阿里云-增值税发票识别

增值税发票识别

接口地址：http://route.showapi.com/2010-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 

参数名称	类型	默认值	示例值	必须	描述
img	String			否	图像数据：base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px，支持jpg/png/bmp格式，和url参数只能同时存在一个
url	String		https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/wjy/%E5%8F%91%E7%A5%A8.jpg	否	图像url地址：图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px，支持jpg/png/bmp格式，和img参数只能同时存在一个

请求示例：String res=new ShowApiRequest("http://route.showapi.com/2010-1","my_appId","my_appSecret") .addTextPara("img","") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/wjy/%E5%8F%91%E7%A5%A8.jpg") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
sid	String	4ae0bc9d524970ce52bdf4a458908856f9a3fb77c6c3697cf2667a297b773a3d0b7c69d7	请求id
data	Object		返回数据
-  发票代码	String	110xxx0	发票代码
-  发票号码	String	876xxx	发票号码
-  开票日期	String	2010年11月18日	开票日期
-  校验码	String		校验码
-  发票金额	String	7018.83	发票金额
-  大写金额	String	7018.83	大写金额
-  发票税额	String	1019.83	发票税额
-  不含税金额	String	5999.00	不含税金额
-  受票方名称	String	剧试购xxx业	受票方名称
-  受票方税号	String	410xxx456789	受票方税号
-  受票方地址、电话	String	北京市xxx81234567	受票方地址、电话
-  受票方开户行、账号	String	建行-000012345678	受票方开户行、账号
-  销售方名称	String	测试销方企业	销售方名称
-  销售方税号	String	410305012345678	销售方税号
-  销售方地址、电话	String	北京市海淀xxxxx744xxx	销售方地址、电话
-  销售方开户行、账号	String	工行1xxxx-234xxx56111	销售方开户行、账号
-  联次	String	第二联：抵扣联	联次
-  发票类型	String	专用发票	发票类型
-  发票详单	Object[]		发票详单
-  0	Object
-  货物或应税劳务、服务名称	String	计算机
-  规格型号	String	A6100
-  单位	String	台
-  数量	String
-  单价	String	5999.00
-  金额	String	5999.00
-  税率	String	17%
-  税额	String	1019.83
angle	Number	0	角度
height	Number	519	读光处理后的图片高度
width	Number	888	读光处理后的图片宽度
orgHeight	Number	519	原图图片高度
orgWidth	Number	888	原图图片宽度
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "c99bcbdf4fa343719febacbfbaf18a63", "showapi_res_code": 0, "showapi_res_body": { "sid": "4ae0bc9d524970ce52bdf4a458908856f9a3fb77c6c3697cf2667a297b773a3d0b7c69d7", "data": { "发票代码": "110xxx0", "发票号码": "876xxx", "开票日期": "2010年11月18日", "校验码": "", "发票金额": "7018.83", "大写金额": "7018.83", "发票税额": "1019.83", "不含税金额": "5999.00", "受票方名称": "剧试购xxx业", "受票方税号": "410xxx456789", "受票方地址、电话": "北京市xxx81234567", "受票方开户行、账号": "建行-000012345678", "销售方名称": "测试销方企业", "销售方税号": "410305012345678", "销售方地址、电话": "北京市海淀xxxxx744xxx", "销售方开户行、账号": "工行1xxxx-234xxx56111", "联次": "第二联：抵扣联", "发票类型": "专用发票", "发票详单": [ { "货物或应税劳务、服务名称": "计算机", "规格型号": "A6100", "单位": "台", "数量": "", "单价": "5999.00", "金额": "5999.00", "税率": "17%", "税额": "1019.83" } ] }, "angle": 0, "height": 519, "width": 888, "orgHeight": 519, "orgWidth": 888 } }