财政票据查验（明细版）

接口描述

该接口用于查验财政票据真伪并获取明细&版式文件，返回结果与财政票据官网查验返回结果保持一致，需联系运营开通权限方可使用。

PS：开票日期为一年以前的财政票据，目前仅返回PDF版式文件

支持查验地区如下：

地区	返回版式文件类型	支持查验日期
北京	pdf	3年以内
上海	pdf	3年以内
广东	pdf	不限
深圳	pdf	不限
浙江	pdf/多个pdf的zip包	不限
江苏	pdf	不限
安徽	pdf	不限
天津	pdf	不限
广西	pdf	不限
吉林	pdf	不限
河北	pdf/多个pdf的zip包	不限
辽宁	pdf	不限
山东	pdf	不限
湖北	pdf	不限
海南	pdf	1年以内
重庆	pdf	不限
四川	pdf	不限
贵州	pdf	不限
陕西	pdf	不限
山西	pdf	不限
湖南	pdf	1年以内
福建	pdf	1年以内
江西	pdf	不限
大连	pdf	不限
宁波	pdf/多个pdf的zip包	不限
西藏	pdf	不限
新疆	pdf	不限

💡

注意：
1.仅支持单张财政票据查验。
2.目前开票日期超过一年的财政票据查验仅返回版式文件。

错误码

错误代码	错误信息	说明
CheckInvoiceForTheSameFrequent	当前发票正在查验中,请不要频繁请求	当前发票正在查验中,请稍后重试
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地区是否符合参数规范
IllegalParameter.IllegalPayer	财政票据超一年票据查验jkr缴款人不能为空！	请核对jkr缴款人是否符合参数规范
IllegalParameter.IllegalIdentityCard	财政票据超一年票据查验sfz身份证后六位不能为空！财政票据查验明细版sfz身份证后六位不能为空！	请核对sfz身份证后六位是否符合参数规范
CheckInvoicesMoreThanToday	开票日期超过当前日期	请核对开票日期是否正确
CheckInvoicesOverOneYears	仅可查验最近一年内开具的财政电子票据!	请核对开票日期是否在支持查验的范围内
CheckInvoiceNotSupport	暂不支持该（省市）电子票据查验	该地区暂不支持该票种查验
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>

发票类型代码

可选

枚举值:

010304080909010903090409100915092009306183820810111415100101102103

示例值:

string | null

地区代码

可选

customReqId

string

请求ID

必需

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

data

object | null

查验结果

可选

{
  "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
    }
  ]
}

财政票据查验（明细版）

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码