API重要字段
关键字段解释
本部分解释了NFE API中最重要且对正确发行发票至关重要的字段。
⚠️ 注意:这些字段的正确配置对于有效发行发票至关重要。请始终参考现行税务法规。
| 字段 | 描述 | 可能值 | 重要性 |
|---|---|---|---|
invoice_type |
公司类型(法人/自然人) | juridica, fisica |
高 - 定义税收制度 |
nature_of_operation |
操作性质(销售、退货等) | 例如:VENDA, DEVOLUCAO |
高 - 确定CFOP |
transaction_type |
交易类型(进/出) | ENTRADA, SAIDA |
高 - 引导税务流程 |
model |
发票模型 | nfe, nfce |
高 - 文档模型 |
issuance_type |
发行类型(正常、应急) | NORMAL, CONTINGENCIA |
中 - 发行模式 |
ambiente |
处理环境 | PRODUCAO, HOMOLOGACAO |
高 - 定义税务局目的地 |
cliente |
客户/买方类型 | CONSUMIDOR, CONTRIBUINTE |
高 - 影响税款 |
products.origem |
产品来源(国内/进口) | 0 至 8 |
高 - 決定征税 |
products.indicador_total |
产品是否计入发票总额 | true, false |
中 - 用于样品项目 |
💡 提示:对于产品,
origem字段至关重要:0-国内,1-直接进口外国产品,2-在国内市场购买的外国产品等。请参考完整的商品来源表。