功能介绍

识别机动车销售发票、二手车销售发票图片中的文字内容，服务能自动分辨两种类型，并将识别的结果以JSON格式返回给用户。该接口的使用限制请参见约束与限制，详细使用指导请参见OCR服务使用简介章节。

图1 机动车销售发票示例图

图2 机动车销售发票示例图

图3 二手车销售发票示例图

如果图片中包含多张卡证票据，请调用智能分类识别服务。

约束与限制

• 支持识别PNG、JPG、JPEG、BMP、TIFF、PDF格式。
• 图像各边的像素大小在100到8000px之间。
• 图像中识别区域有效占比超过80%，保证整张发票及其边缘包含在图像内。
• 支持图像中发票任意角度的水平旋转。
• 支持少量扭曲，扭曲后图像中的发票长宽比与实际发票相差不超过10%。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

前提条件

在使用之前，需要您完成服务申请和认证鉴权，具体操作流程请参见开通服务和认证鉴权章节。

用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。

URI

POST https://{endpoint}/v2/{project_id}/ocr/mvs-invoice

请求参数

响应参数

根据识别的结果，可能有不同的HTTP响应状态码（status code）。例如，200表示API调用成功，400表示调用失败，详细的状态码和响应参数说明如下。

状态码： 200

状态码： 400

请求示例

• “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。

  例如，机动车销售发票识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”，请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/mvs-invoice”，“project_id”为项目ID，获取方法请参见获取项目ID

• 如何获取Token请参见认证鉴权。

• 请求示例（方式一：使用图片的Base64编码）

  POST https://{endpoint}/v2/{project_id}/ocr/mvs-invoice 
      
   Request Header:   
   Content-Type: application/json   
   X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
   Request Body:
  
  
  
  {
    "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA...",
    "type" : "auto"
  }

• 请求示例（方式二：使用图片URL）

  POST https://{endpoint}/v2/{project_id}/ocr/mvs-invoice
      
   Request Header:   
   Content-Type: application/json   
   X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
   Request Body:
   {
       "url":"https://BucketName.obs.xxxx.com/ObjectName"
    }

响应示例

状态码：200

成功响应示例1

{
  "result" : {
    "code" : "144031624150",
    "number" : "00446874",
    "machine_printed_code" : "144031624150",
    "machine_printed_number" : "00446874",
    "issue_date" : "2017-07-19",
    "machine_number" : "49991450XXXX",
    "buyer_name" : "深圳市宝安区XXX",
    "buyer_organization_number" : "XXX",
    "buyer_id" : "XXX",
    "seller_name" : "深圳市XXX服务有限公司",
    "seller_phone" : "0755-XXX",
    "seller_id" : "XXX",
    "seller_account" : "XXX",
    "seller_address" : "深圳市宝安区松岗街道办XXX",
    "seller_bank" : "建设银行深圳XX支行",
    "vehicle_type" : "多用途乘用车",
    "brand_model" : "东风日产牌/XXX",
    "manufacturing_location" : "大连市",
    "quality_certificate" : "XXX",
    "import_certificate" : "",
    "inspection_number" : "",
    "engine_number" : "XXX",
    "vehicle_identification_number" : "XXX",
    "tonnage" : "",
    "seating_capacity" : "5",
    "tax_authority" : "深圳市宝安区国家税务局XXX税务分局",
    "tax_authority_code" : "144030614",
    "tax_payment_receipt" : "",
    "tax_rate" : "17%",
    "tax" : "￥21475.21",
    "tax_exclusive_price" : "￥126324.79",
    "total" : "￥147800.00",
    "total_chinese" : "壹拾肆万柒仟捌佰圆整",
    "fiscal_code" : ""
  }
}

成功响应示例2

{
  "result" : {
    "used_vehicle_market_name" : "动车交易有限公司",
    "auction_org_bank_account" : "10468888888830",
    "seller_phone" : "13988888888",
    "buyer_id" : "AB37836SDWGDUOHDOEHD3",
    "machine_printed_number" : "00888858",
    "auction_org_id" : "AB37836SDWGDUOHDOEHD3",
    "auction_org_name" : "某拍卖行",
    "buyer_name" : "汽车贸易有限公司",
    "used_vehicle_market_id" : "91DEDD3782733DJ6R",
    "used_vehicle_market_phone" : "07588888888",
    "code" : "044008888817",
    "machine_number" : "4888888182",
    "used_vehicle_market_address" : "佛山市",
    "seller_address" : "广东省佛山市",
    "auction_org_address" : "广东省佛山市",
    "brand_model" : "吉利莫车型",
    "licence_plate_number" : "粤A88888",
    "seller_id" : "AB37836SDWGDUOHDOEHD3",
    "machine_printed_code" : "10468888888830",
    "registration_number" : "1234EHWEGG8888830",
    "buyer_phone" : "13988888888",
    "vehicle_type" : "小型轿车",
    "drawer_name" : "张三",
    "total" : "￥20000.00",
    "total_chinese" : "贰万圆整",
    "issue_date" : "1987-12-27",
    "seller_name" : "李四",
    "vehicle_identification_number" : "L6T7804826379E3GG875",
    "auction_org_phone" : "13988888888",
    "used_vehicle_market_bank_account" : "中国农业银行",
    "buyer_address" : "佛山市",
    "dept_motor_vehicles" : "广东省佛山市车管所",
    "remark" : "免税开具",
    "number" : "003753534",
    "fiscal_code" : "017807816386738245",
    "type" : "二手车销售统一发票"
  } 
}

状态码：400

失败响应示例

{
    "error_code": "AIS.0103",
    "error_msg": "The image size does not meet the requirements."
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。