Catálogo de Eventos e Payloads
Matriz canônica de eventos oficiais com payloads para NF-e, NFC-e, NFS-e, CT-e e Monitor Fiscal.
Esta página reúne a matriz canônica de eventos disparados pela NFER. Os nomes de eventos seguem a convenção <entidade>.<acao> em letras minúsculas. Ao cadastrar um webhook, você pode assinar eventos específicos ou usar o curinga "*" para receber todas as notificações da sua empresa.
Matriz de Cobertura por Documento
| Nome do Evento (Canônico) | Documento | Quando é disparado |
|---|---|---|
nfe.authorized | NF-e / NFC-e | Documento autorizado com sucesso perante a SEFAZ (cStat 100/150). Retorna chave de 44 dígitos e protocolo. |
nfe.rejected | NF-e / NFC-e | Lote rejeitado pela SEFAZ. Retorna código cStat e motivo da rejeição fiscal. |
nfe.canceled | NF-e / NFC-e | Evento de cancelamento (110111) homologado e vinculado à chave da nota. |
nfe.correction_letter | NF-e / CT-e | Carta de Correção Eletrônica (CC-e 110110) homologada pela SEFAZ. |
nfse.authorized | NFS-e Nacional | Declaração de Prestação de Serviços (DPS) convertida em NFS-e na prefeitura ou ADN. |
cte.authorized | CT-e Rodoviário | Conhecimento de Transporte Eletrônico autorizado pela SEFAZ. |
company.certificate_expiring | Organização | Alerta preventivo: certificado digital A1 expirará nos próximos 30 ou 15 dias. |
monitor.document_received | Monitor Fiscal | Novo documento fiscal de compras/frete emitido contra o seu CNPJ foi capturado. |
1. Eventos de NF-e (Modelo 55)
Exemplo de payload do evento nfe.authorized contendo chave de acesso, protocolo de autorização, links para download direto de DANFE e XML assinado:
Exemplo de payload do evento nfe.rejected quando a SEFAZ rejeita o lote:
2. Eventos de NFC-e (Modelo 65)
Para NFC-e (consumidor final balcão), a NFER utiliza o mesmo evento canônico nfe.authorized com "modelo": 65, incluindo o buffer binário em Base64 para envio direto à impressora térmica ESC/POS (80mm ou 58mm):
3. Eventos de NFS-e (Nacional / Municipal)
Notificação disparada quando o Recibo Provisório de Serviços (RPS) é convertido com sucesso em Nota Fiscal de Serviços Eletrônica:
4. Eventos do Monitor Fiscal (DF-e Recebidos)
Disparado instantaneamente quando os robôs de sincronização distribuída capturam uma nova NF-e emitida por fornecedores ou CT-e de transportadoras contra o CNPJ da sua empresa:
5. Eventos de Empresa & Certificado
Disparado preventivamente quando o certificado digital A1 cadastrado estiver próximo do vencimento, permitindo alertar o departamento contábil ou automatizar a renovação: