跳到主要内容

创建企业电子印章

1. 接口描述

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

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

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

image

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

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

2. 输入参数

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

参数名称必选类型描述
ActionString公共参数,本接口取值:CreateSealByImage。
VersionString公共参数,本接口取值:2021-05-26。
RegionString公共参数,此参数为可选参数。
AgentAgent关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。

此接口下面信息必填。

  • 渠道应用标识: Agent.AppId
  • 第三方平台子客企业标识: Agent.ProxyOrganizationOpenId
  • 第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId


第三方平台子客企业和员工必须已经经过实名认证
SealNameString电子印章名字,1-50个中文字符
注:同一企业下电子印章名字不能相同
SealImageString电子印章图片base64编码,大小不超过10M(原始图片不超过5M),只支持PNG或JPG图片格式

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

GenerateSourceString电子印章生成方式

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

SealTypeString电子印章类型 , 可选类型如下:
  • OFFICIAL: (默认)公章
  • CONTRACT: 合同专用章;
  • FINANCE: 财务专用章;
  • PERSONNEL: 人事专用章
  • INVOICE: 发票专用章


注: 同企业下只能有一个公章, 重复创建会报错
示例值:OFFICIAL
SealHorizontalTextString企业印章横向文字,最多可填15个汉字 (若超过印章最大宽度,优先压缩字间距,其次缩小字号)
横向文字的位置如下图中的"印章横向文字在这里"

image

示例值:横向文字
SealStyleString印章样式, 可以选择的样式如下:
  • circle:(默认)圆形印章
  • ellipse:椭圆印章

示例值:cycle
SealSizeString印章尺寸取值描述, 可以选择的尺寸如下:
  • 42_42: 圆形企业公章直径42mm, 当SealStyle是圆形的时候才有效
  • 40_40: 圆形企业印章直径40mm, 当SealStyle是圆形的时候才有效
  • 45_30: 椭圆形印章45mm x 30mm, 当SealStyle是椭圆的时候才有效
  • 40_30: 椭圆形印章40mm x 30mm, 当SealStyle是椭圆的时候才有效

示例值:42_42
TaxIdentifyCodeString企业税号
注: 1.印章类型SealType是INVOICE类型时,此参数才会生效
2.印章类型SealType是INVOICE类型,且该字段没有传入值或传入空时,会取该企业对应的统一社会信用代码作为默认的企业税号

3. 输出参数

参数名称类型描述
SealIdString电子印章ID,为32位字符串。
建议开发者保留此印章ID,后续指定签署区印章或者操作印章需此印章ID。
ImageUrlString电子印章预览链接地址,地址默认失效时间为24小时。

注:图片上传生成的电子印章无预览链接地址
注意:此字段可能返回 null,表示取不到有效值。
示例值:https://file.ess.tencent.cn/bresource/resource/resource/0/0.PNG?hkey=a6cdd6******64d4
RequestIdString唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 系统生成印章

GenerateSource为SealGenerateSourceSystem表示系统生成印章

输入示例

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

{
"Agent": {
"AppId": "yDwhxUUckp3gl8j5UuFX33LSNozpRsbi",
"ProxyOrganizationOpenId": "org_dianziqian",
"ProxyOperator": {
"OpenId": "n9527"
},
"ProxyAppId": ""
},
"SealName": "合同专用章",
"GenerateSource": "SealGenerateSourceSystem",
"SealType": "FINANCE",
"SealHorizontalText": "印章横向文字在这里"
}

输出示例

{
"Response": {
"SealId": "yDwi8UUckpo5z4omUyleFeZeadKwB=1Hm",
"ImageUrl": "https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.PNG?hkey=a6c****66264",
"RequestId": "477f4d46-062c-4d72-a2e0-94e5b52b0cc5"
}
}

示例2 创建一个发票专用章

1.设置GenerateSource为SealGenerateSourceSystem 2.设置SealType为发票专用章INVOICE 3.设置SealStyle为椭圆形ellipse 4.设置SealSize为40_30

输入示例

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

{
"Agent": {
"AppId": "yDwhxUUckp3gl8j5UuFX33LSNozpRsbi",
"ProxyOrganizationOpenId": "org_dianziqian",
"ProxyOperator": {
"OpenId": "n9527"
},
"ProxyAppId": ""
},
"SealName": "发票专用章",
"GenerateSource": "SealGenerateSourceSystem",
"SealType": "INVOICE",
"SealStyle": "ellipse",
"SealSize": "40_30"
}

输出示例

{
"Response": {
"SealId": "yDwfwUUgygorm2w0UuS2eARCYT5rtPIi",
"ImageUrl": "https://file.test.ess.tencent.cn/bresource/resource/resource/0/0.PNG?hkey=xxxxxxxxxxxxxx",
"RequestId": "477f4d46-062c-4d72-a2e0-94e5b52b0cc5"
}
}

示例3 通过图片创建电子印章

1.SealImage传递图片的base64编码, GenerateSource不设置 2. 通过图片创建电子印章,需要电子签人工审核

输入示例

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

{
"Agent": {
"AppId": "yDwhxUUckp3gl8j5UuFX33LSNozpRsbi",
"ProxyOrganizationOpenId": "org_dianziqian",
"ProxyOperator": {
"OpenId": "n9527"
},
"ProxyAppId": ""
},
"SealName": "人事专用章",
"SealImage": "iVBORw0KGgoAAAANSUhEUgAAAGwAAABuCAYAAADCrvbGAAABW2lDZXE15yz3uZ6TErkJggg....(图片base64省略)",
"SealType": "PERSONNEL"
}

输出示例

{
"Response": {
"SealId": "yDwi8UUckpo5z4k1UyleFeZEcAE49vb6",
"ImageUrl": "",
"RequestId": "62378bbc-2384-499c-89f6-7835040b24a1"
}
}

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请升级到对应版本后即可使用该接口。
更多开发者交流反馈
购买咨询
微信客服
4006-808-062
4006-808-062