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

  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

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 2
    评论
### 回答1: 国税局发票查验API接口文档说明是一份重要的文档,它对于开发人员实现发票查验功能非常有帮助。该文档详细说明了API接口的调用方法和参数格式,包括请求参数、响应参数、错误码等信息,以便开发人员进行接入和调试工作。 该文档中,请求参数包括发票代码、发票号码、开日期、金额等信息,开发人员需要按照规定格式进行传输。响应参数中包括了发票的相关信息,如发票种类、购买方名称、税号、开日期、发票代码、发票号码、发票金额等。 API接口中还包括了错误码,响应结果中如果出现错误,会返回对应的错误码和错误信息,为开发人员进行问题排查提供了便利。 总之,国税局发票查验API接口文档说明提供了详细的接口调用流程和规则,为开发人员实现发票查验功能提供了指导和支持。 ### 回答2: 国税局发票查验api接口文档提供了开发者用于接入国税局发票查验系统的标准接口,以便于开发者可以使用该接口来进行发票查验工作。 该接口文档由国税局统一制定并发布,内容主要包括接口说明、请求方式、参数说明、响应参数等内容,开发者可根据接口文档进行程序开发。在接入国税局发票查验系统时,需要先向国税局申请接口授权码,并使用授权码进行访问。 使用该API接口可以实现方便快捷的发票查询工作,可以节省用户的时间和精力。同时,该接口具有高可用性、高安全性等优点,可以确保信息安全及时性、准确性。 总之,国税局发票查验API接口文档说明为开发者提供了标准的接入国税局发票查验系统的方式,并为发票查验工作的实施提供了便利。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

onedayismyway

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值