接口文档 - 星云税融API

接口文档

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

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

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

查验扩展

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

查验并获取版式

数电票查验并获取版式

数电票查验+版式文件下载(与verify-ept-digital同URL,差异在必传bswjFplx触发版式下载任务)。响应返回bswjxzTaskId(30天有效,取结果后失效),通过版式下载结果查询接口获取PDF/OFD/XML文件。kprq格式:不登录用yyyy-MM-dd;登录(需购方税号托管+订购查验扩展版)可用yyyyMMdd

登录查看报价

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

请求参数

参数名	类型	必填	说明
customReqId	String	是	请求ID
cyList	Array	是	查验列表
cyList[].fphm	String	是	发票号码
cyList[].kprq	String	是	开票日期:不登录用yyyy-MM-dd,登录可用yyyyMMdd(需购方税号托管)
cyList[].jshj	Number	是	价税合计
cyList[].bswjFplx	String	是	需获取版式文件的发票类型范围(多个逗号分隔,枚举0910/0920/61/83/0930)。仅当次查验fplx在此范围内才下载版式
cyList[].bswjLx	String	否	版式文件类型:XML,OFD,PDF(多个逗号分隔,默认全部)。bswjFplx为空时本字段无效
cyList[].ytbq	Boolean	否	是否获取入账状态及用途标签(默认true)

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data	Array	查验结果
data[].success	Boolean	单张查验是否成功
data[].bswjxzTaskId	String	版式文件下载任务ID(30天有效)
data[].fplx	String	票种代码
data[].data	Object	全票面数据(含ytbqxx/mxzb/tspzxx/qdfphm/qdlx)

响应示例

JSON

{
    "reqId": "d8ca03b851eb4025833f15b93c035249",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "bswjxzTaskId": "564549648156117900",
            "fplx": "0920",
            "fphm": "21xxxxxxxxxxxxxxxxx61",
            "kprq": "2021-12-01 00:00:00",
            "jshj": 1129.99
        }
    ]
}

查验并获取版式(电票平台)

电票平台数电票查验并获取版式文件(与verify-with-format/verify-ept-digital同URL)。必传bswjFplx触发版式下载任务,响应返回bswjxzTaskId,通过"查验版式下载任务结果"接口获取PDF/OFD/XML文件

登录查看报价

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

请求参数

参数名	类型	必填	说明
customReqId	String	是	请求ID
cyList	Array	是	查验列表
cyList[].fphm	String	是	发票号码
cyList[].kprq	String	是	开票日期
cyList[].jshj	Number	是	价税合计
cyList[].bswjFplx	String	是	需获取版式文件的发票类型范围(枚举0910/0920/61/83/0930,多个逗号分隔)
cyList[].bswjLx	String	否	版式文件类型:XML,OFD,PDF(默认全部)

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data[].bswjxzTaskId	String	版式文件下载任务ID(30天有效,用于结果查询接口)
data[].data	Object	全票面数据

响应示例

JSON

{
    "reqId": "d8ca...",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "bswjxzTaskId": "564549648156117900",
            "fplx": "0920",
            "fphm": "21xxxxx61",
            "jshj": 1129.99
        }
    ]
}

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