1. 发票查验
1.1. 接口说明
单张发票信息查验
1.2. 调用方式
请求方式:POST
https://invoice.youepiao.com/input/openApi/checkInvoiceSingle
1.3. 请求参数
1.3.1. 参数示例
{
"jym": "",
"fpje": "",
"fpdm": "",
"kprq": "",
"fphm": "",
"fpzl": ""
}
1.3.2. 参数说明
| 参数 |
参数名称 |
类型 |
长度 |
必须 |
说明 |
| jym |
校验码 |
String |
6 |
是 |
校验码;发票校验码后 6 位,发票种类为 04,10,11,14 , 16(全部)时此项为必填项;发票种类参考发票种类 (fpzl)字段 |
| fpje |
不含税金额 |
String |
|
是 |
不含税金额;当发票种类为 01,02,03,15,08,16,21,22 时此 项为必填项:且当 01,02,03,16 填写发票不含税金 额,15 填写发票车价合计;发票种类参考发票种类 (fpzl)字段;且当 21,22 时填写发票价税合计金额 |
| fpdm |
发票代码 |
String |
10/12 |
是 |
发票代码;全电发票(普通/专用)可为空 |
| kprq |
开票日期 |
String |
8 |
是 |
开票日期;格式 yyyyMMdd 例:20200324 |
| fphm |
发票号码 |
String |
8 |
是 |
发票号码; |
| fpzl |
发票种类 |
String |
2 |
是 |
发票种类;增值税专用发票:01 货运运输业增值税专用发票:02 机动车销售统一发票:03 增值税普通发票:04 增值税普通发票(电子):10 增值税普通发票(卷式):11 通行费发票:14 二手车发票:15 增值税电子专用发票:08 区块链电子发票:16(只支持深圳地区) 全电发票(专用发票):21 全电发票(普通发票):22 |
1.4. 返回结果
1.4.1. 返回示例
{
"success": true,
"code": "0000",
"message": "default success",
"data": {
"detailList": [{
"sl": "6%",
"je": "12092.26",
"ggxh": "",
"jldw": "批",
"se": "725.54",
"fyxm": "",
"txrqq": "",
"spsl": "",
"hsje": "",
"mxbh": "1",
"txrqz": "",
"lx": "",
"hwmc": "*物流辅助服务*收派服务",
"cph": "",
"bhsdj": "",
"hsdj": "",
"ssflbm": "",
}],
"fpdm": "4100191130",
"jym": "",
"fpzl": "01",
"fpje": "12092.26",
"kprq": "20190806",
"cyjg": "0001",
"fphm": "07537241",
"cyjgxx": "查验成功发票一致",
"jshj": "12817.80",
"xhfdzdh": "三门峡市崤山西路 5 号 15238990130",
"zfbz": "N",
"bswjurl": "",
"cd": "",
"xhfsbh": "91411200558331044L",
"cllx": "",
"sjdh": "",
"xhfmc": "中国邮政速递物流股份有限公司三门峡市分公司",
"gmfdzdh": "芮城县风陵渡开发区工业大道 1 号 0359-3388045",
"bz": "明细见附件起运地-到达地:三门峡-郑州-全国各地 车种车号:9.6 米 邮政厢车 豫 AN3061 豫 AG9992 豫 AU1113 吨位:13T 运输货物信息:医药",
"kpr": "",
"fdjhm": "",
"jqbh": "499906906488",
"hgzs": "",
"clshb": "",
"gmfyhzh": "中国工商银行芮城风陵渡支行 0511038309200004046",
"jkzmsh": "",
"cycs": "22",
"xhfyhzh": "100433485660019999 邮政储蓄银行三门峡分行中心支行",
"gmfsbh": "91140830757262627K",
"gmfmc": "山西亚宝医药经销有限公司",
"fpse": "",
"fhr": "",
"skr": "",
"sfzh": "",
"cpxh": "",
"mfdwgr": "",
"khyh": "",
"fhrsbh": "",
"khyhjzh": "",
"mfdh": "",
"escscdz": "",
"jypmdwdz": "",
"spfshb": "",
"zrdcgsmc": "",
"escsckhyhzh": "",
"escsc": "",
"xhfdz": "",
"cpzh": "",
"mfdwdmsfzh": "",
"xcrs": "",
"txfbz": "",
"jypmdwdh": "",
"cyrsbh": "",
"jypmdw": "",
"cjhj": "",
"escscdh": "",
"sl": "",
"dw": "",
"fhrmc": "",
"skph": "",
"smfdwgrzz": "",
"djzh": "",
"khzh": "",
"lslbs": "",
"jypmdwdzsbh": "",
"shrmc": "",
"yshwxx": "",
"smfdwdmsfzh": "",
"zgswjgmc": "",
"mfdwgrdz": "",
"smfdwgr": "",
"smfdh": "",
"shrsbh": "",
"ccdw": "",
"escscsbh": "",
"wspzhm": "",
"qydjyddd": "",
"czch": "",
"cyrmc": "",
"zgswjgdm": "",
"spfmc": ""
}
}
返回说明
| 参数 |
参数名称 |
类型 |
长度 |
必须 |
说明 |
| cyjg |
查验结果 |
String |
10 |
是 |
|
| cyjgxx |
查验结果信息 |
String |
100 |
是 |
查询结果的信息 |
| fpzl |
发票种类 |
String |
2 |
是 |
|
| fpdm |
发票代码 |
String |
20 |
是 |
|
| fphm |
发票号码 |
String |
8 |
是 |
|
| cycs |
查验次数 |
String |
100 |
是 |
|
| xhfmc |
销售方名称 |
String |
100 |
是 |
|
| xhfsbh |
销售方识别号 |
String |
20 |
是 |
|
| xhfdzdh |
销售方地址电话 |
String |
100 |
是 |
|
| xhfyhzh |
销售方开户行及账号 |
String |
100 |
是 |
|
| gmfsbh |
购买方识别号 |
String |
20 |
是 |
|
| gmfmc |
购买方名称 |
String |
100 |
是 |
|
| gmfmc |
购买方名称 |
String |
100 |
是 |
|
| gmfdzdh |
购方地址、电话 |
String |
100 |
是 |
|
| gmfyhzh |
购买方开户行及账号 |
String |
100 |
是 |
|
| kprq |
开票日期 |
String |
8 |
是 |
格式 yyyyMMdd |
| fpje |
发票金额 |
String |
20 |
是 |
|
| fpse |
发票税额 |
String |
20 |
是 |
|
| jshj |
价税合计 |
String |
16 |
是 |
|
| bz |
备注 |
String |
200 |
是 |
|
| jqbh |
机器编号 |
String |
20 |
是 |
|
| kpr |
开票人 |
String |
8 |
是 |
|
| skr |
收款人 |
String |
8 |
是 |
|
| fhr |
复核人 |
String |
8 |
是 |
|
| jym |
校验码 |
String |
32 |
是 |
区块链电子发票返回 5 位 |
| zfbz |
作废标志 |
String |
100 |
是 |
Y:已作废 H:已冲红 N:未作 废 |
| qdbz |
清单标识 |
String |
1 |
是 |
Y:带清单;N:无清单;备注; 只有当发票种类为:专用发 票,电子专用发票,电子发票, 普通发票时返回此字段的值 |
| detailList |
|
|
|
|
|
| mxbh |
明细编号 |
String |
90 |
是 |
|
| hwmc |
货物名称 |
String |
40 |
是 |
|
| je |
金额 |
String |
22 |
是 |
|
| spsl |
数量 |
String |
22 |
是 |
|
| sl |
税率 |
String |
24 |
是 |
|
| se |
税额 |
String |
24 |
是 |
|
| hsdj |
含税单价 |
String |
24 |
是 |
|
| hsje |
含税金额 |
String |
24 |
是 |
|
| bhsdj |
不含税单价 |
String |
24 |
是 |
|
| ggxh |
规格型号 |
String |
100 |
是 |
|
| jldw |
计量单位 |
String |
100 |
是 |
|
| fyxm |
费用项目 |
String |
100 |
是 |
货运发票返回信息 |
| cph |
车牌号 |
String |
100 |
是 |
通行费发票返回信息 |
| lx |
类型 |
String |
100 |
是 |
通行费发票返回信息 |
| txrqq |
通行日期起 |
String |
100 |
是 |
通行费发票返回信息 |
| txrqz |
通行日起止 |
String |
100 |
是 |
通行费发票返回信息 |
| ssflbm |
税收分类编码 |
String |
100 |
是 |
|
| bswjurl |
版式文件 URL |
String |
100 |
是 |
ofd 类型文件返回该字段 |
1.4.2. 返回代码说明
| 类型 |
返回码 |
返回说明 |
说明 |
| 查验失败 |
9999 |
查验失败 |
查验失败 |
| 查验成功发票一致 |
0001 |
查验成功发票一致 |
查验成功 |
| 超过该张票当天查验次数 |
0002 |
查验失败 |
此发票今日查询次数已达上限 (5 次),请次日查询 |
| 请求不合法 |
0005 |
请求不合法 |
发票信息有误,请核对后再查询 |
| 发票信息不一致 |
0006 |
发票信息不一致 |
发票信息有误,请核对后再查询 |
| 发票不存在 |
0009 |
发票不存在 |
所查发票不存在 |
| 已超过最大查验量 |
1004 |
已超过最大查验量 |
已超过最大查验量,请联系管理 员 |
| 查询发票不规范 |
1005 |
查询发票不规范 |
信息有误,请核对后再查询 |
| 查验异常 |
1006 |
查验异常 |
发票信息有误,请核对后再查询 |
| 该批次已过 期,请重新更 换批次号查 验 |
1007 |
该批次已过期,请重新更 换批次号查验 |
该批次已过期,请重新更换批次 号查验 |
| 字段不能为空 |
1008 |
字段不能为空 |
发票请求参数不能为空 |
| 参数长度不正确 |
1009 |
参数长度不正确 |
参数长度不符合规范,确认参数,再次查验 |
| 当前查验未完成 |
1010 |
当前查验未完成 |
查验正在进行中(批量查验) |
| 该批次已查验 |
1011 |
该批次已查验 |
批量已查验(应当调用发票获 取 接口 获得查验发票信息) |
| 超过规定张数 |
1012 |
超过规定张数 |
批量查验接口默认 200 张,超过 规定张数 |
| 批次号不存 在 |
1013 |
批次号不存在 |
可重新请求,换批次号 |
| 日期当天的不能查验 |
1014 |
日期当天的不能查验 |
日期当天的不能查验,请隔天再 查 |
| 超过5年的不能查验 |
1015 |
超过 5 年的不能查验 |
超过 5 年的不能查验 |
| 没有查验权 限 |
1020 |
没有查验权限 |
没有查验权限,请联系管理员 |
| 网络超时 |
1021 |
网络超时 |
税局维护升级 |