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.autorizada | NF-e / NFC-e | Documento autorizado com sucesso perante a SEFAZ (cStat 100/150). Retorna chave de 44 dígitos e protocolo. |
nfe.erro | NF-e / NFC-e | Lote rejeitado pela SEFAZ. Retorna erroCstat e erroMotivo da rejeição fiscal. |
nfe.cancelada | NF-e / NFC-e | Evento de cancelamento (110111) homologado e vinculado à chave da nota. |
nfe.denegada | NF-e / NFC-e | Uso denegado pela SEFAZ por irregularidade fiscal do emitente ou destinatário. |
nfe.contingencia | NF-e / NFC-e | Emissão realizada em contingência offline (NFC-e) ou SVC. |
nfe.batch.completed | NF-e (Lote) | Processamento de lote assíncrono concluído via /v1/nfe/batch. |
nfe.recebida.detectada | Monitor Fiscal | Novo documento fiscal emitido contra o seu CNPJ foi detectado na SEFAZ. |
nfe.recebida.completa | Monitor Fiscal | XML completo da NF-e recebida de fornecedor baixado e disponibilizado. |
cte.recebido | Monitor Fiscal | Novo CT-e tomado pelo seu CNPJ foi detectado e importado. |
1. Eventos de NF-e (Modelo 55)
Exemplo de payload do evento nfe.autorizada contendo chave de acesso, protocolo de autorização e metadados no envelope canônico NFER:
Exemplo de payload do evento nfe.erro quando a SEFAZ rejeita a nota:
2. Eventos de NFC-e (Modelo 65)
Para NFC-e, a NFER utiliza o mesmo evento canônico nfe.autorizada com "modelo": "65", incluindo o buffer em Base64 ou URL para impressão térmica direta ESC/POS:
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 contra o CNPJ da sua empresa:
5. Processamento de Lote (nfe.batch.completed)
Disparado quando o processamento assíncrono de um lote de notas (POST /v1/nfe/batch) é concluído por completo pelos workers: