文档首页 > > API参考> API> 机动车销售发票识别

机动车销售发票识别

分享
更新时间: 2020/07/31 GMT+08:00

功能介绍

识别机动车销售发票图片中的文字内容,并将识别的结果以json格式返回给用户。该接口的使用限制请参见使用限制,详细使用指导请参见OCR服务使用简介章节。

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

前提条件

在使用机动车销售发票识别之前,需要您完成服务申请和认证鉴权,具体操作流程请参见申请服务认证鉴权章节。

URL

POST https://{endpoint}/v1.0/ocr/mvs-invoice

表1 参数说明

参数

是否必选

说明

endpoint

指定承载REST服务端点的服务器域名或IP,不同服务不同区域的endpoint不同,您可以从终端节点中获取。

例如,OCR服务在“华北-北京四”区域的“endpoint”“ocr.cn-north-4.myhuaweicloud.com”

请求消息

机动车销售发票识别请求参数说明请参见 表2
表2 请求参数说明

参数

是否必选

参数类型

说明

image

否,该参数与url二选一

String

图像数据,base64编码,要求base64编码后大小不超过10MB。图片最小边不小于100px,最长边不超过8000px。支持JPEG、JPG、PNG、BMP、TIFF格式。

url

否,该参数与image二选一

String

图片的url路径,目前支持:

  • 公网http/https url
  • OBS提供的url,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权,详情参见配置OBS访问权限
说明:
  • 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。
  • 请保证被检测图片所在的存储服务稳定可靠,推荐使用OBS服务存储图片数据。

响应消息

机动车销售发票识别响应参数说明请参见 表3
表3 响应参数说明

参数

参数类型

说明

result

Object

调用成功时表示调用结果。

调用失败时无此字段。

code

String

发票代码。

number

String

发票号码。

machine_printed_code

String

机打代码。

machine_printed_number

String

机打号码。

issue_date

String

开票日期。

machine_number

String

机器编号。

buyer_name

String

购买方名称。

buyer_organization_number

String

购买方身份证号码或组织机构代码。

buyer_id

String

购买方纳税人识别号。

seller_name

String

销货单位名称。

seller_phone

String

销售方电话。

seller_id

String

销售方纳税人识别号。

seller_account

String

销售方账号。

seller_address

String

销售方地址。

seller_bank

String

销售方开户行。

vehicle_type

String

车辆类型。

brand_model

String

厂牌型号。

manufacturing_location

String

产地。

quality_certificate

String

合格证号。

import_certificate

String

进口证明书号。

inspection_number

String

商检单号。

engine_number

String

发动机号码。

vehicle_identification_number

String

车辆识别代号/车架号码。

tonnage

String

吨位。

seating_capacity

String

限乘人数。

tax_authority

String

主管税务机关。

tax_authority_code

String

主管税务机关代码。

tax_payment_receipt

String

完税凭证号码。

tax_rate

String

增值税税率或征收率。

tax

String

增值税税额。

tax_exclusive_price

String

不含税价。

total

String

价税合计。

total_chinese

String

价税合计大写。

fiscal_code

String

税控码。

error_code

String

调用失败时的错误码,具体请参见错误码

当出现错误码“ModelArts.4204”时,请参考为什么调用API时提示“ModelArts.4204”?章节。

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

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

例如机动车销售发票识别服务部署在“华北-北京四”区域的“endpoint”“ocr.cn-north-4.myhuaweicloud.com”,请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v1.0/ocr/mvs-invoice”

  • 请求示例(方式一:使用图片的base64编码)
    POST https://{endpoint}/v1.0/ocr/mvs-invoice 
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
     Request Body:
     { 
        "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
      }
  • 请求示例(方式二:使用图片URL)
    POST https://{endpoint}/v1.0/ocr/mvs-invoice
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
     Request Body:
     {
         "url":"https://BucketName.obs.xxxx.com/ObjectName"
      }
  • 成功响应示例
    {
      "result":{
          "code":"11XXXXXXXX88",
          "number":"00XXXX08",
          "machine_printed_code":"11XXXXXXXX88",
          "machine_printed_number":"00XXXX08",
          "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银行深圳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":"XXXX",
          "tax_authority_code":"122XXXX08",
          "tax_payment_receipt":"",
          "tax_rate": "17%",
          "tax": "¥21475.21",
          "tax_exclusive_price": "¥126324.79",
          "total": "¥147800.00",
          "total_chinese": "壹拾肆万柒仟捌佰圆整",
          "fiscal_code":""
      }
    }
  • 失败响应示例
    {
        "error_code": "AIS.0103",
        "error_msg": "The image size does not meet the requirements."
    }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问