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

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. 使用发票四要素进行查验接口

接口地址：