接口文档 - 星云税融API

财政票据查验

财政票据查验(与财政票据官网一致)。⚠️仅支持单张/仅查最近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"
                    }
                ]
            }
        }
    ]
}

票据查验 - 其它票据查验

发票查验

其它票据查验

财政票据查验

财政票据查验

请求参数

请求示例

响应参数

响应示例

财政票据查验(明细版)

请求参数

请求示例

响应参数

响应示例

通用电子发票查验

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

请求参数

请求示例

响应参数

响应示例

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

区块链发票查验

区块链发票查验(深圳)

请求参数

请求示例

响应参数

响应示例

区块链发票查验(北京)

请求参数

请求示例

响应参数

响应示例

区块链发票查验(云南)

请求参数

请求示例

响应参数

响应示例

车辆通行费发票查验

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

请求参数

请求示例

响应参数

响应示例