NFC-e
开具 NFC-e
为州内卖给最终消费者的零售开具消费者电子发票(模型 65);缺省异步,也可同步等待结果当场打印。
/openapi/v2/empresas/{empresaId}/nfcetoken、timestamp、sign 三个签名头,参见认证与签名。路径参数
empresaId* | string | 开票主体标识 |
* 必填字段
请求体
id* | string | 请求标识 |
ambienteEmissao* | string | 开票环境 |
modoResposta | string | 响应模式 |
consumidorFinal | bool | 最终消费者标志 |
informacoesAdicionais | string | 补充信息 |
| array | 纳税人观察项 |
| array | 给税务机关的观察项 |
| array | 授权下载 XML 的证件 |
* | object | 订单与支付 |
*配送销售、金额超过州识别门槛、或消费者要求在票上印 CPF 时必填 | object | 消费者 |
*配送销售必填 | object | 运输信息 |
* | array | 商品行 |
* 必填字段
Autorizada、Negada 或 ContingenciaPendente(见下方示例)。AguardandoAutorizacao。最终结果经 Webhook 推送,也可按同一 id 查询。| 模式 | 适用 | 响应 |
|---|---|---|
Assincrono(缺省) | 后台批量、外卖订单 | HTTP 200 无内容;结果经 Webhook 或查询接口获知 |
Sincrono | 收银台要当场打印小票 | HTTP 200,响应体与查询接口相同。10 秒内没有结果返回 HTTP 202 与 AguardandoAutorizacao,最终结果经 Webhook 推送 |
SEFAZ 不可用且本州允许离线应急时,同步模式返回 200 与 ContingenciaPendente:离线小票可以当场打印交给顾客,平台在 SEFAZ 恢复后自动补传。
两种模式都会推送 Webhook。
幂等。 id 是幂等键:同一 id 重复提交返回同一张票,不会重复开票。网络超时后请用同一个 id 重试。上一次结果为 Negada 时,同一 id 修正字段后重提会重新开票。建议用「终端号 + 本地流水号」,如 PDV01-000123。
每种模式从头到尾走一遍:发什么、接口回什么、最终结果怎么拿到。两种模式的 Webhook 都要先在 Webhook 注册里订阅 nfce.* 事件才会推送。
异步 1/3:请求
餐厅后台系统提交的订单,不需要在收银台等结果。不传 modoResposta 即异步。
{"id": "LOJA01-PED-98765","ambienteEmissao": "Homologacao","pedido": {"presencaConsumidor": "OperacaoPresencial","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 42.50 } ] }},"itens": [{"cfop": "5102", "codigo": "PF-FRANGO", "descricao": "PRATO FEITO FRANGO", "ncm": "21069090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 32.50,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }},{"cfop": "5405", "codigo": "7894900011517", "descricao": "REFRIGERANTE LATA 350ML", "ncm": "22021000", "cest": "0300700","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 5.00,"impostos": { "icms": { "situacaoTributaria": "500" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
异步 2/3:返回 HTTP 200 无内容
接口立即返回 HTTP 200,响应体为空:只表示已受理,不代表已授权。字段校验不通过时和同步模式一样当场返回 400。请保存提交时的 id,Webhook 里的 nfeId 和查询接口都用它定位这张票。
异步 3/3:Webhook 推送结果
通常几秒内收到 nfce.authorized,内容如下。SEFAZ 驳回时收到 nfce.rejected,nfeStatus 为 Negada,原因在 nfeMotivoStatus,链接和协议号为 null。不接 Webhook 的,用同一个 id 查询。
{"tipo": "NFC-e","empresaId": "1934811222334455","nfeId": "LOJA01-PED-98765","nfeStatus": "Autorizada","nfeMotivoStatus": null,"nfeLinkDanfe": "https://api.v2.tffiscal.com/openapi/files/danfce/35261111222333000181650010000001251123456784?token=MXw3fDEwMXwxNzU4...","nfeLinkXml": "https://api.v2.tffiscal.com/openapi/files/xml/9903?token=MXw3fDEwMXwxNzU4...","nfeNumero": "125","nfeSerie": "1","nfeChaveAcesso": "35261111222333000181650010000001251123456784","nfeDataEmissao": "2026-11-04T18:05:11Z","nfeDataAutorizacao": "2026-11-04T18:05:12Z","nfeNumeroProtocolo": "135261234567892","nfeQrCode": "https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35261111222333000181650010000001251123456784|3|2"}
异步:驳回时的 Webhook
{"tipo": "NFC-e","empresaId": "1934811222334455","nfeId": "LOJA01-PED-98765","nfeStatus": "Negada","nfeMotivoStatus": "778 - Rejeicao: Informado NCM inexistente","nfeLinkDanfe": null,"nfeLinkXml": null,"nfeNumero": "125","nfeSerie": "1","nfeChaveAcesso": "35261111222333000181650010000001251123456784","nfeDataEmissao": "2026-11-04T18:05:11Z","nfeDataAutorizacao": null,"nfeNumeroProtocolo": null,"nfeQrCode": null}
同步 1/3:请求
收银台传 "modoResposta": "Sincrono",拿到响应再打印小票。完整请求体见本页顶部的请求示例;调用方的 HTTP 超时请设为 15 秒以上。
同步 2/3:HTTP 200 已授权
最常见的情况:SEFAZ 在 10 秒内返回,接口回 HTTP 200,状态 Autorizada(示例见「响应」部分)。用 linkDanfe 直接打印,或用 qrCode、urlConsulta、chaveAcesso 自行排版小票。同时也会收到 nfce.authorized 回调。
同步 3/3:HTTP 202 等待中
SEFAZ 10 秒内没有返回。这张票已有号码和访问密钥,但还没有协议号和小票链接,先不要打印。最终结果经 nfce.authorized 或 nfce.rejected 推送,也可以用同一个 id 查询。用同一个 id 重提不会多开一张。如果当时还在排队、尚未取号,numero、serie、chaveAcesso 也为 null。
{"id": "PDV01-000123","tipo": "NFC-e","status": "AguardandoAutorizacao","motivoStatus": null,"ambienteEmissao": "Homologacao","dataCriacao": "2026-11-04T15:20:01Z","dataUltimaAlteracao": "2026-11-04T15:20:01Z","numero": "123","serie": "1","dataEmissao": "2026-11-04T15:20:01Z","chaveAcesso": "35261111222333000181650010000001231123456780","dataAutorizacao": null,"protocolo": null,"qrCode": "https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35261111222333000181650010000001231123456780|3|2","urlConsulta": "https://www.homologacao.nfce.fazenda.sp.gov.br/consulta","linkDanfe": null,"linkDownloadXml": null,"emitidaEmContingencia": false,"alertas": [],"valorTotal": 60.30}
同步:HTTP 200 离线开出
SEFAZ 不可用且本州允许离线应急:返回 HTTP 200,状态 ContingenciaPendente,emitidaEmContingencia 为 true。此时已有 linkDanfe,直接打印交给顾客,小票上带离线标识。SEFAZ 恢复后平台自动补传,授权后推送 nfce.authorized,补传被拒推送 nfce.rejected。
{"id": "PDV01-000124","tipo": "NFC-e","status": "ContingenciaPendente","motivoStatus": null,"ambienteEmissao": "Homologacao","dataCriacao": "2026-11-04T15:31:40Z","dataUltimaAlteracao": "2026-11-04T15:31:42Z","numero": "124","serie": "1","dataEmissao": "2026-11-04T15:31:41Z","chaveAcesso": "35261111222333000181650010000001249123456782","dataAutorizacao": null,"protocolo": null,"qrCode": "https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35261111222333000181650010000001249123456782|3|2|...","urlConsulta": "https://www.homologacao.nfce.fazenda.sp.gov.br/consulta","linkDanfe": "https://api.v2.tffiscal.com/openapi/files/danfce/35261111222333000181650010000001249123456782?token=MXw3fDEwMXwxNzU4...","linkDownloadXml": null,"emitidaEmContingencia": true,"alertas": [],"valorTotal": 60.30}
平台在取号前先检查以下规则,违反返回 10022004,mensagem 点名具体原因。
| 规则 | 说明 |
|---|---|
| 送货地址须州内 | transporte.enderecoEntrega 须与开票主体同州 |
| 只能卖给最终消费者 | consumidorFinal 只能为 true,买方不能有州注册号 |
| 在场方式 | 只能 OperacaoPresencial、EntregaEmDomicilio、OperacaoPresencialForaDoEstabelecimento |
| 配送销售 | 必须识别消费者(证件号、地址)并填承运方 |
| 金额上限 | 单票不得超过 R$200.000,部分州更低 |
| 识别门槛 | 单票超过 R$10.000 必须识别消费者,多个州门槛更低 |
| 支付 | 合计减找零等于票面总额;不能用 SemPagamento |
| 只开正常票 | 不能开退货、补充、调整票,不能引用其他票 |
| 实时开票 | 开票时刻早于 SEFAZ 收到时刻 5 分钟以上会被 SEFAZ 驳回(704) |
NFC-e 不接受的字段。 传了会在一次 10022004 里全部列出:finalidade 不是 Normal、naturezaOperacao、notaReferenciada、cobranca、exportacao、cliente.inscricaoEstadual、transporte.veiculo、transporte.reboques、transporte.retencaoIcms、transporte.enderecoRetirada(NT 2026.002 起 NFC-e 不能带取货地址),以及商品行的 pedido、notaReferenciada、impostos.ipi、impostos.icms.substituicaoTributaria、impostos.icms.difal、impostos.icms.motivoDesoneracaoSt、impostos.icms.valorDesoneradoSt、impostos.icms.codigoBeneficioFiscalReducaoBase。
可用的 CFOP。
| CFOP | 用途 | 可配 ICMS 税码 |
|---|---|---|
| 5101、5102 | 销售自产商品 / 外购商品 | CST 00、20、40、41、90;CSOSN 102、103、300、400、900 |
| 5103、5104 | 从非生产场所销售 | 同上 |
| 5115 | 寄售商品销售 | 同上 |
| 5405 | 销售已由前道代收 ICMS-ST 的商品 | CST 60;CSOSN 500 |
| 5910 | 赠品、促销、样品赠送 | CST 00、20、40、41、60、90;CSOSN 102、103、300、400、500、900 |
CST 00、20、40、41、90 与 CSOSN 102、103、300、400、900 只能配 5101 至 5104、5115 和 5910(下方州例外除外)。代收类税码 CST 60、CSOSN 500 只能配 5405、5656、5667 和 5910。
5656、5667(燃料,配 CST 60 / 61 或 CSOSN 500)须在商品行带 combustivel 组。5933 是与商品同票的服务行:该行传 impostos.issqn 代替 icms,整张票至少要有一行带 ICMS 的商品,开票主体须在主体资料里登记市政注册号。服务金额计入票面总额。
州例外:RS、ES 允许 5949 配 CST 90 / CSOSN 900;SP 允许 5949 配 CST 40 / CSOSN 900,用于登记小费;CE 允许 5403、5405 配 CST 90 / CSOSN 900。MEI 主体只能用 CSOSN 102 或 300 配 CFOP 5102,服务行同样受此约束,所以 MEI 不能开服务行。
可用的 ICMS 税码。
| 主体税制 | 税码 |
|---|---|
| 一般税制(CST) | 00、20、40、41、60、61;90 由州决定 |
| Simples Nacional(CSOSN) | 102、103、300、400、500;900 由州决定 |
| MEI | 102、300 |
SEFAZ 侧规则。 部分州禁止 CSOSN 103 与 400,平台受理时不检查,由 SEFAZ 授权时驳回,票为 Negada。
pedido.presencaConsumidor | 请求体的区别 |
|---|---|
OperacaoPresencial | 只需 pedido 和 itens;cliente 可选;不传 transporte |
EntregaEmDomicilio | cliente 带证件号和地址,必须有 transporte.transportadora;经外卖或电商平台下单的再加 pedido.intermediadorTransacao |
OperacaoPresencialForaDoEstabelecimento | 和门店现场销售一样,在外地城市销售时加 pedido.municipioOcorrencia;不传 transporte |
部分州禁止配送销售开 NFC-e,或只允许同城配送,见 NFC-e。
门店现场销售:消费者不识别
收银台最常见的情况。不传 cliente,小票印 CONSUMIDOR NÃO IDENTIFICADO。现金付款有找零:各支付金额之和减去 troco 等于票面总额。
{"id": "PDV01-000130","ambienteEmissao": "Homologacao","modoResposta": "Sincrono","pedido": {"presencaConsumidor": "OperacaoPresencial","pagamento": { "formas": [ { "tipo": "Dinheiro", "valor": 50.00 } ], "troco": 7.50 }},"itens": [{"cfop": "5102", "codigo": "PF-FRANGO", "descricao": "PRATO FEITO FRANGO", "ncm": "21069090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 32.50,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }},{"cfop": "5405", "codigo": "7894900011517", "descricao": "REFRIGERANTE LATA 350ML", "ncm": "22021000", "cest": "0300700","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 5.00,"impostos": { "icms": { "situacaoTributaria": "500" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
门店现场销售:消费者报 CPF
顾客要求在小票上印 CPF:cliente 只传 tipoPessoa 和 cpfCnpj。姓名和地址可不传,超过本州识别门槛时除外。
{"id": "PDV01-000131","ambienteEmissao": "Homologacao","modoResposta": "Sincrono","pedido": {"presencaConsumidor": "OperacaoPresencial","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 42.50 } ] }},"cliente": { "tipoPessoa": "F", "cpfCnpj": "52998224725" },"itens": [{"cfop": "5102", "codigo": "PF-FRANGO", "descricao": "PRATO FEITO FRANGO", "ncm": "21069090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 32.50,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }},{"cfop": "5405", "codigo": "7894900011517", "descricao": "REFRIGERANTE LATA 350ML", "ncm": "22021000", "cest": "0300700","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 5.00,"impostos": { "icms": { "situacaoTributaria": "500" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
配送销售:商家自配送
电话或自有网站下单,由商家或雇佣的骑手配送。cliente 带证件号和送货地址,并填 transporte.transportadora。
{"id": "APP-DELIVERY-98765","ambienteEmissao": "Homologacao","pedido": {"presencaConsumidor": "EntregaEmDomicilio","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 89.90 } ] }},"cliente": {"tipoPessoa": "F","nome": "Maria da Silva","cpfCnpj": "52998224725","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Rua Augusta", "numero": "1500", "bairro": "Consolacao", "cep": "01304001" }},"transporte": {"frete": { "modalidade": "PorContaDoEmitente" },"transportadora": { "cpfCnpj": "11222333000181", "nome": "Entregas Rapidas LTDA", "uf": "SP" }},"itens": [{"cfop": "5102", "codigo": "PIZ-GG-01", "descricao": "PIZZA GRANDE MUSSARELA", "ncm": "19059090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 89.90,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
配送销售:外卖平台订单
和自配送相同,另加 pedido.intermediadorTransacao:平台的 CNPJ 和商家在平台上的店铺编号。
{"id": "APP-DELIVERY-98766","ambienteEmissao": "Homologacao","pedido": {"presencaConsumidor": "EntregaEmDomicilio","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 89.90 } ] },"intermediadorTransacao": { "cnpj": "33444555000181", "identificadorCadastro": "loja-centro-123" }},"cliente": {"tipoPessoa": "F","nome": "Maria da Silva","cpfCnpj": "52998224725","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Rua Augusta", "numero": "1500", "bairro": "Consolacao", "cep": "01304001" }},"transporte": {"frete": { "modalidade": "PorContaDoEmitente" },"transportadora": { "cpfCnpj": "11222333000181", "nome": "Entregas Rapidas LTDA", "uf": "SP" }},"itens": [{"cfop": "5102", "codigo": "PIZ-GG-01", "descricao": "PIZZA GRANDE MUSSARELA", "ncm": "19059090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 89.90,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
店外现场销售:外地展会摊位
在展会、活动或流动摊点现场销售。示例里展会在坎皮纳斯,开票主体在圣保罗市,所以传 pedido.municipioOcorrencia = 3509502;在开票主体所在城市销售时不传。销售城市必须和开票主体同州。
{"id": "FEIRA-CAMPINAS-0007","ambienteEmissao": "Homologacao","modoResposta": "Sincrono","pedido": {"presencaConsumidor": "OperacaoPresencialForaDoEstabelecimento","municipioOcorrencia": "3509502","pagamento": { "formas": [ { "tipo": "CartaoDeDebito", "valor": 36.00 } ] }},"itens": [{"cfop": "5102", "codigo": "DOCE-LEITE-500", "descricao": "DOCE DE LEITE POTE 500G", "ncm": "19019020","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 18.00,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
ambienteEmissao开票环境
| 取值 | 含义 |
|---|---|
| Homologacao | 税务局测试环境,票无法律效力 |
| Producao | 正式环境 |
modoResposta响应模式
不传即 Assincrono。
| 取值 | 含义 |
|---|---|
| Assincrono | 受理即返回 HTTP 200 无内容,结果经 Webhook 推送 |
| Sincrono | 最多等待 SEFAZ 结果 10 秒,超时返回 HTTP 202 |
pedido.presencaConsumidor消费者在场方式
| 取值 | 含义 |
|---|---|
| OperacaoPresencial | 门店现场销售,不能带承运方 |
| EntregaEmDomicilio | 非现场销售并配送,必须传 cliente 的证件号与地址,以及 transporte.transportadora;送货地址须与开票主体同州 |
| OperacaoPresencialForaDoEstabelecimento | 店外现场销售,如展会、流动摊点,不能带承运方 |
| OperacaoPelaInternet | 互联网销售,请改开 NF-e。NFC-e 不接受 |
| OperacaoPorTelefone | 电话销售,请改开 NF-e。NFC-e 不接受 |
| NaoSeAplica | 不适用。NFC-e 不接受 |
| Outros | 其他。NFC-e 不接受 |
pedido.pagamento.formas[].tipo支付方式
与 NF-e 名称相同,但 NFC-e 不接受 SemPagamento。credenciadoraCartao 只能用于下表标注的支付方式,descricao 只能用于 Outros,其他支付方式带了返回 10022004。
| 取值 | 含义 |
|---|---|
| Dinheiro | 现金,可产生找零 |
| Cheque | 支票 |
| CartaoDeCredito | 信用卡,多数州须填 credenciadoraCartao |
| CartaoDeDebito | 借记卡,多数州须填 credenciadoraCartao |
| CreditoLoja | 赊销 |
| ValeAlimentacao | 食品券,可填 credenciadoraCartao |
| ValeRefeicao | 餐券,可填 credenciadoraCartao |
| ValePresente | 礼品券,可填 credenciadoraCartao |
| ValeCombustivel | 燃油券,可填 credenciadoraCartao |
| BoletoBancario | 银行票据,可填 credenciadoraCartao |
| DepositoBancario | 银行存款 |
| PagamentoInstantaneoPix | Pix 动态码,多数州须填 credenciadoraCartao |
| TransferenciaBancaria | 银行转账,可填 credenciadoraCartao |
| ProgramaDeFidelidade | 积分或返现 |
| PagamentoInstantaneoPixEstatico | Pix 静态码:静态二维码、Pix 密钥或账户信息 |
| CreditoEmLoja | 店内余额,来自此前付款或退货 |
| PagamentoEletronicoNaoInformado | 未能对接的电子支付,只用于收银硬件故障且无法离线开票 |
| PagamentoInstantaneoPixAutomatico | Pix 自动扣款 |
| TransferenciaTefBookTransfer | TEF 同行转账 |
| PagamentoPosterior | 后付,金额 0;有这一笔时合计可低于票面总额,不能找零 |
| SemPagamento | 无支付。NFC-e 不接受 |
| Outros | 其他,须填 descricao |
pedido.pagamento.formas[].credenciadoraCartao.tipoIntegracaoPagamento刷卡终端对接方式
只要传了 credenciadoraCartao 就必填;不传或不在表内返回 10022004。
| 取值 | 含义 |
|---|---|
| NaoIntegradoAoSistemaDeGestao | 终端未对接收银系统,bandeira 可选 |
| IntegradoAoSistemaDeGestao | 终端已对接收银系统,须传 cnpj 与 codigoAutorizacao |
pedido.pagamento.formas[].credenciadoraCartao.bandeira卡品牌
不区分大小写,平台转换为官方品牌码。NFC-e 里表外的品牌返回 10022004。
| 取值 | 含义 |
|---|---|
| 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 | 其他品牌 |
cliente.tipoPessoa买方类型
须与 cpfCnpj 位数一致。部分州 NFC-e 不接受以 CNPJ 识别的消费者,这些州请改开 NF-e。
| 取值 | 含义 |
|---|---|
| F | 个人,证件是 CPF |
| J | 企业,证件是 CNPJ |
cliente.endereco.uf消费者所在州
NFC-e 只能州内:消费者地址、transporte.enderecoEntrega.uf 都须与开票主体同州,不能用 EX。transporte.transportadora.uf 也用这张表。
| 取值 | 含义 |
|---|---|
| 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 |
cliente.endereco.cidadeIBGE 城市码
长码表,见 IBGE 城市码。须是开票主体所在州的城市。pedido.municipioOcorrencia、transporte.enderecoEntrega.cidade、itens[].impostos.issqn.municipioFatoGerador、itens[].impostos.issqn.municipioIncidencia 同此规则。
| 取值 | 含义 |
|---|---|
| NNNNNNN | 7 位数字 |
itens[].cfopNFC-e 可用的 CFOP
只有这 10 个,都是州内销项。部分州额外放行个别 CFOP 与 ICMS 税码组合,其余返回 10022004。MEI 主体只能用 5102。
| 取值 | 含义 |
|---|---|
| 5101 | 销售自产商品。配非代收税码:CST 00 / 20 / 40 / 41 / 90 或 CSOSN 102 / 103 / 300 / 400 / 900 |
| 5102 | 转售外购商品。税码同 5101 |
| 5103 | 店外销售自产商品。税码同 5101 |
| 5104 | 店外转售外购商品。税码同 5101 |
| 5115 | 销售寄售收到的商品。税码同 5101 |
| 5405 | 销售上游已代收 ST 的商品。配 CST 60 或 CSOSN 500 |
| 5656 | 向最终消费者销售燃料。须带 combustivel 块;配 CST 60 / 61 或 CSOSN 500 |
| 5667 | 店外向最终消费者销售燃料。须带 combustivel 块;配 CST 60 / 61 或 CSOSN 500 |
| 5910 | 赠品或奖励。代收与非代收税码都可配 |
| 5933 | 缴 ISSQN 的服务行。用 impostos.issqn 代替 icms,ncm 填 00;整票至少要有一行商品 |
itens[].ncm商品 NCM 编码
南共市统一商品编码长表,此处不逐一列出。
| 取值 | 含义 |
|---|---|
| NNNNNNNN | 商品行,8 位数字 |
| 00 | 服务行,CFOP 5933 |
itens[].impostos.issqn.exigibilidadeISS 可征性
| 取值 | 含义 |
|---|---|
| 1 | 应征 |
| 2 | 不征 |
| 3 | 免征 |
| 4 | 出口 |
| 5 | 豁免 |
| 6 | 司法裁定暂停,填写 processo |
| 7 | 行政程序暂停,填写 processo |
transporte.frete.modalidade运费方式
非配送销售只能是缺省的 SemFrete。
| 取值 | 含义 |
|---|---|
| SemFrete | 无运费 |
| PorContaDoEmitente | 发货方承担 |
| PorContaDoDestinatario | 收货方承担 |
| PorContaDeTerceiros | 第三方承担 |
| TransporteProprioPorContaDoRemetente | 发货方自有车辆 |
| TransporteProprioPorContaDoDestinatario | 收货方自有车辆 |
itens[].origem商品来源
| 取值 | 含义 |
|---|---|
| 0 | 国产 |
| 1 | 直接进口 |
| 2 | 国内购入的进口品 |
| 3 | 国产,进口成分超 40 % |
| 4 | 国产,按基本生产流程制造 |
| 5 | 国产,进口成分不超 40 % |
| 6 | 直接进口,无国产同类品 |
| 7 | 国内购入的进口品,无国产同类品 |
| 8 | 国产,进口成分超 70 % |
itens[].impostos.icms.situacaoTributariaNFC-e 的 ICMS 税码 CST,一般税制
NF-e 税码表的子集,其余 CST 返回 10022004。
| 取值 | 含义 |
|---|---|
| 00 | 全额征税。传 aliquota;配非代收 CFOP |
| 20 | 税基缩减。须传 aliquota 与 percentualReducaoBase;codigoBeneficioFiscal 按州要求传 |
| 40 | 免税。codigoBeneficioFiscal 按州要求传 |
| 41 | 不征税。codigoBeneficioFiscal 按州要求传 |
| 60 | 上游已代收 ST。可选 retencaoAnterior;配 CFOP 5405、5656、5667 或 5910 |
| 61 | 燃油按量,前环节已征。传 monofasico 并带 combustivel 块 |
| 90 | 其他。只在允许 NFC-e 用它的州可用,其他州返回 10022004 |
| 02 / 15 / 53 | 燃油自征、代征或递延。NFC-e 不接受 |
| 10 / 30 / 70 | 本票代收 ST。NFC-e 不接受 |
| 50 / 51 | 暂缓或递延。NFC-e 不接受 |
itens[].impostos.icms.situacaoTributariaNFC-e 的 ICMS 税码 CSOSN,Simples Nacional
NF-e 税码表的子集。MEI 主体只能用 102 或 300,并配 CFOP 5102。
| 取值 | 含义 |
|---|---|
| 102 | 征税不抵扣。ICMS 里不用再传别的 |
| 103 | 营收区间免征。ICMS 里不用再传别的 |
| 300 | 宪法豁免。ICMS 里不用再传别的 |
| 400 | 不征税。ICMS 里不用再传别的 |
| 500 | 上游已代收 ST。可选 retencaoAnterior;配 CFOP 5405、5656、5667 或 5910 |
| 900 | 其他。只在允许 NFC-e 用它的州可用,其他州返回 10022004 |
| 101 | 允许买方抵扣。NFC-e 不接受 |
| 201 / 202 / 203 | 本票代收 ST。NFC-e 不接受 |
itens[].impostos.pis.situacaoTributariaNFC-e 的 PIS 与 COFINS 税码
不接受 03,因为 NFC-e 没有按量计税字段;50 到 75 与 98 是进项码,NFC-e 永远是销项票。两个税种用同一张表。
| 取值 | 含义 |
|---|---|
| 01 | 基本税率征税 |
| 02 | 差别税率征税 |
| 04 | 单相制转售零税率 |
| 05 | 代收 |
| 06 | 零税率 |
| 07 | 免税 |
| 08 | 不征,出口用 |
| 09 | 暂缓 |
| 49 | 其他销项操作 |
| 99 | 其他操作 |
| 03 | 按数量征税。NFC-e 不接受 |
| 50–75 / 98 | 进项码。NFC-e 不接受 |
itens[].impostos.cofins.situacaoTributariaNFC-e 的 COFINS 税码
与 NFC-e 的 PIS 同一张表。
| 取值 | 含义 |
|---|---|
| 01 | 基本税率征税 |
| 02 | 差别税率征税 |
| 04 | 单相制转售零税率 |
| 05 | 代收 |
| 06 | 零税率 |
| 07 | 免税 |
| 08 | 不征,出口用 |
| 09 | 暂缓 |
| 49 | 其他销项操作 |
| 99 | 其他操作 |
| 03 | 按数量征税。NFC-e 不接受 |
| 50–75 / 98 | 进项码。NFC-e 不接受 |
itens[].impostos.ibsCbs.situacaoTributariaNFC-e 的 IBS/CBS 状态码
只对一般税制主体(CRT 3)生效,其他税制忽略该组。不传即 000。NF-e 的其余状态码需要 NFC-e 没有的参数组。
| 取值 | 含义 |
|---|---|
| 000 | 全额征税 |
| 200 | 减率,减率比例由分类码决定 |
| 410 | 免征或不征 |
| 620 | 燃油按量征税。只能用分类码 620006,并传 monofasico 与 combustivel 块 |
| 510 / 515 | 递延,NFC-e 没有 percentualDiferimento。NFC-e 不接受 |
| 550 | 暂停征收,NFC-e 没有 tributacaoRegular。NFC-e 不接受 |
| 800 / 810 / 811 | 抵扣转移、马瑙斯推定抵扣或期间调整。NFC-e 不接受 |
| 010 / 011 / 220 / 221 / 222 / 400 / 820 / 830 | 平台暂不支持的状态码。NFC-e 不接受 |
itens[].impostos.ibsCbs.classificacaoTributariaNFC-e 的 IBS/CBS 分类码
不传即 000001。前 3 位须与 situacaoTributaria 一致。不接受 200022 与 200024,它们需要 tributacaoRegular。
| 取值 | 含义 |
|---|---|
| 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 % |
| 200023 | 激励工业之间的中间品供给;减率 100 % |
| 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 | 其他无对价且不征税的交易 |
| 620006 | 燃油单相征税,前环节已征 |
itens[].impostos.issqn.itemListaServico服务清单项
《补充法 116/2003》附表长清单,此处不逐一列出。
| 取值 | 含义 |
|---|---|
| NN.NN | 项与子项,例如 14.01 |
itens[].medicamento.codigoAnvisa药品 ANVISA 注册号
| 取值 | 含义 |
|---|---|
| NNNNNNNNNNN | 11 位注册号 |
| NNNNNNNNNNNNN | 13 位注册号 |
| ISENTO | 豁免注册的药品,须传 motivoIsencao |
itens[].combustivel.codigoANPANP 燃料产品码
ANP 产品长码表,此处不逐一列出。由它决定 percentualBiocombustivel、origens 与液化气比例是否必填。
| 取值 | 含义 |
|---|---|
| NNNNNNNNN | 9 位数字 |
| 210203001 | 液化气,须传 percentualGLP、percentualGasNaturalNacional、percentualGasNaturalImportado,三者合计 100 |
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[].cestCEST 编码
长码表,此处不逐一列出。取现行 ICMS 142/2018 公约的代码。
| 取值 | 含义 |
|---|---|
| NNNNNNN | 7 位数字 |
itens[].impostos.icms.codigoBeneficioFiscal州税收优惠码
各州各自一张表,此处不逐一列出。取开票方所在州 SEFAZ 公布的 cBenef 表;表外的码 SEFAZ 以 946 驳回。
| 取值 | 含义 |
|---|---|
| XXNNNNNN | 8 位字符,例如 PR800001 |
| XXNNNNNNNN | 10 位字符 |
| SEM CBENEF | 无优惠,只用于未发布优惠表的州。SEFAZ-SP 不接受 |
| 错误码 | HTTP | |
|---|---|---|
| 10022024 | 400 | 未传 IBGE 市政码,且无法按邮编补齐:邮编不在基础数据中、对应多个市政或属于别的州。请传 IBGE 码,或核对 cep / uf。 |
| 10005215 | 400 | 引用了另一类型的税种:NF-e 只能引用 NFe 税种,NFC-e 只能引用 NFCe 税种;消息点名行与编码。 |
| 10005220 | 400 | 引用的税种与主体当前 CRT 或计税制度不符(IncompativelComRegime);请按新税制整份替换税种。 |
| 10001002 | 400 | 引用税种的商品行在 impostos 里直传了 icms 或 issqn 却没传 cfop,没有税种行可带出 CFOP;消息点名 itens[n].cfop。 |
| 10005209 | 400 | 引用的税种在本行需要的组(ICMS 或服务行的 ISSQN、PIS、COFINS)里没有适用于本票的行;消息点名组、场景、客户类型与买方是否非纳税人。 |
| 10005202 | 400 | 商品行引用的税种在本主体下不存在、已删除或属于别的主体;消息点名行与编码。 |
| 10005205 | 400 | 税种选中的行含 NFC-e 不接受的组或字段(如 ipi、ST、DIFAL、按量 PIS);消息点名字段。 |
| 10003000 | 404 | empresaId 不存在。 |
| 10022001 | 400 | 主体当前环境未开通 NFC-e。注册或更新时传 emissaoNFeConsumidor。 |
| 10022002 | 400 | 主体不可开票:未审批通过或证书不可用。 |
| 10022003 | 400 | ambienteEmissao 与主体当前环境不一致。 |
| 10022004 | 400 | 不符合 NFC-e 规则,mensagem 点名原因。按原因修正,或改开 NF-e。 |
| 10022009 | 400 | 本州要求二维码 v2,但主体没有可用的安全码。二维码 v2 由平台为主体切换,安全码只在生产环境生效,请联系平台。 |
| 10001001 | 400 | 字段校验失败,mensagem 点名字段。 |
| 10005000 | 400 | 税务引擎拒绝,mensagem 说明原因。 |
