Documentação Técnica - Padrão CAUCAIA

Tópicos deste artigo

• Manual do web service
• Portais disponíveis 
• Métodos disponíveis 
• Tipo de impressão 
• Observações gerais
• Observações sobre a geração do XML
• 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.
  • Síncrono¹
  • Não aceita envio de lote de RPS
• Consulta de NFSe por RPS

¹ Não necessita que as notas sejam enviadas de forma sequencial

Tipo de impressão

• A impressão é feita via rota disponibilizada pelo padrão e também há impressão de layout próprio da Tecnospeed quando em contingência.

Observações gerais

• O webservice atualmente sofre com constantes oscilações que podem acarretar em dificuldades nas emissões de nota. Em caso de retornos de 503 ou timeout, tente novamente em alguns minutos.
• O cancelamento só pode ser feito via portal da prefeitura. Porém o retorno da nota não vem com informações de cancelamento. Para impressão da tarja de cancelamento no RTM, adicione o campo NotaCancelada=1 nos campos customizados.
• A autenticação das requisições pode ser feita de duas formas:
  • Envio como parâmetro extra Login e a Senha de acesso ao portal da Prefeitura da seguinte forma: "login=XXXXXX;senha=XXXXXXX"
  • Envio como parâmetro extra "Senha" o token adquirido através da rota disponibilizada pela prefeitura através da rota POST https://api.nfse.sefin.caucaia.ce.gov.br/auth/token (detalhes na documentação do padrão anexada). Dessa forma as requisições serão mais rápidas, pois não será necessário a geração de token novo em cada uma das comunicações. Exemplo "senha=2982m3klxz;;"
  • No Edoc/Saas o Token/Acesso portal deve ser informado nas configurações, na aba de Autenticação da Prefeitura.
• Padrão não possui  Múltiplos Serviços;
• O campo TipoRps deve ser preenchido com um código de validação (AIRPS) que é retornado da rota da https://api.nfse.sefin.caucaia.ce.gov.br/rps/consultarAiRps . Detalhes de como adquirir a lista, na documentação do padrão.

Observações sobre a geração do XML

• O layout do XML é próprio do município e ainda não tem integrado os campos da RT.

Campos customizados para a impressão do RPS

• RazaoSocialPrestador=String[80]
• CpfCnpjPrestador=String[20]
• InscricaoMunicipalPrestador=String[40]
• CodigoCidadePrestador=String[10]
• DescricaoCidadePrestador=String[40]
• EnderecoPrestador=String[80]
• BairroPrestador=String[60]
• NumeroPrestador=String[7]
• ComplementoPrestador=String[80]
• CepPrestador=String[10]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• DataEmissao=String[20]
• UFPrestador=String[10]
• DDDPrestador=String[10]
• DataDeCancelamento=String[20]

Campos Customizados para a impressão da NFSe

• RazaoSocialPrestador=String[80]
• NomeFantasiaPrestador=String[80]
• DataDeCancelamento=String[20]
• OptanteSimplesNacional=String[5]
• TipoTributacao=String[5]
• NotaCancelada=String[20]