Tópicos deste artigo

• Manual de integração com o webservice
• Portais disponíveis
• Métodos disponíveis
• Tipo de impressão
• Observações gerais
• Emissão pelo PlugNotas
• Emissão pelo ManagerEdoc/ManagerSaaS
• Emissão pelo Componente NFSe
• Observações sobre a geração do XML
• Erros comuns
• Campos customizados para a impressão do RPS
• Campos customizados para a impressão da NFSe

 

 

Manual de integração com o webservice

Download do manual

 

 

Portais Disponíveis

• Produção

 

 

Métodos disponíveis

• Envio
  • Não necessita envio sequencial¹
  • Síncrono
  • Não aceita envio de lote de RPS
• Consulta de NFSe
• Consulta de NFSe por RPS
• Cancelamento de NFSe

 

¹ Não necessita que as notas sejam enviadas de forma sequencial

Tipo de impressão

• A impressão é feita via layout próprio da Tecnospeed¹

 

¹ Nossos produtos geram o PDF da NFSe, se aproximando o máximo possível do layout da prefeitura.

Observações gerais

• Para o padrão é necessário gerar uma chave digital de webservice no portal da prefeitura. Esta chave digital deverá ser informada no parâmetro "Senha", nas configurações de autenticação com a prefeitura. Essa chave digital deve ser adquirida junto a prefeitura, pois varia de prestador para prestador.
• Ao realizar o cancelamento de uma NFSe o motivo de cancelamento e o código de cancelamento são obrigatórios. Caso estes dados não sejam informados preencheremos automaticamente com os valores abaixo: 
  • Motivo: "NFSe cancelada à pedido do prestador"
  • Código: 2 - Serviço não prestado.
• Códigos de cancelamento aceitos:
  • 1 - Erro na emissão
  • 2 - Serviço não prestado.
• O XML do envio síncrono não possui identificação dos campos referentes ao RPS (Número RPS, série e tipo).

 

 

Emissão pelo PlugNotas

• A chave digital deverá ser informada no parâmetro "Senha", nas configurações de autenticação com a prefeitura.

Exemplo de configuração da chave digital pela interface do PlugNotas

 

 Exemplo de configuração da chave digital pela API

 

 

Emissão pelo ManagerEdoc/ManagerSaaS

• ​A chave digital deve ser informado no campo Senha na aba Configurações > Autenticação da Prefeitura.

Exemplo de configuração da chave digital:

 

Emissão pelo Componente NFSe

• Nos testes realizados com o Delphi 7 e modo debug, foi encontrado um problema ao fazer a requisição para o Webservice do padrão. A exceção levantada traz a mensagem "Invalid argument to date Encode". Apesar de disparar a exceção, a requisição é feita corretamente e não foi possível tratá-la, pois é referente a um problema conhecido do Indy, utilizado para fazer a requisição.
• A chave digital deve ser informado no parâmetro extra "Senha".

Exemplo de configuração da chave digital:

NFSe.ParametrosExtras = "Senha=999512b599abc9babc9a9bc99abc999c";

 

 

Observações sobre a geração do XML

• O código do serviço segue o que está descrito na LC-116.
• O campos CodigoTributacaoMunicipio pode ser informado, entretanto não é obrigatório para a autorização de notas.
• Caso não esteja utilizando o padrão único, a alíquota deve ser informada com o valor inteiro. Ex: Aliquota=5.00
• Ao gerar o XML os acentos estavam sendo trocados pelo caractere '?', portanto foi removido os acentos.
• Quando gerar xml via Tx2 do município ou Dataset deverá ser informado o código CNAE no campo CodigoItemListaServico

 

 

Erros comuns

• Erro ao tentar gerar NFS-e => Referência de objeto não definida para uma instância de um objeto.
  
  • Poderá ocorrer quando algum campo for enviado de forma incorreta, exemplo do campo CodigoItemListaServico.

 

 

Campos customizados para a impressão do RPS

• RazaoSocialPrestador=String[80]
• NomeFantasiaPrestador=String[80]
• EnderecoPrestador=String[80]
• TelefonePrestador=String[80]
• EmailPrestador=String[80]
• ValorTotalDescontos=String[10]
• NaturezaOperacao=String[80]
• ValorUnitarioServico=String[20]

 

 

Campos customizados para a impressão da NFSe

• DataEmissaoNFSeSubstituida=String[20]
• NumeroProcesso=String[20]
• EnderecoPrestador=String[80]
• NaturezaOperacao=String[80]
• ValorUnitarioServico=String[20]

 

 

Soluções Tecnospeed

 

• Componente NFSe:  Release 7.7.36.X.
• Manager eDoc:  Release 3.0.84.X.