下载发票原件 API 接口

本文档提供下载发票原件 API 的详细接入指南。通过本接口，开发者可以在进行发票查验的同时，同步获取官方颁发的带有数字签名的板式文件下载链接。支持 PDF、OFD、XML 三种格式。该方案非常适合直接集成至企业 ERP、财务报销系统或自动化财务流中，提供比传统桌面端 RPA 抓取更稳定、高效的电子会计档案归档体验。

适用场景与优势

• 全面兼容：支持最新版数电发票（全电发票）的 XML、PDF、OFD 格式下载。
• 降本增效：通过 API 直连获取，避免人工登录税局网站逐张下载的繁琐。
• 合规存档：获取的文件均包含官方数字签名，满足国家电子会计档案的合规入账要求。

接口调用说明

本发票原件下载API是发票查验接口的扩展能力，建立在核心的发票查验能力之上。

• 请求地址：与核心的 发票查验及真伪核验 API 保持一致。
• 请求方法：POST
• 调用逻辑：只需在任意增值税发票查验请求体中，将 files 参数设置为 true 即可。

新增请求参数

参数名	类型	是否必填	示例值	说明
files	Boolean	否	true	是否同时获取数电发票/增值税发票板式文件下载地址

响应字段新增说明

调用成功后，系统将在查验结果的 data 对象中附加以下文件下载链接：

字段名	类型	说明
ofdUrl	string	官方 OFD 版式文件下载地址
pdfUrl	string	官方 PDF 版式文件下载地址
xmlUrl	string	官方 XML 结构化数据文件下载地址
qrCodeUrl	string	官方 OFD、PDF、XML 版式文件预览地址

说明：所有下载地址均来自官方渠道，文件包含合法数字签名。

响应报文示例

{
  "success": true,
  "code": 0,
  "data": {
    ...,
    "pdfUrl": "https://...",
    "ofdUrl": "https://...",
    "xmlUrl": "https://...",
    "qrCodeUrl": "https://..."
  },
  "requestId": "唯一请求ID"
}

常见问题

调用发票原件下载功能需要单独申请吗？

不需要。本功能是发票查验 API 的内置扩展能力，所有已接入发票查验接口的用户，直接添加 files: true 参数即可使用，无需额外申请或对接。

下载的发票文件可以用于财务入账吗？

可以。所有版式文件均来自税务官方渠道，包含完整的数字签名与票面信息，符合国家电子发票入账归档相关规范，可直接用于财务入账、电子档案留存等合规场景。

支持哪些票种的原件下载？

目前已全面支持数电发票（全电发票）的版式文件下载，包含火车票、飞机票等等。