Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção
• Homologação

Métodos Disponíveis

• Envio.
  • Síncrono.
• Consulta de NFSe por RPS.
• Consulta de NFSe.
• Cancelamento de NFSe. 

Observações

• Não utiliza certificado digital para assinatura de XML.
• Para iniciar a integração com o Web Service, é necessário informar nas configurações, na aba de Autenticação da Prefeitura:
  
  • Login: CPF de acesso ao portal da prefeitura (sem máscara);
  • Senha: Senha de acesso ao portal da prefeitura.
• Aceita envio em lote.
• A cada nota enviada ao Webservice, deve-se incrementar o número do rps.
• Nos testes realizados, a quebra de linha não funcionou corretamente, portanto mesmo ao informar o caracter  pipe ' | ',  a quebra de linha não ocorrerá na comunicação com o Webservice.
• O Campo 'IncentivoFiscal' é representado por 2 valores diferente ao costume. Sendo: O mesmo não possui obrigatoriedade. Apenas deve ser informado se entrar na regra descrita. Trecho retirado do manual de Londrina.

Componente

•  Para consultar a NFSe deve ser usado o valor do código de verificação localizado na tag codigoVerificacao do xml de resposta do envio. Ex:
  
  • ConsultarNota(aCodigoVerificacao, senha='token fornecido pela prefeitura')
• A chave de cancelamento da NFSe é formada pelo número da NFSe e pelo número do RPS correspondente. Deve ser informada dessa forma: "NumeroNFSe_NumeroRPS".

Notas Rejeitadas por Duplicidade (Edoc/SaaS

• Caso ocorra divergências entre a situação da nota na prefeitura (Autorizada) e em nosso produto (Rejeitada), o procedimento a ser realizado é informar o Código de Verificação da nota na rota de resolve, acrescentando o parâmetro nprotocolo, Exemplo: nprotocolo=12345678AB
  
  • Para encontrar a Código de Verificação da nota, é necessário fazer o download do XML no portal da prefeitura e visualizar o conteúdo da tag "<codigoVerificacao>" ;

• Procedimentos: 
  • Para comunicações via API:
    • o parâmetro nprotocolo=codigoVerificacao deverá ser adicionado no Body da requisição;
  • Para comunicações via integração por pasta:
    • o parâmetro nprotocolo=codigoVerificacao deverá ser adicionado no TX2;
  • Para realizar via Interface Web:
    • Selecione a nota desejada, e clique no botão RESOLVE. Abrirá uma caixa de texto aonde deve ser informado a Código de Verificação daquela nota.
      
      • Obs: O procedimento funcionará apenas quando:
        
        • A nota estiver com a situação REJEITADA;
        • Apenas uma nota for selecionada.

• ATENÇÃO: a sincronização será realizada independente de que as informações contidas na nota emitida sejam diferentes da NFSe do portal da prefeitura. Portanto é necessário se certificar que o Código de Verificação seja exatamente o correspondente à nota resolvida.

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na  LC-116.
• Código CNAE segue a tabela nacional com 7 digítos.
• Acentuação muitas vezes causa problema de rejeição no servidor. Devido a isso está sendo removido os acentos do RPS.

Campos customizados para a impressão

Impressão do RPS

• TipoLogradouroPrestador=String[10]
• TipoLogradouroTomador=String[10]
• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• InscricaoEstadualPrestador=String[40]
• TelefonePrestador=String[20]
• EnderecoPrestador=String[80]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[10]
• CodigoMunicipioPrestador=String[10]
• UfPrestador=String[2]
• EmailPrestador=String[80]
• NumeroVia=String[10]
• OutrasInformacoes=String[255]
• CodigoAGRS=String[50]
• ValorDeducoes=String[10]
• ValorISS=String[10]
• EnderecoLogotipoTomador=String[255]
• CodigoCnae=String[10]
• NumeroNota=String[12]
• CodigoVerificacao=String[10]
• ValorLiquido=String[10]
• NotaCancelada=String[10]

Impressão da NFSe

• TipoLogradouroPrestador=String[10]
• TipoLogradouroTomador=String[10]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[10]
• CodigoMunicipioPrestador=String[10]
• UfPrestador=String[15]
• NumeroNota=String[12]
• CodigoVerificacao=String[10]
• ValorDeducoes=String[10]
• ValorISS=String[10]
• ValorLiquido=String[10]
• EnderecoLogotipoTomador=String[255]
• CodigoCnae=String[10]
• NotaCancelada=String[10]

Soluções Tecnospeed

• Componente NFSe:    Release 8.7.49.X.
• Manager eDoc:    Release 3.0.83.X.