NFC-e

开具 NFC-e

为州内卖给最终消费者的零售开具消费者电子发票（模型 65）；缺省异步，也可同步等待结果当场打印。

POST/openapi/v2/empresas/{empresaId}/nfce

需要 token、timestamp、sign 三个签名头，参见认证与签名。

主体须已审批通过、证书可用，并已在注册开票主体时用 emissaoNFeConsumidor 段开通 NFC-e。请求体沿用 NF-e 开票的字段名，只加上 NFC-e 的限制与新增字段。ambienteEmissao 必须与主体当前环境一致。

路径参数

empresaId*

string

开票主体标识

* 必填字段

请求体

`id*`	string	请求标识
`ambienteEmissao*`	string	开票环境
`modoResposta`	string	响应模式
`consumidorFinal`	bool	最终消费者标志
`informacoesAdicionais`	string	补充信息
	array	纳税人观察项
	array	给税务机关的观察项
	array	授权下载 XML 的证件
`*`	object	订单与支付
`*` 配送销售、金额超过州识别门槛、或消费者要求在票上印 CPF 时必填	object	消费者
`*` 配送销售必填	object	运输信息
`*`	array	商品行

* 必填字段

200

异步模式：已受理，无响应体，结果经 Webhook 推送。同步模式拿到结果：响应体与查询接口相同，状态为 Autorizada、Negada 或 ContingenciaPendente（见下方示例）。

202

同步模式 10 秒内没有结果：相同响应体，状态 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 即异步。

json

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

json

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

json

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

json

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

json

{
  "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` 与 `transporte.enderecoRetirada` 须与开票主体同州
只能卖给最终消费者	`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，以及商品行的 pedido、notaReferenciada、valorFrete、valorSeguro、impostos.ipi、impostos.icms.substituicaoTributaria、impostos.icms.difal。

可用的 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 等于票面总额。

json

{
  "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。姓名和地址可不传，超过本州识别门槛时除外。

json

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

json

{
  "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 和商家在平台上的店铺编号。

json

{
  "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；在开票主体所在城市销售时不传。销售城市必须和开票主体同州。

json

{
  "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" } }
    }
  ]
}

`modoResposta`响应模式

不传即 Assincrono。

取值	含义
Assincrono	受理即返回 HTTP 200 无内容，结果经 Webhook 推送
Sincrono	最多等待 SEFAZ 结果 10 秒，超时返回 HTTP 202

`pedido.presencaConsumidor`消费者在场方式

取值	含义
OperacaoPresencial	门店现场销售，不能带承运方
EntregaEmDomicilio	非现场销售并配送，必须传 `cliente` 的证件号与地址，以及 `transporte.transportadora`；送货、取货地址须与开票主体同州
OperacaoPresencialForaDoEstabelecimento	店外现场销售，如展会、流动摊点，不能带承运方

`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；有这一笔时合计可低于票面总额，不能找零
Outros	其他，须填 `descricao`

`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	其他品牌

`itens[].impostos.issqn.exigibilidade`ISS 可征性

取值	含义
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.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	其他操作

错误码	HTTP
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` 说明原因。

开具 NFC-e

参数

路径参数

请求体

响应

响应模式与幂等

两种模式完整案例8 块

异步 1/3：请求

异步 2/3：返回 HTTP 200 无内容

异步 3/3：Webhook 推送结果

异步：驳回时的 Webhook

同步 1/3：请求

同步 2/3：HTTP 200 已授权

同步 3/3：HTTP 202 等待中

同步：HTTP 200 离线开出

NFC-e 规则

三种在场方式示例5 块

门店现场销售：消费者不识别

门店现场销售：消费者报 CPF

配送销售：商家自配送

配送销售：外卖平台订单

店外现场销售：外地展会摊位

枚举9 张表

modoResposta响应模式

pedido.presencaConsumidor消费者在场方式

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

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

itens[].impostos.issqn.exigibilidadeISS 可征性

transporte.frete.modalidade运费方式

itens[].origem商品来源

itens[].impostos.pis.situacaoTributariaPIS 税码

itens[].impostos.cofins.situacaoTributariaCOFINS 税码

错误8 条

`modoResposta`响应模式

`pedido.presencaConsumidor`消费者在场方式

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

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

`itens[].impostos.issqn.exigibilidade`ISS 可征性

`transporte.frete.modalidade`运费方式

`itens[].origem`商品来源

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

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