星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 票据查验 / 查验扩展 / 获取版式文件(电票平台) / 版式下载结果查询

票据查验 - 版式下载结果查询

增值税/数电票/财政票据/区块链发票查验

查验扩展

获取版式文件(电票平台)

版式下载结果查询

查验版式下载任务结果查询

数电发票查验版式文件下载结果查询。通过bswjxzTaskId或全电发票号码查询。⚠️taskId获取3次结果成功后失效;使用qdfphm/qdfphmList查询成功一次后对应最近一条任务记录的taskId也失效;失效后需重新发起查验+版式下载任务。返回pdfUrl/ofdUrl/xmlUrl下载地址

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/ept-format/result

请求参数

参数名 类型 必填 说明
taskId String 否 bswjxzTaskId(单个)
taskIdList Array 否 bswjxzTaskId列表
qdfphm String 否 全电发票号码(单个)
qdfphmList Array 否 全电发票号码列表。注:taskId/taskIdList/qdfphm/qdfphmList四选一,不可都为空

请求示例

JSON 
{
    "taskId": "531928300933248"
}

响应参数

参数名 类型 说明
code String 2000=成功;BusinessVerification=未查到/已过期/已取走;CheckBswjxzException=任务超时;CheckAuthorityVerification=未订购查验扩展版;CheckTaxLoginInfoError=登录信息有误;CheckTaxLoginFailed=登录失败
data Array 下载结果
data[].qdfphm String 数电发票号码
data[].zt String 任务状态:1=申请处理中,2=申请处理失败,3=申请处理完成
data[].kprq String 开票日期(仅zt=3精确到时分秒)
data[].jshj Number 价税合计(仅zt=3返回)
data[].fplx String 发票类型(仅zt=3返回)
data[].pdfUrl String PDF版式文件URL
data[].ofdUrl String OFD版式文件URL
data[].xmlUrl String XML版式文件URL
data[].code String 失败错误码(仅zt=2返回)
data[].chargingNsrsbh String 计费纳税人识别号(仅开通税号版发票查验版式文件下载产品时返回)

响应示例

JSON 
{
    "reqId": "df46cccec9cb4b3db93c6f266d71c25d",
    "code": "2000",
    "success": true,
    "data": [
        {
            "qdfphm": "24xxxxxxxxxxxxxxxxx04",
            "zt": "3",
            "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?..."
        }
    ]
}

版式下载结果回调(电票平台+总局门户 接收端)

⚠️非代理接口,是本系统实现的统一回调接收端点 /api/v1/callback/qxy/invoice-format。配置给企享云作为版式下载任务回调URL,同时服务于"电票平台下载"和"总局门户下载"两种场景(企享云使用统一回调格式)。企享云推送{taskId,status(0初始化/1执行中/2失败/3成功),errorMsg},我方响应{code:2000,msg:成功}。本系统按taskId路由分发给对应客户的Webhook

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/callback/qxy/invoice-format

请求参数

参数名 类型 必填 说明
taskId String 是 任务ID(对应bswjxzTaskId)
status Integer 是 0=初始化/1=执行中/2=失败/3=成功
errorMsg String 是 失败原因

请求示例

JSON 
{
    "taskId": "12345abcde",
    "status": 3,
    "errorMsg": "成功"
}

响应参数

参数名 类型 说明
code String 2000=成功,9999=失败
msg String 具体原因

响应示例

JSON 
{
    "code": "2000",
    "msg": "成功"
}

© 2026 星云税融API. All rights reserved.

如需接入支持，请联系技术团队 | 注册账号