发票验真API开发文档

一、接口简介
1、版权说明：
未经翔云人工智能开放平台授权，不得擅自进行使用。
2、调用客户端运行环境
当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。
3、服务主要功能描述
翔云发票验真服务，实时联网核查验5年内增值税发票管理系统开具的发票，如果发票为真则返回全票面信息，可查询票种包含：增值税专用发票、增值税电子专用发票、增值税普通发票（折叠票）、增值税普通发票（卷票）、增值税电子普通发票（含收费公路通行费增值税电子普通发票）、机动车销售统一发票、二手车销售统一发票。

通过https协议post方法上传发票要素信息；
将查验结果以XML或json格式返回给用户；
4、服务调用约束
请您在调用发票识别接口前，确保客户端程序或设备网络连接通畅，如使用发票识别接口自动提取发票要素信息，要求发票图像文件大小在200KB左右，扫描图像建议分辨率为300DPI，图像小于3M，电子发票请上传PDF格式。
二、前提准备
1、用户登录 https://www.netocr.com/register.html注册账号，如图:
2、输入注册信息，确认无误后点击同意条款并注册，如图:

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

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

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

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

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

三、接口说明
接口地址，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 未知错误
返回结果字符串
标签显示了识别状态，大于等于“0”代表识别成功【“0”代表查询成功，“1”代表未查到数据，“2”代表查询失败】，小于“0”代表识别失败，失败的原因在中描述。
调用错误码
status值描述
-1 用户已屏蔽
-2 用户key或secret验证错误
-3 服务次数不足
-4 用户未找到
-6 系统异常
-7 图片不可为空，参数不可为空
-8 类型错误
调用方式(java客户端基于httpclient4.3)
1.依赖库: \java客户端\httpClient4.3库\，如图:

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

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

执行main方法返回结果如下：
增值税发票：

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

发票验真API开发文档相关推荐

不动产登记证识别API开发文档
不动产登记证识别API开发文档一.接口简介 1.版权说明: 未经翔云人工智能开放平台授权,不得擅自进行使用. 2.调用客户端运行环境当客户端使用的编程语言为Java时,请使用1.5及以上版本JRE ...
手机号实名认证增强版API开发文档
手机号实名认证增强版API开发文档一.接口简介 1.版权说明: 未经翔云人工智能开放平台授权,不得擅自进行使用. 2.调用客户端运行环境当客户端使用的编程语言为Java时,请使用1.5及以上版本J ...
银行卡实名认证标准版API开发文档
银行卡实名认证标准版API开发文档一.接口简介 1.版权说明: 未经翔云人工智能开放平台授权,不得擅自进行使用. 2.调用客户端运行环境当客户端使用的编程语言为Java时,请使用1.5及以上版本J ...
银行卡实名认证增强版API开发文档
银行卡实名认证增强版API开发文档一.接口简介 1.版权说明: 未经翔云人工智能开放平台授权,不得擅自进行使用. 2.调用客户端运行环境当客户端使用的编程语言为Java时,请使用1.5及以上版本J ...
最新抖音快手小红书西瓜全平台解析接口api开发文档
简介:从短视频平台APP中复制出来的分享链接,通过接口获取或通过主页在线一键解析获取短视频中的:视频标题.视频封面.无水印视频地址.图集列表等参数信息接口地址: https://eeapi.cn/ ...
ujquery.fancybox api开发文档中文翻译版
2016年11月17日11:57:14 基础使用 http://fancybox.net/howto 1. 首先,请确保您使用的是有效的DOCTYPE这是FancyBox看起来和功能正确需要. 2. ...
发票查验|身份证实名认证增强版API开发文档
一.接口简介 1.版权说明: 未经翔云人工智能开放平台授权,不得擅自进行使用. 2.调用客户端运行环境当客户端使用的编程语言为Java时,请使用1.5及以上版本JRE. 3.服务主要功能描述翔云身 ...
发票识别+发票验真API：告别手动录入
现如今,企业每一个大大小小的项目,都可能会收到供应商开具的发票,有时候甚至一个项目就会产生数以千计的发票数量.而发票作为第二"钞票",是业务往来中重要的支付凭证,因此每一张发票,无 ...
如何下载API开发文档
首先进入API下载官方网址:https://www.oracle.com/java/technologies/javase-downloads.html 然后下拉,寻找自己需要的版本点击Documen ...
php js sdk 签名算法,签名算法 · PAYJS API 开发文档
签名算法 PAYJS 签名算法与微信官方签名算法一致签名生成的通用步骤如下: 设所有发送或者接收到的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序(字典序),使用URL键 ...

发票验真API开发文档

发票验真API开发文档相关推荐

最新文章

热门文章