Webhook para recebimento automático de NF-e e CT-e

Um webhook de NF-e ou CT-e notifica automaticamente um sistema assim que um documento novo é encontrado, em vez de exigir que esse sistema fique perguntando periodicamente se há algo novo: a mesma ideia já usada para NFS-e, com um tipo de evento próprio para cada documento.

Eventos separados por tipo

• Um evento próprio para NF-e recebida, disparado quando um documento novo é encontrado.
• Um evento próprio para CT-e recebido, independente do evento de NF-e.
• Os eventos de NFS-e continuam existindo sem mudança: quem já assina só esses não passa a receber NF-e/CT-e sem configurar.

Por que eventos separados, e não um único genérico

Ter um evento por tipo de documento permite que um sistema assine só o que precisa: um time que só cuida de logística pode assinar apenas o evento de CT-e, sem precisar filtrar NF-e e NFS-e do lado de dentro do próprio código. Isso também evita quebrar integrações já existentes: quem assina o evento genérico de NFS-e continua recebendo exatamente o mesmo volume de antes, mesmo depois de a empresa ligar NF-e e CT-e.

Perguntas frequentes

Um mesmo endpoint pode receber os eventos de NF-e, CT-e e NFS-e?

Sim. É possível assinar múltiplos tipos de evento para a mesma URL de webhook, cabendo ao sistema que recebe diferenciar pelo tipo de evento presente no payload.

A assinatura do webhook (HMAC) muda entre os tipos de documento?

Não. O mecanismo de assinatura e verificação é o mesmo, independente do tipo de evento. Veja os detalhes de segurança em segurança de webhook de documentos fiscais.

A configuração de webhook (URL, segredo e tipos de evento) é feita no painel, no mesmo lugar já usado para os eventos de NFS-e. Detalhes de payload e retry estão na documentação da API pública.