接口文档 - 星云税融API

税控发票查验

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

星云税融API

票据查验 - 增值税平台查验

发票查验

增值税平台查验

税控发票查验

请求参数

请求示例

响应参数

响应示例

数电票查验

请求参数

请求示例

响应参数

响应示例

数电纸质发票查验

请求参数

请求示例

响应参数

响应示例