NFC-e

查询 NFC-e

返回状态、二维码、小票与 XML 下载链接，以及开票入参回显。

GET/openapi/v2/empresas/{empresaId}/nfce/{nfceId}

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

按开票时传入的 id 查询。下载链接不需要签名，每次查询重新签发，见文件下载。小票在首次下载时生成；渲染服务繁忙时链接返回 503，稍后重试即可。

路径参数

`empresaId*`	string	开票主体标识
`nfceId*`	string	NFC-e 标识

* 必填字段

200

查询成功。

`id`	string	请求标识
`tipo`	string	单据类型
`status`	string	单据状态
`motivoStatus`	string	状态原因
`ambienteEmissao`	string	开票环境
`dataCriacao`	string	受理时间
`dataUltimaAlteracao`	string	最后更新时间
	object	订单
	object	消费者
`transporte`	object	运输信息
`numero`	string	票号
`serie`	string	系列号
`dataEmissao`	string	开票时间
`chaveAcesso`	string	访问密钥
`dataAutorizacao`	string	授权时间
	object	授权协议
`qrCode`	string	二维码内容
`urlConsulta`	string	按访问密钥查询的网址
`linkDanfe`	string	小票 PDF 下载地址
`linkDownloadXml`	string	XML 下载地址
`emitidaEmContingencia`	bool	离线应急开出标志
`alertas`	array	授权告警
	array	商品行
`valorTotal`	number	票面总额

`status`单据状态

取消受理中票仍为 Autorizada。

取值	含义
AguardandoAutorizacao	已受理，等待 SEFAZ 结果
Autorizada	SEFAZ 已授权
Negada	被 SEFAZ 驳回，或平台后台处理失败，原因在 `motivoStatus`
Cancelada	已取消
ContingenciaPendente	SEFAZ 不可用时离线开出，平台在 SEFAZ 恢复后自动补传

错误码	HTTP
10022006	404	该主体下 `nfceId` 不存在。
10003000	404	`empresaId` 不存在。

APP_SECRET='<APP_SECRET>'

API_PATH='/openapi/v2/empresas/{empresaId}/nfce/{nfceId}'

TIMESTAMP=$(date +%s)

SIGN=$(printf '%s%s%s' "$APP_SECRET" "$API_PATH" "$TIMESTAMP" | md5sum | cut -d' ' -f1)

curl -sS -X GET "https://api.v2.tffiscal.com${API_PATH}" \

-H "token: $APP_SECRET" -H "timestamp: $TIMESTAMP" -H "sign: $SIGN"

{

"id": "PDV01-000123",

"tipo": "NFC-e",

"status": "Autorizada",

"motivoStatus": null,

"ambienteEmissao": "Homologacao",

"dataCriacao": "2026-11-04T15:20:01Z",

"dataUltimaAlteracao": "2026-11-04T15:20:02Z",

"pedido": {

"presencaConsumidor": "OperacaoPresencial",

"pagamento": {

"formas": [

{ "tipo": "Dinheiro", "valor": 50.00 },

{ "tipo": "CartaoDeDebito", "valor": 10.30 }

"troco": 0.00

}

"cliente": null,

"transporte": null,

"numero": "123",

"serie": "1",

"dataEmissao": "2026-11-04T15:20:01Z",

"chaveAcesso": "35261111222333000181650010000001231123456780",

"dataAutorizacao": "2026-11-04T15:20:02Z",

"protocolo": { "numero": "135261234567890" },

"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": "https://api.v2.tffiscal.com/openapi/files/danfce/35261111222333000181650010000001231123456780?token=MXw3fDEwMXwxNzU4...",

"linkDownloadXml": "https://api.v2.tffiscal.com/openapi/files/xml/9901?token=MXw3fDEwMXwxNzU4...",

"emitidaEmContingencia": false,

"alertas": [],

"itens": [

{ "cfop": "5102", "codigo": "7891000100103", "descricao": "ARROZ TIPO 1 5KG", "quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 25.15, "valorTotal": 50.30 },

{ "cfop": "5405", "codigo": "7894900011517", "descricao": "REFRIGERANTE COLA 2L", "quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 10.00, "valorTotal": 10.00 }

"valorTotal": 60.30

}

查询 NFC-e

参数

路径参数

响应

枚举1 张表

status单据状态

错误2 条

`status`单据状态