---
title: "Referência: eventos por tipo de documento"
description: "Esta página lista os eventos fiscais que a NFE.io processa hoje, organizados pelo modelo de eventos do documento fiscal. Para cada evento: o código, quem o registra, como registrá-lo ou consultá-lo, e qual webhook notifica sobre ele."
source_url: https://nfe.io/docs/documentacao/eventos-fiscais/matriz-de-eventos-fiscais
last_updated: 2026-08-25
---

# Referência: eventos por tipo de documento

Esta página lista os eventos fiscais que a NFE.io processa hoje, organizados pelo [modelo de eventos do documento fiscal](/documentacao/eventos-fiscais/eventos-do-documento-fiscal/). Para cada evento: o código, quem o registra, como registrá-lo ou consultá-lo, e qual webhook notifica sobre ele.

:::info O modelo evolui com a legislação
Os eventos fiscais estão em expansão pela Reforma Tributária, cujo cronograma é definido pelo governo. As linhas marcadas **Contrato publicado — habilitação alinhada ao calendário oficial** já têm especificação técnica completa; a ativação segue os marcos regulatórios.
:::

## Papel Registrar — você é o autor

### NF-e e NFC-e

| Evento | Código | Aplica-se a | Como registrar | Webhook | Status |
|---|---|---|---|---|---|
| Cancelamento | `110111` | NF-e e NFC-e | `DELETE /v2/companies/{companyId}/productinvoices/{invoiceId}` (ou `consumerinvoices`) | `cancelled_successfully` / `cancelled_error` / `cancelled_failed` | Disponível |
| Carta de Correção | `110110` | Somente NF-e | `PUT /v2/companies/{companyId}/productinvoices/{invoiceId}/correctionletter` | `cce_successfully` / `cce_error` / `cce_failed` | Disponível |
| Inutilização de numeração | — | NF-e e NFC-e | `POST /v2/companies/{companyId}/productinvoices/{invoiceId}/disablement` (por nota ou faixa) | `disabled_successfully` / `disabled_error` / `disabled_failed` | Disponível |
| Contingência (EPEC) | — | Somente NF-e | Modalidade de emissão automática — não é uma chamada separada. Consulta: `GET /v2/companies/{companyId}/productinvoices/{invoiceId}/xml-epec` | Reusa o webhook de emissão | Disponível |

### Eventos da Reforma Tributária (NT 2025.002-RTC) — autoria do emitente

Seis eventos registráveis. Um único endpoint registra todos: `POST /v2/companies/{companyId}/productinvoices/{invoiceId}/authority-events`, com o corpo escolhido pelo campo `type` (case-sensitive) — os campos de cada tipo vão na raiz do corpo, sem agrupamento aninhado. Válido apenas para NF-e (modelo 55); a NT não se aplica a NFC-e.

| Evento | Código | Webhook | Status |
|---|---|---|---|
| Pagamento Integral | `112110` | `dfe_event_successfully` / `error` / `failed` | Contrato publicado — habilitação alinhada ao calendário oficial |
| Importação ALC/ZFM | `112120` | idem | Contrato publicado — habilitação alinhada ao calendário oficial |
| Perecimento (CIF) | `112130` | idem | Contrato publicado — habilitação alinhada ao calendário oficial |
| Fornecimento não realizado | `112140` | idem | Contrato publicado — habilitação alinhada ao calendário oficial |
| Atualização da data de previsão de entrega | `112150` | idem | Contrato publicado — habilitação alinhada ao calendário oficial |
| Destinação para consumo pessoal | `211120` | — | **Revogado** — LC 227/2026 (NT 2025.002-RTC v1.51); a API recusa o registro |
| Cancelamento de evento | `110001` | `dfe_event_cancelled` | Contrato publicado — habilitação alinhada ao calendário oficial |

#### Payload por tipo

**Pagamento Integral (`IntegralPayment`, 112110)**

| Campo | Tipo | Regra |
|---|---|---|
| `indicator` | string (enum) | Único valor aceito hoje: `Settled` |

**Atualização da data de previsão de entrega (`ExpectedDeliveryUpdate`, 112150)**

| Campo | Tipo | Regra |
|---|---|---|
| `expectedDeliveryDate` | string (data-hora) | Obrigatório |

**Perecimento — CIF (`Spoilage`, 112130)**

| Campo | Tipo | Regra |
|---|---|---|
| `items` | lista | Ao menos 1 item |
| `items[].itemNumber` | inteiro | Maior que zero — número do item na NF-e original |
| `items[].ibsAmount`, `cbsAmount` | decimal | Maior ou igual a zero |
| `items[].spoilageQuantity` | decimal | Maior que zero |
| `items[].spoilageUnit` | string | Obrigatório |
| `items[].inventoryIbsAmount`, `inventoryCbsAmount` | decimal | Maior ou igual a zero — valores no controle de estoque |

**Fornecimento não realizado (`UnfulfilledSupply`, 112140)**

Mesma estrutura de `Spoilage`, trocando `spoilageQuantity`/`spoilageUnit` por `unfulfilledQuantity`/`unfulfilledUnit`.

**Importação ALC/ZFM (`AlcZfmImport`, 112120)**

| Campo | Tipo | Regra |
|---|---|---|
| `items` | lista | Ao menos 1 item |
| `items[].itemNumber` | inteiro | Maior que zero |
| `items[].ibsAmount`, `cbsAmount` | decimal | Maior ou igual a zero |
| `items[].consumptionQuantity` | decimal | Maior que zero |
| `items[].consumptionUnit` | string | Obrigatório |
| `items[].referencedAccessKey` | string | Exatamente 44 dígitos numéricos — chave de acesso da NF-e referenciada |
| `items[].referencedItem` | inteiro | Maior que zero — item dentro da NF-e referenciada |

**Cancelamento de evento (`CancelDFeEvent`, 110001)**

| Campo | Tipo | Regra |
|---|---|---|
| `targetEventId` | string (uuid) | Id do evento a cancelar, obtido na consulta |
| `reason` | string | De 15 a 1000 caracteres |

Só é possível cancelar um evento com status `Merged` que ainda não tenha sido cancelado. O tipo e o protocolo do evento alvo são derivados automaticamente a partir do `targetEventId` — não são aceitos como entrada.

#### Ciclo de vida e resposta

Registro é assíncrono: o `POST` responde `202` confirmando apenas o enfileiramento. O resultado chega por webhook ou por consulta ao evento.

| Status do evento | Significado |
|---|---|
| `Pending` | Registrado, aguardando envio ao SEFAZ |
| `XmlSigned` | XML assinado e armazenado |
| `Sent` | Transmitido ao SEFAZ, protocolo capturado |
| `Merged` | Ciclo concluído, XML do evento disponível |
| `Failed` | Falha terminal |
| `Cancelled` | Anulado por um evento de cancelamento |

A resposta de cada evento inclui um objeto `protocol` com o retorno da SEFAZ: `accessKey`, `status` (cStat), `message`, `eventType`, `eventSequence`, `protocolNumber`, `appVersion`, `stateCode` e `receiptOn`. `GET .../authority-events` (lista) retorna apenas eventos com protocolo `status` 135, 136 ou 155 — eventos em processamento não aparecem ali; para acompanhá-los, consulte por id.

Além destes, a NT 2025.002-RTC define outros dez tipos de evento, de autoria do destinatário, de uma sucessora na operação ou do fisco. Esses eventos são registrados por outra parte da relação fiscal, não pelo emitente — por isso não fazem parte do escopo atual de implementação da NFE.io:

| Código | Evento | Autor |
|---|---|---|
| `211110` | Solicitação de apropriação de crédito presumido | Destinatário |
| `211124` | Perecimento no transporte contratado pelo adquirente | Destinatário |
| `211128` | Aceite de débito na apuração por nota de crédito | Destinatário |
| `211130` | Imobilização de item | Destinatário |
| `211140` | Solicitação de apropriação de crédito de combustível | Destinatário |
| `211150` | Solicitação de apropriação de crédito vinculada à atividade do adquirente | Destinatário |
| `212110` | Transferência de crédito de IBS em sucessão | Sucessora |
| `212120` | Transferência de crédito de CBS em sucessão | Sucessora |
| `412120` | Manifestação do fisco — crédito de IBS em sucessão | Fisco |
| `412130` | Manifestação do fisco — crédito de CBS em sucessão | Fisco |

Status: **Previsto na NT 2025.002-RTC**.

### NFS-e Nacional

| Evento | Código | Como registrar | Webhook | Status |
|---|---|---|---|---|
| Cancelamento | `101101` | `DELETE /v1/companies/{companyId}/serviceinvoices/{id}` — XML do evento: `GET .../serviceinvoices/{id}/cancellation-xml` | `cancelled_successfully` / `cancelled_error` / `cancelled_failed` | Disponível |

O cancelamento de NFS-e Nacional é o único evento de emissão implementado e exposto hoje para este tipo de documento.

:::info Provedores fora do Ambiente Nacional
Provedores municipais em layout próprio, fora do Ambiente Nacional, não têm evento de cancelamento com XML dedicado.
:::

## Papel Observar — eventos de terceiros e do fisco

A NFE.io captura, para você, eventos registrados por outras partes sobre notas que envolvem seu CNPJ. O catálogo completo, por área (NF-e/CT-e e NFS-e), está em:

- [Webhook events — NFe/CTe Inbound](/distribuicao-nfe-cte-webhook/)
- [Catálogo de eventos — NFS-e Inbound](/distribuicao-nfse-inbound-webhook/)

## Papel Agir — manifestação do destinatário

### NF-e

| Evento | Código | Como registrar |
|---|---|---|
| Confirmação da Operação | `210200` | `POST /v2/companies/{companyId}/inbound/productinvoices/by-access-key/{accessKey}/manifestation-events` |
| Ciência da Operação | `210210` | idem |
| Desconhecimento da Operação | `210220` | idem |
| Operação não Realizada | `210240` | idem (exige justificativa de 15 a 255 caracteres) |

Status: Disponível. Não há validação de prazo ou de ordem entre os tipos de manifestação.

### NFS-e

| Evento | Como registrar | Status |
|---|---|---|
| Confirmação ou rejeição pelo tomador | `POST /v2/companies/{companyId}/inbound/nfse/by-access-key/{accessKey}/manifestations` | Disponível |

A manifestação do tomador é registrada manualmente, por chamada explícita. O agendamento automático de manifestação está previsto e ainda não está disponível.

## Desambiguação: dois códigos de cancelamento

O evento `110001` (Reforma Tributária, NF-e) e o evento `101101` (cancelamento de NFS-e Nacional) têm propósitos completamente diferentes, apesar de ambos tratarem de cancelamento:

- **`110001`** cancela **um evento da Reforma Tributária já registrado** — por exemplo, desfazer um Pagamento Integral enviado por engano. Não cancela a nota fiscal.
- **`101101`** cancela **a própria NFS-e**.

São eventos de documentos diferentes (NF-e modelo 55 e NFS-e Nacional), sob normas diferentes, sem relação entre si.

## Próximos passos

- [Eventos do documento fiscal](/documentacao/eventos-fiscais/eventos-do-documento-fiscal/) — o modelo conceitual
- [Fluxos de eventos e apuração do IBS/CBS](/documentacao/eventos-fiscais/fluxos-eventos-ibs/) — cenários de negócio, do fluxo ao efeito na apuração
- [Conformidade normativa e disponibilidade](/documentacao/eventos-fiscais/conformidade-normativa/) — o que já está em produção, por Nota Técnica
- [Payloads dos webhooks de emissão](/documentacao/webhooks/payloads-de-emissao/)
- [Payloads dos webhooks de entrada](/documentacao/webhooks/payloads-de-entrada/)