Manual de integração com o webservice

Download do manual

Portais Disponíveis

 A interface do GovDigital passou a ser NFe-cidades. (https://www.nfe-cidades.com.br/index.action)

Para verificar o endpoint de cada uma das cidades atendidas pelo padrão, visite https://ws.nfe-cidades.com.br/ws 

• Produção
• Homologação

Métodos Disponíveis

• Envio.
  • Síncrono.
• Consulta de NFSe.
• Consulta de Notas Tomadas.
• Cancelamento de NFSe.

Observações

• Envio síncrono aceita somente o envio de uma nota por vez. Para arquivos TX2 com mais de uma nota será gerado somente a primeira.
• É necessário solicitar liberação para emitir NFSe através do Webservice. A solicitação pode ser feita diretamente pelo portal da prefeitura em: "Solicitações > Autorização de Emissão de NFe"
• É necessário solicitar liberação de RPS diretamente pelo portal da prefeitura em: "Solicitações > Recibo de Prestação de Serviços"
• A consulta de NFSe de uma nota inexistente no WebService retorna um XML vazio, e caso seja feita uma consulta de uma nota válida está retornando com o número do item da lista de serviço incorreto. 
• Na impressão do campo de ExibilidadeISS, caso seja informado os valores "6" ou "7", será impresso com a descrição "Exigibilidade Suspensa".
• Para integração via Manager Edoc, o resolver está funcionando apenas para notas com as situações iguais à Autorizada ou Cancelada.
• Para consulta de Notas Tomadas, deverá ser informado o CNPJ/CPF do tomador, CNPJ/CPF do consulente, data inicial, data final e a página.

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LC-116.
• A cidade Ouro Preto-MG usa um CodigoTributacaoMunicipio próprio de 9 dígitos que consta no portal da prefeitura
• Não é obrigatório informar o código CNAE, entretanto, caso informado será gerado no XML.
  • Código CNAE segue a tabela nacional com 7 dígitos.
• Tanto a emissão através do portal ou via webservice, não utilizam o código de tributação do município, entretanto, caso informado será gerado no XML.
  • O "Código de Tributação do Município" é um código proprietário de cada município, ou seja, cada município tem o seu, não existe um padrão, sendo assim é necessário contatar o município para identificar qual a codificação utilizada.   
    Algumas prefeituras adotam a codificação da lista de serviço da Lei Complementar 116/03 ampliada, outras adotam o código CNAE.

Campos customizados para a impressão

Impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoMunicipioPrestador=String[10]
• UfPrestador=String[2]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[80]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• RegTomador=String[20]
• RegPrestador=String[20]
• InscricaoEstadualTomador=String[20]
• InscricaoEstadualPrestador=String[20]
• CodMobPrestador=String[20]
• Quantidade=String[5]
• ValorTributos=String[20]
• PorcentagemTributos=String[20]
• ValorLiquidoNfse=String[20]
• BaseCalculo=String[20]

Impressão da NFSe

• UfServicos=String[2]
• ComplementoEnderecoPrestador=String[80]
• RegTomador=String[20]
• RegPrestador=String[20]
• InscricaoEstadualTomador=String[20]
• InscricaoEstadualPrestador=String[20]
• CodMobPrestador=String[20]
• Quantidade=String[5]
• MensagemCancelamento=String[80]
• ValorTributos=String[20]
• PorcentagemTributos=String[20]
• Observacoes=String[255]

Soluções Tecnospeed

• Componente NFSe:   Release 7.7.43.X.
• Manager eDoc:  Release 2.0.77.X.