tencentcloud-sdk-nodejs-ess 4.0.766 → 4.0.768

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.
Files changed (7) hide show
  1. package/package.json +1 -1
  2. package/products.md +20 -20
  3. package/src/services/ess/v20201111/ess_client.ts +68 -22
  4. package/src/services/ess/v20201111/ess_models.ts +144 -37
  5. package/tencentcloud/services/ess/v20201111/ess_client.d.ts +55 -18
  6. package/tencentcloud/services/ess/v20201111/ess_client.js +57 -18
  7. package/tencentcloud/services/ess/v20201111/ess_models.d.ts +141 -37
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tencentcloud-sdk-nodejs-ess",
3
- "version": "4.0.766",
3
+ "version": "4.0.768",
4
4
  "description": "Tencent Cloud API NODEJS SDK",
5
5
  "main": "tencentcloud/index.js",
6
6
  "scripts": {
package/products.md CHANGED
@@ -23,7 +23,7 @@
23
23
  | batch | [批量计算](https://cloud.tencent.com/document/product/599) | 2023-12-15 19:00:41 |
24
24
  | bda | [人体分析](https://cloud.tencent.com/document/product/1208) | 2023-10-11 01:10:01 |
25
25
  | bi | [商业智能分析 BI](https://cloud.tencent.com/document/product/590) | 2023-12-22 01:07:03 |
26
- | billing | [费用中心](https://cloud.tencent.com/document/product/555) | 2023-12-01 01:08:07 |
26
+ | billing | [费用中心](https://cloud.tencent.com/document/product/555) | 2023-12-27 01:07:34 |
27
27
  | bizlive | [商业直播](https://cloud.tencent.com/document/product) | 2020-03-10 01:08:07 |
28
28
  | bm | [黑石物理服务器CPM](https://cloud.tencent.com/document/product/386) | 2023-10-18 01:14:30 |
29
29
  | bma | [品牌经营管家](https://cloud.tencent.com/document/product/1296) | 2023-08-31 01:07:17 |
@@ -37,8 +37,8 @@
37
37
  | cam | [访问管理](https://cloud.tencent.com/document/product/598) | 2023-12-11 00:09:38 |
38
38
  | captcha | [验证码](https://cloud.tencent.com/document/product/1110) | 2023-12-01 01:09:01 |
39
39
  | car | [应用云渲染](https://cloud.tencent.com/document/product/1547) | 2023-12-05 01:14:32 |
40
- | cat | [云拨测](https://cloud.tencent.com/document/product/280) | 2023-12-26 01:07:57 |
41
- | cbs | [云硬盘](https://cloud.tencent.com/document/product/362) | 2023-11-01 01:07:57 |
40
+ | cat | [云拨测](https://cloud.tencent.com/document/product/280) | 2023-12-28 01:08:16 |
41
+ | cbs | [云硬盘](https://cloud.tencent.com/document/product/362) | 2023-12-27 01:08:57 |
42
42
  | ccc | [云联络中心](https://cloud.tencent.com/document/product/679) | 2023-12-22 01:08:08 |
43
43
  | cdb | [云数据库 MySQL](https://cloud.tencent.com/document/product/236) | 2023-12-22 01:08:53 |
44
44
  | cdc | [本地专用集群](https://cloud.tencent.com/document/product/1346) | 2023-12-05 01:17:51 |
@@ -70,7 +70,7 @@
70
70
  | csip | [云安全一体化平台](https://cloud.tencent.com/document/product/664) | 2023-12-19 01:25:03 |
71
71
  | csxg | [5G入云服务](https://cloud.tencent.com/document/product/1687) | 2023-05-19 11:26:14 |
72
72
  | cvm | [云服务器](https://cloud.tencent.com/document/product/213) | 2023-12-22 01:11:31 |
73
- | cwp | [主机安全](https://cloud.tencent.com/document/product/296) | 2023-11-29 01:11:08 |
73
+ | cwp | [主机安全](https://cloud.tencent.com/document/product/296) | 2023-12-27 01:12:48 |
74
74
  | cws | [漏洞扫描服务](https://cloud.tencent.com/document/product) | 2019-11-22 12:16:15 |
75
75
  | cynosdb | [TDSQL-C MySQL 版](https://cloud.tencent.com/document/product/1003) | 2023-12-15 19:25:23 |
76
76
  | dasb | [T-Sec-堡垒机（BH）](https://cloud.tencent.com/document/product/1025) | 2023-11-17 01:12:46 |
@@ -87,7 +87,7 @@
87
87
  | ds | [文档服务](https://cloud.tencent.com/document/product/869) | 2023-08-17 02:59:40 |
88
88
  | dsgc | [数据安全治理中心](https://cloud.tencent.com/document/product/1087) | 2023-11-29 01:53:04 |
89
89
  | dtf | [分布式事务](https://cloud.tencent.com/document/product/1224) | 2022-04-04 06:38:57 |
90
- | dts | [数据传输服务](https://cloud.tencent.com/document/product/571) | 2023-12-22 01:14:53 |
90
+ | dts | [数据传输服务](https://cloud.tencent.com/document/product/571) | 2023-12-27 01:17:28 |
91
91
  | eb | [事件总线](https://cloud.tencent.com/document/product/1359) | 2023-12-15 19:35:27 |
92
92
  | ecc | [英文作文批改](https://cloud.tencent.com/document/product/1076) | 2023-09-13 01:42:58 |
93
93
  | ecdn | [全站加速网络](https://cloud.tencent.com/document/product/570) | 2023-08-17 03:03:04 |
@@ -96,10 +96,10 @@
96
96
  | eis | [数据连接器](https://cloud.tencent.com/document/product/1270) | 2023-08-10 01:17:44 |
97
97
  | emr | [弹性 MapReduce](https://cloud.tencent.com/document/product/589) | 2023-12-25 00:10:01 |
98
98
  | es | [Elasticsearch Service](https://cloud.tencent.com/document/product/845) | 2023-12-05 01:46:13 |
99
- | ess | [腾讯电子签企业版](https://cloud.tencent.com/document/product/1323) | 2023-12-26 01:15:22 |
100
- | essbasic | [腾讯电子签（基础版）](https://cloud.tencent.com/document/product/1420) | 2023-12-26 01:15:49 |
99
+ | ess | [腾讯电子签企业版](https://cloud.tencent.com/document/product/1323) | 2023-12-28 01:15:21 |
100
+ | essbasic | [腾讯电子签（基础版）](https://cloud.tencent.com/document/product/1420) | 2023-12-28 01:15:39 |
101
101
  | facefusion | [人脸融合](https://cloud.tencent.com/document/product/670) | 2023-12-15 19:41:44 |
102
- | faceid | [人脸核身](https://cloud.tencent.com/document/product/1007) | 2023-12-26 01:16:06 |
102
+ | faceid | [人脸核身](https://cloud.tencent.com/document/product/1007) | 2023-12-27 01:19:47 |
103
103
  | fmu | [人脸试妆](https://cloud.tencent.com/document/product/1172) | 2023-12-25 00:11:01 |
104
104
  | ft | [人像变换](https://cloud.tencent.com/document/product/1202) | 2023-08-17 03:12:58 |
105
105
  | gaap | [全球应用加速](https://cloud.tencent.com/document/product/608) | 2023-11-14 01:16:54 |
@@ -128,8 +128,8 @@
128
128
  | iotvideo | [物联网智能视频服务](https://cloud.tencent.com/document/product/1131) | 2023-11-29 01:57:28 |
129
129
  | iotvideoindustry | [物联网智能视频服务（行业版）](https://cloud.tencent.com/document/product/1361) | 2023-08-17 03:44:44 |
130
130
  | irp | [智能推荐平台](https://cloud.tencent.com/document/product/1541) | 2023-09-22 02:00:51 |
131
- | iss | [智能视图计算平台](https://cloud.tencent.com/document/product/1344) | 2023-11-09 01:16:39 |
132
- | ivld | [媒体智能标签](https://cloud.tencent.com/document/product/1509) | 2023-05-18 01:35:21 |
131
+ | iss | [智能视图计算平台](https://cloud.tencent.com/document/product/1344) | 2023-12-27 01:22:46 |
132
+ | ivld | [媒体智能标签](https://cloud.tencent.com/document/product/1509) | 2023-12-28 01:18:25 |
133
133
  | keewidb | [云数据库 KeeWiDB](https://cloud.tencent.com/document/product/1520) | 2023-11-30 04:52:16 |
134
134
  | kms | [密钥管理系统](https://cloud.tencent.com/document/product/573) | 2023-08-17 03:51:31 |
135
135
  | lcic | [实时互动-教育版](https://cloud.tencent.com/document/product/1639) | 2023-12-21 01:48:52 |
@@ -144,8 +144,8 @@
144
144
  | mgobe | [游戏联机对战引擎](https://cloud.tencent.com/document/product/1038) | 2022-07-08 06:11:32 |
145
145
  | mmps | [小程序安全](https://cloud.tencent.com/document/product/1223) | 2023-05-18 01:39:20 |
146
146
  | mna | [多网聚合加速](https://cloud.tencent.com/document/product/1385) | 2023-12-01 01:19:47 |
147
- | mongodb | [云数据库 MongoDB](https://cloud.tencent.com/document/product/240) | 2023-12-26 01:20:00 |
148
- | monitor | [腾讯云可观测平台](https://cloud.tencent.com/document/product/248) | 2023-12-26 01:20:10 |
147
+ | mongodb | [云数据库 MongoDB](https://cloud.tencent.com/document/product/240) | 2023-12-27 01:26:46 |
148
+ | monitor | [腾讯云可观测平台](https://cloud.tencent.com/document/product/248) | 2023-12-27 01:26:59 |
149
149
  | mps | [媒体处理](https://cloud.tencent.com/document/product/862) | 2023-12-06 20:13:59 |
150
150
  | mrs | [医疗报告结构化](https://cloud.tencent.com/document/product/1314) | 2023-12-08 02:10:30 |
151
151
  | ms | [移动应用安全](https://cloud.tencent.com/document/product/283) | 2023-12-05 02:07:42 |
@@ -155,7 +155,7 @@
155
155
  | npp | [号码保护](https://cloud.tencent.com/document/product) | 2020-04-22 08:00:22 |
156
156
  | oceanus | [流计算 Oceanus](https://cloud.tencent.com/document/product/849) | 2023-12-20 01:57:04 |
157
157
  | ocr | [文字识别](https://cloud.tencent.com/document/product/866) | 2023-12-21 01:56:34 |
158
- | omics | [腾讯健康组学平台](https://cloud.tencent.com/document/product/1643) | 2023-12-13 02:14:02 |
158
+ | omics | [腾讯健康组学平台](https://cloud.tencent.com/document/product/1643) | 2023-12-28 01:21:09 |
159
159
  | organization | [集团账号管理](https://cloud.tencent.com/document/product/850) | 2023-12-25 00:15:53 |
160
160
  | partners | [渠道合作伙伴](https://cloud.tencent.com/document/product/563) | 2023-08-17 04:23:46 |
161
161
  | pds | [私域安全](https://cloud.tencent.com/document/product/1473) | 2023-05-18 01:44:14 |
@@ -176,11 +176,11 @@
176
176
  | sms | [短信](https://cloud.tencent.com/document/product/382) | 2023-11-28 01:23:01 |
177
177
  | soe | [智聆口语评测](https://cloud.tencent.com/document/product/884) | 2023-10-16 01:23:02 |
178
178
  | solar | [智汇零售](https://cloud.tencent.com/document/product) | 2020-03-19 08:01:59 |
179
- | sqlserver | [云数据库 SQL Server](https://cloud.tencent.com/document/product/238) | 2023-12-04 00:17:13 |
179
+ | sqlserver | [云数据库 SQL Server](https://cloud.tencent.com/document/product/238) | 2023-12-27 01:30:20 |
180
180
  | ssa | [安全运营中心](https://cloud.tencent.com/document/product/664) | 2023-11-15 02:18:28 |
181
181
  | ssl | [SSL 证书](https://cloud.tencent.com/document/product/400) | 2023-12-20 02:05:02 |
182
182
  | sslpod | [证书监控 SSLPod](https://cloud.tencent.com/document/product/1084) | 2023-08-17 04:46:28 |
183
- | ssm | [凭据管理系统](https://cloud.tencent.com/document/product/1140) | 2023-12-12 02:23:51 |
183
+ | ssm | [凭据管理系统](https://cloud.tencent.com/document/product/1140) | 2023-12-28 01:23:11 |
184
184
  | sts | [安全凭证服务](https://cloud.tencent.com/document/product/1312) | 2023-10-27 02:11:56 |
185
185
  | taf | [流量反欺诈](https://cloud.tencent.com/document/product/1031) | 2023-08-17 04:47:19 |
186
186
  | tag | [标签](https://cloud.tencent.com/document/product/651) | 2023-12-22 01:22:58 |
@@ -191,7 +191,7 @@
191
191
  | tbm | [](https://cloud.tencent.com/document/product) | 2019-03-29 14:49:11 |
192
192
  | tbp | [腾讯智能对话平台](https://cloud.tencent.com/document/product/1060) | 2023-08-17 04:48:55 |
193
193
  | tcaplusdb | [游戏数据库 TcaplusDB](https://cloud.tencent.com/document/product/596) | 2023-09-25 01:25:42 |
194
- | tcb | [云开发 CloudBase](https://cloud.tencent.com/document/product/876) | 2023-11-28 01:24:16 |
194
+ | tcb | [云开发 CloudBase](https://cloud.tencent.com/document/product/876) | 2023-12-27 01:32:04 |
195
195
  | tcbr | [云托管 CloudBase Run](https://cloud.tencent.com/document/product/1243) | 2023-05-18 01:51:15 |
196
196
  | tcex | [腾讯云释义](https://cloud.tencent.com/document/product/1266) | 2022-07-21 06:17:29 |
197
197
  | tchd | [腾讯云健康看板](https://cloud.tencent.com/document/product/1688) | 2023-11-28 01:24:39 |
@@ -225,18 +225,18 @@
225
225
  | trro | [远程实时操控](https://cloud.tencent.com/document/product/1584) | 2023-07-18 01:53:24 |
226
226
  | trtc | [实时音视频](https://cloud.tencent.com/document/product/647) | 2023-12-15 20:34:23 |
227
227
  | tse | [微服务引擎 TSE](https://cloud.tencent.com/document/product/1364) | 2023-12-20 02:20:03 |
228
- | tsf | [微服务平台 TSF](https://cloud.tencent.com/document/product/649) | 2023-12-14 02:42:40 |
228
+ | tsf | [微服务平台 TSF](https://cloud.tencent.com/document/product/649) | 2023-12-28 01:27:36 |
229
229
  | tsw | [微服务观测平台 TSW](https://cloud.tencent.com/document/product/1311) | 2023-05-18 02:04:00 |
230
230
  | tts | [语音合成](https://cloud.tencent.com/document/product/1073) | 2023-11-27 00:22:20 |
231
231
  | ump | [客流数字化平台](https://cloud.tencent.com/document/product/1320) | 2023-08-17 05:50:27 |
232
232
  | vm | [视频内容安全](https://cloud.tencent.com/document/product/1265) | 2023-12-22 01:27:31 |
233
233
  | vms | [语音消息](https://cloud.tencent.com/document/product/1128) | 2023-08-17 05:50:56 |
234
- | vod | [云点播](https://cloud.tencent.com/document/product/266) | 2023-12-26 01:28:48 |
235
- | vpc | [私有网络](https://cloud.tencent.com/document/product/215) | 2023-12-26 01:32:32 |
234
+ | vod | [云点播](https://cloud.tencent.com/document/product/266) | 2023-12-27 01:37:29 |
235
+ | vpc | [私有网络](https://cloud.tencent.com/document/product/215) | 2023-12-27 01:44:26 |
236
236
  | vrs | [声音复刻](https://cloud.tencent.com/document/product/1283) | 2023-11-27 00:23:42 |
237
237
  | waf | [Web 应用防火墙](https://cloud.tencent.com/document/product/627) | 2023-12-26 02:05:35 |
238
238
  | wav | [企业微信汽车行业版](https://cloud.tencent.com/document/product/1318) | 2023-11-15 02:42:49 |
239
- | wedata | [数据开发治理平台 WeData](https://cloud.tencent.com/document/product/1267) | 2023-12-22 01:29:59 |
239
+ | wedata | [数据开发治理平台 WeData](https://cloud.tencent.com/document/product/1267) | 2023-12-28 01:29:55 |
240
240
  | weilingwith | [微瓴同业开放平台](https://cloud.tencent.com/document/product/1693) | 2023-12-14 02:56:46 |
241
241
  | wss | [SSL证书管理服务](https://cloud.tencent.com/document/product) | 2020-04-01 08:53:44 |
242
242
  | yinsuda | [音速达直播音乐版权引擎](https://cloud.tencent.com/document/product/1592) | 2023-12-26 02:06:57 |
package/src/services/ess/v20201111/ess_client.ts CHANGED
@@ -26,6 +26,7 @@ import {
26
26
  UpdateIntegrationEmployeesResponse,
27
27
  Department,
28
28
  CreatePreparedPersonalEsignRequest,
29
+ DeleteStaffsResult,
29
30
  DescribeIntegrationDepartmentsResponse,
30
31
  DeleteExtendedServiceAuthInfosResponse,
31
32
  CreateFlowApproversResponse,
@@ -55,6 +56,8 @@ import {
55
56
  DeleteIntegrationRoleUsersResponse,
56
57
  CreateConvertTaskApiRequest,
57
58
  DeleteIntegrationEmployeesResponse,
59
+ NeedReviewApproverInfo,
60
+ CreateFlowGroupSignReviewResponse,
58
61
  CreateBatchSignUrlResponse,
59
62
  CreateFlowRemindsResponse,
60
63
  DescribeOrganizationGroupOrganizationsRequest,
@@ -199,7 +202,7 @@ import {
199
202
  CreateUserAutoSignEnableUrlResponse,
200
203
  SignUrl,
201
204
  VerifyPdfResponse,
202
- DeleteStaffsResult,
205
+ CreateFlowGroupSignReviewRequest,
203
206
  DescribeBillUsageDetailRequest,
204
207
  Admin,
205
208
  Caller,
@@ -388,23 +391,20 @@ export class Client extends TencentCloudCommon.AbstractClient {
388
391
  }
389
392
 
390
393
  /**
391
- * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
392
-
393
- 适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
394
-
395
- 适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。此处注意权限树内容可能会更新，需尽量拉取最新的权限树内容，并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
394
+ * 提交合同组签署流程审批结果的适用场景包括：
396
395
 
397
- 适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
396
+ 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时，若指定了以下参数 为true，则可以调用此接口提交企业内部签署审批结果。即使是自动签署也需要进行审核通过才会进行签署。
397
+ - [FlowGroupInfo.NeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#flowgroupinfo)
398
+ - [ApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#approverinfo)
398
399
 
399
- 适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
400
400
 
401
- 注意事项：SaaS角色和集团角色对应的权限树是不一样的。
401
+ 2. 同一合同组，同一签署人可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
402
402
  */
403
- async CreateIntegrationRole(
404
- req: CreateIntegrationRoleRequest,
405
- cb?: (error: string, rep: CreateIntegrationRoleResponse) => void
406
- ): Promise<CreateIntegrationRoleResponse> {
407
- return this.request("CreateIntegrationRole", req, cb)
403
+ async CreateFlowGroupSignReview(
404
+ req: CreateFlowGroupSignReviewRequest,
405
+ cb?: (error: string, rep: CreateFlowGroupSignReviewResponse) => void
406
+ ): Promise<CreateFlowGroupSignReviewResponse> {
407
+ return this.request("CreateFlowGroupSignReview", req, cb)
408
408
  }
409
409
 
410
410
  /**
@@ -525,9 +525,36 @@ export class Client extends TencentCloudCommon.AbstractClient {
525
525
  }
526
526
 
527
527
  /**
528
- * 提交签署流程审批结果的适用场景包括：
529
- 1. 在使用模板（CreateFlow）或文件（CreateFlowByFiles）创建签署流程时，若指定了参数NeedSignReview为true，且发起方企业作为签署方参与了流程签署，则可以调用此接口提交企业内部签署审批结果。自动签署也需要进行审核通过才会进行签署。
530
- 2. 若签署流程状态正常，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
528
+ * 提交企业流程审批结果
529
+ **当前存在两种审核操作：**
530
+ <ul>
531
+ <li>签署审核
532
+ <ul>
533
+ <li>在通过接口<ul>
534
+ <li>CreateFlowByFiles</li>
535
+ <li>CreateFlow</li>
536
+ <li>CreateFlowGroupByTemplates</li>
537
+ <li>CreateFlowGroupByFiles</li>
538
+ <li>CreatePrepareFlow</li>
539
+ </ul>
540
+ 发起签署流程时，通过指定NeedSignReview为true，则可以调用此接口，并指定operate=SignReview，以提交企业内部签署审批结果</li>
541
+ <li>在通过接口
542
+ <ul>
543
+ <li>CreateFlowByFiles</li>
544
+ <li>CreateFlow</li>
545
+ <li>CreateFlowGroupByTemplates</li>
546
+ <li>CreateFlowGroupByFiles</li>
547
+ </ul>
548
+ 发起签署流程时，通过指定签署人ApproverNeedSignReview为true，则可以调用此接口，并指定operate=SignReview，并指定RecipientId，以提交企业内部签署审批结果</li>
549
+ </ul>
550
+ </li>
551
+ <li>发起审核
552
+ <ul>
553
+ <li>通过接口CreatePrepareFlow指定发起后需要审核，那么可以调用此接口，并指定operate=CreateReview，以提交企业内部审批结果。可以多次提交审批结果，但一旦审批通过，后续提交的结果将无效
554
+ </li>
555
+ </ul>
556
+ </li>
557
+ </ul>
531
558
  */
532
559
  async CreateFlowSignReview(
533
560
  req: CreateFlowSignReviewRequest,
@@ -676,11 +703,10 @@ export class Client extends TencentCloudCommon.AbstractClient {
676
703
  跳转到小程序的实现，参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
677
704
 
678
705
  注：
679
- `1. 如果签署人是在PC端扫码签署，可以通过生成跳转链接自主转换成二维码，让签署人在PC端扫码签署`
680
-
681
- `2. 签署链接的有效期为90天，超过有效期链接不可用`
682
-
683
- `3. 如果需跳转详情页（即PathType值为1）进行填写或签署合同，需指定签署方信息：姓名、手机号码、企业名称等，才能生成正确的跳转链接`
706
+ <ul><li>1. 如果签署人是在PC端扫码签署，可以通过生成跳转链接自主转换成二维码，让签署人在PC端扫码签署</li>
707
+ <li>2. 签署链接的有效期为<font color="red">90天</font>，超过有效期链接不可用</li>
708
+ <li>3. 如果需跳转详情页（即PathType值为1）进行填写或签署合同，需指定签署方信息:姓名、手机号码、企业名称等，才能生成正确的跳转链接</li>
709
+ <li>4. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）</li></ul>
684
710
 
685
711
  其中小程序的原始Id如下，或者查看小程序信息自助获取。
686
712
 
@@ -996,6 +1022,26 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");
996
1022
  return this.request("DescribeFlowBriefs", req, cb)
997
1023
  }
998
1024
 
1025
+ /**
1026
+ * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
1027
+
1028
+ 适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
1029
+
1030
+ 适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。此处注意权限树内容可能会更新，需尽量拉取最新的权限树内容，并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
1031
+
1032
+ 适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
1033
+
1034
+ 适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
1035
+
1036
+ 注意事项：SaaS角色和集团角色对应的权限树是不一样的。
1037
+ */
1038
+ async CreateIntegrationRole(
1039
+ req: CreateIntegrationRoleRequest,
1040
+ cb?: (error: string, rep: CreateIntegrationRoleResponse) => void
1041
+ ): Promise<CreateIntegrationRoleResponse> {
1042
+ return this.request("CreateIntegrationRole", req, cb)
1043
+ }
1044
+
999
1045
  /**
1000
1046
  * 此接口用于赋予员工指定的角色权限，如需解绑请使用 DeleteIntegrationRoleUsers 接口。
1001
1047
  */
package/src/services/ess/v20201111/ess_models.ts CHANGED
@@ -382,6 +382,22 @@ BLUE 蓝色。
382
382
  SceneKey?: string
383
383
  }
384
384
 
385
+ /**
386
+ * 删除员工结果
387
+ */
388
+ export interface DeleteStaffsResult {
389
+ /**
390
+ * 删除员工的成功数据
391
+ 注意：此字段可能返回 null，表示取不到有效值。
392
+ */
393
+ SuccessEmployeeData: Array<SuccessDeleteStaffData>
394
+ /**
395
+ * 删除员工的失败数据
396
+ 注意：此字段可能返回 null，表示取不到有效值。
397
+ */
398
+ FailedEmployeeData: Array<FailedDeleteStaffData>
399
+ }
400
+
385
401
  /**
386
402
  * DescribeIntegrationDepartments返回参数结构体
387
403
  */
@@ -538,35 +554,32 @@ export interface CreateMultiFlowSignQRCodeResponse {
538
554
  */
539
555
  export interface FlowApproverUrlInfo {
540
556
  /**
541
- * 签署短链接。</br>
557
+ * 签署短链接。
542
558
  注意:
543
- - 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
544
- - 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
545
- 注意：此字段可能返回 null，表示取不到有效值。
559
+ 1. 该链接有效期为<b>30分钟</b>，同时需要注意保密，不要外泄给无关用户。
560
+ 2. 该链接不支持小程序嵌入，仅支持<b>移动端浏览器</b>打开。
561
+ 3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
546
562
  */
547
563
  SignUrl?: string
548
564
  /**
549
565
  * 签署人类型。
550
566
  - **1**: 个人
551
- 注意：此字段可能返回 null，表示取不到有效值。
552
567
  */
553
568
  ApproverType?: number
554
569
  /**
555
570
  * 签署人姓名。
556
- 注意：此字段可能返回 null，表示取不到有效值。
557
571
  */
558
572
  ApproverName?: string
559
573
  /**
560
574
  * 签署人手机号。
561
- 注意：此字段可能返回 null，表示取不到有效值。
562
575
  */
563
576
  ApproverMobile?: string
564
577
  /**
565
- * 签署长链接。</br>
578
+ * 签署长链接。
566
579
  注意:
567
- - 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
568
- - 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
569
- 注意：此字段可能返回 null，表示取不到有效值。
580
+ 1. 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
581
+ 2. 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
582
+ 3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
570
583
  */
571
584
  LongUrl?: string
572
585
  }
@@ -1098,6 +1111,61 @@ export interface DeleteIntegrationEmployeesResponse {
1098
1111
  RequestId?: string
1099
1112
  }
1100
1113
 
1114
+ /**
1115
+ * 需要进行签署审核的签署人信息
1116
+ */
1117
+ export interface NeedReviewApproverInfo {
1118
+ /**
1119
+ * 签署方经办人的类型，支持以下类型
1120
+ <ul><li> ORGANIZATION 企业（含企业自动签）</li>
1121
+ <li>PERSON 个人（含个人自动签）</li></ul>
1122
+ */
1123
+ ApproverType: string
1124
+ /**
1125
+ * 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
1126
+ */
1127
+ ApproverName: string
1128
+ /**
1129
+ * 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。
1130
+ */
1131
+ ApproverMobile?: string
1132
+ /**
1133
+ * 签署方经办人的证件类型，支持以下类型
1134
+ <ul><li>ID_CARD 居民身份证 (默认值)</li>
1135
+ <li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
1136
+ <li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
1137
+ <li>OTHER_CARD_TYPE 其他证件</li></ul>
1138
+
1139
+ 注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
1140
+ */
1141
+ ApproverIdCardType?: string
1142
+ /**
1143
+ * 签署方经办人的证件号码，应符合以下规则
1144
+ <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
1145
+ <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
1146
+ <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
1147
+ */
1148
+ ApproverIdCardNumber?: string
1149
+ /**
1150
+ * 组织机构名称。
1151
+ 请确认该名称与企业营业执照中注册的名称一致。
1152
+ 如果名称中包含英文括号()，请使用中文括号（）代替。
1153
+ 如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
1154
+
1155
+ */
1156
+ OrganizationName?: string
1157
+ }
1158
+
1159
+ /**
1160
+ * CreateFlowGroupSignReview返回参数结构体
1161
+ */
1162
+ export interface CreateFlowGroupSignReviewResponse {
1163
+ /**
1164
+ * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1165
+ */
1166
+ RequestId?: string
1167
+ }
1168
+
1101
1169
  /**
1102
1170
  * CreateBatchSignUrl返回参数结构体
1103
1171
  */
@@ -1105,7 +1173,9 @@ export interface CreateBatchSignUrlResponse {
1105
1173
  /**
1106
1174
  * 批量签署链接，以短链形式返回，短链的有效期参考回参中的 ExpiredTime。
1107
1175
 
1108
- 注: `非小程序和APP集成使用`
1176
+ 注:
1177
+ 1. 非小程序和APP集成使用
1178
+ 2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
1109
1179
  */
1110
1180
  SignUrl?: string
1111
1181
  /**
@@ -1115,7 +1185,9 @@ export interface CreateBatchSignUrlResponse {
1115
1185
  /**
1116
1186
  * 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
1117
1187
 
1118
- 注: `小程序和APP集成使用`
1188
+ 注:
1189
+ 1. 小程序和APP集成使用
1190
+ 2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
1119
1191
  */
1120
1192
  MiniAppPath?: string
1121
1193
  /**
@@ -2807,31 +2879,24 @@ export interface CreateFlowSignReviewRequest {
2807
2879
  Operator: UserInfo
2808
2880
  /**
2809
2881
  * 合同流程ID，为32位字符串。
2810
- 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
2811
- 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
2882
+ <ul><li>建议开发者妥善保存此流程ID，以便于顺利进行后续操作。</li>
2883
+ <li>可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。</li></ul>
2812
2884
  */
2813
2885
  FlowId: string
2814
2886
  /**
2815
- * 企业审核结果
2816
- <ul><li>PASS: 通过</li>
2817
- <li>REJECT: 拒绝</li></ul>
2887
+ * 企业内部审核结果
2888
+ <ul><li>PASS: 审核通过</li>
2889
+ <li>REJECT: 审核拒绝</li>
2890
+ <li>SIGN_REJECT:拒签(流程结束)</li></ul>
2818
2891
  */
2819
2892
  ReviewType: string
2820
- /**
2821
- * 审核结果原因，
2822
- 字符串长度不超过200
2823
- 当ReviewType 是拒绝（REJECT） 时此字段必填。
2824
-
2825
- */
2826
- ReviewMessage?: string
2827
2893
  /**
2828
2894
  * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
2829
2895
  */
2830
2896
  Agent?: Agent
2831
2897
  /**
2832
- * 审核签署节点人标识，
2833
- 用来标识审核的签署方。
2834
- 如果签署审核节点是个人， 此参数必填。
2898
+ * 审核节点的签署人标志，用于指定当前审核的签署方
2899
+ <ul><li>**如果签署审核节点是个人， 此参数必填**。</li></ul>
2835
2900
  */
2836
2901
  RecipientId?: string
2837
2902
  /**
@@ -2843,6 +2908,15 @@ export interface CreateFlowSignReviewRequest {
2843
2908
  如果审核节点是个人，则操作类型只能为SignReview。
2844
2909
  */
2845
2910
  OperateType?: string
2911
+ /**
2912
+ * 审核结果原因
2913
+ <ul><li>字符串长度不超过200</li>
2914
+ <li>当ReviewType 是拒绝（REJECT） 时此字段必填。</li>
2915
+ <li>当ReviewType 是拒绝（SIGN_REJECT） 时此字段必填。</li></ul>
2916
+
2917
+
2918
+ */
2919
+ ReviewMessage?: string
2846
2920
  }
2847
2921
 
2848
2922
  /**
@@ -2881,6 +2955,9 @@ export interface CreateSchemeUrlResponse {
2881
2955
  <ul><li>如果EndPoint是**APP**，得到的链接类似于`pages/guide?from=default&where=mini&id=yDwJSUUirqauh***7jNSxwdirTSGuH&to=CONTRACT_DETAIL&name=&phone=&shortKey=yDw***k1xFc5`, 用法可以参加接口描述中的"跳转到小程序的实现"</li>
2882
2956
  <li>如果EndPoint是**HTTP**，得到的链接类似于 `https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?where=mini&from=SFY&id=yDwfEUUw**4rV6Avz&to=MVP_CONTRACT_COVER&name=%E9%83%**5%86%9B`，点击后会跳转到腾讯电子签小程序进行签署</li>
2883
2957
  <li>如果EndPoint是**HTTP_SHORT_URL**，得到的链接类似于 `https://essurl.cn/2n**42Nd`，点击后会跳转到腾讯电子签小程序进行签署</li></ul>
2958
+
2959
+
2960
+ 注： <font color="red">生成的链路后面不能再增加参数</font>
2884
2961
  */
2885
2962
  SchemeUrl?: string
2886
2963
  /**
@@ -3287,7 +3364,8 @@ FormField输入示例：
3287
3364
  }
3288
3365
  ```
3289
3366
 
3290
- 当控件的 ComponentType='ATTACHMENT'时，FormField.ComponentValue填入附件图片的资源ID列表，以逗号分隔，单个附件控件最多支持6个资源ID；
3367
+ 当控件的 ComponentType='ATTACHMENT'时，FormField.ComponentValue支持填入附件图片或者文件的资源ID列表，以逗号分隔，单个附件控件最多支持6个资源ID；
3368
+ 支持的文件类型包括doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt、pdf
3291
3369
 
3292
3370
  ```
3293
3371
  FormField输入示例：
@@ -6642,19 +6720,48 @@ export interface VerifyPdfResponse {
6642
6720
  }
6643
6721
 
6644
6722
  /**
6645
- * 删除员工结果
6723
+ * CreateFlowGroupSignReview请求参数结构体
6646
6724
  */
6647
- export interface DeleteStaffsResult {
6725
+ export interface CreateFlowGroupSignReviewRequest {
6648
6726
  /**
6649
- * 删除员工的成功数据
6650
- 注意：此字段可能返回 null，表示取不到有效值。
6727
+ * 执行本接口操作的员工信息。
6728
+ 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
6651
6729
  */
6652
- SuccessEmployeeData: Array<SuccessDeleteStaffData>
6730
+ Operator: UserInfo
6653
6731
  /**
6654
- * 删除员工的失败数据
6655
- 注意：此字段可能返回 null，表示取不到有效值。
6732
+ * 合同(流程)组的合同组Id，为32位字符串，通过接口[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles) 或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时返回。
6656
6733
  */
6657
- FailedEmployeeData: Array<FailedDeleteStaffData>
6734
+ FlowGroupId: string
6735
+ /**
6736
+ * 提交的审核结果，审核结果有下面三种情况
6737
+ <ul><li><b>PASS</b>: 审核通过，合同流程可以继续执行签署等操作</li>
6738
+ <li><b>REJECT</b>: 审核拒绝，合同流程不会变动</li>
6739
+ <li><b>SIGN_REJECT</b>:拒签，合同流程直接结束，合同状态变为**合同拒签**</li></ul>
6740
+ */
6741
+ ReviewType: string
6742
+ /**
6743
+ * 需要进行签署审核的签署人的个人信息或企业信息，签署方的匹配方式按照以下规则:
6744
+
6745
+ 个人：二选一（选择其中任意信息组合即可）
6746
+ <ul><li>姓名+证件类型+证件号</li>
6747
+ <li>姓名+手机号</li></ul>
6748
+
6749
+ 企业：二选一 （选择其中任意信息组合即可）
6750
+ <ul><li>企业名+姓名+证件类型+证件号</li>
6751
+ <li>企业名+姓名+手机号</li></ul>
6752
+ */
6753
+ ApproverInfo: NeedReviewApproverInfo
6754
+ /**
6755
+ * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
6756
+ */
6757
+ Agent?: Agent
6758
+ /**
6759
+ * 审核不通过的原因，该字段的字符串长度不超过200个字符。
6760
+
6761
+ 注：`当审核类型（ReviewType）为审核拒绝（REJECT）或拒签（SIGN_REJECT）时，审核结果原因字段必须填写`
6762
+
6763
+ */
6764
+ ReviewMessage?: string
6658
6765
  }
6659
6766
 
6660
6767
  /**
package/tencentcloud/services/ess/v20201111/ess_client.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
2
- import { DescribePersonCertificateResponse, CreateSealRequest, ModifyIntegrationDepartmentResponse, CancelFlowResponse, DescribeExtendedServiceAuthDetailResponse, UpdateIntegrationEmployeesResponse, CreatePreparedPersonalEsignRequest, DescribeIntegrationDepartmentsResponse, DeleteExtendedServiceAuthInfosResponse, CreateFlowApproversResponse, DescribeFileUrlsResponse, CreateExtendedServiceAuthInfosRequest, ModifyApplicationCallbackInfoResponse, CreateMultiFlowSignQRCodeResponse, DescribeThirdPartyAuthCodeResponse, DisableUserAutoSignResponse, CancelUserAutoSignEnableUrlResponse, BindEmployeeUserIdWithClientOpenIdResponse, CreateIntegrationEmployeesRequest, DescribeIntegrationRolesRequest, CreateFlowEvidenceReportRequest, StartFlowResponse, CreateBatchQuickSignUrlResponse, CreateIntegrationRoleRequest, DeleteIntegrationRoleUsersResponse, CreateConvertTaskApiRequest, DeleteIntegrationEmployeesResponse, CreateBatchSignUrlResponse, CreateFlowRemindsResponse, DescribeOrganizationGroupOrganizationsRequest, CreateFlowGroupByFilesRequest, DescribeFlowComponentsResponse, DescribeFlowEvidenceReportResponse, DeleteSealPoliciesRequest, CreateFlowGroupByTemplatesResponse, CreateDocumentResponse, DescribeIntegrationEmployeesRequest, CreateIntegrationUserRolesResponse, CreateFlowRequest, CreateSchemeUrlRequest, DeleteIntegrationDepartmentResponse, DescribeThirdPartyAuthCodeRequest, UnbindEmployeeUserIdWithClientOpenIdResponse, CreateReleaseFlowResponse, CreateWebThemeConfigResponse, BindEmployeeUserIdWithClientOpenIdRequest, CreateOrganizationInfoChangeUrlResponse, DescribeExtendedServiceAuthDetailRequest, CreateIntegrationDepartmentResponse, DescribeFlowTemplatesRequest, DeleteSealPoliciesResponse, DescribeUserAutoSignStatusResponse, CreateUserAutoSignSealUrlResponse, CreatePersonAuthCertificateImageResponse, CreateBatchCancelFlowUrlResponse, CreateSealPolicyResponse, DisableUserAutoSignRequest, DescribeIntegrationEmployeesResponse, CreateConvertTaskApiResponse, CreateFlowSignReviewRequest, UnbindEmployeeUserIdWithClientOpenIdRequest, CreateSchemeUrlResponse, CreateFlowByFilesRequest, CreateFlowSignUrlResponse, DescribeFileUrlsRequest, CreateUserAutoSignSealUrlRequest, CreateFlowApproversRequest, ModifyIntegrationRoleResponse, CreateFlowEvidenceReportResponse, CreateIntegrationRoleResponse, DescribeFlowComponentsRequest, CreateIntegrationDepartmentRequest, CreateDocumentRequest, CreatePreparedPersonalEsignResponse, DescribeOrganizationSealsResponse, CreateEmbedWebUrlRequest, DeleteIntegrationEmployeesRequest, GetTaskResultApiRequest, DescribeFlowBriefsResponse, ModifyIntegrationRoleRequest, CreateFlowGroupByFilesResponse, CreateIntegrationEmployeesResponse, DeleteIntegrationRoleUsersRequest, CreateFlowSignUrlRequest, CreateReleaseFlowRequest, CreateIntegrationUserRolesRequest, CreatePersonAuthCertificateImageRequest, CreateFlowByFilesResponse, UploadFilesResponse, DescribeFlowEvidenceReportRequest, CreateFlowSignReviewResponse, ModifyIntegrationDepartmentRequest, CreateUserAutoSignEnableUrlRequest, CreateOrganizationBatchSignUrlResponse, CancelUserAutoSignEnableUrlRequest, CreateExtendedServiceAuthInfosResponse, CreateWebThemeConfigRequest, CreateOrganizationBatchSignUrlRequest, CreatePrepareFlowResponse, GetTaskResultApiResponse, CancelMultiFlowSignQRCodeRequest, DeleteIntegrationDepartmentRequest, ModifyApplicationCallbackInfoRequest, StartFlowRequest, CreateSealResponse, CreatePrepareFlowRequest, CreateEmbedWebUrlResponse, CreateSealPolicyRequest, DescribeOrganizationSealsRequest, CancelFlowRequest, DescribeExtendedServiceAuthInfosRequest, DescribeIntegrationRolesResponse, CreateBatchSignUrlRequest, CreateFlowRemindsRequest, UpdateIntegrationEmployeesRequest, DescribeFlowBriefsRequest, CreateFlowGroupByTemplatesRequest, DescribeBillUsageDetailResponse, CreateUserAutoSignEnableUrlResponse, VerifyPdfResponse, DescribeBillUsageDetailRequest, DescribeFlowTemplatesResponse, UploadFilesRequest, DescribePersonCertificateRequest, CreateBatchCancelFlowUrlRequest, CreateMultiFlowSignQRCodeRequest, VerifyPdfRequest, DescribeFlowInfoRequest, DeleteExtendedServiceAuthInfosRequest, DescribeIntegrationDepartmentsRequest, DescribeFlowInfoResponse, CancelMultiFlowSignQRCodeResponse, CreateFlowResponse, DescribeUserAutoSignStatusRequest, CreateBatchQuickSignUrlRequest, CreateOrganizationInfoChangeUrlRequest, DescribeOrganizationGroupOrganizationsResponse, DescribeExtendedServiceAuthInfosResponse } from "./ess_models";
2
+ import { DescribePersonCertificateResponse, CreateSealRequest, ModifyIntegrationDepartmentResponse, CancelFlowResponse, DescribeExtendedServiceAuthDetailResponse, UpdateIntegrationEmployeesResponse, CreatePreparedPersonalEsignRequest, DescribeIntegrationDepartmentsResponse, DeleteExtendedServiceAuthInfosResponse, CreateFlowApproversResponse, DescribeFileUrlsResponse, CreateExtendedServiceAuthInfosRequest, ModifyApplicationCallbackInfoResponse, CreateMultiFlowSignQRCodeResponse, DescribeThirdPartyAuthCodeResponse, DisableUserAutoSignResponse, CancelUserAutoSignEnableUrlResponse, BindEmployeeUserIdWithClientOpenIdResponse, CreateIntegrationEmployeesRequest, DescribeIntegrationRolesRequest, CreateFlowEvidenceReportRequest, StartFlowResponse, CreateBatchQuickSignUrlResponse, CreateIntegrationRoleRequest, DeleteIntegrationRoleUsersResponse, CreateConvertTaskApiRequest, DeleteIntegrationEmployeesResponse, CreateFlowGroupSignReviewResponse, CreateBatchSignUrlResponse, CreateFlowRemindsResponse, DescribeOrganizationGroupOrganizationsRequest, CreateFlowGroupByFilesRequest, DescribeFlowComponentsResponse, DescribeFlowEvidenceReportResponse, DeleteSealPoliciesRequest, CreateFlowGroupByTemplatesResponse, CreateDocumentResponse, DescribeIntegrationEmployeesRequest, CreateIntegrationUserRolesResponse, CreateFlowRequest, CreateSchemeUrlRequest, DeleteIntegrationDepartmentResponse, DescribeThirdPartyAuthCodeRequest, UnbindEmployeeUserIdWithClientOpenIdResponse, CreateReleaseFlowResponse, CreateWebThemeConfigResponse, BindEmployeeUserIdWithClientOpenIdRequest, CreateOrganizationInfoChangeUrlResponse, DescribeExtendedServiceAuthDetailRequest, CreateIntegrationDepartmentResponse, DescribeFlowTemplatesRequest, DeleteSealPoliciesResponse, DescribeUserAutoSignStatusResponse, CreateUserAutoSignSealUrlResponse, CreatePersonAuthCertificateImageResponse, CreateBatchCancelFlowUrlResponse, CreateSealPolicyResponse, DisableUserAutoSignRequest, DescribeIntegrationEmployeesResponse, CreateConvertTaskApiResponse, CreateFlowSignReviewRequest, UnbindEmployeeUserIdWithClientOpenIdRequest, CreateSchemeUrlResponse, CreateFlowByFilesRequest, CreateFlowSignUrlResponse, DescribeFileUrlsRequest, CreateUserAutoSignSealUrlRequest, CreateFlowApproversRequest, ModifyIntegrationRoleResponse, CreateFlowEvidenceReportResponse, CreateIntegrationRoleResponse, DescribeFlowComponentsRequest, CreateIntegrationDepartmentRequest, CreateDocumentRequest, CreatePreparedPersonalEsignResponse, DescribeOrganizationSealsResponse, CreateEmbedWebUrlRequest, DeleteIntegrationEmployeesRequest, GetTaskResultApiRequest, DescribeFlowBriefsResponse, ModifyIntegrationRoleRequest, CreateFlowGroupByFilesResponse, CreateIntegrationEmployeesResponse, DeleteIntegrationRoleUsersRequest, CreateFlowSignUrlRequest, CreateReleaseFlowRequest, CreateIntegrationUserRolesRequest, CreatePersonAuthCertificateImageRequest, CreateFlowByFilesResponse, UploadFilesResponse, DescribeFlowEvidenceReportRequest, CreateFlowSignReviewResponse, ModifyIntegrationDepartmentRequest, CreateUserAutoSignEnableUrlRequest, CreateOrganizationBatchSignUrlResponse, CancelUserAutoSignEnableUrlRequest, CreateExtendedServiceAuthInfosResponse, CreateWebThemeConfigRequest, CreateOrganizationBatchSignUrlRequest, CreatePrepareFlowResponse, GetTaskResultApiResponse, CancelMultiFlowSignQRCodeRequest, DeleteIntegrationDepartmentRequest, ModifyApplicationCallbackInfoRequest, StartFlowRequest, CreateSealResponse, CreatePrepareFlowRequest, CreateEmbedWebUrlResponse, CreateSealPolicyRequest, DescribeOrganizationSealsRequest, CancelFlowRequest, DescribeExtendedServiceAuthInfosRequest, DescribeIntegrationRolesResponse, CreateBatchSignUrlRequest, CreateFlowRemindsRequest, UpdateIntegrationEmployeesRequest, DescribeFlowBriefsRequest, CreateFlowGroupByTemplatesRequest, DescribeBillUsageDetailResponse, CreateUserAutoSignEnableUrlResponse, VerifyPdfResponse, CreateFlowGroupSignReviewRequest, DescribeBillUsageDetailRequest, DescribeFlowTemplatesResponse, UploadFilesRequest, DescribePersonCertificateRequest, CreateBatchCancelFlowUrlRequest, CreateMultiFlowSignQRCodeRequest, VerifyPdfRequest, DescribeFlowInfoRequest, DeleteExtendedServiceAuthInfosRequest, DescribeIntegrationDepartmentsRequest, DescribeFlowInfoResponse, CancelMultiFlowSignQRCodeResponse, CreateFlowResponse, DescribeUserAutoSignStatusRequest, CreateBatchQuickSignUrlRequest, CreateOrganizationInfoChangeUrlRequest, DescribeOrganizationGroupOrganizationsResponse, DescribeExtendedServiceAuthInfosResponse } from "./ess_models";
3
3
  /**
4
4
  * ess client
5
5
  * @class
@@ -98,19 +98,16 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
98
98
  */
99
99
  CreateUserAutoSignEnableUrl(req: CreateUserAutoSignEnableUrlRequest, cb?: (error: string, rep: CreateUserAutoSignEnableUrlResponse) => void): Promise<CreateUserAutoSignEnableUrlResponse>;
100
100
  /**
101
- * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
101
+ * 提交合同组签署流程审批结果的适用场景包括：
102
102
 
103
- 适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
103
+ 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时，若指定了以下参数 为true，则可以调用此接口提交企业内部签署审批结果。即使是自动签署也需要进行审核通过才会进行签署。
104
+ - [FlowGroupInfo.NeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#flowgroupinfo)
105
+ - [ApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#approverinfo)
104
106
 
105
- 适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。此处注意权限树内容可能会更新，需尽量拉取最新的权限树内容，并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
106
-
107
- 适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
108
107
 
109
- 适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
110
-
111
- 注意事项：SaaS角色和集团角色对应的权限树是不一样的。
108
+ 2. 同一合同组，同一签署人可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
112
109
  */
113
- CreateIntegrationRole(req: CreateIntegrationRoleRequest, cb?: (error: string, rep: CreateIntegrationRoleResponse) => void): Promise<CreateIntegrationRoleResponse>;
110
+ CreateFlowGroupSignReview(req: CreateFlowGroupSignReviewRequest, cb?: (error: string, rep: CreateFlowGroupSignReviewResponse) => void): Promise<CreateFlowGroupSignReviewResponse>;
114
111
  /**
115
112
  * 本接口（CreateEmbedWebUrl）用于创建嵌入Web的链接，支持以下类型的Web链接创建：
116
113
  1. 创建印章
@@ -169,9 +166,36 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
169
166
  */
170
167
  DeleteIntegrationRoleUsers(req: DeleteIntegrationRoleUsersRequest, cb?: (error: string, rep: DeleteIntegrationRoleUsersResponse) => void): Promise<DeleteIntegrationRoleUsersResponse>;
171
168
  /**
172
- * 提交签署流程审批结果的适用场景包括：
173
- 1. 在使用模板（CreateFlow）或文件（CreateFlowByFiles）创建签署流程时，若指定了参数NeedSignReview为true，且发起方企业作为签署方参与了流程签署，则可以调用此接口提交企业内部签署审批结果。自动签署也需要进行审核通过才会进行签署。
174
- 2. 若签署流程状态正常，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
169
+ * 提交企业流程审批结果
170
+ **当前存在两种审核操作：**
171
+ <ul>
172
+ <li>签署审核
173
+ <ul>
174
+ <li>在通过接口<ul>
175
+ <li>CreateFlowByFiles</li>
176
+ <li>CreateFlow</li>
177
+ <li>CreateFlowGroupByTemplates</li>
178
+ <li>CreateFlowGroupByFiles</li>
179
+ <li>CreatePrepareFlow</li>
180
+ </ul>
181
+ 发起签署流程时，通过指定NeedSignReview为true，则可以调用此接口，并指定operate=SignReview，以提交企业内部签署审批结果</li>
182
+ <li>在通过接口
183
+ <ul>
184
+ <li>CreateFlowByFiles</li>
185
+ <li>CreateFlow</li>
186
+ <li>CreateFlowGroupByTemplates</li>
187
+ <li>CreateFlowGroupByFiles</li>
188
+ </ul>
189
+ 发起签署流程时，通过指定签署人ApproverNeedSignReview为true，则可以调用此接口，并指定operate=SignReview，并指定RecipientId，以提交企业内部签署审批结果</li>
190
+ </ul>
191
+ </li>
192
+ <li>发起审核
193
+ <ul>
194
+ <li>通过接口CreatePrepareFlow指定发起后需要审核，那么可以调用此接口，并指定operate=CreateReview，以提交企业内部审批结果。可以多次提交审批结果，但一旦审批通过，后续提交的结果将无效
195
+ </li>
196
+ </ul>
197
+ </li>
198
+ </ul>
175
199
  */
176
200
  CreateFlowSignReview(req: CreateFlowSignReviewRequest, cb?: (error: string, rep: CreateFlowSignReviewResponse) => void): Promise<CreateFlowSignReviewResponse>;
177
201
  /**
@@ -278,11 +302,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
278
302
  跳转到小程序的实现，参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
279
303
 
280
304
  注：
281
- `1. 如果签署人是在PC端扫码签署，可以通过生成跳转链接自主转换成二维码，让签署人在PC端扫码签署`
282
-
283
- `2. 签署链接的有效期为90天，超过有效期链接不可用`
284
-
285
- `3. 如果需跳转详情页（即PathType值为1）进行填写或签署合同，需指定签署方信息：姓名、手机号码、企业名称等，才能生成正确的跳转链接`
305
+ <ul><li>1. 如果签署人是在PC端扫码签署，可以通过生成跳转链接自主转换成二维码，让签署人在PC端扫码签署</li>
306
+ <li>2. 签署链接的有效期为<font color="red">90天</font>，超过有效期链接不可用</li>
307
+ <li>3. 如果需跳转详情页（即PathType值为1）进行填写或签署合同，需指定签署方信息:姓名、手机号码、企业名称等，才能生成正确的跳转链接</li>
308
+ <li>4. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）</li></ul>
286
309
 
287
310
  其中小程序的原始Id如下，或者查看小程序信息自助获取。
288
311
 
@@ -484,6 +507,20 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
484
507
  注: `每个企业限制日调用量限制：100W，当日超过此限制后再调用接口返回错误`
485
508
  */
486
509
  DescribeFlowBriefs(req: DescribeFlowBriefsRequest, cb?: (error: string, rep: DescribeFlowBriefsResponse) => void): Promise<DescribeFlowBriefsResponse>;
510
+ /**
511
+ * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
512
+
513
+ 适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
514
+
515
+ 适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。此处注意权限树内容可能会更新，需尽量拉取最新的权限树内容，并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
516
+
517
+ 适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
518
+
519
+ 适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
520
+
521
+ 注意事项：SaaS角色和集团角色对应的权限树是不一样的。
522
+ */
523
+ CreateIntegrationRole(req: CreateIntegrationRoleRequest, cb?: (error: string, rep: CreateIntegrationRoleResponse) => void): Promise<CreateIntegrationRoleResponse>;
487
524
  /**
488
525
  * 此接口用于赋予员工指定的角色权限，如需解绑请使用 DeleteIntegrationRoleUsers 接口。
489
526
  */
package/tencentcloud/services/ess/v20201111/ess_client.js CHANGED
@@ -139,20 +139,17 @@ class Client extends TencentCloudCommon.AbstractClient {
139
139
  return this.request("CreateUserAutoSignEnableUrl", req, cb);
140
140
  }
141
141
  /**
142
- * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
143
-
144
- 适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
145
-
146
- 适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。此处注意权限树内容可能会更新，需尽量拉取最新的权限树内容，并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
142
+ * 提交合同组签署流程审批结果的适用场景包括：
147
143
 
148
- 适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
144
+ 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时，若指定了以下参数 为true，则可以调用此接口提交企业内部签署审批结果。即使是自动签署也需要进行审核通过才会进行签署。
145
+ - [FlowGroupInfo.NeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#flowgroupinfo)
146
+ - [ApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#approverinfo)
149
147
 
150
- 适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
151
148
 
152
- 注意事项：SaaS角色和集团角色对应的权限树是不一样的。
149
+ 2. 同一合同组，同一签署人可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
153
150
  */
154
- async CreateIntegrationRole(req, cb) {
155
- return this.request("CreateIntegrationRole", req, cb);
151
+ async CreateFlowGroupSignReview(req, cb) {
152
+ return this.request("CreateFlowGroupSignReview", req, cb);
156
153
  }
157
154
  /**
158
155
  * 本接口（CreateEmbedWebUrl）用于创建嵌入Web的链接，支持以下类型的Web链接创建：
@@ -232,9 +229,36 @@ class Client extends TencentCloudCommon.AbstractClient {
232
229
  return this.request("DeleteIntegrationRoleUsers", req, cb);
233
230
  }
234
231
  /**
235
- * 提交签署流程审批结果的适用场景包括：
236
- 1. 在使用模板（CreateFlow）或文件（CreateFlowByFiles）创建签署流程时，若指定了参数NeedSignReview为true，且发起方企业作为签署方参与了流程签署，则可以调用此接口提交企业内部签署审批结果。自动签署也需要进行审核通过才会进行签署。
237
- 2. 若签署流程状态正常，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
232
+ * 提交企业流程审批结果
233
+ **当前存在两种审核操作：**
234
+ <ul>
235
+ <li>签署审核
236
+ <ul>
237
+ <li>在通过接口<ul>
238
+ <li>CreateFlowByFiles</li>
239
+ <li>CreateFlow</li>
240
+ <li>CreateFlowGroupByTemplates</li>
241
+ <li>CreateFlowGroupByFiles</li>
242
+ <li>CreatePrepareFlow</li>
243
+ </ul>
244
+ 发起签署流程时，通过指定NeedSignReview为true，则可以调用此接口，并指定operate=SignReview，以提交企业内部签署审批结果</li>
245
+ <li>在通过接口
246
+ <ul>
247
+ <li>CreateFlowByFiles</li>
248
+ <li>CreateFlow</li>
249
+ <li>CreateFlowGroupByTemplates</li>
250
+ <li>CreateFlowGroupByFiles</li>
251
+ </ul>
252
+ 发起签署流程时，通过指定签署人ApproverNeedSignReview为true，则可以调用此接口，并指定operate=SignReview，并指定RecipientId，以提交企业内部签署审批结果</li>
253
+ </ul>
254
+ </li>
255
+ <li>发起审核
256
+ <ul>
257
+ <li>通过接口CreatePrepareFlow指定发起后需要审核，那么可以调用此接口，并指定operate=CreateReview，以提交企业内部审批结果。可以多次提交审批结果，但一旦审批通过，后续提交的结果将无效
258
+ </li>
259
+ </ul>
260
+ </li>
261
+ </ul>
238
262
  */
239
263
  async CreateFlowSignReview(req, cb) {
240
264
  return this.request("CreateFlowSignReview", req, cb);
@@ -355,11 +379,10 @@ class Client extends TencentCloudCommon.AbstractClient {
355
379
  跳转到小程序的实现，参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
356
380
 
357
381
  注：
358
- `1. 如果签署人是在PC端扫码签署，可以通过生成跳转链接自主转换成二维码，让签署人在PC端扫码签署`
359
-
360
- `2. 签署链接的有效期为90天，超过有效期链接不可用`
361
-
362
- `3. 如果需跳转详情页（即PathType值为1）进行填写或签署合同，需指定签署方信息：姓名、手机号码、企业名称等，才能生成正确的跳转链接`
382
+ <ul><li>1. 如果签署人是在PC端扫码签署，可以通过生成跳转链接自主转换成二维码，让签署人在PC端扫码签署</li>
383
+ <li>2. 签署链接的有效期为<font color="red">90天</font>，超过有效期链接不可用</li>
384
+ <li>3. 如果需跳转详情页（即PathType值为1）进行填写或签署合同，需指定签署方信息:姓名、手机号码、企业名称等，才能生成正确的跳转链接</li>
385
+ <li>4. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）</li></ul>
363
386
 
364
387
  其中小程序的原始Id如下，或者查看小程序信息自助获取。
365
388
 
@@ -599,6 +622,22 @@ class Client extends TencentCloudCommon.AbstractClient {
599
622
  async DescribeFlowBriefs(req, cb) {
600
623
  return this.request("DescribeFlowBriefs", req, cb);
601
624
  }
625
+ /**
626
+ * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
627
+
628
+ 适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
629
+
630
+ 适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。此处注意权限树内容可能会更新，需尽量拉取最新的权限树内容，并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
631
+
632
+ 适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
633
+
634
+ 适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
635
+
636
+ 注意事项：SaaS角色和集团角色对应的权限树是不一样的。
637
+ */
638
+ async CreateIntegrationRole(req, cb) {
639
+ return this.request("CreateIntegrationRole", req, cb);
640
+ }
602
641
  /**
603
642
  * 此接口用于赋予员工指定的角色权限，如需解绑请使用 DeleteIntegrationRoleUsers 接口。
604
643
  */
package/tencentcloud/services/ess/v20201111/ess_models.d.ts CHANGED
@@ -356,6 +356,21 @@ export interface CreatePreparedPersonalEsignRequest {
356
356
  */
357
357
  SceneKey?: string;
358
358
  }
359
+ /**
360
+ * 删除员工结果
361
+ */
362
+ export interface DeleteStaffsResult {
363
+ /**
364
+ * 删除员工的成功数据
365
+ 注意：此字段可能返回 null，表示取不到有效值。
366
+ */
367
+ SuccessEmployeeData: Array<SuccessDeleteStaffData>;
368
+ /**
369
+ * 删除员工的失败数据
370
+ 注意：此字段可能返回 null，表示取不到有效值。
371
+ */
372
+ FailedEmployeeData: Array<FailedDeleteStaffData>;
373
+ }
359
374
  /**
360
375
  * DescribeIntegrationDepartments返回参数结构体
361
376
  */
@@ -504,35 +519,32 @@ export interface CreateMultiFlowSignQRCodeResponse {
504
519
  */
505
520
  export interface FlowApproverUrlInfo {
506
521
  /**
507
- * 签署短链接。</br>
522
+ * 签署短链接。
508
523
  注意:
509
- - 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
510
- - 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
511
- 注意：此字段可能返回 null，表示取不到有效值。
524
+ 1. 该链接有效期为<b>30分钟</b>，同时需要注意保密，不要外泄给无关用户。
525
+ 2. 该链接不支持小程序嵌入，仅支持<b>移动端浏览器</b>打开。
526
+ 3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
512
527
  */
513
528
  SignUrl?: string;
514
529
  /**
515
530
  * 签署人类型。
516
531
  - **1**: 个人
517
- 注意：此字段可能返回 null，表示取不到有效值。
518
532
  */
519
533
  ApproverType?: number;
520
534
  /**
521
535
  * 签署人姓名。
522
- 注意：此字段可能返回 null，表示取不到有效值。
523
536
  */
524
537
  ApproverName?: string;
525
538
  /**
526
539
  * 签署人手机号。
527
- 注意：此字段可能返回 null，表示取不到有效值。
528
540
  */
529
541
  ApproverMobile?: string;
530
542
  /**
531
- * 签署长链接。</br>
543
+ * 签署长链接。
532
544
  注意:
533
- - 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
534
- - 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
535
- 注意：此字段可能返回 null，表示取不到有效值。
545
+ 1. 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
546
+ 2. 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
547
+ 3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
536
548
  */
537
549
  LongUrl?: string;
538
550
  }
@@ -1043,6 +1055,59 @@ export interface DeleteIntegrationEmployeesResponse {
1043
1055
  */
1044
1056
  RequestId?: string;
1045
1057
  }
1058
+ /**
1059
+ * 需要进行签署审核的签署人信息
1060
+ */
1061
+ export interface NeedReviewApproverInfo {
1062
+ /**
1063
+ * 签署方经办人的类型，支持以下类型
1064
+ <ul><li> ORGANIZATION 企业（含企业自动签）</li>
1065
+ <li>PERSON 个人（含个人自动签）</li></ul>
1066
+ */
1067
+ ApproverType: string;
1068
+ /**
1069
+ * 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
1070
+ */
1071
+ ApproverName: string;
1072
+ /**
1073
+ * 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。
1074
+ */
1075
+ ApproverMobile?: string;
1076
+ /**
1077
+ * 签署方经办人的证件类型，支持以下类型
1078
+ <ul><li>ID_CARD 居民身份证 (默认值)</li>
1079
+ <li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
1080
+ <li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
1081
+ <li>OTHER_CARD_TYPE 其他证件</li></ul>
1082
+
1083
+ 注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
1084
+ */
1085
+ ApproverIdCardType?: string;
1086
+ /**
1087
+ * 签署方经办人的证件号码，应符合以下规则
1088
+ <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
1089
+ <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
1090
+ <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
1091
+ */
1092
+ ApproverIdCardNumber?: string;
1093
+ /**
1094
+ * 组织机构名称。
1095
+ 请确认该名称与企业营业执照中注册的名称一致。
1096
+ 如果名称中包含英文括号()，请使用中文括号（）代替。
1097
+ 如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
1098
+
1099
+ */
1100
+ OrganizationName?: string;
1101
+ }
1102
+ /**
1103
+ * CreateFlowGroupSignReview返回参数结构体
1104
+ */
1105
+ export interface CreateFlowGroupSignReviewResponse {
1106
+ /**
1107
+ * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1108
+ */
1109
+ RequestId?: string;
1110
+ }
1046
1111
  /**
1047
1112
  * CreateBatchSignUrl返回参数结构体
1048
1113
  */
@@ -1050,7 +1115,9 @@ export interface CreateBatchSignUrlResponse {
1050
1115
  /**
1051
1116
  * 批量签署链接，以短链形式返回，短链的有效期参考回参中的 ExpiredTime。
1052
1117
 
1053
- 注: `非小程序和APP集成使用`
1118
+ 注:
1119
+ 1. 非小程序和APP集成使用
1120
+ 2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
1054
1121
  */
1055
1122
  SignUrl?: string;
1056
1123
  /**
@@ -1060,7 +1127,9 @@ export interface CreateBatchSignUrlResponse {
1060
1127
  /**
1061
1128
  * 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
1062
1129
 
1063
- 注: `小程序和APP集成使用`
1130
+ 注:
1131
+ 1. 小程序和APP集成使用
1132
+ 2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
1064
1133
  */
1065
1134
  MiniAppPath?: string;
1066
1135
  /**
@@ -2704,31 +2773,24 @@ export interface CreateFlowSignReviewRequest {
2704
2773
  Operator: UserInfo;
2705
2774
  /**
2706
2775
  * 合同流程ID，为32位字符串。
2707
- 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
2708
- 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
2776
+ <ul><li>建议开发者妥善保存此流程ID，以便于顺利进行后续操作。</li>
2777
+ <li>可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。</li></ul>
2709
2778
  */
2710
2779
  FlowId: string;
2711
2780
  /**
2712
- * 企业审核结果
2713
- <ul><li>PASS: 通过</li>
2714
- <li>REJECT: 拒绝</li></ul>
2781
+ * 企业内部审核结果
2782
+ <ul><li>PASS: 审核通过</li>
2783
+ <li>REJECT: 审核拒绝</li>
2784
+ <li>SIGN_REJECT:拒签(流程结束)</li></ul>
2715
2785
  */
2716
2786
  ReviewType: string;
2717
- /**
2718
- * 审核结果原因，
2719
- 字符串长度不超过200
2720
- 当ReviewType 是拒绝（REJECT） 时此字段必填。
2721
-
2722
- */
2723
- ReviewMessage?: string;
2724
2787
  /**
2725
2788
  * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
2726
2789
  */
2727
2790
  Agent?: Agent;
2728
2791
  /**
2729
- * 审核签署节点人标识，
2730
- 用来标识审核的签署方。
2731
- 如果签署审核节点是个人， 此参数必填。
2792
+ * 审核节点的签署人标志，用于指定当前审核的签署方
2793
+ <ul><li>**如果签署审核节点是个人， 此参数必填**。</li></ul>
2732
2794
  */
2733
2795
  RecipientId?: string;
2734
2796
  /**
@@ -2740,6 +2802,15 @@ export interface CreateFlowSignReviewRequest {
2740
2802
  如果审核节点是个人，则操作类型只能为SignReview。
2741
2803
  */
2742
2804
  OperateType?: string;
2805
+ /**
2806
+ * 审核结果原因
2807
+ <ul><li>字符串长度不超过200</li>
2808
+ <li>当ReviewType 是拒绝（REJECT） 时此字段必填。</li>
2809
+ <li>当ReviewType 是拒绝（SIGN_REJECT） 时此字段必填。</li></ul>
2810
+
2811
+
2812
+ */
2813
+ ReviewMessage?: string;
2743
2814
  }
2744
2815
  /**
2745
2816
  * UnbindEmployeeUserIdWithClientOpenId请求参数结构体
@@ -2776,6 +2847,9 @@ export interface CreateSchemeUrlResponse {
2776
2847
  <ul><li>如果EndPoint是**APP**，得到的链接类似于`pages/guide?from=default&where=mini&id=yDwJSUUirqauh***7jNSxwdirTSGuH&to=CONTRACT_DETAIL&name=&phone=&shortKey=yDw***k1xFc5`, 用法可以参加接口描述中的"跳转到小程序的实现"</li>
2777
2848
  <li>如果EndPoint是**HTTP**，得到的链接类似于 `https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?where=mini&from=SFY&id=yDwfEUUw**4rV6Avz&to=MVP_CONTRACT_COVER&name=%E9%83%**5%86%9B`，点击后会跳转到腾讯电子签小程序进行签署</li>
2778
2849
  <li>如果EndPoint是**HTTP_SHORT_URL**，得到的链接类似于 `https://essurl.cn/2n**42Nd`，点击后会跳转到腾讯电子签小程序进行签署</li></ul>
2850
+
2851
+
2852
+ 注： <font color="red">生成的链路后面不能再增加参数</font>
2779
2853
  */
2780
2854
  SchemeUrl?: string;
2781
2855
  /**
@@ -3176,7 +3250,8 @@ FormField输入示例：
3176
3250
  }
3177
3251
  ```
3178
3252
 
3179
- 当控件的 ComponentType='ATTACHMENT'时，FormField.ComponentValue填入附件图片的资源ID列表，以逗号分隔，单个附件控件最多支持6个资源ID；
3253
+ 当控件的 ComponentType='ATTACHMENT'时，FormField.ComponentValue支持填入附件图片或者文件的资源ID列表，以逗号分隔，单个附件控件最多支持6个资源ID；
3254
+ 支持的文件类型包括doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt、pdf
3180
3255
 
3181
3256
  ```
3182
3257
  FormField输入示例：
@@ -6443,19 +6518,48 @@ export interface VerifyPdfResponse {
6443
6518
  RequestId?: string;
6444
6519
  }
6445
6520
  /**
6446
- * 删除员工结果
6521
+ * CreateFlowGroupSignReview请求参数结构体
6447
6522
  */
6448
- export interface DeleteStaffsResult {
6523
+ export interface CreateFlowGroupSignReviewRequest {
6449
6524
  /**
6450
- * 删除员工的成功数据
6451
- 注意：此字段可能返回 null，表示取不到有效值。
6525
+ * 执行本接口操作的员工信息。
6526
+ 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
6452
6527
  */
6453
- SuccessEmployeeData: Array<SuccessDeleteStaffData>;
6528
+ Operator: UserInfo;
6454
6529
  /**
6455
- * 删除员工的失败数据
6456
- 注意：此字段可能返回 null，表示取不到有效值。
6530
+ * 合同(流程)组的合同组Id，为32位字符串，通过接口[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles) 或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时返回。
6457
6531
  */
6458
- FailedEmployeeData: Array<FailedDeleteStaffData>;
6532
+ FlowGroupId: string;
6533
+ /**
6534
+ * 提交的审核结果，审核结果有下面三种情况
6535
+ <ul><li><b>PASS</b>: 审核通过，合同流程可以继续执行签署等操作</li>
6536
+ <li><b>REJECT</b>: 审核拒绝，合同流程不会变动</li>
6537
+ <li><b>SIGN_REJECT</b>:拒签，合同流程直接结束，合同状态变为**合同拒签**</li></ul>
6538
+ */
6539
+ ReviewType: string;
6540
+ /**
6541
+ * 需要进行签署审核的签署人的个人信息或企业信息，签署方的匹配方式按照以下规则:
6542
+
6543
+ 个人：二选一（选择其中任意信息组合即可）
6544
+ <ul><li>姓名+证件类型+证件号</li>
6545
+ <li>姓名+手机号</li></ul>
6546
+
6547
+ 企业：二选一 （选择其中任意信息组合即可）
6548
+ <ul><li>企业名+姓名+证件类型+证件号</li>
6549
+ <li>企业名+姓名+手机号</li></ul>
6550
+ */
6551
+ ApproverInfo: NeedReviewApproverInfo;
6552
+ /**
6553
+ * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
6554
+ */
6555
+ Agent?: Agent;
6556
+ /**
6557
+ * 审核不通过的原因，该字段的字符串长度不超过200个字符。
6558
+
6559
+ 注：`当审核类型（ReviewType）为审核拒绝（REJECT）或拒签（SIGN_REJECT）时，审核结果原因字段必须填写`
6560
+
6561
+ */
6562
+ ReviewMessage?: string;
6459
6563
  }
6460
6564
  /**
6461
6565
  * DescribeBillUsageDetail请求参数结构体