发票真伪查询网
搜索 K

Appearance

下载发票原件 API 接口 ​

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

适用场景与优势 ​

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

接口调用说明 ​

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

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

新增请求参数 ​

参数名类型是否必填示例值说明
dpptcyBoolean否true是否使用电票平台查验，启用时会获取数电发票/增值税发票板式文件下载地址，如果同时获取截图，则截图为电票平台查验截图

响应字段新增说明 ​

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

字段名类型说明
ofdUrlstring官方 OFD 版式文件下载地址
pdfUrlstring官方 PDF 版式文件下载地址
xmlUrlstring官方 XML 结构化数据文件下载地址
qrCodeUrlstring官方 OFD、PDF、XML 版式文件预览地址
kprstring开票人

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

特殊票种的新增返回字段

差额征税 ​

json
{
  "kce": "扣除额"
}

建筑服务 ​

json
{
    "JzfwfpmxList": [
        {
            "Je": "金额",
            "Jzfwfsd": "建筑服务发生地",
            "Jzxmmc": "建筑项目名称",
            "Se": "税额",
            "Sl1": "税率",
            "Xh": "序号",
            "Xmmc": "项目名称"
        }
    ]
}

货物运输服务 ​

json
{
    "HwysfwdzfpmxbList": [
        {
            "Ddd": "到达地",
            "Qyd": "起运地",
            "Xh": "序号",
            "Ysgjph": "运输工具牌号",
            "Ysgjzl": "交通工具种类",
            "Yshwmc": "运输货物名称"
        }
    ]
}

不动产销售 ​

json
{
    "BdcTdysfpList": [
        {
            "Bdcdz": "不动产地址",
            "Bdczldz": "不动产坐落地址",
            "Kdsbz": "N", // 跨地市标志 N否 Y是
            "Kprq": "开票日期",
            "Tdzzsxmbh": "土地增值税项目编号",
            "Wqhtbabh": "网签合同备案编号",
            "Xh": "序号"
        }
    ]
}

不动产经营租赁服务 ​

json
{
    "BdcTdysfpList": [
        {
            "Bdcdz": "不动产地址",
            "Bdczldz": "不动产坐落地址",
            "Cqzsbh": "产权证书编号",
            "Cqzsh": "产权证书号",
            "Kdsbz": "N", // 跨地市标志 N否 Y是
            "Kprq": "开票日期",
            "Xh": "序号",
            "Zlqq": "租赁期起",
            "Zlqqz": "租赁期起止",
            "Zlqz": "租赁期止"
        }
    ]
}

旅客运输服务 ​

json
{
    "LkysfwTdysList": [
        {
            "Cfd": "出发地",
            "Chuxrq": "出行日期",
            "Cxr": "出行人",
            "CxrzjlxDm": "身份证代码201",
            "Ddd": "到达地",
            "Dengj": "等级",
            "Jtgjlx": "交通工具类型", // 1飞机 2火车 3长途汽车 4公共交通 5出租车 6汽车 7船舶 9其他
            "Sfzjhm": "有效身份证件号",
            "Xh": "序号"
        }
    ]
}

医疗服务（住院） ​

json
{
    "DzfpKpywTdysYlfwzyfpVO": {
        "Bjje": "补缴金额",
        "Blh": "病历号",
        "Fphm": "26******0472731991",
        "Grxjzf": "个人现金支付",
        "Grxjzfje": "个人现金支付金额",
        "Grzf": "个人自付",
        "Grzfje": "个人自付金额",
        "Grzfje1": "个人自费金额",
        "Grzhzf": "个人账户支付",
        "Grzhzfje": "个人账户支付金额",
        "hzsfzjhm": "患者证件号码",
        "hzsfzjlxDm": "患者证件类型 201身份证",
        "hzxm": "患者姓名",
        "Jkr": "交款人",
        "Kprq": "2026-05-22 10:25:53",
        "Qtzf": "其它自费",
        "Qtzfje": "其它自费金额",
        "skdw": "收款单位",
        "Tfje": "退费金额",
        "Xb": "性别",
        "xbDm": "性别编码",
        "Ybbh": "医保编号",
        "Yblx": "医保类型",
        "Ybtcjjzf": "医保统筹基金支付",
        "Ybtcjjzfje": "医保统筹基金支付金额",
        "Yjje": "预缴金额",
        "Ylbjje": "医疗补缴金额",
        "YlfwzysfmxVO": {
            "Hjje": "合计金额",
            "Hjse": "合计税额",
            "Zys": 1,
            "ZysfmxVOList": [
                {
                    "Dqym": 1,
                    "DysfmxVOList": [
                        {
                            "Bz": "备注",
                            "Dw": "单位",
                            "Fpspsl": "数量",
                            "Fymx": "费用明细",
                            "Je": "金额",
                            "Se": "税额",
                            "Sl": "数量",
                            "sl1": "税率"
                        }
                    ],
                    "Xjje": "小计金额",
                    "Xjse": "小计税额"
                }
            ]
        },
        "Yljglx": "医疗机构类型",
        "Yltfje": "医疗退费金额",
        "Ylyjje": "医疗预缴金额",
        "Ylywlsh": "医疗业务流水号",
        "Ywlsh": "业务流水号",
        "Zyh": "住院号",
        "Zykb": "住院科别",
        "Zysj": "住院时间",
        "zysjq": "住院时间起",
        "zysjz": "住院时间止"
    }
}

医疗服务（门诊） ​

json
{
    "DzfpKpywTdysYlfwmzfpVO": {
        "Grxjzf": "个人现金支付",
        "Grxjzfje": "个人现金支付金额",
        "Grzf": "个人自付",
        "Grzfje": "个人自费",
        "Grzhzf": "个人账户支付",
        "Grzhzfje": "个人账户支付金额",
        "hzsfzjhm": "证件号码",
        "hzsfzjlxDm": "身份证 201",
        "hzxm": "患者姓名",
        "Jzrq1": "就诊时间",
        "Mzh": "门诊号",
        "Mzjzsj": "门诊就诊时间",
        "Qtzf": "其他支付",
        "Qtzfje": "其他支付金额",
        "Xb": "性别",
        "Yblx": "医保类型",
        "Ybtcjjzf": "医保统筹基金支付",
        "Ybtcjjzfje": "医保统筹基金支付金额",
        "Yljglx": "医疗机构类型",
        "Ylywlsh": "医疗业务流水号",
        "Ywlsh": "业务流水号"
    }
}

拖拉机和联合收割机 ​

json
{
    "TljhLhsgj": {
        "Dphgzbh": "底盘号",
        "Fdjhm": "发动机号码"
    }
}

响应报文示例 ​

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

常见问题 ​

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

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

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

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

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

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