TF Fiscal
开发文档

NF-e 验证

DANFE 获取

按 chave 取本账户验证过的 NF-e 的 DANFE,直接返回 PDF 文件。

GET/openapi/v3/consultas/danfe/{chave}
需要 token、timestamp、sign 三个签名头,参见认证与签名。

按 chave 取一张本账户验证过的 NF-e 的 DANFE(A4 版式),直接返回 PDF 文件。每次按取的那一刻这张票最新的验证结论现生成,平台不保存 PDF;取 PDF 本身不访问 SEFAZ,也不单独收费。

本端点有单独的授权范围,需平台单独开通:开通了 chave 查询 不等于能取 PDF,反过来也一样。

失败时返回 HTTP 状态与无包装的 {code, message} 对象(错误码见页底);即使请求头带 Accept: application/pdf,错误也以 JSON 返回。鉴权失败(401 / 403 / 429)为平台统一响应体,见 鉴权与授权错误。

路径参数

chave*
string访问密钥

* 必填字段

200
DANFE 的 PDF 文件(不是 JSON)。响应头:Content-Type: application/pdf;Content-Disposition: inline; filename="{chave}.pdf";Cache-Control: no-store;X-Tffiscal-Nfe-Status 为这份 PDF 对应的税务状态,Autorizada(正常版)或 Cancelada(作废水印版),不必解析 PDF 即可区分。

鉴权方式与 chave 查询 相同:带 token、timestamp、sign 三个请求头,GET 的 body 取空串,chave 属于签名 path(完整规则见 认证与签名)。给定 app_secret = sk_live_9f8e7d6c5b4a、chave 35260764962869000108550990001366171195929648、timestamp = 1784906308,签名字符串为:

text
sign_input = "sk_live_9f8e7d6c5b4a"
+ "/openapi/v3/consultas/danfe/35260764962869000108550990001366171195929648"
+ ""
+ "1784906308"
sign = md5Hex(sign_input)