tencentcloud-sdk-nodejs-ess 4.0.691 → 4.0.692

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -24,10 +24,12 @@ export interface CreateSealRequest {
24
24
  GenerateSource?: string;
25
25
  /**
26
26
  * 电子印章类型:
27
- OFFICIAL-公章;
28
- CONTRACT-合同专用章;
29
- FINANCE-合财务专用章;
30
- PERSONNEL-人事专用章.
27
+ <ul>
28
+ <li>OFFICIAL-公章;</li>
29
+ <li>CONTRACT-合同专用章;</li>
30
+ <li>FINANCE-合财务专用章;</li>
31
+ <li>PERSONNEL-人事专用章.</li>
32
+ </ul>
31
33
  */
32
34
  SealType?: string;
33
35
  /**
@@ -73,18 +75,22 @@ export interface CreateSealRequest {
73
75
  */
74
76
  FileToken?: string;
75
77
  /**
76
- * 印章样式:
78
+ * 印章样式,取值如下:
77
79
 
78
- cycle:圆形印章;
79
- ellipse:椭圆印章;
80
- 注:默认圆形印章
80
+ <ul>
81
+ <li>cycle:圆形印章;</li>
82
+ <li>ellipse:椭圆印章;</li>
83
+ <li>注:默认圆形印章</li>
84
+ </ul>
81
85
  */
82
86
  SealStyle?: string;
83
87
  /**
84
88
  * 印章尺寸取值描述:
85
- 42_42 圆形企业公章直径42mm;
86
- 40_40 圆形企业印章直径40mm;
87
- 45_30 椭圆形印章45mm x 30mm;
89
+ <ul>
90
+ <li>42_42 圆形企业公章直径42mm;</li>
91
+ <li>40_40 圆形企业印章直径40mm;</li>
92
+ <li>45_30 椭圆形印章45mm x 30mm;</li>
93
+ </ul>
88
94
  */
89
95
  SealSize?: string;
90
96
  }
@@ -164,24 +170,26 @@ export interface CreatePreparedPersonalEsignRequest {
164
170
  */
165
171
  UserName: string;
166
172
  /**
167
- * 身份证件号码
173
+ * 证件号码,应符合以下规则
174
+ <ul><li>居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。</li>
175
+ <li>港澳居民来往内地通行证号码应为9位字符串,第1位为“C”,第2位为英文字母(但“I”、“O”除外),后7位为阿拉伯数字。</li>
176
+ <li>港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。</li></ul>
168
177
  */
169
178
  IdCardNumber: string;
170
179
  /**
171
- * 印章名称
180
+ * 印章名称,长度1-50个字。
172
181
  */
173
182
  SealName: string;
174
183
  /**
175
- * 调用方用户信息,userId 必填。支持填入集团子公司经办人 userId代发合同。
184
+ * 执行本接口操作的员工信息。
185
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
176
186
  */
177
187
  Operator?: UserInfo;
178
188
  /**
179
- * 身份证件类型:
180
- ID_CARD 身份证
181
- PASSPORT 护照
182
- HONGKONG_AND_MACAO 中国香港
183
- FOREIGN_ID_CARD 境外身份
184
- HONGKONG_MACAO_AND_TAIWAN 中国台湾
189
+ * 证件类型,支持以下类型
190
+ <ul><li>ID_CARD : 居民身份证 (默认值)</li>
191
+ <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
192
+ <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
185
193
  */
186
194
  IdCardType?: string;
187
195
  /**
@@ -213,10 +221,12 @@ export interface CreatePreparedPersonalEsignRequest {
213
221
  */
214
222
  SealColor?: string;
215
223
  /**
216
- * 是否处理印章
217
- 默认不做印章处理。
218
- 取值:false:不做任何处理;
219
- true:做透明化处理和颜色增强。
224
+ * 是否处理印章,默认不做印章处理。
225
+ 取值如下:
226
+ <ul>
227
+ <li>false:不做任何处理;</li>
228
+ <li>true:做透明化处理和颜色增强。</li>
229
+ </ul>
220
230
  */
221
231
  ProcessSeal?: boolean;
222
232
  /**
@@ -226,7 +236,8 @@ export interface CreatePreparedPersonalEsignRequest {
226
236
  */
227
237
  FileId?: string;
228
238
  /**
229
- * 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
239
+ * 代理企业和员工的信息。
240
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
230
241
  */
231
242
  Agent?: Agent;
232
243
  /**
@@ -440,62 +451,62 @@ export interface CreateIntegrationEmployeesRequest {
440
451
  export interface CreateFlowOption {
441
452
  /**
442
453
  * 是否允许修改发起合同时确认弹窗的合同信息(合同名称、合同类型、签署截止时间),若不允许编辑,则表单字段将被禁止输入。
443
- <br/>true:允许编辑(默认),<br/>false:不允许编辑<br/>默认:false:不允许编辑
454
+ <br/>true:允许编辑<br/>false:不允许编辑(默认值)<br/>
444
455
  */
445
456
  CanEditFlow?: boolean;
446
457
  /**
447
458
  * 是否允许编辑模板控件
448
459
  <br/>true:允许编辑模板控件信息
449
- <br/>false:不允许编辑模板控件信息
450
- <br/>默认false:不允许编辑模板控件信息
460
+ <br/>false:不允许编辑模板控件信息(默认值)
461
+ <br/>
451
462
  */
452
463
  CanEditFormField?: boolean;
453
464
  /**
454
465
  * 发起页面隐藏合同名称展示
455
466
  <br/>true:发起页面隐藏合同名称展示
456
- <br/>false:发起页面不隐藏合同名称展示
457
- <br/>默认false:发起页面不隐藏合同名称展示
467
+ <br/>false:发起页面不隐藏合同名称展示(默认值)
468
+ <br/>
458
469
  */
459
470
  HideShowFlowName?: boolean;
460
471
  /**
461
472
  * 发起页面隐藏合同类型展示
462
473
  <br/>true:发起页面隐藏合同类型展示
463
- <br/>false:发起页面不隐藏合同类型展示
464
- <br/>默认false:发起页面不隐藏合同类型展示
474
+ <br/>false:发起页面不隐藏合同类型展示(默认值)
475
+ <br/>
465
476
 
466
477
  */
467
478
  HideShowFlowType?: boolean;
468
479
  /**
469
480
  * 发起页面隐藏合同截止日期展示
470
481
  <br/>true:发起页面隐藏合同截止日期展示
471
- <br/>false:发起页面不隐藏合同截止日期展示
472
- <br/>默认false:发起页面不隐藏合同截止日期展示
482
+ <br/>false:发起页面不隐藏合同截止日期展示(默认值)
483
+ <br/>
473
484
  */
474
485
  HideShowDeadline?: boolean;
475
486
  /**
476
487
  * 发起页面允许跳过添加签署人环节
477
488
  <br/>true:发起页面允许跳过添加签署人环节
478
- <br/>false:发起页面不允许跳过添加签署人环节
479
- <br/>默认false:发起页面不允许跳过添加签署人环节
489
+ <br/>false:发起页面不允许跳过添加签署人环节(默认值)
490
+ <br/>
480
491
 
481
492
  */
482
493
  CanSkipAddApprover?: boolean;
483
494
  /**
484
495
  * 文件发起页面跳过文件上传步骤
485
496
  <br/>true:文件发起页面跳过文件上传步骤
486
- <br/>false:文件发起页面不跳过文件上传步骤
487
- <br/>默认false:文件发起页面不跳过文件上传步骤
497
+ <br/>false:文件发起页面不跳过文件上传步骤(默认值)
498
+ <br/>
488
499
  */
489
500
  SkipUploadFile?: boolean;
490
501
  /**
491
502
  * 禁止编辑填写控件
492
503
  <br/>true:禁止编辑填写控件
493
- <br/>false:允许编辑填写控件
494
- <br/>默认false:允许编辑填写控件
504
+ <br/>false:允许编辑填写控件(默认值)
505
+ <br/>
495
506
  */
496
507
  ForbidEditFillComponent?: boolean;
497
508
  /**
498
- * 定制化发起合同弹窗的描述信息,描述信息最长500
509
+ * 定制化发起合同弹窗的描述信息,描述信息最长500字符
499
510
 
500
511
  */
501
512
  CustomCreateFlowDescription?: string;
@@ -983,7 +994,7 @@ export interface CreateFlowGroupByFilesRequest {
983
994
  */
984
995
  export interface DescribeFlowComponentsResponse {
985
996
  /**
986
- * 流程关联的填写控件信息,按照参与方进行分类返回。
997
+ * 合同流程关联的填写控件信息,按照参与方进行分类返回。
987
998
  注意:此字段可能返回 null,表示取不到有效值。
988
999
  */
989
1000
  RecipientComponentInfos?: Array<RecipientComponentInfo>;
@@ -1188,7 +1199,8 @@ export interface CreateDocumentResponse {
1188
1199
  /**
1189
1200
  * 合同预览链接URL。
1190
1201
 
1191
- 注:如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL
1202
+ 注: `1.如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL`
1203
+ `2.当使用的模板中存在动态表格控件时,预览结果中没有动态表格的填写内容`
1192
1204
  注意:此字段可能返回 null,表示取不到有效值。
1193
1205
  */
1194
1206
  PreviewFileUrl?: string;
@@ -1710,40 +1722,44 @@ export interface CreateIntegrationDepartmentResponse {
1710
1722
  */
1711
1723
  export interface DescribeFlowTemplatesRequest {
1712
1724
  /**
1713
- * 调用方员工/经办人信息
1714
- UserId 必填,在企业控制台组织架构中可以查到员工的UserId
1715
- 注:请保证员工有相关的角色权限
1725
+ * 执行本接口操作的员工信息。
1726
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
1716
1727
  */
1717
1728
  Operator: UserInfo;
1718
1729
  /**
1719
- * 代理相关应用信息
1720
- 如集团主企业代子企业操作的场景中ProxyOrganizationId必填
1730
+ * 代理企业和员工的信息。
1731
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
1721
1732
  */
1722
1733
  Agent?: Agent;
1723
1734
  /**
1724
- * 查询内容类型
1725
- 0-模板列表及详情(默认)
1726
- 1-仅模板列表
1735
+ * 查询内容控制
1736
+
1737
+ <ul><li>**0**:模板列表及详情(默认)</li>
1738
+ <li>**1**:仅模板列表</li></ul>
1727
1739
  */
1728
1740
  ContentType?: number;
1729
1741
  /**
1730
1742
  * 搜索条件,本字段用于指定模板Id进行查询。
1731
- Key:template-id
1732
- Values:需要查询的模板Id列表
1743
+ Key:template-id Values:需要查询的模板Id列表
1733
1744
  */
1734
1745
  Filters?: Array<Filter>;
1735
1746
  /**
1736
- * 查询结果分页返回,此处指定第几页,如果不传默从第一页返回。页码从0开始,即首页为0。
1747
+ * 查询结果分页返回,指定从第几页返回数据,和Limit参数配合使用。
1748
+
1749
+ 注:`1.offset从0开始,即第一页为0。`
1750
+ `2.默认从第一页返回。`
1737
1751
  */
1738
1752
  Offset?: number;
1739
1753
  /**
1740
- * 指定每页多少条数据,如果不传默认为20,单页最大200。
1754
+ * 指定每页返回的数据条数,和Offset参数配合使用。
1755
+
1756
+ 注:`1.默认值为20,单页做大值为200。`
1741
1757
  */
1742
1758
  Limit?: number;
1743
1759
  /**
1744
- * 用于查询指定应用号下单模板列表。
1745
- ApplicationId不为空,查询指定应用下的模板列表
1746
- ApplicationId为空,查询所有应用下的模板列表
1760
+ * 指定查询的应用号,指定后查询该应用号下的模板列表。
1761
+
1762
+ 注:`1.ApplicationId为空时,查询所有应用下的模板列表。`
1747
1763
  */
1748
1764
  ApplicationId?: string;
1749
1765
  /**
@@ -2105,7 +2121,8 @@ export interface SignQrCode {
2105
2121
  */
2106
2122
  export interface CreateSealPolicyResponse {
2107
2123
  /**
2108
- * 最终授权成功的。其他的跳过的是已经授权了的
2124
+ * 最终授权成功的用户ID,在腾讯电子签平台的唯一身份标识,为32位字符串。
2125
+ 可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
2109
2126
  */
2110
2127
  UserIds?: Array<string>;
2111
2128
  /**
@@ -2447,20 +2464,29 @@ export interface RegisterInfo {
2447
2464
  */
2448
2465
  export interface DescribeFileUrlsRequest {
2449
2466
  /**
2450
- * 调用方用户信息,UserId 必填
2467
+ * 执行本接口操作的员工信息。
2468
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
2451
2469
  */
2452
2470
  Operator: UserInfo;
2453
2471
  /**
2454
2472
  * 文件对应的业务类型,目前支持:
2455
- - 流程 "FLOW",如需下载合同文件请选择此项
2456
- - 模板 "TEMPLATE"
2457
- - 文档 "DOCUMENT"
2458
- - 印章 “SEAL”
2473
+ <ul>
2474
+ <li>FLOW 如需下载合同文件请选择此项</li>
2475
+ <li>TEMPLATE 如需下载模板文件请选择此项</li>
2476
+ <li>DOCUMENT 如需下载文档文件请选择此项</li>
2477
+ <li>SEAL 如需下载印章图片请选择此项</li>
2478
+ </ul>
2459
2479
  */
2460
2480
  BusinessType: string;
2461
2481
  /**
2462
- * 业务编号的数组,如流程编号、模板编号、文档编号、印章编号。如需下载合同文件请传入FlowId
2463
- 最大支持20个资源
2482
+ * 业务编号的数组,取值如下:
2483
+ <ul>
2484
+ <li>流程编号</li>
2485
+ <li>模板编号</li>
2486
+ <li>文档编号</li>
2487
+ <li>印章编号</li>
2488
+ <li>如需下载合同文件请传入FlowId,最大支持20个资源</li>
2489
+ </ul>
2464
2490
  */
2465
2491
  BusinessIds: Array<string>;
2466
2492
  /**
@@ -2468,15 +2494,20 @@ export interface DescribeFileUrlsRequest {
2468
2494
  */
2469
2495
  FileName?: string;
2470
2496
  /**
2471
- * 文件类型,"JPG", "PDF","ZIP"等
2497
+ * 要下载的文件类型,取值如下:
2498
+ <ul>
2499
+ <li>JPG</li>
2500
+ <li>PDF</li>
2501
+ <li>ZIP</li>
2502
+ </ul>
2472
2503
  */
2473
2504
  FileType?: string;
2474
2505
  /**
2475
- * 指定资源起始偏移量,默认0
2506
+ * 指定分页返回第几页的数据,如果不传默认返回第一页,页码从 0 开始,即首页为 0,最大 1000。
2476
2507
  */
2477
2508
  Offset?: number;
2478
2509
  /**
2479
- * 指定资源数量,查询全部资源则传入-1
2510
+ * 指定分页每页返回的数据条数,如果不传默认为 20,单页最大支持 100。
2480
2511
  */
2481
2512
  Limit?: number;
2482
2513
  /**
@@ -3055,13 +3086,15 @@ export interface RecipientComponentInfo {
3055
3086
  RecipientId?: string;
3056
3087
  /**
3057
3088
  * 参与方填写状态
3058
- 0-未填写
3059
- 1-已填写
3089
+ <ul><li>0-未填写</li>
3090
+ <li>1-已填写</li></ul>
3060
3091
  注意:此字段可能返回 null,表示取不到有效值。
3061
3092
  */
3062
3093
  RecipientFillStatus?: string;
3063
3094
  /**
3064
3095
  * 是否为发起方
3096
+ <ul><li>true-发起方</li>
3097
+ <li>false-参与方</li></ul>
3065
3098
  注意:此字段可能返回 null,表示取不到有效值。
3066
3099
  */
3067
3100
  IsPromoter?: boolean;
@@ -3118,15 +3151,19 @@ export interface CreateIntegrationRoleResponse {
3118
3151
  */
3119
3152
  export interface DescribeFlowComponentsRequest {
3120
3153
  /**
3121
- * 操作者信息
3154
+ * 执行本接口操作的员工信息。
3155
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
3122
3156
  */
3123
3157
  Operator: UserInfo;
3124
3158
  /**
3125
- * 流程(合同)的编号
3159
+ * 合同流程ID,为32位字符串。
3160
+ 建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
3161
+ 可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
3126
3162
  */
3127
3163
  FlowId: string;
3128
3164
  /**
3129
- * 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
3165
+ * 代理企业和员工的信息。
3166
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
3130
3167
  */
3131
3168
  Agent?: Agent;
3132
3169
  }
@@ -3283,6 +3320,7 @@ export interface CreateDocumentRequest {
3283
3320
  * 是否为预览模式,取值如下:
3284
3321
  <ul><li> **false**:非预览模式(默认),会产生合同流程并返回合同流程编号FlowId。</li>
3285
3322
  <li> **true**:预览模式,不产生合同流程,不返回合同流程编号FlowId,而是返回预览链接PreviewUrl,有效期为300秒,用于查看真实发起后合同的样子。</li></ul>
3323
+ 注: `当使用的模板中存在动态表格控件时,预览结果中没有动态表格的填写内容`
3286
3324
  */
3287
3325
  NeedPreview?: boolean;
3288
3326
  /**
@@ -3327,7 +3365,8 @@ export interface RemindFlowRecords {
3327
3365
  */
3328
3366
  export interface CreatePreparedPersonalEsignResponse {
3329
3367
  /**
3330
- * 导入生成的印章ID
3368
+ * 导入生成的印章ID,为32位字符串。
3369
+ 建议开发者保存此印章ID,开头实名认证后,通过此 ID查询导入的印章。
3331
3370
  */
3332
3371
  SealId?: string;
3333
3372
  /**
@@ -3834,58 +3873,46 @@ export interface CreateIntegrationUserRolesRequest {
3834
3873
  */
3835
3874
  export interface FlowDetailInfo {
3836
3875
  /**
3837
- * 合同(流程)的ID
3876
+ * 合同流程ID,为32位字符串。
3838
3877
  */
3839
3878
  FlowId?: string;
3840
3879
  /**
3841
- * 合同(流程)的名字
3880
+ * 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
3842
3881
  */
3843
3882
  FlowName?: string;
3844
3883
  /**
3845
- * 合同(流程)的类型
3884
+ * 合同流程的类别分类(如销售合同/入职合同等)。
3846
3885
  注意:此字段可能返回 null,表示取不到有效值。
3847
3886
  */
3848
3887
  FlowType?: string;
3849
3888
  /**
3850
- * 流程状态
3851
- - 0 还没有发起
3852
- - 1 待签署
3853
- - 2 部分签署
3854
- - 3 已拒签
3855
- - 4 已签署
3856
- - 5 已过期
3857
- - 6 已撤销
3858
- - 7 还没有预发起
3859
- - 8 等待填写
3860
- - 9 部分填写
3861
- - 10 拒填
3862
- - 21 已解除
3889
+ * 合同流程当前的签署状态, 会存在下列的状态值 <ul><li> **0** : 未开启流程(合同中不存在填写环节)</li> <li> **1** : 待签署</li> <li> **2** : 部分签署</li> <li> **3** : 已拒签</li> <li> **4** : 已签署</li> <li> **5** : 已过期</li> <li> **6** : 已撤销</li> <li> **7** : 未开启流程(合同中存在填写环节)</li> <li> **8** : 等待填写</li> <li> **9** : 部分填写</li> <li> **10** : 已拒填</li> <li> **21** : 已解除</li></ul>
3863
3890
  */
3864
3891
  FlowStatus?: number;
3865
3892
  /**
3866
- * 合同(流程)的信息
3893
+ * 当合同流程状态为已拒签(即 FlowStatus=3)或已撤销(即 FlowStatus=6)时,此字段 FlowMessage 为拒签或撤销原因。
3867
3894
  注意:此字段可能返回 null,表示取不到有效值。
3868
3895
  */
3869
3896
  FlowMessage?: string;
3870
3897
  /**
3871
- * 流程的描述
3898
+ * 合同流程描述信息。
3872
3899
  注意:此字段可能返回 null,表示取不到有效值。
3873
3900
  */
3874
3901
  FlowDescription?: string;
3875
3902
  /**
3876
- * 合同(流程)的创建时间戳,单位秒
3903
+ * 合同流程的创建时间戳,格式为Unix标准时间戳(秒)。
3877
3904
  */
3878
3905
  CreatedOn?: number;
3879
3906
  /**
3880
- * 合同(流程)的签署方数组
3907
+ * 合同流程的签署方数组
3881
3908
  */
3882
3909
  FlowApproverInfos?: Array<FlowApproverDetail>;
3883
3910
  /**
3884
- * 合同(流程)的关注方信息列表
3911
+ * 合同流程的关注方信息数组
3885
3912
  */
3886
3913
  CcInfos?: Array<FlowApproverDetail>;
3887
3914
  /**
3888
- * 合同发起人UserId
3915
+ * 合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。
3889
3916
  注意:此字段可能返回 null,表示取不到有效值。
3890
3917
  */
3891
3918
  Creator?: string;
@@ -4082,13 +4109,20 @@ export interface Recipient {
4082
4109
  */
4083
4110
  export interface VerifyPdfRequest {
4084
4111
  /**
4085
- * 流程ID
4112
+ * 合同流程ID,为32位字符串。
4113
+ 可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
4086
4114
  */
4087
4115
  FlowId: string;
4088
4116
  /**
4089
- * 调用方用户信息,userId 必填
4117
+ * 执行本接口操作的员工信息。
4118
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
4090
4119
  */
4091
4120
  Operator?: UserInfo;
4121
+ /**
4122
+ * 代理企业和员工的信息。
4123
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
4124
+ */
4125
+ Agent?: Agent;
4092
4126
  }
4093
4127
  /**
4094
4128
  * 绑定角色失败信息
@@ -4490,7 +4524,7 @@ export interface CreateWebThemeConfigRequest {
4490
4524
  */
4491
4525
  ThemeType: string;
4492
4526
  /**
4493
- * 主题配置
4527
+ * 电子签logo是否展示,主体颜色等配置项
4494
4528
  */
4495
4529
  WebThemeConfig: WebThemeConfig;
4496
4530
  /**
@@ -4504,7 +4538,8 @@ export interface CreateWebThemeConfigRequest {
4504
4538
  */
4505
4539
  export interface DeleteSealPoliciesRequest {
4506
4540
  /**
4507
- * 调用方用户信息,userId 必填
4541
+ * 执行本接口操作的员工信息。
4542
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
4508
4543
  */
4509
4544
  Operator: UserInfo;
4510
4545
  /**
@@ -4512,15 +4547,20 @@ export interface DeleteSealPoliciesRequest {
4512
4547
  */
4513
4548
  PolicyIds?: Array<string>;
4514
4549
  /**
4515
- * 印章ID。这个参数跟上面的PolicyIds其中一个必填,另外一个可选填
4550
+ * 电子印章ID,为32位字符串。
4551
+ 建议开发者保留此印章ID,后续指定签署区印章或者操作印章需此印章ID。
4552
+ 可登录腾讯电子签控制台,在 "印章"->"印章中心"选择查看的印章,在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
4553
+ 注:印章ID。这个参数跟上面的PolicyIds其中一个必填,另外一个可选填。
4516
4554
  */
4517
4555
  SealId?: string;
4518
4556
  /**
4519
- * 待授权的员工ID
4557
+ * 待授权的员工ID,员工在腾讯电子签平台的唯一身份标识,为32位字符串。
4558
+ 可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
4520
4559
  */
4521
4560
  UserIds?: Array<string>;
4522
4561
  /**
4523
- * 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
4562
+ * 代理企业和员工的信息。
4563
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
4524
4564
  */
4525
4565
  Agent?: Agent;
4526
4566
  }
@@ -4605,7 +4645,7 @@ export interface IntegrateRole {
4605
4645
  */
4606
4646
  export interface CreatePrepareFlowResponse {
4607
4647
  /**
4608
- * 快速发起预览链接,有效期5分钟
4648
+ * 发起流程的web页面链接,有效期5分钟
4609
4649
  */
4610
4650
  Url?: string;
4611
4651
  /**
@@ -4771,7 +4811,9 @@ export interface StartFlowRequest {
4771
4811
  */
4772
4812
  export interface CreateSealResponse {
4773
4813
  /**
4774
- * 电子印章编号
4814
+ * 电子印章ID,为32位字符串。
4815
+ 建议开发者保留此印章ID,后续指定签署区印章或者操作印章需此印章ID。
4816
+ 可登录腾讯电子签控制台,在 "印章"->"印章中心"选择查看的印章,在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
4775
4817
  */
4776
4818
  SealId?: string;
4777
4819
  /**
@@ -4784,62 +4826,67 @@ export interface CreateSealResponse {
4784
4826
  */
4785
4827
  export interface CreatePrepareFlowRequest {
4786
4828
  /**
4787
- * 调用方用户信息,userId 必填
4829
+ * 执行本接口操作的员工信息。使用此接口时,必须填写userId
4830
+ 支持填入集团子公司经办人 userId 代发合同。
4831
+
4832
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
4788
4833
  */
4789
4834
  Operator: UserInfo;
4790
4835
  /**
4791
- * 资源id,与ResourceType对应
4836
+ * 资源id,与ResourceType相对应,取值范围:
4837
+ <ul>
4838
+ <li>文件Id(通过UploadFiles获取文件资源Id)</li>
4839
+ <li>模板Id</li>
4840
+ </ul>
4792
4841
  */
4793
4842
  ResourceId: string;
4794
4843
  /**
4795
- * 合同名称
4844
+ * 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
4845
+
4796
4846
  */
4797
4847
  FlowName: string;
4798
4848
  /**
4799
- * 是否顺序签署
4800
- true:无序签
4801
- false:顺序签
4849
+ * 合同流程的签署顺序类型:
4850
+ <ul><li> **false**:(默认)有序签署, 本合同多个参与人需要依次签署 </li>
4851
+ <li> **true**:无序签署, 本合同多个参与人没有先后签署限制</li></ul>
4802
4852
  */
4803
4853
  Unordered?: boolean;
4804
4854
  /**
4805
- * 签署流程的签署截止时间。
4806
- 值为unix时间戳,精确到秒
4807
- 不传默认为当前时间一年后
4855
+ * 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
4856
+
4808
4857
  */
4809
4858
  Deadline?: number;
4810
4859
  /**
4811
4860
  * 用户自定义合同类型Id
4812
4861
 
4813
- 该id为电子签企业内的合同类型id, 可以在自定义合同类型处获取
4862
+ 该id为电子签企业内的合同类型id, 可以在控制台-合同-自定义合同类型处获取
4863
+ 注: `该参数如果和FlowType同时传,以该参数优先生效`
4814
4864
  */
4815
4865
  UserFlowTypeId?: string;
4816
4866
  /**
4817
- * 合同类型名称
4818
- 该字段用于客户自定义合同类型
4819
- 建议使用时指定合同类型,便于之后合同分类以及查看
4820
- 如果合同类型与自定义的合同类型描述一致,会自动归类到自定义的合同类型处,如果不一致,则会创建一个新的自定义合同类型
4867
+ * 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为200个字符,仅限中文、字母、数字和下划线组成。
4821
4868
  */
4822
4869
  FlowType?: string;
4823
4870
  /**
4824
- * 签署流程参与者信息,最大限制50
4871
+ * 合同流程的参与方列表,最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息,具体定义可以参考开发者中心的ApproverInfo结构体。
4872
+
4873
+ 如果合同流程是有序签署,Approvers列表中参与人的顺序就是默认的签署顺序,请确保列表中参与人的顺序符合实际签署顺序。
4825
4874
  */
4826
4875
  Approvers?: Array<FlowCreateApprover>;
4827
4876
  /**
4828
- * 打开智能添加填写区
4829
- 默认开启,打开:"OPEN"
4830
- 关闭:"CLOSE"
4877
+ * 开启或者关闭智能添加填写区:
4878
+ <ul><li> **OPEN**:开启(默认值)</li>
4879
+ <li> **CLOSE**:关闭</li></ul>
4831
4880
  */
4832
4881
  IntelligentStatus?: string;
4833
4882
  /**
4834
- * 资源类型,
4835
- 1:模板
4836
- 2:文件,
4837
- 不传默认为2:文件
4883
+ * 资源类型,取值有:
4884
+ <ul><li> **1**:模板</li>
4885
+ <li> **2**:文件(默认值)</li></ul>
4838
4886
  */
4839
4887
  ResourceType?: number;
4840
4888
  /**
4841
- * 发起方填写控件
4842
- 该类型控件由发起方完成填写
4889
+ * 该字段已废弃,请使用InitiatorComponents
4843
4890
  */
4844
4891
  Components?: Component;
4845
4892
  /**
@@ -4849,31 +4896,44 @@ export interface CreatePrepareFlowRequest {
4849
4896
  */
4850
4897
  FlowOption?: CreateFlowOption;
4851
4898
  /**
4852
- * 是否开启发起方签署审核
4853
- true:开启发起方签署审核
4854
- false:不开启发起方签署审核
4855
- 默认false:不开启发起方签署审核
4899
+ * 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
4900
+ <ul><li> **false**:(默认)不需要审批,直接签署。</li>
4901
+ <li> **true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。</li></ul>
4902
+ 企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
4903
+ <ul><li> 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。</li>
4904
+ <li> 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。</li></ul>
4905
+ 注:`此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同`
4856
4906
  */
4857
4907
  NeedSignReview?: boolean;
4858
4908
  /**
4859
- * 开启发起方发起合同审核
4860
- true:开启发起方发起合同审核
4861
- false:不开启发起方发起合同审核
4862
- 默认false:不开启发起方发起合同审核
4909
+ * 发起方企业的签署人进行发起操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。
4910
+
4911
+ 若设置为true,发起审核结果需通过接口 CreateFlowSignReview 通知电子签,审核通过后,发起方企业签署人方可进行发起操作,否则会阻塞其发起操作。
4912
+
4913
+
4863
4914
  */
4864
4915
  NeedCreateReview?: boolean;
4865
4916
  /**
4866
- * 用户自定义参数
4917
+ * 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 20480长度。
4918
+
4919
+ 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
4867
4920
  */
4868
4921
  UserData?: string;
4869
4922
  /**
4870
- * 合同id,用于通过已web页面发起的合同id快速生成一个web发起合同链接
4923
+ * 合同Id:用于通过一个已发起的合同快速生成一个发起流程web链接
4924
+ 注: `该参数必须是一个待发起审核的合同id,并且还未审核通过`
4871
4925
  */
4872
4926
  FlowId?: string;
4873
4927
  /**
4874
- * 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
4928
+ * 代理企业和员工的信息。
4929
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
4875
4930
  */
4876
4931
  Agent?: Agent;
4932
+ /**
4933
+ * 模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
4934
+
4935
+ */
4936
+ InitiatorComponents?: Array<Component>;
4877
4937
  }
4878
4938
  /**
4879
4939
  * 签署人个性化能力信息
@@ -4913,7 +4973,8 @@ export interface CreateEmbedWebUrlResponse {
4913
4973
  */
4914
4974
  export interface CreateSealPolicyRequest {
4915
4975
  /**
4916
- * 调用方用户信息,userId 必填
4976
+ * 执行本接口操作的员工信息。
4977
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
4917
4978
  */
4918
4979
  Operator: UserInfo;
4919
4980
  /**
@@ -4921,7 +4982,9 @@ export interface CreateSealPolicyRequest {
4921
4982
  */
4922
4983
  Users: Array<UserInfo>;
4923
4984
  /**
4924
- * 印章ID
4985
+ * 电子印章ID,为32位字符串。
4986
+ 建议开发者保留此印章ID,后续指定签署区印章或者操作印章需此印章ID。
4987
+ 可登录腾讯电子签控制台,在 "印章"->"印章中心"选择查看的印章,在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
4925
4988
  */
4926
4989
  SealId: string;
4927
4990
  /**
@@ -4937,7 +5000,8 @@ export interface CreateSealPolicyRequest {
4937
5000
  */
4938
5001
  Policy?: string;
4939
5002
  /**
4940
- * 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
5003
+ * 代理企业和员工的信息。
5004
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
4941
5005
  */
4942
5006
  Agent?: Agent;
4943
5007
  }
@@ -4946,19 +5010,24 @@ export interface CreateSealPolicyRequest {
4946
5010
  */
4947
5011
  export interface DescribeOrganizationSealsRequest {
4948
5012
  /**
4949
- * 调用方用户信息,userId 必填
5013
+ * 执行本接口操作的员工信息。
5014
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
4950
5015
  */
4951
5016
  Operator: UserInfo;
4952
5017
  /**
4953
- * 返回最大数量,最大为100
5018
+ * 指定分页每页返回的数据条数,如果不传默认为 20,单页最大支持 200。
4954
5019
  */
4955
5020
  Limit: number;
4956
5021
  /**
4957
- * 偏移量,默认为0,最大为20000
5022
+ * 指定分页返回第几页的数据,如果不传默认返回第一页,页码从 0 开始,即首页为 0,最大 20000
4958
5023
  */
4959
5024
  Offset?: number;
4960
5025
  /**
4961
- * 查询信息类型,为0时不返回授权用户,为1时返回
5026
+ * 查询信息类型,取值如下:
5027
+ <ul>
5028
+ <li>0不返回授权用户</li>
5029
+ <li>1返回授权用户信息</li>
5030
+ </ul>
4962
5031
  */
4963
5032
  InfoType?: number;
4964
5033
  /**
@@ -4969,28 +5038,32 @@ export interface DescribeOrganizationSealsRequest {
4969
5038
  * 印章类型列表(都是组织机构印章)。
4970
5039
  为空时查询所有类型的印章。
4971
5040
  目前支持以下类型:
4972
- OFFICIAL:企业公章;
4973
- CONTRACT:合同专用章;
4974
- ORGANIZATION_SEAL:企业印章(图片上传创建);
4975
- LEGAL_PERSON_SEAL:法定代表人章
5041
+ <ul>
5042
+ <li>OFFICIAL:企业公章;</li>
5043
+ <li>CONTRACT:合同专用章;</li>
5044
+ <li>ORGANIZATION_SEAL:企业印章(图片上传创建);</li>
5045
+ <li>LEGAL_PERSON_SEAL:法定代表人章</li>
5046
+ </ul>
4976
5047
  */
4977
5048
  SealTypes?: Array<string>;
4978
5049
  /**
4979
- * 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
5050
+ * 代理企业和员工的信息。
5051
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
4980
5052
  */
4981
5053
  Agent?: Agent;
4982
5054
  /**
4983
5055
  * 查询的印章状态列表。
4984
- 取值为空,只查询启用状态的印章;
4985
- 取值ALL,查询所有状态的印章;
4986
- 取值CHECKING,查询待审核的印章;
4987
- 取值SUCCESS,查询启用状态的印章;
4988
- 取值FAIL,查询印章审核拒绝的印章;
4989
- 取值DISABLE,查询已停用的印章;
4990
- 取值STOPPED,查询已终止的印章;
4991
- 取值VOID,查询已作废的印章;
4992
- 取值INVALID,查询已失效的印章;
4993
-
5056
+ <ul>
5057
+ <li>空,只查询启用状态的印章;</li>
5058
+ <li>ALL,查询所有状态的印章;</li>
5059
+ <li>CHECKING,查询待审核的印章;</li>
5060
+ <li>SUCCESS,查询启用状态的印章;</li>
5061
+ <li>FAIL,查询印章审核拒绝的印章;</li>
5062
+ <li>DISABLE,查询已停用的印章;</li>
5063
+ <li>STOPPED,查询已终止的印章;</li>
5064
+ <li>VOID,查询已作废的印章;</li>
5065
+ <li>INVALID,查询已失效的印章;</li>
5066
+ </ul>
4994
5067
  */
4995
5068
  SealStatuses?: Array<string>;
4996
5069
  }
@@ -5593,15 +5666,26 @@ export interface SignUrl {
5593
5666
  */
5594
5667
  export interface VerifyPdfResponse {
5595
5668
  /**
5596
- * 验签结果,1-文件未被篡改,全部签名在腾讯电子签完成; 2-文件未被篡改,部分签名在腾讯电子签完成;3-文件被篡改;4-异常:文件内没有签名域;5-异常:文件签名格式错误
5669
+ * 验签结果代码,代码的含义如下:
5670
+
5671
+ <ul><li>**1**:文件未被篡改,全部签名在腾讯电子签完成。</li>
5672
+ <li>**2**:文件未被篡改,部分签名在腾讯电子签完成。</li>
5673
+ <li>**3**:文件被篡改。</li>
5674
+ <li>**4**:异常:文件内没有签名域。</li>
5675
+ <li>**5**:异常:文件签名格式错误。</li></ul>
5597
5676
  */
5598
5677
  VerifyResult?: number;
5599
5678
  /**
5600
- * 验签结果详情,每个签名域对应的验签结果。状态值:1-验签成功,在电子签签署;2-验签成功,在其他平台签署;3-验签失败;4-pdf文件没有签名域;5-文件签名格式错误
5679
+ * 验签结果详情,每个签名域对应的验签结果。状态值如下
5680
+ <ul><li> **1** :验签成功,在电子签签署</li>
5681
+ <li> **2** :验签成功,在其他平台签署</li>
5682
+ <li> **3** :验签失败</li>
5683
+ <li> **4** :pdf文件没有签名域</li>
5684
+ <li> **5** :文件签名格式错误</li></ul>
5601
5685
  */
5602
5686
  PdfVerifyResults?: Array<PdfVerifyResult>;
5603
5687
  /**
5604
- * 验签序列号
5688
+ * 验签序列号, 为11为数组组成的字符串
5605
5689
  */
5606
5690
  VerifySerialNo?: string;
5607
5691
  /**
@@ -5684,11 +5768,11 @@ export interface Caller {
5684
5768
  */
5685
5769
  export interface DescribeFlowTemplatesResponse {
5686
5770
  /**
5687
- * 模板详情列表
5771
+ * 模板详情列表数据
5688
5772
  */
5689
5773
  Templates?: Array<TemplateInfo>;
5690
5774
  /**
5691
- * 查询到的总数
5775
+ * 查询到的模板总数
5692
5776
  */
5693
5777
  TotalCount?: number;
5694
5778
  /**
@@ -5910,7 +5994,7 @@ export interface CreateMultiFlowSignQRCodeRequest {
5910
5994
  */
5911
5995
  export interface DescribeFlowInfoRequest {
5912
5996
  /**
5913
- * 调用方用户信息,userId 必填
5997
+ * 执行本接口操作的员工信息。 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
5914
5998
  */
5915
5999
  Operator?: UserInfo;
5916
6000
  /**
@@ -5920,7 +6004,7 @@ export interface DescribeFlowInfoRequest {
5920
6004
  */
5921
6005
  FlowIds?: Array<string>;
5922
6006
  /**
5923
- * 代理相关应用信息,如集团主企业代子企业操作的场景中ProxyOrganizationId必填
6007
+ * 代理企业和员工的信息。 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
5924
6008
  */
5925
6009
  Agent?: Agent;
5926
6010
  /**
@@ -5939,7 +6023,7 @@ export interface DescribeFlowInfoResponse {
5939
6023
  */
5940
6024
  FlowDetailInfos?: Array<FlowDetailInfo>;
5941
6025
  /**
5942
- * 合同组ID
6026
+ * 合同组ID,为32位字符串
5943
6027
  */
5944
6028
  FlowGroupId?: string;
5945
6029
  /**