Appearance
响应参数
成功响应
| 字段名 | 类型 | 描述 |
|---|---|---|
success | Boolean | 查验状态 (true) |
code | Number | 业务状态码 |
data | Object | 发票详细信息 |
requestId | String | 唯一请求 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全额冲红",
"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": "主管税务机关代码",
"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)
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": "商品编码"
}
],
"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": "二手车开户银行、账号",
"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
}失败响应
| 字段名 | 类型 | 描述 |
|---|---|---|
success | Boolean | 查验状态 (false) |
code | Number | 业务状态码 |
message | String | 错误信息描述 |
requestId | String | 唯一请求 ID |
失败响应示例:
json
{
"success": false,
"code": 2005,
"message": "入参fpdm错误：发票代码不正确",
"requestId": "唯一请求id"
}业务状态码
特殊票种代码表
| tspzlx (特殊票种类型) | 特殊票种名称 |
|---|---|
| 02 | 农产品收购 |
| 03 | 稀土矿产品发票 |
| 04 | 稀土产成品发票 |
| 05 | 石脑油 |
| 06 | 通行费可抵扣 |
| 07 | 通行费（不可抵扣） |
| 08 | 成品油发票 |
| 12 | 机动车 |
| 76 | 报废产品收购 |
| 77 | 报废产品收购 |
| 81 | 成品油 |
| 82 | 稀土 |
| 83 | 建筑服务 |
| 84 | 货物运输服务 |
| 85 | 不动产销售 |
| 86 | 不动产经营租赁服务 |
| 88 | 通行费电子发票 |
| 89 | 旅客运输服务 |
| 92 | 自产农产品销售 |
| 93 | 拖拉机按减征税 |
| 94 | 机动车 |
| 96 | 农产品收购 |
| 空（null 或 ""） | 不属于特殊发票类型 |