Conceitos de WebHook
Abaixo um breve tutorial sobre o funcionamento do Webhook em: Conceitos sobre WebHook. Logo, é um ponto de encontro entre você e a sua nota.
O que encontrará no texto?
1. Como funciona na NFE.io?
2. Fluxo de notificação
1. Como funciona na NFE.io?
Quando estamos falando de emissão de nota, vimos que nenhum sistema é perfeito, então, entendemos que sistema do Governo pode ficar fora do ar, ter instabilidades ou ter uma série de regras para emissão que pode levar a um tempo maior para o sucesso.
Você poderá enviar os dados para emissão das notas, processaremos, e através dos webhoooks poderemos te avisar o que aconteceu no processo.
O WebHook é um ponto de encontro entre você e a sua nota, ou seja, você não precisará ficar esperando todo o processamento para identificar o estado dela, e sim, te avisaremos no momento de sua conclusão. Em algumas regras de negócio, ela faz total sentido.
2. Fluxo de notificação
No exemplo seguinte, faremos uma análise do fluxo de emissão e notificação.
Basicamente temos dois passos:
- O "Sistema Cliente" que envia os dados da nota fiscal para a NFE.io.
- Após todo o fluxo de emissão de nota, faremos as notificações devidas na nota fiscal utilizando o WebHook.
Essas notificações são enviadas para o "Sistema do Cliente" de acordo com a ação identificada (emitida, erro ou falha).
Ilustração do fluxo
Passo a passo:
- Sistema do Cliente envia os dados para emissão.
- Sistema NFe.io recebe dados para emitir.
- NFE.io processa a nota fiscal.
- NFE.io entende o estado da nota, se foi emitida com sucesso, com erro ou com falha.
- NFE.io aciona o gatilho de notificação para o Sistema do Cliente baseado no status da nota fiscal.
- Sistema do Cliente recebe a nota fiscal na url equivalente ao status da nota.
Como utilizar?
Agora que você já tem uma ideia de como funcionam os WebHooks, os próximos passos são:
1. Tutorial de webhooks
2. Consultar tipos de eventos
3. Cadastrar um webhook
4. Consultar um webhook
5. Editar um webhook
6. Excluir um webhook
7. Listar todos webhooks