国税发票查验系统接口文档
- 验证码识别接口(这里以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 |
国税发票查验系统接口文档相关推荐
- 国税局发票查验API接口文档说明
1 请求参数和请求地址 该接口通过RPA机器人技术进行查验. 校验项目说明如下: 增值税电子普通发票10.增值税普通发票04.增值税普通发票(卷票)11.增值税电子普通发票(通行费)14,这四种发票使 ...
- Zabbix系统接口文档
Zabbix系统接口文档 (V1.0) 2018.3 注:已上传word版,如需下载请前往https://download.cs ...
- 国税发票查验API接口说明
目录 1.请求地址与数据项说明 1.1. 请求说明 1.2. other项说明 1.3. 支持发票类型[fpzl] 1.4. 发票状态说明[fpzt] 1.5. 票种标志说明[pzbz] 2. 响应报 ...
- 全电发票开票API接口文档
所有接口通用的请求格式 HTTP请求URL https://fpkj.market.alicloudapi.com/kpgl/fpkj 请求方式 POST 接口请求头部信息ContentType ap ...
- 商品库存推送至外部系统API接口文档
没有与外部系统对接,商品库存数据不通?往下看看 电商API文档---点击查看!http://ds.xnxxxk.cn/apijk?comefrom=CSDN&plan=kucuntongbu1 ...
- 驰骋工作流引擎与第三方系统的接口文档For 山东金义
驰骋工作流引擎与第三方系统的接口文档For 山东金义 驰骋BPM要与第3方系统的接口主要有发起.待办.在途.查询4个菜单,如果被集成的系统由于风格问题需要自己生成发起,待办,在途三个页面,最有效的办法 ...
- 基于 apidoc 生成在线接口文档 (实时更新)(linux系统)
基于 apidoc 生成在线接口文档 (实时更新)(linux系统) 动态加载,热部署 背景: 规范开发人员的接口文档 文档统一管理,防止本地文档版本不统一 远程部署,保证文档的统一性 主要还是解决, ...
- 三网话费、充值系统搭建、电费充值API接口文档
一.文档综述 近期想做项目的看过来~三网(全国移动.联通.电信)话费.电费充值接口能够实现将接口接入到公众号或者app上面,通过接口提交号码和金额进行充值,可以帮助相关人员快速完成接口对接与联调,平台 ...
- IT隐匿者官方解析系统API接口文档
IT隐匿者官方解析系统API接口文档 简要描述: 需要到平台注册自己账号,然后开通会员权限,就有自己的api接口 平台地址:IT隐匿者解析系统 接口只能用于自己的产品,禁止打包外售或与其他人共用,发现 ...
最新文章
- 哈尔滨工业大学计算机改专业课,哈尔滨工业大学计算机专业课 复试 2013HITCS
- Alibaba Java诊断利器Arthas实践--使用redefine排查应用奇怪的日志来源
- 如何用css实现等高布局。
- 【数理知识】《数值分析》李庆扬老师-第9章-常微分方程初值问题数值解法
- javascript --- 异步按顺序执行
- mvc html validator,ASP.NET MVC实现Validation验证器扩展
- 身高2m,体重2kg,这样的数据“看上去很好”?
- 多功能网址导航源码 包含交易系统等多功能
- SSH Secure Shell Client中文乱码的解决办法
- Linux系统Load average负载详细解释
- SQL Server 2014,表变量上的非聚集索引
- 《模式识别与机器学习》 简称 PRML 开源了
- PHP购物网站(含购物车、全部源码、数据库设计表及其源码)
- 小游戏---java版2048(2048 go go go)
- 太赞!机器学习、深度学习绘图模板.ppt
- 计网——计算机网络和互联网
- mysql数据库授权,备份,恢复_wuli大世界_新浪博客
- 这可能是知乎中,最好的项目管理书单!
- 理财通app的设计与实现(六)
- vue项目引入vue-i18n,实现中英文切换
热门文章
- 3296电位器调节工具
- worm/spybot_周末娱乐:在Spybot中搜索和销毁复活节彩蛋
- 网上计算机书店折扣“战火”烧
- 国外巨头苹果对国内小程序厂商的无情收割——Apple Clips,苹果主推亲儿子苹果小程序
- git cherry-pick冲突解决
- springData中的@Query注解及@Modifying注解
- 【微信公众号模板消息First,Remark字段不显示】
- 17 柯西中值定理、不定式极限
- 让android手机崩溃的壁纸,一张壁纸导致安卓手机崩溃作者首发声:绝非故意
- Svn 取消revert