OCR增值税发票识别

OCR增值税发票识别

接口地址：http://route.showapi.com/1782-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_data	String			是	图片base64字符串

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1782-1","my_appId","my_appSecret") .addTextPara("img_data","") .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数据结构）： 展开收起 

名称	类型	示例值	描述
ret_code	String	0	接口调用是否成功,0为成功,其他为失败
remark	String	识别成功！	提示信息
invoice_code	String		发票代码
invoice_no	String		发票号码
invoice_date	String		开票日期
goods	String		货物或服务名称
payer_addr_tell	String		金额明细
payer_bank_account	String		购买方开户行及账号
payer_name	String		购买方名称
price_list	String		金额明细
payer_id	String		购买方纳税人识别号
seller_addr_tell	String		销售方地址电话
seller_bank_account	String		销售方开户行及账号
seller_id	String		销售方纳税人识别号
seller_name	String		销售方名称
tax_list	String		税额明细
tax_rate_list	String		税率明细
tax_total	String		税额合计
total	String		合计
total_cover_tax	String		价税合计大写
total_cover_tax_digits	String		价税合计小写
total_note	String		备注
type	String		发票状态
special_flag	String		是否为专票
...

返回示例：{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "payer_addr_tell": " 北京市西城区广安门内岳峰园3区1号京安友情馆8005010-62667878", "invoice_code": "4300171130", "invoice_date": "2018年01月15日", "goods": "*石油制品*车用油\n*石油制品*车用油\n*合成液体燃料*车用油\n*石油制品*车用油\n*石油制品*车用油\n*石油制品*车用油", "invoice_no": "02550485", "payer_bank_account": "招商银行股份有限公司北京上地支行110917823410701", "payer_id": "911101023513172379", "payer_name": "中启行物联科技(北京)有限公司", "price_list": "4958.76\n2531.25\n278.83\n1778.15\n762.66\n235.78", "seller_addr_tell": " 湖南省长沙市芙蓉北路388号0731-84205588", "seller_bank_account": "中国银行湖南省分行营业部582066019635", "seller_id": "91430100717079385W", "seller_name": "中国石化销售有限公司湖南长沙石油分公司", "special_flag": "专票", "tax_list": "842.99\n430.31\n47.40\n302.29\n129.65\n40.08", "tax_rate_list": "17%\n17%\n17%\n17%\n17%\n17%", "tax_total": "¥1792.72", "total": "¥10545.43", "total_cover_tax": "壹万贰仟叁佰叁拾捌圆壹角伍分", "total_cover_tax_digits": "¥12338.15", "total_note": "5363607:", "type": "非电子发票", "remark": "识别成功！", "ret_code": "0" } }