Important API Fields
Critical Field Interpretation
This section explains the most important fields of the NFE API that are essential for the correct functioning of invoice issuance.
⚠️ ATTENTION: Correct configuration of these fields
is fundamental for valid invoice issuance. Always consult current tax
legislation.
| Field | Description | Possible Values | Importance |
|---|---|---|---|
invoice_type |
Company type (legal entity/individual) | juridica, fisica |
High - Defines tax regime |
nature_of_operation |
Nature of operation (sale, return, etc.) | Ex: SALE, RETURN |
High - Determines CFOP |
transaction_type |
Transaction type (input/output) | INPUT, OUTPUT |
High - Directs fiscal flow |
model |
Invoice model | nfe, nfce |
High - Document model |
issuance_type |
Issuance type (normal, contingency) | NORMAL, CONTINGENCY |
Medium - Issuance mode |
ambiente |
Processing environment | PRODUCTION, HOMOLOGATION |
High - Defines destination tax authority |
cliente |
Customer/buyer type | CONSUMER, TAXPAYER |
High - Impacts taxes |
products.origem |
Product origin (national/imported) | 0 to 8 |
High - Determines taxation |
products.indicador_total |
Whether product enters invoice total | true, false |
Medium - For sample items |
💡 TIP: For products, the
origem field
is critical: 0-National, 1-Foreign direct import, 2-Foreign acquired
in domestic market, etc. Consult the complete table of merchandise
origin.