文件
文件下载
通过查询与回调返回的链接下载 XML、DANFE、DACCE 或 DACTE。
GET
/openapi/files/{kind}/{ref}无需签名头。
查询响应与回调载荷中的下载链接形如 https://api.v2.tffiscal.com/openapi/files/{kind}/{ref}?token=…。无需签名头：令牌随链接携带，直接 GET 即可。令牌与路径、集成商、应用绑定；改动路径或复用到其他文件都会失效。请原样使用返回的链接。
参数
路径参数
kindstring必填文件类型：
xml（授权 XML 或事件回执）、danfe、dacce或dacte（CT-e）。refstring必填文件 id 或 44 位访问密钥。
查询参数
tokenstring必填平台签发的链接令牌，不要手工构造或修改。
响应
302
重定向到 60 秒内有效的对象存储 URL。客户端必须跟随重定向（curl -L）。响应带 Cache-Control: no-store，请勿缓存链接。
无响应体
错误
| 错误码 | HTTP | |
|---|---|---|
| 10009035 | 401 | 下载链接无效（路径被改动、令牌被复用或签名不匹配）。 |
| 10009036 | 401 | 下载链接已过期。重新查询文档即可获得新链接。 |
| 10009037 | 503 | 文件尚未就绪（渲染服务繁忙）。按 |
| 10013011 | 404 | 文件不存在。 |
| 10013016 | 429 | 同一 IP 下载过于频繁。按 |
有效期与渲染
- 有效期：默认 7 天（平台可按集成商配置 1 到 365 天）；配置只影响之后签发的链接。每次查询都会签发新链接。
- DANFE 按需渲染：NF-e 授权后
linkDanfe即可使用；PDF 在首次下载时渲染。 - 失败以 HTTP 状态表达：401 链接无效或过期，403 应用或集成商被停用，404 文件不存在，429 限流（带
Retry-After），503 文件未就绪；响应体为平台信封（success=false）。 - 限流与计费：下载计入应用限流并有独立的
FILES分组；不计费。