星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 票据查验

票据查验

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

发票查验
13 个接口
查验扩展
10 个接口

发票查验

增值税平台查验

税控发票查验

增值税发票四要素查验(与国家税务总局全国增值税查验平台一致)。cyList单次最多50张。je(不含税金额)仅专票/电子专票/机动车/数电纸质(专/机动车/二手车)必填；jym(校验码后6位)仅普票/电子普票/卷票/电子普票(通行费)/数电纸质(普)必填

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

请求参数

参数名 类型 必填 说明
cyList Array 是 查验发票列表，单次最多50张
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].kprq String 是 开票日期，yyyy-MM-dd 或 yyyyMMdd
cyList[].je Number 否 不含税金额(专票/电子专票/机动车/二手车等必填)
cyList[].jym String 否 校验码后6位(普票/电子普票/卷票/电子普票(通行费)必填)
customReqId String 否 请求ID(建议由代理层自动生成)

请求示例

JSON 
{
    "cyList": [
        {
            "fpdm": "4403212130",
            "fphm": "24361495",
            "kprq": "2021-09-28",
            "je": 21640.26
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
reqId String 服务端请求ID
data Array 每张票一个对象
data[].success Boolean 单张查验是否成功
data[].fplx String 发票类型代码,详见附录
data[].data Object 全票面结构化数据(查验成功返回,含xfmc/gfmc/je/se/jshj/hwxx等)

响应示例

JSON 
{
    "reqId": "1f7d8d89b55641fe8f4075f2f01119d3",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "01",
            "fpdm": "4403212130",
            "fphm": "24361495",
            "kprq": "2021-09-28 00:00:00",
            "je": 21640.26,
            "times": 11,
            "time": 1678785967000,
            "data": {
                "xfmc": "金蝶蝶金云计算有限公司",
                "xfsbh": "914403003119439031",
                "gfmc": "辽宁金蚕软件服务有限公司",
                "gfsbh": "91211103MA107PP20C",
                "je": 21640.26,
                "se": 1298.43,
                "jshj": 22938.69,
                "fpztDm": "0",
                "hwxx": [
                    {
                        "mc": "*信息技术服务*软件服务费",
                        "je": 2539.62,
                        "se": 152.38,
                        "slv": 0.06,
                        "spbm": "3040201990000000000"
                    }
                ]
            }
        }
    ]
}

数电票查验

数电发票查验(电子发票:普票/专票/机动车/二手车/铁路/航空/通行费)。与税控发票查验同一URL,企享云按请求体字段自动识别。cyList单次最多50张。数电票无fpdm,必填fphm+kprq+jshj(价税合计)

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/digital

请求参数

参数名 类型 必填 说明
cyList Array 是 查验发票列表，单次最多50张
cyList[].fphm String 是 发票号码(数电票无fpdm)
cyList[].kprq String 是 开票日期，yyyy-MM-dd 或 yyyyMMdd
cyList[].jshj Number 是 价税合计(数电票统一用jshj,不需je/jym)
customReqId String 否 请求ID(建议代理层自动生成)

请求示例

JSON 
{
    "cyList": [
        {
            "fphm": "21317000000000001061",
            "kprq": "2021-12-01",
            "jshj": 1129.99
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
reqId String 服务端请求ID
data Array 每张票一个对象
data[].success Boolean 单张查验是否成功
data[].fplx String 发票类型代码:0910/0920/0930/0940/61/83/8208
data[].data Object 全票面结构化数据(按票种字段不同,含xfmc/gfmc/jshj/hwxx;铁路票含cc/cfz/ddz;航空票含lkxm/hbh;机动车含cjhm/fdjhm等)

响应示例

JSON 
{
    "reqId": "9b3f23c436774227a66f12c40d94344c",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "0920",
            "fphm": "21317000000000001061",
            "kprq": "2021-12-01 00:00:00",
            "jshj": 1129.99,
            "times": 335,
            "data": {
                "xfmc": "上海百联商贸有限公司",
                "xfsbh": "91310107660704281C",
                "gfmc": "安付宝商务有限公司",
                "gfsbh": "91310107566588632G",
                "je": 999.99,
                "se": 130,
                "jshj": 1129.99,
                "fpztDm": "0",
                "qdfphm": "21317000000000001061",
                "qdlx": "20",
                "hwxx": [
                    {
                        "mc": "*纸制品*积点卡",
                        "je": 999.99,
                        "se": 130,
                        "slv": 0.13,
                        "spbm": "1060105990000000000"
                    }
                ]
            }
        }
    ]
}

数电纸质发票查验

数电纸质发票查验(fplx:0901专票/0904普票/0903机动车/0915二手车)。与税控发票查验/数电票查验共用同一URL,企享云按请求体字段+fplx自动识别。cyList单次最多50张。必填fpdm+fphm+kprq；je(专票/机动车/二手车必填),jym(普票必填)

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

请求参数

参数名 类型 必填 说明
cyList Array 是 查验发票列表，单次最多50张
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].kprq String 是 开票日期，yyyy-MM-dd 或 yyyyMMdd
cyList[].je Number 否 不含税金额(数电纸质专票/机动车/二手车必填)
cyList[].jym String 否 校验码后6位(数电纸质普票必填)
customReqId String 否 请求ID(建议代理层自动生成)

请求示例

JSON 
{
    "cyList": [
        {
            "fpdm": "31000230",
            "fphm": "2000095",
            "kprq": "2022-09-23",
            "je": 94339.62
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
reqId String 服务端请求ID
data Array 每张票一个对象
data[].success Boolean 单张查验是否成功
data[].fplx String 0901=数电纸质专票,0904=数电纸质普票,0903=机动车,0915=二手车
data[].data Object 全票面结构化数据(含qdfphm数电号/qdlx全电类型/xfmc/gfmc/je/jshj/hwxx等,机动车二手车含hzfpxx红冲信息)

响应示例

JSON 
{
    "reqId": "5384870061504dab93ad977be2a40348",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "0901",
            "fpdm": "31000230",
            "fphm": "2000095",
            "kprq": "2022-09-23 00:00:00",
            "je": 94339.62,
            "times": 36,
            "data": {
                "xfmc": "悠派XX有限公司",
                "gfmc": "维美XX有限公司",
                "je": 94339.62,
                "se": 5660.38,
                "jshj": 100000,
                "fpztDm": "0",
                "qdfphm": "2XXXXXXXXXXX1",
                "qdlx": "01",
                "hwxx": [
                    {
                        "mc": "*人力资源服务*服务费",
                        "je": 94339.62,
                        "se": 5660.38,
                        "slv": 0.06,
                        "spbm": "3040803990000000000"
                    }
                ]
            }
        }
    ]
}

电票平台查验

电票平台数电票查验

电票平台数电票/数电纸质发票查验(企享云电票平台)。三要素查验:fphm+kprq+jshj。相比zzsfpCy增值税平台查验,额外返回入账状态(ytbqxx)/明细子表(mxzb)/特殊票种信息(tspzxx)。支持ytbq参数控制是否获取入账状态。数电纸质也使用三要素查验(20位数电票号+价税合计+开票日期)

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

请求参数

参数名 类型 必填 说明
customReqId String 是 请求ID
cyList Array 是 查验列表,单次最多50张
cyList[].fphm String 是 发票号码(20位数电票号)
cyList[].kprq String 是 开票日期,yyyy-MM-dd 或 yyyyMMdd
cyList[].jshj Number 是 价税合计(数电纸质也用三要素)
cyList[].ytbq Boolean 否 是否获取入账状态及用途标签(默认true)

请求示例

JSON 
{
    "customReqId": "",
    "cyList": [
        {
            "fphm": "23xxxxxxxxxxxxxxxxx27",
            "kprq": "2023-01-05",
            "jshj": "60000"
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
reqId String 服务端请求ID
data Array 每张票一个对象
data[].success Boolean 单张查验是否成功
data[].code String 查验失败编码(如CheckInvoiceNotSupport)
data[].fplx String 发票类型:0910/0920/0930/0940/61/83/8208/0901/0904/0903/0915
data[].data Object 全票面数据,含ytbqxx(入账/用途标签)/mxzb(明细子表)/tspzxx(特殊票种:医疗/不动产/旅客运输等)/qdfphm/qdlx

响应示例

JSON 
{
    "reqId": "3f946cde871d4458b308119d070733cf",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "0920",
            "fphm": "23xxxxxxxxxxxxxxxxx27",
            "kprq": "2023-01-05 00:00:00",
            "jshj": 60000,
            "data": {
                "xfmc": "厦门XX有限公司",
                "gfmc": "瑞幸XX有限公司",
                "je": 57142.86,
                "se": 2857.14,
                "jshj": 60000,
                "qdfphm": "23xxxxxxxxxxxxxxxxx27",
                "qdlx": "20",
                "tdyslxDm": "06",
                "ytbqxx": {
                    "qdfphm": "23xxxxxxxxxxxxxxxxx27",
                    "fplymc": "电子发票服务平台",
                    "fprzzt": "未入账",
                    "zzsytbq": "未使用"
                },
                "tspzxx": [
                    {
                        "bdcdz": "福建XX号",
                        "zlqq": "2022-11-01",
                        "zlqz": "2023-01-31",
                        "tdyslxDm": "06"
                    }
                ],
                "hwxx": [
                    {
                        "mc": "*经营租赁*租金",
                        "je": 57142.86,
                        "se": 2857.14,
                        "slv": 0.05
                    }
                ]
            }
        }
    ]
}

其它票据查验

财政票据查验

财政票据查验

财政票据查验(与财政票据官网一致)。⚠️仅支持单张/仅查最近1年/暂不支持非税收入一般缴款书。支持票种:非税收入通用票据/公益捐赠/医疗收费/社会团体会费/行政事业资金往来/教育垫付资金/收费公路通行费等。响应已含明细(xmqd/xmmx)

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/fiscal

请求参数

参数名 类型 必填 说明
customReqId String 是 请求ID(AppKey+去横杠UUID)
cyList Array 是 查验列表,仅支持单张(length=1)
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].kprq String 是 开票日期(最近1年内),yyyy-MM-dd 或 yyyyMMdd
cyList[].je Number 是 金额
cyList[].jym String 是 校验码

请求示例

JSON 
{
    "customReqId": "100019953790cccf01c45ce1b744e14ec46384eb",
    "cyList": [
        {
            "fpdm": "11xxxxx22",
            "fphm": "00xxxxxx82",
            "kprq": "2022-12-28",
            "je": "18807",
            "jym": "7665fe"
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
reqId String 服务端请求ID
data Array 查验结果
data[].success Boolean 单张查验是否成功
data[].fplx String 财政票据类型代码(如101=中央非税收入)
data[].data Object 票面数据:pjmc(票据名称)/jehj(金额合计)/jkr(缴款人)/skdw(收款单位)/skr/fhr/xmqd[](项目清单)/xmmx[](明细)/qtxx[](其他信息)/detailUrl

响应示例

JSON 
{
    "reqId": "d97c94a65de94876a8e70b4e765fbe50",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "101",
            "fpdm": "00xxxxxx23",
            "fphm": "00xxxxxxx03",
            "kprq": "2023-04-12 00:00:00",
            "je": 900,
            "jym": "86a793",
            "data": {
                "pjmc": "中央非税收入统一票据（电子）",
                "jehj": "900.00",
                "jehjcn": "玖佰圆整",
                "jkr": "广XX公司",
                "skdw": "国家知识产权局专利局",
                "skr": "周X宁",
                "xmqd": [
                    {
                        "xmbh": "056990126050",
                        "xmmc": "外观设计专利第5年年费",
                        "je": "900.00"
                    }
                ]
            }
        }
    ]
}

财政票据查验(明细版)

财政票据查验-明细版(与基础版同URL,需联系运营开通权限)。仅支持1张/仅查最近1年(开权限后可查超1年,但必传jkr+sfz)。提供医疗票据版式文件(pdf或zip)下载,覆盖26个地区(浙江/河北/宁波返回zip,其他pdf)。明细版返回额外字段:czpjMxcx(调地方税局成功与否)/mxcxMessage/ylpjFile(医疗版式文件)/data.xmmx(医疗收费明细)

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

请求参数

参数名 类型 必填 说明
customReqId String 是 请求ID
cyList Array 是 查验列表,仅支持单张
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].kprq String 是 开票日期(默认最近1年内,开权限后支持超1年)
cyList[].je Number 是 金额
cyList[].jym String 是 校验码
cyList[].czpjMxcx Boolean 否 是否获取医疗票据明细(默认true,需开通权限)
cyList[].jkr String 否 交款人(北京/山西/辽宁/大连/吉林/宁波/安徽/福建/山东/广东/海南/四川/贵州/西藏/陕西/新疆获取医疗明细时必传;超1年票据查验必传)
cyList[].sfz String 否 身份证后6位或税号后6位(山西/辽宁/湖北/海南/重庆/四川/陕西/新疆/内蒙古必传;超1年票据查验必传)

请求示例

JSON 
{
    "customReqId": "100019953790cccf01c45ce1b744e14ec46384eb",
    "cyList": [
        {
            "fpdm": "11xxxxx22",
            "fphm": "00xxxxxx82",
            "kprq": "2022-12-28",
            "je": "18807",
            "jym": "7665fe",
            "czpjMxcx": true,
            "jkr": "张三",
            "sfz": "123456"
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
data Array 查验结果
data[].success Boolean 单张查验成功与否
data[].czpjMxcx Boolean 调用地方税局是否成功
data[].mxcxMessage String 调用地方税局错误信息
data[].ylpjFile Object 医疗票据版式文件(pdf或zip二进制/链接)
data[].fplx String 票据类型代码(101-103财政,01-15增值税,09XX数电)
data[].data Object 票面数据:pjmc/jehj/jkr/skdw/skr/xmqd[]/xmmx[]医疗明细/qtxx[]/detailUrl

响应示例

JSON 
{
    "reqId": "d97c94a65de94876a8e70b4e765fbe50",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "czpjMxcx": true,
            "mxcxMessage": null,
            "fplx": "101",
            "fpdm": "00xxxxxx23",
            "fphm": "00xxxxxxx03",
            "kprq": "2023-04-12 00:00:00",
            "je": 900,
            "data": {
                "pjmc": "中央非税收入统一票据（电子）",
                "jehj": "900.00",
                "jkr": "广XX公司",
                "skdw": "国家知识产权局专利局",
                "xmqd": [
                    {
                        "xmmc": "外观设计专利第5年年费",
                        "je": "900.00"
                    }
                ],
                "xmmx": []
            }
        }
    ]
}
通用电子发票查验

通用电子发票查验(浙江/宁波)

通用电子发票查验(浙江dq=3300/宁波dq=3302)。比普通查验多必填xfsbh(销方识别号)。局端仅验真,无全票面数据,无hwxx/je/se。fplx=102通用电子发票

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

请求参数

参数名 类型 必填 说明
cyList Array 是 查验发票列表
cyList[].dq String 是 地区代码:3300=浙江,3302=宁波(默认3300)
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].xfsbh String 是 销方识别号(本接口特有)
cyList[].kprq String 是 开票日期,yyyy-MM-dd 或 yyyyMMdd
cyList[].jshj Number 是 价税合计
customReqId String 否 请求ID

请求示例

JSON 
{
    "cyList": [
        {
            "dq": "3300",
            "fpdm": "23xxxxxxxxxx11",
            "fphm": "51xxxx24",
            "xfsbh": "92xxxxxxxxxxx0A",
            "kprq": "20210801",
            "jshj": 630
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
data Array 查验结果
data[].success Boolean 单张查验是否成功
data[].fplx String 102=通用电子发票
data[].data Object 票面基础:fpdm/fphm/kprq/jshj/fpzt(0正常)/kjlx/fplbmc(电子发票)/xfmc/xfsbh/gfmc/gfsbh/dq

响应示例

JSON 
{
    "reqId": "907a1642d5de40c19fd1d48a7375043d",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "102",
            "fpdm": "23xxxxxxxxxx11",
            "fphm": "51xxxx24",
            "kprq": "2021-08-01 00:00:00",
            "jshj": 630,
            "dq": "3300",
            "data": {
                "dq": "浙江",
                "fpdm": "23xxxxxxxxxx11",
                "fphm": "51xxxx24",
                "fplbmc": "电子发票",
                "fpzt": "0",
                "kjlx": "1",
                "kprq": "2021-08-01",
                "jshj": "630",
                "xfmc": "杭XX店",
                "xfsbh": "92xxxxxxxxxxx0A",
                "gfmc": "物XX公司",
                "gfsbh": "91xxxxxxxxxxx7A"
            }
        }
    ]
}

通用电子发票查验(广东)

通用电子发票查验(广东)

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

该接口文档正在完善中，请联系客服获取详细参数说明。

区块链发票查验

区块链发票查验(深圳)

区块链发票查验(深圳)。dq固定4403。仅需5项:dq/fpdm/fphm/xfsbh/jym(无需kprq/jshj)。fplx=100区块链发票。局端仅验真,返回票面基础信息

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

请求参数

参数名 类型 必填 说明
cyList Array 是 查验列表
cyList[].dq String 是 地区,固定4403(深圳)
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].xfsbh String 是 销方识别号
cyList[].jym String 是 校验码
customReqId String 否 请求ID

请求示例

JSON 
{
    "cyList": [
        {
            "dq": "4403",
            "fpdm": "14xxxxxx10",
            "fphm": "28xxxx43",
            "xfsbh": "92xxxxxxxxxxxx5J",
            "jym": "ff59e"
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
data Array 查验结果
data[].success Boolean 单张查验是否成功
data[].qkl Boolean 是否区块链发票=true
data[].fplx String 100=区块链发票
data[].data Object 票面信息:fpdm/fphm/kprq/jshj/jshjcn/fpzt/yczt/xfmc/xfsbh/gfmc/kjlx

响应示例

JSON 
{
    "reqId": "2f1e094469234435a388ddc36f2a6c42",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "100",
            "fpdm": "14xxxxxx10",
            "fphm": "28xxxx43",
            "jym": "ff59e",
            "xfsbh": "92xxxxxxxxxxxx5J",
            "qkl": true,
            "data": {
                "dq": "深圳",
                "fpdm": "14xxxxxx10",
                "fphm": "28xxxx43",
                "fplx": "100",
                "fpzt": "1",
                "yczt": "0",
                "kprq": "2022-10-20 00:00:00",
                "jshj": 337,
                "jshjcn": "叁佰元整",
                "jym": "ff59e",
                "kjlx": "1",
                "xfmc": "深圳XX小吃店",
                "xfsbh": "92xxxxxxxxxxxx5J",
                "gfmc": "深圳XX公司"
            }
        }
    ]
}

区块链发票查验(北京)

区块链发票查验(北京)。与深圳同URL /v2/invoice/cy/qklfpCy,区别仅在dq。dq固定1100。仅需4项:dq/fpdm/fphm/jym(北京连xfsbh都不需要,比深圳少)。fplx=100区块链发票

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

请求参数

参数名 类型 必填 说明
cyList Array 是 查验列表
cyList[].dq String 是 地区,固定1100(北京)
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].jym String 是 校验码
customReqId String 否 请求ID

请求示例

JSON 
{
    "cyList": [
        {
            "dq": "1100",
            "fpdm": "11xxxxxx10",
            "fphm": "00xxxx01",
            "jym": "841428"
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
data Array 查验结果
data[].success Boolean 单张查验是否成功
data[].qkl Boolean 是否区块链发票=true
data[].fplx String 100=区块链发票
data[].data Object 票面信息:fpdm/fphm/kprq/jshj/jshjcn/fpzt/yczt/xfmc/xfsbh/gfmc/kjlx

响应示例

JSON 
{
    "reqId": "0de733c7d63349f18e9afe6428844855",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "100",
            "fpdm": "14xxxxxx10",
            "fphm": "28xxxx43",
            "jym": "ffxx9e",
            "qkl": true,
            "data": {
                "dq": "北京",
                "fpdm": "14xxxxxx10",
                "fphm": "28xxxx43",
                "fplx": "100",
                "fpzt": "1",
                "yczt": "0",
                "kprq": "2022-10-20 00:00:00",
                "jshj": 337,
                "jshjcn": "叁佰叁拾柒元整",
                "jym": "fxx9e",
                "kjlx": "1",
                "xfmc": "北京市XX店",
                "xfsbh": "92xxxxxxxxxxxx5J",
                "gfmc": "北京XX公司"
            }
        }
    ]
}

区块链发票查验(云南)

区块链发票查验(云南)。与深圳/北京同URL /v2/invoice/cy/qklfpCy,区别仅在dq。dq固定5300。5项必填:dq/fpdm/fphm/jym/xfsbh(同深圳格式)。fplx=100区块链发票

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

请求参数

参数名 类型 必填 说明
cyList Array 是 查验列表
cyList[].dq String 是 地区,固定5300(云南)
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].jym String 是 校验码
cyList[].xfsbh String 是 销方识别号
customReqId String 否 请求ID

请求示例

JSON 
{
    "cyList": [
        {
            "dq": "5300",
            "fpdm": "15xxxxxxxx00",
            "fphm": "05xxxx52",
            "jym": "4fa6f",
            "xfsbh": "92xxxxxxxxxxxxxx5Q"
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
data Array 查验结果
data[].success Boolean 单张查验是否成功
data[].qkl Boolean 是否区块链发票=true
data[].fplx String 100=区块链发票
data[].data Object 票面信息:fpdm/fphm/kprq/jshj/jshjcn/fpzt/yczt/xfmc/xfsbh/gfmc/kjlx

响应示例

JSON 
{
    "reqId": "0de733c7d63349f18e9afe6428844855",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "fplx": "100",
            "fpdm": "14xxxxxxxx10",
            "fphm": "28xxxx43",
            "jym": "ffxx9e",
            "qkl": true,
            "data": {
                "dq": "云南",
                "fpdm": "14xxxxxxxx10",
                "fphm": "28xxxx43",
                "fplx": "100",
                "fpzt": "1",
                "yczt": "0",
                "kprq": "2022-10-20 00:00:00",
                "jshj": 337,
                "jshjcn": "叁佰叁拾柒元整",
                "jym": "fxx9e",
                "kjlx": "1",
                "xfmc": "云南XX店",
                "xfsbh": "92xxxxxxxxxxxx5J",
                "gfmc": "云南XX公司"
            }
        }
    ]
}
车辆通行费发票查验

车辆通行费发票查验(江苏)

车辆通行费发票查验(江苏非ETC)。dq固定3200。4项必填:dq/fpdm/fphm/gfmc(购方名称/抬头)。fplx=103车辆通行费。响应含taxFpUrl(PDF下载链接)和车牌号/车型/出入口站/出口时间等备注

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/toll

请求参数

参数名 类型 必填 说明
customReqId String 是 请求ID
cyList Array 是 查验列表
cyList[].dq String 是 地区,固定3200(江苏)
cyList[].fpdm String 是 发票代码
cyList[].fphm String 是 发票号码
cyList[].gfmc String 是 购方名称/抬头名称(本接口特有)

请求示例

JSON 
{
    "customReqId": "100019953790cccf01c45ce1b744e14ec46384eb",
    "cyList": [
        {
            "dq": "3200",
            "fpdm": "13xxxxxxxx11",
            "fphm": "37xxxx51",
            "gfmc": "苏交XX公司"
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
data Array 查验结果
data[].success Boolean 单张查验是否成功
data[].cltxf Boolean 是否车辆通行费=true
data[].fplx String 103=车辆通行费
data[].data Object 票面信息:fpdm/fphm/kprq/jshj/gfmc/gfsbh/xfmc/xfsbh/skr(收费站)/bz(车牌号/车型/入口站/出口站/出口时间)/taxFpUrl(PDF下载链接)/xmmx[]

响应示例

JSON 
{
    "reqId": "e34be2b2b1b44af0a61a915a4542d27c",
    "code": "2000",
    "success": true,
    "data": [
        {
            "success": true,
            "cltxf": true,
            "fplx": "103",
            "fpdm": "13xxxxxxxx11",
            "fphm": "37xxxx51",
            "data": {
                "fpdm": "13xxxxxxxx11",
                "fphm": "37xxxx51",
                "kprq": "2023年 07月 05日",
                "jshj": "73.00",
                "gfmc": "苏XX公司",
                "gfsbh": "91XXXXXXX7U",
                "xfmc": "江XX公司",
                "xfsbh": "91XXXXXXX9U",
                "skr": "江苏XX站",
                "bz": "车牌号:苏XXX(蓝色);车型:一型客车;入口站:江苏XX站;出口时间:2023-07-05 16:09:24",
                "taxFpUrl": "https:\/\/sh1a.qingstor.com\/dianzifapiao\/invoice\/...\/13xxxxxxxx11_37xxxx51.pdf?...",
                "xmmx": [
                    {
                        "xmmc": "车辆通行费",
                        "xmje": "73.00",
                        "xmsl": "1"
                    }
                ]
            }
        }
    ]
}

增值税平台查验(新)

增值税平台查验(新)

增值税平台查验-新平台

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

该接口文档正在完善中，请联系客服获取详细参数说明。

查验扩展

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

查验并获取版式

数电票查验并获取版式

数电票查验+版式文件下载(与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
        }
    ]
}
版式下载结果查询

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

数电发票查验版式文件下载结果查询。通过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": "成功"
}
不查验获取版式
同步方式

同步获取数电票版式文件

同步获取数电票版式文件(仅支持数电票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"
        }
    ]
}

上传文件查验

上传文件查验

上传文件查验(仅限增值税发票)。支持xml/ofd/pdf格式,文件大小<500KB。企享云先从文件识别四要素再查验,返回全票面+fileUrl。适合费控报销场景:客户只有PDF/OFD文件,无需手工录入fpdm/fphm/kprq等

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/upload

请求参数

参数名 类型 必填 说明
fileName String 是 文件名+后缀,目前支持pdf/ofd/xml。例:test.pdf
fileData String 是 文件内容base64编码,原始文件需<500KB

请求示例

JSON 
{
    "fileName": "test.pdf",
    "fileData": "JVBERi0xLjQKJaqr..."
}

响应参数

参数名 类型 说明
code String 2000=成功
data Array 查验结果
data[].success Boolean 查验是否成功
data[].fileUploadCy Boolean 是否文件上传查验=true
data[].fileUrl String 文件存储URL(企享云侧)
data[].fplx String 识别出的发票类型
data[].fpdm String 识别出的发票代码
data[].fphm String 识别出的发票号码
data[].kprq String 识别出的开票日期
data[].je Number 识别出的金额
data[].jym String 识别出的校验码
data[].dq String 地区码
data[].data Object 查验成功返回全票面(同zzsfpCy),失败返回识别结果

响应示例

JSON 
{
    "code": "2000",
    "reqId": "1f7d8d89b55641fe8f4075f2f01119d3",
    "success": true,
    "data": [
        {
            "success": true,
            "fileUploadCy": true,
            "fplx": "10",
            "dq": "11",
            "fpdm": "011002200811",
            "fphm": "95988841",
            "kprq": "2023-02-15 00:00:00",
            "je": 1960.26,
            "jym": "509791",
            "fileUrl": "http:\/\/qxy-oss...\/xxx.pdf",
            "times": 2,
            "data": {
                "xfmc": "北京XX科技有限公司",
                "xfsbh": "9111XXXXFB09",
                "gfmc": "XX有限公司",
                "gfsbh": "91XXXXXXXX90",
                "je": 1960.26,
                "se": 28.14,
                "jshj": 1988.4,
                "fpztDm": "0",
                "hwxx": [
                    {
                        "mc": "*运输服务*客运服务费",
                        "je": 1066.24,
                        "slv": 0
                    }
                ]
            }
        }
    ]
}

入账状态及用途标签

入账状态及用途标签查询

查询发票入账状态及用途标签。支持数电票(fphm+kprq+jshj三要素)和增值税税控票(含fpdm,普票必传jym)。返回发票状态(fpztDm/fpztMc)/风险等级(fpfxdj)/来源(fplyDm)/冲红作废标志/入账状态ytbqxx(fprzzt未入账/已入账,zzsytbq增值税用途标签:未使用/已抵扣/未抵扣/不抵扣)

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

请求参数

参数名 类型 必填 说明
customReqId String 是 请求ID
cyList Array 是 查询列表
cyList[].fpdm String 否 发票代码(增值税专票/电子专票/机动车/二手车查询时必填,数电票无需)
cyList[].fphm String 是 发票号码
cyList[].kprq String 是 开票日期,yyyy-MM-dd 或 yyyyMMdd
cyList[].jshj Number 是 价税合计
cyList[].jym String 否 校验码(增值税普票/电子普票/卷票/电子普票通行费查询时必填)

请求示例

JSON 
{
    "customReqId": "",
    "cyList": [
        {
            "fphm": "23xxxxxxxxxxxxxxxxx27",
            "kprq": "2023-01-05",
            "jshj": "60000"
        }
    ]
}

响应参数

参数名 类型 说明
code String 2000=成功
data Array 查询结果
data[].fpdm String 发票代码(数电票为空)
data[].fphm String 发票号码(数电票为空)
data[].qdfphm String 全电发票号码
data[].lzfpqdhm String 蓝字发票全电号码
data[].kprq String 开票日期
data[].fpztDm String 发票状态:0正常/2已作废/3已红冲/7已红冲-部分/8已红冲-全额
data[].fpztMc String 发票状态名称
data[].fppzDm String 发票票种代码:01增值税专票/02普票/03机动车/04二手车/05铁路/06航空
data[].fpfxdj String 发票风险等级:正常/异常/疑点
data[].sfch String 是否冲红:未冲红/已冲红
data[].sfzf String 是否作废:未作废/已作废
data[].sffxbz String 是否风险标志:Y/N
data[].fplyDm String 发票来源:1增值税发票管理系统,2电子发票服务平台
data[].gfsbh String 购方识别号
data[].dsffpbz String 第三方发票标志Y/N
data[].cyjg String 查验结果
data[].ytbqxx Object 用途标签信息:fprzzt入账状态/zzsytbq增值税用途标签(未使用/已抵扣/未抵扣/不抵扣)/xfsytbq消费税用途标签/zzsgxsq增值税勾选所属期

响应示例

JSON 
{
    "reqId": "a1621b0da26f403e8f76ae496f98dd0d",
    "code": "2000",
    "success": true,
    "data": [
        {
            "qdfphm": "21xxxxxxxxxxxxxxxxx61",
            "cyjg": "第三方发票,经查验,发票信息一致",
            "dsffpbz": "Y",
            "fpfxdj": "正常",
            "fplyDm": "2",
            "fplymc": "电子发票服务平台",
            "fpztDm": "0",
            "gfsbh": "91XXXXXXXXX2G",
            "kprq": "2021-12-01 00:00:00",
            "sfch": "未冲红",
            "sfchDm": "N",
            "sffxbz": "N",
            "sfzf": "未作废",
            "ytbqxx": {
                "qdfphm": "21xxxxxxxxxxxxxxxxx61",
                "fplymc": "电子发票服务平台",
                "fprzzt": "未入账",
                "xfsytbq": "未使用",
                "zzsytbq": "未使用"
            }
        }
    ]
}

查验并获取版式(总局门户)

查验并获取版式(总局门户)

总局门户数电票查验+版式文件下载(查验结果与国家税务总局全国增值税查验平台一致,版式文件下载结果与电票平台版式文件一致)。与税控/数电/数电纸质查验共用同一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.

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