国税发票查验系统接口文档
- 验证码识别接口（这里以127.0.0.1为例,端口9898，实际请替换服务器公网IP或网址，如为服务器本地调用，则保留为127.0.0.1；实际端口以服务器开放端口为准）
接口地址：
请求参数：
|
序号 |
关键字 |
含义 |
是否为必需 |
|
1 |
fpdm |
发票代码 |
是 |
|
2 |
fphm |
发票号码 |
是 |
|
3 |
date |
开票日期 |
是 |
|
4 |
code |
校验码后6位或不含税金额 |
是 |
|
5 |
ip |
代理ip |
否 |
|
6 |
port |
代理端口 |
否 |
|
7 |
timeout |
超时时间，单位为毫秒 |
否 |
请求方式：GET/POST
响应代码code：
|
响应代码code |
含义 |
|
0 |
正常 |
|
-1 |
返回为空，原因为国税平台对应返回数据无响应。 |
|
-2 |
未获取到验证码数据，原因为请求频繁或时间原因。 |
|
-3 |
请求过程发生错误，系统原因。 |
|
-4 |
参数不合法，检查发票代码、发票号码、开票日期、校验码后6位或不含税金额。 |
|
-5 |
开票日期大于等于请求日，不处理 |
|
-7 |
系统多次请求后仍异常，原因：国税平台无法获取验证码，请检查发票信息或前往国税查验平台手动查验确认 |
|
-8 |
系统多次请求后仍异常，原因：国税平台无返回信息。 |
|
-9（保留项） |
代理无效，系统会自动请求百度进行判断 |
其他返回参数：
|
content |
返回识别情况中文描述 |
|
img |
返回国税平台验证码的base64编码字符串，解码即可获得验证码 |
|
key2 |
验证码时间，后续查验需要 |
|
Key3 |
后续查验需要 |
|
Key4 |
需要识别的验证码文字颜色，分为00,01,02,03，对应：所有字符、红色字符、黄色字符、蓝色字符 |
|
Key6 |
后续查验需要 |
|
Recognition results
|
系统识别结果，不区分大小写 |
|
tip
|
验证码文字颜色提示信息，与key4对应 |
- 使用发票四要素、验证码、key2、key3、key6请求国税查验结果接口
接口地址：
请求参数：
|
序号 |
关键字 |
含义 |
是否为必需 |
|
1 |
fpdm |
发票代码 |
是 |
|
2 |
fphm |
发票号码 |
是 |
|
3 |
date |
开票日期 |
是 |
|
4 |
code |
校验码后6位或不含税金额 |
是 |
|
5 |
ip |
代理ip |
否 |
|
6 |
port |
代理端口 |
否 |
|
7 |
key2 |
请求验证码返回的key2 |
是 |
|
8 |
key3 |
请求验证码返回的key3 |
是 |
|
9 |
key6 |
请求验证码返回的key6 |
是 |
|
10 |
yzm |
指定颜色对应的验证码字符 |
是 |
|
11 |
timeout |
超时时间，单位为毫秒 |
否 |
请求方式：GET/POST
响应代码code：
|
响应代码code |
含义 |
|
1 |
该省尚未开通发票查验功能 |
|
001 |
正常 |
|
002 |
超过该张发票当日查验次数(请于次日再次查验) |
|
003 |
发票查验请求太频繁，请稍后再试 |
|
004 |
超过服务器最大请求数，请稍后访问 |
|
005 |
请求不合法 |
|
020 |
由于查验行为异常，涉嫌违规，当前无法使用查验服务 |
|
006 |
查验不一致 |
|
007 |
验证码失效 |
|
008 |
验证码错误 |
|
009 |
查无此票 |
|
010 |
查无此票 |
|
rqerr |
当日开具发票可于次日进行查验 |
|
999 |
国税系统返回异常，请重试 |
|
-1 |
返回为空 |
|
-2 |
未获取到验证码数据，原因为请求频繁或时间原因。 |
|
-3 |
系统错误 |
|
-4 |
参数不合法，检查发票代码、发票号码、开票日期、校验码后6位或不含税金额、key2、key3、key6、yzm值是否正确。 |
|
-5 |
开票日期大于等于请求日，不处理 |
|
-9（保留项） |
代理无效，系统会自动请求百度进行判断 |
注意：响应码为负数，表示查验系统处理结果，其他为国税平台返回代码，此处未做修改。
其他返回参数：
|
content |
拼接好的国税平台返回结果 |
|
time |
当前时间戳 |
|
Try count |
验证码请求次数，用于判断系统稳定性 |
|
Vcode count |
验证码识别次数，用于判断识别模型准确性 |
|
Use time |
整个流程单次耗时，单位为毫秒 |
|
original data |
国税平台原始返回结果 |
- 使用发票四要素进行查验接口
接口地址：
请求参数：
|
序号 |
关键字 |
含义 |
是否为必需 |
|
1 |
fpdm |
发票代码 |
是 |
|
2 |
fphm |
发票号码 |
是 |
|
3 |
date |
开票日期 |
是 |
|
4 |
code |
校验码后6位或不含税金额 |
是 |
|
5 |
ip |
代理ip |
否 |
|
6 |
port |
代理端口 |
否 |
|
7 |
timeout |
超时时间，单位为毫秒 |
否 |
请求方式：GET/POST
同接口2 返回结果。
4、解析类说明
请根据系统返回的字段进行解析，以下仅为解析的说明，仅供参考：
发票类型01
|
字段 |
说明 |
备注 |
|
Hwxx |
货物信息 |
|
|
Bz |
备注 |
|
|
Hzxx |
红字信息 |
|
|
jshj |
价税合计 |
|
|
Je |
金额 |
|
|
Se |
税额 |
|
|
Kprq |
开票日期 |
|
|
xfsbh |
销方识别号 |
|
|
Xfmc |
销方名称 |
|
|
Cycs |
查验次数 |
|
|
Fphm_zp |
发票号码 |
|
|
Fpdm_zp |
发票代码 |
|
|
Fpcc_zp |
发票抬头信息，省份，发票大类型 |
|
|
Cysj |
查验时间 |
|
|
jqbh |
机器编号 |
|
|
Gfmc |
购方名称 |
|
|
Gfsbh |
购方识别号 |
|
|
Gfdzdh |
购方地址电话 |
|
|
Gfyhzh |
购方银行账号 |
|
|
Xfdzdh |
销方地址电话 |
|
|
Xfyhzh |
销方银行账号 |
|
|
Zfbz |
作废标志 |
作废、部分红冲、红冲、全额红冲、正常 |
发票类型02
|
字段 |
说明 |
备注 |
|
Fpdm |
发票代码 |
|
|
fphm |
发票号码 |
|
|
Fpcc |
发票抬头 |
|
|
Cycs |
查验次数 |
|
|
Kprq |
开票日期 |
|
|
Cyrmc |
承运人名称 |
|
|
cyrsbh |
承运人识别号 |
|
|
Spfmc |
实际受票方名称 |
|
|
Spfsbh |
实际受票方识别号 |
|
|
Shrmc |
收货人名称 |
|
|
Shrsbh |
收货人识别号 |
|
|
Fhrmc |
发货人名称 |
|
|
Fhrsbh |
发货人识别号 |
|
|
Hjje |
合计金额 |
|
|
Yshwxx |
运输货物信息 |
|
|
Qyd |
起运地 |
|
|
Sl |
税率 |
注意税率存在***，表免税 |
|
Se |
税额 |
|
|
Skph |
机器编号 |
|
|
Jshjxx |
价税合计 |
|
|
Czch |
车种车号 |
|
|
Ccdw |
车船吨位 |
|
|
Swjg_dm |
税务机关代码 |
|
|
Swjg_mc |
税务机关名称 |
|
|
Bz |
备注 |
|
|
Zfbz |
作废标志 |
发票类型03
|
字段 |
说明 |
备注 |
|
jshjxx |
价税合计信息 |
|
|
Cjfy |
不含税金额 |
拼音缩写不太对，有待核实 |
|
Zzsse |
增值税税额 |
|
|
Kprq |
开票日期 |
|
|
nsrsbh |
纳税人识别号 |
|
|
Cycs |
查验次数 |
|
|
Fpdm |
发票代码 |
|
|
Fphm |
发票号码 |
|
|
Fpcc |
发票抬头 |
|
|
Cysj |
查验时间 |
|
|
jddm |
机打代码 |
|
|
jdhm |
机打号码 |
|
|
Jqbm |
机器编码 |
|
|
Ghdw |
购货单位 |
|
|
Gfsbh |
购方识别号 |
|
|
Cllx |
车辆类型 |
|
|
Cpxh |
厂牌型号 |
|
|
cd |
产地 |
|
|
Hgzs |
合格证书 |
|
|
Sjdh |
商检单号 |
|
|
Fdjhm |
发动机号码 |
|
|
Cjhm |
车架号码 |
|
|
Jkzmsh |
进口证明书号 |
|
|
Xhdwmc |
销货单位名称 |
|
|
Dh |
电话 |
|
|
Zh |
账号 |
|
|
Dz |
地址 |
|
|
Khyh |
开户银行 |
|
|
Zzsl |
增值税率 |
|
|
Swjg_dm |
税务机构代码 |
|
|
Wspzhm |
完税凭证号码 |
|
|
Dw |
吨位 |
|
|
Xcrs |
限乘人数 |
|
|
Sfzhm |
身份证号码 |
|
|
Zfbz |
作废标志 |
发票类型04
|
字段 |
说明 |
备注 |
|
Bz |
备注 |
|
|
Hzxx |
红字信息 |
|
|
Hwxx |
货物信息 |
|
|
jshj |
价税合计 |
|
|
je |
金额 |
|
|
Se |
税额 |
|
|
Kprq |
开票日期 |
|
|
Xfsbh |
销方识别号 |
|
|
Cycs |
查验次数 |
|
|
Fpdm |
发票代码 |
|
|
Fphm |
发票号码 |
|
|
Fpcc |
发票抬头 |
发票省份、发票大类型 |
|
Cysj |
查验时间 |
|
|
Dkbz |
代开标志 |
|
|
Jqbh |
机器编号 |
|
|
Xfmc |
销方名称 |
|
|
Gfmc |
购方名称 |
|
|
Gfsbh |
购方识别号 |
|
|
xfdzdh |
销方地址电话 |
|
|
Xfyhzh |
销方银行账户 |
|
|
Gfdzdh |
购方地址电话 |
|
|
gfyhzh |
购方银行账户 |
|
|
Jym |
校验码 |
|
|
Zfbz |
作废标志 |
发票类型08
|
字段 |
说明 |
备注 |
|
Hzxx |
红字信息 |
|
|
Hwxx |
货物信息 |
|
|
Bz |
备注 |
|
|
Jshj |
加税合计 |
|
|
Je |
金额 |
|
|
Se |
税额 |
|
|
Kprq |
开票日期 |
|
|
Xfsbh |
销方识别号 |
|
|
Cycs |
查验次数 |
|
|
Fpdm |
发票代码 |
|
|
Fphm |
发票号码 |
|
|
Fpcc |
发票抬头 |
|
|
Cysj |
查验时间 |
|
|
Jqbh |
机器编号 |
|
|
Gfmc |
购方名称 |
|
|
Gfsbh |
购方识别号 |
|
|
Gfdzdh |
购方地址电话 |
|
|
Gdyhzh |
购方银行账户 |
|
|
Xfmc |
销方名称 |
|
|
Xfdzdh |
销方地址电话 |
|
|
xfyhzh |
销方银行账号 |
|
|
Jym |
校验码 |
|
|
Zfbz |
作废标志 |
|
|
Pdfurl |
Pdf下载地址 |
发票类型10
|
字段 |
说明 |
备注 |
|
Bz |
备注 |
|
|
Hzxx |
红字信息 |
|
|
jshj |
价税合计 |
|
|
Je |
金额 |
|
|
Se |
税额 |
|
|
Kprq |
开票日期 |
|
|
Xfsbh |
销方识别号 |
|
|
Cysj |
查验时间 |
|
|
Fpdm |
发票代码 |
|
|
Fphm |
发票号码 |
|
|
Fpcc |
发票抬头 |
发票省份、大类型 |
|
Cysj |
查验时间 |
|
|
Xfmc |
销方名称 |
|
|
Xfdzdh |
销方地址电话 |
|
|
Xfyhzh |
销方银行账号 |
|
|
Gfmc |
购方名称 |
|
|
Gfsbh |
购方识别号 |
|
|
gfyhzh |
购方银行账号 |
|
|
Jym |
校验码 |
|
|
Sbbh |
设备编号 |
|
|
Hwxx |
货物信息 |
|
|
Zfbz |
作废标志 |
发票类型11
|
字段 |
说明 |
备注 |
|
Hwxx |
货物信息 |
|
|
Hzxx |
红字信息 |
|
|
Bz |
备注 |
|
|
Jshj |
加税合计 |
|
|
Kprq |
开票日期 |
|
|
Xfsh |
销方税号 |
|
|
Cycs |
查验次数 |
|
|
Fpdm |
发票代码 |
|
|
Fphm |
发票号码 |
|
|
Fpcc |
发票抬头 |
发票身份、大类型 |
|
Cysj |
查验时间 |
|
|
Xfmc |
销方名称 |
|
|
Gfmc |
购方名称 |
|
|
Gfsh |
购方税号 |
|
|
Sbbh |
设备编号 |
|
|
Jym |
校验码 |
|
|
Sky |
收款员z |
|
|
zfbz |
作废标志 |
发票类型14
|
字段 |
说明 |
备注 |
|
Hzxx |
红字信息 |
|
|
Hwxx |
货物信息 |
|
|
Jshj |
价税合计 |
|
|
je |
金额 |
|
|
Se |
税额 |
|
|
Kprq |
开票日期 |
|
|
Xfsbh |
销方识别号 |
|
|
Cycs |
查验次数 |
|
|
Fpdm |
发票代码 |
|
|
Fphm |
发票号码 |
|
|
Fpcc |
发票抬头 |
发票省份、大类型 |
|
Cysj |
查验时间 |
|
|
Jqbh |
机器编号 |
|
|
Xfmc |
销方名称 |
|
|
Xfdzdh |
销方地址电话 |
|
|
Xfyhzh |
销方银行账户 |
|
|
Gfmc |
购方名称 |
|
|
Gfsbh |
购方识别号 |
|
|
Gfdzdh |
购方地址电话 |
|
|
Gfyhzh |
购方银行账号 |
|
|
Jym |
校验码 |
|
|
Bz |
备注 |
|
|
Zfbz |
作废标志 |
发票类型15
|
字段 |
说明 |
备注 |
|
Hzxxx |
红字信息 |
|
|
Cycs |
查验次数 |
|
|
Fpdm |
发票代码 |
|
|
Fphm |
发票号码 |
|
|
Fpcc |
发票抬头 |
发票省份、大类型 |
|
Cysj |
查验时间 |
|
|
Kprq |
开票日期 |
|
|
Jddm |
机打代码 |
|
|
Jdhm |
机打号码 |
|
|
Mfmc |
买方名称 |
|
|
mfdm |
买方代码 |
|
|
Mfdz |
买方地址 |
|
|
Mfdh |
买方电话 |
|
|
Xfmc |
销方名称 |
|
|
Xfdm |
销方代码 |
|
|
Xfdz |
销方地址 |
|
|
Xfdh |
销方电话 |
|
|
Cpzh |
车牌照号 |
|
|
Djzhm |
登记证号 |
|
|
Cllx |
车辆类型 |
|
|
clsbdm |
车辆识别代码 |
|
|
Cpxh |
厂牌型号 |
|
|
Zrcgs |
转入车管所 |
|
|
Cjhj |
车价合计 |
|
|
Jydw |
经营、拍卖单位 |
|
|
jydwsbh |
经营拍卖单位识别号 |
|
|
Jydwyhzh |
经营单位银行账户 |
|
|
jydwdh |
经营单位电话 |
|
|
Jydwdz |
经营单位地址 |
|
|
Escsc |
二手车市场 |
|
|
escscsbh |
二手车市场识别号 |
|
|
Escscdz |
二手车市场地址 |
|
|
Escscyhzh |
二手车市场银行账号 |
|
|
Escscdh |
二手车市场电话 |
|
|
Bz |
备注 |
|
|
Zfbz |
作废标志 |
特别注意：所有字段名都是小写，具体以实际为准，上表中首字母大写为word问题。
当作废标志为作废时，建议再次请求用于判断，如果为正常基本都是正确数据。
- 配置文件说明
|
序号 |
键值 |
含义 |
|
1 |
url |
内网ip及其端口，详见示例http://127.0.0.1:9898 |
|
2 |
deal |
是否解析发票信息，值为true或者false |
|
3 |
testProxy |
是否在使用代理前测试代理，测试耗时，谨慎开启，值为true或者false |
|
4 |
timeOut |
全局超时时间，单位为毫秒，如4000 |
|
5 |
log |
是否记录全部信息，值为true或者false |
