跳到主要内容

创建企业电子印章

1. 接口描述​

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

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

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

image

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

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

2. 输入参数​

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

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

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


示例值：SealGenerateSourceSystem
SealType否String电子印章类型 , 可选类型如下:
  • OFFICIAL: (默认)公章
  • CONTRACT: 合同专用章;
  • FINANCE: 财务专用章;
  • PERSONNEL: 人事专用章
  • INVOICE: 发票专用章


注: 同企业下只能有一个公章, 重复创建会报错
示例值：OFFICIAL
FileName否String电子印章图片文件名称，1-50个中文字符。
示例值：印章图片.png
Image否String电子印章图片base64编码，大小不超过10M（原始图片不超过5M），只支持PNG或JPG图片格式

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


示例值：imagecontentbase64
Width否Integer电子印章宽度,单位px
参数不再启用，系统会设置印章大小为标准尺寸。
示例值：10
Height否Integer电子印章高度,单位px
参数不再启用，系统会设置印章大小为标准尺寸。
示例值：20
Color否String电子印章印章颜色(默认红色RED),RED-红色

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

image

示例值：横向文字
SealChordText否String暂时不支持下弦文字设置
示例值：下弦文字
SealCentralType否String系统生成的印章只支持STAR
示例值：Star
FileToken否String通过文件上传时，服务端生成的电子印章上传图片的token
SealStyle否String印章样式, 可以选择的样式如下:
  • circle:(默认)圆形印章
  • ellipse:椭圆印章

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

示例值：42_42
TaxIdentifyCode否String企业税号
注: 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