Skip to content

发票查验截图 API接口

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

什么是发票查验截图 API?

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

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

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

常见需求包括:

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

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

支持的票据与截图类型

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

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

发票查验截图生成流程

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

使用方式

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

新增请求参数

参数名类型是否必填说明
withScreenshotboolean是否返回截图,默认不返回
withQdScreenshotboolean当是清单票时,是否截取清单内容,默认不返回
fullScreenboolean是否截取全部内容,默认情况下滚动条以外的部分不会被截取

响应字段新增

字段名类型说明
screenshotstring税局查验截图的 Base64 图片字符串
qd_screenshotstring当入参传入了withQdScreenshot时(需要获取清单内容截图时),返回税局查验清单截图的 Base64 图片字符串

图片格式说明

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

示例返回(含截图)

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