国税发票查验|一种简单的发票验真API开发文档

小太阳

一、接口简介

1、版权说明：

未经翔云人工智能开放平台授权，不得擅自进行使用。

2、调用客户端运行环境

当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。

3、服务主要功能描述

翔云发票验真服务，实时联网核查验5年内增值税发票管理系统开具的发票，如果发票为真则返回全票面信息，可查询票种包含：增值税专用发票、增值税电子专用发票、增值税普通发票（折叠票）、增值税普通发票（卷票）、增值税电子普通发票（含收费公路通行费增值税电子普通发票）、机动车销售统一发票、二手车销售统一发票。

1) 通过https协议post方法上传发票要素信息；

2) 将查验结果以XML或json格式返回给用户；

4、服务调用约束

请您在调用发票识别接口前，确保客户端程序或设备网络连接通畅，如使用发票识别接口自动提取发票要素信息，要求发票图像文件大小在200KB左右，扫描图像建议分辨率为300DPI，图像小于3M，电子发票请上传PDF格式。

二、前提准备

1、用户登录 https://www.netocr.com/register.html注册账号，如图:

2、输入注册信息，确认无误后点击同意条款并注册，如图:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps1.jpg

3、注册成功后点击右上角的账号名称-个人中心，进入管理页面:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps2.jpg

4、点击“用户管理-基础信息”，查看OCRKey以及OCRSecret：

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps3.jpg

5、点击“服务列表”，查看服务次数及余额(每调用一次https接口消耗一次)，可点击立即购买直接跳转到购买页面购买API服务次数：

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps4.jpg

6、购买成功后,会显示购买的总次数及剩余次数，例如下图所示：

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps5.jpg

7、设置剩余条数提醒，进入个人中心-用户管理-剩余条数提醒，设置提醒下线、通知手机号及服务类型，设置成功后到达用户设置的服务剩余条数下限，系统会发短息至预留手机号。

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps6.jpg

三、接口说明

接口地址，https://netocr.com/verapi/verInvoice.do

接口调用方法：post

3、请求参数

接口说明
接口地址：			https://netocr.com/verapi/verInvoice.do
接口调用方法：			post
接口接收参数：
序号	名称			类型		必填		说明
1	key			String		是		用户ocrKey
2	secret			String		是		用户ocrSecrert
3	invoiceCode			String		是		发票代码
4	invoiceNumber			String		是		发票号码
5	billingDate			String		是		开票日期：YYYY-MM-DD
6	totalAmount			String		是		合计金额（不含税），必须精确到两位小数（专票、货运专票、机动车专票必填）
7	checkCode			String		是		校验码后6位（普票、电子普票、卷式普票必填）
8	salesTaxNo			String		否		销方税号（区块链必填）
9	typeId			Integer		是		发票验真：3007
10	format			String		是		返回格式(xml或者json)，如果format为空，则默认返回xml
接口返回值参数说明：
序号		名称					类型		说明
1		invoiceType					String		发票类型 增值税专用发票　　　　　　01 货运运输业增值税专用发票　02 机动车销售统一发票　　　　03 增值税普通发票　　　　　　04 增值税普通发票（电子）　　10 增值税普通发票（卷式）　　11 增值税普通发票（通行费）　14 二手车销售统一发票        15
2		administrativeDivisionName					String		所属行政区名称
3		invoiceCode					String		发票代码
4		invoiceNumber					String		发票号码
5		billingDate					String		开票日期：YYYY-MM-DD
6		purchaserName					String		购方名称
7		purchaserTaxNo					String		购方税号
8		purchaserBank					String		购方开户行账户
9		purchaserAddressPhone					String		购方地址电话
10		salesName					String		销方名称
11		salesTaxNo					String		销方税号
12		salesAddressPhone					String		销方地址电话
13		salesBank					String		销方开户行账户
14		totalAmount					String		合计金额
15		totalTax					String		合计税额
16		amountTax					String		价税合计
17		amountTaxCN					String		价税合计_中文
18		remarks					String		备注
19		machineCode					String		机器编码
20		checkCode					String		校验码
21		state					String		发票状态 未作废　1 作废　　2
22		invoiceList					String		发票详细信息列表
23		commodityName					String		货物或应税劳务名称
24		specificationMode					String		规格型号
25		unit					String		单位
26		quantity					String		数量
27		unitPrice					String		单价
28		amount					String		金额
29		taxRate					String		税率
30		tax					String		税额
31		carrierName					String		承运人名称
32		carrierTaxNo					String		承运人识别号
33		draweeName					String		受票方名称
34		draweeTaxNo					String		受票方识别号
35		cargoInformation					String		运输货物信息
36		transportRoute					String		起运地、经由、到达地
37		machineCode					String		税控盘号
38		automobileType					String		车种车号
39		tonnage					String		车船吨位
40		taxAuthorityNo					String		主管税务机关
41		taxAuthorityName					String		主管税务名称
42		remarks					String		备注
43		iDCardNo					String		身份证号码/组织机构代码
44		purchaserTaxNo					String		购方税号
46		vehicleType					String		车辆类型
46		brandModel					String		厂牌型号
47		originPlace					String		产地
48		certificateNo					String		合格证号
49		inspectionListNo					String		商检单号
50		engineNo					String		发动机号
51		vehicleNo					String		车辆识别代号/车架号码
52		importCertificateNo					String		进口证明书号
53		salesPhone					String		销方地址电话
54		salesTaxNo					String		销方税号
55		salesBankNo					String		账号
56		salesAddress					String		销方地址
57		paymentVoucherNo					String		完税凭证号码
58		passengersLimited					String		限乘人数
状态码说明：
status					code		message
					2		查验成功发票一致（扣费）
					5		请求不合法
					6		发票信息不一致
					9		所查发票不存在
					20		超过该张票当天查验次数
					30+code		该票在本平台核验失败已超5次（扣费）
					1004		已超过最大查验量
					1005		查询发票不规范
					1006		查验异常
					1008		参数不能为空
					1009		参数长度不正确
					1014		日期当天的不能查验
					1015		超过一年的不能查验
					1021		网络超时
					100000		缺少参数
					100001		参数取值范围错误
					100005		请求过于频繁
					100006		远程访问错误
					100010		请求超时
					60		未知错误

返回结果字符串
<status/>标签显示了识别状态，大于等于“0”代表识别成功【“0”代表查询成功，“1”代表未查到数据，“2”代表查询失败】，小于“0”代表识别失败，失败的原因在<value/>中描述。

调用错误码

status值	描述
-1	用户已屏蔽
-2	用户key或secret验证错误
-3	服务次数不足
-4	用户未找到
-6	系统异常
-7	图片不可为空，参数不可为空
-8	类型错误

调用方式(java客户端基于httpclient4.3)
1.依赖库: \java客户端\httpClient4.3库\，如图:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps7.png

2.示例程序代码详见: \java客户端\httpClientDemo\中的Client类，如图:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps8.png

在main方法定义参数，并传入   doPost(url, file, key, secret, typeId, format) 方法中。如图:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps9.png

执行main方法返回结果如下：

增值税发票：

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps10.jpg

剩余条数查询接口(所有产品类型)

接口地址：	https://netocr.com/api/accountLift.do
接口调用方法：	post
接口接收参数：
String key：	用户ocrKey
String secret：	用户ocrSecret
String format：	返回格式(xml或者json)，如果format为空，则默认返回xml