跳到主要内容

创建企业电子印章

1. 接口描述​

接口请求域名： essbasic.tencentcloudapi.com 。

  1. 可以通过图片为子客企业代创建印章，图片最大5MB

  2. 可以使用系统生成印章为子客企业代创建印章, 系统创建的印章样子下图(样式可以调整)

image

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数​

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称必选类型描述
Action是String公共参数，本接口取值：CreateSealByImage。
Version是String公共参数，本接口取值：2021-05-26。
Region否String公共参数，此参数为可选参数。
Agent是Agent

关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。

此接口下面信息必填。

  • 渠道应用标识: Agent.AppId
  • 第三方平台子客企业标识: Agent.ProxyOrganizationOpenId
  • 第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId
第三方平台子客企业和员工必须已经经过实名认证
SealName是String

电子印章名字，1-50个中文字符
注:同一企业下电子印章名字不能相同


示例值：合同专用章
SealImage否String

电子印章图片base64编码，大小不超过10M（原始图片不超过5M），只支持PNG或JPG图片格式

注: 通过图片创建的电子印章，需电子签平台人工审核


示例值：iVBORw0KGgoAAAANSUhEUgAAAGwAAABuCAYAAADCrvbGAAABW2lDZXE15yz3uZ6TErkJggg....(图片base64省略)
GenerateSource否String

电子印章生成方式

  • 空值:(默认)使用上传的图片生成印章, 此时需要上传SealImage图片
  • SealGenerateSourceSystem: 系统生成印章, 无需上传SealImage图片

示例值：SealGenerateSourceSystem
SealType否String

电子印章类型 , 可选类型如下:

  • OFFICIAL: (默认)公章
  • CONTRACT: 合同专用章;
  • FINANCE: 财务专用章;
  • PERSONNEL: 人事专用章
  • INVOICE: 发票专用章
  • OTHER: 其他
注: 同企业下只能有一个公章, 重复创建会报错


示例值：OFFICIAL
SealHorizontalText否String

企业印章横向文字，最多可填15个汉字 (若超过印章最大宽度，优先压缩字间距，其次缩小字号)
横向文字的位置如下图中的"印章横向文字在这里"

image


示例值：横向文字
SealStyle否String

印章样式, 可以选择的样式如下:

  • circle:(默认)圆形印章
  • ellipse:椭圆印章

示例值：circle
SealSize否String

印章尺寸，格式为 宽_高（单位：mm，整数），用于签署时按物理尺寸将印章加盖到PDF。
取值范围：
• 图片上传印章（Image 或 FileToken 非空时生效）：支持自定义尺寸，宽、高均为 10-100 的整数（即 1cm-10cm），宽高比（宽/高）需在 0.1-10 之间。
• 系统生成印章（未传 Image 与 FileToken）：仅支持与SealStyle 匹配的固定枚举值：
  - 圆形印章（SealStyle=cycle）：38_38 / 40_40 / 42_42 / 45_45 / 50_50 / 58_58
  - 椭圆印章（SealStyle=ellipse）：40_30 / 45_30
字段依赖关系：
• 与 SealStyle关联：仅系统生成印章场景下 SealStyle 生效，此时 SealSize 需与 SealStyle对应的枚举匹配；图片上传印章场景 SealStyle 会被忽略，SealSize支持自定义。
• 与 SealType 关联：公章/合同章仅支持圆形枚举，财务/人事/其它章支持圆形或椭圆枚举。
• 与 Image / FileToken 关联：SealSize 是加盖到 PDF的物理尺寸，与上传图片的像素分辨率无绑定，图片会按 SealSize 缩放渲染；建议上传图片的宽高比与 SealSize 保持一致，避免拉伸形变。


示例值：42_42
TaxIdentifyCode否String

企业税号

注:

  • 1.印章类型SealType是INVOICE类型时，此参数才会生效
  • 2.印章类型SealType是INVOICE类型，且该字段没有传入值或传入空时，会取该企业对应的统一社会信用代码作为默认的企业税号（如果是通过授权书授权方式认证的企业，此参数必传不能为空）

示例值：91278105MA09226546
SealDescription否String

印章描述内容


示例值：印章描述说明
Options.N否Array of Option

个性化配置字段，默认不传。

3. 输出参数​

参数名称类型描述
SealIdString

电子印章ID，为32位字符串。
建议开发者保留此印章ID，后续指定签署区印章或者操作印章需此印章ID。


示例值：429b82b4xxxx0a90d45c715bad7
ImageUrlString

电子印章预览链接地址，地址默认失效时间为24小时。

注:图片上传生成的电子印章无预览链接地址


示例值：https://file.ess.tencent.cn/bresource/resource/resource/0/0.PNG?hkey=a6cdd6******64d4
SealOperatorVerifyPathString

人脸验证操作人链接，用法可以参考"跳转电子签小程序配置"，默认为空。


示例值：/pages/guide/index?to=FACE_IDENTIFY&request_token=yDXXXXXXXXXXXXXX&expired_time=1758888888
SealOperatorVerifyQrcodeUrlString

人脸验证操作人二维码链接，扫码后会跳转到腾讯电子签小程序进行人脸验证，默认为空。


示例值：https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=xxxxxxxxxxxxxxxxxxxxxxxxxxx
PreviewFileUrlString

创建印章预览逻辑，返回的是印章加盖在示例文件上的效果图片链接。链接有效期为90天。


示例值：https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.JPG?hkey=xxxxxxxxxx
PreviewPdfUrlString

创建印章预览逻辑，返回的是印章加盖在示例文件上的效果PDF文件链接。链接有效期为90天。


示例值：https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.PDF?hkey=xxxxxxxxxx
RequestIdString唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例​

示例1 创建企业电子印章​

输入示例​

POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateSealByImage
<公共请求参数>

{
    "Agent": {
        "AppId": "yDtKBUUckpf4cgufUuWZO6XBnuF44TXA",
        "ProxyOrganizationOpenId": "123321",
        "ProxyOperator": {
            "OpenId": "123321"
        }
    },
    "SealName": "ceshi",
    "SealSize": "42_42",
    "GenerateSource": "SealGenerateSourceSystem",
    "SealType": "OTHER"
}

输出示例​

{
    "Response": {
        "ImageUrl": "https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.PNG?hkey=fa8b8ce5d7dcf25fc59ffb546fd5cbaf65cb80b79d479c2bda0b9bb91c68019639fc18b2b20f3bf71fd29fb6b3080b622c1d08678eb5baa8dfa64a9d706d86dc88139a296aec0465fa603bb9bee4c68aa2537f19594b55bf5e2b6833d66be0c41647b4dcfd395697586d12538590b898&sign=1cf2a8eacace5317e3f1d9f034b28f02f4f98383d2243d9071e0d4b31747cad2",
        "PreviewFileUrl": "",
        "PreviewPdfUrl": "",
        "SealId": "yD3J7UUckpeq9ku9UED1q6P8DgGXxXR8",
        "SealOperatorVerifyPath": "",
        "SealOperatorVerifyQrcodeUrl": "",
        "RequestId": "18263fb8-9f12-4b46-a646-0807c1442ff2"
    }
}

5. 错误码​

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。

错误码描述
AuthFailureCAM签名/鉴权错误。
FailedOperation操作失败。
FailedOperation.AuthFail鉴权失败。
FailedOperation.ExistSameSealName存在同名印章。
InternalError.SealUpload上传印章失败。
InternalError.System系统错误。
InvalidParameter.Image图片不正确。
InvalidParameter.LimitSealName印章名称长度超出。
InvalidParameter.ParamError参数错误。
InvalidParameter.SensitiveFileContent上传的文件包含敏感（不合规）的内容，请确认。
MissingParameter.OrganizationId企业信息为空。
MissingParameter.SealImage印章图片为空。
MissingParameter.SealName印章名称为空。
OperationDenied操作被拒绝。
OperationDenied.AlreadyHas相关资源已经存证, 无法在创建新的相关资源
ResourceNotFound.Organization机构不存在。
ResourceNotFound.VerifyUser实名用户信息不存在。
UnauthorizedOperation.NoPermissionFeature请升级到对应版本后即可使用该接口。
更多开发者交流反馈