Manual de integração com o Web-Service

Lista de Manuais

Servidores Disponíveis 

• Produção

Métodos Disponíveis 

• Envio; 
  • Síncrono.
• Consulta de RPS
• Consulta de NFSe
• Cancelamento de NSFe

Observações

• Ao realizar os métodos disponíveis no componente  devem ser informados o login e senha de acesso do contribuinte da seguinte forma: "login=XXXXX;senha=XXXXXXXXXX".
  • No Edoc/Saas o login e senha devem ser informado nas configurações, na aba de Autenticação da Prefeitura.
  • No PlugNotas o login e senha deverá ser informado na aba de NFSe, rolando a tela até a guia de Autenticação prefeitura.
  • Para a consulta de NFSe por RPS além do login e senha deverá também ser informada a data do RPS da seguinte forma "login=XXXXX;senha=XXXXXXXXXX;data=aaaa-mm-dd".
• Padrão não possui quebra de linha.;
• Padrão possui o envio em lote;
• Padrão possui  Múltiplos Serviços;

Manager eDoc/Manager SaaS

Quando for usado tx2 com dataset de múltiplos serviços, deve se atentar no preenchimento dos valores de ISS, pois este padrão permite envio do valor total de ISS e valor de ISS de cada serviço.

Dentro do dataset do primeiro serviço deve ser usado a tag "ValorISS" para preencher o valor de iss total da nota e usar a tag "ValorISSServico" para preencher o valor do iss do primeiro serviço.
Dentro do dataset de multiplos serviços deve ser usado a tag "ValorISS" para preencher o valor de iss de cada serviço adicional.

• 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: "NAO IMPORTADO - ERRO 21 - Recibo ja existe", ou retorne as seguintes mensagens ao tentar resolver ou descartar uma nota:
  • "EXCEPTION,EspdNFSeOperacaoIndisponivelException,Não é possível realizar o RESOLVE desta nota pois o RPS informado já foi convertido em uma NFSe. Caso deseje realizar uma tentativa de sincronização, informe o número da nfse através do parâmetro "NumNFSeConsulta", por exemplo: NumNFSeConsulta=1234".
  • "EXCEPTION,EspdManNFSeCheckParamsException,Por questão de segurança, não é possível realizar o DESCARTE desta nota pois o RPS informado já foi convertido em uma NFSe. Caso a nota não tenha sido emitida, deve-se informar 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 "NumNFSeConsulta" 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.

Geração do XML - Campos Importantes 

• O código do serviço segue o que está descrito na LC-116.

Campos customizados para a impressão 

Impressão do RPS

• CpfCnpjPrestador=string[20]
• InscricaoEstadualPrestador=string[15]
• InscricaoMunicipalPrestador=string[15]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• NumeroEnderecoPrestador=String[10]
• ComplementoEnderecoPrestador=String[60]
• CodigoMunicipioPrestado=String[10]
• UfPrestador=String[2]
• BairroPrestador=String[40]
• EmailPrestador=String[80]
• TelefonePrestador=String[20]

Impressão do NFSe

• CpfCnpjPrestador=string[20]
• InscricaoEstadualPrestador=string[15]
• InscricaoMunicipalPrestador=string[15]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• NumeroEnderecoPrestador=String[10]
• ComplementoEnderecoPrestador=String[60]
• CodigoMunicipioPrestado=String[10]
• UfPrestador=String[2]
• BairroPrestador=String[40]
• EmailPrestador=String[80]
• TelefonePrestador=String[20]