发票查验截图 API接口

本接口基于发票查验 API扩展，提供发票查验结果截图返回功能，便于合规留存与审计追溯。图像清晰、适合财务风控、报销留存、审计记录等合规应用。

什么是发票查验截图 API？

发票查验截图 API 是在完成发票真伪查验后，返回官方查验结果截图图片 的接口服务。
企业系统可通过接口直接获取查验页面截图，用于合规留存、审计备查或报销凭证存档。

为什么需要发票查验截图？

在企业财务与审计流程中，仅保存查验结果数据往往不够，还需要可追溯的查验凭证。

常见需求包括：

• 报销资料需要留存查验截图
• 审计或风控需要可视化证据
• 合规要求保存查验结果原始展示

通过发票查验截图 API，可自动生成并留存标准化的查验结果图片。

支持的票据与截图类型

当前接口支持多种票据的查验结果截图，包括：

• 所有增值税发票查验结果截图
• 铁路电子客票查验截图
• 航空运输电子客票查验截图
• 所有财政票据的结果截图

发票查验截图获取流程

1. 调用发票查验 API 完成真伪核验
2. 自动截取查验结果截图
3. 返回发票信息和图片数据
4. 企业系统进行存档或展示

使用方式

• 请求地址：同 发票查验 API
• 请求方法：POST
• 仅需在原接口请求中添加参数以下参数

新增请求参数

参数名	类型	是否必填	说明
withScreenshot	boolean	否	是否返回截图，默认不返回
withQdScreenshot	boolean	否	当是清单票时，是否截取清单内容，默认不返回
fullScreen	boolean	否	是否截取全部内容，默认情况下滚动条以外的部分不会被截取
sDPR	number	否	截图清晰度，默认值为 1。设置为 2 时可获取更清晰的截图。（图片更清晰，但体积更大）

响应字段新增

字段名	类型	说明
screenshot	string	税局查验截图的 Base64 图片字符串
qd_screenshot	string	当入参传入了withQdScreenshot时（需要获取清单内容截图时），返回税局查验清单截图的 Base64 图片字符串

图片格式说明

返回字段是一个 base64 编码的 JPEG 图像，可以直接在 HTML 中以 img 标签渲染： <img src="data:image/jpeg;base64,..." />

示例返回（含截图）

{
  "success": true,
  "code": 0,
  "data": {
    ...,
    "screenshot": "iVBORw0KGgoAAAANSUhEUg...",
    "qd_screenshot": "iVBORw0KGgoAAAANSUhEUg..."
  },
  "requestId": "唯一请求ID"
}

合规留存场景

• 报销留存：员工报销时自动保存税局查验成功截图，与发票影像一并归档，杜绝"只报数据无凭证"
• 审计追溯：内审、外审与税务检查时提供可验证的查验原始展示，截图与查验结果数据一一对应
• 风控留证：对查验异常、红冲、查无此票等情况留存截图证据，便于后续争议处理
• 司法/监管备查：电子会计档案要求查验过程可追溯，截图是直观的过程凭证

常见问题

截图支持哪些票据？

支持增值税发票（含数电票）、铁路电子客票、航空运输电子客票行程单及财政票据，与发票查验 API 支持的票种一致；清单票可通过 withQdScreenshot 参数额外截取清单内容。