企享云API(适配版本)
  1. 发票查验
企享云API(适配版本)
  • 基本介绍
  • 快速开始
    • 开发必读
    • 对接地址
    • SDK集成
    • 认证鉴权
    • 接口调用
    • 加密说明
  • 前置流程
    • 业务指引
    • 证书申请指引
    • 证书对接前置流程
    • 小号申请指引
  • 公共业务
    • 鉴权
      • 获取access_token
    • 订购
      • 自然人获取企业列表
      • 订购产品
      • 订购取消
      • 订购查询
      • 企业取消授权
    • 自然人
      • 自然人创建接口
      • 自然人修改接口
      • 自然人删除接口
    • 通知预警
      • 客户通知
    • 附录
      • 地区代码
  • 登录业务
    • 简介
    • 登录
      • 托管模式
        • 登录接口
        • 通用账户创建
        • 账号启用
        • 登录电票平台接口
        • 校验电局账号有效性
      • 自持登录
        • 自然人同步登录接口
        • 自然人异步登录发送验证码接口
        • 异步登录校验税局缓存是否有效
        • 异步登录税局【发送短信验证码】
        • 扫码登录税局(二维码获取)
        • 扫码登录税局(二维码登录)
        • 异步登录税局【上传短信验证码登录】
        • 自然人异步登录税局【上传短信验证码登录】
        • 上传cookie接口
      • 校验appkey是否账户自持
    • 多账号管理
      • 托管模式
        • 托管账号创建
        • 托管账号修改
        • 托管账号删除
        • 托管账号查询
        • 账号产品绑定
        • 账号产品解绑
      • 自持登录
        • 校验异步登录税务数字账户缓存是否有效
        • 异步登录税务数字账户【发送短信验证码】
        • 异步登录税务数字账户【上传短信验证码登录】
  • 发票业务
    • 发票查验
      • 简介
      • 发票查验
        POST
      • 税号版数电票查验及版式文件下载
        POST
      • 发票查验版式文件下载结果查询
        POST
    • 发票认证
      • 简介
      • 发票勾选/代购代缴完税凭证勾选
      • 进项发票勾选结果查询
      • 海关缴款书勾选
      • 海关缴款书勾选结果查询
      • 申请统计接口
      • 发票同步
      • 海关缴款书同步
      • 申请统计
      • 申请统计结果查询
      • 抵扣统计结果获取
      • 多票采集接口
      • 申请确认
      • 申请确认结果查询
    • 发票附录
      • 发票附录
      • 数电票号码规则
  1. 发票查验

发票查验版式文件下载结果查询

开发中
POST
/v2/invoice/cy/bsxzJgCx
发票查验版式文件下载

接口描述#

该接口用于数电发票查验版式文件下载结果查询。可用过查验时返回的bswjxzTaskId进行结果查询,也可通过单个或多个全电发票号码进行结果查询。
💡
注意:taskId在获取过一次结果成功后即失效。
使用qdfphm或qdfphmList查询结果成功一次对应的最近一条任务记录的taskId也失效。
taskId失效后无法再次通过本结果获取版式文件记录!如需获取,需要重新发起查验+版式文件下载任务。

错误码#

错误代码错误信息说明
BusinessVerification未查询到对应的发票查验版式文件下载记录
发票查验版式文件已过期,请重新下载!
发票查验版式文件已取走,请重新下载!
请重新发起下载任务!
CheckBswjxzException任务执行超时
获取版式文件失败,请重试
获取版式文件超时,请重试
请联系管理员

请求参数

Header 参数
access_token
string 
必需
通过调用access_token接口返回的access_token值
示例值:
{{access_token}}
req_date
string 
必需
当前时间转为的毫秒数
示例值:
{{req_date}}
req_sign
string 
签名算法得到的签名
必需
示例值:
{{req_sign}}
Content-Type
string 
可选
默认值:
application/json
Body 参数application/json
taskId
integer  | null 
查验结果返回的bswjxzTaskId
可选
qdfphm
string  | null 
全电发票号码(数电发票号码)
可选
qdfphmList
array[string] | null 
全电发票号码列表
可选
注:taskId、qdfphm、qdfphmList任选其中一种方式进行结果查询均可,但不可都为空。
示例
//通过taskId查询版式文件下载结果
{
    "taskId": 531928300933248
}
//通过全电发票号码查询版式文件下载结果
{
    "qdfphm": "24****************04"
}
//通过全电发票号码列表查询版式文件下载结果
{
    "qdfphmList": [
        "24****************04",
        "24****************05",
        "24****************06"
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/invoice/cy/bsxzJgCx' \
--header 'access_token: {{access_token}}' \
--header 'access_token;' \
--header 'req_date: {{req_date}}' \
--header 'req_date;' \
--header 'req_sign: {{req_sign}}' \
--header 'req_sign;' \
--header 'Content-Type: application/json' \
--data-raw '//通过taskId查询版式文件下载结果
{
    "taskId": 531928300933248
}
//通过全电发票号码查询版式文件下载结果
{
    "qdfphm": "24****************04"
}
//通过全电发票号码列表查询版式文件下载结果
{
    "qdfphmList": [
        "24****************04",
        "24****************05",
        "24****************06"
    ]
}'

返回响应

🟢200成功
application/json
Body
reqId
string 
请求id
必需
由服务器端生成的唯一标识,对应每次请求。排查接口异常时,可提供该字段方便定位
code
string  | null 
错误码
必需
错误码
success
boolean 
是否成功标记
必需
接口是否成功(是否发生业务异常)
message
string  | null 
错误信息
必需
data
array[object (Dzh-发票查验版式文件下载结果查询) {7}]  | null 
业务数据
可选
qdfphm
string 
数电发票号码
必需
pdfUrl
string 
pdf版式文件url
必需
ofdUrl
string 
ofd版式文件url
必需
xmlUrl
string 
xml版式文件url
必需
zt
enum<string> 
查验版式文件下载的任务执行状态
必需
1-申请处理中;2-申请处理失败;3-申请处理完成;
枚举值:
123
示例值:
1
code
string  | null 
错误码
可选
仅当任务状态为失败,即zt=2时不为空
message
string  | null 
错误信息
可选
仅当任务状态为失败,即zt=2时不为空
示例
{
    "reqId": "c80e874ae4134318a0e3638d9a55a7f1",
    "code": "2000",
    "success": true,
    "message": null,
    "data": [
        {
            "code": null,
            "message": null,
            "ofdUrl": "http://qxy-oss-robot-product.oss-cn-beijing.aliyuncs.com/0708872f7d0892a86ac409f5380e0d24.ofd?***************",
            "pdfUrl": "http://qxy-oss-robot-product.oss-cn-beijing.aliyuncs.com/b8a3b049dedeea9e43d332add31a7b52.pdf?***************",
            "qdfphm": "24********************04",
            "xmlUrl": "http://qxy-oss-robot-product.oss-cn-beijing.aliyuncs.com/dzfp_24332000000122959604_20240520171423.xml?***************",
            "zt": "3"
        }
    ]
}
修改于 2025-05-10 09:10:25
上一页
税号版数电票查验及版式文件下载
下一页
简介
Built with