开具 NF-e

路径参数

empresaId*

string

开票主体标识

* 必填字段

请求体

`id*`	string	请求标识
`ambienteEmissao*`	string	开票环境
`finalidade`	string	开票目的
`*` 退货、补充、调整票必填。	object	原票引用
`naturezaOperacao`	string	操作性质描述
`consumidorFinal`	bool	最终消费者标记
`informacoesAdicionais`	string	票面备注
`informacoesAdicionaisFisco`	string	税务机关备注
`*`	object	订单信息
`*`	object	买方
`*`	array	商品行
	object	运输信息
	object	账单分期
`*` 出口票必填。	object	出境信息

* 必填字段

200

受理成功，无响应体。SEFAZ 返回前发票处于 AguardandoAutorizacao。

无响应体

Simples Nacional 商家（CRT 1）线上卖给个人。只需要例子里的五个块；下面的字段表只列要填的字段，没列出来的都不用传。

json

{
  "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	商品行

* 必填字段

简易票之外的一切都是可选的；不传时出票结果与场景二完全一致。可用的组：

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、informacoesAdicionais、pedido。

下面各小节按场景给出每个组的例子和要填的字段；违反规则返回 10004031 并附字段路径。

json

{
  "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）。

json

{
  "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 和税码以会计确认为准。

json

{
  "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 税参与原票行保持一致。

json

{
  "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	商品行

* 必填字段

tipoPessoa、cpfCnpj、inscricaoEstadual、indicadorContribuinteICMS 要互相匹配。组合决定买方是不是 ICMS 纳税人，进而决定能用哪些 ICMS 税码（10004047）。国外买方见出口票小节。

个人消费者

电商最常见的买方。不传州注册号也不传身份指示，平台按非纳税人处理；只能用非纳税人税码。

json

"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 抵免。

json

"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）。按非纳税人处理。

json

"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）。

json

"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，各行之和要与支付对得上。

带折扣、分摊运费、条码和采购单号的商品行

json

{
  "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。

json

{
  "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 自动算。

json

"icms": { "situacaoTributaria": "00", "aliquota": 18 }

`situacaoTributaria*`	string	税码
`aliquota`	number	ICMS 税率
`aliquotaFcp`	number	FCP 税率
	object	DIFAL

* 必填字段

CST 10：征税并代收下游 ST

卖方自己缴 ICMS，还替下游环节预先代收。只对纳税人买方（10004047）。

json

"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：税基缩减

税基比价格小。要带州税收优惠码。

json

"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，但替下游代收。只对纳税人买方。

json

"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。

json

"icms": { "situacaoTributaria": "40", "codigoBeneficioFiscal": "SP800001" }

`situacaoTributaria*`	string	税码
`codigoBeneficioFiscal*`	string	州税收优惠码
`substituicaoTributariaDestino`	object	目的州 ST 组

* 必填字段

CST 51：递延

一部分税推到链条后面的环节再缴。

json

"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 商品卖给终端消费者：税已在上游缴过。不传税率。

json

"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 的代收合在一起。只对纳税人买方。

json

"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：其他

组合式税码：传了哪个组就算哪个组，除优惠码外没有必填。

json

"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。

json

"icms": { "situacaoTributaria": "15", "monofasico": { "quantidadeBaseCalculo": 7300, "quantidadeBaseCalculoRetencao": 2700 } }

`situacaoTributaria*`	string	税码
`*`	object	燃油单相组
`percentualDiferimento`	number	递延比例

* 必填字段

IBS 与 CBS 是 2026 税改的两个税种：IBS 接替 ICMS 与 ISS，CBS 接替 PIS 与 COFINS。2026 年只申报不征收，用测试税率。一般税制公司（CRT 3）每张票都带本组；Simples 公司 2027 年才需要，之前传了也忽略。普通销售什么都不用传，平台按 000 加分类码 000001 写出。下面是例外情形；一行传了本组，每一行都要传。

IBS/CBS 200：减率

减率比例由分类码决定。

json

"ibsCbs": { "situacaoTributaria": "200", "classificacaoTributaria": "200003" }

`situacaoTributaria*`	string	税码
`classificacaoTributaria*`	string	分类码

* 必填字段

IBS/CBS 410：免征或不征

票面不出税额。

json

"ibsCbs": { "situacaoTributaria": "410", "classificacaoTributaria": "410001" }

`situacaoTributaria*`	string	税码
`classificacaoTributaria*`	string	分类码

* 必填字段

IBS/CBS 510 / 515：递延

515 是递延加减率。

json

"ibsCbs": { "situacaoTributaria": "510", "classificacaoTributaria": "510001", "percentualDiferimento": 100 }

`situacaoTributaria*`	string	税码
`classificacaoTributaria*`	string	分类码
`percentualDiferimento*`	number	递延比例

* 必填字段

IBS/CBS 550：暂停征收

在 tributacaoRegular 里写没有暂停时本来该怎么征。

json

"ibsCbs": { "situacaoTributaria": "550", "classificacaoTributaria": "550001", "tributacaoRegular": { "situacaoTributaria": "000", "classificacaoTributaria": "000001" } }

`situacaoTributaria*`	string	税码
`classificacaoTributaria*`	string	分类码
`*`	object	常规征税

* 必填字段

IBS/CBS 620：燃油按量

json

"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：抵扣转移、自贸区抵扣、期间调整

json

"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，任何状态下可选

只有分类码允许推定抵扣时才传。

json

"ibsCbs": { "situacaoTributaria": "000", "classificacaoTributaria": "000001", "creditoPresumido": { "codigo": "01", "percentualIbs": 2, "percentualCbs": 1, "suspensivo": false, "deduzir": true } }

object

推定抵扣

* 必填字段

每一笔都要 tipo 与 valor。各笔合计减 troco 必须等于票面总额。下面几种情形覆盖全部 22 个类型。

现金、支票、银行票据、存款、转账、各类券、店铺信用、店内余额、忠诚计划

只填类型和金额。这些类型都不能带刷卡终端信息。

json

"pagamento": { "formas": [ { "tipo": "BoletoBancario", "valor": 56.94 } ] }

*

array

支付明细

* 必填字段

信用卡、借记卡、Pix：未对接的刷卡终端

电商的常规情形：刷卡终端或 Pix 不与开票系统对接。credenciadoraCartao 可以不传，平台按未对接终端申报。

json

"pagamento": { "formas": [ { "tipo": "CartaoDeCredito", "valor": 56.94, "credenciadoraCartao": { "tipoIntegracaoPagamento": "NaoIntegradoAoSistemaDeGestao", "bandeira": "Mastercard" } } ] }

*

array

支付明细

* 必填字段

与开票系统对接的刷卡终端

门店的对接式刷卡。三个交易信息都必填，缺任一返回 10004031。

json

"pagamento": { "formas": [ { "tipo": "CartaoDeDebito", "valor": 56.94, "credenciadoraCartao": { "tipoIntegracaoPagamento": "IntegradoAoSistemaDeGestao", "cnpj": "01027058000191", "bandeira": "Visa", "codigoAutorizacao": "123456" } } ] }

*

array

支付明细

* 必填字段

其他支付方式 Outros

表里没有的方式；说明必填。

json

"pagamento": { "formas": [ { "tipo": "Outros", "valor": 56.94, "descricao": "Vale-troca" } ] }

*

array

支付明细

* 必填字段

多笔支付与找零

各笔合计减找零必须正好等于票面总额，差一分都会被拒。

json

"pagamento": { "troco": 3.06, "formas": [ { "tipo": "Dinheiro", "valor": 40.00 }, { "tipo": "PagamentoInstantaneoPix", "valor": 20.00 } ] }

`formas*`	array	支付明细
`troco`	number	找零

* 必填字段

赊购 PagamentoAPrazo

通常配银行票据。要登记分期，再传 cobranca 组。

json

"pagamento": { "tipo": "PagamentoAPrazo", "formas": [ { "tipo": "BoletoBancario", "valor": 100.00 } ] }

`tipo*`	string	付款时点
`formas*`	array	支付明细

* 必填字段

后付 PagamentoPosterior

开票时还没收款，或只收了一部分。PagamentoPosterior 这一笔金额填 0；有这一笔时，各笔合计可以低于票面总额，但不能有找零。

json

"pagamento": { "formas": [ { "tipo": "Dinheiro", "valor": 20.00 }, { "tipo": "PagamentoPosterior", "valor": 0 } ] }

*

array

支付明细

* 必填字段

无支付 SemPagamento，只用于退货票

只能是唯一一笔，金额 0。正常销售票税务局会拒。

json

"pagamento": { "formas": [ { "tipo": "SemPagamento", "valor": 0 } ] }

*

array

支付明细

* 必填字段

不传 transporte 组就按 SemFrete 出票，票面不申报运费，不想填物流就这样。SemFrete 时不要传 transportadora、veiculo、retencaoIcms（10004031）。

委托承运人运输

PorContaDoEmitente、PorContaDoDestinatario 或 PorContaDeTerceiros。各子组都可选，知道什么填什么。

json

"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 台。

json

"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 并用。

json

"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 码。

json

"transporte": {
  "enderecoEntrega": { "cpfCnpj": "11222333000181", "nome": "Deposito Demo", "uf": "PR", "cidade": "4106902", "logradouro": "Rua B", "numero": "20", "bairro": "Centro", "cep": "80010000", "telefone": "41999990000" }
}

*

object

交货地址

* 必填字段

`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.veiculo.uf、transporte.enderecoEntrega.uf 与 exportacao.ufEmbarque（这些不能用 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`卡品牌

不区分大小写，平台转换为官方品牌码。

取值	含义
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
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.situacaoTributaria`ICMS 税码 CST，一般税制 CRT 2 / 3

取值	含义
00	全额征税
02	燃油按量，自征
10	征税并代收下游 ST
15	燃油按量，自征加代征
20	税基缩减
30	自身免税但代收下游 ST
40	免税
41	不征税
50	暂缓
51	递延
53	燃油按量，递延
60	上游已代收 ST
61	燃油按量，前环节已征
70	税基缩减并代收下游 ST
90	其他

`itens[].impostos.icms.situacaoTributaria`ICMS 税码 CSOSN，Simples Nacional CRT 1 / 4

取值	含义
101	征税且允许买方抵扣
102	征税不抵扣
103	营收区间免征
201	代收 ST 且允许抵扣
202	代收 ST 不抵扣
203	营收区间免征并代收 ST
300	宪法豁免
400	不征税
500	上游已代收 ST
900	其他

`itens[].impostos.pis.situacaoTributaria`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.cofins.situacaoTributaria`COFINS 税码

与 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.situacaoTributaria`IPI 税码

取值	含义
00	进项征税
01	进项零税率
02	进项免税
03	进项不征
04	进项豁免
05	进项暂缓
49	其他进项
50	销项征税
51	销项零税率
52	销项免税
53	销项不征
54	销项豁免
55	销项暂缓
99	其他销项

`itens[].impostos.ibsCbs.situacaoTributaria`IBS/CBS 状态码

不传即 000。

取值	含义
000	全额征税
200	减率
410	免征或不征
510	递延
515	递延加减率
550	暂停征收
620	燃油按量征税
800	抵扣转移
810	马瑙斯自贸区推定抵扣
811	以前期间调整

`itens[].impostos.ibsCbs.classificacaoTributaria`IBS/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	信息技术产品及法律另行规定的商品

错误码	HTTP
10003004	400	收件人 IBGE 市政码不存在。核对 UF 与 IBGE 码。
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` 修正。

`presencaConsumidor*`	string	在场方式
	object	中介平台

参数

路径参数

请求体

响应

场景一 Simples Nacional 简易票（CSOSN 102）

场景二 一般税制公司（CST 00）

场景三 完整票

开票目的 finalidade3 块

Complementar：给已授权的原票补开

Ajuste：对已授权的原票做调整

Devolucao：退一张已授权的原票

在场方式 pedido.presencaConsumidor1 块

在场方式与中介平台

买方 cliente4 块

个人消费者

企业买方，ICMS 纳税人

企业买方，没有州注册号

有州注册号的个人（农户等）

商品行 itens[]2 块

带折扣、分摊运费、条码和采购单号的商品行

燃料行：分销商卖柴油 B

ICMS 一般税制（CRT 2 / 3）10 块

CST 00：全额征税

CST 10：征税并代收下游 ST

CST 20：税基缩减

CST 30：自身免税但代收下游 ST

CST 40 / 41 / 50：免税、不征税、暂缓

CST 51：递延

CST 60：上游已代收 ST

CST 70：税基缩减并代收下游 ST

CST 90：其他

CST 02 / 15 / 53 / 61：燃油按量征税

ICMS Simples Nacional（CRT 1 / 4）5 块

CSOSN 102 / 103 / 300 / 400：不带抵扣

CSOSN 101：允许买方抵扣

CSOSN 201 / 202 / 203：代收下游 ST

CSOSN 500：上游已代收 ST

CSOSN 900：其他

PIS 与 COFINS5 块

CST 01 / 02：按税率征税

CST 03：按数量征税

CST 04 到 09：销售不征税

CST 49 / 99：其他操作

CST 50 到 75 与 98：进项码，只用于退货票

IPI3 块

IPI 征税：CST 50 / 99

IPI 不征税：CST 51 到 55

IPI 退货票：CST 00 到 49

IBS/CBS（2026 税改）7 块

IBS/CBS 200：减率

IBS/CBS 410：免征或不征

IBS/CBS 510 / 515：递延

IBS/CBS 550：暂停征收

IBS/CBS 620：燃油按量

IBS/CBS 800 / 810 / 811：抵扣转移、自贸区抵扣、期间调整

推定抵扣 creditoPresumido，任何状态下可选

支付 pedido.pagamento8 块

现金、支票、银行票据、存款、转账、各类券、店铺信用、店内余额、忠诚计划

信用卡、借记卡、Pix：未对接的刷卡终端

与开票系统对接的刷卡终端

其他支付方式 Outros

多笔支付与找零

赊购 PagamentoAPrazo

后付 PagamentoPosterior

无支付 SemPagamento，只用于退货票

卡品牌（credenciadoraCartao.bandeira）

运输 transporte4 块

委托承运人运输

自有车辆运输

运费的 ICMS 代扣

交货地址与买方地址不同

账单分期 cobranca1 块

分两期的账单

出口票1 块

卖到国外

枚举20 张表

ambienteEmissao开票环境

finalidade开票目的

cliente.tipoPessoa买方类型

`ambienteEmissao`开票环境

`finalidade`开票目的

`cliente.tipoPessoa`买方类型

`cliente.indicadorContribuinteICMS`买方 ICMS 身份

`cliente.endereco.uf`买方所在州

`pedido.presencaConsumidor`在场方式

`pedido.pagamento.tipo`付款时点

`pedido.pagamento.formas[].tipo`支付方式

`pedido.pagamento.formas[].credenciadoraCartao.tipoIntegracaoPagamento`刷卡终端对接方式

`pedido.pagamento.formas[].credenciadoraCartao.bandeira`卡品牌

`transporte.frete.modalidade`运费方式

`itens[].origem`商品来源

`itens[].impostos.icms.situacaoTributaria`ICMS 税码 CST，一般税制 CRT 2 / 3

`itens[].impostos.icms.situacaoTributaria`ICMS 税码 CSOSN，Simples Nacional CRT 1 / 4

`itens[].impostos.pis.situacaoTributaria`PIS 税码

`itens[].impostos.cofins.situacaoTributaria`COFINS 税码

`itens[].impostos.ipi.situacaoTributaria`IPI 税码

`itens[].impostos.ibsCbs.situacaoTributaria`IBS/CBS 状态码

`itens[].impostos.ibsCbs.classificacaoTributaria`IBS/CBS 分类码

`itens[].impostos.ibsCbs.zonaFrancaManaus.tipo`马瑙斯推定抵扣档位