腾讯云营业执照识别 (BizLicenseOCR)

用途

调用腾讯云OCR营业执照识别接口，支持快速精准识别营业执照上的字段，包括统一社会信用代码、公司名称、主体类型、法定代表人、注册资本、组成形式、成立日期、营业期限和经营范围等字段。

核心能力：

基础识别：识别统一社会信用代码（注册号）、公司名称、注册资本、法定代表人、地址、经营范围、主体类型、营业期限、组成形式、成立日期
扩展识别：登记日期、登记机关、标题、编号、重要提示
辅助信息：是否为副本、图片旋转角度、是否有国徽/二维码/印章、是否电子营业执照
告警检测：黑白复印件告警(-9102)、翻拍件告警(-9104)
营业类证件：开启后支持非营业执照的其他营业类证件识别

官方文档：https://cloud.tencent.com/document/api/866/36215

使用时机

当用户提出以下需求时触发此技能：

需要从营业执照图片中提取文字信息
需要获取公司的统一社会信用代码、名称、法定代表人等信息
需要检测营业执照是否为复印件或翻拍件
需要识别电子营业执照
需要识别非营业执照的其他营业类证件（如企业许可证等）
涉及营业执照OCR识别的任何场景

环境要求

Python 3.6+
依赖：tencentcloud-sdk-python（通过 pip install tencentcloud-sdk-python 安装）
环境变量：
- TENCENTCLOUD_SECRET_ID：腾讯云API密钥ID
- TENCENTCLOUD_SECRET_KEY：腾讯云API密钥Key

使用方式

运行 scripts/main.py 脚本完成营业执照识别。

请求参数

参数	类型	必填	说明
ImageBase64	str	否(二选一)	图片Base64值，编码后不超过7M，支持PNG/JPG/JPEG，不支持GIF
ImageUrl	str	否(二选一)	图片URL地址，下载时间不超过3秒。都提供时仅使用ImageUrl
EnableCopyWarn	bool	否	是否返回告警码（复印件/翻拍件告警），默认false
EnablePeriodComplete	bool	否	是否返回自动拼接的有效期，默认true
EnableBusinessCertificate	bool	否	是否支持营业类证件识别（含非营业执照证件），默认false
UserAgent	str	否	请求来源标识(可选)，用于追踪调用来源，统一固定为`Skills`

输出格式

识别成功后返回 JSON 格式结果：

标准营业执照识别结果：

{
  "RegNum": "91110000MA0XXXXXXX",
  "Name": "XX科技有限公司",
  "Capital": "1000万元人民币",
  "Person": "张三",
  "Address": "北京市海淀区XX路XX号",
  "Business": "技术开发、技术咨询、技术服务...",
  "Type": "有限责任公司(自然人投资或控股)",
  "Period": "2020年01月01日至2040年01月01日",
  "ComposingForm": "",
  "SetDate": "2020年01月01日",
  "IsDuplication": 1,
  "RegistrationDate": "2020年01月01日",
  "Angle": 0.0,
  "NationalEmblem": true,
  "QRCode": true,
  "Seal": true,
  "Title": "营业执照",
  "SerialNumber": "000000000",
  "RegistrationAuthority": "北京市海淀区市场监督管理局",
  "Electronic": false,
  "RequestId": "xxx"
}

含告警信息的结果（需开启 EnableCopyWarn）：

{
  "RegNum": "91110000MA0XXXXXXX",
  "Name": "XX科技有限公司",
  "Warnings": [
    {
      "code": -9102,
      "message_id": "WARN_COPY_CARD",
      "description": "黑白复印件告警"
    }
  ],
  "RequestId": "xxx"
}

告警码说明

告警码	消息标识	含义
-9102	WARN_COPY_CARD	黑白复印件告警
-9104	WARN_RESHOOT_CARD	翻拍件告警

错误码说明

错误码	描述
FailedOperation.DownLoadError	文件下载失败
FailedOperation.ImageDecodeFailed	图片解码失败
FailedOperation.NoBizLicense	非营业执照
FailedOperation.OcrFailed	OCR识别失败
FailedOperation.UnKnowError	未知错误
FailedOperation.UnOpenError	服务未开通
InvalidParameterValue.InvalidParameterValueLimit	参数值错误
LimitExceeded.TooLargeFileError	文件内容太大
ResourceUnavailable.InArrears	账号已欠费
ResourceUnavailable.ResourcePackageRunOut	账号资源包耗尽
ResourcesSoldOut.ChargeStatusException	计费状态异常

重要业务逻辑

ImageUrl 优先：ImageBase64 和 ImageUrl 都提供时，仅使用 ImageUrl
有效期拼接：EnablePeriodComplete 未传入时默认设为 true，自动拼接营业期限
EnableBusinessCertificate 分流逻辑：
- false → 直接走营业执照识别引擎
- true → 先调用卡证分类模型：
  - 分类为 "BizLicense" → 走原营业执照引擎
  - 分类为 "EnterpriseLicense" → 走文档抽取基础版引擎(BizLicenseNew)
  - 其他类型 → 返回 FailedOperation.NoBizLicense 错误
电子营业执照：支持识别电子营业执照，通过 Electronic 字段标识
图片限制：Base64 编码后不超过 7M，支持 PNG/JPG/JPEG，不支持 GIF
默认请求频率限制：10次/秒

调用示例

# 通过URL识别营业执照
python scripts/main.py --image-url "https://example.com/biz_license.jpg"

# 通过文件路径(自动Base64编码)识别
python scripts/main.py --image-base64 ./biz_license.jpg

# 开启复印件/翻拍件告警检测
python scripts/main.py --image-url "https://example.com/biz_license.jpg" --enable-copy-warn

# 开启营业类证件识别（含非营业执照证件）
python scripts/main.py --image-url "https://example.com/biz_license.jpg" --enable-business-certificate

# 关闭有效期自动拼接
python scripts/main.py --image-url "https://example.com/biz_license.jpg" --enable-period-complete false

# 指定地域
python scripts/main.py --image-url "https://example.com/biz_license.jpg" --region ap-beijing```

TencentCloud BizLicense OCR