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. Para cada evento: o código, quem o registra, como registrá-lo ou consultá-lo, e qual webhook notifica sobre ele.

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.

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
• Catálogo de eventos — NFS-e Inbound

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 — o modelo conceitual
• Fluxos de eventos e apuração do IBS/CBS — cenários de negócio, do fluxo ao efeito na apuração
• Conformidade normativa e disponibilidade — o que já está em produção, por Nota Técnica
• Payloads dos webhooks de emissão
• Payloads dos webhooks de entrada