商务合作联系QQ:360355056或微信号:talkandstop
- 验证码识别接口(这里以127.0.0.1为例,端口9898,实际请替换服务器公网IP或网址,如为服务器本地调用,则保留为127.0.0.1;实际端口以服务器开放端口为准)
接口地址:http://127.0.0.1:9898/getVercode
请求参数:
序号 |
关键字 |
含义 |
是否为必需 |
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请求国税查验结果接口
接口地址:http://127.0.0.1:9898/getInvoiceInfo
请求参数:
序号 |
关键字 |
含义 |
是否为必需 |
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 |
国税平台原始返回结果 |
- 使用发票四要素进行查验接口
接口地址:http://127.0.0.1:9898/queryInfo
请求参数:
序号 |
关键字 |
含义 |
是否为必需 |
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 |