首页 > 其他分享 >国税发票查验系统接口文档

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

时间:2024-10-08 10:34:29浏览次数:5  
标签:查验 识别 验证码 文档 发票 国税发 销方 购方

​商务合作联系QQ:360355056或微信号:talkandstop

  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

标签:查验,识别,验证码,文档,发票,国税发,销方,购方
From: https://www.cnblogs.com/onedayismway/p/18451193

相关文章

  • [Markdown] Markdown 及文档格式转换
    1概述:MarkdownMarkdown的诞生什么是Markdown?Markdown的诞生初衷Markdown是一种用于编写结构化文档的纯文本格式,基于在电子邮件和usenet帖子中指示格式的约定。它由JohnGruber开发(在AaronSwartz的帮助下),并于2004年以语法描述和用于将Markdown转换为......
  • 如何去除Windows10文件资源管理器上的6个文件夹:桌面、视频、图片、文档、下载、音乐和
    尽管 Win10 提供了迄今为止最先进和丰富的功能,但并不是每一个人都希望其预装那么多的组件。长期以来,微软通常会在Windows资源管理器中包含6个“桌面、文档、下载、音乐、图片和视频”的默认存储位置。在2017年10月的“秋季创意者更新”之后,它又增加了“3D对象”。其旨在为......
  • 基于java+springboot的医院预约挂号系统小程序(源码+lw+部署文档+讲解等)
    课题简介医院预约挂号系统基于Java和SpringBoot开发,是改善医疗服务流程、提高患者就医体验的重要工具。该系统利用Java的稳定性和强大性能,以及SpringBoot的便捷开发框架,确保系统可靠运行和易于维护。它包含了患者信息管理、医生信息管理、科室信息管理、预约管......
  • 基于java+springboot的医学电子技术线上翻转课堂系统(源码+lw+部署文档+讲解等)
    课题简介医学电子技术线上翻转课堂系统基于Java和SpringBoot开发,是为医学教育领域量身打造的创新教学平台。该系统借助Java的稳定性和强大性能,以及SpringBoot的高效开发特性,确保系统能够稳定运行且易于维护和扩展。它涵盖了丰富的功能模块,包括课程资源管理、学......
  • 基于java+springboot的医疗设备管理系统(源码+lw+部署文档+讲解等)
    课题简介医疗设备管理系统基于Java和SpringBoot开发,是专为医疗机构设计的全面高效的设备管理解决方案。该系统利用Java的稳定性和强大性能,以及SpringBoot的便捷开发框架,确保系统可靠运行和易于维护。它涵盖了设备信息管理、采购管理、库存管理、维修管理、报废......
  • 基于微信小程序的大学生就业平台-计算机毕业设计源码+LW文档
    摘要随着计算机技术的成熟,互联网的建立,如今,PC平台上有许多关于大学生就业方面的程序,但由于使用时间和地点上的限制,用户在使用上存在着种种不方便,而开发一款大学生就业平台微信小程序,能够有效地解决这个问题。本文主要介绍了大学生就业平台微信小程序的开发过程,对开发环境、系统......
  • 说明文档
    这篇文档主要介绍《基于YOLOv8的农田病虫害检测与分析》的代码实现部分,整篇论文的目的主要是改进YOLOv8的网络结构,使其在检测病虫害的精度和实时性上有所提升。接下来,我将介绍如何从零开始搭建起本项目。安装Python到python的官方网站:https://www.python.org/下载,安装安装完......
  • 基于SpringBoot+Vue+协同过滤算法的音乐推荐系统设计与实现(源码+论文+PPT+部署文档教
    具体实现截图网站首页页面主要包括系统首页、热门歌曲、音乐资讯、留言板、个人中心等内容,并根据需要进行详细操作;如图5-1所示:图5-1网站首页界面图在注册流程中,用户在Vue前端填写必要信息(如用户名、密码等)并提交。前端将这些信息通过HTTP请求发送到Java后端。后端处理......
  • 基于Hadoop+Scrapy爬虫+可视化大屏分析的大型超市进销存系统设计与实现(源码+lw+部署
    具体实现截图大型超市数据处理系统5.1前台用户功能实现当游客打开系统的网址后,首先看到的就是首页界面。在这里,游客能够看到大型超市数据处理系统的导航条显示首页、生鲜信息、系统公告、留言反馈、个人中心等。系统首页界面如图5-1所示:图5-1系统首页界面这是一个用户注册的......
  • Java Doc 生成文档
    packagecom.div.Base;/***@authorWendy*@version1.0*@since1.8*/publicclassDoc01{Stringname;//属性/***@authorWendy*@paramname*@return*@throwsException*/publi......