星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档

票据查验 - 电票平台查验

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

发票查验

电票平台查验

电票平台数电票查验

电票平台数电票/数电纸质发票查验(企享云电票平台)。三要素查验: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
                    }
                ]
            }
        }
    ]
}

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

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