NF-e
开具 NF-e
受理即返回,异步向 SEFAZ 授权。
/openapi/v2/empresas/{empresaId}/nf-etoken、timestamp、sign 三个签名头,参见认证与签名。路径参数
empresaId* | string | 开票主体标识 |
* 必填字段
请求体
id* | string | 请求标识 |
ambienteEmissao* | string | 开票环境 |
finalidade | string | 开票目的 |
*退货、补充、调整票必填。 | object | 原票引用 |
naturezaOperacao | string | 操作性质描述 |
consumidorFinal | bool | 最终消费者标记 |
informacoesAdicionais | string | 票面备注 |
informacoesAdicionaisFisco | string | 税务机关备注 |
* | object | 订单信息 |
* | object | 买方 |
* | array | 商品行 |
| object | 运输信息 |
| object | 账单分期 |
*出口票必填。 | object | 出境信息 |
* 必填字段
AguardandoAutorizacao。无响应体
Simples Nacional 商家(CRT 1)线上卖给个人。只需要例子里的五个块;下面的字段表只列要填的字段,没列出来的都不用传。
{"id": "NFe-000014553","ambienteEmissao": "Homologacao","pedido": {"presencaConsumidor": "OperacaoPelaInternet","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 56.94 } ] }},"cliente": {"tipoPessoa": "F", "nome": "Cliente Demo", "email": "cliente.demo@mail.com", "cpfCnpj": "88533234775","endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Rua Presidente Wilson", "numero": "911", "bairro": "Uberaba", "cep": "81570440" }},"itens": [{"cfop": "6102", "codigo": "000068", "descricao": "Pendrive 16GB", "ncm": "85235190","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 28.47,"impostos": {"icms": { "situacaoTributaria": "102" },"pis": { "situacaoTributaria": "49" },"cofins": { "situacaoTributaria": "49" }}}]}
id* | string | 请求标识 |
ambienteEmissao* | string | 开票环境 |
* | object | 订单信息 |
* | object | 买方 |
* | array | 商品行 |
* 必填字段
一般税制公司(CRT 3)州内卖给个人。结构与简易票相同,只有 impostos 块不同:改用两位 CST 并带税率。卖给企业时看表里的 cliente.inscricaoEstadual 与 indicadorContribuinteICMS。
{"id": "NFe-000014560","ambienteEmissao": "Producao","pedido": {"presencaConsumidor": "OperacaoPelaInternet","pagamento": { "formas": [ { "tipo": "CartaoDeCredito", "valor": 100.00 } ] }},"cliente": {"tipoPessoa": "F", "nome": "Cliente Demo", "cpfCnpj": "88533234775","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" }},"itens": [{"cfop": "5102", "codigo": "SKU-100", "descricao": "Produto demo", "ncm": "85235190", "origem": 0,"quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 50.00,"impostos": {"icms": { "situacaoTributaria": "00", "aliquota": 18 },"pis": { "situacaoTributaria": "01", "aliquota": 1.65 },"cofins": { "situacaoTributaria": "01", "aliquota": 7.6 }}}]}
id* | string | 请求标识 |
ambienteEmissao* | string | 开票环境 |
* | object | 订单信息 |
* | object | 买方 |
* | array | 商品行 |
* 必填字段
简易票之外的一切都是可选的;不传时出票结果与场景二完全一致。可用的组:
naturezaOperacao、consumidorFinal、informacoesAdicionais、informacoesAdicionaisFisco:票头与备注。pedido.intermediadorTransacao:居间成交的电商平台(只在在场方式为互联网 / 店外现场 / 其他时可传)。pedido.pagamento.tipo(PagamentoAVista·PagamentoAPrazo)、troco、formas[].descricao、已对接的credenciadoraCartao(cnpj+bandeira+codigoAutorizacao)。cliente.indicadorContribuinteICMS、inscricaoMunicipal;出口票用cliente.idEstrangeiro、endereco.uf=EX、endereco.codigoPais、endereco.pais与exportacao。transporte:frete.modalidade(见运输小节)、transportadora、veiculo、reboques、volumes、retencaoIcms、enderecoEntrega。cobranca:fatura与parcelas(分期合计 = 净额)。itens[].valorFrete、valorSeguro、valorOutrasDespesas、producaoEmEscala、cnpjFabricante、informacoesAdicionais、pedido、impostos.impostoSeletivo。
下面各小节按场景给出每个组的例子和要填的字段;违反规则返回 10004031 并附字段路径。
{"id": "NFe-000014554","ambienteEmissao": "Producao","naturezaOperacao": "Venda de mercadoria","consumidorFinal": false,"informacoesAdicionais": "Pedido loja 77 - entrega em 5 dias uteis","informacoesAdicionaisFisco": "ICMS recolhido conforme regime normal","pedido": {"presencaConsumidor": "OperacaoPelaInternet","intermediadorTransacao": { "cnpj": "12345678000195", "identificadorCadastro": "seller-778899" },"pagamento": {"tipo": "PagamentoAPrazo","troco": 0,"formas": [{ "tipo": "BoletoBancario", "valor": 60.00 },{ "tipo": "CartaoDeCredito", "valor": 44.50, "credenciadoraCartao": { "tipoIntegracaoPagamento": "IntegradoAoSistemaDeGestao", "cnpj": "01027058000191", "bandeira": "Mastercard", "codigoAutorizacao": "123456" } }]}},"cliente": {"tipoPessoa": "J", "nome": "Revenda Demo LTDA", "cpfCnpj": "11222333000181", "inscricaoEstadual": "123456789012","indicadorContribuinteICMS": "ContribuinteICMS", "inscricaoMunicipal": "123456","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" }},"transporte": {"frete": { "modalidade": "PorContaDoEmitente" },"transportadora": { "cpfCnpj": "12345678000195", "nome": "Transportadora Demo LTDA", "inscricaoEstadual": "123456789", "enderecoCompleto": "Rua A, 10", "cidade": "Sao Paulo", "uf": "SP" },"veiculo": { "placa": "ABC1D23", "uf": "SP", "rntc": "000123456" },"volumes": [ { "quantidade": 2, "especie": "CAIXA", "marca": "MARCA X", "numeracao": "001-002", "pesoLiquido": 1.250, "pesoBruto": 1.500 } ],"enderecoEntrega": { "cpfCnpj": "11222333000181", "nome": "Deposito Demo", "uf": "SP", "cidade": "3550308", "logradouro": "Rua B", "numero": "20", "bairro": "Centro", "cep": "01001000", "telefone": "11999990000" }},"cobranca": {"fatura": { "numero": "FAT-2026-001", "valorOriginal": 104.50, "desconto": 0, "valorLiquido": 104.50 },"parcelas": [ { "numero": "001", "vencimento": "2026-10-30", "valor": 52.25 }, { "numero": "002", "vencimento": "2026-11-30", "valor": 52.25 } ]},"itens": [{"cfop": "5102", "codigo": "SKU-100", "descricao": "Produto demo", "ncm": "85235190", "origem": 0,"quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 50.00, "valorDesconto": 0,"valorFrete": 3.00, "valorSeguro": 1.00, "valorOutrasDespesas": 0.50,"informacoesAdicionais": "Lote 2026-09","pedido": { "numero": "PO-778899", "numeroItem": 3 },"impostos": {"icms": { "situacaoTributaria": "20", "aliquota": 18, "percentualReducaoBase": 33.33, "codigoBeneficioFiscal": "SP800001" },"pis": { "situacaoTributaria": "01", "aliquota": 1.65 },"cofins": { "situacaoTributaria": "01", "aliquota": 7.6 }}}]}
不传即 Normal,就是场景一到三的普通销售。另外三个取值都要引用一张本平台本主体已授权的原票:Devolucao 退货,Complementar 补金额、数量或税额,Ajuste 做无货物流转的调整。三种各自的写法见下。
Complementar:给已授权的原票补开
原票的价格、数量或税额开少了时用。它是一张普通的销项票,在票头引用原票;商品行只写差额(少开的价或量),税按差额算,支付覆盖这笔差额。商品行不要带 notaReferenciada(10004022)。缺 notaReferenciada.chaveAcesso 会被拒(10004028)。
{"id": "NFe-000014561-C","ambienteEmissao": "Producao","finalidade": "Complementar","notaReferenciada": { "chaveAcesso": "35241104893402000113550020000002621202427463" },"pedido": {"presencaConsumidor": "OperacaoPelaInternet","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 20.00 } ] }},"cliente": {"tipoPessoa": "F", "nome": "Cliente Demo", "cpfCnpj": "88533234775","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" }},"itens": [{"cfop": "5102", "codigo": "SKU-100", "descricao": "Produto demo - complemento de preco", "ncm": "85235190","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 10.00,"impostos": {"icms": { "situacaoTributaria": "00", "aliquota": 18 },"pis": { "situacaoTributaria": "01", "aliquota": 1.65 },"cofins": { "situacaoTributaria": "01", "aliquota": 7.6 }}}]}
finalidade* | string | 开票目的 |
* | object | 原票引用 |
naturezaOperacao | string | 操作性质描述 |
pedido* | object | 订单信息 |
cliente* | object | 买方 |
* | array | 商品行 |
* 必填字段
Ajuste:对已授权的原票做调整
没有货物流转的票,用来修正已授权原票的税额或库存。票头引用原票,没有支付(在场方式按 NaoSeAplica,支付按 SemPagamento,和退货票一样),出口票不能用。商品行写被调整的内容,原因写在 informacoesAdicionais。每种情形的 CFOP 和税码以会计确认为准。
{"id": "NFe-000014561-A","ambienteEmissao": "Producao","finalidade": "Ajuste","notaReferenciada": { "chaveAcesso": "35241104893402000113550020000002621202427463" },"informacoesAdicionais": "Ajuste de ICMS referente a NF-e 262 serie 2","pedido": {"presencaConsumidor": "NaoSeAplica","pagamento": { "formas": [ { "tipo": "SemPagamento", "valor": 0 } ] }},"cliente": {"tipoPessoa": "J", "nome": "Revenda Demo LTDA", "cpfCnpj": "11222333000181", "inscricaoEstadual": "123456789012","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" }},"itens": [{"cfop": "5949", "codigo": "AJUSTE-ICMS", "descricao": "Ajuste de imposto", "ncm": "85235190","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 100.00,"impostos": {"icms": { "situacaoTributaria": "00", "aliquota": 18 },"pis": { "situacaoTributaria": "08" },"cofins": { "situacaoTributaria": "08" }}}]}
finalidade* | string | 开票目的 |
* | object | 原票引用 |
naturezaOperacao | string | 操作性质描述 |
informacoesAdicionais | string | 票面备注 |
* | object | 订单信息 |
cliente* | object | 买方 |
* | array | 商品行 |
* 必填字段
Devolucao:退一张已授权的原票
退货票是进项票:引用原票,CFOP 与 PIS/COFINS 用进项码,没有支付,在场方式自动按 NaoSeAplica。ICMS 税参与原票行保持一致。
{"id": "DEV-000014553","ambienteEmissao": "Producao","finalidade": "Devolucao","notaReferenciada": { "chaveAcesso": "35241204893402000113650010000117691017244265" },"pedido": { "presencaConsumidor": "OperacaoPelaInternet", "pagamento": { "formas": [ { "tipo": "SemPagamento", "valor": 0 } ] } },"cliente": { "tipoPessoa": "F", "nome": "Demo Client", "cpfCnpj": "88533234775", "endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Rua Presidente Wilson", "numero": "911", "bairro": "Uberaba", "cep": "81570440" } },"itens": [{"cfop": "2202", "codigo": "000068", "descricao": "Pendrive Kingston 16GB", "ncm": "85235190","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 28.47,"notaReferenciada": { "numeroItem": 1 },"impostos": {"icms": { "situacaoTributaria": "102" },"pis": { "situacaoTributaria": "70", "aliquota": 0 },"cofins": { "situacaoTributaria": "70", "aliquota": 0 }}}]}
finalidade* | string | 开票目的 |
* | object | 原票引用 |
* | object | 订单信息 |
* | array | 商品行 |
* 必填字段
描述这笔交易怎么成交的。普通销售填 OperacaoPelaInternet 即可;中介平台组只在三个取值下可带。
在场方式与中介平台
"pedido": {"presencaConsumidor": "OperacaoPelaInternet","intermediadorTransacao": { "cnpj": "12345678000195", "identificadorCadastro": "seller-778899" },"pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 56.94 } ] }}
presencaConsumidor* | string | 在场方式 |
| object | 中介平台 |
* 必填字段
tipoPessoa、cpfCnpj、inscricaoEstadual、indicadorContribuinteICMS 要互相匹配。组合决定买方是不是 ICMS 纳税人,进而决定能用哪些 ICMS 税码(10004047)。国外买方见出口票小节。
个人消费者
电商最常见的买方。不传州注册号也不传身份指示,平台按非纳税人处理;只能用非纳税人税码。
"cliente": { "tipoPessoa": "F", "nome": "Cliente Demo", "cpfCnpj": "88533234775", "email": "cliente@mail.com", "endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Rua Presidente Wilson", "numero": "911", "bairro": "Uberaba", "cep": "81570440" } }
tipoPessoa* | string | 买方类型 |
nome* | string | 姓名或公司名 |
cpfCnpj* | string | CPF 11 位 |
email | string | 邮箱 |
inscricaoMunicipal | string | 市政登记号 |
* | object | 买方地址 |
* 必填字段
企业买方,ICMS 纳税人
B2B 销售。有州注册号就算纳税人,身份指示可不传。可以用 ST 类税码和 Simples 抵免。
"cliente": { "tipoPessoa": "J", "nome": "Revenda Demo LTDA", "cpfCnpj": "11222333000181", "inscricaoEstadual": "123.456.789.012", "endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" } }
tipoPessoa* | string | 买方类型 |
nome* | string | 姓名或公司名 |
cpfCnpj* | string | CNPJ 14 位 |
inscricaoEstadual* | string | 州注册号 IE |
indicadorContribuinteICMS | string | ICMS 身份 |
email | string | 邮箱 |
inscricaoMunicipal | string | 市政登记号 |
* | object | 买方地址 |
* 必填字段
企业买方,没有州注册号
服务型公司、物业、政府机关等。身份指示必须传,不传时无 IE 的 CNPJ 被拒(10004034)。按非纳税人处理。
"cliente": { "tipoPessoa": "J", "nome": "Servicos Demo LTDA", "cpfCnpj": "11222333000181", "indicadorContribuinteICMS": "NaoContribuinte", "endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" } }
tipoPessoa* | string | 买方类型 |
nome* | string | 姓名或公司名 |
cpfCnpj* | string | CNPJ 14 位 |
indicadorContribuinteICMS* | string | ICMS 身份 |
email | string | 邮箱 |
inscricaoMunicipal | string | 市政登记号 |
* | object | 买方地址 |
* 必填字段
有州注册号的个人(农户等)
少见情形。必须显式传 ContribuinteICMS,不传时 CPF 带 IE 会被拒(10004031)。
"cliente": { "tipoPessoa": "F", "nome": "Produtor Demo", "cpfCnpj": "88533234775", "inscricaoEstadual": "123.456.789.012", "indicadorContribuinteICMS": "ContribuinteICMS", "endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Estrada Rural", "numero": "S/N", "bairro": "Zona Rural", "cep": "81570440" } }
tipoPessoa* | string | 买方类型 |
nome* | string | 姓名或公司名 |
cpfCnpj* | string | CPF 11 位 |
inscricaoEstadual* | string | 州注册号 IE |
indicadorContribuinteICMS* | string | ICMS 身份 |
email | string | 邮箱 |
inscricaoMunicipal | string | 市政登记号 |
* | object | 买方地址 |
* 必填字段
cfop、codigo、descricao、ncm、quantidade、unidadeMedida、valorUnitario、impostos 见场景一、二。行总额 = quantidade × valorUnitario − valorDesconto + valorFrete + valorSeguro + valorOutrasDespesas,各行之和要与支付对得上。
带折扣、分摊运费、条码和采购单号的商品行
{"cfop": "5102", "codigo": "SKU-100", "descricao": "Produto demo", "ncm": "85235190", "ean": "7891149102105", "origem": 0,"quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 50.00,"valorDesconto": 5.00, "valorFrete": 3.00, "valorSeguro": 1.00, "valorOutrasDespesas": 0.50,"informacoesAdicionais": "Lote 2026-09","pedido": { "numero": "PO-778899", "numeroItem": 3 },"impostos": { "icms": { "situacaoTributaria": "00", "aliquota": 18 }, "pis": { "situacaoTributaria": "01" }, "cofins": { "situacaoTributaria": "01" } }}
cfop* | string | CFOP |
ean | string | 合法 GTIN |
cest | string | 只有 ST 商品才填 |
origem | int | 商品来源 |
valorDesconto | number | 本行折扣 |
valorFrete | number | 本行分摊的运费 |
valorSeguro | number | 本行分摊的保险费 |
valorOutrasDespesas | number | 本行分摊的其他费用 |
producaoEmEscala | bool | 规模化生产标记 |
informacoesAdicionais | string | 本行备注 |
| object | 采购订单 |
* 必填字段
燃料行:分销商卖柴油 B
液体燃料的商品行都要带 combustivel 块,不带时税务局会拒单相税码。平台按 NF-e 门户官方表核对 ANP 码:行的计量单位必须是表里的单位(L 或 KG),掺混比和来源州按产品决定必填还是禁填,每单位 ICMS 税额不传时按表回填。卖燃料给经销商或分销商(CFOP 5.651 到 5.655、6.651 到 6.656 等)必须带 transporte.transportadora 的 CNPJ 或 CPF,不带税务局拒 362,平台在发送前就拒;没有实物流转时填开票方自己的 CNPJ。
{"codigo": "DIESEL-B-S10","descricao": "OLEO DIESEL B S10 COMUM","ncm": "27101921","cfop": "5656","unidadeMedida": "L","quantidade": 1000,"valorUnitario": 5.5,"combustivel": {"codigoANP": "820101034","ufConsumo": "SP","percentualBiocombustivel": 14,"origens": [{ "importado": false, "ufOrigem": "35", "percentual": 100 }]},"impostos": {"icms": { "situacaoTributaria": "61", "monofasico": { "valorIcmsRetidoAnteriormente": 1119.55 } },"pis": { "situacaoTributaria": "04" },"cofins": { "situacaoTributaria": "04" }}}
unidadeMedida* | string | 计量单位 |
* | object | 燃料组 |
* 必填字段
一般税制公司(CRT 2 与 3)在 itens[].impostos.icms.situacaoTributaria 里传两位 CST;传三位 CSOSN 会被拒(10004046)。下面每种情形给出商品行里的 icms 块和它能带的字段;没列出的字段不要传(10004044)。百分比直接写数字,18 表示 18 %。
CST 00:全额征税
最常见的销售情形。只要税率;跨州卖给个人时 DIFAL 自动算。
"icms": { "situacaoTributaria": "00", "aliquota": 18 }
situacaoTributaria* | string | 税码 |
aliquota | number | ICMS 税率 |
aliquotaFcp | number | FCP 税率 |
| object | DIFAL |
* 必填字段
CST 10:征税并代收下游 ST
卖方自己缴 ICMS,还替下游环节预先代收。只对纳税人买方(10004047)。
"cest": "0300100","impostos": { "icms": { "situacaoTributaria": "10", "aliquota": 18, "substituicaoTributaria": { "mva": 40, "aliquota": 18 } } }
situacaoTributaria* | string | 税码 |
aliquota* | number | ICMS 税率 |
* | object | 代收 ST 组 |
cest* | string | 商品的 CEST 码 |
aliquotaFcp | number | FCP 税率 |
| object | 州际分成组 |
* 必填字段
CST 20:税基缩减
税基比价格小。要带州税收优惠码。
"icms": { "situacaoTributaria": "20", "aliquota": 18, "percentualReducaoBase": 33.33, "codigoBeneficioFiscal": "SP800001" }
situacaoTributaria* | string | 税码 |
aliquota* | number | ICMS 税率 |
percentualReducaoBase* | number | 税基削减比例 |
codigoBeneficioFiscal* | string | 州税收优惠码 |
aliquotaFcp | number | FCP 税率 |
| object | DIFAL |
* 必填字段
CST 30:自身免税但代收下游 ST
卖方自己不缴 ICMS,但替下游代收。只对纳税人买方。
"cest": "0300100","impostos": { "icms": { "situacaoTributaria": "30", "codigoBeneficioFiscal": "SP800001", "substituicaoTributaria": { "mva": 40, "aliquota": 18 } } }
situacaoTributaria* | string | 税码 |
* | object | 代收 ST 组 |
codigoBeneficioFiscal* | string | 州税收优惠码 |
cest* | string | 商品的 CEST 码 |
* 必填字段
CST 40 / 41 / 50:免税、不征税、暂缓
本行没有 ICMS。只要优惠码;不产生 DIFAL。出口票通常用 41。
"icms": { "situacaoTributaria": "40", "codigoBeneficioFiscal": "SP800001" }
situacaoTributaria* | string | 税码 |
codigoBeneficioFiscal* | string | 州税收优惠码 |
substituicaoTributariaDestino | object | 目的州 ST 组 |
* 必填字段
CST 51:递延
一部分税推到链条后面的环节再缴。
"icms": { "situacaoTributaria": "51", "aliquota": 18, "percentualDiferimento": 100, "codigoBeneficioFiscal": "SP800001" }
situacaoTributaria* | string | 税码 |
aliquota* | number | ICMS 税率 |
percentualDiferimento* | number | 递延比例 |
codigoBeneficioFiscal* | string | 州税收优惠码 |
percentualReducaoBase | number | 税基削减比例 |
aliquotaFcp | number | FCP 税率 |
percentualDiferimentoFcp | number | 递延的 FCP 比例 |
* 必填字段
CST 60:上游已代收 ST
ST 商品卖给终端消费者:税已在上游缴过。不传税率。
"cest": "0300100","impostos": { "icms": { "situacaoTributaria": "60", "retencaoAnterior": { "baseCalculo": 45, "aliquota": 18 } } }
situacaoTributaria* | string | 税码 |
cest* | string | 商品的 CEST 码 |
| object | 上游已代收组 |
| object | 目的州 ST 组 |
| object | 有效税负组 |
* 必填字段
CST 70:税基缩减并代收下游 ST
把 CST 20 的减基和 CST 10 的代收合在一起。只对纳税人买方。
"cest": "0300100","impostos": { "icms": { "situacaoTributaria": "70", "aliquota": 18, "percentualReducaoBase": 33.33, "codigoBeneficioFiscal": "SP800001", "substituicaoTributaria": { "mva": 40, "aliquota": 18 } } }
situacaoTributaria* | string | 税码 |
aliquota* | number | ICMS 税率 |
percentualReducaoBase* | number | 税基削减比例 |
* | object | 代收 ST 组 |
codigoBeneficioFiscal* | string | 州税收优惠码 |
cest* | string | 商品的 CEST 码 |
aliquotaFcp | number | FCP 税率 |
* 必填字段
CST 90:其他
组合式税码:传了哪个组就算哪个组,除优惠码外没有必填。
"icms": { "situacaoTributaria": "90", "codigoBeneficioFiscal": "SP800001", "aliquota": 18 }
situacaoTributaria* | string | 税码 |
codigoBeneficioFiscal* | string | 州税收优惠码 |
aliquota | number | ICMS 税率 |
percentualReducaoBase | number | 税基削减比例 |
aliquotaFcp | number | FCP 税率 |
| object | 代收 ST 组 |
| object | 州际分成组 |
* 必填字段
CST 02 / 15 / 53 / 61:燃油按量征税
税额是每升或每公斤固定金额,不按百分比。02 自征,15 自征加代征,53 递延,61 前环节已征。商品行必须带 combustivel 块(见商品行小节)。每单位税额可不传,平台按 NF-e 门户官方表回填,传了与表不同会被拒。15 卖柴油时代征按税额的 33.33 % 计,与税务局算法一致。石油衍生燃料不产生 DIFAL;Simples 公司也用这几个 CST。
"icms": { "situacaoTributaria": "15", "monofasico": { "quantidadeBaseCalculo": 7300, "quantidadeBaseCalculoRetencao": 2700 } }
situacaoTributaria* | string | 税码 |
* | object | 燃油单相组 |
percentualDiferimento | number | 递延比例 |
* 必填字段
Simples Nacional 公司(CRT 1 与 4)在 situacaoTributaria 里传三位 CSOSN;传两位 CST 会被拒(10004046)。任何 CSOSN 都不传 aliquota、difal、percentualDiferimento、monofasico。例外:燃料行在 Simples 下也用 CST 02、15、53、61。
CSOSN 102 / 103 / 300 / 400:不带抵扣
Simples 的普通销售:只传税码。
"icms": { "situacaoTributaria": "102" }
situacaoTributaria* | string | 税码 |
* 必填字段
CSOSN 101:允许买方抵扣
卖给会抵扣的纳税人企业。只对纳税人买方(10004047)。
"icms": { "situacaoTributaria": "101", "percentualCreditoSimples": 1.25 }
situacaoTributaria* | string | 税码 |
percentualCreditoSimples* | number | 买方抵扣比例 |
* 必填字段
CSOSN 201 / 202 / 203:代收下游 ST
卖方替下游代收 ICMS。只对纳税人买方;201 同时允许抵扣。
"cest": "0300100","impostos": { "icms": { "situacaoTributaria": "201", "percentualCreditoSimples": 1.25, "substituicaoTributaria": { "mva": 40, "aliquota": 18 } } }
situacaoTributaria* | string | 税码 |
percentualCreditoSimples | number | 只在 201 |
* | object | 代收 ST 组 |
cest* | string | 商品的 CEST 码 |
* 必填字段
CSOSN 500:上游已代收 ST
Simples 公司把 ST 商品卖给终端消费者。
"cest": "0300100","impostos": { "icms": { "situacaoTributaria": "500" } }
situacaoTributaria* | string | 税码 |
cest* | string | 商品的 CEST 码 |
| object | 上游已代收组 |
* 必填字段
CSOSN 900:其他
组合式税码:传了哪个组就算哪个组,没有必填。
"icms": { "situacaoTributaria": "900" }
situacaoTributaria* | string | 税码 |
percentualCreditoSimples | number | Simples 抵扣比例 |
percentualReducaoBase | number | 税基削减比例 |
| object | 代收 ST 组 |
* 必填字段
pis 与 cofins 是两个字段相同的独立块,两者税码几乎总是一样。01–49 是销项码(销售用);50–98 是进项码,只能用在退货票;99 两个方向都可以。税率按百分数:1.65 表示 1.65 %。
CST 01 / 02:按税率征税
一般税制非累积制。01 用基本税率 1.65 与 7.6;02 用差别税率。
"pis": { "situacaoTributaria": "01", "aliquota": 1.65 },"cofins": { "situacaoTributaria": "01", "aliquota": 7.6 }
situacaoTributaria* | string | 税码 |
aliquota | number | 税率 |
* 必填字段
CST 03:按数量征税
税额按每单位固定金额算,不按百分比。
"pis": { "situacaoTributaria": "03", "quantidadeBaseCalculo": 100, "valorUnitarioTributo": 0.1 },"cofins": { "situacaoTributaria": "03", "quantidadeBaseCalculo": 100, "valorUnitarioTributo": 0.46 }
situacaoTributaria* | string | 税码 |
valorUnitarioTributo* | number | 每单位税额 |
quantidadeBaseCalculo | number | 计税数量 |
* 必填字段
CST 04 到 09:销售不征税
只传税码。05 在卖方代买方缴纳时可带代收组。
"pis": { "situacaoTributaria": "07" },"cofins": { "situacaoTributaria": "07" }
situacaoTributaria* | string | 税码 |
substituicaoTributaria | object | 代收 ST 组 |
* 必填字段
CST 49 / 99:其他操作
Simples 卖方的常用码。只传税码,税率按 0。
"pis": { "situacaoTributaria": "49" },"cofins": { "situacaoTributaria": "49" }
situacaoTributaria* | string | 税码 |
* 必填字段
CST 50 到 75 与 98:进项码,只用于退货票
退货票是进项票,所以 PIS/COFINS 用进项码,税率必传(无税传 0)。退 Simples 的销售票通常用 70 加税率 0。
"pis": { "situacaoTributaria": "70", "aliquota": 0 },"cofins": { "situacaoTributaria": "70", "aliquota": 0 }
situacaoTributaria* | string | 税码 |
aliquota* | number | 税率 |
* 必填字段
IPI 是联邦工业产品税,只有工业或视同工业的主体才传 ipi 组。50–99 是销项码;00–49 是进项码,只能用在退货票。
IPI 征税:CST 50 / 99
"ipi": { "situacaoTributaria": "50", "aliquota": 5, "codigoEnquadramento": "999" }
situacaoTributaria* | string | 税码 |
aliquota* | number | IPI 税率 |
codigoEnquadramento | string | IPI 法律框架码 |
* 必填字段
IPI 不征税:CST 51 到 55
"ipi": { "situacaoTributaria": "52", "codigoEnquadramento": "301" }
situacaoTributaria* | string | 税码 |
codigoEnquadramento | string | IPI 法律框架码 |
* 必填字段
IPI 退货票:CST 00 到 49
"ipi": { "situacaoTributaria": "00", "aliquota": 5 }
situacaoTributaria* | string | 税码 |
aliquota | number | 税率 |
codigoEnquadramento | string | IPI 法律框架码 |
* 必填字段
IBS 与 CBS 是 2026 税改的两个税种:IBS 接替 ICMS 与 ISS,CBS 接替 PIS 与 COFINS。2026 年只申报不征收,用测试税率。一般税制公司(CRT 3)每张票都带本组;Simples 公司 2027 年才需要,之前传了也忽略。普通销售什么都不用传,平台按 000 加分类码 000001 写出。下面是例外情形;一行传了本组,每一行都要传。
IBS/CBS 200:减率
减率比例由分类码决定。
"ibsCbs": { "situacaoTributaria": "200", "classificacaoTributaria": "200003" }
situacaoTributaria* | string | 税码 |
classificacaoTributaria* | string | 分类码 |
* 必填字段
IBS/CBS 410:免征或不征
票面不出税额。
"ibsCbs": { "situacaoTributaria": "410", "classificacaoTributaria": "410001" }
situacaoTributaria* | string | 税码 |
classificacaoTributaria* | string | 分类码 |
* 必填字段
IBS/CBS 510 / 515:递延
515 是递延加减率。
"ibsCbs": { "situacaoTributaria": "510", "classificacaoTributaria": "510001", "percentualDiferimento": 100 }
situacaoTributaria* | string | 税码 |
classificacaoTributaria* | string | 分类码 |
percentualDiferimento* | number | 递延比例 |
* 必填字段
IBS/CBS 550:暂停征收
在 tributacaoRegular 里写没有暂停时本来该怎么征。
"ibsCbs": { "situacaoTributaria": "550", "classificacaoTributaria": "550001", "tributacaoRegular": { "situacaoTributaria": "000", "classificacaoTributaria": "000001" } }
situacaoTributaria* | string | 税码 |
classificacaoTributaria* | string | 分类码 |
* | object | 常规征税 |
* 必填字段
IBS/CBS 620:燃油按量
"ibsCbs": { "situacaoTributaria": "620", "classificacaoTributaria": "620001", "monofasico": { "quantidadeBaseCalculo": 100, "aliquotaAdRemIbs": 0.2, "aliquotaAdRemCbs": 0.1 } }
situacaoTributaria* | string | 税码 |
classificacaoTributaria* | string | 分类码 |
monofasico* | object | 燃油单相组 |
* 必填字段
IBS/CBS 800 / 810 / 811:抵扣转移、自贸区抵扣、期间调整
"ibsCbs": { "situacaoTributaria": "800", "classificacaoTributaria": "800001", "transferenciaCredito": { "valorIbs": 10.00, "valorCbs": 4.00 } }
situacaoTributaria* | string | 税码 |
classificacaoTributaria* | string | 分类码 |
transferenciaCredito | object | 只在 800 |
zonaFrancaManaus | object | 只在 810 |
ajuste | object | 只在 811 |
* 必填字段
推定抵扣 creditoPresumido,任何状态下可选
只有分类码允许推定抵扣时才传。
"ibsCbs": { "situacaoTributaria": "000", "classificacaoTributaria": "000001", "creditoPresumido": { "codigo": "01", "percentualIbs": 2, "percentualCbs": 1, "suspensivo": false, "deduzir": true } }
| object | 推定抵扣 |
* 必填字段
选择性消费税是税改中对有害健康或环境的商品征收的联邦税:烟草、酒类与含糖饮料、车辆、船舶、航空器、矿产。2027 年起征;生产环境在此之前开票会被拒(10005261),认证测试环境现在就能联调。税率由普通法律规定,官方的适用商品表与分类码表尚未公布,所以税率由你传,计税基数与税额由平台算出。税额会计入同一行 IBS/CBS 的计税基数。不征此税的商品不传本组。
从价税率
计税基数:本行金额 + 运费 + 保险 + 其他费用 − 折扣 − 本行 ICMS、FCP、DIFAL、PIS、COFINS、ISS。税额 = 计税基数 × 税率。
"impostoSeletivo": { "situacaoTributaria": "000", "classificacaoTributaria": "000001", "aliquota": 10 }
situacaoTributaria* | string | 状态码 |
classificacaoTributaria* | string | 分类码 |
aliquota* | number | 税率 |
aliquotaAdRem*不填 | number | 从量税率 |
* 必填字段
只申报代码
不传税率时票面只申报状态码与分类码,本税合计为 0。
"impostoSeletivo": { "situacaoTributaria": "000", "classificacaoTributaria": "000001" }
situacaoTributaria* | string | 状态码 |
classificacaoTributaria* | string | 分类码 |
* 必填字段
每一笔都要 tipo 与 valor。各笔合计减 troco 必须等于票面总额。下面几种情形覆盖全部 22 个类型。
现金、支票、银行票据、存款、转账、各类券、店铺信用、店内余额、忠诚计划
只填类型和金额。这些类型都不能带刷卡终端信息。
"pagamento": { "formas": [ { "tipo": "BoletoBancario", "valor": 56.94 } ] }
* | array | 支付明细 |
* 必填字段
信用卡、借记卡、Pix:未对接的刷卡终端
电商的常规情形:刷卡终端或 Pix 不与开票系统对接。credenciadoraCartao 可以不传,平台按未对接终端申报。
"pagamento": { "formas": [ { "tipo": "CartaoDeCredito", "valor": 56.94, "credenciadoraCartao": { "tipoIntegracaoPagamento": "NaoIntegradoAoSistemaDeGestao", "bandeira": "Mastercard" } } ] }
* | array | 支付明细 |
* 必填字段
与开票系统对接的刷卡终端
门店的对接式刷卡。三个交易信息都必填,缺任一返回 10004031。
"pagamento": { "formas": [ { "tipo": "CartaoDeDebito", "valor": 56.94, "credenciadoraCartao": { "tipoIntegracaoPagamento": "IntegradoAoSistemaDeGestao", "cnpj": "01027058000191", "bandeira": "Visa", "codigoAutorizacao": "123456" } } ] }
* | array | 支付明细 |
* 必填字段
其他支付方式 Outros
表里没有的方式;说明必填。
"pagamento": { "formas": [ { "tipo": "Outros", "valor": 56.94, "descricao": "Vale-troca" } ] }
* | array | 支付明细 |
* 必填字段
多笔支付与找零
各笔合计减找零必须正好等于票面总额,差一分都会被拒。
"pagamento": { "troco": 3.06, "formas": [ { "tipo": "Dinheiro", "valor": 40.00 }, { "tipo": "PagamentoInstantaneoPix", "valor": 20.00 } ] }
formas* | array | 支付明细 |
troco | number | 找零 |
* 必填字段
赊购 PagamentoAPrazo
通常配银行票据。要登记分期,再传 cobranca 组。
"pagamento": { "tipo": "PagamentoAPrazo", "formas": [ { "tipo": "BoletoBancario", "valor": 100.00 } ] }
tipo* | string | 付款时点 |
formas* | array | 支付明细 |
* 必填字段
后付 PagamentoPosterior
开票时还没收款,或只收了一部分。PagamentoPosterior 这一笔金额填 0;有这一笔时,各笔合计可以低于票面总额,但不能有找零。
"pagamento": { "formas": [ { "tipo": "Dinheiro", "valor": 20.00 }, { "tipo": "PagamentoPosterior", "valor": 0 } ] }
* | array | 支付明细 |
* 必填字段
无支付 SemPagamento,只用于退货票
只能是唯一一笔,金额 0。正常销售票税务局会拒。
"pagamento": { "formas": [ { "tipo": "SemPagamento", "valor": 0 } ] }
* | array | 支付明细 |
* 必填字段
可接受的取值,不区分大小写;平台转换为官方品牌码。
Visa · Mastercard · AmericanExpress · Sorocred · DinersClub · Elo · Hipercard · Aura · Cabal · Alelo · BanesCard · CalCard · Credz · Discover · GoodCard · GreenCard · Hiper · JcB · Mais · MaxVan · Policard · RedeCompras · Sodexo · ValeCard · Verocheque · VR · Ticket · Outros
不传 transporte 组就按 SemFrete 出票,票面不申报运费,不想填物流就这样。SemFrete 时不要传 transportadora、veiculo、retencaoIcms(10004031)。
委托承运人运输
PorContaDoEmitente、PorContaDoDestinatario 或 PorContaDeTerceiros。各子组都可选,知道什么填什么。
"transporte": {"frete": { "modalidade": "PorContaDoEmitente" },"transportadora": { "cpfCnpj": "12345678000195", "nome": "Transportadora Demo LTDA", "inscricaoEstadual": "123456789", "enderecoCompleto": "Rua A, 10", "cidade": "Curitiba", "uf": "PR" },"volumes": [ { "quantidade": 2, "especie": "CAIXA", "numeracao": "001-002", "pesoLiquido": 1.250, "pesoBruto": 1.500 } ]}
* | object | 运费承担 |
| object | 承运人 |
| array | 包装件 |
* 必填字段
自有车辆运输
TransporteProprioPorContaDoRemetente 或 TransporteProprioPorContaDoDestinatario。挂车须随车辆,最多 5 台。
"transporte": {"frete": { "modalidade": "TransporteProprioPorContaDoRemetente" },"veiculo": { "placa": "ABC1D23", "uf": "PR", "rntc": "000123456" },"reboques": [ { "placa": "XYZ9Z99", "uf": "PR" } ],"volumes": [ { "quantidade": 10, "especie": "PALLET" } ]}
* | object | 运费承担 |
| object | 运输车辆 |
| array | 挂车 |
| array | 包装件 |
* 必填字段
运费的 ICMS 代扣
卖方代扣运输服务的 ICMS 时传。六个字段全必填,valor 须等于 baseCalculo × aliquota。不能与 SemFrete 并用。
"transporte": {"frete": { "modalidade": "PorContaDoEmitente" },"retencaoIcms": { "valorServico": 100.00, "baseCalculo": 100.00, "aliquota": 12, "valor": 12.00, "cfop": "5352", "codigoMunicipio": "4106902" }}
* | object | 运费 ICMS 代扣 |
* 必填字段
交货地址与买方地址不同
任何运费方式下都可传,包括 SemFrete。cidade 同买方地址一样传 IBGE 码。
"transporte": {"enderecoEntrega": { "cpfCnpj": "11222333000181", "nome": "Deposito Demo", "uf": "PR", "cidade": "4106902", "logradouro": "Rua B", "numero": "20", "bairro": "Centro", "cep": "80010000", "telefone": "41999990000" }}
* | object | 交货地址 |
* 必填字段
只在赊销时传,通常配 BoletoBancario 与 pagamento.tipo=PagamentoAPrazo。即付销售不传本组。
分两期的账单
"cobranca": {"fatura": { "numero": "FAT-2026-001", "valorOriginal": 100.00, "desconto": 0, "valorLiquido": 100.00 },"parcelas": [ { "numero": "001", "vencimento": "2026-10-30", "valor": 50.00 }, { "numero": "002", "vencimento": "2026-11-30", "valor": 50.00 } ]}
| object | 账单 |
* | array | 分期明细 |
* 必填字段
cliente.endereco.uf=EX 即视为出口票。国外买方没有 CPF/CNPJ 也没有 CEP;货物从某个州的某个口岸出境。
卖到国外
税码通常是 ICMS 41 加优惠码、PIS/COFINS 08,以会计确认为准。只能 finalidade=Normal。
{"id": "NFe-EXP-0001", "ambienteEmissao": "Producao","pedido": { "presencaConsumidor": "OperacaoPelaInternet", "pagamento": { "formas": [ { "tipo": "TransferenciaBancaria", "valor": 500.00 } ] } },"cliente": { "tipoPessoa": "J", "nome": "Overseas Buyer Inc", "idEstrangeiro": "US123456", "endereco": { "uf": "EX", "codigoPais": "2496", "pais": "ESTADOS UNIDOS", "logradouro": "5th Avenue", "numero": "100", "bairro": "Manhattan" } },"exportacao": { "ufEmbarque": "SP", "localEmbarque": "Porto de Santos", "localDespacho": "Santos" },"itens": [ { "cfop": "7101", "codigo": "SKU-100", "descricao": "Produto demo", "ncm": "85235190", "quantidade": 10, "unidadeMedida": "UN", "valorUnitario": 50.00,"impostos": { "icms": { "situacaoTributaria": "41", "codigoBeneficioFiscal": "SP800001" }, "pis": { "situacaoTributaria": "08" }, "cofins": { "situacaoTributaria": "08" } } } ]}
* | object | 买方 |
* | object | 出境信息 |
* | array | 商品行 |
* 必填字段
ambienteEmissao开票环境
| 取值 | 含义 |
|---|---|
| Homologacao | 税务局测试环境,票无法律效力 |
| Producao | 正式环境 |
finalidade开票目的
不传即 Normal。
| 取值 | 含义 |
|---|---|
| Normal | 普通销售 |
| Complementar | 补充票,给已授权的原票补金额、数量或税额 |
| Ajuste | 调整票,对已授权的原票做无货物流转的调整 |
| Devolucao | 退货票,退一张已授权的原票 |
cliente.tipoPessoa买方类型
| 取值 | 含义 |
|---|---|
| F | 个人,证件是 CPF |
| J | 企业,证件是 CNPJ |
cliente.indicadorContribuinteICMS买方 ICMS 身份
不传时:CNPJ 带州注册号算纳税人,其余算非纳税人。
| 取值 | 含义 |
|---|---|
| ContribuinteICMS | 纳税人,须带 inscricaoEstadual |
| ContribuinteIsento | 免登记 |
| NaoContribuinte | 非纳税人 |
cliente.endereco.uf买方所在州
同一张表也用于 transporte.transportadora.uf、transporte.enderecoEntrega.uf、exportacao.ufEmbarque,这些不能用 EX;以及 transporte.veiculo.uf、transporte.reboques[].uf、itens[].combustivel.ufConsumo,这些可以用 EX。
| 取值 | 含义 |
|---|---|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MA | Maranhão |
| MT | Mato Grosso |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
| EX | 国外,出口票用 |
pedido.presencaConsumidor在场方式
| 取值 | 含义 |
|---|---|
| NaoSeAplica | 不适用,只用于退货票 |
| OperacaoPresencial | 门店现场成交 |
| OperacaoPelaInternet | 互联网成交,电商常用 |
| OperacaoPorTelefone | 电话成交 |
| EntregaEmDomicilio | 送货上门时成交 |
| OperacaoPresencialForaDoEstabelecimento | 店外现场成交,如展会、外勤销售 |
| Outros | 其他 |
pedido.pagamento.tipo付款时点
不传即 PagamentoAVista。
| 取值 | 含义 |
|---|---|
| PagamentoAVista | 即付 |
| PagamentoAPrazo | 赊购,分期用 cobranca 登记 |
pedido.pagamento.formas[].tipo支付方式
| 取值 | 含义 |
|---|---|
| Dinheiro | 现金 |
| Cheque | 支票 |
| CartaoDeCredito | 信用卡 |
| CartaoDeDebito | 借记卡 |
| CreditoLoja | 店铺信用 |
| ValeAlimentacao | 食品券 |
| ValeRefeicao | 餐券 |
| ValePresente | 礼品券 |
| ValeCombustivel | 燃油券 |
| BoletoBancario | 银行票据 |
| DepositoBancario | 银行存款 |
| PagamentoInstantaneoPix | Pix 即时支付 |
| TransferenciaBancaria | 银行转账 |
| ProgramaDeFidelidade | 忠诚计划或返现 |
| PagamentoInstantaneoPixEstatico | Pix 静态码:静态二维码、Pix 密钥或账户信息 |
| CreditoEmLoja | 店内余额,来自此前付款或退货 |
| PagamentoEletronicoNaoInformado | 未能对接的电子支付,只用于收银硬件故障 |
| PagamentoInstantaneoPixAutomatico | Pix 自动扣款,周期性扣款 |
| TransferenciaTefBookTransfer | TEF 同行转账 |
| SemPagamento | 无支付,只用于退货票,须单独出现且金额 0 |
| PagamentoPosterior | 后付,金额 0,合计可低于票面总额 |
| Outros | 其他,须填 descricao |
pedido.pagamento.formas[].credenciadoraCartao.tipoIntegracaoPagamento刷卡终端对接方式
不传即 NaoIntegradoAoSistemaDeGestao。
| 取值 | 含义 |
|---|---|
| NaoIntegradoAoSistemaDeGestao | 未对接,只需 bandeira |
| IntegradoAoSistemaDeGestao | 已对接,须 cnpj、bandeira、codigoAutorizacao |
pedido.pagamento.formas[].credenciadoraCartao.bandeira卡品牌
不区分大小写,平台转换为官方品牌码。NF-e 里表外的品牌会被忽略,不写入票面。
| 取值 | 含义 |
|---|---|
| Visa | Visa |
| Mastercard | Mastercard |
| AmericanExpress | AmericanExpress |
| Sorocred | Sorocred |
| DinersClub | DinersClub |
| Elo | Elo |
| Hipercard | Hipercard |
| Aura | Aura |
| Cabal | Cabal |
| Alelo | Alelo |
| BanesCard | BanesCard |
| CalCard | CalCard |
| Credz | Credz |
| Discover | Discover |
| GoodCard | GoodCard |
| GreenCard | GreenCard |
| Hiper | Hiper |
| JcB | JcB |
| Mais | Mais |
| MaxVan | MaxVan |
| Policard | Policard |
| RedeCompras | RedeCompras |
| Sodexo | Sodexo |
| ValeCard | ValeCard |
| Verocheque | Verocheque |
| VR | VR |
| Ticket | Ticket |
| Amex | 等同 AmericanExpress |
| Outros | 其他品牌 |
transporte.frete.modalidade运费方式
不传即 SemFrete。
| 取值 | 含义 |
|---|---|
| SemFrete | 无运费,不能带承运人、车辆、代扣 |
| PorContaDoEmitente | 发货方承担 |
| PorContaDoDestinatario | 收货方承担 |
| PorContaDeTerceiros | 第三方承担 |
| TransporteProprioPorContaDoRemetente | 发货方自有车辆 |
| TransporteProprioPorContaDoDestinatario | 收货方自有车辆 |
itens[].origem商品来源
不传即 0。1 / 2 / 3 / 8 跨州按 4 % 税率。
| 取值 | 含义 |
|---|---|
| 0 | 国产 |
| 1 | 直接进口 |
| 2 | 国内购入的进口品 |
| 3 | 国产,进口成分超 40 % |
| 4 | 国产,按基本生产流程制造 |
| 5 | 国产,进口成分不超 40 % |
| 6 | 直接进口,无国产同类品 |
| 7 | 国内购入的进口品,无国产同类品 |
| 8 | 国产,进口成分超 70 % |
itens[].impostos.icms.situacaoTributariaICMS 税码 CST,一般税制 CRT 2 / 3
一般税制主体传两位 CST,传 CSOSN 返回 10004046。携带该税码不允许的组返回 10004044。
| 取值 | 含义 |
|---|---|
| 00 | 全额征税。传 aliquota;CRT 3 不传时平台按税率表补 |
| 02 | 燃油按量,自征。须传 monofasico 与商品行 combustivel 块 |
| 10 | 征税并代收下游 ST。须传 aliquota 与 substituicaoTributaria,买方须为 ICMS 纳税人;可选 partilha;可选 motivoDesoneracaoSt |
| 15 | 燃油按量,自征加代征。须传 monofasico,含自征与代征税率 |
| 20 | 税基缩减。须传 aliquota、percentualReducaoBase 与 codigoBeneficioFiscal;可选 motivoDesoneracao |
| 30 | 自身免税但代收下游 ST。须传 substituicaoTributaria 与 codigoBeneficioFiscal,买方须为 ICMS 纳税人;可选 motivoDesoneracao |
| 40 | 免税。须传 codigoBeneficioFiscal;可选 motivoDesoneracao |
| 41 | 不征税。须传 codigoBeneficioFiscal;州际转拨 ST 时同传 substituicaoTributariaDestino 与 retencaoAnterior;可选 motivoDesoneracao |
| 50 | 暂缓。须传 codigoBeneficioFiscal;可选 motivoDesoneracao |
| 51 | 递延。须传 aliquota、percentualDiferimento 与 codigoBeneficioFiscal;传了 aliquotaFcp 还须传 percentualDiferimentoFcp;带减基时可选 codigoBeneficioFiscalReducaoBase |
| 53 | 燃油按量,递延。须传 monofasico,递延比例放 percentualDiferimento |
| 60 | 上游已代收 ST。可选 retencaoAnterior;tributacaoEfetiva 与 substituicaoTributariaDestino 按州要求传 |
| 61 | 燃油按量,前环节已征。须传 monofasico,含前环节税率 |
| 70 | 税基缩减并代收下游 ST。须传 aliquota、percentualReducaoBase、codigoBeneficioFiscal 与 substituicaoTributaria,买方须为 ICMS 纳税人;可选 motivoDesoneracao 与 motivoDesoneracaoSt |
| 90 | 其他。须传 codigoBeneficioFiscal;可选 substituicaoTributaria 与 partilha;可选 motivoDesoneracao 与 motivoDesoneracaoSt |
itens[].impostos.icms.situacaoTributariaICMS 税码 CSOSN,Simples Nacional CRT 1 / 4
Simples 主体传三位 CSOSN,传 CST 返回 10004046。
| 取值 | 含义 |
|---|---|
| 101 | 征税且允许买方抵扣。须传 percentualCreditoSimples,买方须为 ICMS 纳税人 |
| 102 | 征税不抵扣。ICMS 里不用再传别的;codigoBeneficioFiscal 与 creditosPresumidos 按州要求传 |
| 103 | 营收区间免征。ICMS 里不用再传别的;codigoBeneficioFiscal 与 creditosPresumidos 按州要求传 |
| 201 | 代收 ST 且允许抵扣。须传 percentualCreditoSimples 与 substituicaoTributaria,买方须为 ICMS 纳税人 |
| 202 | 代收 ST 不抵扣。须传 substituicaoTributaria,买方须为 ICMS 纳税人 |
| 203 | 营收区间免征并代收 ST。须传 substituicaoTributaria,买方须为 ICMS 纳税人 |
| 300 | 宪法豁免。ICMS 里不用再传别的;codigoBeneficioFiscal 与 creditosPresumidos 按州要求传 |
| 400 | 不征税。ICMS 里不用再传别的;codigoBeneficioFiscal 与 creditosPresumidos 按州要求传 |
| 500 | 上游已代收 ST。可选 retencaoAnterior |
| 900 | 其他。可选 substituicaoTributaria |
itens[].impostos.icms.motivoDesoneracaoICMS 减免原因
每个 CST 只接受部分取值:CST 20 为 3、9、10、11、12;CST 30 为 6、7、9;CST 40、41、50 为 1、3、4、5、6、7、8、9、10、11、16、90;CST 70、90 为 3、9、12。其他返回 10005230。
| 取值 | 含义 |
|---|---|
| 1 | 出租车 |
| 3 | 农牧业用途 |
| 4 | 车队或租车公司 |
| 5 | 外交领事 |
| 6 | 西部亚马逊及自贸区的商用车与摩托车 |
| 7 | SUFRAMA 管辖区 |
| 8 | 向公共机关销售 |
| 9 | 其他 |
| 10 | 自驾的残障人士 |
| 11 | 不自驾的残障人士 |
| 12 | 农牧业促进机构 |
| 16 | 2016 里约奥运会 |
| 90 | 税务机关要求 |
itens[].impostos.icms.motivoDesoneracaoStICMS-ST 减免原因
只用于 CST 10、70、90。
| 取值 | 含义 |
|---|---|
| 3 | 农牧业用途 |
| 9 | 其他 |
| 12 | 农牧业促进机构 |
itens[].impostos.icms.difal.aliquotaInterestadualDIFAL 州际税率
只接受这三个值,其他值拒绝开票。
| 取值 | 含义 |
|---|---|
| 4 | 进口商品(来源 1、2、3、8) |
| 7 | 南部、东南部(ES 除外)发往北部、东北部、中西部或 ES |
| 12 | 其余州际交易 |
itens[].impostos.icms.partilha.ufSubstituicaoTributaria分成的 ST 应缴州
两位大写州代码。
| 取值 | 含义 |
|---|---|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MA | Maranhão |
| MT | Mato Grosso |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
itens[].impostos.pis.situacaoTributariaPIS 税码
票的方向决定可用税码:退货票是进项票,不能用 01、02、49;50 到 75 与 98 只能用于退货票。方向用错会被拒绝。
| 取值 | 含义 |
|---|---|
| 01 | 基本税率征税 |
| 02 | 差别税率征税 |
| 03 | 按数量征税 |
| 04 | 单相制转售零税率 |
| 05 | 代收 |
| 06 | 零税率 |
| 07 | 免税 |
| 08 | 不征,出口用 |
| 09 | 暂缓 |
| 49 | 其他销项操作 |
| 50–56 | 进项有抵扣权,按收入类型细分,只用于退货票 |
| 60–66 | 进项推定抵扣,按收入类型细分,只用于退货票 |
| 67 | 进项推定抵扣,其他情形,只用于退货票 |
| 70 | 进项无抵扣权,只用于退货票 |
| 71 | 进项免税,只用于退货票 |
| 72 | 进项暂缓,只用于退货票 |
| 73 | 进项零税率,只用于退货票 |
| 74 | 进项不征,只用于退货票 |
| 75 | 进项代收,只用于退货票 |
| 98 | 其他进项操作,只用于退货票 |
| 99 | 其他操作 |
itens[].impostos.cofins.situacaoTributariaCOFINS 税码
与 PIS 同一张表、同一条方向规则。
| 取值 | 含义 |
|---|---|
| 01 | 基本税率征税 |
| 02 | 差别税率征税 |
| 03 | 按数量征税 |
| 04 | 单相制转售零税率 |
| 05 | 代收 |
| 06 | 零税率 |
| 07 | 免税 |
| 08 | 不征,出口用 |
| 09 | 暂缓 |
| 49 | 其他销项操作 |
| 50–56 | 进项有抵扣权,按收入类型细分,只用于退货票 |
| 60–66 | 进项推定抵扣,按收入类型细分,只用于退货票 |
| 67 | 进项推定抵扣,其他情形,只用于退货票 |
| 70 | 进项无抵扣权,只用于退货票 |
| 71 | 进项免税,只用于退货票 |
| 72 | 进项暂缓,只用于退货票 |
| 73 | 进项零税率,只用于退货票 |
| 74 | 进项不征,只用于退货票 |
| 75 | 进项代收,只用于退货票 |
| 98 | 其他进项操作,只用于退货票 |
| 99 | 其他操作 |
itens[].impostos.ipi.situacaoTributariaIPI 税码
整组可选。00 到 05 与 49 只用于退货票,退货票是进项票;50 到 55 与 99 只用于其他票。方向用错会被拒绝。
| 取值 | 含义 |
|---|---|
| 00 | 进项征税 |
| 01 | 进项零税率 |
| 02 | 进项免税 |
| 03 | 进项不征 |
| 04 | 进项豁免 |
| 05 | 进项暂缓 |
| 49 | 其他进项 |
| 50 | 销项征税 |
| 51 | 销项零税率 |
| 52 | 销项免税 |
| 53 | 销项不征 |
| 54 | 销项豁免 |
| 55 | 销项暂缓 |
| 99 | 其他销项 |
itens[].impostos.ipi.codigoEnquadramentoIPI 法律框架代码
3 位数字,不传即 999。免税、豁免、暂缓类 CST 必须填对应区间的代码;不在官方表内的代码拒绝开票。官方码表为 NF-e 纳税人指导手册表 8-6。
| 取值 | 含义 |
|---|---|
| 001–007 | 豁免;CST 04 / 54 必须用这一段 |
| 101–165 | 暂缓;CST 05 / 55 必须用这一段 |
| 301–351 | 免税;CST 02 / 52 必须用这一段 |
| 601–608 | 减征 |
| 999 | 正常计税及其余情形;缺省值 |
itens[].impostos.ibsCbs.situacaoTributariaIBS/CBS 状态码
不传即 000。tributacaoRegular.situacaoTributaria 用同一张表。标为暂不支持的码在官方表中存在,传了会被拒绝。
| 取值 | 含义 |
|---|---|
| 000 | 全额征税。只传状态码与分类码 |
| 200 | 减率。减率比例由分类码决定;200022 / 200024 须传 tributacaoRegular |
| 410 | 免征或不征。只传状态码与分类码 |
| 510 | 递延。须传 percentualDiferimento |
| 515 | 递延加减率。须传 percentualDiferimento |
| 550 | 暂停征收。须传 tributacaoRegular |
| 620 | 燃油按量征税。须传 monofasico 与商品行 combustivel 块 |
| 800 | 抵扣转移。须传 transferenciaCredito |
| 810 | 马瑙斯自贸区推定抵扣。须传 zonaFrancaManaus |
| 811 | 以前期间调整。须传 ajuste |
| 010 | 统一税率,金融服务用。暂不支持 |
| 011 | 统一减率。暂不支持 |
| 220 | 固定税率。暂不支持 |
| 221 | 按比例固定税率。暂不支持 |
| 222 | 税基缩减。暂不支持 |
| 400 | 免税。官方表没有 NF-e 可用的分类码,暂不支持 |
| 820 | 在专门单据上征税。暂不支持 |
| 830 | 从税基中排除。暂不支持 |
itens[].impostos.ibsCbs.classificacaoTributariaIBS/CBS 分类码
不传即 000001。前 3 位就是状态码,须与 situacaoTributaria 一致;只列 NF-e 可用且平台已支持状态码下的分类码(官方表 2026-08-23 版)。
| 取值 | 含义 |
|---|---|
| 000001 | IBS 与 CBS 全额征税的一般情形 |
| 000003 | 汽车业激励项目(第 311 条);可传 creditoPresumido |
| 000004 | 汽车业激励项目(第 312 条);可传 creditoPresumido |
| 000005 | 本应与 A 类汽油调和的无水乙醇改作他用 |
| 200002 | 供给非纳税人农业生产者或独立货运司机;减率 100 % |
| 200003 | 人类食用产品销售(附件一);减率 100 % |
| 200004 | 医疗器械供给(附件十二);减率 100 % |
| 200005 | 向政府机关与免税医疗机构供给医疗器械(附件十二);减率 100 % |
| 200006 | 政府认定的公共卫生紧急状态;减率 100 % |
| 200007 | 残障人士无障碍器具供给(附件十三);减率 100 % |
| 200008 | 政府机关采购的残障人士无障碍器具;减率 100 % |
| 200009 | Anvisa 注册药品供给;减率 100 % |
| 200010 | 政府机关采购的 Anvisa 注册药品;减率 100 % |
| 200011 | 政府机关采购的肠内与肠外营养制剂;减率 100 % |
| 200012 | 政府认定的公共卫生紧急状态;减率 100 % |
| 200013 | 卫生棉条与卫生巾供给;减率 100 % |
| 200014 | 蔬菜、水果与鸡蛋(附件十五);减率 100 % |
| 200015 | 职业司机或残障人士购买的国产乘用车;减率 100 % |
| 200020 | 选择 IBS/CBS 特定制度的合作社的交易;减率 100 % |
| 200022 | 自贸区外向马瑙斯自贸区内纳税人发送工业品;减率 100 %,须传 tributacaoRegular |
| 200023 | 激励工业之间的中间品供给;减率 100 % |
| 200024 | 自由贸易区外向区内纳税人发送货物;减率 100 %,须传 tributacaoRegular |
| 200030 | 医疗器械销售(附件四);减率 60 % |
| 200031 | 残障人士无障碍器具(附件五);减率 60 % |
| 200032 | Anvisa 注册药品或配制药品,附件十四除外;减率 60 % |
| 200033 | 肠内与肠外营养制剂(附件六);减率 60 % |
| 200034 | 人类食用食品(附件七);减率 60 % |
| 200035 | 个人卫生与清洁用品(附件八);减率 60 % |
| 200036 | 未加工的农、渔、林与植物采集产品;减率 60 % |
| 200038 | 农业与水产养殖投入品(附件九);减率 60 % |
| 200039 | 国内艺术、文化、活动、新闻与影视制作相关供给;减率 60 % |
| 200043 | 向政府供给的主权与安全相关商品和服务(附件十一);减率 60 % |
| 200047 | 酒吧与餐厅;减率 40 % |
| 200053 | Anvisa 注册的血清或疫苗类药品;减率 100 % |
| 200054 | 农业合作社向非正规制度社员供给货物;减率 100 % |
| 410001 | 票面注明且不依赖后续事件的赠品 |
| 410002 | 同一纳税人各分支之间的调拨 |
| 410003 | 捐赠人不取得对价的捐赠 |
| 410004 | 商品与服务出口 |
| 410005 | 联邦、州、联邦区与市政府的供给 |
| 410006 | 宗教团体与各类教堂的供给 |
| 410007 | 政党、工会与非营利教育或社会救助机构的供给 |
| 410008 | 书籍、报纸、期刊及其印刷用纸 |
| 410009 | 巴西制作的音乐录音与音乐影像 |
| 410012 | 未选正规制度的物业小区的供给 |
| 410013 | 燃油出口 |
| 410014 | 非纳税人农业生产者的供给;可传 creditoPresumido |
| 410016 | 固体废弃物的供给或采购;可传 creditoPresumido |
| 410017 | 带附条件推定抵扣的动产采购,须转售 |
| 410019 | 餐饮供给中小费不计入税基 |
| 410020 | 餐饮供给中平台佣金不计入税基 |
| 410026 | 需冲销抵扣的捐赠 |
| 410027 | 服务或无形商品出口 |
| 410029 | 只涉及 ICMS 的交易 |
| 410030 | 因腐坏、变质、被盗或遗失冲销抵扣 |
| 410031 | IBS 与 CBS 生效前的供给 |
| 410035 | 微型创业者的供给 |
| 410999 | 其他无对价且不征税的交易 |
| 510001 | 电力的进口、发电、销售、配电与输电,递延 |
| 515001 | 农业与水产养殖投入品,递延(附件九);减率 60 % |
| 550001 | 有形商品出口;须传 tributacaoRegular |
| 550002 | 过境制度;须传 tributacaoRegular |
| 550003 | 仓储制度(第 85 条);须传 tributacaoRegular |
| 550004 | 仓储制度(第 87 条);须传 tributacaoRegular |
| 550005 | 仓储制度(第 87 条单款);须传 tributacaoRegular |
| 550006 | 暂时进境制度;须传 tributacaoRegular |
| 550007 | 加工贸易制度;须传 tributacaoRegular |
| 550008 | Repetro 临时进口制度下的货物进口;须传 tributacaoRegular |
| 550009 | GNL 临时制度;须传 tributacaoRegular |
| 550010 | Repetro 永久制度;须传 tributacaoRegular |
| 550011 | Repetro 工业化制度;须传 tributacaoRegular |
| 550012 | Repetro 国产制度;须传 tributacaoRegular |
| 550013 | Repetro 保税仓制度;须传 tributacaoRegular |
| 550014 | 出口加工区;须传 tributacaoRegular |
| 550015 | 港口现代化与扩建激励税制;须传 tributacaoRegular |
| 550016 | 基础设施发展特别激励制度;须传 tributacaoRegular |
| 550017 | 造船业激励税制;须传 tributacaoRegular |
| 550018 | 资本品采购减负;须传 tributacaoRegular |
| 550019 | 激励工业为在马瑙斯自贸区使用而进口货物;须传 tributacaoRegular |
| 550020 | 自由贸易区;须传 tributacaoRegular |
| 550021 | 出口导向的加工;须传 tributacaoRegular |
| 550022 | 低碳氢生产特别激励制度;须传 tributacaoRegular |
| 550023 | 石油或天然气来源的非燃料液态烃,含石脑油;须传 tributacaoRegular |
| 620001 | 燃油单相征税 |
| 620002 | 燃油单相征税并负责代扣 |
| 620003 | 燃油单相征税,由第三方代扣 |
| 620004 | 乙醇与 A 类汽油调和比例高于法定值的单相征税 |
| 620005 | 乙醇与 A 类汽油调和比例低于法定值的单相征税 |
| 620006 | 燃油单相征税,前环节已征 |
| 620007 | 单相制度下的腐坏、变质、被盗或遗失 |
| 800001 | 合并、分立或吸收 |
| 800002 | 社员的抵扣转移,含基层合作社 |
| 810001 | 自马瑙斯自贸区发出的供给的推定抵扣 |
| 811001 | 免税或免征销项的抵扣冲销 |
| 811002 | 未纳入核算的发票税额补记 |
| 811003 | 退出 Simples Nacional |
itens[].impostos.ibsCbs.zonaFrancaManaus.tipo马瑙斯推定抵扣档位
| 取值 | 含义 |
|---|---|
| 0 | 无推定抵扣 |
| 1 | 最终消费品 |
| 2 | 资本品 |
| 3 | 中间品 |
| 4 | 信息技术产品及法律另行规定的商品 |
itens[].impostos.icms.monofasico.motivoReducaoAdRemad rem 减征事由
只与 percentualReducaoAdRem 一起传。
| 取值 | 含义 |
|---|---|
| 1 | 公共客运 |
| 9 | 其他 |
itens[].combustivel.origens[].ufOrigem燃料来源州
两位 IBGE 州码,不是州简称。
| 取值 | 含义 |
|---|---|
| 11 | RO |
| 12 | AC |
| 13 | AM |
| 14 | RR |
| 15 | PA |
| 16 | AP |
| 17 | TO |
| 21 | MA |
| 22 | PI |
| 23 | CE |
| 24 | RN |
| 25 | PB |
| 26 | PE |
| 27 | AL |
| 28 | SE |
| 29 | BA |
| 31 | MG |
| 32 | ES |
| 33 | RJ |
| 35 | SP |
| 41 | PR |
| 42 | SC |
| 43 | RS |
| 50 | MS |
| 51 | MT |
| 52 | GO |
| 53 | DF |
itens[].cfop操作代码
长码表,此处不逐一列出。取 1970 年 SINIEF 公约 CFOP 附表的现行代码。
| 取值 | 含义 |
|---|---|
| 5NNN | 州内销项 |
| 6NNN | 跨州销项 |
| 7NNN | 出口销项,出口票用 |
| 1NNN / 2NNN / 3NNN | 州内、跨州、国外进项,只用于退货票 |
itens[].ncm商品 NCM 编码
长码表,此处不逐一列出。取联邦税务局公布的南共市统一商品编码现行码;不存在的码 SEFAZ 以 778 驳回。
| 取值 | 含义 |
|---|---|
| NNNNNNNN | 8 位数字 |
itens[].cestCEST 编码
长码表,此处不逐一列出。取现行 ICMS 142/2018 公约的代码。
| 取值 | 含义 |
|---|---|
| NNNNNNN | 7 位数字 |
cliente.endereco.cidadeIBGE 城市码
长码表,见 IBGE 城市码。前 2 位是州码,须与 uf 一致。transporte.enderecoEntrega.cidade 与 transporte.retencaoIcms.codigoMunicipio 同此规则。
| 取值 | 含义 |
|---|---|
| NNNNNNN | 巴西城市,7 位数字 |
| 9999999 | 国外,出口票用,也可不传 |
cliente.endereco.codigoPais国家代码
巴西央行国家码长表,此处不逐一列出。只用于出口票,国内票不传。
| 取值 | 含义 |
|---|---|
| N–NNNN | 1 到 4 位数字,例如 2496 美国 |
| 1058 | 巴西,国内票自动填写 |
itens[].impostos.icms.codigoBeneficioFiscal州税收优惠码
各州各自一张表,此处不逐一列出。取开票方所在州 SEFAZ 公布的 cBenef 表;表外的码 SEFAZ 以 946 驳回。
| 取值 | 含义 |
|---|---|
| XXNNNNNN | 8 位字符,例如 PR800001 |
| XXNNNNNNNN | 10 位字符 |
| SEM CBENEF | 无优惠,只用于未发布优惠表的州。SEFAZ-SP 不接受 |
itens[].combustivel.codigoANPANP 燃料产品码
ANP 产品长码表,此处不逐一列出。由它决定 percentualBiocombustivel、origens 与液化气比例是否必填。
| 取值 | 含义 |
|---|---|
| NNNNNNNNN | 9 位数字 |
| 210203001 | 液化气,须传 percentualGLP、percentualGasNaturalNacional、percentualGasNaturalImportado,三者合计 100 |
itens[].impostos.ibsCbs.creditoPresumido.codigo推定抵扣码
IBS/CBS 官方推定抵扣码表,此处不逐一列出。只能配分类码 000003、000004、410014、410016,其他分类码传了会被拒绝。
| 取值 | 含义 |
|---|---|
| NN | 2 位数字 |
| 错误码 | HTTP | |
|---|---|---|
| 10005215 | 400 | 引用了另一类型的税种:NF-e 只能引用 NFe 税种,NFC-e 只能引用 NFCe 税种;消息点名行与编码。 |
| 10005220 | 400 | 引用的税种与主体当前 CRT 或计税制度不符(IncompativelComRegime);请按新税制整份替换税种。 |
| 10001002 | 400 | 引用税种的商品行在 impostos 里直传了 icms 或 issqn 却没传 cfop,没有税种行可带出 CFOP;消息点名 itens[n].cfop。 |
| 10005230 | 400 | impostos.icms.motivoDesoneracao 或 motivoDesoneracaoSt 不在该税码可用的取值内;消息列出可用值。 |
| 10005235 | 400 | 减免金额推不出,例如没有 percentualReducaoBase 的 CST 90;按消息传 valorDesonerado 或 valorDesoneradoSt。 |
| 10005209 | 400 | 引用的税种在本行需要的组(ICMS 或服务行的 ISSQN、PIS、COFINS)里没有适用于本票的行;消息点名组、场景、客户类型与买方是否非纳税人。 |
| 10005202 | 400 | 商品行引用的税种在本主体下不存在、已删除或属于别的主体;消息点名行与编码。 |
| 10003004 | 400 | 收件人 IBGE 市政码不存在。核对 UF 与 IBGE 码。 |
| 10004051 | 400 | 未传 IBGE 市政码,且无法按邮编补齐:邮编不在基础数据中、对应多个市政或属于别的州。请传 IBGE 码,或核对 cep / uf。 |
| 10003000 | 404 | empresaId 不存在或非本应用名下。 |
| 10004004 | 400 | 主体不可开票(未审批通过或证书未就绪)。等待审批 / 关联证书。 |
| 10004030 | 400 | ambienteEmissao 与主体当前环境不一致。按主体环境提交或联系运营切换。 |
| 10004031 | 400 | 不支持的取值:presencaConsumidor 码表外、未知支付类型或卡品牌、tipoPessoa 与证件不符、IE 与 indicadorContribuinteICMS 不一致、已对接刷卡缺三要素、无运输却传承运人、国内票或出口票缺必填项。mensagem 会点名字段路径。 |
| 10004032 | 400 | 上一次仍在处理或已授权时,同一 id 改动了关键字段重提。请换新 id。 |
| 10004002 | 400 | 该 CNPJ 待处理开票任务超限。稍后重试。 |
| 10005000 | 400 | 税务引擎校验拒绝(税制错配、ST 用于非纳税人、税率越界等)。见 ICMS、CSOSN、PIS/COFINS 各税码小节。 |
| 10005011 | 400 | 平台尚未导入燃料 ANP 码表,燃料行暂不受理。联系支持。 |
| 10005012 | 400 | 燃料行不符合 NF-e 规则,消息里带规则编号与原因(表外 ANP 码用了单相税码、单位与表不符、掺混比或来源州该填未填或不该填、来源合计不为 100、计数器用在 5.656 / 5.667 之外的 CFOP、卖给经销商没带 transporte.transportadora)。 |
| 10005013 | 400 | 单相 ICMS 的每单位税额与 NF-e 门户官方表(按 ANP 码和开票日)不一致。不传或传表值;减征须同时传 percentualReducaoAdRem 与 motivoReducaoAdRem。 |
| 10004020 | 400 | CST 20/30/40/41/50/51/70/90 缺少 codigoBeneficioFiscal。 |
| 10004021 | 400 | 退货票:行缺 notaReferenciada.numeroItem 或单据缺 notaReferenciada.chaveAcesso。 |
| 10004022 | 400 | 非退货票携带行级引用。 |
| 10004023 | 400 | 原票不存在或不属本主体。 |
| 10004024 | 400 | 原票未授权。 |
| 10004025 | 400 | 原票行不存在。 |
| 10004026 | 400 | 数量超原票行(引用同一原票行的多行合计)。 |
| 10004028 | 400 | 补充票或调整票缺 notaReferenciada.chaveAcesso。补上原票。 |
| 10004029 | 400 | 普通票带了 notaReferenciada.chaveAcesso 却没有行级引用。票头引用只给 Complementar / Ajuste 用;退货票按行引用。 |
| 10004034 | 400 | CNPJ 买方既没传 cliente.inscricaoEstadual 也没传 indicadorContribuinteICMS。纳税人补 IE;无 IE 的企业传 NaoContribuinte 或 ContribuinteIsento。 |
| 10004043 | 400 | 契约字段缺失(减基比例 / ST MVA 与税率 / 递延比例 / 按量单位税额 / IPI 税码 / percentualCreditoSimples 请求与档案皆无 / ST 商品缺 cest),mensagem 点名字段路径。按所用税码的小节补字段。 |
| 10004044 | 400 | 字段不适用于该税码(非 ST 税码带 substituicaoTributaria、非抵免税码带 percentualCreditoSimples、CST 02/15/53/61 之外带 monofasico)。去掉该组。 |
| 10004045 | 400 | CNPJ 买方的 cliente.inscricaoEstadual 不符合买方所在州的校验位规则。核对买方 IE 与州。 |
| 10004046 | 400 | 税码与主体税制不匹配(CRT 1/4 须三位 CSOSN,CRT 2/3 须两位 CST)。 |
| 10004047 | 400 | 非纳税人买方使用了只对纳税人合法的税码(10/30/70、101/201/202/203)或携带 percentualCreditoSimples。改用 102 / 500 或不带抵免的 900。 |
| 10001001 | 400 | 请求字段校验失败(每字段一条)。按 mensagem 修正。 |
