NF-e Issuance
NF-e Statuses
draft → pending → processing → issued
↓ (error) → error
issued → pending_cancel → canceling → canceled
↓ (error) → error
| Status | Description |
|---|---|
| draft | Draft, not yet submitted |
| pending | Queued for issuance |
| processing | Being processed by the provider (async) |
| issued | Successfully issued |
| pending_cancel | Marked for cancellation |
| canceling | Cancellation in progress |
| canceled | Successfully canceled |
| error | Issuance/cancellation failed after exhausting attempts |
NF-e Fields
Identification
| Field | Description |
|---|---|
| Invoice | Associated invoice |
| Billing account | Customer |
| Company | Issuing company |
Numbers and Keys
| Field | Description |
|---|---|
| NF-e number | Sequential number |
| Series | NF-e series |
| Key | 44-digit key |
| Verification code | For lookup |
| RPS number | Provisional Service Receipt |
Service
| Field | Description |
|---|---|
| Amount (cents) | Service amount |
| Service code | LC 116/2003 code |
| Description | Description of the service provided |
| CNAE code | Activity classification |
| NBS code | Brazilian Nomenclature of Services |
Taxes
The NF-e stores the breakdown of calculated taxes:
- ISS (rate and amount)
- PIS, COFINS, CSLL
- IRRF
- INSS
URLs
| Field | Description |
|---|---|
| XML URL | Download the invoice XML |
| PDF URL | Download the DANFE in PDF |
Customer Snapshot
The NF-e stores a snapshot of the customer data at the time of issuance:
- Name, document, email, phone
- Full address with IBGE city code
This ensures the invoice reflects the correct data even if the customer updates their information later.
Audit Trail
Each HTTP request made to the provider is recorded in NfeRequestTry:
- Action (issue, cancel, query)
- Endpoint called
- Complete request and response
- HTTP status
- Duration in milliseconds
- Result (success/failure)