As principais alterações no status da nota fiscal notificarão (POST) seus webhooks.
Notificações dos webhooks
Seus webhooks serão notificados nessas situações:
- Autorizada - Prefeitura autorizou a nota fiscal
- Negada - Prefeitura rejeitou a nota fiscal
- Cancelada - Prefeitura autorizou o cancelamento da nota fiscal
- CancelamentoNegado - Prefeitura negou o cancelamento da nota fiscal
O valor em negrito representa o status que será retornado no parâmetro nfeStatus.
Dados retornados nos POSTs
{
"empresaId": "string",
"nfeId": "string",
"nfeIdExterno": "string",
"nfeStatus": "string",
"nfeMotivoStatus": "string",
"nfeLinkPdf": "string",
"nfeLinkXml": "string",
"nfeNumero": "string",
"nfeCodigoVerificacao": "string",
"nfeNumeroRps": "string",
"nfeSerieRps": "string",
"nfeDataCompetencia" : date
}
Status da nota fiscal
Além dos seus webhooks serem notificados das principais alterações na sua nota fiscal, você também pode consultar o status da sua nota.
Vários status são internos e podem significar a mesma coisa pra você, como por exemplo os status ligados aos passos executados pelo Gateway dentro do processo de autorização da nota fiscal.
Os status relevantes estão em negrito.
Listei abaixo os status referentes à autorização da nota fiscal:
- AguardandoAutorizacao - Status inicial da nota fiscal.
- SolicitandoAutorizacao - Nota fiscal sendo incluída na fila de transmissão à prefeitura.
- AutorizacaoSolicitada - Nota fiscal incluída na fila de transmissão à prefeitura.
- EmProcessoDeAutorizacao - Sua nota fiscal foi transmitida à prefeitura e o Gateway está aguardando um retorno.
- AutorizadaAguardandoGeracaoPDF - Sua nota foi autorizada pela prefeitura e está na fila de geração de PDF.
- Autorizada - Nota fiscal autorizada e com PDF pronto para download.
- Negada - A prefeitura rejeitou sua nota fiscal.
Listei abaixo os status referentes ao cancelamento da nota fiscal:
- SolicitandoCancelamento - Nota fiscal sendo incluída na fila de cancelamento junto à prefeitura.
- CancelamentoSolicitado - Nota fiscal incluída na fila de cancelamento junto à prefeitura.
- EmProcessoDeCancelamento - Cancelamento solicitado junto à prefeitura e o Gateway está aguardando um retorno.
- CanceladaAguardandoAtualizacaoPDF - Nota fiscal cancelada pela prefeitura e está na fila para atualização de seu PDF.
- Cancelada - Nota fiscal cancelada e com PDF atualizado pronto para download.
- CancelamentoNegado - Prefeitura rejeitou o cancelamento de sua nota fiscal.
Token
Se desejar, você pode especificar um token, ou seja, um código ou frase de sua preferência, dentro do cadastro de seu webhook (pelo painel).
Essa informação será enviada pelo Gateway em cada notificação para o seu link, dessa forma, você consegue garantir que o POST está sendo enviado pelo eNotas Gateway.
O token de autenticação do webhook vai no cabeçalho da requisição, mais especificamente, no item "x-token".
Retentativas em caso de falha
Se seu sistema apresentar instabilidades ou estiver fora do ar, o eNotas tentará lhe enviar o POST de notificação até receber o status HTTP 200, indicando que recebeu e tratou com sucesso o POST.
São realizadas 150 tentativas com intervalos de tempo progressivos entre elas.
Leave A Comment?