财政票据查验

接口描述

该接口用于财政票据查验，与财政票据官网保持一致。

💡

注意：
1.本接口仅支持单张财政票据查验。
2.本接口仅可查验最近一年内开具的电子票据

错误码

错误代码	错误信息	说明
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)由于开票方离线开票，票据数据未上传至财政；(3)查验平台无此票据。
CheckInvoiceNotSame	查验成功所查发票不一致	暂未遇到
CheckInvoiceNotStandard	查询发票不规范	请核对四要素是否符合发票规范
CheckInvoiceRequestNonStandard	请求不规范	请核对请求参数
CheckInvoiceException	税局服务异常，建议15-20分钟后重试	税局服务异常，建议15-20分钟后重试
CheckAbnormal	查验异常（错误信息不固定）	税局服务异常，建议15-20分钟后重试
CheckExceedingLimit	查验发票张数超过限制	发票剩余查验量不足，请与运营负责人沟通确认
CheckInvoiceSingular	请求太频繁或超过服务器最大请求数，请稍后访问！	当前请求数达到服务最大并发数
ServerError	服务器异常，请稍后重试	服务器异常
InternalServerError	服务遇到未知错误，请稍后重试	请联系管理员
RemoteDataException	税局数据异常	请联系管理员
RemoteResultFail	调用税局异常，请稍后重试。	请联系管理员
50008	字段文件名称不能为空(name)	请联系管理员
50014	超过并发限制	请降低并发
59999	未知异常	请联系管理员

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string | null

错误信息

必需

data

array [object {16}] | null

业务数据

可选

code

string | null

查验失败编码

可选

message

string | null

查验失败信息

可选

success

boolean

查验是否成功

必需

time

string

查验时间

必需

times

integer | null

查验次数

可选

fpdm

string | null

发票代码

可选

fphm

string

发票号码

必需

kprq

string

开票日期

必需

jym

string | null

校验码

可选

number | null

金额

可选

jshj

number | null

价税合计

可选

skm

string | null

税控码/密码区

可选

fplx

enum<string> | enum<null>

发票类型代码

可选

枚举值:

0103040809090109030904091009150920618310111415100101102103

示例值:

string | null

地区代码

可选

customReqId

string

请求ID

必需

用于标识一次调用。用户入参传入了则使用用户传入的，未传入则自动生成。

data

查验结果

可选

{
  "reqId": "d97c94a65de94876a8e70b4e765fbe50",
  "code": "2000",
  "success": true,
  "message": null,
  "data": [
    {
      "code": null,
      "czpj": true,
      "czpjCyAndGetFile": null,
      "data": {
        "ch": "01",
        "chrq": "",
        "chsj": "",
        "chyy": "",
        "czbmyz": "",
        "czbmyzbh": "",
        "detailUrl": "",
        "fhr": "",
        "fpdm": "00****23",
        "fphm": "00******03",
        "jehj": "900.00",
        "jehjcn": "玖佰圆整",
        "jkr": "广*************司",
        "jkrnsrsbh": "91***********X7",
        "jym": "86a793",
        "kprq": "20230412",
        "pjmc": "中央非税收入统一票据（电子）",
        "qtxx": [
          {
            "cn": "备注",
            "en": "remark",
            "value": "申请号:20************80 缴费日期:2023-04-11 缴费方式:银行 **代办处 "
          }
        ],
        "skdw": "国家知识产权局专利局",
        "skr": "周*宁",
        "xmmx": [],
        "xmqd": [
          {
            "bz": "",
            "dw": "元",
            "ggbz": "900",
            "je": "900.00",
            "sl": "1",
            "xmbh": "056990126050",
            "xmmc": "外观设计专利第5年年费",
            "xmxh": 0
          }
        ]
      },
      "dq": "00",
      "fpdm": "00****23",
      "fphm": "00******03",
      "fplx": "101",
      "je": 900,
      "jshj": null,
      "jym": "86a793",
      "kprq": "2023-04-12 00:00:00",
      "message": null,
      "qkl": null,
      "skm": null,
      "success": true,
      "time": "2023-06-19 15:35:54",
      "times": 0,
      "tydz": null,
      "xzpj": null,
      "ylpjFile": null
    }
  ]
}

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码