国税发票查验系统接口文档

1. 验证码识别接口（这里以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对应

1. 使用发票四要素、验证码、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	国税平台原始返回结果

1. 使用发票四要素进行查验接口

接口地址：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. 配置文件说明

序号	键值	含义
1	url	内网ip及其端口，详见示例http://127.0.0.1:9898
2	deal	是否解析发票信息，值为true或者false
3	testProxy	是否在使用代理前测试代理，测试耗时，谨慎开启，值为true或者false
4	timeOut	全局超时时间，单位为毫秒，如4000
5	log	是否记录全部信息，值为true或者false