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

POST

/v2/invoice/cy/bsxzJgCx

接口描述

该接口用于数电发票查验版式文件下载结果查询。可用过查验时返回的bswjxzTaskId进行结果查询，也可通过单个或多个全电发票号码进行结果查询。

💡

注意：taskId在获取过一次结果成功后即失效。
使用qdfphm或qdfphmList查询结果成功一次对应的最近一条任务记录的taskId也失效。
taskId失效后无法再次通过本结果获取版式文件记录！如需获取，需要重新发起查验+版式文件下载任务。

错误码

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

请求参数

Header 参数

Body 参数application/json

示例

//通过taskId查询版式文件下载结果
{
    "taskId": 531928300933248
}
//通过全电发票号码查询版式文件下载结果
{
    "qdfphm": "24****************04"
}
//通过全电发票号码列表查询版式文件下载结果
{
    "qdfphmList": [
        "24****************04",
        "24****************05",
        "24****************06"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/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": "df46cccec9cb4b3db93c6f266d71c25d",
    "code": "2000",
    "success": true,
    "message": null,
    "data": [
        {
            "qdfphm": "24********************04",
            "zt": "3",
            "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?***************",
            "xmlUrl": "http://qxy-oss-robot-product.oss-cn-beijing.aliyuncs.com/dzfp_24332000000122959604_20240520171423.xml?***************"
        }
    ]
}

🟢200失败

修改于 2024-09-07 08:29:45

查验版式文件下载任务执行结果回调接口说明

区块链发票查验（云南）

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

接口描述#

错误码#

请求参数

示例代码

返回响应

接口描述

错误码