Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção

Métodos Disponíveis

• Envio.
  • Assíncrono.
• Consulta Situação de lote.
• Consulta de lote.
• Consulta de NFSe por RPS.
• Consultar NFSe.
• Cancelamento de NFSe.

Observações

• Nos testes realizados pudemos observar que:
  • Utilizando caracteres especiais o Webservice apresentou problema, portanto é recomendado que não faça uso dos mesmos.
  • O webservice apresentou instabilidade ao emitir notas com acentos, por esse motivo os acentos serão removidos automaticamente.
  • Ao enviar a nota sem os campos InscricaoMunicipalTomador e EmailTomador não foi possível realizar o cancelamento via WebService, sendo necessário efetuá-lo através de solicitação diretamente no portal do municipio.
• Manager SaaS
  • Caso o retorno da consulta de situação for em processamento ou consumo excessivo de consultas o Manager SaaS consultará a nota apenas uma vez independente da quantidade de tentativas configurada e a nota ficará com a situação ENVIADA.

Notas Rejeitadas por Duplicidade (Edoc/SaaS)

• Para evitar duplicações e o descarte de notas que já foram AUTORIZADAS será possível sincronizar as notas que retornarem o erro de duplicidade no fluxo de ENVIO. As notas ficarão com a situação ENVIADA, necessitando de um tratamento especial para chegarem a situação final (AUTORIZADA, REJEITADA OU CANCELADA). 
• Caso exista divergências entre a situação da nota na prefeitura (Autorizada) e em nosso produto (Enviada) e a mensagem do retorno tenha sido: "RPS já convertido em NFS", ou retorne as seguintes mensagens ao tentar resolver ou descartar uma nota:
  • "EXCEPTION,EspdManNFSeCheckParamsException,Por questão de segurança, o RPS informado já foi convertido em NFSe, caso os dados da nota sejam os mesmos e deseje sincronizar, passe o parâmetro "forcar=true.""
  • "EXCEPTION,EspdManNFSeResolveException,Por questão de segurança a nota não será descartada pois o RPS informado já foi convertido em uma NFSe, caso os dados da nota não sejam os mesmos e deseje descartar, passe o parâmetro "forcar=true""
• Siga algum dos passos à seguir:
  • Dados Iguais: Se os dados da nota enviada forem os mesmos da nota que está AUTORIZADA no portal da prefeitura, e deseje sincroniza-la, deve ser utilizado o parâmetro "forcar=true" na rota de RESOLVE, como no exemplo abaixo:                                                                                                                                                                                                                                                                                                                                                                                  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 as notas sejam exatamente as mesmas.                                                                                                                                          
  • Dados Diferentes: caso os dados da nota enviada e da AUTORIZADA no portal da prefeitura sejam divergentes e deseje descartar essa nota, deverá utilizar o parâmetro "forcar=true" na rota de DESCARTA, conforme o exemplo abaixo:                                                                                                                                                                                                                                                                                                                                                                       ATENÇÃO: Isso fará com que a nota seja descartada.

 Os demais parâmetros do método RESOLVE, continuam sendo os mesmos já aceitos (handle; numNFSe; e numRPS, serieRPS e tipoRPS ), conforme a documentação  

Geração do XML - Campos Importantes

• O Código do serviço segue o que está descrito na LC-116.
• O Código Cnae segue o que esta descrito na tabela nacional.
• O código tributação município deve ser informado com o mesmo valor do código do serviço, entretanto ele deve possuir apenas números.

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[20]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• MotivoCancelamento=String[100]
• TituloDiretoria=String[80]
• EnderecoPrefeitura=String[80]
• TipoLogradouroPrestador=String[10]
• TipoLogradouroTomador=String[10]
• idCompl=String[10]
• NumeroNfse=String[10]
• DataEmissaoRps=String[10]
• OutrasInformacoes=String[10]
• NfseSubstituidora=String[10]
• DataHoraCancelamento=String[10]
• NfseSubstituida=String[10]
• InscricaoEstadualPrestador=String[15]
• InscricaoEstadualTomador=String[15]
• EnderecoProcon=String[80]

Impressão da NFSe

• EnderecoPrefeitura=String[80]
• MotivoCancelamento=String[100]
• TituloDiretoria=String[80]
• InscricaoEstadualPrestador=String[15]
• InscricaoEstadualTomador=String[15]
• EnderecoProcon=String[80]
• TipoLogradouroPrestador=String[10]
• TipoLogradouroTomador=String[10]
• idCompl=String[10]

Soluções Tecnospeed

• Componente NFSe:    Release 8.7.48.X.
• Manager eDoc:  Release 3.0.82.X