Tax360Developers
Get startedAPI reference
NFS-e

Machine translation, not yet reviewed.

NFS-e — event types

Event with no additional fields besides the description.

Reference document — Complete list of NFS-e events with their specific fields and possible values, according to the tiposEventos_v1.01.xsd schema.

Summary

CodeXML tagDescription
101101e101101NFS-e Cancellation
105102e105102NFS-e Cancellation by Substitution
101103e101103Request for Tax Analysis for NFS-e Cancellation
105104e105104NFS-e Cancellation Granted by Tax Analysis
105105e105105NFS-e Cancellation Denied by Tax Analysis
202201e202201NFS-e Manifestation — Provider Confirmation
203202e203202NFS-e Manifestation — Recipient Confirmation
204203e204203NFS-e Manifestation — Intermediary Confirmation
205204e205204NFS-e Manifestation — Tacit Confirmation
202205e202205NFS-e Manifestation — Provider Rejection
203206e203206NFS-e Manifestation — Recipient Rejection
204207e204207NFS-e Manifestation — Intermediary Rejection
205208e205208NFS-e Manifestation — Annulment of Rejection
305101e305101Ex Officio NFS-e Cancellation
305102e305102Ex Officio NFS-e Blocking
305103e305103Ex Officio NFS-e Unblocking

1. Cancellation Events

1.1. NFS-e Cancellation — e101101

FieldRequiredDescription
xDescYesFixed value: "Cancelamento de NFS-e".
cMotivoYesCancellation justification code.
xMotivoYesFree text describing the reason.

Values of cMotivo:

ValueDescription
1Issuance Error
2Service Not Provided
9Other

1.2. Cancellation by Substitution — e105102

FieldRequiredDescription
xDescYesFixed value: "Cancelamento de NFS-e por Substituição".
cMotivoYesJustification code for the cancellation by substitution.
xMotivoNoFree text describing the reason.
chSubstitutaYesAccess key of the replacement NFS-e.

Values of cMotivo:

ValueDescription
01NFS-e removed from Simples Nacional
02NFS-e included in Simples Nacional
03Retroactive Inclusion of Immunity/Exemption for NFS-e
04Retroactive Exclusion of Immunity/Exemption for NFS-e
05Rejection of NFS-e by the recipient or intermediary responsible for paying the tax
99Other

1.3. Request for Tax Analysis for Cancellation — e101103

FieldRequiredDescription
xDescYesFixed value: "Solicitação de Análise Fiscal para Cancelamento de NFS-e".
cMotivoYesRequest reason code.
xMotivoYesFree text describing the reason.

Values of cMotivo:

ValueDescription
1Issuance Error
2Service Not Provided
9Other

1.4. Cancellation Granted by Tax Analysis — e105104

FieldRequiredDescription
xDescYesFixed value: "Cancelamento de NFS-e Deferido por Análise Fiscal".
CPFAgTribYesCPF of the municipal tax administration agent who granted the cancellation.
nProcAdmNoNumber of the municipal administrative proceeding linked to the request.
cMotivoYesTax analysis response.
xMotivoYesFree text describing the reason.

Values of cMotivo:

ValueDescription
1NFS-e Cancellation Granted

1.5. Cancellation Denied by Tax Analysis — e105105

FieldRequiredDescription
xDescYesFixed value: "Cancelamento de NFS-e Indeferido por Análise Fiscal".
CPFAgTribYesCPF of the municipal tax administration agent who denied the cancellation.
nProcAdmNoNumber of the municipal administrative proceeding linked to the request.
cMotivoYesTax analysis response.
xMotivoYesFree text describing the reason.

Values of cMotivo:

ValueDescription
1NFS-e Cancellation Denied
2NFS-e Cancellation Denied Without Analysis of Merit

2. Manifestation Events — Confirmation

2.1. Provider Confirmation — e202201

FieldRequiredDescription
xDescYesFixed value: "Manifestação de NFS-e - Confirmação do Prestador".

Event with no additional fields besides the description.

2.2. Recipient Confirmation — e203202

FieldRequiredDescription
xDescYesFixed value: "Manifestação de NFS-e - Confirmação do Tomador".

Event with no additional fields besides the description.

2.3. Intermediary Confirmation — e204203

FieldRequiredDescription
xDescYesFixed value: "Manifestação de NFS-e - Confirmação do Intermediário".

Event with no additional fields besides the description.

2.4. Tacit Confirmation — e205204

FieldRequiredDescription
xDescYesFixed value: "Manifestação de NFS-e - Confirmação Tácita".

Event with no additional fields besides the description. Generated automatically by the system when no manifestation is registered within the deadline.

3. Manifestation Events — Rejection

3.1. Provider Rejection — e202205

FieldRequiredDescription
xDescYesFixed value: "Manifestação de NFS-e - Rejeição do Prestador".
cMotivoYesRejection reason code.
xMotivoNoFree text describing the reason.

Values of cMotivo:

ValueDescription
1Duplicate NFS-e
2NFS-e already issued by the recipient
3Taxable event did not occur
4Error regarding tax liability
5Error regarding the service amount, deductions amount, service provided or taxable event date
9Other

3.2. Recipient Rejection — e203206

FieldRequiredDescription
xDescYesFixed value: "Manifestação de NFS-e - Rejeição do Tomador".
cMotivoYesRejection reason code.
xMotivoNoFree text describing the reason.

Values of cMotivo: same as section 3.1.

3.3. Intermediary Rejection — e204207

FieldRequiredDescription
xDescYesFixed value: "Manifestação de NFS-e - Rejeição do Intermediário".
cMotivoYesRejection reason code.
xMotivoNoFree text describing the reason.

Values of cMotivo: same as section 3.1.

3.4. Annulment of Rejection — e205208

FieldRequiredDescription
xDescYesFixed value: "Manifestação de NFS-e - Anulação da Rejeição".
CPFAgTribYesCPF of the municipal tax administration agent who annulled the rejection.
idEvManifRejYesReference to the Id of the rejection event that gave rise to this annulment.
xMotivoYesFree text describing the reason for the annulment.

4. Ex Officio Events

4.1. Ex Officio Cancellation — e305101

FieldRequiredDescription
xDescYesFixed value: "Cancelamento de NFS-e por Ofício".
CPFAgTribYesCPF of the municipal tax administration agent who performed the cancellation.
nProcAdmYesNumber of the municipal administrative proceeding linked to the cancellation.
xProcAdmYesFree text describing the reason for the administrative proceeding.

4.2. Ex Officio Blocking — e305102

FieldRequiredDescription
xDescYesFixed value: "Bloqueio de NFS-e por Ofício".
CPFAgTribYesCPF of the municipal tax administration agent who performed the blocking.
codEventoYesCode of the event type that will be blocked for this NFS-e.
xMotivoYesFree text describing the reason for the blocking.

Values of codEvento:

ValueDescription
e101101NFS-e Cancellation
e105102NFS-e Cancellation by Substitution
e105104NFS-e Cancellation Granted by Tax Analysis
e105105NFS-e Cancellation Denied by Tax Analysis
e305101Ex Officio NFS-e Cancellation

4.3. Ex Officio Unblocking — e305103

FieldRequiredDescription
xDescYesFixed value: "Desbloqueio de NFS-e por Ofício".
CPFAgTribYesCPF of the municipal tax administration agent who performed the unblocking.
idBloqOficYesReference to the Id of the ex officio blocking event that gave rise to this unblocking.

Source: tiposEventos_v1.01.xsd

NFS-e JSON — fields and structures reference

Endpoint: GET /api/integration/dfe/nfse/inbound/documentos (with json=true) OpenAPI reference: NFS-e Public API

NFS-e document and event reconciliation

The documents (/inbound/documentos) and events (/inbound/eventos) endpoints operate independently. The client consumes each one in its own…

On this page

Summary1. Cancellation Events1.1. NFS-e Cancellation — e1011011.2. Cancellation by Substitution — e1051021.3. Request for Tax Analysis for Cancellation — e1011031.4. Cancellation Granted by Tax Analysis — e1051041.5. Cancellation Denied by Tax Analysis — e1051052. Manifestation Events — Confirmation2.1. Provider Confirmation — e2022012.2. Recipient Confirmation — e2032022.3. Intermediary Confirmation — e2042032.4. Tacit Confirmation — e2052043. Manifestation Events — Rejection3.1. Provider Rejection — e2022053.2. Recipient Rejection — e2032063.3. Intermediary Rejection — e2042073.4. Annulment of Rejection — e2052084. Ex Officio Events4.1. Ex Officio Cancellation — e3051014.2. Ex Officio Blocking — e3051024.3. Ex Officio Unblocking — e305103