文档中心 > API类目 > 电子发票

alibaba.einvoice.income.ocr.return (服务商回传发票ocr的结果)

服务商回传发票ocr的结果,分两种场景:扫描驱动服务商主动回传;阿里主动发起的ocr回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
checksum String 可选 02789374837498234 校验码,ocr结果为普票,success=true并且invoiceKind=1时必填
error_code String 可选 001 错误码,success=false是必填
error_message String 可选 无效的发票 错误消息,success=false是必填
image_data byte[] 可选 010101010001 发票ocr影像文件,type=1时必填
image_id String 可选 1 发票ocr影像编号,type=1时必填
invoice_code String 可选 1001022020 发票代码,success=true时必填
invoice_date String 可选 2018-08-01 开票日期,格式为yyyy-MM-dd,success=true时必填
invoice_kind Number 可选 1 发票种类,1=普票,2=专票,success=true时必填
invoice_no String 可选 11009911 发票号码,success=true时必填
req_index String 必须 012987842kshf 开票请求标识,扫描驱动回传type=1时填批次号
success Boolean 必须 true ocr结果,true=成功,false=失败
sum_price String 可选 181.98 不含税金额,ocr结果为专票,success=true并且invoiceKind=2时必填
type Number 必须 1 请求类型,0=阿里主动发起的cor,1=扫描驱动服务商主动回传ocr结果

响应参数

名称 类型 示例值 描述
is_success Boolean true 接口调用结果,true=成功,false=失败,subCode以isp开头时需要服务商重试

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaEinvoiceIncomeOcrReturnRequest req = new AlibabaEinvoiceIncomeOcrReturnRequest();
req.setChecksum("02789374837498234");
req.setErrorCode("001");
req.setErrorMessage("无效的发票");
req.setImageData(new FileItem("/tmp/file.txt"));
req.setImageId("1");
req.setInvoiceCode("1001022020");
req.setInvoiceDate("2018-08-01");
req.setInvoiceKind(1L);
req.setInvoiceNo("11009911");
req.setReqIndex("012987842kshf");
req.setSuccess(true);
req.setSumPrice("181.98");
req.setType(1L);
AlibabaEinvoiceIncomeOcrReturnResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_einvoice_income_ocr_return_response>
    <is_success>true</is_success>
</alibaba_einvoice_income_ocr_return_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部