---
title: "Catálogo de eventos de webhook"
description: "Lista completa dos eventos enviados pela NFE.io — o que ela emite e o que ela captura — com schema e política de entrega."
source_url: https://nfe.io/docs/webhooks/catalogo-de-eventos
last_updated: 2026-08-26
---

# Catálogo de eventos de webhook

A NFE.io publica eventos de webhook em duas famílias: **eventos de saída** — o que a sua conta emite (NFS-e, NF-e, NFC-e, guias e regras fiscais) — e **eventos de entrada** — documentos de terceiros que a NFE.io captura contra o seu CNPJ (NF-e, CT-e, NFS-e recebidas). Esta página indexa as duas.

## Política de entrega

- **Entrega:** at-least-once. Garanta idempotência — nunca assuma que um evento chega uma única vez.
- **Retry:** reentrega automática em falha de rede ou resposta HTTP fora da faixa 2xx.
- **Timeout:** responda 2xx rápido e processe de forma assíncrona. Retornar erro faz a NFE.io reenviar o mesmo evento.
- **Assinatura:** todo evento é assinado por HMAC no cabeçalho. Valide antes de processar — veja [Dúvidas frequentes](./duvidas-frequentes.md).

## Como descobrir qual evento chegou

| Origem | O que traz |
|---|---|
| Cabeçalho `X-Hook-Event` | o eventType (ex.: `service_invoice`) |
| Cabeçalho `X-Hook-Id` | identificador único da entrega — use para deduplicar |
| Cabeçalho `X-Hook-Attempts` | número da tentativa |
| Corpo (`flowStatus`/`status`) | o resultado da operação |

## Os dois envelopes

| eventType | Família | Envelope |
|---|---|---|
| `service_invoice` | Saída (NFS-e) | `{"payload": {...}}` |
| `product_invoice` | Saída (NF-e) | achatado na raiz |
| `consumer_invoice` | Saída (NFC-e) | achatado na raiz |
| `product_tax`, `tax_payment_form` | Saída (outros) | achatado na raiz |
| `product_invoice_inbound`, `*_summary` | Entrada | achatado na raiz |
| `transportation_invoice_inbound` | Entrada | achatado na raiz |
| `service_invoice_inbound` | Entrada | achatado na raiz (envelope próprio com `document`) |

## Eventos de saída

O que a sua conta emite. 24 eventos cobertos, agrupados por produto:

| Página | Produto | Eventos |
|---|---|---|
| [Catálogo de saída — NFS-e](./catalogo-saida/catalogo-saida-nfse.md) | Nota Fiscal de Serviço | 7 — emissão, cancelamento (sucesso e falha) |
| [Catálogo de saída — NF-e](./catalogo-saida/catalogo-saida-nfe.md) | Nota Fiscal Eletrônica | 11 — emissão, cancelamento, inutilização, Carta de Correção |
| [Catálogo de saída — NFC-e](./catalogo-saida/catalogo-saida-nfce.md) | Nota Fiscal de Consumidor | 5 — emissão, cancelamento |
| [Catálogo de saída — Outros eventos](./catalogo-saida/catalogo-saida-outros.md) | Regras fiscais e guias | 4 — `product_tax`, `tax_payment_form` |

## Eventos de entrada

O que a NFE.io captura contra o seu CNPJ. 10 eventos, em uma única página de referência:

| Página | Cobre |
|---|---|
| [Catálogo de entrada — Documentos recebidos](./catalogo-entrada/catalogo-entrada.md) | NF-e, resumo de NF-e, CT-e e NFS-e recebidos, incluindo manifestação do destinatário |

Para o guia didático dos eventos de entrada — com contexto de uso e exemplos de parsing — veja [Payloads de webhooks de documentos recebidos](./guias/payloads-de-entrada.md).

## Como validar a assinatura

Veja o exemplo de validação de HMAC em [Dúvidas frequentes](./duvidas-frequentes.md).

## Veja também

- [Payloads de emissão — regras gerais dos dois envelopes](./guias/payloads-de-emissao.md)
- [Como cadastrar um webhook](./como-cadastrar-consultar-listar-editar-e-excluir.md)
- [Conceitos](./conceitos.md)
- [IPs de origem](./ips-de-origem.md)