NF-e
查询 NF-e
返回状态、票面与 DANFE / XML 下载链接。
/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}需要 token、timestamp、sign 三个签名头，参见认证与签名。
参数
路径参数
empresaIdstring必填注册主体返回的主体标识。
示例:1934811222334455nfeIdstring必填开票时传入的
id。示例:NFe-000014553
响应
查询成功。
idstring开票请求 id。
tipostring固定
NF-e。statusstringAguardandoAutorizacao处理中 /Autorizada已授权 /Negada已驳回 /Cancelada已作废。取值:AguardandoAutorizacaoAutorizadaNegadaCanceladamotivoStatusstring驳回原因：SEFAZ 返回码 + 描述，如
778 - Rejeicao: NCM inexistente；仅 Negada 有值。ambienteEmissaostringHomologacao/Producao。enviadaPorEmailboolean固定 false（平台不代发邮件）。
dataCriacaostring开票请求受理时间，ISO-8601 UTC。
dataUltimaAlteracaostring最后更新时间。
forcarEmissaoContingenciaboolean固定 false。
pedidoobject订单信息。
clienteobject收件人信息。
numerostring票号
nNF（字符串）。seriestring系列号。
dataEmissaostring开票时间。
chaveAcessostring44 位访问密钥。
transporteobject运输信息。
dataAutorizacaostringSEFAZ 授权时间；未授权无值。
linkDanfestringDANFE PDF 下载地址，仅 Autorizada；首次下载触发渲染。见文件下载。
linkDownloadXmlstring授权 XML 下载地址，仅有 XML 时。见文件下载。
linkConsultaPorChaveAcessostring固定空串。
protocoloobject授权协议。
emitidaEmContingenciaboolean是否应急模式开出。
finalidadestring开票目的回显：
Normal/Devolucao。notaReferenciadaobject退货票回显被退货原票的访问密钥。
itensarray商品行。
valorTotalnumber发票总额。
informacoesAdicionaisstring附加信息，当前不提供。
informacoesAdicionaisFiscostring税务机关附加信息，当前不提供。
错误
| 错误码 | HTTP | |
|---|---|---|
| NFe0001 | 404 |
|
| 10003000 | 404 |
|
状态口径
受理后至 SEFAZ 返回前为 AguardandoAutorizacao；授权后 Autorizada；被拒 Negada（motivoStatus 给出原因，修正后重新提交）；作废成功后 Cancelada。
文件下载链接（`linkDanfe` / `linkDownloadXml`）
链接形如 https://api.v2.tffiscal.com/openapi/files/{kind}/{ref}?token=…，不需要签名头：直接 GET 并跟随 302 跳转即可。每次查询都重新签发链接；过期回 401 + 10009036。有效期、DANFE 按需渲染与其余错误见文件下载。