支持包括发票代码、开票号码、开票日期、发票金额、增值税税额、合格证号、购买方名称、购买方身份证号/代码等关键字段结构化识别输出。
接口说明
本接口适用场景
阿里云机动车销售发票识别，是阿里云官方自研 OCR 文字识别产品，适用于识别购车发票上的发票金额、购买方名称、车辆类型、厂牌型号、销售方名称等关键信息的场景。
阿里云 OCR 产品基于阿里巴巴达摩院强大的 AI 技术及海量数据，历经多年沉淀打磨，具有服务稳定、操作简易、实时性高、能力全面等几大优势。
本接口图片示例
本接口核心能力
| 分类 | 概述 |
| 图片格式 | 支持 PNG、JPG、JPEG、BMP、GIF、TIFF、WebP。 |
| 图像增强 | 默认支持图像增强，包括图像自动旋转、畸变自动矫正、模糊图片自动增强等能力。 |
| 多类型覆盖 | 支持模糊、光照不均、透视畸变、任意背景等低质量图像识别。 |
| 高精度识别 | 总体识别准确率可达 98%。 |
如何使用本接口
| 步骤 | 概述 |
| 1 | 开通 票据凭证识别 服务。开通服务前后，您可以通过体验馆免费体验本功能识别效果。 |
| 2 | 购买机动车销售发票识别资源包。本 API 会赠送免费额度，可使用免费额度测试。您也可以不购买资源包，系统会通过“按量付费”方式按实际调用量自动扣款。 |
| 3 | 可以参照调试页面提供的代码示例完成 API 接入开发。接入完成后，调用 API 获取识别结果。如果使用子账号调用接口，需要阿里云账号（主账号）对 RAM 账号进行授权。创建 RAM 用户的具体操作，请参考：创建 RAM 用户。文字识别服务提供一种系统授权策略，即 AliyunOCRFullAccess。具体授权操作，请参见在用户页面为 RAM 用户授权。 |
重要提示
| 类型 | 概述 |
| 图片格式 |
|
| 图片尺寸 |
|
| 图片大小 |
|
| 相关能力 |
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ocr:RecognizeCarInvoice |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Url |
string |
否 |
|
https://img.alicdn.com/tfs/TB1hC7bXCzqK1RjSZPcXXbTepXa-832-616.jpg |
| body |
string |
否 |
|
图片二进制文件 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求唯一 ID |
43A29C77-405E-4CC0-BC55-EE694AD00655 |
| Data |
string |
返回数据 |
{ "data": { "taxCode": "0492725/*+0/法55337*<56-24/*184-/*<94 16-6+9*-897+98546/<>74*++16<43800*>+-< 116*丰1<4201/*18+-/74*++16<43800*>+-< 116*丰1<4201/*18+-/ |
| Code |
string |
错误码（如果识别成功，不会返回此字段） |
noPermission |
| Message |
string |
错误提示（如果识别成功，不会返回此字段） |
You are not authorized to perform this operation. |
返回参数说明
| 字段 | 类型 | 说明 |
| data | object | 结构化信息。 |
| sliceRect | list | 检测出的子图坐标信息。 |
| prism_keyValueInfo | list | 结构化信息的坐标信息。 |
| ftype | int | 是否为复印件（1：是，0：否）。 |
| height | int | 算法矫正图片后的高度。 |
| width | int | 算法矫正图片后的宽度。 |
| orgHeight | int | 原图的高度。 |
| orgWidth | int | 原图的宽度。 |
识别结果（data 字段）
| 字段 | 类型 | 说明 |
| taxCode | string | 税控码。 |
| invoiceDate | string | 开票日期。 |
| invoiceCode | string | 发票代码。 |
| invoiceNumber | string | 发票号码。 |
| machineCode | string | 机器编号。 |
| purchaserName | string | 购买方名称。 |
| purchaseCode | string | 购买方身份证号码/组织机构代码。 |
| vehicleType | string | 车辆类型。 |
| brandMode | string | 厂牌型号。 |
| origin | string | 产地。 |
| certificateNumber | string | 合格证号。 |
| importCertificateNumber | string | 进口证明书号。 |
| commodityInspectionNumber | string | 商检单号。 |
| engineNumber | string | 发动机号码。 |
| vinCode | string | 车辆识别代号/车架号码。 |
| invoiceAmountCn | string | 价税合计（大写）。 |
| invoiceAmount | string | 价税合计（小写）。 |
| sellerName | string | 销货单位名称。 |
| sellerContact | string | 销货单位电话。 |
| sellerTaxNumber | string | 销货单位纳税人识别号。 |
| sellerBankAccount | string | 销货单位账号。 |
| sellerAddress | string | 销货单位地址。 |
| sellerDepositaryBank | string | 销货单位开户银行。 |
| taxRate | string | 增值税税率或征收率。 |
| tax | string | 增值税税额。 |
| taxAuthoritiesInfo | string | 主管税务机关及代码。 |
| taxAuthoritiesName | string | 主管税务机关。 |
| taxAuthoritiesCode | string | 主管税务代码。 |
| preTaxAmount | string | 不含税价。 |
| passengerLimitNumber | string | 限乘人数。 |
| issuer | string | 开票人。 |
| tonnage | string | 吨位。 |
| purchaserTaxNumber | string | 购买方纳税人识别号。 |
| taxPaymentNumber | string | 完税凭证号码。 |
结构化坐标信息（prism_keyValueInfo 字段）
| 字段 | 类型 | 说明 |
| key | string | 识别出的字段名称。 |
| keyProb | int | 字段名称置信度。 |
| value | string | 识别出的字段名称对应的值。 |
| valueProb | int | 字段名称对应值的置信度。 |
| valuePos | list | 字段在原图中的四个点坐标（左上、右上、右下、左下）。 |
示例
正常返回示例
JSON格式
{
"RequestId": "43A29C77-405E-4CC0-BC55-EE694AD00655",
"Data": "{\n \"data\": {\n \"taxCode\": \"0492725/*+0/法55337*<56-24/*184-/*<94 16-6+9*-897+98546/<>74*++16<43800*>+-< 116*丰1<4201/*18+-/74*++16<43800*>+-< 116*丰1<4201/*18+-/ },\n {\n \"x\": 323,\n \"y\": 524\n },\n {\n \"x\": 323,\n \"y\": 509\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"taxAuthoritiesInfo\",\n \"keyProb\": 100,\n \"value\": \"安阳县国家税务局341052200\",\n \"valuePos\": [\n {\n \"x\": 633,\n \"y\": 498\n },\n {\n \"x\": 633,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 498\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"taxAuthoritiesName\",\n \"keyProb\": 100,\n \"value\": \"安阳县国家税务局\",\n \"valuePos\": [\n {\n \"x\": 633,\n \"y\": 498\n },\n {\n \"x\": 633,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 498\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"taxAuthoritiesCode\",\n \"keyProb\": 100,\n \"value\": \"341052200\",\n \"valuePos\": [\n {\n \"x\": 633,\n \"y\": 498\n },\n {\n \"x\": 633,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 498\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"preTaxAmount\",\n \"keyProb\": 97,\n \"value\": \"84615.38\",\n \"valuePos\": [\n {\n \"x\": 216,\n \"y\": 557\n },\n {\n \"x\": 216,\n \"y\": 543\n },\n {\n \"x\": 305,\n \"y\": 544\n },\n {\n \"x\": 305,\n \"y\": 559\n }\n ],\n \"valueProb\": 97\n },\n {\n \"key\": \"passengerLimitNumber\",\n \"keyProb\": 100,\n \"value\": \"5\",\n \"valuePos\": [\n {\n \"x\": 723,\n \"y\": 545\n },\n {\n \"x\": 723,\n \"y\": 557\n },\n {\n \"x\": 714,\n \"y\": 557\n },\n {\n \"x\": 714,\n \"y\": 545\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"issuer\",\n \"keyProb\": 100,\n \"value\": \"赵迪\",\n \"valuePos\": [\n {\n \"x\": 437,\n \"y\": 573\n },\n {\n \"x\": 437,\n \"y\": 588\n },\n {\n \"x\": 410,\n \"y\": 588\n },\n {\n \"x\": 410,\n \"y\": 573\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"tonnage\",\n \"keyProb\": 100,\n \"value\": \"\",\n \"valueProb\": 100\n },\n {\n \"key\": \"purchaserTaxNumber\",\n \"keyProb\": 100,\n \"value\": \"410523197206046072\",\n \"valuePos\": [\n {\n \"x\": 730,\n \"y\": 240\n },\n {\n \"x\": 730,\n \"y\": 253\n },\n {\n \"x\": 569,\n \"y\": 253\n },\n {\n \"x\": 569,\n \"y\": 240\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"taxPaymentNumber\",\n \"keyProb\": 100,\n \"value\": \"\",\n \"valueProb\": 100\n }\n ],\n \"width\": 832\n}",
"Code": "noPermission",
"Message": "You are not authorized to perform this operation."
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。