文字识别 OCR-发票验真:请求参数

时间:2024-04-15 09:41:20

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。

Content-Type

String

发送的实体的MIME类型,参数值为“application/json”。

Enterprise-Project-Id

String

企业项目ID。OCR支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账。

获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。

企业项目创建步骤请参见用户指南。

说明:

创建企业项目后,在传参时,有以下三类场景。

  • 携带正确的ID,正常使用OCR服务,账单归到企业ID对应的企业项目中。
  • 携带错误的ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。
  • 不携带ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。
表3 请求Body参数

参数

是否必选

参数类型

说明

code

String

发票代码。

发票种类为全电发票时,该参数须为空字符串。

number

String

发票号码。

issue_date

String

发票日期格式YYYY-MM-DD。

check_code

String

校验码后六位。

  • 以下种类发票,check_code参数为必选。

    增值税普通发票、增值税电子普通发票、增值税普通发票(卷式)、增值税电子普通发票(通行费)、区块链电子发票。

  • 区块链电子发票需要填写5位校验码。

subtotal_amount

String

合计金额。和票据上的金额的有效数字保持一致,例如票据上的金额为88.00,则需要输入字符串为“88.00”,否则可能验真不成功。如果输入“88”或“88.0”可能会产生"result_code": "1010", " Parameter error."报错。

发票种类为全电发票时,该参数须为价税合计金额,其他票种使用不含税合计金额。

  • 以下种类发票,参数不可为空。

    增值税专用发票、增值税电子专用发票、机动车销售统一发票、二手车销售统一发票、区块链电子发票、全电发票。

  • 填写发票合计金额(不含税)

    增值税专用发票、增值税电子专用发票、机动车销售统一发票、区块链电子发票。

  • 二手车发票需要填写发票车价合计金额。
support.huaweicloud.com/api-ocr/ocr_03_0134.html