---
title: "Eventos do documento fiscal"
description: "Um documento fiscal autorizado não é o fim de uma história — é o começo dela. NF-e, NFC-e, CT-e e NFS-e Nacional continuam tendo fatos registrados sobre si mesmos depois da autorização na NF-e modelo 55, o evento Atualização da Data de Previsão de Entrega da mercadoria — código 112150), cancela a operação, confirma que recebeu a mercadoria, ou declara uma informação exigida pela nova legislação tributária. Cada um desses fatos é um evento fiscal."
source_url: https://nfe.io/docs/documentacao/eventos-fiscais/eventos-do-documento-fiscal
last_updated: 2026-08-25
---

# Eventos do documento fiscal

Um documento fiscal autorizado não é o fim de uma história — é o começo dela. NF-e, NFC-e, CT-e e NFS-e Nacional continuam tendo fatos registrados sobre si mesmos depois da autorização: alguém corrige um dado (ex.: na NF-e modelo 55, o evento **Atualização da Data de Previsão de Entrega da mercadoria** — código `112150`), cancela a operação, confirma que recebeu a mercadoria, ou declara uma informação exigida pela nova legislação tributária. Cada um desses fatos é um **evento fiscal**.

:::info O modelo evolui com a legislação
Os eventos fiscais estão em expansão pela Reforma Tributária (NT 2025.002-RTC), cuja regulamentação segue o calendário oficial do governo. Esta página descreve o que está em vigor na data em `last_validated_at` — a NFE.io habilita novos eventos de forma alinhada aos marcos regulatórios, não conforme prontidão interna.
:::

## O que é um evento fiscal

Um evento fiscal é um documento eletrônico próprio, vinculado à chave de acesso de uma nota já autorizada. Ele tem:

- **Um código** (`tpEvento`), definido pela SEFAZ ou pelo Ambiente Nacional de NFS-e (ADN)
- **Um autor** — quem registra o evento
- **Uma sequência**, quando mais de um evento incide sobre a mesma nota
- **Um XML e um protocolo próprios**, distintos do XML de emissão da nota

Isso é diferente de um **webhook**. O evento fiscal é o fato; o webhook é como a NFE.io avisa você de que o fato aconteceu. Um cancelamento de NF-e, por exemplo, é o evento fiscal `110111` — e a notificação de que ele ocorreu chega pelo webhook `cancelled_successfully`. Confundir os dois é a fonte mais comum de mal-entendido em integrações com eventos fiscais.

## Quem pode fazer o quê

A NFE.io atua em três papéis diferentes diante de um evento fiscal, dependendo de quem é o autor:

| Papel | Quando ocorre | Exemplos |
|---|---|---|
| **Registrar** | Você é o autor — a NFE.io emite o evento em seu nome, sobre a sua própria nota | Cancelamento, Carta de Correção, os eventos da Reforma Tributária |
| **Observar** | Um terceiro ou o próprio fisco registrou o evento sobre uma nota que envolve você — a NFE.io captura essa informação para você | Cancelamento ou CC-e de um fornecedor, eventos do Ambiente Nacional sobre notas recebidas |
| **Agir** | Você é o destinatário de uma nota de terceiro e precisa se manifestar sobre ela | Confirmação da Operação, Ciência da Operação, Desconhecimento |

Os três papéis convivem porque a vida de uma nota fiscal não pertence só a quem a emitiu — o destinatário e o fisco também produzem fatos sobre ela.

## O modelo por tipo de documento

O comportamento dos eventos varia por tipo de documento fiscal. Use esta seção para saber o que se aplica ao documento com que você trabalha; o detalhe operacional de cada evento (endpoint, payload, webhook) está na [referência de eventos por documento](/documentacao/eventos-fiscais/matriz-de-eventos-fiscais/).

### NF-e (modelo 55)

O modelo mais completo — os três papéis se aplicam:

- **Registrar:** Cancelamento (`110111`), Carta de Correção (`110110`), Inutilização de numeração, Contingência EPEC — e os eventos da Reforma Tributária, descritos abaixo.
- **Agir:** manifestação do destinatário (`210200`, `210210`, `210220`, `210240`).
- **Observar:** eventos de terceiros e do fisco sobre notas que envolvem seu CNPJ, via captura (Inbound).

**Os eventos da Reforma Tributária pertencem a este subtópico: a NT 2025.002-RTC se aplica somente à NF-e (modelo 55) — não à NFC-e.** A NT definia 17 tipos de evento; a versão 1.51 revogou o `211120` (Destinação para consumo pessoal, LC 227/2026), restando 16 em vigor. Destes, **seis são de autoria do emitente e têm contrato publicado** — endpoint, payload e ciclo de vida assíncrono: Pagamento Integral (`112110`), Importação ALC/ZFM (`112120`), Perecimento (`112130`), Fornecimento não realizado (`112140`), Atualização da data de previsão de entrega (`112150`) e Cancelamento de evento (`110001`). Os dez restantes são de autoria do destinatário, de uma sucessora ou do fisco, e não fazem parte do escopo de implementação.

### NFC-e (modelo 65)

Somente o papel **Registrar**, com escopo reduzido: Cancelamento e Inutilização de numeração. Não há Carta de Correção para NFC-e, e os eventos da Reforma Tributária **não se aplicam** a este modelo.

### CT-e

A NFE.io atua no papel **Observar**: eventos registrados por terceiros ou pelo fisco sobre CT-e que envolvem seu CNPJ são capturados e notificados via [webhooks de Inbound](/distribuicao-nfe-cte-webhook/). O registro de eventos de CT-e como autor não faz parte do escopo atual.

### NFS-e Nacional (Ambiente Nacional)

Quando esta documentação cita **Ambiente Nacional (ADN)**, trata-se dos serviços do **padrão nacional de NFS-e**. Aqui se aplicam:

- **Registrar:** Cancelamento (`101101`) — único evento de emissão exposto hoje.
- **Agir:** confirmação ou rejeição pelo tomador (manifestação).
- **Observar:** eventos do Ambiente Nacional sobre notas recebidas, via captura.

Provedores municipais em layout próprio, fora do Ambiente Nacional, não participam deste modelo — ver [a fronteira importante](#uma-fronteira-importante) abaixo.

## O ciclo de vida de um evento

Do ponto de vista de quem registra um evento (papel Registrar), ele percorre os mesmos estágios de qualquer documento fiscal eletrônico:

```
Solicitado → Assinado → Transmitido → Autorizado ou Rejeitado
```

O processo abaixo mostra um caso concreto — o registro de um evento da Reforma Tributária sobre uma NF-e modelo 55 — relacionando o momento da ocorrência, a comunicação com o governo e os gatilhos de atuação via API:

```mermaid
sequenceDiagram
    autonumber
    participant C as Sua aplicação
    participant N as API NFE.io
    participant S as SEFAZ

    Note over C: O fato ocorre no mundo real (ex.: nova data de previsão de entrega)
    C->>N: POST .../productinvoices/{id}/authority-events
    N-->>C: 202 Accepted (evento enfileirado, status Pending)
    N->>N: Monta e assina o XML do evento (XmlSigned)
    N->>S: Transmite o evento (Sent)
    S-->>N: Protocolo de autorização (cStat 135/136)
    N->>N: Consolida o ciclo (Merged)
    N-->>C: Webhook dfe_event_successfully
    C->>N: GET .../authority-events/{eventId} (opcional)
    N-->>C: Evento com XML e protocolo completos
```

Na prática: **o gatilho é seu** (o `POST`, quando o fato ocorre), **a comunicação com o governo é da NFE.io** (assinatura, transmissão, protocolo), e **o desfecho volta para você** por webhook ou consulta. Um exemplo de envio e retorno para o evento do diagrama:

```json title="Envio — POST .../authority-events"
{
  "type": "ExpectedDeliveryUpdate",
  "expectedDeliveryDate": "2026-09-15T00:00:00-03:00"
}
```

```json title="Retorno — GET .../authority-events/{eventId} (após o ciclo concluir)"
{
  "id": "0e7a3f7c-2f4b-4c8e-9d15-6b2a9c1f0e42",
  "type": "ExpectedDeliveryUpdate",
  "status": "Merged",
  "protocol": {
    "accessKey": "53260846759666000129557180000000131525965352",
    "status": 135,
    "message": "Evento registrado e vinculado a NF-e",
    "eventType": 112150,
    "eventSequence": 1,
    "protocolNumber": "891260000012345",
    "appVersion": "AN_1.0.0",
    "stateCode": 91,
    "receiptOn": "2026-08-18T14:05:22-03:00"
  }
}
```

O payload campo a campo de cada tipo de evento, com as validações, está na [referência de eventos por documento](/documentacao/eventos-fiscais/matriz-de-eventos-fiscais/).

Um evento autorizado pode, em alguns casos, ser cancelado por um evento posterior — é o que ocorre, por exemplo, quando um evento da Reforma Tributária enviado por engano precisa ser desfeito.

:::info Recusa de entrega envolve dois eventos, de partes diferentes
Quando a mercadoria não é entregue (recusa do destinatário ou não localização), dois eventos distintos entram em jogo — não um só: **`210240`** (Operação não Realizada), registrado pelo **destinatário** via manifestação; e **`110192`**/**`110193`** (Insucesso na Entrega da NF-e / seu cancelamento), registrado pelo **transportador** ou pelo emitente após a tentativa (NT 2023.005, Ajuste SINIEF 49/2025). Cada um cobre uma parte diferente do fluxo — não são intercambiáveis nem duplicados.
:::

## Como você é notificado

O canal de notificação sobre eventos fiscais é o webhook. Cada família de documento tem seu próprio conjunto de ações — `cancelled_successfully`, `cce_successfully`, `event_raised_successfully`, entre outras — descritas na [referência de eventos por documento](/documentacao/eventos-fiscais/matriz-de-eventos-fiscais/). Você também pode consultar o histórico de eventos de uma nota diretamente pela API, sem depender de webhook.

## Como a Reforma Tributária expande o modelo

Até a NT 2025.002-RTC, os eventos fiscais eram majoritariamente corretivos ou declaratórios — corrigir um dado, cancelar uma operação, confirmar ou negar uma operação. A Reforma Tributária muda essa natureza: eventos como pagamento integral, perecimento de mercadoria ou fornecimento não realizado passam a **alimentar diretamente a apuração de crédito de IBS e CBS**. O evento deixa de ser uma exceção do ciclo de vida da nota e passa a fazer parte do fluxo fiscal ordinário.

Para acompanhar essa mudança de natureza, a NFE.io construiu uma estrutura genérica de eventos — em vez de tratar cada novo tipo isoladamente, a plataforma já publica o contrato de registro assim que a norma o define, e habilita o registro efetivo em sincronia com os marcos regulatórios oficiais. A relação completa dos tipos, sua vigência e a autoria de cada um estão no subtópico [NF-e (modelo 55)](#nf-e-modelo-55) acima e, evento a evento, na [referência](/documentacao/eventos-fiscais/matriz-de-eventos-fiscais/).

## Uma fronteira importante

Nem todo emissor de documento fiscal tem acesso a este modelo de eventos. Provedores municipais de NFS-e em layout próprio (fora do Ambiente Nacional) não têm um modelo de eventos fiscais equivalente ao da NF-e — cancelamento, quando existe, segue outro fluxo, sem XML de evento dedicado.

## Próximos passos

- [Referência: eventos por tipo de documento](/documentacao/eventos-fiscais/matriz-de-eventos-fiscais/) — o que está disponível hoje, por evento
- [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/)
- [Webhook events — NFe/CTe Inbound](/distribuicao-nfe-cte-webhook/)