AI 助理
备案控制台
文档
输入文档关键字查找
首页 文字识别 开发参考 API参考 API目录 票据凭证识别 RecognizeBankAcceptance - 银行承兑汇票识别

RecognizeBankAcceptance - 银行承兑汇票识别

更新时间：
产品详情
我的收藏

支持包括出票日期、票据号码、出票人信息、收票人信息、承兑人信息、票据金额等关键字段结构化识别输出。

接口说明

本接口适用场景

  • 阿里云银行承兑汇票识别，是阿里云官方自研 OCR 文字识别产品，适用于识别银行承兑汇票上的出票日期、到期日期、票据状态、票据号码、出票人信息、售票人信息、承兑人信息等关键信息的场景。
  • 阿里云 OCR 产品基于阿里巴巴达摩院强大的 AI 技术及海量数据，历经多年沉淀打磨，具有服务稳定、操作简易、实时性高、能力全面等几大优势。
  • 本接口图片示例（仅支持正面识别，暂不支持背面识别）

本接口核心能力

分类概述
图片格式支持 PNG、JPG、JPEG、BMP、GIF、TIFF、WebP。
图像增强默认支持图像增强，包括图像自动旋转、畸变自动矫正、模糊图片自动增强等能力。
多类型覆盖支持模糊、光照不均、透视畸变、任意背景等低质量图像识别。
高精度识别总体识别准确率可达 98%。

如何使用本接口

步骤概述
1开通 票据凭证识别 服务。开通服务前后，您可以通过体验馆免费体验本功能识别效果。
2购买银行承兑汇票识别资源包。本 API 会赠送免费额度，可使用免费额度测试。您也可以不购买资源包，系统会通过“按量付费”方式按实际调用量自动扣款。
3可以参照调试页面提供的代码示例完成 API 接入开发。接入完成后，调用 API 获取识别结果。如果使用子账号调用接口，需要阿里云账号（主账号）对 RAM 账号进行授权。创建 RAM 用户的具体操作，请参考：创建 RAM 用户。文字识别服务提供一种系统授权策略，即 AliyunOCRFullAccess。具体授权操作，请参见在用户页面为 RAM 用户授权。

重要提示

类型概述
图片格式
  • 本接口支持：PNG、JPG、JPEG、BMP、GIF、TIFF、WebP。暂不支持 PDF 格式。
图片尺寸
  • 图片长宽需要大于 15 像素，小于 8192 像素。
  • 长宽比需要小于 50。
  • 如需达到较好识别效果，建议长宽均大于 500px。
图片大小
  • 图片二进制文件不能超过 10MB。
  • 图片过大会影响接口响应速度，建议使用小于 1.5M 图片进行识别，且通过传图片 URL 的方式调用接口。
相关能力

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
ocr:RecognizeBankAcceptanceget
  • 全部资源
    *
    无
无

请求参数

名称类型必填描述示例值
Urlstring否
  • 本字段和 body 字段二选一，不可同时透传或同时为空。
    • 图片链接（长度不超 2048 字节，不支持 base64）。
https://img.alicdn.com/imgextra/i1/O1CN016eNk0d1ubhKP4y6gK_!!6000000006056-2-tps-631-570.png
bodybyte否
  • 本字段和 URL 字段二选一，不可同时透传或同时为空。
  • 图片二进制文件，最大 10MB。
  • 使用 HTTP 方式调用，把图片二进制文件放到 HTTP body 中上传即可。
  • 使用 SDK 的方式调用，把图片放到 SDK 的 body 中即可。
图片二进制

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求唯一 ID

43A29C77-405E-4CC0-BC55-EE694AD00655
Datastring

返回数据

{"data": {"issueDate": "2021-03-31", "validToDate": "2021-06-30", "draftStatus": "提示收票已签收", "draftNumber": "130659500009820xxxx", "issuerName": "广东格林精密部件股份有限公司", "issuerAccountNumber": "955088001663180xxxx", "issuerAccountBank": "广发银行股份有限公司惠州江北支行", "payeeName": "", "payeeAccountNumber": "200802200920026xxxx", "payeeAccountBank": "中国工商银行惠州仲恺高新区支行", "totalAmountInWords": "贰拾万捌仟捌佰肆拾伍元整", "totalAmount": "208845.00", "acceptorName": "广发银行股份有限公司惠州江北支行", "acceptorAccountNumber": "0", "acceptorBankNumber": "30659500xxxx", "acceptorAccountBank": "广发银行股份有限公司惠州江北支行", "agreementNumber": "", "assignability": "可转让", "acceptanceDate": "2021-03-31"}, "ftype": 0, "height": 570, "orgHeight": 570, "orgWidth": 631, "prism_keyValueInfo": [{"key": "issueDate", "keyProb": 100, "value": "2021-03-31", "valuePos": [{"x": 149, "y": 39}, {"x": 149, "y": 50}, {"x": 87, "y": 50}, {"x": 87, "y": 39}], "valueProb": 100}, {"key": "validToDate", "keyProb": 100, "value": "2021-06-30", "valuePos": [{"x": 151, "y": 56}, {"x": 151, "y": 68}, {"x": 87, "y": 68}, {"x": 87, "y": 56}], "valueProb": 100}, {"key": "draftStatus", "keyProb": 100, "value": "提示收票已签收", "valuePos": [{"x": 467, "y": 37}, {"x": 467, "y": 52}, {"x": 379, "y": 51}, {"x": 379, "y": 36}], "valueProb": 100}, {"key": "draftNumber", "keyProb": 97, "value": "130659500009820xxxx", "valuePos": [{"x": 511, "y": 57}, {"x": 511, "y": 68}, {"x": 380, "y": 68}, {"x": 380, "y": 56}], "valueProb": 97}, {"key": "issuerName", "keyProb": 100, "value": "广东格林精密部件股份有限公司", "valuePos": [{"x": 275, "y": 75}, {"x": 275, "y": 90}, {"x": 103, "y": 90}, {"x": 103, "y": 75}], "valueProb": 100}, {"key": "issuerAccountNumber", "keyProb": 100, "value": "955088001663180xxxx", "valuePos": [{"x": 221, "y": 96}, {"x": 221, "y": 108}, {"x": 105, "y": 108}, {"x": 105, "y": 96}], "valueProb": 100}, {"key": "issuerAccountBank", "keyProb": 100, "value": "广发银行股份有限公司惠州江北支行", "valuePos": [{"x": 298, "y": 120}, {"x": 298, "y": 136}, {"x": 106, "y": 136}, {"x": 106, "y": 119}], "valueProb": 100}, {"key": "payeeName", "keyProb": 100, "value": "", "valueProb": 100}, {"key": "payeeAccountNumber", "keyProb": 100, "value": "200802200920026xxxx", "valuePos": [{"x": 536, "y": 97}, {"x": 536, "y": 108}, {"x": 420, "y": 108}, {"x": 420, "y": 97}], "valueProb": 100}, {"key": "payeeAccountBank", "keyProb": 100, "value": "中国工商银行惠州仲恺高新区支行", "valuePos": [{"x": 421, "y": 115}, {"x": 587, "y": 115}, {"x": 587, "y": 140}, {"x": 421, "y": 140}], "valueProb": 98}, {"key": "totalAmountInWords", "keyProb": 100, "value": "贰拾万捌仟捌佰肆拾伍元整", "valuePos": [{"x": 300, "y": 164}, {"x": 300, "y": 180}, {"x": 154, "y": 180}, {"x": 154, "y": 164}], "valueProb": 100}, {"key": "totalAmount", "keyProb": 99, "value": "208845.00", "valuePos": [{"x": 300, "y": 164}, {"x": 300, "y": 180}, {"x": 154, "y": 180}, {"x": 154, "y": 164}], "valueProb": 100}, {"key": "acceptorName", "keyProb": 100, "value": "广发银行股份有限公司惠州江北支行", "valuePos": [{"x": 309, "y": 208}, {"x": 310, "y": 233}, {"x": 180, "y": 234}, {"x": 179, "y": 210}], "valueProb": 100}, {"key": "acceptorAccountNumber", "keyProb": 100, "value": "0", "valuePos": [{"x": 188, "y": 249}, {"x": 188, "y": 260}, {"x": 181, "y": 260}, {"x": 181, "y": 249}], "valueProb": 100}, {"key": "acceptorBankNumber", "keyProb": 100, "value": "30659500xxxx", "valuePos": [{"x": 494, "y": 218}, {"x": 494, "y": 229}, {"x": 421, "y": 229}, {"x": 421, "y": 218}], "valueProb": 100}, {"key": "acceptorAccountBank", "keyProb": 100, "value": "广发银行股份有限公司惠州江北支行", "valuePos": [{"x": 587, "y": 241}, {"x": 587, "y": 266}, {"x": 420, "y": 266}, {"x": 420, "y": 241}], "valueProb": 100}, {"key": "agreementNumber", "keyProb": 100, "value": "", "valueProb": 100}, {"key": "assignability", "keyProb": 100, "value": "可转让", "valuePos": [{"x": 144, "y": 309}, {"x": 144, "y": 324}, {"x": 106, "y": 324}, {"x": 106, "y": 309}], "valueProb": 100}, {"key": "acceptanceDate", "keyProb": 100, "value": "2021-03-31", "valuePos": [{"x": 466, "y": 317}, {"x": 466, "y": 329}, {"x": 404, "y": 329}, {"x": 404, "y": 317}], "valueProb": 100}], "sliceRect": {"x0": 10, "y0": 90, "x1": 616, "y1": 88, "x2": 616, "y2": 498, "x3": 10, "y3": 499}, "width": 631}
Codestring

错误码

noPermission
Messagestring

错误提示

You are not authorized to perform this operation.

返回参数说明


字段类型说明
dataobject结构化信息。
sliceRectlist检测出的子图坐标信息。
prism_keyValueInfolist结构化信息的坐标信息。
ftypeint是否为复印件（1：是，0：否）。
heightint算法矫正图片后的高度。
widthint算法矫正图片后的宽度。
orgHeightint原图的高度。
orgWidthint原图的宽度。

识别结果（data 字段）

字段类型说明
issueDatestring出票日期。
validToDatestring到期日期。
draftStatusstring票据状态。
draftNumberstring票据号码。
issuerNamestring出票人全称。
issuerAccountNumberstring出票人账号。
issuerAccountBankstring出票人开户银行。
payeeNamestring收票人全称。
payeeAccountNumberstring收票人账号。
payeeAccountBankstring收票人开户银行。
totalAmountInWordsstring票据金额大写。
totalAmountstring票据金额小写。
acceptorNamestring承兑人全称。
acceptorAccountNumberstring承兑人账号。
acceptorBankNumberstring承兑人开户行行号。
acceptorAccountBankstring承兑人开户行名称。
agreementNumberstring交易合同号。
assignabilitystring能否转让。
acceptanceDatestring承兑日期。
subDraftNumberstring子票区间号。

结构化坐标信息（prism_keyValueInfo 字段）

字段类型说明
keystring识别出的字段名称。
keyProbint字段名称置信度。
valuestring识别出的字段名称对应的值。
valueProbint字段名称对应值的置信度。
valuePoslist字段在原图中的四个点坐标（左上、右上、右下、左下）。

示例

正常返回示例

JSON格式

{
  "RequestId": "43A29C77-405E-4CC0-BC55-EE694AD00655",
  "Data": "{\"data\": {\"issueDate\": \"2021-03-31\", \"validToDate\": \"2021-06-30\", \"draftStatus\": \"提示收票已签收\", \"draftNumber\": \"130659500009820xxxx\", \"issuerName\": \"广东格林精密部件股份有限公司\", \"issuerAccountNumber\": \"955088001663180xxxx\", \"issuerAccountBank\": \"广发银行股份有限公司惠州江北支行\", \"payeeName\": \"\", \"payeeAccountNumber\": \"200802200920026xxxx\", \"payeeAccountBank\": \"中国工商银行惠州仲恺高新区支行\", \"totalAmountInWords\": \"贰拾万捌仟捌佰肆拾伍元整\", \"totalAmount\": \"208845.00\", \"acceptorName\": \"广发银行股份有限公司惠州江北支行\", \"acceptorAccountNumber\": \"0\", \"acceptorBankNumber\": \"30659500xxxx\", \"acceptorAccountBank\": \"广发银行股份有限公司惠州江北支行\", \"agreementNumber\": \"\", \"assignability\": \"可转让\", \"acceptanceDate\": \"2021-03-31\"}, \"ftype\": 0, \"height\": 570, \"orgHeight\": 570, \"orgWidth\": 631, \"prism_keyValueInfo\": [{\"key\": \"issueDate\", \"keyProb\": 100, \"value\": \"2021-03-31\", \"valuePos\": [{\"x\": 149, \"y\": 39}, {\"x\": 149, \"y\": 50}, {\"x\": 87, \"y\": 50}, {\"x\": 87, \"y\": 39}], \"valueProb\": 100}, {\"key\": \"validToDate\", \"keyProb\": 100, \"value\": \"2021-06-30\", \"valuePos\": [{\"x\": 151, \"y\": 56}, {\"x\": 151, \"y\": 68}, {\"x\": 87, \"y\": 68}, {\"x\": 87, \"y\": 56}], \"valueProb\": 100}, {\"key\": \"draftStatus\", \"keyProb\": 100, \"value\": \"提示收票已签收\", \"valuePos\": [{\"x\": 467, \"y\": 37}, {\"x\": 467, \"y\": 52}, {\"x\": 379, \"y\": 51}, {\"x\": 379, \"y\": 36}], \"valueProb\": 100}, {\"key\": \"draftNumber\", \"keyProb\": 97, \"value\": \"130659500009820xxxx\", \"valuePos\": [{\"x\": 511, \"y\": 57}, {\"x\": 511, \"y\": 68}, {\"x\": 380, \"y\": 68}, {\"x\": 380, \"y\": 56}], \"valueProb\": 97}, {\"key\": \"issuerName\", \"keyProb\": 100, \"value\": \"广东格林精密部件股份有限公司\", \"valuePos\": [{\"x\": 275, \"y\": 75}, {\"x\": 275, \"y\": 90}, {\"x\": 103, \"y\": 90}, {\"x\": 103, \"y\": 75}], \"valueProb\": 100}, {\"key\": \"issuerAccountNumber\", \"keyProb\": 100, \"value\": \"955088001663180xxxx\", \"valuePos\": [{\"x\": 221, \"y\": 96}, {\"x\": 221, \"y\": 108}, {\"x\": 105, \"y\": 108}, {\"x\": 105, \"y\": 96}], \"valueProb\": 100}, {\"key\": \"issuerAccountBank\", \"keyProb\": 100, \"value\": \"广发银行股份有限公司惠州江北支行\", \"valuePos\": [{\"x\": 298, \"y\": 120}, {\"x\": 298, \"y\": 136}, {\"x\": 106, \"y\": 136}, {\"x\": 106, \"y\": 119}], \"valueProb\": 100}, {\"key\": \"payeeName\", \"keyProb\": 100, \"value\": \"\", \"valueProb\": 100}, {\"key\": \"payeeAccountNumber\", \"keyProb\": 100, \"value\": \"200802200920026xxxx\", \"valuePos\": [{\"x\": 536, \"y\": 97}, {\"x\": 536, \"y\": 108}, {\"x\": 420, \"y\": 108}, {\"x\": 420, \"y\": 97}], \"valueProb\": 100}, {\"key\": \"payeeAccountBank\", \"keyProb\": 100, \"value\": \"中国工商银行惠州仲恺高新区支行\", \"valuePos\": [{\"x\": 421, \"y\": 115}, {\"x\": 587, \"y\": 115}, {\"x\": 587, \"y\": 140}, {\"x\": 421, \"y\": 140}], \"valueProb\": 98}, {\"key\": \"totalAmountInWords\", \"keyProb\": 100, \"value\": \"贰拾万捌仟捌佰肆拾伍元整\", \"valuePos\": [{\"x\": 300, \"y\": 164}, {\"x\": 300, \"y\": 180}, {\"x\": 154, \"y\": 180}, {\"x\": 154, \"y\": 164}], \"valueProb\": 100}, {\"key\": \"totalAmount\", \"keyProb\": 99, \"value\": \"208845.00\", \"valuePos\": [{\"x\": 300, \"y\": 164}, {\"x\": 300, \"y\": 180}, {\"x\": 154, \"y\": 180}, {\"x\": 154, \"y\": 164}], \"valueProb\": 100}, {\"key\": \"acceptorName\", \"keyProb\": 100, \"value\": \"广发银行股份有限公司惠州江北支行\", \"valuePos\": [{\"x\": 309, \"y\": 208}, {\"x\": 310, \"y\": 233}, {\"x\": 180, \"y\": 234}, {\"x\": 179, \"y\": 210}], \"valueProb\": 100}, {\"key\": \"acceptorAccountNumber\", \"keyProb\": 100, \"value\": \"0\", \"valuePos\": [{\"x\": 188, \"y\": 249}, {\"x\": 188, \"y\": 260}, {\"x\": 181, \"y\": 260}, {\"x\": 181, \"y\": 249}], \"valueProb\": 100}, {\"key\": \"acceptorBankNumber\", \"keyProb\": 100, \"value\": \"30659500xxxx\", \"valuePos\": [{\"x\": 494, \"y\": 218}, {\"x\": 494, \"y\": 229}, {\"x\": 421, \"y\": 229}, {\"x\": 421, \"y\": 218}], \"valueProb\": 100}, {\"key\": \"acceptorAccountBank\", \"keyProb\": 100, \"value\": \"广发银行股份有限公司惠州江北支行\", \"valuePos\": [{\"x\": 587, \"y\": 241}, {\"x\": 587, \"y\": 266}, {\"x\": 420, \"y\": 266}, {\"x\": 420, \"y\": 241}], \"valueProb\": 100}, {\"key\": \"agreementNumber\", \"keyProb\": 100, \"value\": \"\", \"valueProb\": 100}, {\"key\": \"assignability\", \"keyProb\": 100, \"value\": \"可转让\", \"valuePos\": [{\"x\": 144, \"y\": 309}, {\"x\": 144, \"y\": 324}, {\"x\": 106, \"y\": 324}, {\"x\": 106, \"y\": 309}], \"valueProb\": 100}, {\"key\": \"acceptanceDate\", \"keyProb\": 100, \"value\": \"2021-03-31\", \"valuePos\": [{\"x\": 466, \"y\": 317}, {\"x\": 466, \"y\": 329}, {\"x\": 404, \"y\": 329}, {\"x\": 404, \"y\": 317}], \"valueProb\": 100}], \"sliceRect\": {\"x0\": 10, \"y0\": 90, \"x1\": 616, \"y1\": 88, \"x2\": 616, \"y2\": 498, \"x3\": 10, \"y3\": 499}, \"width\": 631}",
  "Code": "noPermission",
  "Message": "You are not authorized to perform this operation."
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2022-11-25API 内部配置变更，不影响调用查看变更详情

SDK 调用 通过 SDK 调用此接口的示例请参考开发者中心
上一篇：RecognizeRollTicket - 增值税发票卷票识别下一篇：RecognizeBusShipTicket - 客运车船票识别
文档推荐