接口文档 - 星云税融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": []
            }
        }
    ]
}

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