接口文档
票据查验 - 查验并获取版式(总局门户)
增值税/数电票/财政票据/区块链发票查验
查验扩展
查验并获取版式(总局门户)
查验并获取版式(总局门户)
总局门户数电票查验+版式文件下载(查验结果与国家税务总局全国增值税查验平台一致,版式文件下载结果与电票平台版式文件一致)。与税控/数电/数电纸质查验共用同一URL zzsfpCy,企享云按bswjFplx是否存在+请求体字段自动识别为"查验+版式"模式。必传fphm+kprq+jshj+bswjFplx。响应可直接返回pdfUrl/ofdUrl/xmlUrl(同步模式)或bswjxzTaskId(异步模式,需08b查询)
登录查看报价
POST
https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/portal-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为空时无效) |
请求示例
JSON
{
"customReqId": "48",
"cyList": [
{
"fphm": "24xxxxxxxxxxxxxxxxx58",
"kprq": "2024-05-24",
"jshj": 55000,
"bswjFplx": "0910,0920,61,83",
"bswjLx": "PDF,OFD,XML"
}
]
}
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 2000=成功 |
| data | Array | 查验+版式结果 |
| data[].success | Boolean | 单张处理是否成功 |
| data[].code | String | 失败编码(如IllegalParameter=bswjLx类型不支持) |
| data[].bswjxzTaskId | String | 版式文件下载任务ID(异步时返回,同步时为null) |
| data[].fplx | String | 票种代码 |
| data[].pdfUrl | String | PDF下载URL(同步返回时直接返回) |
| data[].ofdUrl | String | OFD下载URL |
| data[].xmlUrl | String | XML下载URL(含税局数字签名) |
| data[].data | Object | 全票面数据(xfmc/gfmc/je/jshj/hwxx/qdfphm/qdlx) |
响应示例
JSON
{
"reqId": "a9855c9280e343eca1e67e1fecdbf213",
"code": "2000",
"success": true,
"data": [
{
"success": true,
"bswjxzTaskId": null,
"fplx": "0910",
"fphm": "24332000000122959604",
"jshj": 18200,
"kprq": "2024-04-30 00:00:00",
"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?...",
"data": {
"xfmc": "东XX公司",
"gfmc": "东XX公司",
"je": 17333.33,
"se": 866.67,
"jshj": 18200,
"qdfphm": "24xxxxxxxxxxxxxxxxx04",
"qdlx": "10"
}
}
]
}
查验版式下载结果(总局)
总局门户查验版式下载任务结果查询(与08b verify-ept-fmt-result共用同一URL /v2/invoice/cy/bsxzJgCx)。bsxzJgCx是统一的版式下载结果查询入口,无论是电票平台(dpptCy)还是总局门户(zzsfpCy)异步产生的bswjxzTaskId都走此查询。Body与失效规则详见08b
登录查看报价
POST
https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/portal-format/result
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | String | 否 | bswjxzTaskId(单个) |
| taskIdList | Array | 否 | bswjxzTaskId列表 |
| qdfphm | String | 否 | 全电发票号码(单个) |
| qdfphmList | Array | 否 | 全电发票号码列表。四选一,不可都为空 |
请求示例
JSON
{
"taskId": "531928300933248"
}
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 2000=成功;BusinessVerification=未查到/已过期/已取走;CheckBswjxzException=任务超时;CheckAuthorityVerification=未订购查验扩展版 |
| data[].qdfphm | String | 数电发票号码 |
| data[].zt | String | 任务状态:1=处理中,2=失败,3=完成 |
| data[].pdfUrl | String | PDF下载URL |
| data[].ofdUrl | String | OFD下载URL |
| data[].xmlUrl | String | XML下载URL |
| 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\/...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_...xml?..."
}
]
}
© 2026 星云税融API. All rights reserved.
如需接入支持，请联系技术团队 | 注册账号