数电票查验并获取版式文件

接口描述

该接口用于数电票查验，目前仅支持数电票与数电纸质发票查验，与电票平台-发票查验保持一致。

💡

注意：不同的数电票价税合计取值不同

错误码

错误代码	错误信息	说明
CheckInvoiceOverSupportCount	超过当前接口支持最大查验张数!	超过接口限制的单次请求张数，请调整单次请求张数。
CheckInvoiceForTheSameFrequent	当前发票正在查验中,请不要频繁请求	当前发票正在查验中,请稍后重试
CheckInvoicesOverOneYears	仅可查验最近一年内开具的财政电子票据!	请检查开票日期！
IllegalParameter	请求参数不正确	请核对请求参数
IllegalParameter.IllegalInvoiceCode	请求参数不正确,参数fpdm发票代码不正确！	请核对fpdm发票代码是否符合参数规范
IllegalParameter.IllegalInvoiceNumber	请求参数不正确,参数fphm发票号码不正确！	请核对fphm发票号码是否符合参数规范
IllegalParameter.IllegalBillingDate	请求参数不正确,参数kprq开票日期不正确！	请核对kprq开票日期是否符合参数规范
IllegalParameter.IllegalCheckCode	参数jym[发票校验码后6位]不正确	请核对jym校验码是否符合参数规范
IllegalParameter.IllegalTotalAmount	参数je[不含税金额]不正确	请核对je金额是否符合参数规范
IllegalParameter.IllegalTotalAmountIincludingTax	请求参数不正确,价税合计为空！	请核对jshj价税合计是否符合参数规范
IllegalParameter.IllegalXfsbh	请求参数不正确,销售方识别号为空！	请核对xfsbh销方识别号是否符合参数规范
IllegalParameter.IllegalArea	请求参数不正确,参数dq地区不正确！	请核对dq地区是否符合参数规范
CheckInvoicesMoreThanToday	开票日期超过当前日期	请核对开票日期是否正确
CheckInvoicesOverFiveYears	超过五年的发票不能查验	请核对开票日期是否正确
CheckInvoiceNotSupport	暂不支持该（省市）电子票据查验	该地区暂不支持该票种查验
CheckInvoicesOverOneYears	仅可查验最近一年内开具的财政电子票据!	请检查开票日期！
CheckInvoiceMoreFiveTimes	超过该张票当天查验次数	请确认在调用接口前是否已经通过官方平台查验超过5次
CheckInvoiceNotExistence	查验成功所查发票不存在	发票代码或发票号码在税局查不到，请核对代码、号码是否正确注：可能原因如下：(1)输入的查验项有误；(2)查询的发票开票日期距当前日期超过5年；(3)由于开票方离线开票，发票数据未上传至税务局；(4)非增值税发票管理系统开具的发票。
CheckInvoiceNotSame	查验成功所查发票不一致	请检查四要素是否与真实票面一致，传入金额是否为不含税金额（非二手车）或该发票是否为假票
CheckInvoiceNotStandard	查询发票不规范	请核对四要素是否符合发票规范
CheckInvoiceRequestNonStandard	请求不规范	请核对请求参数
CheckInvoiceException	税局服务异常，建议15-20分钟后重试	税局服务异常，建议15-20分钟后重试
CheckAbnormal	查验异常（错误信息不固定）	税局服务异常，建议15-20分钟后重试
CheckExceedingLimit	查验发票张数超过限制	发票剩余查验量不足，请与运营负责人沟通确认
CheckInvoiceSingular	请求太频繁或超过服务器最大请求数，请稍后访问！	当前请求数达到服务最大并发数
ServerError	服务器异常，请稍后重试	服务器异常
InternalServerError	服务遇到未知错误，请稍后重试	请联系管理员
RemoteDataException	税局数据异常	请联系管理员
RemoteResultFail	调用税局异常，请稍后重试。	请联系管理员
50008	字段文件名称不能为空(name)	请联系管理员
50014	超过并发限制	请降低并发
59999	未知异常	请联系管理员
505002	接口调用异常!	请联系管理员

请求参数

Header 参数

Body 参数application/json

示例

{
    "customReqId": "",
    "cyList": [
        {
            "fphm": "23****************27",
            "kprq": "2023-01-05",
            "jshj": "60000",
            "bswjFplx": "0910,0920,61,83",
            "bswjLx": "XML,OFD,PDF"
        }
    ]
}

返回响应

🟢200电子发票（增值税专用发票）

application/json

Body

示例

电子发票（增值税专用发票）电子发票（增值税专用发票）带入账状态及用途标签

{
    "reqId": "d8ca03b851eb4025833f15b93c035249",
    "code": "2000",
    "success": true,
    "message": null,
    "data": [
        {
            "bswjxzTaskId": 564549648156117900,
            "customReqId": "10001999695681ce86bf44548f5d2ff68cee05c7",
            "data": {
                "bz": "",
                "dkXsfmc": null,
                "dkXsfsbh": null,
                "dq": "上海",
                "fhr": null,
                "fpdm": "",
                "fphm": "21*****************61",
                "fplx": "0920",
                "fpztDm": "0",
                "gfmc": "安付********公司",
                "gfsbh": "91****************2G",
                "gmfdzdh": "上海****************************33",
                "gmfyhzh": "中国***********************************30",
                "hwxx": [
                    {
                        "dj": "0.31858410",
                        "ggxh": "",
                        "je": 999.99,
                        "jldw": "张",
                        "lslbs": "",
                        "mc": "*纸制品*积点卡",
                        "mxxh": 1,
                        "se": 130,
                        "sl": "3138.85721200",
                        "slv": 0.13,
                        "spbm": "1060105990000000000",
                        "ysse": "130.0",
                        "ysslv": "13%"
                    }
                ],
                "je": 999.99,
                "jshj": 1129.99,
                "jshjcn": "壹仟壹佰贰拾玖元玖角玖分",
                "jym": "",
                "kjlx": "1",
                "kprq": "2021-12-01 00:00:00",
                "mxts": null,
                "purl": "",
                "qdfphm": "21*****************61",
                "qdlx": "20",
                "sbbh": "",
                "se": 130,
                "skm": null,
                "skr": null,
                "tdyslxDm": null,
                "tspzDm": "",
                "url": "",
                "xfmc": "上海*******公司",
                "xfsbh": "91****************1C",
                "xhqdBz": "",
                "xsfdzdh": "上海**********************************33",
                "xsfyhzh": "中国*************************************30",
                "yfpdm": null,
                "yfphm": null
            },
            "dq": "31",
            "fpdm": null,
            "fphm": "21*****************61",
            "fplx": "0920",
            "je": null,
            "jshj": 1129.99,
            "jym": null,
            "kprq": "2021-12-01 00:00:00",
            "success": true,
            "time": "2024-08-05 11:36:11",
            "times": 3
        }
    ]
}

🟢200医疗服务（门诊）

🟢200电子发票（普通发票）

🟢200电子发票（铁路电子客票）

🟢200电子发票（航空运输电子客票行程单）

🟢200数电纸质（机动车统一销售发票）

🟢200数电纸质发票（二手车统一销售发票)查验

🟢200建筑服务发票

🟢200货物运输服务发票

🟢200不动产销售服务

🟢200不动产经营租赁服务

🟢200旅客运输服务发票

🟢200拖拉机和联合收割机发票

🟢200自产农产品销售

🟢200农产品收购发票

🟢200电票平台查验失败

🟢200数电纸质（增值税专用发票）

🟢200数电纸质发票(增值税普通发票)

数电票查验并获取版式文件

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码