发票真伪查询网
搜索 K

Appearance

发票查验结果字段说明-响应参数 ​

成功响应 ​

字段名类型描述
successBoolean查验状态 (true)
codeNumber业务状态码
dataObject发票详细信息
requestIdString唯一请求 ID

成功响应示例:

json
{
  "success": true,
  "code": 0,
  "data": {}, // 具体发票数据
  "requestId": "唯一请求ID"
}

增值税专用发票(01),增值税普通发票(04),增值税电子专用发票(08),增值税电子普通发票(10),数电票-增值税专用发票(31), 数电票-普通发票(32) ​

json
{
  "code": 0,
  "data": {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "kprq": "开票日期",
    "fplx": "发票类型",
    "fplxmc": "发票类型名称",
    "cysj": "查验时间",
    "cycs": "查验次数",
    "fpzt": "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红",
    "dkbz": "代开标志 0委托代开 1自开 2代开 3代办退税",
    "jym": "校验码",
    "jqm": "机器编码",
    "jehj": "金额合计",
    "sehj": "税额合计",
    "jshj": "价税合计",
    "xfmc": "销方名称",
    "xfsbh": "销方税号",
    "xfdzdh": "销方地址电话",
    "xfyhzh": "销方银行账号",
    "gfmc": "购方名称",
    "gfsbh": "购方税号",
    "gfdzdh": "购方地址电话",
    "gfyhzh": "购方银行账号",
    "ofdUrl": "若OFD版式文件下载地址为空，说明该发票不存在版式文件",
    "pdfUrl": "若PDF版式文件下载地址为空，说明该发票不存在版式文件",
    "qdbz": "清单标志 Y代表有清单 N代表无清单",
    "tspzlx": "特殊票种类型代码",
    "hwxx": [
      {
        "hwmc": "商品名称",
        "ggxh": "规格型号",
        "dw": "单位",
        "sl": "数量",
        "dj": "单价",
        "je": "金额",
        "slv": "税率",
        "se": "税额",
        "spbm": "商品编码",
        "zsse": "展示税额 如 ***",
        "zsslv": "展示税率 如 免税 不征税"
      }
    ],
    "hzfpxx": [
      {
        "HZ_YWSJ": "红字业务时间",
        "HZ_KPRQ": "红字开票日期",
        "HZ_FPHM": "红字发票号码",
        "HZ_FPDM": "红字发票代码",
        "FPZT_DM": "发票状态代码 0正常 2作废 3红冲 7部分红冲 8全额冲红",
        "KPYF": "红字开票月份"
      }
    ],
    "bz": "备注"
  },
  "requestId": "requestId",
  "success": true
}

INFO

特殊票种代码表

清单票

如果返回的qdbz(清单标志)为Y，表示有清单行，此时在返回的对象data中新增一个 key 为qdh的字段来表示清单行

json
{
  "qdh": [
    {
      "hwmc": "清单行名称",
      "ggxh": "",
      "dw": "",
      "sl": "",
      "dj": "",
      "je": "金额",
      "slv": "税率",
      "se": "税额"
    }
  ]
}

机动车销售统一发票(03) ​

json
{
  "code": 0,
  "data": {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "kprq": "开票日期",
    "cycs": "查验次数",
    "cysj": "查验时间",
    "fplx": "03",
    "fplxmc": "机动车销售统一发票",
    "fpzt": "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红",
    "tspzlx": "特殊票种类型代码",
    "jym": "",
    "jqm": "机器编号",
    "jehj": "金额合计",
    "sehj": "税额合计",
    "jshj": "价税合计",
    "xfmc": "销货单位名称",
    "xfsbh": "销方纳税人识别号",
    "xfdz": "销方地址",
    "xfdh": "销方电话",
    "xfyh": "销方开户银行",
    "xfzh": "销方账号",
    "gfmc": "购方名称",
    "gfsbh": "购方纳税人识别号",
    "gfsfz": "购方组织机构代码",
    "cllx": "车辆类型​",
    "cpxh": "厂牌型号",
    "cd": "产地",
    "hgzh": "合格证号",
    "jkzmsh": "进口证明书号",
    "sjdh": "商检单号",
    "fdjh": "发动机号码",
    "cjh": "车辆识别代号/车架号码",
    "wspz": "完税凭证号码",
    "dw": "吨位",
    "xcrs": "限乘人数",
    "slv": "税率",
    "zgswjg": "主管税务机关",
    "zgswjgdm": "主管税务机关代码",
    "sdFplx": "数电发票类型 1:电子数电票  2:纸质数电票",
    "bz": "备注"
  },
  "requestId": "requestId",
  "success": true
}

增值税普通发票-卷票(11) ​

json
{
  "code": 0,
  "data": {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "kprq": "开票日期",
    "fplx": "发票类型",
    "fplxmc": "增值税普通发票(卷票)",
    "cysj": "查验时间",
    "cycs": "查验次数",
    "fpzt": "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红",
    "jym": "校验码",
    "jqm": "机器编码",
    "jehj": "金额合计",
    "sehj": "税额合计",
    "jshj": "价税合计",
    "xfmc": "销方名称",
    "xfsbh": "销方税号",
    "xfdzdh": "销方地址电话",
    "xfyhzh": "销方银行账号",
    "gfmc": "购方名称",
    "gfsbh": "购方税号",
    "gfdzdh": "购方地址电话",
    "gfyhzh": "购方银行账号",
    "ofdUrl": "若OFD版式文件下载地址为空，说明该发票不存在版式文件",
    "pdfUrl": "若PDF版式文件下载地址为空，说明该发票不存在版式文件",
    "qdbz": "清单标志 Y代表有清单 N代表无清单",
    "tspzlx": "特殊票种类型代码",
    "hwxx": [
      {
        "hwmc": "商品名称",
        "ggxh": "规格型号",
        "dw": "单位",
        "sl": "数量",
        "dj": "单价",
        "je": "金额（含税）",
        "slv": "税率",
        "se": "税额",
        "spbm": "商品编码",
        "bhsje": "不含税金额"
      }
    ],
    "bz": "备注"
  },
  "requestId": "requestId",
  "success": true
}

增值税电子普通发票-通行费(14),数电票-通行费发票(72) ​

json
{
  "code": 0,
  "data": {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "kprq": "开票日期",
    "cycs": "查验次数",
    "cysj": "查验时间",
    "fplx": "14",
    "fplxmc": "增值税电子普通发票(通行费)",
    "fpzt": "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红",
    "jym": "校验码",
    "jqm": "机器编码",
    "jehj": "金额合计",
    "sehj": "税额合计",
    "jshj": "价税合计",
    "xfmc": "销方名称",
    "xfsbh": "销方税号",
    "xfdzdh": "销方地址电话",
    "xfyhzh": "销方银行账号",
    "gfmc": "购方名称",
    "gfsbh": "购方税号",
    "gfdzdh": "购方地址电话",
    "gfyhzh": "购方银行账号",
    "ofdUrl": "若OFD版式文件下载地址为空，说明该发票不存在版式文件",
    "pdfUrl": "若PDF版式文件下载地址为空，说明该发票不存在版式文件",
    "qdbz": "清单标志 Y代表有清单 N代表无清单",
    "tspzlx": "特殊票种类型代码",
    "hwxx": [
      {
        "hwmc": "项目名称",
        "cph": "车牌号",
        "lx": "类型",
        "txrqq": "通行日期起",
        "txrqz": "通行日期止",
        "je": "金额",
        "slv": "税率",
        "se": "税额",
        "spbm": "商品编码",
        "zsse": "展示税额 如 ***",
        "zsslv": "展示税率 如 免税 不征税"
      }
    ],
    "bz": "备注"
  },
  "requestId": "requestId",
  "success": true
}

二手车销售统一发票(15) ​

json
{
  "code": 0,
  "data": {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "kprq": "开票日期",
    "fplx": "15",
    "fplxmc": "二手车销售统一发票",
    "cycs": "查验次数",
    "cysj": "查验时间",
    "fpzt": "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红",
    "jym": "",
    "jqm": "机器编号",
    "jehj": "金额合计",
    "sehj": "",
    "jshj": "车价合计",
    "xfmc": "卖方单位/个人",
    "xfsbh": "卖方单位代码/身份证号码",
    "xfdzdh": "卖方单位/个人地址 卖方电话",
    "xfyhzh": "",
    "gfmc": "买方单位/个人",
    "gfsbh": "买方单位代码/身份证号码",
    "gfdzdh": "买方单位/个人地址 买方电话",
    "gfyhzh": "",
    "cph": "车牌照号",
    "djzh": "登记证号",
    "cllx": "车辆类型",
    "cjh": "车架号",
    "cpxh": "厂牌型号",
    "zrdcgsmc": "转入地车辆管理所名称",
    "jypmdwmc": "经营、拍卖单位",
    "jypmdwsbh": "经营、拍卖单位纳税人识别号",
    "jypmdwdz": "经营、拍卖单位地址",
    "jypmdwdh": "经营、拍卖单位电话",
    "jypmdwyhzh": "经营、拍卖单位开户银行、账号",
    "escsc": "二手车市场",
    "escnsrsbh": "二手车纳税人识别号",
    "escdz": "二手车地址",
    "escdh": "二手车电话",
    "esckhyhzh": "二手车开户银行、账号",
    "sdFplx": "数电发票类型 1:电子数电票  2:纸质数电票",
    "bz": "备注",
  },
  "requestId": "requestId",
  "success": true
}

航空运输电子客票行程单(61) ​

json
{
  "code": 0,
  "data": {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "kprq": "开票日期",
    "fplx": "61",
    "fplxmc": "航空运输电子客票行程单",
    "cycs": "查验次数",
    "cysj": "查验时间",
    "fpzt": "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红",
    "jehj": "",
    "sehj": "税额合计",
    "jshj": "价税合计",
    "gfmc": "购买方名称",
    "gfsbh": "购买方纳税人识别号",
    "dzkphm": "电子客票号码",
    "xm": "姓名",
    "zjhm": "证件号码",
    "gngjbz": "国内国际标志",
    "gpdh": "GP单号",
    "hwxx": [
      {
        "hdxh": "航段序号",
        "sfz": "始发站",
        "mdz": "目的站",
        "cyr": "承运人",
        "hbh": "航班号",
        "zwdj": "座位等级",
        "cyrq": "承运日期",
        "qfsj": "起飞时间",
        "kpjb": "客票等级"
      }
    ],
    "bz": "备注"
  },
  "requestId": "requestId",
  "success": true
}

铁路电子客票(83) ​

json
{
  "code": 0,
  "data": {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "kprq": "开票日期",
    "fplx": "83",
    "fplxmc": "铁路电子客票",
    "cysj": "查验时间",
    "cycs": "查验次数",
    "fpzt": "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红",
    "jehj": "金额合计",
    "sehj": "税额合计",
    "jshj": "票价",
    "gfmc": "购买方名称",
    "gfsbh": "购买方统一社会信用代码",
    "ywlx": "业务类型 0退 1售 2改",
    "xm": "姓名",
    "zjh": "证件号",
    "slv": "税率",
    "cfz": "出发站",
    "ddz": "到达站",
    "cc": "车次",
    "ccrq": "乘车日期",
    "cfsj": "出发时间",
    "xb": "席别",
    "cx": "车厢",
    "xw": "席位",
    "pz": "票种",
    "dzkph": "电子客票号",
    "kttz": "空调特征",
    "bz": ""
  },
  "requestId": "requestId",
  "success": true
}

失败响应 ​

字段名类型描述
successBoolean查验状态 (false)
codeNumber业务状态码
messageString错误信息描述
requestIdString唯一请求 ID

失败响应示例:

json
{
  "success": false,
  "code": 2005,
  "message": "入参fpdm错误：发票代码不正确",
  "requestId": "唯一请求id"
}

业务状态码 ​

点击查看所有业务状态码

特殊票种代码表 ​

tspzlx (特殊票种类型)特殊票种名称
02农产品收购
03稀土矿产品发票
04稀土产成品发票
05石脑油
06通行费可抵扣
07通行费（不可抵扣）
08成品油发票
12机动车
19出口发票
28金融商品转让
29客运场站服务
76报废产品收购
77报废产品收购
81成品油
82稀土
83建筑服务
84货物运输服务
85不动产销售
86不动产经营租赁服务
87代征车船税
88通行费电子发票
89旅客运输服务
90医疗发票（门诊）
91医疗发票（住院）
92自产农产品销售
93拖拉机按减征税
94机动车
95二手车
96农产品收购
97光伏收购
98卷烟
空（null 或 ""）不属于特殊发票类型

常见问题 ​

如何通过查验结果判断发票是否有效？ ​

在使用发票查验 API 时，开发者和财务系统通常最关心以下问题：

  • 这张发票是否真实有效？
  • 是否已经作废？
  • 是否已被红冲？
  • 是否可以用于报销或入账？

这些判断都可以通过接口返回的关键字段组合得出。

核心判断字段总览 ​

以下字段是判断发票状态的核心字段：

fpzt: "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红"

字段名含义重要性
fpzt发票当前状态、是否作废、是否红冲⭐⭐⭐⭐⭐

发票状态判断规则说明 ​

正常有效发票 ​

当查验结果满足以下条件时，可认为发票为有效状态：

  • 查验结果为成功
  • 发票未作废
  • 发票未红冲

此类发票通常可用于报销或入账。

已作废发票 ​

当返回字段显示发票已作废时，说明该发票已失效：

  • 作废发票不可用于报销
  • 作废状态通常由开票方主动操作

即使查验成功，作废状态仍需视为无效票据。

已红冲发票 ​

红冲表示该发票已被红字发票冲销：

  • 原发票不再具备报销或入账效力
  • 财务系统应单独处理此类票据

常见判断误区 ​

查验成功是否等于发票有效？ ​

不完全等同。查验成功仅表示发票真实存在，仍需判断是否作废或红冲。

全额红冲后原发票还能用吗？ ​

不能。全额红冲后的原发票不应再用于任何财务用途。

使用建议 ​

  • 财务系统应同时校验查验结果与发票状态字段
  • 建议将作废、红冲状态作为强校验条件
  • 查验结果字段可用于自动报销风控