# 华为文字识别 华为文字识别连接器是基于华为云文字识别OCR进行集成开发，文字识别是指对图像中的打印字符进行检测识别，通过调用API，识别图片中的文字，并返回JSON格式的识别结果。华为文字识别连接器包含的执行动作如[表1]所示。 表1执行动作 | 执行动作 | 使用说明 | |:---|:---| | 机动车销售发票识别 | 识别机动车销售发票图片中的文字内容，并将识别的结果返回给用户。该增值税发票仅限于中华人民共和国境内使用的增值税发票。 | | 火车票识别 | 识别火车票中的文字信息，并返回识别的结构化结果。 | | 营业执照识别 | 识别营业执照首页图片中的文字信息，并返回识别的结构化结果。 | | 身份证识别 | 识别身份证图片中的文字内容，并将识别的结果返回给用户。 | | 护照识别 | 识别用户上传的护照首页图片中的文字信息，并返回识别的结构化结果。当前版本支持中国护照的全字段识别。外国护照支持护照下方两行国际标准化的机读码识别，并可从中提取6-7个关键字段信息。 | | 车牌识别 | 识别输入图片中的车牌信息，并返回其坐标和内容 | | 文字识别 | 识别图片上的文字信息，返回识别的文字和坐标。支持扫描文件、电子文档、书籍、票据和表单等多种场景的文字识别。 | | 手写文字识别 | 识别文档中的手写文字信息，并将识别的结构化结果返回给用户。 | | 车辆通行费发票识别 | 识别车辆通行费发票中的文字信息，并返回识别的结构化结果。 | | 银行卡识别 | 识别银行卡上的关键文字信息，并返回识别的结构化结果。 | | 名片识别 | 识别名片图片上的文字信息，并返回识别的结构化结果。支持对多种不同版式名片进行结构化信息提取。 | | 增值税发票识别 | 识别用户上传的增值税发票图片（或者用户提供的华为云上OBS的增值税发票图片文件的URL）中的文字内容，并将识别的结果返回给用户。 说明： 该增值税发票仅限于中华人民共和国境内使用的增值税发票。 如果图片中包含多张卡证票据，请调用智能分类识别服务。 | | 网络图片识别 | 识别网络图片中的文字内容，并返回识别的结构化结果。 | | 行驶证识别 | 识别用户上传的行驶证图片（或者用户提供的华为云上OBS的行驶证图片文件的URL）中主页和副页的文字内容，并将识别的结果返回给用户。 说明： 如果图片中包含多张卡证票据，请调用智能分类识别服务。 | | 发票验真 | 发票验真服务支持9种增值税发票的信息核验，包括增值税专用发票、增值税普通发票、增值税普通发票（卷式）、增值税电子专用发票、增值税电子普通发票、增值税电子普通发票（通行费）、二手车销售统一发票、机动车销售统一发票、区块链电子发票，支持返回票面的全部信息。 | #### 连接参数 华为文字识别连接器使用IAM认证，连接参数说明如[表2]所示。 表2连接参数说明 | 名称 | 必填 | 说明 | 示例值/默认值 | |:---|:---|:---|:---| | 连接名称 | 是 | 设置连接名称。 | 华为文字识别的连接 | | 描述 | 否 | 对于连接的信息描述说明。 | description | | 租户名 | 是 | IAM用户所属账号信息。了解[账号与IAM用户的关系](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html#section2)。 | domain | | 用户名 | 是 | IAM用户名。 | name | | 密码 | 是 | IAM用户的登录密码。 | - | | 项目ID | 是 | 系统为用户自动生成的项目ID，单击"我的凭证 \> API凭证"，根据项目获取。 | e9993fc787\*\*\*\*\*\*\*\*\*\*\*\*a340f9c0f4 | | 站点 | 是 | 站点。 | iam.cn-north-4.myhuaweicloud.com | #### 机动车销售发票识别 识别机动车销售发票图片中的文字内容，并将识别的结果返回给用户。该增值税发票仅限于中华人民共和国境内使用的增值税发票。 - 输入参数 用户配置机动车销售发票识别执行动作，相关参数说明如[表3]所示。 表3机动车销售发票识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片文件。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表4]。 表4机动车销售发票识别输出参数说明 | 参数 | 说明 | |:---|:---| | 发票代码 | 显示发票代码。 | | 发票号码 | 显示发票号码。 | | 机打代码 | 显示发票机打代码。 | | 机打号码 | 显示发票机打号码。 | | 开票日期 | 显示发票开票日期。 | | 机器编号 | 显示发票机器编号。 | | 购买方名称 | 显示购买方名称。 | | 购买方身份证号码/组织机构代码 | 显示购买方身份证号码/组织机构代码。 | | 购买方纳税人识别号 | 显示购买方纳税人识别号。 | | 销货单位名称 | 显示销货单位名称。 | | 销售方电话 | 显示销售方电话。 | | 销售方纳税人识别号 | 显示销售方纳税人识别号。 | | 销售方账号 | 显示销售方账号。 | | 销售方地址 | 显示销售方地址。 | | 销售方开户行 | 显示销售方开户行。 | | 车辆类型 | 显示车辆类型。 | | 厂牌型号 | 显示厂牌型号。 | | 产地 | 显示产地。 | | 合格证号 | 显示合格证号。 | | 进口证明书号 | 显示进口证明书号。 | | 商检单号 | 显示商检单号。 | | 发动机号码 | 显示发动机号码。 | | 车辆识别代号/车架号码 | 显示车辆识别代号/车架号码。 | | 吨位 | 显示吨位。 | | 限乘人数 | 显示车辆限乘人数。 | | 主管税务机关 | 显示相关主管税务机关。 | | 主管税务机关代码 | 显示相关主管税务机关代码。 | | 完税凭证号码 | 显示完税凭证号码。 | | 增值税税率或征收率 | 显示增值税的税率或征收率。 | | 增值税税额 | 显示增值税的税额。 | | 不含税价 | 显示不含税价。 | | 价税合计 | 显示价税合计。 | | 价税合计大写 | 显示价税合计大写。 | | 税控码 | 显示税控码。 | #### 火车票识别 识别火车票中的文字信息，并返回识别的结构化结果。 - 输入参数 用户配置火车票识别执行动作，相关参数说明如[表5]所示。 表5火车票识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片文件。 | | 图片的URL路径 | 与图片文件Base64编码二选一。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表6]。 表6火车票识别输出参数说明 | 参数 | 说明 | |:---|:---| | 火车票左上角的车票ID | 火车票左上角的车票ID。 | | 检票口信息 | 显示检票口信息。 | | 车次 | 显示车辆车次。 | | 始发站 | 该班次始发站。 | | 终点站 | 该班次终点站。 | | 开车时间 | 该班次开车时间。 | | 座位号 | 该票座位号。 | | 票价 | 该班次车票的票价。 | | 售票方式 | 该车票售票方式。 | | 座位类别 | 该座位的座位类别。 | | 是否改签票 | 是否改签票，"Yes"表示改签票。 | | 车票持有人的身份证号 | 车票持有人的身份证号。 | | 车票持有人姓名 | 车票持有人姓名。 | | 车票最下方的序列号 | 车票最下方的序列号。 | | 车票售票地点 | 车票售票地点。 | #### 营业执照识别 识别营业执照首页图片中的文字信息，并返回识别的结构化结果。 - 输入参数 用户配置营业执照识别执行动作，相关参数说明如[表7]所示。 表7营业执照识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片文件。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表8]。 表8营业执照识别输出参数说明 | 参数 | 说明 | |:---|:---| | 2- 老版本营业执照对应注册号 | 老版本营业执照对应注册号。 | | 企业名称 | 企业名称。 | | 公司/企业类型/主体类型 | 显示公司/企业类型/主体类型。 | | 住所/营业场所/企业住所 | 显示该企业住所/营业场所/企业住所。 | | 法定代表人/负责人 | 该企业法定代表人/负责人。 | | 注册资本 | 该企业注册资本。 | | 成立日期 | 该企业成立日期。 | | 营业期限 | 该企业营业期限。 | | 经营范围 | 该企业经营范围。 | | 发照日期 | 该企业发照日期。 | #### 身份证识别 识别身份证图片中的文字内容，并将识别的结果返回给用户。 - 输入参数 用户配置身份证识别执行动作，相关参数说明如[表9]所示。 表9身份证识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | | 识别正面/反面 | - front：身份证正面。 - back：身份证背面。 | | 是否返回校验信息 | - true：返回校验信息。 - false：不返回校验信息。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表10]。 表10身份证识别输出参数说明 | 参数 | 说明 | |:---|:---| | 姓名 | 姓名。 | | 性别 | 性别。 | | 出生日期 | 出生日期。 | | 民族 | 民族。 | | 地址 | 地址。 | | 身份证号 | 身份证号。 | | 发证机关 | 身份证的发证机关。 | | 有效起始日期 | 有效起始日期。 | | 有效结束日期 | 有效结束日期。说明：身份证识别只支持中国大陆汉族身份证识别。 | | 身份证号合法 | 根据校验规则判断身份证是否合法，如果身份证号合法，返回true，否则代表身份证号不合法，返回false。当身份证图片是背面时，默认是false。 | | 身份证号与出生日期一致 | 判断出生日期和身份证号的第7位和第14位之间表示的出生日期是否一致。一致返回true，否则返回false。 当身份证图片是背面时，默认是false。 | | 身份证号与性别一致 | 判断性别和身份证号的第17位表示的性别信息是否一致。身份证号的第17位如果为奇数表示男性，偶数表示女性。一致返回true，否则返回false。当身份证图片是背面时，默认是false。 | | 当前日期在有效期内 | 当前日期在身份证有效期内返回true，否则返回false。 当身份证图片是正面时，默认是false。 | #### 护照识别 识别用户上传的护照首页图片中的文字信息，并返回识别的结构化结果。当前版本支持中国护照的全字段识别。外国护照支持护照下方两行国际标准化的机读码识别，并可从中提取6-7个关键字段信息。 - 输入参数 用户配置护照识别执行动作，相关参数说明如[表11]所示。 表11护照识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 与图片文件Base64编码二选一。 | | 护照颁发国的国家码 | -GENERAL，护照机器码识别。 -CHN，中国护照全字段识别。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表12]。 表12护照识别输出参数说明 | 参数 | 说明 | |:---|:---| | 护照类型 | （P：普通因私护照、W：外交护照、G：公务护照）（英文）。 | | 护照签发国的国家码（英文） | 护照签发国的国家码（英文）。 | | 护照号码（英文） | 护照号码（英文）。 | | 护照持有人国籍（英文） | 护照持有人国籍（英文）。 | | 姓（英文） | 持有人姓（英文）。 | | 名字（英文） | 持有人名字（英文）。 | | 性别（英文） | 持有人性别（英文）。 | | 出生日期（英文） | 持有人出生日期（英文）。 | | 护照有效期（英文） | 该护照有效期（英文）。 | | 护照签发日期 | 该护照签发日期（英文）。 | | 出生地 | 持有人出生地（英文）。 | | 签发地 | 持有人签发地（英文）。 | | 签发机构 | 签发机构（英文），其中对中国的英文简写统一输出为P.R.China。 | #### 车牌识别 识别输入图片中的车牌信息，并返回其坐标和内容。 - 输入参数 用户配置车牌识别执行动作，相关参数说明如[表13]所示。 表13车牌识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表14]。 表14车牌识别输出参数说明 | 参数 | 说明 | |:---|:---| | 车牌内容 | 显示车牌号。 | | 当前版本支持的车牌底色类型 | -blue蓝色；green绿色；-black黑色；-white白色；-yellow黄色。 | #### 文字识别 识别图片上的文字信息，返回识别的文字和坐标。支持扫描文件、电子文档、书籍、票据和表单等多种场景的文字识别。 - 输入参数 用户配置文字识别执行动作，相关参数说明如[表15]所示。 表15文字识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表16]。 表16文字识别输出参数说明 | 参数 | 说明 | |:---|:---| | 识别文字块列表 | 识别文字块列表，输出顺序从左到右，先上后下。 | | 文字块识别结果 | 文字块识别结果。 | #### 手写文字识别 识别文档中的手写文字信息，并将识别的结构化结果返回给用户。 - 输入参数 用户配置手写文字识别执行动作，相关参数说明如[表17]所示。 表17手写文字识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 图片的URL路径，和图片文件 。 | | 是否校正图片的倾斜角度 | -true：校正图片的倾斜角度；-false：不校正图片的倾斜角度。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表18]。 表18手写文字识别输出参数说明 | 参数 | 说明 | |:---|:---| | 识别文字块列表 | 识别文字块列表，输出顺序从左到右，从上到下。 | | 文字块识别结果 | 文字块识别结果。 | #### 车牌通行费发票识别 识别车辆通行费发票中的文字信息，并返回识别的结构化结果。 - 输入参数 用户配置车辆通行费发票识别执行动作，相关参数说明如[表19]所示。 表19车辆通行费发票识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表20]。 表20车辆通行费发票识别输出参数说明 | 参数 | 说明 | |:---|:---| | 发票代码 | 发票代码。 | | 发票号码 | 发票号码。 | | 入口 | 该车通行入口。 | | 出口 | 该车通行出口。 | | 收费金额 | 该车通行收费金额。 | | 收费员 | 收费员。 | | 车辆类型 | 车辆类型。 | | 日期 | 该车通行日期。 | | 时间 | 该车通行时间。 | #### 银行卡识别 识别银行卡上的关键文字信息，并返回识别的结构化结果。 - 输入参数 用户配置银行卡识别执行动作，相关参数说明如[表21]所示。 表21银行卡识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 与图片文件Base64编码二选一。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表22]。 表22银行卡识别输出参数说明 | 参数 | 说明 | |:---|:---| | 发卡行 | 该卡发卡行。 | | 银行卡号 | 该卡银行卡号。 | | 有效期开始日期 | 该卡有效期开始日期。 | | 有效期截止日期 | 该卡有效期截止日期。 | | 银行卡类别 | 银行卡的类别，如：储蓄卡，信用卡。 | #### 名片识别 识别名片图片上的文字信息，并返回识别的结构化结果。支持对多种不同版式名片进行结构化信息提取。 - 输入参数 用户配置名片识别执行动作，相关参数说明如[表23]所示。 表23名片识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 与图片文件Base64编码二选一。 | | 图片朝向检测开关 | - true：检测图片朝向； - false：不检测图片朝向。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表24]。 表24名片识别输出参数说明 | 参数 | 说明 | |:---|:---| | 姓名列表 | 姓名。 | | 职位头衔列表 | 持有人职位头衔列表。 | | 公司列表 | 持有人公司列表。 | | 部门列表 | 持有人公司部门列表。 | | 联系方式列表 | 持有人联系方式列表。 | | 地址列表 | 公司地址列表。 | | 邮箱列表 | 持有人邮箱列表。 | | 传真列表 | 持有人传真列表。 | | 邮编列表 | 持有人所在公司邮编列表。 | | 公司网址列表 | 持有人网址列表。 | | 返回矫正后的名片图像的BASE64编码 | 返回矫正后的名片图像的BASE64编码。 | #### 增值税发票识别 识别用户上传的增值税发票图片（或者用户提供的华为云上OBS的增值税发票图片文件的URL）中的文字内容，并将识别的结果返回给用户。 说明： 该增值税发票仅限于中华人民共和国境内使用的增值税发票。 如果图片中包含多张卡证票据，请调用智能分类识别服务。 - 输入参数 用户配置增值税发票执行动作，相关参数说明如[表25]所示。 表25增值税发票识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | | 是否返回更多字段 | 如果传参为true，则返回更多字段。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表26]。 表26增值税发票识别输出参数说明 | 参数 | 说明 | |:---|:---| | 增值税发票类型 | 可选值包括：-special增值税专用发票；-normal增值税普通发票；-electronic增值税电子普通发票；-roll增值税普通发票（卷票）。 | | 发票联次 | 发票联次。 | | 发票归属地 | 发票归属地。 | | 发票监制章 | 发票监制章。 | | 发票代码 | 发票代码。 | | 机器编号 | 机器编号。 | | 机打号码 | 机打号码。 | | 发票校验码 | 发票校验码。 | | 发票号码 | 发票号码。 | | 开票日期 | 开票日期。 | | 密码区 | 密码区。 | | 购买方名称 | 购买方名称。 | | 购买方纳税人识别号 | 购买方纳税人识别号。 | | 购买方地址、电话 | 购买方地址、电话。 | | 购买方开户行及账号 | 购买方开户行及账号。 | | 销售方名称 | 销售方名称。 | | 销售方纳税人识别号 | 销售方纳税人识别号。 | | 销售方地址、电话 | 销售方地址、电话。 | | 销售方开户行及账号 | 销售方开户行及账号。 | | 合计金额 | 合计金额。 | | 合计税额 | 合计税额。 | | 价税合计 | 价税合计。 | | 价税合计（大写） | 价税合计（大写）。 | | 备注 | 备注。 | | 收款人 | 收款人。 | | 复核 | 复核。 | | 开票人 | 开票人。 | | 销售方发票专用章 | 销售方发票专用章。 | | 货物或应税劳务列表 | 货物或应税劳务列表。 | | 货物或应税劳务、服务名称 | 货物或应税劳务、服务名称。 | | 规格型号 | 规格型号。 | | 单位 | 单位。 | | 数量 | 数量。 | | 单价 | 单价。 | | 车牌号码 | 车牌号码。 | | 金额 | 金额。 | | 税率 | 税率。 | | 税额 | 税额。 | | 通行日期止 | 通行日期止。 | | 通行日期起 | 通行日期起。 | | 车辆类型 | 车辆类型。 | | 各个字段的置信度 | 各个字段的置信度。 | #### 网络图片识别 识别网络图片中的文字内容，并返回识别的结构化结果。 - 输入参数 用户配置网络图片识别执行动作，相关参数说明如[表27]所示。 表27网络图片识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表28]。 表28网络图片识别输出参数说明 | 参数 | 说明 | |:---|:---| | 识别文字块列表 | 识别文字块列表，输出顺序从左到右，从上到下。 | | 文字块识别结果 | 文字块识别结果。 | #### 行驶证识别 识别用户上传的行驶证图片（或者用户提供的华为云上OBS的行驶证图片文件的URL）中主页和副页的文字内容，并将识别的结果返回给用户。 说明： 如果图片中包含多张卡证票据，请调用智能分类识别服务。 - 输入参数 用户配置行驶证执行动作，相关参数说明如[表29]所示。 表29行驶证识别输入参数说明 | 参数 | 说明 | |:---|:---| | 图片文件 | 上传图片所在位置。 | | 图片的URL路径 | 图片的URL路径，和图片文件二选一。 | | 识别主页/副页 | - front：行驶证主页。 - back：行驶证副页。 | | 是否返回发证机关 | - true：返回发证机关。 - false：不返回发证机关。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表30]。 表30行驶证识别输出参数说明 | 参数 | 说明 | |:---|:---| | 号牌号码 | 车辆号牌号码。 | | 车辆类型 | 车辆类型。 | | 所有人 | 车辆所有人。 | | 住址 | 住址。 | | 使用性质 | 车辆使用性质。 | | 品牌型号 | 车辆品牌型号。 | | 发动机号码 | 发动机号码。 | | 车辆识别代号 | 车辆识别代号。 | | 注册日期 | 车辆注册日期。 | | 发证日期 | 车辆发证日期。 | | 发证机关 | 发证机关。 | | 档案编码 | 车辆档案编码。 | | 核定载人数 | 核定载人数。 | | 总质量 | 车辆总质量。 | | 整备质量 | 车辆整备质量。 | | 核定载质量 | 车辆核定载质量。 | | 外廓尺寸 | 车辆外廓尺寸。 | | 准牵引总质量 | 车辆准牵引总质量。 | | 检验记录 | 车辆检验记录。 | | 条码号 | 车辆条码号。 | #### 发票验真 发票验真服务支持9种增值税发票的信息核验，包括增值税专用发票、增值税普通发票、增值税普通发票（卷式）、增值税电子专用发票、增值税电子普通发票、增值税电子普通发票（通行费）、二手车销售统一发票、机动车销售统一发票、区块链电子发票，支持返回票面的全部信息。 - 输入参数 用户配置发票验真执行动作，相关参数说明如[表31]所示。 表31发票验真输入参数说明 | 参数 | 必须 | 说明 | |:---|:---|:---| | 发票代码 | 是 | 发票代码。 | | 发票号码 | 是 | 发票号码。 | | 发票日期 | 是 | 发票日期格式：YYYY-MM-DD。 | | 校验码后六位 | 否 | 校验码后六位发票种类为增值税普通发票、增值税电子普通发票、增值税普通发票（卷式）、增值税电子普通发票（通行费）、区块链电子发票时此项不可为空（区块链电子发票验真时，填写的是5位校验码）。 | | 合计金额 | 否 | 合计金额（不含税） 1. 发票种类为增值税专用发票、增值税电子专用发票、机动车销售统一发票、二手车销售统一发票、区块链电子发票时不可为空。 2. 增值税专用发票、增值税电子专用发票、机动车销售统一发票、区块链电子发票填写发票合计金额（不含税），二手车发票填写发票车价合计。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表32]。 表32发票验真输出参数说明 | 参数 | 说明 | |:---|:---| | 调用成功时表示调用结果 | 调用成功时表示调用结果，调用失败时无此字段。 |