接口文档 - 星云税融API

接口文档

文档 / 票据查验 / 查验扩展 / 获取版式文件(电票平台) / 不查验获取版式

票据查验 - 不查验获取版式

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

查验扩展

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

不查验获取版式

同步方式

同步获取数电票版式文件

同步获取数电票版式文件(仅支持数电票0910/0920/61/83)。一次请求直接返回pdfUrl/ofdUrl/xmlUrl,无需轮询。三要素:fphm+kprq+jshj。数电纸质发票和非数电票不支持

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/format/sync

请求参数

参数名	类型	必填	说明
customReqId	String	是	请求ID
cyList	Array	是	查验列表
cyList[].fphm	String	是	数电发票号码
cyList[].kprq	String	是	开票日期,格式yyyy-MM-dd
cyList[].jshj	Number	是	价税合计
cyList[].bswjLx	String	否	版式文件类型:XML,OFD,PDF(多个逗号分隔,默认全部)

请求示例

JSON

{
    "customReqId": "",
    "cyList": [
        {
            "fphm": "23xxxxxxxxxxxxxxxxx27",
            "kprq": "2023-01-05",
            "jshj": "60000",
            "bswjLx": "XML,OFD,PDF"
        }
    ]
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Array	下载结果
data[].success	Boolean	版式文件下载是否成功
data[].qdfphm	String	数电发票号码
data[].kprq	String	开票日期(时分秒均为00)
data[].jshj	Number	价税合计
data[].fplx	String	发票类型(仅成功返回)
data[].pdfUrl	String	PDF版式文件URL
data[].ofdUrl	String	OFD版式文件URL
data[].xmlUrl	String	XML版式文件URL
data[].code	String	失败错误码(success=false时返回)
data[].chargingNsrsbh	String	计费纳税人识别号(仅开通税号版时返回)

响应示例

JSON

{
    "reqId": "05c3dbffdb7c4f378b919d8434050a84",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "qdfphm": "24xxxxxxxxxxxxxxxxx04",
            "kprq": "2024-04-30 00:00:00",
            "jshj": 18200,
            "ofdUrl": "http:\/\/qxy-oss-robot-product.oss-cn-beijing.aliyuncs.com\/...ofd?...",
            "pdfUrl": "http:\/\/qxy-oss-robot-product.oss-cn-beijing.aliyuncs.com\/...pdf?...",
            "xmlUrl": "http:\/\/qxy-oss-robot-product.oss-cn-beijing.aliyuncs.com\/dzfp_24xxx_20240520171423.xml?..."
        }
    ]
}

异步方式

异步获取数电票版式文件

异步获取数电票版式文件(仅支持数电票0910/0920/61/83)。请求体同bswjxz(同步版),但只返回bswjxzTaskId不直接返回URL。需再调08b(bsxzJgCx)结果查询接口获取pdfUrl/ofdUrl/xmlUrl。适合批量大量下载,对响应时间不敏感场景

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/format/async

请求参数

参数名	类型	必填	说明
customReqId	String	是	请求ID
cyList	Array	是	查验列表
cyList[].fphm	String	是	数电发票号码
cyList[].kprq	String	是	开票日期,格式yyyy-MM-dd
cyList[].jshj	Number	是	价税合计
cyList[].bswjLx	String	否	版式文件类型:XML,OFD,PDF(多个逗号分隔,默认全部)

请求示例

JSON

{
    "customReqId": "",
    "cyList": [
        {
            "fphm": "23xxxxxxxxxxxxxxxxx27",
            "kprq": "2023-01-05",
            "jshj": "60000",
            "bswjLx": "XML,OFD,PDF"
        }
    ]
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Array	任务创建结果
data[].success	Boolean	任务创建是否成功
data[].bswjxzTaskId	String	异步下载任务ID,用于后续调bsxzJgCx结果查询接口
data[].qdfphm	String	全电发票号码
data[].kprq	String	开票日期(时分秒均为00)
data[].jshj	Number	价税合计
data[].fplx	String	发票类型
data[].customReqId	String	请求ID
data[].chargingNsrsbh	String	计费纳税人识别号

响应示例

JSON

{
    "reqId": "caf8f68695524b93a948c822ec0b93a3",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "bswjxzTaskId": "550156172890752",
            "fplx": "09",
            "qdfphm": "23xxxxxxxxxxxxxxx05",
            "kprq": "2023-07-05 00:00:00",
            "jshj": 1,
            "customReqId": "100019990c1eae53d7a04463832830c94a33ca35"
        }
    ]
}

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