星云税融API

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

票据查验 - 发票查验

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

发票查验

增值税平台查验

税控发票查验

增值税发票四要素查验(与国家税务总局全国增值税查验平台一致)。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

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

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

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