接口文档 - 星云税融API

接口文档

文档 / 票据查验 / 查验扩展 / 入账状态及用途标签

票据查验 - 入账状态及用途标签

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

查验扩展

入账状态及用途标签

入账状态及用途标签查询

查询发票入账状态及用途标签。支持数电票(fphm+kprq+jshj三要素)和增值税税控票(含fpdm,普票必传jym)。返回发票状态(fpztDm/fpztMc)/风险等级(fpfxdj)/来源(fplyDm)/冲红作废标志/入账状态ytbqxx(fprzzt未入账/已入账,zzsytbq增值税用途标签:未使用/已抵扣/未抵扣/不抵扣)

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/entry-status

请求参数

参数名	类型	必填	说明
customReqId	String	是	请求ID
cyList	Array	是	查询列表
cyList[].fpdm	String	否	发票代码(增值税专票/电子专票/机动车/二手车查询时必填,数电票无需)
cyList[].fphm	String	是	发票号码
cyList[].kprq	String	是	开票日期,yyyy-MM-dd 或 yyyyMMdd
cyList[].jshj	Number	是	价税合计
cyList[].jym	String	否	校验码(增值税普票/电子普票/卷票/电子普票通行费查询时必填)

请求示例

JSON

{
    "customReqId": "",
    "cyList": [
        {
            "fphm": "23xxxxxxxxxxxxxxxxx27",
            "kprq": "2023-01-05",
            "jshj": "60000"
        }
    ]
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Array	查询结果
data[].fpdm	String	发票代码(数电票为空)
data[].fphm	String	发票号码(数电票为空)
data[].qdfphm	String	全电发票号码
data[].lzfpqdhm	String	蓝字发票全电号码
data[].kprq	String	开票日期
data[].fpztDm	String	发票状态:0正常/2已作废/3已红冲/7已红冲-部分/8已红冲-全额
data[].fpztMc	String	发票状态名称
data[].fppzDm	String	发票票种代码:01增值税专票/02普票/03机动车/04二手车/05铁路/06航空
data[].fpfxdj	String	发票风险等级:正常/异常/疑点
data[].sfch	String	是否冲红:未冲红/已冲红
data[].sfzf	String	是否作废:未作废/已作废
data[].sffxbz	String	是否风险标志:Y/N
data[].fplyDm	String	发票来源:1增值税发票管理系统,2电子发票服务平台
data[].gfsbh	String	购方识别号
data[].dsffpbz	String	第三方发票标志Y/N
data[].cyjg	String	查验结果
data[].ytbqxx	Object	用途标签信息:fprzzt入账状态/zzsytbq增值税用途标签(未使用/已抵扣/未抵扣/不抵扣)/xfsytbq消费税用途标签/zzsgxsq增值税勾选所属期

响应示例

JSON

{
    "reqId": "a1621b0da26f403e8f76ae496f98dd0d",
    "code": "2000",
    "success": true,
    "data": [
        {
            "qdfphm": "21xxxxxxxxxxxxxxxxx61",
            "cyjg": "第三方发票,经查验,发票信息一致",
            "dsffpbz": "Y",
            "fpfxdj": "正常",
            "fplyDm": "2",
            "fplymc": "电子发票服务平台",
            "fpztDm": "0",
            "gfsbh": "91XXXXXXXXX2G",
            "kprq": "2021-12-01 00:00:00",
            "sfch": "未冲红",
            "sfchDm": "N",
            "sffxbz": "N",
            "sfzf": "未作废",
            "ytbqxx": {
                "qdfphm": "21xxxxxxxxxxxxxxxxx61",
                "fplymc": "电子发票服务平台",
                "fprzzt": "未入账",
                "xfsytbq": "未使用",
                "zzsytbq": "未使用"
            }
        }
    ]
}

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