Guia
Webhooks da API Emitfy
Como receber webhooks da Emitfy com o status de cada nota: eventos, headers de autenticação, retentativas e a diferença para o webhook de entrada.
Dois tipos de webhook
Webhook de saída (Emitfy → seu sistema): notifica eventos de nota. É cadastrado na assinatura, por /v1/webhooks ou no painel em API & Webhooks, com URL, eventos e headers próprios.
Webhook de entrada (venda → Emitfy): é a integração. Hotmart, Kiwify e as demais plataformas, ou o seu sistema pela integração API, enviam a venda para a Emitfy emitir.
Documentação: docs.emitfy.com/webhooks (saída) e docs.emitfy.com/integrations/api-webhook (entrada).
Eventos disponíveis
| Documento | Eventos |
|---|---|
| NFS-e | nfse.authorized · nfse.rejected · nfse.cancelled |
| NF-e | nfe.authorized · nfe.rejected · nfe.cancelled |
| CT-e | cte.authorized · cte.rejected · cte.cancelled |
| MDF-e | mdfe.authorized · mdfe.rejected · mdfe.cancelled · mdfe.closed |
Boas práticas no seu endpoint
- URL HTTPS que aceite o mesmo evento mais de uma vez sem duplicar efeito
- Header próprio (por exemplo, Authorization) cadastrado no webhook e conferido a cada chamada
- Responder 2xx rápido e processar o evento em segundo plano
- Guardar o id da nota e o companyId de cada evento
- Conferir no painel, em API & Webhooks → Eventos, o request e a resposta de cada disparo
Perguntas frequentes
Como sei que o webhook veio da Emitfy?
No cadastro do webhook você define headers HTTP, como Authorization com um segredo seu. A Emitfy envia esses headers em toda notificação, junto com User-Agent Emitfy/1.0.0. Recuse chamadas sem o seu header.
E se o meu servidor estiver fora do ar?
Se a resposta não for 2xx, a Emitfy reenvia o evento até 5 vezes, com intervalo crescente. Cada tentativa fica registrada no log de eventos do painel.
Os webhooks incluem o XML?
Não. O evento avisa o que aconteceu; XML e PDF são baixados pelos endpoints da nota, como /nfse/{id}/xml.
Preciso de webhook se uso só o painel?
Não. Webhooks servem para sistemas que precisam reagir sozinhos à mudança de status.
Próximo passo
Automatize a emissão fiscal com a Emitfy
Conecte sua plataforma ou use a API REST. 10 notas grátis para testar, sem cartão.
Continue lendo
Leitura relacionada
Exemplos de API Emitfy
Exemplos de chamadas à API Emitfy: autenticação, emissão de NFS-e, NF-e e CT-e, idempotência, erros e NF-e recebidas. Contrato completo no OpenAPI.
3 min · 23/10/2026Ler o guia GuiaAPIAPI de NFS-e da Emitfy
Como emitir NFS-e pela API da Emitfy quando o checkout é seu: credenciais, endpoint, erros de validação, retentativa e quando preferir a integração nativa.
2 min · 23/10/2026Ler o guia GuiaAPIAPI de NF-e da Emitfy
Como emitir NF-e pela API da Emitfy: credenciais, companyId no path, Idempotency-Key, XML/PDF, carta de correção e recebimento de NF-e de fornecedores.
3 min · 23/10/2026Ler o guia