跳到主要内容

创建企业电子印章

1. 接口描述

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

本接口(CreateSeal)用于创建企业电子印章,支持创建企业公章,合同章,财务专用章和人事专用章创建。

  1. 可以通过图片创建印章,图片最大5MB
  2. 可以系统创建创建印章, 系统创建的印章样子下图(样式可以调整)

image

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

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

2. 输入参数

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

参数名称必选类型描述
ActionString公共参数,本接口取值:CreateSeal。
VersionString公共参数,本接口取值:2020-11-11。
RegionString公共参数,此参数为可选参数。
OperatorUserInfo执行本接口操作的员工信息。
注: 在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
SealNameString电子印章名字,1-50个中文字符
注:同一企业下电子印章名字不能相同
示例值:公司印章
AgentAgent代理企业和员工的信息。
在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
GenerateSourceString电子印章生成方式

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


示例值:SealGenerateSourceSystem
SealTypeString电子印章类型 , 可选类型如下:
  • OFFICIAL: (默认)公章
  • CONTRACT: 合同专用章;
  • FINANCE: 财务专用章;
  • PERSONNEL: 人事专用章
  • INVOICE: 发票专用章
  • OTHER: 其他
注: 同企业下只能有一个公章, 重复创建会报错
示例值:OFFICIAL
FileNameString电子印章图片文件名称,1-50个中文字符。
示例值:印章图片.png
ImageString电子印章图片base64编码,大小不超过10M(原始图片不超过5M),只支持PNG或JPG图片格式

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


示例值:imagecontentbase64
WidthInteger电子印章宽度,单位px
参数不再启用,系统会设置印章大小为标准尺寸。
示例值:10
HeightInteger电子印章高度,单位px
参数不再启用,系统会设置印章大小为标准尺寸。
示例值:20
ColorString电子印章印章颜色(默认红色RED),RED-红色

系统目前只支持红色印章创建。
示例值:Red
SealHorizontalTextString企业印章横向文字,最多可填15个汉字 (若超过印章最大宽度,优先压缩字间距,其次缩小字号)
横向文字的位置如下图中的"印章横向文字在这里"

image

示例值:横向文字
SealChordTextString暂时不支持下弦文字设置
示例值:下弦文字
SealCentralTypeString系统生成的印章只支持STAR
示例值:Star
FileTokenString通过文件上传时,服务端生成的电子印章上传图片的token
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。
可登录腾讯电子签控制台,在 "印章"->"印章中心"选择查看的印章,在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
示例值:429b82b40900a9f870a90d45c715bad7
RequestIdString唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

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

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

输入示例

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

{
"Operator": {
"UserId": "user-id-xxxx"
},
"GenerateSource": "SealGenerateSourceSystem",
"SealType": "INVOICE",
"SealName": "这是一个发票专用章",
"SealHorizontalText": "",
"SealStyle": "ellipse",
"SealSize": "SealSize"
}

输出示例

{
"Response": {
"RequestId": "s170xxxxxxxx1760718",
"SealId": "yDwfwUUgygorm2w0UuS2eARCYT5rtPIi"
}
}

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

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

输入示例

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

{
"Operator": {
"UserId": "11234567890123456789012345678901"
},
"SealName": "公司印章",
"Image": "imagecontentbase64",
"Width": 10,
"Height": 20,
"Color": "Red",
"SealType": "OFFICIAL",
"SealHorizontalText": "印章横向文字",
"SealChordText": "下弦文字",
"SealCentralType": "Star",
"FileName": "印章图片.png"
}

输出示例

{
"Response": {
"SealId": "429b82b4xxxx0a90d45c715bad7",
"RequestId": "62DDFFC6xxxxxA6-59152E3D129A"
}
}

示例3 通过企业印章横向文字创建椭圆形印章

通过企业印章横向文字创建椭圆形印章

输入示例

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

{
"Operator": {
"UserId": "user-id-xxxx"
},
"GenerateSource": "SealGenerateSourceSystem",
"SealType": "OFFICIAL",
"SealName": "这是一个椭圆形电子印章名称",
"SealHorizontalText": "测试专业用椭圆印章一号",
"SealStyle": "ellipse"
}

输出示例

{
"Response": {
"SealId": "yDxxx1234556677xxx",
"RequestId": "s1692775850696494255"
}
}

示例4 通过企业印章横向文字创建企业圆形公章

通过企业印章横向文字创建企业圆形公章

输入示例

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

{
"Operator": {
"UserId": "user-id-xxxx"
},
"GenerateSource": "SealGenerateSourceSystem",
"SealType": "OFFICIAL",
"SealName": "这是一个圆形电子印章名称",
"SealHorizontalText": "测试专业用章圆形横向一号",
"SealStyle": "circle"
}

输出示例

{
"Response": {
"SealId": "yDxxx12345xxx",
"RequestId": "s1692775850696494235"
}
}

5. 错误码

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

错误码描述
FailedOperation操作失败。
InternalError内部错误。
InternalError.Decryption解密失败。
InternalError.DependsApi依赖的第三方API返回错误。
InternalError.DependsDb数据库执行错误。
InternalError.Encryption加密失败。
InternalError.System系统错误,请稍后重试。
InvalidParameter.ParamError参数错误。
OperationDenied操作被拒绝。
OperationDenied.Forbid禁止此项操作。
OperationDenied.NoLogin用户未登录,请先登录后再操作。
OperationDenied.SubOrgNotJoin子企业暂未加入。
更多开发者交流反馈
购买咨询
微信客服
4006-808-062
4006-808-062