NFe.io | Docs

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:

  1. O "Sistema Cliente" que envia os dados da nota fiscal para a NFE.io.
  2. 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

webhook

Passo a passo:

  1. Sistema do Cliente envia os dados para emissão.
  2. Sistema NFe.io recebe dados para emitir.
  3. NFE.io processa a nota fiscal.
  4. NFE.io entende o estado da nota, se foi emitida com sucesso, com erro ou com falha.
  5. NFE.io aciona o gatilho de notificação para o Sistema do Cliente baseado no status da nota fiscal.
  6. 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

Our Score