Campos Importantes da API
Interpretação de Campos Críticos
Esta seção explica os campos mais importantes da NFE API que são essenciais para o correto funcionamento da emissão de notas fiscais.
⚠️ ATENÇÃO: A configuração correta destes campos é
fundamental para a emissão válida de notas fiscais. Consulte sempre a
legislação tributária vigente.
| Campo | Descrição | Valores Possíveis | Importância |
|---|---|---|---|
invoice_type |
Tipo de empresa (pessoa jurídica/física) | juridica, fisica |
Alta - Define o regime tributário |
nature_of_operation |
Natureza da operação (venda, devolução, etc.) | Ex: VENDA, DEVOLUCAO |
Alta - Determina o CFOP |
transaction_type |
Tipo de transação (entrada/saída) | ENTRADA, SAIDA |
Alta - Direciona o fluxo fiscal |
model |
Modelo da nota fiscal | nfe, nfce |
Alta - Modelo do documento |
issuance_type |
Tipo de emissão (normal, contingência) | NORMAL, CONTINGENCIA |
Média - Modo de emissão |
ambiente |
Ambiente de processamento | PRODUCAO, HOMOLOGACAO |
Alta - Define Fisco destino |
cliente |
Tipo do cliente/comprador | CONSUMIDOR, CONTRIBUINTE |
Alta - Impacta nos impostos |
products.origem |
Origem do produto (nacional/importado) | 0 a 8 |
Alta - Determina tributação |
products.indicador_total |
Se o produto entra no total da NF | true, false |
Média - Para itens de amostra |
💡 DICA: Para produtos, o campo
origem é
crítico: 0-Nacional, 1-Estrangeira importação direta, 2-Estrangeira
adquirida no mercado interno, etc. Consulte a tabela completa de
origem de mercadorias.