创建企业电子印章

1. 接口描述

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

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

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

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

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个汉字 (若超过印章最大宽度，优先压缩字间距，其次缩小字号) 横向文字的位置如下图中的"印章横向文字在这里" 示例值：横向文字
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. 输出参数

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. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

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