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
• Geração do XML - Campos importantes
• Emissão pelo PlugNotas
• Emissão pelo ManagerEdoc/ManagerSaaS
• Emissão pelo Componente NFSe
• 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

• É necessário preencher o parâmetro "Senha" nas configurações de Autenticação da Prefeitura com a Chave digital de webservice gerada no portal da prefeitura.
  Dúvidas sobre o preenchimento, clique aqui.
• O XML do envio síncrono não possui identificação dos campos referentes ao RPS (Número RPS, série e tipo).

Cancelamento de uma NFSe

• Para cancelar 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 a 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.

 

Geração do XML - Campos importantes

• O código do serviço segue o que está descrito na LC-116.
• O campo CodigoTributacaoMunicipio pode ser informado, entretanto, não é obrigatório para a autorização de notas.
• Ao gerar o XML os acentos estavam sendo trocados pelo caractere '?', portanto foi removido os acentos.

 

---

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";

 

---

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

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]

Impressão da NFSe

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