alguém mandar uma chamada falsa?
Sem o segredo do webhook não dá para gerar o X-Emitfy-Signature. O carimbo de tempo protege contra replay.
OUT1515% off na primeira cobrança com o cupom OUT15.15% off na 1ª cobrançaVer planos
Webhooks · NFS-e, NF-e, CT-e e MDF-e
Autorizada, rejeitada, cancelada ou encerrada: a Emitfy avisa a sua URL em cada mudança, com o documento no payload, assinatura HMAC e histórico de entregas com reenvio. Sem polling. Em todos os planos.
X-Emitfy-Signature: t=1793240706,v1=9f2c…e81anfse.authorized200142 msnfe.authorized20098 mscte.authorized50330 scte.authorized nova tentativa200211 msmdfe.closed20087 msCatálogo de eventos
Cada webhook assina só os eventos que interessam ao seu sistema.
Nota de serviço autorizada, rejeitada ou cancelada, com PDF e XML no payload.
Nota de produto, com chave de acesso, PDF e XML quando autorizada.
Conhecimento de transporte, com número, chave ou o motivo da rejeição.
Manifesto da viagem, incluindo o encerramento.
NFC-e ainda não tem evento de webhook: o status fica em GET /nfce/{id} e /events. Veja a API de NFC-e.
Na prática
O envelope de cada entrega, a verificação da assinatura, o cadastro e o histórico.
// O que chega no seu endpoint
POST https://seu-sistema.com/webhooks/emitfy
Content-Type: application/json
User-Agent: Emitfy/1.0.0
X-Emitfy-Signature: t=1793240706,v1=9f2c…e81a
Authorization: Bearer seu-token // header seu, opcional
{
"id": "evt_…",
"event": "nfse.authorized",
"createdAt": "2026-10-28T14:32:10.000Z",
"data": {
"id": "…",
"externalId": "venda-48213",
"type": "nfse",
"status": "authorized",
…,
"assets": { "pdf": "https://api.emitfy.com/…", "xml": "https://api.emitfy.com/…" }
}
}
// data = o mesmo recurso da API
// (GET /v1/companies/{id}/invoices/{id})
// Campos sem valor não vêm no payload:
// trate ausência como "não se aplica".
// Responda 2xx rápido e processe depois.
CT-e e MDF-e usam o mesmo envelope (id, event, createdAt, data), com os dados do documento.
Uma entrega
SEFAZ, prefeitura ou Sefin Nacional respondem e a nota muda de status.
Payload com o documento, os seus headers e o X-Emitfy-Signature.
Resposta diferente de 2xx: a Emitfy tenta de novo, com intervalos crescentes.
Request, response e tentativas guardados, com reenvio quando você quiser.
Antes de integrar
Sem o segredo do webhook não dá para gerar o X-Emitfy-Signature. O carimbo de tempo protege contra replay.
Gere outro com POST /v1/webhooks/{id}/signing-secret: o anterior deixa de valer na hora.
Cadastre os seus headers no webhook, como um Authorization. Eles vão em toda entrega.
Filtre o histórico por status=error e reenvie a entrega. O log original fica preservado.
A URL precisa ser pública: endereços internos, loopback e de metadados são bloqueados por segurança.
Pelo MCP, um agente de IA compatível cria, lista e ativa webhooks em português.
Ver o MCPPerguntas frequentes
NFS-e e NF-e: authorized, rejected e cancelled. CT-e: authorized, rejected e cancelled. MDF-e: authorized, rejected, cancelled e closed. Você escolhe, por webhook, quais eventos quer receber.
Toda entrega leva o header X-Emitfy-Signature, com o HMAC-SHA256 do corpo bruto e um carimbo de tempo, calculado com o segredo do webhook. Recalcule no seu servidor, compare em tempo constante e rejeite carimbos com mais de 5 minutos.
Se a resposta não for 2xx, a Emitfy tenta de novo com intervalos crescentes. Cada tentativa fica no histórico de entregas, e qualquer entrega pode ser reenviada pela API ou pelo painel.
Não. O webhook pertence à conta e vale para todas as empresas da assinatura. Use o id e o externalId do payload para ligar o evento ao seu registro.
Ainda não há evento de webhook para a NFC-e. O status fica na consulta da nota (GET /nfce/{id}) e na linha do tempo (GET /nfce/{id}/events).
Webhooks fazem parte da API, incluída em todos os planos e no período gratuito de 10 notas.
Webhooks na Emitfy
Crie a conta sem cartão, cadastre a sua URL e receba o primeiro evento com as 10 notas grátis.