国税发票查验|一种简单的发票验真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
接口接收参数：
序号名称类型必填说明
1keyString是用户ocrKey
2secretString是用户ocrSecrert
3invoiceCodeString是发票代码
4invoiceNumberString是发票号码
5billingDateString是开票日期：YYYY-MM-DD
6totalAmountString是合计金额（不含税），必须精确到两位小数（专票、货运专票、机动车专票必填）
7checkCodeString是校验码后6位（普票、电子普票、卷式普票必填）
8salesTaxNoString否销方税号（区块链必填）
9typeIdInteger是发票验真：3007
10formatString是返回格式(xml或者json)，如果format为空，则默认返回xml
接口返回值参数说明：
序号名称类型说明
1invoiceTypeString发票类型
增值税专用发票 01
货运运输业增值税专用发票 02
机动车销售统一发票 03
增值税普通发票 04
增值税普通发票（电子） 10
增值税普通发票（卷式） 11
增值税普通发票（通行费） 14
二手车销售统一发票 15
2administrativeDivisionNameString所属行政区名称
3invoiceCodeString发票代码
4invoiceNumberString发票号码
5billingDateString开票日期：YYYY-MM-DD
6purchaserNameString购方名称
7purchaserTaxNoString购方税号
8purchaserBankString购方开户行账户
9purchaserAddressPhoneString购方地址电话
10salesNameString销方名称
11salesTaxNoString销方税号
12salesAddressPhoneString销方地址电话
13salesBankString销方开户行账户
14totalAmountString合计金额
15totalTaxString合计税额
16amountTaxString价税合计
17amountTaxCNString价税合计_中文
18remarksString备注
19machineCodeString机器编码
20checkCodeString校验码
21stateString发票状态
未作废 1
作废 2
22invoiceListString发票详细信息列表
23commodityNameString货物或应税劳务名称
24specificationModeString规格型号
25unitString单位
26quantityString数量
27unitPriceString单价
28amountString金额
29taxRateString税率
30taxString税额
31carrierNameString承运人名称
32carrierTaxNoString承运人识别号
33draweeNameString受票方名称
34draweeTaxNoString受票方识别号
35cargoInformationString运输货物信息
36transportRouteString起运地、经由、到达地
37machineCodeString税控盘号
38automobileTypeString车种车号
39tonnageString车船吨位
40taxAuthorityNoString主管税务机关
41taxAuthorityNameString主管税务名称
42remarksString备注
43iDCardNoString身份证号码/组织机构代码
44purchaserTaxNoString购方税号
46vehicleTypeString车辆类型
46brandModelString厂牌型号
47originPlaceString产地
48certificateNoString合格证号
49inspectionListNoString商检单号
50engineNoString发动机号
51vehicleNoString车辆识别代号/车架号码
52importCertificateNoString进口证明书号
53salesPhoneString销方地址电话
54salesTaxNoString销方税号
55salesBankNoString账号
56salesAddressString销方地址
57paymentVoucherNoString完税凭证号码
58passengersLimitedString限乘人数
状态码说明：
statuscodemessage
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
页:
[1]