tencentcloud-sdk-nodejs-essbasic 4.0.1014 → 4.0.1019

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.
@@ -27,20 +27,6 @@ class Client extends TencentCloudCommon.AbstractClient {
27
27
  constructor(clientConfig) {
28
28
  super("essbasic.tencentcloudapi.com", "2021-05-26", clientConfig);
29
29
  }
30
- /**
31
- * 此接口(ChannelDeleteSealPolicies)用于删除已指定员工印章授权信息,删除员工的印章授权后,该员工使用印章进行盖章时,将需要提交印章授权申请且通过审核后才能使用该印章进行签署。
32
- */
33
- async ChannelDeleteSealPolicies(req, cb) {
34
- return this.request("ChannelDeleteSealPolicies", req, cb);
35
- }
36
- /**
37
- * 给医疗个人自动签许可续期。续期成功后,可对医疗自动签许可追加一年有效期,只可续期一次。
38
-
39
- 注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
40
- */
41
- async ChannelRenewAutoSignLicense(req, cb) {
42
- return this.request("ChannelRenewAutoSignLicense", req, cb);
43
- }
44
30
  /**
45
31
  * 提交企业流程审批结果
46
32
  **当前存在两种审核操作:**
@@ -62,45 +48,6 @@ class Client extends TencentCloudCommon.AbstractClient {
62
48
  async ChannelCreateFlowSignReview(req, cb) {
63
49
  return this.request("ChannelCreateFlowSignReview", req, cb);
64
50
  }
65
- /**
66
- * 管理企业扩展服务
67
-
68
- - **直接开通的情形:** 若在操作过程中接口没有返回跳转链接,这表明无需进行任何跳转操作。此时,相应的企业拓展服务将会直接被开通或关闭。
69
-
70
- - **需要法人或者超管签署开通协议的情形:** 当需要开通以下企业拓展服务时, 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成服务的开通操作。
71
- - **AUTO_SIGN(企业自动签)**
72
- - **DOWNLOAD_FLOW(授权渠道下载合同)**
73
-
74
- 注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人`
75
-
76
-
77
- 对应的扩展服务能力可以在控制台的【扩展服务】中找到
78
- ![image](https://qcloudimg.tencent-cloud.cn/raw/99eebd37883ec55ed1f1df3a57aee60a.png)
79
- */
80
- async ModifyExtendedService(req, cb) {
81
- return this.request("ModifyExtendedService", req, cb);
82
- }
83
- /**
84
- * 此接口(ChannelCreateMultiFlowSignQRCode)用于创建一码多签签署码。
85
-
86
- **适用场景**:
87
- 签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
88
-
89
- **注意**:
90
- 1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**, 若是B2C模板,还要满足以下任意一个条件
91
- - 模板中配置的签署顺序是无序
92
- - B端企业的签署方式是静默签署
93
- - B端企业是非首位签署
94
- 2. 通过扫描一码多签签署码发起的合同,合同涉及到的回调消息可参考文档[合同发起及签署相关回调
95
- ]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
96
- 3. 用户通过扫描一码多签签署码发起合同时,因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
97
-
98
- 签署码的样式如下图:
99
- ![image](https://qcloudimg.tencent-cloud.cn/raw/27317cf5aacb094fb1dc6f94179a5148.png )
100
- */
101
- async ChannelCreateMultiFlowSignQRCode(req, cb) {
102
- return this.request("ChannelCreateMultiFlowSignQRCode", req, cb);
103
- }
104
51
  /**
105
52
  * 此接口(ChannelModifyRole)用来更新企业自定义角色。
106
53
 
@@ -112,74 +59,15 @@ class Client extends TencentCloudCommon.AbstractClient {
112
59
  return this.request("ChannelModifyRole", req, cb);
113
60
  }
114
61
  /**
115
- * 接口(ChannelCreateFlowByFiles)用PDF文件创建签署流程。
116
-
117
- 适用场景:适用非制式的合同文件签署,开发者有每个签署流程的PDF,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
118
-
119
- **注**:
120
- <ul>
121
- <li>此接口静默签(企业自动签)能力为白名单功能,使用前请联系对接的客户经理沟通。</li>
122
- <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号(FileIds)进行使用。整体的逻辑如下图</li>
123
- </ul>
124
-
125
- ![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
126
-
127
- **可以作为发起方和签署方的角色列表**
128
- <table> <thead> <tr> <th>场景编号</th> <th>发起方</th> <th>签署方</th> <th>补充</th> </tr> </thead> <tbody> <tr> <td>场景一</td> <td>子企业A的员工</td> <td>子企业A的员工</td> <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td> </tr> <tr> <td>场景二</td> <td>子企业A的员工</td> <td>子企业B(不指定经办人走领取逻辑)</td> <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td> </tr> <tr> <td>场景三</td> <td>子企业A的员工</td> <td>子企业B的员工</td> <td>-</td> </tr> <tr> <td>场景四</td> <td>子企业A的员工</td> <td>个人</td> <td>就是自然人,不是企业员工</td> </tr> <tr> <td>场景五</td> <td>子企业A的员工</td> <td>SaaS平台企业员工</td> <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td> </tr> </tbody> </table>
129
-
130
-
131
- **注**:
132
- `1. 发起合同时候, 作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
133
-
134
- `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
135
-
136
- `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(过期,拒签,签署完成,解除完成等状态不会返还额度)`
137
-
138
- `4. 静默(自动)签署不支持合同签署方存在填写功能`
139
-
140
- <font color="red">相关视频指引</font> <br>
141
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
142
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
143
- */
144
- async ChannelCreateFlowByFiles(req, cb) {
145
- return this.request("ChannelCreateFlowByFiles", req, cb);
146
- }
147
- /**
148
- * 获取区块链存证证书查看链接/二维码接口
149
-
150
- 适用场景:企业员工可以通过此接口生成合同区块链存证证书的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
151
-
152
- [点击查看区块链存证证书样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
153
-
154
- 注:
155
- <ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
156
- <li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成证书查看二维码/短链。</li>
157
- <li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
158
- <li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证证书,请妥善保管好二维码或链接。</li></ul>
159
- */
160
- async CreateFlowBlockchainEvidenceUrl(req, cb) {
161
- return this.request("CreateFlowBlockchainEvidenceUrl", req, cb);
162
- }
163
- /**
164
- * 此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID,然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
165
- ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
166
-
167
-
168
- 注:
169
- `异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间`
170
- */
171
- async DescribeBatchOrganizationRegistrationUrls(req, cb) {
172
- return this.request("DescribeBatchOrganizationRegistrationUrls", req, cb);
173
- }
174
- /**
175
- * 1. 可以**通过图片**为子客企业代创建印章,图片最大5MB
176
-
177
- 2. 可以**系统创建**子客企业代创建印章, 系统创建的印章样子下图(样式可以调整)
62
+ * 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时,若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
63
+ - [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
64
+ - [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)
65
+ - [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo)
178
66
 
179
- ![image](https://dyn.ess.tencent.cn/guide/capi/CreateSealByImage.png)
67
+ 2. 同一合同组,同一签署人可以多次提交签署审批结果,签署时的最后一个“审批结果”有效。
180
68
  */
181
- async CreateSealByImage(req, cb) {
182
- return this.request("CreateSealByImage", req, cb);
69
+ async CreateFlowGroupSignReview(req, cb) {
70
+ return this.request("CreateFlowGroupSignReview", req, cb);
183
71
  }
184
72
  /**
185
73
  * 此接口(CancelMultiFlowSignQRCode)用于废除取消一码多签签署码。
@@ -209,35 +97,15 @@ class Client extends TencentCloudCommon.AbstractClient {
209
97
  return this.request("DescribeExtendedServiceAuthInfo", req, cb);
210
98
  }
211
99
  /**
212
- * 分页查询企业角色列表,法人的角色是系统保留角色,不会返回,按照角色创建时间升序排列。
213
-
214
-
215
- <font color="red">系统默认角色</font>说明可参考下表
100
+ * 此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID,然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
101
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
216
102
 
217
- | 角色名称| 建议授予对象 | 角色描述 |
218
- | --- | --- | --- |
219
- | **超级管理员** |电子签业务最高权限,可以授权给法务/企业法人/业务负责人等 | 所有功能和数据管理权限,只能设置一位超管。 |
220
- | **业务管理员**|IT 系统负责人,可以授权给CTO等 | 企业合同模块、印章模块、模板模块等全量功能及数据权限。 |
221
- | **经办人**|企业法务负责人等 | 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看企业所有合同数据。 |
222
- | **业务员**|销售员、采购员 等| 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看自己相关所有合同数据。 |
223
103
 
224
- 附件:<a href="https://dyn.ess.tencent.cn/guide/apivideo/roles.xlsx" target="_blank">点击下载角色对应的权限点的excel文档</a>
225
- */
226
- async ChannelDescribeRoles(req, cb) {
227
- return this.request("ChannelDescribeRoles", req, cb);
228
- }
229
- /**
230
- * 此接口(ChannelCreateConvertTaskApi)用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
231
- 前提条件:源文件已经通过 <a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>完成上传,并得到了源文件的资源Id。<br />
232
- 适用场景1:已经上传了一个word文件,希望将该word文件转换成pdf文件后发起合同
233
- 适用场景2:已经上传了一个jpg图片文件,希望将该图片文件转换成pdf文件后发起合同<br />
234
- 转换文件是一个耗时操作,若想查看转换任务是否完成,可以通过<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelGetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
235
- 注:
236
- 1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
237
- 2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
104
+ 注:
105
+ `异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间`
238
106
  */
239
- async ChannelCreateConvertTaskApi(req, cb) {
240
- return this.request("ChannelCreateConvertTaskApi", req, cb);
107
+ async DescribeBatchOrganizationRegistrationUrls(req, cb) {
108
+ return this.request("DescribeBatchOrganizationRegistrationUrls", req, cb);
241
109
  }
242
110
  /**
243
111
  * 此接口(DescribeUsage)用于获取此应用下子客企业的合同消耗数量。
@@ -250,90 +118,270 @@ class Client extends TencentCloudCommon.AbstractClient {
250
118
  return this.request("DescribeUsage", req, cb);
251
119
  }
252
120
  /**
253
- * 查询企业扩展服务的授权详情(列表),当前支持查询以下内容:
254
-
255
- 1. **企业自动签**
256
- 2. **批量签署**
121
+ * 该接口用于在使用视频认证方式签署合同后,获取用户的签署人脸认证视频。
257
122
 
123
+ 1. 该接口**仅适用于在H5端签署**的合同,**在通过视频认证后**获取认证的视频内容。
124
+ 2. 该接口**不支持小程序端**的签署认证的视频获取。
125
+ 3. 请在**签署完成后的三天内**获取视频,**过期后将无法获取**。
258
126
 
259
- 注: <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
127
+ **注意:该接口需要开通白名单,请联系客户经理开通后使用。**
260
128
  */
261
- async DescribeExtendedServiceAuthDetail(req, cb) {
262
- return this.request("DescribeExtendedServiceAuthDetail", req, cb);
129
+ async ChannelDescribeSignFaceVideo(req, cb) {
130
+ return this.request("ChannelDescribeSignFaceVideo", req, cb);
263
131
  }
264
132
  /**
265
- * 在已启动的签署流程中,可对签署截止日期进行延期操作,主要分为以下两个层面:
266
- 1. <b> 合同(流程)层面</b>:仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
267
- 2. <b> 签署人层面</b> :需提供流程ID和签署人ID。此操作针对特定签署人进行延期,特别是对于有序合同(流程),签署截止时间不得超过后续签署人的流程截止时间。
268
-
269
- 此接口存在以下限制:
270
- 1. 执行操作的员工须为<font color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
271
- 2. 延长整个签署流程时,<font color="red">应至少有一方尚未签署</font>(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
272
- 3. 延长整个签署流程时,新的签署截止日期应晚于已设定的签署截止日期和当前日期。
273
- 4. 延长签署方截止时间时,<font color="red">签署方不能处于流程完结或已终止状态</font>(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
274
- 5. 延长签署方截止时间时,新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同,还需早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
275
- 6. <font color="red">不支持操作合同组合同</font>。
133
+ * 通过此接口,删除员工绑定的角色,支持以电子签userId、客户系统userId两种方式调用。
276
134
 
277
- 合同(流程)层面截止时间子企业控制台展示的位置:
278
- ![image](https://qcloudimg.tencent-cloud.cn/raw/f0f88c0eb49a926da9a86e5a6e9efa8b.png)
135
+ 对应控制台的操作如下图
136
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/5b41194d3cb3f2058ec0ba0fb5ebc6a6.png)
279
137
  */
280
- async ModifyFlowDeadline(req, cb) {
281
- return this.request("ModifyFlowDeadline", req, cb);
138
+ async ChannelDeleteRoleUsers(req, cb) {
139
+ return this.request("ChannelDeleteRoleUsers", req, cb);
282
140
  }
283
141
  /**
284
- * 撤销签署流程接口
142
+ * 创建跳转小程序查看或签署的链接
285
143
 
286
- 适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
144
+ **腾讯电子签小程序的AppID 和 原始Id如下:**
287
145
 
288
- - **可撤回合同状态**:未全部签署完成
289
- - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
146
+ | 小程序 | AppID | 原始ID |
147
+ | ------------ | ------------ | ------------ |
148
+ | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
149
+ | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
290
150
 
291
- 注:
292
- - 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
293
- - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
294
- - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
295
- - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
151
+ **主要使用场景EndPoint分类**
152
+
153
+ |EndPoint| 场景| 说明和示例|
154
+ | ---- | ---- | --- |
155
+ | WEIXINAPP | 短链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序(与腾讯电子签官方短信提醒用户签署形式一样)<br> 示例: https://essurl.cn/x9nvWU8fTg|
156
+ | LONGURL2WEIXINAPP | 长链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
157
+ | CHANNEL | 带有H5引导页的跳转腾讯电子签小程序签署场景 | 点击链接打开一个H5引导页面, 页面中有个"前往小程序"的按钮, 点击后会跳转到腾讯电子签小程序签署场景; 签署完成会回到H5引导页面, 然后跳转到指定创建链接指定的JumpUrl<br>示例: https://res.ess.tencent.cn/cdn/h5-activity-beta/jump-mp.html?use=channel-guide&type=warning&token=uIFKIU8fTd |
158
+ |APP| <font color="red">贵方APP</font>跳转腾讯电子签小程序签署场景| 贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方App的场景<br>跳转到腾讯电子签小程序的实现可以参考微信的官方文档:<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html" target="_blank">开放能力/打开 App</a> <br> 示例: pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
159
+ |APP| <font color="red">贵方小程序</font>跳转腾讯电子签小程序签署场景| 贵方小程序直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方小程序的场景<br>跳转到腾讯电子签小程序的实现可以参考微信官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" target="_blank">全屏方式</a>和<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html " target="_blank">半屏方式</a><br>此时返回的SignUrl就是官方文档中的path<br> 示例:pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
296
160
  */
297
- async ChannelCancelFlow(req, cb) {
298
- return this.request("ChannelCancelFlow", req, cb);
161
+ async CreateSignUrls(req, cb) {
162
+ return this.request("CreateSignUrls", req, cb);
299
163
  }
300
164
  /**
301
- * 通过此接口,可以创建企业批量签署链接,员工只需点击链接即可跳转至控制台进行批量签署。
165
+ * 此接口(ChannelCreateBoundFlows)用于子客企业领取未归属给员工的合同,将合同领取给当前员工,合同不能重复领取。
302
166
 
303
- 注:
304
- - 员工必须在企业下完成实名认证,且需作为批量签署合同的签署方或者领取方。
305
- - 仅支持传入待签署或者待领取的合同,待填写暂不支持。
306
- - 员工批量签署,支持多种签名方式,包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
307
167
 
308
- 签署的嵌入页面长相如下:
309
- ![image](https://qcloudimg.tencent-cloud.cn/raw/a4754bc835a3f837ddec1e28b02ed9c0.png)
168
+ **未归属合同发起方式**
169
+ 指定对应企业的OrganizationOpenId和OrganizationName而不指定具体的参与人(OpenId/名字/手机号等), 则合同进入待领取状态, 示例代码如下
170
+ ```
171
+ FlowApprovers: []*essbasic.FlowApproverInfo{
172
+ {
173
+ ApproverType: common.StringPtr("ORGANIZATION"),
174
+ OrganizationOpenId: common.StringPtr("org_dianziqian"),
175
+ OrganizationName: common.StringPtr("典子谦示例企业"),
176
+ }
177
+ },
178
+ ```
179
+
180
+ 可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
181
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/a34d0cc56ec871613e94dfc6252bc072.png)
182
+
183
+ 注:
184
+ 1. 支持批量领取, 如果有一个合同流程无法领取会导致接口报错, 使得所有合同都领取失败
185
+ 2. 只有企业的<font color="red">超管或者法人</font>才能进行合同的领取
310
186
  */
311
- async ChannelCreateOrganizationBatchSignUrl(req, cb) {
312
- return this.request("ChannelCreateOrganizationBatchSignUrl", req, cb);
313
- }
314
- /**
315
- * 通过接口[批量撤销合同流程](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelBatchCancelFlows)或者[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateBatchCancelFlowUrl)发起批量撤销任务后,可通过此接口查询批量撤销任务的结果。
316
- */
317
- async DescribeCancelFlowsTask(req, cb) {
318
- return this.request("DescribeCancelFlowsTask", req, cb);
187
+ async ChannelCreateBoundFlows(req, cb) {
188
+ return this.request("ChannelCreateBoundFlows", req, cb);
319
189
  }
320
190
  /**
321
- * 将指定印章授权给第三方平台子客企业下的某些员工
191
+ * 创建一个用于他方自动签授权的链接(可选择他方授权或我方授权)。通过这个链接,合作方企业可以直接进入小程序,进行自动签授权操作。
192
+
193
+ 如果授权企业尚未开通企业自动签功能,该链接还将引导他们首先开通本企业的自动签服务
194
+
195
+
196
+ 注:
197
+ 1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
198
+ 2. 已经在授权中或者授权成功的企业,无法重复授权
199
+ 3. 授权企业和被授权企业必须都是已认证企业
200
+ 4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
201
+
202
+ **该接口效果同控制台: 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
203
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/091823fd4f02af7dda416fa10ca65f2d.png)
204
+ */
205
+ async CreatePartnerAutoSignAuthUrl(req, cb) {
206
+ return this.request("CreatePartnerAutoSignAuthUrl", req, cb);
207
+ }
208
+ /**
209
+ * 用来创建嵌入式页面个性化主题配置(例如是否展示电子签logo、定义主题色等),该接口配合其他所有可嵌入页面接口使用
210
+ 创建配置对当前第三方应用全局生效,如果多次调用,会以最后一次的配置为准
211
+ */
212
+ async ChannelCreateWebThemeConfig(req, cb) {
213
+ return this.request("ChannelCreateWebThemeConfig", req, cb);
214
+ }
215
+ /**
216
+ * 指定需要批量催办的签署流程ID,批量催办合同,最多100个。需要符合以下条件的合同才可被催办
217
+ 1. 合同中当前状态为 **待签署** 的签署人是催办的对象
218
+ 2. **每个合同只能催办一次**
219
+
220
+ **催办的效果**: 对方会收到如下的短信通知
221
+
222
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/3caf94b7f540fa5736270d38528d3a7b.png)
223
+
224
+
225
+ **注**:`合同催办是白名单功能,请联系客户经理申请开白后使用`
226
+ */
227
+ async ChannelCreateFlowReminds(req, cb) {
228
+ return this.request("ChannelCreateFlowReminds", req, cb);
229
+ }
230
+ /**
231
+ * 通过合同编号批量撤销合同,单次最多支持撤销100份合同。
232
+
233
+ 适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
234
+
235
+ - **可撤回合同状态**:未全部签署完成
236
+ - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
237
+
238
+ 批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)或通过接口[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask)主动查询。
239
+
240
+
241
+ 注:
242
+ - 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
243
+ - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
244
+ - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
245
+ - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
246
+ */
247
+ async ChannelBatchCancelFlows(req, cb) {
248
+ return this.request("ChannelBatchCancelFlows", req, cb);
249
+ }
250
+ /**
251
+ * **适用场景**:
252
+ 当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口动态补充签署人。同一签署人只允许补充一人,最终实际签署人取决于谁先领取合同完成签署。
253
+
254
+ **接口使用说明**:
255
+
256
+ 1.本接口现已支持批量补充签署人
257
+
258
+ 2.当<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中指定需要补充的FlowId时,可以对指定合同补充签署人;可以指定多个相同发起方的不同合同在完成批量补充
259
+
260
+ 3.当<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中指定需要补充的FlowId时,是对指定的合同补充多个指定的签署人
261
+
262
+ 4.如果同时指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId,仅使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId作为补充的合同
263
+
264
+ 5.如果部分指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId,又指定了<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId;那么<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>存在指定的FlowId,则使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId,不存在则使用<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId作为补充的合同
265
+
266
+
267
+ 6.如果同时未指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId,则传参错误
268
+
269
+ **限制条件**:
270
+ 1. 本企业(发起方企业)企业签署人仅支持通过企业名称+姓名+手机号进行补充。
271
+ 2. 个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
272
+ */
273
+ async ChannelCreateFlowApprovers(req, cb) {
274
+ return this.request("ChannelCreateFlowApprovers", req, cb);
275
+ }
276
+ /**
277
+ * 获取个人用户认证证书图片下载URL
278
+
279
+ 个人用户认证证书图片样式如下图
280
+
281
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/d568bc0f101bef582f7af2cb5ab7a715.png)
282
+
283
+ 注:
284
+ <ul>
285
+ <li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
286
+ <li>专为电子处方单(医疗自动签)特定场景使用。在使用前,请务必与您的客户经理联系以确认已经开通电子处方单功能 </li>
287
+ </ul>
288
+ */
289
+ async CreatePersonAuthCertificateImage(req, cb) {
290
+ return this.request("CreatePersonAuthCertificateImage", req, cb);
291
+ }
292
+ /**
293
+ * 提交申请出证报告任务并返回报告ID。
294
+
295
+ 注意:
296
+ - 使用此功能**需搭配出证套餐** ,使用前请联系对接的客户经理沟通。
297
+ - 操作人必须是**发起方或者签署方企业的(非走授权书认证)法人或者超管**。
298
+ - 合同流程必须**所有参与方已经签署完成**。
299
+ - 出证过程需一定时间,建议在**提交出证任务后的24小时之后**,通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
300
+
301
+
302
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
303
+ */
304
+ async CreateChannelFlowEvidenceReport(req, cb) {
305
+ return this.request("CreateChannelFlowEvidenceReport", req, cb);
306
+ }
307
+ /**
308
+ * 本接口(ChannelCreatePreparedPersonalEsign)用于创建导入个人印章(处方单场景专用,使用此接口请与客户经理确认)。
322
309
  */
323
- async ChannelCreateSealPolicy(req, cb) {
324
- return this.request("ChannelCreateSealPolicy", req, cb);
310
+ async ChannelCreatePreparedPersonalEsign(req, cb) {
311
+ return this.request("ChannelCreatePreparedPersonalEsign", req, cb);
325
312
  }
326
313
  /**
327
- * 该接口用于发起合同后,生成个人/企业用户的批量待办链接。
328
- **注意:**
329
- 1. 该接口可生成签署人的批量、合同组签署/查看链接 。
330
- 2. 该签署链接**有效期为30分钟**,过期后将失效,如需签署可重新创建批量签署链接 。
331
- 4. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
332
- 跳转到小程序的实现,参考微信官方文档(分为<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>。
333
- 6. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
314
+ * 接口(ChannelCreateFlowByFiles)用PDF文件创建签署流程。
315
+
316
+ 适用场景:适用非制式的合同文件签署,开发者有每个签署流程的PDF,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
317
+
318
+ **注**:
319
+ <ul>
320
+ <li>此接口静默签(企业自动签)能力为白名单功能,使用前请联系对接的客户经理沟通。</li>
321
+ <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号(FileIds)进行使用。整体的逻辑如下图</li>
322
+ </ul>
323
+
324
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
325
+
326
+ **可以作为发起方和签署方的角色列表**
327
+ <table> <thead> <tr> <th>场景编号</th> <th>发起方</th> <th>签署方</th> <th>补充</th> </tr> </thead> <tbody> <tr> <td>场景一</td> <td>子企业A的员工</td> <td>子企业A的员工</td> <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td> </tr> <tr> <td>场景二</td> <td>子企业A的员工</td> <td>子企业B(不指定经办人走领取逻辑)</td> <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td> </tr> <tr> <td>场景三</td> <td>子企业A的员工</td> <td>子企业B的员工</td> <td>-</td> </tr> <tr> <td>场景四</td> <td>子企业A的员工</td> <td>个人</td> <td>就是自然人,不是企业员工</td> </tr> <tr> <td>场景五</td> <td>子企业A的员工</td> <td>SaaS平台企业员工</td> <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td> </tr> </tbody> </table>
328
+
329
+
330
+ **注**:
331
+ `1. 发起合同时候, 作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
332
+
333
+ `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
334
+
335
+ `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(过期,拒签,签署完成,解除完成等状态不会返还额度)`
336
+
337
+ `4. 静默(自动)签署不支持合同签署方存在填写功能`
338
+
339
+ <font color="red">相关视频指引</font> <br>
340
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
341
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
334
342
  */
335
- async ChannelCreateBatchQuickSignUrl(req, cb) {
336
- return this.request("ChannelCreateBatchQuickSignUrl", req, cb);
343
+ async ChannelCreateFlowByFiles(req, cb) {
344
+ return this.request("ChannelCreateFlowByFiles", req, cb);
345
+ }
346
+ /**
347
+ * 1. 可以**通过图片**为子客企业代创建印章,图片最大5MB
348
+
349
+ 2. 可以**系统创建**子客企业代创建印章, 系统创建的印章样子下图(样式可以调整)
350
+
351
+ ![image](https://dyn.ess.tencent.cn/guide/capi/CreateSealByImage.png)
352
+ */
353
+ async CreateSealByImage(req, cb) {
354
+ return this.request("CreateSealByImage", req, cb);
355
+ }
356
+ /**
357
+ * 此接口(ChannelCreateConvertTaskApi)用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
358
+ 前提条件:源文件已经通过 <a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>完成上传,并得到了源文件的资源Id。<br />
359
+ 适用场景1:已经上传了一个word文件,希望将该word文件转换成pdf文件后发起合同
360
+ 适用场景2:已经上传了一个jpg图片文件,希望将该图片文件转换成pdf文件后发起合同<br />
361
+ 转换文件是一个耗时操作,若想查看转换任务是否完成,可以通过<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelGetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
362
+ 注:
363
+ 1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
364
+ 2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
365
+ */
366
+ async ChannelCreateConvertTaskApi(req, cb) {
367
+ return this.request("ChannelCreateConvertTaskApi", req, cb);
368
+ }
369
+ /**
370
+ * 撤销签署流程接口
371
+
372
+ 适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
373
+
374
+ - **可撤回合同状态**:未全部签署完成
375
+ - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
376
+
377
+ 注:
378
+ - 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
379
+ - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
380
+ - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
381
+ - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
382
+ */
383
+ async ChannelCancelFlow(req, cb) {
384
+ return this.request("ChannelCancelFlow", req, cb);
337
385
  }
338
386
  /**
339
387
  * 接口(CreateFlowsByTemplates)用于使用模板批量创建签署流程。当前可批量发起合同(签署流程)数量为1-20个。
@@ -405,679 +453,458 @@ class Client extends TencentCloudCommon.AbstractClient {
405
453
  return this.request("CreateFlowsByTemplates", req, cb);
406
454
  }
407
455
  /**
408
- * 通过此接口可以关闭个人用户自动签功能。
409
- 无需对应的用户刷脸等方式同意即可关闭。
456
+ * 此接口(ChannelCreateRole)用来创建企业自定义角色。
410
457
 
411
- 注意:
458
+ 适用场景1:创建当前企业的自定义角色,并且创建时不进行权限的设置(PermissionGroups 参数不传),角色中的权限内容可通过接口 ChannelModifyRole 完成更新。
412
459
 
413
- <ul><li>处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。</li>
414
- <li>如果此用户在开通时候绑定过个人自动签账号许可, 关闭此用户的自动签不会归还个人自动签账号许可的额度。</li></ul>
460
+ 适用场景2:创建当前企业的自定义角色,并且创建时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考[查询角色列表接口](https://qian.tencent.com/developers/partnerApis/accounts/ChannelDescribeRoles) 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
415
461
  */
416
- async ChannelDisableUserAutoSign(req, cb) {
417
- return this.request("ChannelDisableUserAutoSign", req, cb);
462
+ async ChannelCreateRole(req, cb) {
463
+ return this.request("ChannelCreateRole", req, cb);
418
464
  }
419
465
  /**
420
- * 该接口用于在使用视频认证方式签署合同后,获取用户的签署人脸认证视频。
421
-
422
- 1. 该接口**仅适用于在H5端签署**的合同,**在通过视频认证后**获取认证的视频内容。
423
- 2. 该接口**不支持小程序端**的签署认证的视频获取。
424
- 3. 请在**签署完成后的三天内**获取视频,**过期后将无法获取**。
425
-
426
- **注意:该接口需要开通白名单,请联系客户经理开通后使用。**
466
+ * 生成用印申请审批链接,审批人可以通过此链接进入小程序进行审批。
467
+ p.s.
468
+ Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批人打开。
427
469
  */
428
- async ChannelDescribeSignFaceVideo(req, cb) {
429
- return this.request("ChannelDescribeSignFaceVideo", req, cb);
470
+ async DescribeChannelSealPolicyWorkflowUrl(req, cb) {
471
+ return this.request("DescribeChannelSealPolicyWorkflowUrl", req, cb);
430
472
  }
431
473
  /**
432
- * 此接口查询子企业电子印章。<br />
433
-
434
- 注:
435
- 1. 此操作要求操作者具备<b>印章查询权限</b>(若调用者尚无此权限,请联系超级管理员前往Web控制台【组织管理】->【角色管理】添加相应权限)。
474
+ * 生成渠道子客编辑企业信息二维码
475
+ */
476
+ async ChannelCreateOrganizationModifyQrCode(req, cb) {
477
+ return this.request("ChannelCreateOrganizationModifyQrCode", req, cb);
478
+ }
479
+ /**
480
+ * 接口(ChannelCreateDynamicFlowApprover)用来补充<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>发起的动态合同的签署人信息
481
+ **注**:
482
+ <ul>
483
+ <li>此接口需要保证:渠道企业已开启:模块化计费能力,</li>
484
+ <li>此接口需要保证:渠道应用已开启:动态签署人2.0能力</li>
485
+ <li>此接口需要保证:合同发起时指定开启了动态合同</li>
486
+ <li>此接口补充的动态签署人传参规则,请参考接口:<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>的签署人传参规则</li>
487
+ </ul>
436
488
  */
437
- async ChannelDescribeOrganizationSeals(req, cb) {
438
- return this.request("ChannelDescribeOrganizationSeals", req, cb);
489
+ async ChannelCreateDynamicFlowApprover(req, cb) {
490
+ return this.request("ChannelCreateDynamicFlowApprover", req, cb);
439
491
  }
440
492
  /**
441
- * 此接口(SyncProxyOrganization)用于同步第三方平台子客企业信息,包括企业名称、企业营业执照、企业统一社会信用代码和法人姓名等,便于子客企业在企业激活过程中无需手动上传营业执照或补充企业信息。
493
+ * 该接口用于获取创建法人章的二维码,需要通过微信扫描。扫描后将跳转到腾讯电子签署,进入到创建法人章的流程。
442
494
 
443
- 注意:
444
-
445
- - **需要在<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>前同步的企业信息**, 否则会出现信息同步没有用的情形
446
- - **企业信息需要和营业执照信息对应**, 否则会出现激活过程验证不通过的问题
447
-
448
- ![image](https://qcloudimg.tencent-cloud.cn/raw/7ec91b79a0a4860e77c9ff9f4a5f13ad/channel_SyncProxyOrganization2.png)
449
-
450
-
451
- - **企业统一社会信用代码**: 对应上图中的**1**
452
- - **第三方平台子客企业名称**: 对应上图中的**2**
453
- - **企业法定代表人的名字**:对应上图中的**3**
454
- - **企业详细住所**:对应上图中的**4**
455
- */
456
- async SyncProxyOrganization(req, cb) {
457
- return this.request("SyncProxyOrganization", req, cb);
458
- }
459
- /**
460
- * 通过此接口,删除员工绑定的角色,支持以电子签userId、客户系统userId两种方式调用。
461
-
462
- 对应控制台的操作如下图
463
- ![image](https://qcloudimg.tencent-cloud.cn/raw/5b41194d3cb3f2058ec0ba0fb5ebc6a6.png)
464
- */
465
- async ChannelDeleteRoleUsers(req, cb) {
466
- return this.request("ChannelDeleteRoleUsers", req, cb);
467
- }
468
- /**
469
- * 通过此接口(DescribeTemplates)查询该第三方平台子客企业在电子签拥有的有效模板,不包括第三方平台模板。
470
-
471
- **适用场景**
472
- 该接口常用来配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/CreateFlowsByTemplates" target="_blank">用模板创建签署流程</a>和<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates" target="_blank">通过多模板创建合同组签署流程</a>接口,作为创建合同的前置接口使用。
473
- 通过此接口查询到模板信息后,再通过调用创建合同的接口,指定模板ID,指定模板中需要的填写控件内容等,完成合同文档的创建。
474
-
475
- **模板的来源**
476
- 子客企业的模板有两种途径获取
477
- - 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
478
- - 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
479
-
480
- **一个模板通常会包含以下结构信息**
481
-
482
- - 模板ID, 模板名字等基本信息
483
- - 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
484
- - 发起方和签署方的填写控件 Components
485
- - 签署方的签署控件 SignComponents
486
-
487
- ![image](https://qcloudimg.tencent-cloud.cn/raw/ab81fa948a0a6fea14f48cac91d0e36a/channel_DescribeTemplates.png)
488
-
489
- 模板中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
490
-
491
- ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
492
-
493
-
494
- **注意**
495
-
496
- >1. 查询条件TemplateId、TemplateName与ChannelTemplateId可同时存在,即可查询同时满足这些条件的模板。
497
- >2. TemplateId 和TemplateIds互为独立,若两个参数都传入,则以TemplateId为准
498
-
499
- <font color="red">相关视频指引</font> <br>
500
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
501
- */
502
- async DescribeTemplates(req, cb) {
503
- return this.request("DescribeTemplates", req, cb);
504
- }
505
- /**
506
- * 该接口用于批量创建企业认证链接, 可以支持PC浏览器,H5和小程序三种途径。
507
- 此接口为异步提交任务接口,需要与[查询子企业批量认证链接](https://qcloudimg.tencent-cloud.cn/raw/1d3737991b2a3be78002bd78a47d6917.png)配合使用,整体流程如下图。
508
- ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
509
-
510
-
511
-
512
- **注意**
513
-
514
- 1. 单次最多创建10个子企业。
515
- 2. 一天内,同一家企业最多创建8000个子企业。
516
- 3. 同一批创建的子客户不能重复,包括企业名称、企业统一信用代码和子客户经办人openId。
517
- 4. 跳转到小程序的实现,请参考微信官方文档(分为<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>。
518
-
519
-
520
-
521
- **腾讯电子签小程序的AppID 和 原始Id如下:**
522
-
523
- | 小程序 | AppID | 原始ID |
524
- | ------------ | ------------ | ------------ |
525
- | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
526
- | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
527
- */
528
- async CreateBatchOrganizationRegistrationTasks(req, cb) {
529
- return this.request("CreateBatchOrganizationRegistrationTasks", req, cb);
530
- }
531
- /**
532
- * 激活或续期子客企业, 在激活状态下,企业可以正常发起合同;在非激活状态下,企业仅能查看和签署合同。
533
-
534
- **1. 激活**:使用一个许可证将子客企业从未激活状态转变为激活状态。**激活状态的有效期为一年,一年后将自动回到未激活状态**。
535
-
536
- **2. 续期**:使用一个许可证将已激活的子客企业的有效期延长一年。只有处于激活状态的子企业才能进行续期操作(**若处于非激活状态,则需先激活**)。您可以使用多个许可证对同一子客企业进行多次续费。
537
-
538
-
539
- 该接口的效果同:**【企业应用管理】 -> 【子客企业管理】 -> 【激活】或者【续期】**
540
-
541
- ![image](https://qcloudimg.tencent-cloud.cn/raw/cd63761ca6e814c64b4ecf131555b74e.png)
542
-
543
-
544
- 如果不想调用此接口或者页面点击进行激活或续期,可以在【应用扩展服务】中打开自动激活或续期,在许可证充足的情况下会自动激活或续期子客企业
545
-
546
- ![image](https://qcloudimg.tencent-cloud.cn/raw/2ccb37ef6bde463c15c39fdda789216f.png)
547
- */
548
- async CreateChannelSubOrganizationActive(req, cb) {
549
- return this.request("CreateChannelSubOrganizationActive", req, cb);
550
- }
551
- /**
552
- * 此接口(UploadFiles)文件上传。<br/>
553
-
554
- 适用场景:用于合同,印章的文件上传。文件上传以后,
555
- 如果是PDF格式文件可配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>接口进行合同流程的发起
556
- 如果是其他类型可以配合<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务</a>接口转换成PDF文件
557
-
558
- 注:
559
- 1. 图片类型(png/jpg/jpeg)限制大小为5M以下, PDF/word/excel等其他格式限制大小为60M以下
560
- 2. <font color='red'>此接口调用时需要单独设置Domain请求域名 </font>, 联调开发环境为 <font color='red'>file.test.ess.tencent.cn</font>,正式环境需要设置为<font color='red'>file.ess.tencent.cn</font>,代码示例
561
- ```
562
- HttpProfile httpProfile = new HttpProfile();
563
- httpProfile.setEndpoint("file.test.ess.tencent.cn");
564
- ```
565
-
566
- <font color="red">相关视频指引</font> <br>
567
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
568
- */
569
- async UploadFiles(req, cb) {
570
- return this.request("UploadFiles", req, cb);
571
- }
572
- /**
573
- * 该接口用于获取个人授权执业章给企业的二维码,需要个人用户通过微信扫码。
574
-
575
- 扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
576
-
577
- 个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
578
-
579
- **注意**
580
- 1. 该二维码**有效期为7天**,过期后将失效,可重新创建。
581
-
582
-
583
- 整体流程入下图
584
-
585
- ![image](https://qcloudimg.tencent-cloud.cn/raw/21b6b56dbc796c9d6f402d6ce6febb07.png)
586
- */
587
- async CreateEmployeeQualificationSealQrCode(req, cb) {
588
- return this.request("CreateEmployeeQualificationSealQrCode", req, cb);
589
- }
590
- /**
591
- * 此接口(CreateConsoleLoginUrl)用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。
592
-
593
- Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态,进入不同的流程,主要情况分类如下:
594
- <table>
595
- <thead>
596
- <tr>
597
- <th>子客企业状态</th>
598
- <th>子客企业员工状态</th>
599
- <th>点击链接进入的流程</th>
600
- </tr>
601
- </thead>
602
- <tbody>
603
- <tr>
604
- <td>企业未激活</td>
605
- <td>员工未认证</td>
606
- <td>进入企业激活流程,首次完成企业激活流程的员工会成为超管</td>
607
- </tr>
608
- <tr>
609
- <td>企业已激活</td>
610
- <td>员工未认证</td>
611
- <td>进入员工认证并加入企业流程</td>
612
- </tr>
613
- <tr>
614
- <td>企业已激活</td>
615
- <td>员工已认证</td>
616
- <td>进入子客企业Web控制台</td>
617
- </tr>
618
- </tbody>
619
- </table>
620
- 如果是企业激活流程,需要注意如下情况:
621
-
622
- 1. 若在激活过程中,**更换用户OpenID重新生成链接,之前的认证会被清理**。因此不要在企业认证过程生成多个链接给多人同时操作,会导致认证过程互相影响。
623
- 2. 若您认证中发现信息有误需要重新认证,**可通过更换用户OpenID重新生成链接的方式,来清理掉已有的流程**。
624
-
625
- 系统的渠道企业, 应用, 子客企业, 子客员工的组织形式
626
- ![image](https://qcloudimg.tencent-cloud.cn/raw/77677faeea26c9d7f37474597c81fe01.png)
495
+ **注意**
496
+ 1. 该二维码**有效期为7天**,过期后将失效,可重新创建 。
497
+ 2. 每个公司**只能有1个法人章**,无法重复创建或者创建多个
627
498
 
499
+ 法人章的样式可以参考下图索引(也可以自己上传法人印章图片):
628
500
 
629
- <font color="red">相关视频指引</font> <br>
630
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-createconsoleloginin.mp4" target="_blank">【生成子客登录链接】代码编写 & 子企业认证示例</a><br>
501
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/36a0a090750c45bb5cac5047ac461b2c.png)
631
502
  */
632
- async CreateConsoleLoginUrl(req, cb) {
633
- return this.request("CreateConsoleLoginUrl", req, cb);
634
- }
635
- /**
636
- * 生成渠道子客编辑企业信息二维码
637
- */
638
- async ChannelCreateOrganizationModifyQrCode(req, cb) {
639
- return this.request("ChannelCreateOrganizationModifyQrCode", req, cb);
503
+ async CreateLegalSealQrCode(req, cb) {
504
+ return this.request("CreateLegalSealQrCode", req, cb);
640
505
  }
641
506
  /**
642
- * 通过此接口指定合同、签署人、填写控件等信息,生成嵌入式链接,此链接可以嵌入到其他网页或者直接打开,打开后进入发起页面。在此页面上,合同信息和签署人信息均不可更改。
643
-
644
- 注意:
645
- 1. <font color="red">仅支持在PC浏览器</font>上进行操作和使用。
646
- 2. 在使用<font color="red">模板发起合同时,需指定RecipientId</font>以明确参与方在模板中所扮演的角色。
647
-
648
- **嵌入式签署人-各种场景传参说明**:
649
-
650
- <table>
651
- <thead>
652
- <tr>
653
- <th>场景编号</th>
654
- <th>可作为签署方的类型</th>
655
- <th>签署方传参说明</th>
656
- </tr>
657
- </thead>
658
-
659
- <tbody>
660
- <tr>
661
- <td>场景一</td>
662
- <td>第三方子企业员工</td>
663
- <td>OpenId、OrganizationName、OrganizationOpenId必传 ,ApproverType设置为0</td>
664
- </tr>
665
- <tr>
666
- <td>场景二</td>
667
- <td>SaaS平台企业员工</td>
668
- <td>Name、Mobile、OrganizationName必传,NotChannelOrganization=True。 ApproverType设置为0</td>
669
- </tr>
670
- <tr>
671
- <td>场景三</td>
672
- <td>个人/自然人</td>
673
- <td>Name、Mobile必传, ApproverType设置为1</td>
674
- </tr>
675
- </tbody>
676
- </table>
507
+ * 对合同流程文件进行数字签名验证,判断数字签名是否有效,合同文件内容是否被篡改。
677
508
 
678
- 嵌入的页面样式如下:
679
- ![image](https://qcloudimg.tencent-cloud.cn/raw/b2ae013fb4d747891dd3815bbe897208.png)
509
+ **补充**: 可以到控制台[合同验签](https://qian.tencent.com/verifySign)体验验签功能,界面如下
510
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/81c333ccb07f0c5fbaf840d9cee61333.png)
680
511
  */
681
- async ChannelCreatePrepareFlow(req, cb) {
682
- return this.request("ChannelCreatePrepareFlow", req, cb);
512
+ async ChannelVerifyPdf(req, cb) {
513
+ return this.request("ChannelVerifyPdf", req, cb);
683
514
  }
684
515
  /**
685
- * 通过合同编号生成批量撤销合同的链接,单次最多支持撤销100份合同, 返回的链接需要有此权限的人<font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>在<font color='red'>**手机端**</font>打开, 跳转到腾讯电子签小程序输入撤销原因来进行撤销合同
686
-
687
- 适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
688
-
689
- - **可撤回合同状态**:未全部签署完成
690
- - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
691
-
692
- 批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)或通过接口[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask)主动查询。
516
+ * 此接口(GetDownloadFlowUrl)用户获取合同控制台下载页面链接, 点击链接后会跳转至本企业合同管理控制台(会筛选出传入的合同列表), 点击**下载**按钮后就会下载传入的合同列表, 下载页面如下图
517
+ ![image](https://dyn.ess.tencent.cn/guide/capi/channel_GetDownloadFlowUrl.png)
693
518
 
694
519
  注:
695
- - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
696
- - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
697
- - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
698
- */
699
- async ChannelCreateBatchCancelFlowUrl(req, cb) {
700
- return this.request("ChannelCreateBatchCancelFlowUrl", req, cb);
701
- }
702
- /**
703
- * 此接口(ChannelDeleteRole)用来删除企业自定义角色。
704
-
705
- 注:**系统角色不可删除。**
706
- */
707
- async ChannelDeleteRole(req, cb) {
708
- return this.request("ChannelDeleteRole", req, cb);
709
- }
710
- /**
711
- * 此接口(ChannelGetTaskResultApi)用来查询转换任务的状态。如需发起转换任务,请使用<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行资源文件的转换操作<br />
712
- 前提条件:已调用 <a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换,并得到了返回的转换任务Id。<br />
713
-
714
- 适用场景:已创建一个文件转换任务,想查询该文件转换任务的状态,或获取转换后的文件资源ID。<br />
715
- 注:
716
- 1. `大文件转换所需的时间可能会比较长。`
717
- 2. `本接口返回的文件资源ID就是PDF资源ID,可以直接用于【用PDF文件创建签署流程】接口发起合同。`
718
- */
719
- async ChannelGetTaskResultApi(req, cb) {
720
- return this.request("ChannelGetTaskResultApi", req, cb);
721
- }
722
- /**
723
- * 接口(ChannelCreateDynamicFlowApprover)用来补充<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>发起的动态合同的签署人信息
724
- **注**:
725
520
  <ul>
726
- <li>此接口需要保证:渠道企业已开启:模块化计费能力,</li>
727
- <li>此接口需要保证:渠道应用已开启:动态签署人2.0能力</li>
728
- <li>此接口需要保证:合同发起时指定开启了动态合同</li>
729
- <li>此接口补充的动态签署人传参规则,请参考接口:<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>的签署人传参规则</li>
521
+ <li>仅支持下载 <b>本企业</b> 下合同,链接会 <b>登录企业控制台</b> </li>
522
+ <li> <b>链接仅可使用一次</b>,不可重复使用</li>
730
523
  </ul>
731
524
  */
732
- async ChannelCreateDynamicFlowApprover(req, cb) {
733
- return this.request("ChannelCreateDynamicFlowApprover", req, cb);
734
- }
735
- /**
736
- * 此接口(ChannelUpdateSealStatus)用于第三方应用平台为子客企业更新印章状态。
737
- */
738
- async ChannelUpdateSealStatus(req, cb) {
739
- return this.request("ChannelUpdateSealStatus", req, cb);
525
+ async GetDownloadFlowUrl(req, cb) {
526
+ return this.request("GetDownloadFlowUrl", req, cb);
740
527
  }
741
528
  /**
742
- * 通过此接口,创建小程序批量签署链接,个人/企业员工点击此链接即可跳转小程序进行批量签署。
743
- 请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。
529
+ * 此接口查询子企业电子印章。<br />
744
530
 
745
531
  注:
746
- - 使用此接口生成链接,需要提前开通 `个人签署方仅校验手机号` 功能,在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
747
- - 个人参与方点击链接后需短信验证码才能查看合同内容。
748
- - 个人用户批量签署,需要传Name,Mobile,IdCardNumber(IdCardType) 参数。
749
- - saas企业员工用户批量签署,在传递了姓名等基本信息参数的情况下,还需要传OrganizationName(参与方所在企业名称)参数生成签署链接,<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。
750
- - 子客企业员工用户批量签署,需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证,且OpenId对应员工此子客下已经实名</font>。Name,Mobile, IdCard等信息此时可以不传,系统会查询此OpenId实名信息自动补充。
751
- - 生成批量签署链接时,合同目标参与方状态需为<font color="red">待签署</font>状态。
752
- - 个人批量签署进行的合同的签名区, 全部变成<font color="red">手写签名</font>(不管合同里边设置的签名限制)来进行。
753
- - 不支持签署方含有签批控件,或设置了签署方在签署时自行添加签署控件功能的合同进行批量签署。
532
+ 1. 此操作要求操作者具备<b>印章查询权限</b>(若调用者尚无此权限,请联系超级管理员前往Web控制台【组织管理】->【角色管理】添加相应权限)。
754
533
  */
755
- async ChannelCreateBatchSignUrl(req, cb) {
756
- return this.request("ChannelCreateBatchSignUrl", req, cb);
534
+ async ChannelDescribeOrganizationSeals(req, cb) {
535
+ return this.request("ChannelDescribeOrganizationSeals", req, cb);
757
536
  }
758
537
  /**
759
- * 此接口(ChannelCreateBoundFlows)用于子客企业领取未归属给员工的合同,将合同领取给当前员工,合同不能重复领取。
760
-
538
+ * 查询企业扩展服务的授权详情(列表),当前支持查询以下内容:
761
539
 
762
- **未归属合同发起方式**
763
- 指定对应企业的OrganizationOpenId和OrganizationName而不指定具体的参与人(OpenId/名字/手机号等), 则合同进入待领取状态, 示例代码如下
764
- ```
765
- FlowApprovers: []*essbasic.FlowApproverInfo{
766
- {
767
- ApproverType: common.StringPtr("ORGANIZATION"),
768
- OrganizationOpenId: common.StringPtr("org_dianziqian"),
769
- OrganizationName: common.StringPtr("典子谦示例企业"),
770
- }
771
- },
772
- ```
540
+ 1. **企业自动签**
541
+ 2. **批量签署**
773
542
 
774
- 可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
775
- ![image](https://qcloudimg.tencent-cloud.cn/raw/a34d0cc56ec871613e94dfc6252bc072.png)
776
543
 
777
- 注:
778
- 1. 支持批量领取, 如果有一个合同流程无法领取会导致接口报错, 使得所有合同都领取失败
779
- 2. 只有企业的<font color="red">超管或者法人</font>才能进行合同的领取
544
+ 注: <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
780
545
  */
781
- async ChannelCreateBoundFlows(req, cb) {
782
- return this.request("ChannelCreateBoundFlows", req, cb);
546
+ async DescribeExtendedServiceAuthDetail(req, cb) {
547
+ return this.request("DescribeExtendedServiceAuthDetail", req, cb);
783
548
  }
784
549
  /**
785
- * 获取设置自动签印章小程序链接。
550
+ * 创建企业注销链接
786
551
 
787
- 注意:
788
- <ul><li>需要<code>企业开通自动签</code>后使用。</li>
789
- <li>仅支持<code>已经开通了自动签的个人</code>更换自动签印章。</li>
790
- <li>链接有效期默认7天,<code>最多30天</code>。</li>
791
- <li>该接口的链接适用于<code>小程序</code>端。</li>
792
- <li>该接口不会扣除您的合同套餐,暂不参与计费。</li></ul>
552
+ 系统将返回操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成企业的注销操作。
553
+
554
+ 注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人。`
793
555
  */
794
- async ChannelCreateUserAutoSignSealUrl(req, cb) {
795
- return this.request("ChannelCreateUserAutoSignSealUrl", req, cb);
556
+ async CreateCloseOrganizationUrl(req, cb) {
557
+ return this.request("CreateCloseOrganizationUrl", req, cb);
796
558
  }
797
559
  /**
798
- * 通过此接口获取个人用户自动签的开通状态。
799
-
800
- 注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
560
+ * 该接口 (PrepareFlows) 用于创建待发起文件
561
+ 用户通过该接口进入签署流程发起的确认页面,进行发起信息二次确认, 如果确认则进行正常发起。
562
+ 目前该接口只支持B2C,<font color='red'> **不建议使用,将会废弃**</font>。
801
563
  */
802
- async ChannelDescribeUserAutoSignStatus(req, cb) {
803
- return this.request("ChannelDescribeUserAutoSignStatus", req, cb);
564
+ async PrepareFlows(req, cb) {
565
+ return this.request("PrepareFlows", req, cb);
804
566
  }
805
567
  /**
806
- * 该接口用于获取创建法人章的二维码,需要通过微信扫描。扫描后将跳转到腾讯电子签署,进入到创建法人章的流程。
568
+ * 分页查询企业角色列表,法人的角色是系统保留角色,不会返回,按照角色创建时间升序排列。
807
569
 
808
- **注意**
809
- 1. 该二维码**有效期为7天**,过期后将失效,可重新创建 。
810
- 2. 每个公司**只能有1个法人章**,无法重复创建或者创建多个
811
570
 
812
- 法人章的样式可以参考下图索引(也可以自己上传法人印章图片):
571
+ <font color="red">系统默认角色</font>说明可参考下表
813
572
 
814
- ![image](https://qcloudimg.tencent-cloud.cn/raw/36a0a090750c45bb5cac5047ac461b2c.png)
573
+ | 角色名称| 建议授予对象 | 角色描述 |
574
+ | --- | --- | --- |
575
+ | **超级管理员** |电子签业务最高权限,可以授权给法务/企业法人/业务负责人等 | 所有功能和数据管理权限,只能设置一位超管。 |
576
+ | **业务管理员**|IT 系统负责人,可以授权给CTO等 | 企业合同模块、印章模块、模板模块等全量功能及数据权限。 |
577
+ | **经办人**|企业法务负责人等 | 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看企业所有合同数据。 |
578
+ | **业务员**|销售员、采购员 等| 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看自己相关所有合同数据。 |
579
+
580
+ 附件:<a href="https://dyn.ess.tencent.cn/guide/apivideo/roles.xlsx" target="_blank">点击下载角色对应的权限点的excel文档</a>
815
581
  */
816
- async CreateLegalSealQrCode(req, cb) {
817
- return this.request("CreateLegalSealQrCode", req, cb);
582
+ async ChannelDescribeRoles(req, cb) {
583
+ return this.request("ChannelDescribeRoles", req, cb);
818
584
  }
819
585
  /**
820
- * 对合同流程文件进行数字签名验证,判断数字签名是否有效,合同文件内容是否被篡改。
586
+ * 获取合同流程PDF的下载链接,可以下载签署中、签署完的此子企业创建的合同。
821
587
 
822
- **补充**: 可以到控制台[合同验签](https://qian.tencent.com/verifySign)体验验签功能,界面如下
823
- ![image](https://qcloudimg.tencent-cloud.cn/raw/81c333ccb07f0c5fbaf840d9cee61333.png)
588
+
589
+
590
+
591
+ ### 2. 确保合同的PDF已经合成后,再调用本接口。
592
+ 用户创建合同或者提交签署动作后,后台需要1~3秒的时间就进行合同PDF合成或者签名,为了确保您下载的是签署完成的完整合同文件,我们建议采取下面两种方式的一种来<font color="red"><b>确保PDF已经合成完成,然后在调用本接口</b></font>。
593
+
594
+ **第一种**:请确保您的系统配置了[接收合同完成通知的回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign)功能。一旦所有参与方签署完毕,我们的系统将自动向您提供的回调地址发送完成通知。
595
+
596
+ **第二种**:通过调用我们的[获取合同信息](https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo)接口来主动检查合同的签署状态。请仅在确认合同状态为“全部签署完成”后,进行文件的下载操作。
597
+
598
+ ### 3. 链接具有有效期限
599
+ <font color="red"><b>生成的链接是有时间限制的,过期后将无法访问</b></font>。您可以在接口返回的信息中查看具体的过期时间。为避免错误,请确保在链接过期之前进行下载操作。
600
+
601
+ ### 4. 有两种开通下载权限的途径。
602
+
603
+ **第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图。
604
+ 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
605
+
606
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
607
+
608
+ **第二种**: 渠道方企业在**企业应用管理**的配置界面打开需要配置的应用,点击**应用扩展服务**开通此功能,需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
609
+ 注:
610
+ 1. `请注意如果第三方应用的子客主动关闭了渠道端下载渠道子客合同功能开关,那么渠道方开通了此功能也无法下载子客的合同文件`
611
+
612
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
824
613
  */
825
- async ChannelVerifyPdf(req, cb) {
826
- return this.request("ChannelVerifyPdf", req, cb);
614
+ async DescribeResourceUrlsByFlows(req, cb) {
615
+ return this.request("DescribeResourceUrlsByFlows", req, cb);
827
616
  }
828
617
  /**
829
- * 用来创建嵌入式页面个性化主题配置(例如是否展示电子签logo、定义主题色等),该接口配合其他所有可嵌入页面接口使用
830
- 创建配置对当前第三方应用全局生效,如果多次调用,会以最后一次的配置为准
618
+ * 查询渠道子客企业信息时,可以支持单个子客和整个应用下所有子客的查询。返回的信息包括超管、法人的信息以及当前企业的认证状态等信息。
619
+
620
+ - 对于单个企业的查询,通过**指定子客的唯一标识**来查询该子客的企业信息
621
+ - 对于整个应用下所有企业的查询,**不需要指定子客的唯一标识**,直接查询整个应用下所有子客企业的企业信息
831
622
  */
832
- async ChannelCreateWebThemeConfig(req, cb) {
833
- return this.request("ChannelCreateWebThemeConfig", req, cb);
623
+ async DescribeChannelOrganizations(req, cb) {
624
+ return this.request("DescribeChannelOrganizations", req, cb);
834
625
  }
835
626
  /**
836
- * 该接口用于发起合同后,生成用户的签署链接 <br/>
627
+ * 支持企业进行批量初始化操作:
837
628
 
838
- **注意**
839
- 1. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接 。
840
- 2. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。配置方式请参考:<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
841
- 如需跳转到小程序的实现,参考微信官方文档(分为<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>。
842
- 3. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
629
+ 此接口存在以下限制:
630
+ 1. 批量操作的企业需要已经完成电子签的认证流程。
631
+ 2. 通过此接口生成的链接在小程序端进行操作时,操作人需要是<font color="red">所有企业的超管或法人</font>。
632
+ 3. 批量操作的企业,需要是本方第三方应用下的企业。
633
+ 4. <font color="red">操作链接过期时间默认为生成链接后7天。</font>
843
634
  */
844
- async ChannelCreateFlowSignUrl(req, cb) {
845
- return this.request("ChannelCreateFlowSignUrl", req, cb);
635
+ async CreateBatchInitOrganizationUrl(req, cb) {
636
+ return this.request("CreateBatchInitOrganizationUrl", req, cb);
846
637
  }
847
638
  /**
848
- * 发起解除协议的主要应用场景为:基于一份已经签署的合同(签署流程),进行解除操作。
849
- 解除协议的模板是官方提供,经过提供法务审核,暂不支持自定义。具体用法可以参考文档[合同解除](https://qian.tencent.com/developers/partner/flow_release)。
850
-
851
- 注意:
852
- <ul><li><code>原合同必须签署完</code>成后才能发起解除协议。</li>
853
- <li>只有原合同企业类型的参与人才能发起解除协议,<code>个人参与方不能发起解除协议</code>。</li>
854
- <li>原合同个人类型参与人必须是解除协议的参与人,<code>不能更换其他第三方个人</code>参与解除协议。</li>
855
- <li>如果原合同企业参与人无法参与解除协议,可以指定同企业具有同等权限的<code>企业员工代为处理</code>。</li>
856
- <li>发起解除协议同发起其他企业合同一样,也会参与合同<code>扣费</code>,扣费标准同其他类型合同。</li>
857
- <li>在解除协议签署完毕后,原合同及解除协议均变为已解除状态。</li>
858
- <li>非原合同企业参与人发起解除协议时,需要有<code>解除合同的权限</code>。</li>
639
+ * 通过此接口(ChannelDescribeAccountBillDetail)查询该第三方平台子客账号计费详情。
640
+ <ul>
641
+ <li>对于渠道客户企业的查询,通过指定渠道企业的唯一标识(Agent.ProxyOrganizationId)来查询子客账号消耗详情</li>
859
642
  </ul>
860
643
  */
861
- async ChannelCreateReleaseFlow(req, cb) {
862
- return this.request("ChannelCreateReleaseFlow", req, cb);
644
+ async ChannelDescribeAccountBillDetail(req, cb) {
645
+ return this.request("ChannelDescribeAccountBillDetail", req, cb);
863
646
  }
864
647
  /**
865
- * 获取企业员工信息, 可以获取员工的名字,OpenId,UserId和简述的角色等信息,支持设置过滤条件以筛选员工查询结果。
648
+ * 您可以通过合同流程ID查询相关的<font color="red"><b>填写控件</b></font>信息及其内容。这包括控件的归属方、控件的填写状态(是否已填写)以及具体的填写内容。
866
649
 
867
- **注**:通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/SyncProxyOrganizationOperators" target="_blank">企业员工新增或离职</a>接口增加的新员工或者离职的员工也会在列表中。
650
+ 无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件,均包含在查询结果中。
651
+
652
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/08f6ea50d3ae88b51c280c2b17c2a126.png)
653
+ ### 2. 哪些控件会出现在结果里边?
654
+ **A.不返回的控件类型:**
655
+ - 动态表格
656
+ - 附件控件
657
+ - 水印控件
658
+
659
+ **B.返回的控件类型:**
660
+ - 单行文本
661
+ - 多行文本
662
+ - 勾选框控件
663
+ - 数字控件
664
+ - 日期控件
665
+ - 图片控件(图片下载地址)
666
+ - 邮箱控件
667
+ - 地址控件
668
+ - 学历控件
669
+ - 性别控件
670
+ - 省市区控件
671
+
672
+ ### 3.怎么授权?
673
+
674
+ 此接口需要授权, 有两种开通权限的途径
675
+
676
+ **第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图
677
+ 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
678
+
679
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
680
+
681
+ **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
682
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
868
683
  */
869
- async ChannelDescribeEmployees(req, cb) {
870
- return this.request("ChannelDescribeEmployees", req, cb);
684
+ async ChannelDescribeFlowComponents(req, cb) {
685
+ return this.request("ChannelDescribeFlowComponents", req, cb);
871
686
  }
872
687
  /**
873
- * 创建企业注销链接
688
+ * 此接口(ChannelDeleteSealPolicies)用于删除已指定员工印章授权信息,删除员工的印章授权后,该员工使用印章进行盖章时,将需要提交印章授权申请且通过审核后才能使用该印章进行签署。
689
+ */
690
+ async ChannelDeleteSealPolicies(req, cb) {
691
+ return this.request("ChannelDeleteSealPolicies", req, cb);
692
+ }
693
+ /**
694
+ * 此接口(ChannelCreateMultiFlowSignQRCode)用于创建一码多签签署码。
874
695
 
875
- 系统将返回操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成企业的注销操作。
696
+ **适用场景**:
697
+ 签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
876
698
 
877
- 注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人。`
699
+ **注意**:
700
+ 1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**, 若是B2C模板,还要满足以下任意一个条件
701
+ - 模板中配置的签署顺序是无序
702
+ - B端企业的签署方式是静默签署
703
+ - B端企业是非首位签署
704
+ 2. 通过扫描一码多签签署码发起的合同,合同涉及到的回调消息可参考文档[合同发起及签署相关回调
705
+ ]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
706
+ 3. 用户通过扫描一码多签签署码发起合同时,因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
707
+
708
+ 签署码的样式如下图:
709
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/27317cf5aacb094fb1dc6f94179a5148.png )
878
710
  */
879
- async CreateCloseOrganizationUrl(req, cb) {
880
- return this.request("CreateCloseOrganizationUrl", req, cb);
711
+ async ChannelCreateMultiFlowSignQRCode(req, cb) {
712
+ return this.request("ChannelCreateMultiFlowSignQRCode", req, cb);
881
713
  }
882
714
  /**
883
- * 通过合同编号批量撤销合同,单次最多支持撤销100份合同。
715
+ * 管理企业扩展服务
884
716
 
885
- 适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
717
+ - **直接开通的情形:** 若在操作过程中接口没有返回跳转链接,这表明无需进行任何跳转操作。此时,相应的企业拓展服务将会直接被开通或关闭。
886
718
 
887
- - **可撤回合同状态**:未全部签署完成
888
- - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
719
+ - **需要法人或者超管签署开通协议的情形:** 当需要开通以下企业拓展服务时, 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成服务的开通操作。
720
+ - **AUTO_SIGN(企业自动签)**
721
+ - **DOWNLOAD_FLOW(授权渠道下载合同)**
889
722
 
890
- 批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)或通过接口[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask)主动查询。
723
+ 注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人`
891
724
 
892
725
 
893
- 注:
894
- - 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
895
- - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
896
- - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
897
- - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
726
+ 对应的扩展服务能力可以在控制台的【扩展服务】中找到
727
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/99eebd37883ec55ed1f1df3a57aee60a.png)
898
728
  */
899
- async ChannelBatchCancelFlows(req, cb) {
900
- return this.request("ChannelBatchCancelFlows", req, cb);
729
+ async ModifyExtendedService(req, cb) {
730
+ return this.request("ModifyExtendedService", req, cb);
901
731
  }
902
732
  /**
903
- * 该接口用于结束动态签署方2.0的合同流程。
733
+ * 获取区块链存证证书查看链接/二维码接口
904
734
 
735
+ 适用场景:企业员工可以通过此接口生成合同区块链存证证书的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
905
736
 
906
- **功能开通**
907
- - 动态签署方2.0功能的使用需要先<font color="red">联系产品经理开通模块化计费功能</font>,然后到控制台中打开此功能。详细的使用说明请参考<a href="https://qian.tencent.com/developers/company/dynamic_signer_v2" target="_blank">动态签署方2.0</a>文档。
737
+ [点击查看区块链存证证书样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
908
738
 
909
- **使用条件**
910
- - 此接口只能在<font color="red">合同处于非终态且<b>所有的签署方都已经完成签署</b></font>。一旦合同进入终态(例如:过期、拒签、撤销或者调用过此接口成功过),将无法通过此接口结束合同流程。
739
+ 注:
740
+ <ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
741
+ <li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成证书查看二维码/短链。</li>
742
+ <li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
743
+ <li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证证书,请妥善保管好二维码或链接。</li></ul>
911
744
  */
912
- async ArchiveDynamicFlow(req, cb) {
913
- return this.request("ArchiveDynamicFlow", req, cb);
745
+ async CreateFlowBlockchainEvidenceUrl(req, cb) {
746
+ return this.request("CreateFlowBlockchainEvidenceUrl", req, cb);
914
747
  }
915
748
  /**
916
- * 该接口 (PrepareFlows) 用于创建待发起文件
917
- 用户通过该接口进入签署流程发起的确认页面,进行发起信息二次确认, 如果确认则进行正常发起。
918
- 目前该接口只支持B2C,<font color='red'> **不建议使用,将会废弃**</font>。
749
+ * 此接口用于获取企业批量认证链接-单链接包含多条认证流。
750
+
751
+ 前提条件:已调用 [CreateBatchOrganizationRegistrationTasks创建子企业批量认证链接任务接口](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接DescribeBatchOrganizationRegistrationUrls](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 确保认证任务已经完成。
752
+
753
+ 异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间。
754
+ 此链接包含多条认证流程,使用该链接可以批量的对企业进行认证。
919
755
  */
920
- async PrepareFlows(req, cb) {
921
- return this.request("PrepareFlows", req, cb);
756
+ async CreateBatchOrganizationAuthorizationUrl(req, cb) {
757
+ return this.request("CreateBatchOrganizationAuthorizationUrl", req, cb);
922
758
  }
923
759
  /**
924
- * 创建跳转小程序查看或签署的链接
925
-
926
- **腾讯电子签小程序的AppID 原始Id如下:**
927
-
928
- | 小程序 | AppID | 原始ID |
929
- | ------------ | ------------ | ------------ |
930
- | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
931
- | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
932
-
933
- **主要使用场景EndPoint分类**
934
-
935
- |EndPoint| 场景| 说明和示例|
936
- | ---- | ---- | --- |
937
- | WEIXINAPP | 短链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序(与腾讯电子签官方短信提醒用户签署形式一样)<br> 示例: https://essurl.cn/x9nvWU8fTg|
938
- | LONGURL2WEIXINAPP | 长链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
939
- | CHANNEL | 带有H5引导页的跳转腾讯电子签小程序签署场景 | 点击链接打开一个H5引导页面, 页面中有个"前往小程序"的按钮, 点击后会跳转到腾讯电子签小程序签署场景; 签署完成会回到H5引导页面, 然后跳转到指定创建链接指定的JumpUrl<br>示例: https://res.ess.tencent.cn/cdn/h5-activity-beta/jump-mp.html?use=channel-guide&type=warning&token=uIFKIU8fTd |
940
- |APP| <font color="red">贵方APP</font>跳转腾讯电子签小程序签署场景| 贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方App的场景<br>跳转到腾讯电子签小程序的实现可以参考微信的官方文档:<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html" target="_blank">开放能力/打开 App</a> <br> 示例: pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
941
- |APP| <font color="red">贵方小程序</font>跳转腾讯电子签小程序签署场景| 贵方小程序直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方小程序的场景<br>跳转到腾讯电子签小程序的实现可以参考微信官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" target="_blank">全屏方式</a>和<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html " target="_blank">半屏方式</a><br>此时返回的SignUrl就是官方文档中的path<br> 示例:pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
760
+ * 该接口用于发起合同后,生成个人/企业用户的批量待办链接。
761
+ **注意:**
762
+ 1. 该接口可生成签署人的批量、合同组签署/查看链接
763
+ 2. 该签署链接**有效期为30分钟**,过期后将失效,如需签署可重新创建批量签署链接 。
764
+ 4. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
765
+ 跳转到小程序的实现,参考微信官方文档(分为<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>。
766
+ 6. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
942
767
  */
943
- async CreateSignUrls(req, cb) {
944
- return this.request("CreateSignUrls", req, cb);
768
+ async ChannelCreateBatchQuickSignUrl(req, cb) {
769
+ return this.request("ChannelCreateBatchQuickSignUrl", req, cb);
945
770
  }
946
771
  /**
947
- * 此接口(GetDownloadFlowUrl)用户获取合同控制台下载页面链接, 点击链接后会跳转至本企业合同管理控制台(会筛选出传入的合同列表), 点击**下载**按钮后就会下载传入的合同列表, 下载页面如下图
948
- ![image](https://dyn.ess.tencent.cn/guide/capi/channel_GetDownloadFlowUrl.png)
772
+ * 通过此接口可以关闭个人用户自动签功能。
773
+ 无需对应的用户刷脸等方式同意即可关闭。
949
774
 
950
- 注:
951
- <ul>
952
- <li>仅支持下载 <b>本企业</b> 下合同,链接会 <b>登录企业控制台</b> </li>
953
- <li> <b>链接仅可使用一次</b>,不可重复使用</li>
954
- </ul>
775
+ 注意:
776
+
777
+ <ul><li>处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。</li>
778
+ <li>如果此用户在开通时候绑定过个人自动签账号许可, 关闭此用户的自动签不会归还个人自动签账号许可的额度。</li></ul>
955
779
  */
956
- async GetDownloadFlowUrl(req, cb) {
957
- return this.request("GetDownloadFlowUrl", req, cb);
780
+ async ChannelDisableUserAutoSign(req, cb) {
781
+ return this.request("ChannelDisableUserAutoSign", req, cb);
958
782
  }
959
783
  /**
960
- * **适用场景**:
961
- 当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口动态补充签署人。同一签署人只允许补充一人,最终实际签署人取决于谁先领取合同完成签署。
962
-
963
- **接口使用说明**:
784
+ * 该接口用于批量创建企业认证链接, 可以支持PC浏览器,H5和小程序三种途径。
785
+ 此接口为异步提交任务接口,需要与[查询子企业批量认证链接](https://qcloudimg.tencent-cloud.cn/raw/1d3737991b2a3be78002bd78a47d6917.png)配合使用,整体流程如下图。
786
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
964
787
 
965
- 1.本接口现已支持批量补充签署人
966
788
 
967
- 2.当<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中指定需要补充的FlowId时,可以对指定合同补充签署人;可以指定多个相同发起方的不同合同在完成批量补充
968
789
 
969
- 3.当<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中指定需要补充的FlowId时,是对指定的合同补充多个指定的签署人
790
+ **注意**
970
791
 
971
- 4.如果同时指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId,仅使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId作为补充的合同
792
+ 1. 单次最多创建10个子企业。
793
+ 2. 一天内,同一家企业最多创建8000个子企业。
794
+ 3. 同一批创建的子客户不能重复,包括企业名称、企业统一信用代码和子客户经办人openId。
795
+ 4. 跳转到小程序的实现,请参考微信官方文档(分为<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>。
972
796
 
973
- 5.如果部分指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId,又指定了<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId;那么<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>存在指定的FlowId,则使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId,不存在则使用<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId作为补充的合同
974
797
 
975
798
 
976
- 6.如果同时未指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId,则传参错误
799
+ **腾讯电子签小程序的AppID 原始Id如下:**
977
800
 
978
- **限制条件**:
979
- 1. 本企业(发起方企业)企业签署人仅支持通过企业名称+姓名+手机号进行补充。
980
- 2. 个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
801
+ | 小程序 | AppID | 原始ID |
802
+ | ------------ | ------------ | ------------ |
803
+ | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
804
+ | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
981
805
  */
982
- async ChannelCreateFlowApprovers(req, cb) {
983
- return this.request("ChannelCreateFlowApprovers", req, cb);
806
+ async CreateBatchOrganizationRegistrationTasks(req, cb) {
807
+ return this.request("CreateBatchOrganizationRegistrationTasks", req, cb);
984
808
  }
985
809
  /**
986
- * 获取个人用户认证证书图片下载URL
810
+ * 该接口用于获取个人授权执业章给企业的二维码,需要个人用户通过微信扫码。
987
811
 
988
- 个人用户认证证书图片样式如下图
812
+ 扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
989
813
 
990
- ![image](https://qcloudimg.tencent-cloud.cn/raw/d568bc0f101bef582f7af2cb5ab7a715.png)
814
+ 个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
991
815
 
992
- 注:
993
- <ul>
994
- <li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
995
- <li>专为电子处方单(医疗自动签)特定场景使用。在使用前,请务必与您的客户经理联系以确认已经开通电子处方单功能 </li>
996
- </ul>
816
+ **注意**
817
+ 1. 该二维码**有效期为7天**,过期后将失效,可重新创建。
818
+
819
+
820
+ 整体流程入下图
821
+
822
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/21b6b56dbc796c9d6f402d6ce6febb07.png)
997
823
  */
998
- async CreatePersonAuthCertificateImage(req, cb) {
999
- return this.request("CreatePersonAuthCertificateImage", req, cb);
824
+ async CreateEmployeeQualificationSealQrCode(req, cb) {
825
+ return this.request("CreateEmployeeQualificationSealQrCode", req, cb);
1000
826
  }
1001
827
  /**
1002
- * 创建一个用于他方自动签授权的链接(可选择他方授权或我方授权)。通过这个链接,合作方企业可以直接进入小程序,进行自动签授权操作。
1003
-
1004
- 如果授权企业尚未开通企业自动签功能,该链接还将引导他们首先开通本企业的自动签服务
1005
-
1006
-
1007
- 注:
1008
- 1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
1009
- 2. 已经在授权中或者授权成功的企业,无法重复授权
1010
- 3. 授权企业和被授权企业必须都是已认证企业
1011
- 4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
828
+ * 此接口(ChannelGetTaskResultApi)用来查询转换任务的状态。如需发起转换任务,请使用<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行资源文件的转换操作<br />
829
+ 前提条件:已调用 <a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换,并得到了返回的转换任务Id。<br />
1012
830
 
1013
- **该接口效果同控制台: 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
1014
- ![image](https://qcloudimg.tencent-cloud.cn/raw/091823fd4f02af7dda416fa10ca65f2d.png)
831
+ 适用场景:已创建一个文件转换任务,想查询该文件转换任务的状态,或获取转换后的文件资源ID。<br />
832
+ 注:
833
+ 1. `大文件转换所需的时间可能会比较长。`
834
+ 2. `本接口返回的文件资源ID就是PDF资源ID,可以直接用于【用PDF文件创建签署流程】接口发起合同。`
1015
835
  */
1016
- async CreatePartnerAutoSignAuthUrl(req, cb) {
1017
- return this.request("CreatePartnerAutoSignAuthUrl", req, cb);
836
+ async ChannelGetTaskResultApi(req, cb) {
837
+ return this.request("ChannelGetTaskResultApi", req, cb);
1018
838
  }
1019
839
  /**
1020
- * 此接口(ChannelCreateRole)用来创建企业自定义角色。
1021
-
1022
- 适用场景1:创建当前企业的自定义角色,并且创建时不进行权限的设置(PermissionGroups 参数不传),角色中的权限内容可通过接口 ChannelModifyRole 完成更新。
840
+ * 获取设置自动签印章小程序链接。
1023
841
 
1024
- 适用场景2:创建当前企业的自定义角色,并且创建时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考[查询角色列表接口](https://qian.tencent.com/developers/partnerApis/accounts/ChannelDescribeRoles) 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
842
+ 注意:
843
+ <ul><li>需要<code>企业开通自动签</code>后使用。</li>
844
+ <li>仅支持<code>已经开通了自动签的个人</code>更换自动签印章。</li>
845
+ <li>链接有效期默认7天,<code>最多30天</code>。</li>
846
+ <li>该接口的链接适用于<code>小程序</code>端。</li>
847
+ <li>该接口不会扣除您的合同套餐,暂不参与计费。</li></ul>
1025
848
  */
1026
- async ChannelCreateRole(req, cb) {
1027
- return this.request("ChannelCreateRole", req, cb);
849
+ async ChannelCreateUserAutoSignSealUrl(req, cb) {
850
+ return this.request("ChannelCreateUserAutoSignSealUrl", req, cb);
1028
851
  }
1029
852
  /**
1030
- * 获取合同流程PDF的下载链接,可以下载签署中、签署完的此子企业创建的合同。
853
+ * 激活或续期子客企业, 在激活状态下,企业可以正常发起合同;在非激活状态下,企业仅能查看和签署合同。
1031
854
 
855
+ **1. 激活**:使用一个许可证将子客企业从未激活状态转变为激活状态。**激活状态的有效期为一年,一年后将自动回到未激活状态**。
1032
856
 
857
+ **2. 续期**:使用一个许可证将已激活的子客企业的有效期延长一年。只有处于激活状态的子企业才能进行续期操作(**若处于非激活状态,则需先激活**)。您可以使用多个许可证对同一子客企业进行多次续费。
1033
858
 
1034
859
 
1035
- ### 2. 确保合同的PDF已经合成后,再调用本接口。
1036
- 用户创建合同或者提交签署动作后,后台需要1~3秒的时间就进行合同PDF合成或者签名,为了确保您下载的是签署完成的完整合同文件,我们建议采取下面两种方式的一种来<font color="red"><b>确保PDF已经合成完成,然后在调用本接口</b></font>。
860
+ 该接口的效果同:**【企业应用管理】 -> 【子客企业管理】 -> 【激活】或者【续期】**
1037
861
 
1038
- **第一种**:请确保您的系统配置了[接收合同完成通知的回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign)功能。一旦所有参与方签署完毕,我们的系统将自动向您提供的回调地址发送完成通知。
862
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/cd63761ca6e814c64b4ecf131555b74e.png)
1039
863
 
1040
- **第二种**:通过调用我们的[获取合同信息](https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo)接口来主动检查合同的签署状态。请仅在确认合同状态为“全部签署完成”后,进行文件的下载操作。
1041
864
 
1042
- ### 3. 链接具有有效期限
1043
- <font color="red"><b>生成的链接是有时间限制的,过期后将无法访问</b></font>。您可以在接口返回的信息中查看具体的过期时间。为避免错误,请确保在链接过期之前进行下载操作。
865
+ 如果不想调用此接口或者页面点击进行激活或续期,可以在【应用扩展服务】中打开自动激活或续期,在许可证充足的情况下会自动激活或续期子客企业
1044
866
 
1045
- ### 4. 有两种开通下载权限的途径。
867
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/2ccb37ef6bde463c15c39fdda789216f.png)
868
+ */
869
+ async CreateChannelSubOrganizationActive(req, cb) {
870
+ return this.request("CreateChannelSubOrganizationActive", req, cb);
871
+ }
872
+ /**
873
+ * 通过此接口(DescribeTemplates)查询该第三方平台子客企业在电子签拥有的有效模板,不包括第三方平台模板。
1046
874
 
1047
- **第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图。
1048
- 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
875
+ **适用场景**
876
+ 该接口常用来配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/CreateFlowsByTemplates" target="_blank">用模板创建签署流程</a>和<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates" target="_blank">通过多模板创建合同组签署流程</a>接口,作为创建合同的前置接口使用。
877
+ 通过此接口查询到模板信息后,再通过调用创建合同的接口,指定模板ID,指定模板中需要的填写控件内容等,完成合同文档的创建。
1049
878
 
1050
- ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
879
+ **模板的来源**
880
+ 子客企业的模板有两种途径获取
881
+ - 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
882
+ - 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
1051
883
 
1052
- **第二种**: 渠道方企业在**企业应用管理**的配置界面打开需要配置的应用,点击**应用扩展服务**开通此功能,需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
1053
- 注:
1054
- 1. `请注意如果第三方应用的子客主动关闭了渠道端下载渠道子客合同功能开关,那么渠道方开通了此功能也无法下载子客的合同文件`
884
+ **一个模板通常会包含以下结构信息**
1055
885
 
1056
- ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
1057
- */
1058
- async DescribeResourceUrlsByFlows(req, cb) {
1059
- return this.request("DescribeResourceUrlsByFlows", req, cb);
1060
- }
1061
- /**
1062
- * 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时,若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
1063
- - [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
1064
- - [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)
1065
- - [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo)
886
+ - 模板ID, 模板名字等基本信息
887
+ - 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
888
+ - 发起方和签署方的填写控件 Components
889
+ - 签署方的签署控件 SignComponents
1066
890
 
1067
- 2. 同一合同组,同一签署人可以多次提交签署审批结果,签署时的最后一个“审批结果”有效。
1068
- */
1069
- async CreateFlowGroupSignReview(req, cb) {
1070
- return this.request("CreateFlowGroupSignReview", req, cb);
1071
- }
1072
- /**
1073
- * 使用此接口,用来绑定企业实名员工的角色,
1074
- 支持以电子签userId、客户系统openId两种方式进行绑定。
891
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/ab81fa948a0a6fea14f48cac91d0e36a/channel_DescribeTemplates.png)
1075
892
 
1076
- 对应控制台的操作如下图
1077
- ![image](https://qcloudimg.tencent-cloud.cn/raw/5b41194d3cb3f2058ec0ba0fb5ebc6a6.png)
893
+ 模板中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
894
+
895
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
896
+
897
+
898
+ **注意**
899
+
900
+ >1. 查询条件TemplateId、TemplateName与ChannelTemplateId可同时存在,即可查询同时满足这些条件的模板。
901
+ >2. TemplateId 和TemplateIds互为独立,若两个参数都传入,则以TemplateId为准
902
+
903
+ <font color="red">相关视频指引</font> <br>
904
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
1078
905
  */
1079
- async ChannelCreateUserRoles(req, cb) {
1080
- return this.request("ChannelCreateUserRoles", req, cb);
906
+ async DescribeTemplates(req, cb) {
907
+ return this.request("DescribeTemplates", req, cb);
1081
908
  }
1082
909
  /**
1083
910
  * 此接口(ChannelCancelUserAutoSignEnableUrl)用来撤销发送给个人用户的自动签开通链接,撤销后对应的个人用户开通链接失效。若个人用户已经完成开通,将无法撤销。(处方单场景专用,使用此接口请与客户经理确认)
@@ -1086,54 +913,94 @@ class Client extends TencentCloudCommon.AbstractClient {
1086
913
  return this.request("ChannelCancelUserAutoSignEnableUrl", req, cb);
1087
914
  }
1088
915
  /**
1089
- * 生成用印申请审批链接,审批人可以通过此链接进入小程序进行审批。
1090
- p.s.
1091
- Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批人打开。
916
+ * 此接口(UploadFiles)文件上传。<br/>
917
+
918
+ 适用场景:用于合同,印章的文件上传。文件上传以后,
919
+ 如果是PDF格式文件可配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>接口进行合同流程的发起
920
+ 如果是其他类型可以配合<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务</a>接口转换成PDF文件
921
+
922
+ 注:
923
+ 1. 图片类型(png/jpg/jpeg)限制大小为5M以下, PDF/word/excel等其他格式限制大小为60M以下
924
+ 2. <font color='red'>此接口调用时需要单独设置Domain请求域名 </font>, 联调开发环境为 <font color='red'>file.test.ess.tencent.cn</font>,正式环境需要设置为<font color='red'>file.ess.tencent.cn</font>,代码示例
925
+ ```
926
+ HttpProfile httpProfile = new HttpProfile();
927
+ httpProfile.setEndpoint("file.test.ess.tencent.cn");
928
+ ```
929
+
930
+ <font color="red">相关视频指引</font> <br>
931
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
1092
932
  */
1093
- async DescribeChannelSealPolicyWorkflowUrl(req, cb) {
1094
- return this.request("DescribeChannelSealPolicyWorkflowUrl", req, cb);
933
+ async UploadFiles(req, cb) {
934
+ return this.request("UploadFiles", req, cb);
1095
935
  }
1096
936
  /**
1097
- * 查询渠道子客企业信息时,可以支持单个子客和整个应用下所有子客的查询。返回的信息包括超管、法人的信息以及当前企业的认证状态等信息。
937
+ * 该接口用于发起合同后,生成用户的签署链接 <br/>
1098
938
 
1099
- - 对于单个企业的查询,通过**指定子客的唯一标识**来查询该子客的企业信息
1100
- - 对于整个应用下所有企业的查询,**不需要指定子客的唯一标识**,直接查询整个应用下所有子客企业的企业信息
939
+ **注意**
940
+ 1. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接 。
941
+ 2. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。配置方式请参考:<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
942
+ 如需跳转到小程序的实现,参考微信官方文档(分为<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>。
943
+ 3. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
1101
944
  */
1102
- async DescribeChannelOrganizations(req, cb) {
1103
- return this.request("DescribeChannelOrganizations", req, cb);
945
+ async ChannelCreateFlowSignUrl(req, cb) {
946
+ return this.request("ChannelCreateFlowSignUrl", req, cb);
1104
947
  }
1105
948
  /**
1106
- * 指定需要批量催办的签署流程ID,批量催办合同,最多100个。需要符合以下条件的合同才可被催办
1107
- 1. 合同中当前状态为 **待签署** 的签署人是催办的对象
1108
- 2. **每个合同只能催办一次**
949
+ * 此接口(CreateChannelOrganizationInfoChangeUrl)用于创建子客企业信息变更链接。
1109
950
 
1110
- **催办的效果**: 对方会收到如下的短信通知
951
+ <h3 id="1">支持变更链接类型,通过入参 Endpoint 指定,默认为WEIXINAPP。</h3>
952
+
953
+ <h4 id="WEIXINAPP">WEIXINAPP</h4>
954
+ <p>创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。</p>
955
+
956
+ <h4 id="APP">APP</h4>
957
+ <p>创建变更小程序链接,可从第三方App跳转到微信腾讯电子签小程序进行更换。</p>
958
+
959
+
960
+ <h3 id="2">支持创建企业超管变更链接或企业基础信息变更链接,通过入参 ChangeType 指定。</h3>
961
+
962
+ <h4 id="1-企业超管变更">1. 企业超管变更</h4>
963
+
964
+ <p>换成企业的其他员工来当超管</p>
965
+
966
+ <h4 id="2-企业基础信息变更">2. 企业基础信息变更</h4>
967
+
968
+ <h5 id="可以变动">可以变动</h5>
969
+
970
+ <ul>
971
+ <li>企业名称<br>
972
+ </li>
973
+ <li>法定代表人姓名(新法人有邀请链接)<br>
974
+ </li>
975
+ <li>企业地址和所在地</li>
976
+ </ul>
977
+
978
+ <h5 id="不可变动">不可变动</h5>
979
+
980
+ <ul>
981
+ <li>统一社会信用代码<br>
982
+ </li>
983
+ <li>企业主体类型</li>
984
+ </ul>
1111
985
 
1112
- ![image](https://qcloudimg.tencent-cloud.cn/raw/3caf94b7f540fa5736270d38528d3a7b.png)
986
+ <p>如果企业名称变动会引起下面的变动</p>
1113
987
 
988
+ <ul>
989
+ <li>合同: 老合同不做任何处理, 新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
990
+ <li>印章: 会删除所有的印章所有的机构公章,合同专用章,财务专用章和人事专用章, 然后用新企业名称生成新的机构公章,合同专用章,财务专用章和人事专用章, 而法人章不会处理</li>
991
+ <li>证书: 企业证书会重新请求CA机构用新企业名称生成新的证书</li>
992
+ </ul>
1114
993
 
1115
- **注**:`合同催办是白名单功能,请联系客户经理申请开白后使用`
1116
- */
1117
- async ChannelCreateFlowReminds(req, cb) {
1118
- return this.request("ChannelCreateFlowReminds", req, cb);
1119
- }
1120
- /**
1121
- * 提交申请出证报告任务并返回报告ID。
1122
994
 
1123
995
  注意:
1124
- - 使用此功能**需搭配出证套餐** ,使用前请联系对接的客户经理沟通。
1125
- - 操作人必须是**发起方或者签署方企业的(非走授权书认证)法人或者超管**。
1126
- - 合同流程必须**所有参与方已经签署完成**。
1127
- - 出证过程需一定时间,建议在**提交出证任务后的24小时之后**,通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
1128
-
1129
-
1130
- ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
996
+ 1. 生成的电子签小程序链接<font color='red'>只能由企业的法人或者超管</font>点击后进行操作, 其他员工打开后会提示“无权查看该内容”
997
+ 2. 法人可以无需生成链接,直接在电子签小程序中更换本企业的超管
1131
998
  */
1132
- async CreateChannelFlowEvidenceReport(req, cb) {
1133
- return this.request("CreateChannelFlowEvidenceReport", req, cb);
999
+ async CreateChannelOrganizationInfoChangeUrl(req, cb) {
1000
+ return this.request("CreateChannelOrganizationInfoChangeUrl", req, cb);
1134
1001
  }
1135
1002
  /**
1136
- * 接口(ChannelCreateFlowGroupByTemplates)用于通过多模板创建合同组签署流程。
1003
+ * 接口(ChannelCreateFlowGroupByFiles)用于使用 PDF 文件创建合同组签署流程。
1137
1004
 
1138
1005
  - 该接口允许通过选择多个模板一次性创建多个合同,这些合同被组织在一个合同组中。
1139
1006
  - 每个签署方将收到一个签署链接,通过这个链接可以访问并签署合同组中的所有合同。
@@ -1141,6 +1008,7 @@ class Client extends TencentCloudCommon.AbstractClient {
1141
1008
 
1142
1009
  <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
1143
1010
 
1011
+
1144
1012
  ### 2. 适用场景
1145
1013
 
1146
1014
  该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
@@ -1166,6 +1034,7 @@ class Client extends TencentCloudCommon.AbstractClient {
1166
1034
  <td>第三方子企业A员工</td>
1167
1035
  <td>第三方子企业A员工</td>
1168
1036
  </tr>
1037
+
1169
1038
  <tr>
1170
1039
  <td>场景二</td>
1171
1040
  <td>第三方子企业A员工</td>
@@ -1199,143 +1068,295 @@ class Client extends TencentCloudCommon.AbstractClient {
1199
1068
 
1200
1069
  ### 7.合同组暂不支持抄送功能
1201
1070
  */
1202
- async ChannelCreateFlowGroupByTemplates(req, cb) {
1203
- return this.request("ChannelCreateFlowGroupByTemplates", req, cb);
1071
+ async ChannelCreateFlowGroupByFiles(req, cb) {
1072
+ return this.request("ChannelCreateFlowGroupByFiles", req, cb);
1204
1073
  }
1205
1074
  /**
1206
- * 支持企业进行批量初始化操作:
1075
+ * 此接口用于查询合同或者合同组的详情信息,支持查询多个(数量不能超过100)。
1076
+
1077
+ 适用场景:可用于主动查询某个合同或者合同组的详情信息。
1078
+
1079
+ 注: `只能查询本企业创建的合同(创建合同用的Agent和此接口用的Agent数据最好一致) `
1080
+ */
1081
+ async DescribeFlowDetailInfo(req, cb) {
1082
+ return this.request("DescribeFlowDetailInfo", req, cb);
1083
+ }
1084
+ /**
1085
+ * 通过此接口(ChannelDescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。可以支持单个子客和整个应用下所有子客的查询。
1086
+ <ul>
1087
+ <li>对于单个子客企业的查询,通过指定子客的唯一标识(Agent.ProxyOrganizationOpenId)来查询该子客消耗详情</li>
1088
+ <li>对于整个应用下所有企业的查询,不需要指定子客的唯一标识,只需要传入渠道应用标识(Agent.AppId)直接查询整个应用下所有子客企业消耗详情</li>
1089
+ </ul>
1090
+ */
1091
+ async ChannelDescribeBillUsageDetail(req, cb) {
1092
+ return this.request("ChannelDescribeBillUsageDetail", req, cb);
1093
+ }
1094
+ /**
1095
+ * 批量清理未认证的企业认证流程。
1096
+
1097
+ 此接口用来清除企业方认证信息填写错误,批量清理认证中的认证流信息。
1098
+ 为接口[提交子企业批量认证链接创建任务](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 接口的扩展接口。即在批量认证过程中,当发起认证企业发现超管信息错误的时候,可以将当前超管下的所有认证流企业清除。
1099
+
1100
+ 注意:
1101
+ **这个接口的操作人必须跟生成批量认证链接接口的应用号一致,才可以调用,否则会返回当前操作人没有认证中的企业认证流**
1102
+ */
1103
+ async DeleteOrganizationAuthorizations(req, cb) {
1104
+ return this.request("DeleteOrganizationAuthorizations", req, cb);
1105
+ }
1106
+ /**
1107
+ * 在已启动的签署流程中,可对签署截止日期进行延期操作,主要分为以下两个层面:
1108
+ 1. <b> 合同(流程)层面</b>:仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
1109
+ 2. <b> 签署人层面</b> :需提供流程ID和签署人ID。此操作针对特定签署人进行延期,特别是对于有序合同(流程),签署截止时间不得超过后续签署人的流程截止时间。
1207
1110
 
1208
1111
  此接口存在以下限制:
1209
- 1. 批量操作的企业需要已经完成电子签的认证流程。
1210
- 2. 通过此接口生成的链接在小程序端进行操作时,操作人需要是<font color="red">所有企业的超管或法人</font>。
1211
- 3. 批量操作的企业,需要是本方第三方应用下的企业。
1212
- 4. <font color="red">操作链接过期时间默认为生成链接后7天。</font>
1112
+ 1. 执行操作的员工须为<font color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
1113
+ 2. 延长整个签署流程时,<font color="red">应至少有一方尚未签署</font>(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
1114
+ 3. 延长整个签署流程时,新的签署截止日期应晚于已设定的签署截止日期和当前日期。
1115
+ 4. 延长签署方截止时间时,<font color="red">签署方不能处于流程完结或已终止状态</font>(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
1116
+ 5. 延长签署方截止时间时,新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同,还需早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
1117
+ 6. <font color="red">不支持操作合同组合同</font>。
1118
+
1119
+ 合同(流程)层面截止时间子企业控制台展示的位置:
1120
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/f0f88c0eb49a926da9a86e5a6e9efa8b.png)
1213
1121
  */
1214
- async CreateBatchInitOrganizationUrl(req, cb) {
1215
- return this.request("CreateBatchInitOrganizationUrl", req, cb);
1122
+ async ModifyFlowDeadline(req, cb) {
1123
+ return this.request("ModifyFlowDeadline", req, cb);
1216
1124
  }
1217
1125
  /**
1218
- * 此接口(CreateChannelOrganizationInfoChangeUrl)用于创建子客企业信息变更链接。
1126
+ * 通过此接口,可以创建企业批量签署链接,员工只需点击链接即可跳转至控制台进行批量签署。
1219
1127
 
1220
- <h3 id="1">支持变更链接类型,通过入参 Endpoint 指定,默认为WEIXINAPP。</h3>
1128
+ 注:
1129
+ - 员工必须在企业下完成实名认证,且需作为批量签署合同的签署方或者领取方。
1130
+ - 仅支持传入待签署或者待领取的合同,待填写暂不支持。
1131
+ - 员工批量签署,支持多种签名方式,包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
1221
1132
 
1222
- <h4 id="WEIXINAPP">WEIXINAPP</h4>
1223
- <p>创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。</p>
1133
+ 签署的嵌入页面长相如下:
1134
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/a4754bc835a3f837ddec1e28b02ed9c0.png)
1135
+ */
1136
+ async ChannelCreateOrganizationBatchSignUrl(req, cb) {
1137
+ return this.request("ChannelCreateOrganizationBatchSignUrl", req, cb);
1138
+ }
1139
+ /**
1140
+ * 将指定印章授权给第三方平台子客企业下的某些员工
1141
+ */
1142
+ async ChannelCreateSealPolicy(req, cb) {
1143
+ return this.request("ChannelCreateSealPolicy", req, cb);
1144
+ }
1145
+ /**
1146
+ * 通过接口[批量撤销合同流程](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelBatchCancelFlows)或者[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateBatchCancelFlowUrl)发起批量撤销任务后,可通过此接口查询批量撤销任务的结果。
1147
+ */
1148
+ async DescribeCancelFlowsTask(req, cb) {
1149
+ return this.request("DescribeCancelFlowsTask", req, cb);
1150
+ }
1151
+ /**
1152
+ * 此接口(CreateConsoleLoginUrl)用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。
1224
1153
 
1225
- <h4 id="APP">APP</h4>
1226
- <p>创建变更小程序链接,可从第三方App跳转到微信腾讯电子签小程序进行更换。</p>
1154
+ Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态,进入不同的流程,主要情况分类如下:
1155
+ <table>
1156
+ <thead>
1157
+ <tr>
1158
+ <th>子客企业状态</th>
1159
+ <th>子客企业员工状态</th>
1160
+ <th>点击链接进入的流程</th>
1161
+ </tr>
1162
+ </thead>
1163
+ <tbody>
1164
+ <tr>
1165
+ <td>企业未激活</td>
1166
+ <td>员工未认证</td>
1167
+ <td>进入企业激活流程,首次完成企业激活流程的员工会成为超管</td>
1168
+ </tr>
1169
+ <tr>
1170
+ <td>企业已激活</td>
1171
+ <td>员工未认证</td>
1172
+ <td>进入员工认证并加入企业流程</td>
1173
+ </tr>
1174
+ <tr>
1175
+ <td>企业已激活</td>
1176
+ <td>员工已认证</td>
1177
+ <td>进入子客企业Web控制台</td>
1178
+ </tr>
1179
+ </tbody>
1180
+ </table>
1181
+ 如果是企业激活流程,需要注意如下情况:
1227
1182
 
1183
+ 1. 若在激活过程中,**更换用户OpenID重新生成链接,之前的认证会被清理**。因此不要在企业认证过程生成多个链接给多人同时操作,会导致认证过程互相影响。
1184
+ 2. 若您认证中发现信息有误需要重新认证,**可通过更换用户OpenID重新生成链接的方式,来清理掉已有的流程**。
1228
1185
 
1229
- <h3 id="2">支持创建企业超管变更链接或企业基础信息变更链接,通过入参 ChangeType 指定。</h3>
1186
+ 系统的渠道企业, 应用, 子客企业, 子客员工的组织形式
1187
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/77677faeea26c9d7f37474597c81fe01.png)
1230
1188
 
1231
- <h4 id="1-企业超管变更">1. 企业超管变更</h4>
1232
1189
 
1233
- <p>换成企业的其他员工来当超管</p>
1190
+ <font color="red">相关视频指引</font> <br>
1191
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-createconsoleloginin.mp4" target="_blank">【生成子客登录链接】代码编写 & 子企业认证示例</a><br>
1192
+ */
1193
+ async CreateConsoleLoginUrl(req, cb) {
1194
+ return this.request("CreateConsoleLoginUrl", req, cb);
1195
+ }
1196
+ /**
1197
+ * 通过此接口指定合同、签署人、填写控件等信息,生成嵌入式链接,此链接可以嵌入到其他网页或者直接打开,打开后进入发起页面。在此页面上,合同信息和签署人信息均不可更改。
1234
1198
 
1235
- <h4 id="2-企业基础信息变更">2. 企业基础信息变更</h4>
1199
+ 注意:
1200
+ 1. <font color="red">仅支持在PC浏览器</font>上进行操作和使用。
1201
+ 2. 在使用<font color="red">模板发起合同时,需指定RecipientId</font>以明确参与方在模板中所扮演的角色。
1236
1202
 
1237
- <h5 id="可以变动">可以变动</h5>
1203
+ **嵌入式签署人-各种场景传参说明**:
1238
1204
 
1239
- <ul>
1240
- <li>企业名称<br>
1241
- </li>
1242
- <li>法定代表人姓名(新法人有邀请链接)<br>
1243
- </li>
1244
- <li>企业地址和所在地</li>
1245
- </ul>
1205
+ <table>
1206
+ <thead>
1207
+ <tr>
1208
+ <th>场景编号</th>
1209
+ <th>可作为签署方的类型</th>
1210
+ <th>签署方传参说明</th>
1211
+ </tr>
1212
+ </thead>
1246
1213
 
1247
- <h5 id="不可变动">不可变动</h5>
1214
+ <tbody>
1215
+ <tr>
1216
+ <td>场景一</td>
1217
+ <td>第三方子企业员工</td>
1218
+ <td>OpenId、OrganizationName、OrganizationOpenId必传 ,ApproverType设置为0</td>
1219
+ </tr>
1220
+ <tr>
1221
+ <td>场景二</td>
1222
+ <td>SaaS平台企业员工</td>
1223
+ <td>Name、Mobile、OrganizationName必传,NotChannelOrganization=True。 ApproverType设置为0</td>
1224
+ </tr>
1225
+ <tr>
1226
+ <td>场景三</td>
1227
+ <td>个人/自然人</td>
1228
+ <td>Name、Mobile必传, ApproverType设置为1</td>
1229
+ </tr>
1230
+ </tbody>
1231
+ </table>
1248
1232
 
1249
- <ul>
1250
- <li>统一社会信用代码<br>
1251
- </li>
1252
- <li>企业主体类型</li>
1253
- </ul>
1233
+ 嵌入的页面样式如下:
1234
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/b2ae013fb4d747891dd3815bbe897208.png)
1235
+ */
1236
+ async ChannelCreatePrepareFlow(req, cb) {
1237
+ return this.request("ChannelCreatePrepareFlow", req, cb);
1238
+ }
1239
+ /**
1240
+ * 通过合同编号生成批量撤销合同的链接,单次最多支持撤销100份合同, 返回的链接需要有此权限的人<font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>在<font color='red'>**手机端**</font>打开, 跳转到腾讯电子签小程序输入撤销原因来进行撤销合同
1254
1241
 
1255
- <p>如果企业名称变动会引起下面的变动</p>
1242
+ 适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
1256
1243
 
1257
- <ul>
1258
- <li>合同: 老合同不做任何处理, 新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
1259
- <li>印章: 会删除所有的印章所有的机构公章,合同专用章,财务专用章和人事专用章, 然后用新企业名称生成新的机构公章,合同专用章,财务专用章和人事专用章, 而法人章不会处理</li>
1260
- <li>证书: 企业证书会重新请求CA机构用新企业名称生成新的证书</li>
1261
- </ul>
1244
+ - **可撤回合同状态**:未全部签署完成
1245
+ - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
1246
+
1247
+ 批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)或通过接口[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask)主动查询。
1248
+
1249
+ 注:
1250
+ - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
1251
+ - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
1252
+ - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
1253
+ */
1254
+ async ChannelCreateBatchCancelFlowUrl(req, cb) {
1255
+ return this.request("ChannelCreateBatchCancelFlowUrl", req, cb);
1256
+ }
1257
+ /**
1258
+ * 此接口(ChannelDeleteRole)用来删除企业自定义角色。
1262
1259
 
1260
+ 注:**系统角色不可删除。**
1261
+ */
1262
+ async ChannelDeleteRole(req, cb) {
1263
+ return this.request("ChannelDeleteRole", req, cb);
1264
+ }
1265
+ /**
1266
+ * 此接口(SyncProxyOrganization)用于同步第三方平台子客企业信息,包括企业名称、企业营业执照、企业统一社会信用代码和法人姓名等,便于子客企业在企业激活过程中无需手动上传营业执照或补充企业信息。
1263
1267
 
1264
1268
  注意:
1265
- 1. 生成的电子签小程序链接<font color='red'>只能由企业的法人或者超管</font>点击后进行操作, 其他员工打开后会提示“无权查看该内容”
1266
- 2. 法人可以无需生成链接,直接在电子签小程序中更换本企业的超管
1269
+
1270
+ - **需要在<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>前同步的企业信息**, 否则会出现信息同步没有用的情形
1271
+ - **企业信息需要和营业执照信息对应**, 否则会出现激活过程验证不通过的问题
1272
+
1273
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/7ec91b79a0a4860e77c9ff9f4a5f13ad/channel_SyncProxyOrganization2.png)
1274
+
1275
+
1276
+ - **企业统一社会信用代码**: 对应上图中的**1**
1277
+ - **第三方平台子客企业名称**: 对应上图中的**2**
1278
+ - **企业法定代表人的名字**:对应上图中的**3**
1279
+ - **企业详细住所**:对应上图中的**4**
1267
1280
  */
1268
- async CreateChannelOrganizationInfoChangeUrl(req, cb) {
1269
- return this.request("CreateChannelOrganizationInfoChangeUrl", req, cb);
1281
+ async SyncProxyOrganization(req, cb) {
1282
+ return this.request("SyncProxyOrganization", req, cb);
1270
1283
  }
1271
1284
  /**
1272
- * 此接口(SyncProxyOrganizationOperators)用于同步 第三方平台子客企业经办人列表,主要是同步经办人的离职状态。
1273
- 子客Web控制台的组织架构管理,依赖于第三方应用平台的,无法在页面针对员工做新增/更新/离职等操作, 必须通过 API 来操作。
1274
-
1275
- - **新增员工的场景**: 通过本接口提前导入员工列表, 然后调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>分享给对应的员工进行实名, 新增员工后员工的状态为**未实名**, 通过链接实名后状态变为**已实名**, 已实名员工就可以参与合同的发起。
1276
-
1277
- - **员工离职的场景**: 通过本接口将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了, 同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空, 再次加入公司会从零开始) , 若员工信息有误可通过离职后在新增来解决, 离职员工状态为**离职**。
1285
+ * 此接口(ChannelUpdateSealStatus)用于第三方应用平台为子客企业更新印章状态。
1286
+ */
1287
+ async ChannelUpdateSealStatus(req, cb) {
1288
+ return this.request("ChannelUpdateSealStatus", req, cb);
1289
+ }
1290
+ /**
1291
+ * 通过此接口,创建小程序批量签署链接,个人/企业员工点击此链接即可跳转小程序进行批量签署。
1292
+ 请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。
1278
1293
 
1279
- ![image](https://qcloudimg.tencent-cloud.cn/raw/7a27a6bb0e4d39c2f6aa2a0b39946181/channel_SyncProxyOrganizationOperators.png)
1294
+ 注:
1295
+ - 使用此接口生成链接,需要提前开通 `个人签署方仅校验手机号` 功能,在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
1296
+ - 个人参与方点击链接后需短信验证码才能查看合同内容。
1297
+ - 个人用户批量签署,需要传Name,Mobile,IdCardNumber(IdCardType) 参数。
1298
+ - saas企业员工用户批量签署,在传递了姓名等基本信息参数的情况下,还需要传OrganizationName(参与方所在企业名称)参数生成签署链接,<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。
1299
+ - 子客企业员工用户批量签署,需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证,且OpenId对应员工此子客下已经实名</font>。Name,Mobile, IdCard等信息此时可以不传,系统会查询此OpenId实名信息自动补充。
1300
+ - 生成批量签署链接时,合同目标参与方状态需为<font color="red">待签署</font>状态。
1301
+ - 个人批量签署进行的合同的签名区, 全部变成<font color="red">手写签名</font>(不管合同里边设置的签名限制)来进行。
1302
+ - 不支持签署方含有签批控件,或设置了签署方在签署时自行添加签署控件功能的合同进行批量签署。
1303
+ */
1304
+ async ChannelCreateBatchSignUrl(req, cb) {
1305
+ return this.request("ChannelCreateBatchSignUrl", req, cb);
1306
+ }
1307
+ /**
1308
+ * 给医疗个人自动签许可续期。续期成功后,可对医疗自动签许可追加一年有效期,只可续期一次。
1280
1309
 
1281
- **注**:
1282
- - 新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理
1283
- - <font color='red'>超管和法人无法通过此接口离职</font>, 需要超管和法人将权限转移给其他人后才可通过此接口离职
1284
- - 新增员工的场景同ID不同员工会覆盖掉上一个同ID的员工, 如果上一个员工已经实名则不会被覆盖
1310
+ 注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
1285
1311
  */
1286
- async SyncProxyOrganizationOperators(req, cb) {
1287
- return this.request("SyncProxyOrganizationOperators", req, cb);
1312
+ async ChannelRenewAutoSignLicense(req, cb) {
1313
+ return this.request("ChannelRenewAutoSignLicense", req, cb);
1288
1314
  }
1289
1315
  /**
1290
- * 通过此接口(ChannelDescribeAccountBillDetail)查询该第三方平台子客账号计费详情。
1291
- <ul>
1292
- <li>对于渠道客户企业的查询,通过指定渠道企业的唯一标识(Agent.ProxyOrganizationId)来查询子客账号消耗详情</li>
1293
- </ul>
1316
+ * 通过此接口获取个人用户自动签的开通状态。
1317
+
1318
+ 注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
1294
1319
  */
1295
- async ChannelDescribeAccountBillDetail(req, cb) {
1296
- return this.request("ChannelDescribeAccountBillDetail", req, cb);
1320
+ async ChannelDescribeUserAutoSignStatus(req, cb) {
1321
+ return this.request("ChannelDescribeUserAutoSignStatus", req, cb);
1297
1322
  }
1298
1323
  /**
1299
- * 获取出证报告任务执行结果,返回报告 URL。
1324
+ * 发起解除协议的主要应用场景为:基于一份已经签署的合同(签署流程),进行解除操作。
1325
+ 解除协议的模板是官方提供,经过提供法务审核,暂不支持自定义。具体用法可以参考文档[合同解除](https://qian.tencent.com/developers/partner/flow_release)。
1300
1326
 
1301
1327
  注意:
1302
-
1303
- - 使用此功能`需搭配出证套餐` ,使用前请联系对接的客户经理沟通。
1304
- - 需调用创建并返回出证报告接口<a href="https://qian.tencent.com/developers/partnerApis/certificate/CreateChannelFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>获取报告编号后调用当前接口获取报告链接。
1305
-
1306
- ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
1328
+ <ul><li><code>原合同必须签署完</code>成后才能发起解除协议。</li>
1329
+ <li>只有原合同企业类型的参与人才能发起解除协议,<code>个人参与方不能发起解除协议</code>。</li>
1330
+ <li>原合同个人类型参与人必须是解除协议的参与人,<code>不能更换其他第三方个人</code>参与解除协议。</li>
1331
+ <li>如果原合同企业参与人无法参与解除协议,可以指定同企业具有同等权限的<code>企业员工代为处理</code>。</li>
1332
+ <li>发起解除协议同发起其他企业合同一样,也会参与合同<code>扣费</code>,扣费标准同其他类型合同。</li>
1333
+ <li>在解除协议签署完毕后,原合同及解除协议均变为已解除状态。</li>
1334
+ <li>非原合同企业参与人发起解除协议时,需要有<code>解除合同的权限</code>。</li>
1335
+ </ul>
1307
1336
  */
1308
- async DescribeChannelFlowEvidenceReport(req, cb) {
1309
- return this.request("DescribeChannelFlowEvidenceReport", req, cb);
1337
+ async ChannelCreateReleaseFlow(req, cb) {
1338
+ return this.request("ChannelCreateReleaseFlow", req, cb);
1310
1339
  }
1311
1340
  /**
1312
- * 此接口(OperateChannelTemplate)用于针对第三方应用平台模板库中的模板对子客企业发布授权的查询和设置。
1313
- 平台模板库中的模板的位置在控制台 企业应用管理 中下面的应用模板库管理目录, 可以参照下图位置
1314
- ![image](https://qcloudimg.tencent-cloud.cn/raw/7f2b6c94164b3e931efc9a037e0400f7.png)
1341
+ * 获取企业员工信息, 可以获取员工的名字,OpenId,UserId和简述的角色等信息,支持设置过滤条件以筛选员工查询结果。
1315
1342
 
1316
- # 支持的操作
1343
+ **注**:通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/SyncProxyOrganizationOperators" target="_blank">企业员工新增或离职</a>接口增加的新员工或者离职的员工也会在列表中。
1344
+ */
1345
+ async ChannelDescribeEmployees(req, cb) {
1346
+ return this.request("ChannelDescribeEmployees", req, cb);
1347
+ }
1348
+ /**
1349
+ * 该接口用于结束动态签署方2.0的合同流程。
1317
1350
 
1318
- ## 1. 查询模板的子客企业授权 (OperateType=SELECT)
1319
- - 查询模板的授权子企业列表
1320
1351
 
1321
- ## 2. 修改模板的子客企业授权 (OperateType=UPDATE)
1322
- - 当模板未发布时,可以修改模板的模板授权范围是**所有第三方应用合作企业**(AuthTag设置为all)或者**指定第三方应用合作企业**(AuthTag设置为part),**当模板发布后,不可做此修改**
1323
- - 如果模板是部分授权, 可通过ProxyOrganizationOpenIds增加子客的授权范围。
1352
+ **功能开通**
1353
+ - 动态签署方2.0功能的使用需要先<font color="red">联系产品经理开通模块化计费功能</font>,然后到控制台中打开此功能。详细的使用说明请参考<a href="https://qian.tencent.com/developers/company/dynamic_signer_v2" target="_blank">动态签署方2.0</a>文档。
1324
1354
 
1325
- ## 3. 取消模板的子客企业授权 (OperateType=DELETE)
1326
- - 对子客企业进行模板库中模板授权范围的进行删除操作。
1327
- - 主要对于手动领取的模板,去除授权后子客在模板库中看不到,就无法再领取了。但是**已经领取过成为自有模板的不会同步删除**。
1328
- - 对于自动领取的模板,由于已经下发,更改授权不会影响。
1329
- - 如果要同步删除子客自有模板库中的模板,请使用OperateType=UPDATE+Available参数处理。
1355
+ **使用条件**
1356
+ - 此接口只能在<font color="red">合同处于非终态且<b>所有的签署方都已经完成签署</b></font>。一旦合同进入终态(例如:过期、拒签、撤销或者调用过此接口成功过),将无法通过此接口结束合同流程。
1330
1357
  */
1331
- async OperateChannelTemplate(req, cb) {
1332
- return this.request("OperateChannelTemplate", req, cb);
1333
- }
1334
- /**
1335
- * 本接口(ChannelCreatePreparedPersonalEsign)用于创建导入个人印章(处方单场景专用,使用此接口请与客户经理确认)。
1336
- */
1337
- async ChannelCreatePreparedPersonalEsign(req, cb) {
1338
- return this.request("ChannelCreatePreparedPersonalEsign", req, cb);
1358
+ async ArchiveDynamicFlow(req, cb) {
1359
+ return this.request("ArchiveDynamicFlow", req, cb);
1339
1360
  }
1340
1361
  /**
1341
1362
  * 生成合成后的各类企业授权书,包括:
@@ -1349,7 +1370,17 @@ class Client extends TencentCloudCommon.AbstractClient {
1349
1370
  return this.request("CreateOrganizationAuthFile", req, cb);
1350
1371
  }
1351
1372
  /**
1352
- * 接口(ChannelCreateFlowGroupByFiles)用于使用 PDF 文件创建合同组签署流程。
1373
+ * 使用此接口,用来绑定企业实名员工的角色,
1374
+ 支持以电子签userId、客户系统openId两种方式进行绑定。
1375
+
1376
+ 对应控制台的操作如下图
1377
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/5b41194d3cb3f2058ec0ba0fb5ebc6a6.png)
1378
+ */
1379
+ async ChannelCreateUserRoles(req, cb) {
1380
+ return this.request("ChannelCreateUserRoles", req, cb);
1381
+ }
1382
+ /**
1383
+ * 接口(ChannelCreateFlowGroupByTemplates)用于通过多模板创建合同组签署流程。
1353
1384
 
1354
1385
  - 该接口允许通过选择多个模板一次性创建多个合同,这些合同被组织在一个合同组中。
1355
1386
  - 每个签署方将收到一个签署链接,通过这个链接可以访问并签署合同组中的所有合同。
@@ -1357,7 +1388,6 @@ class Client extends TencentCloudCommon.AbstractClient {
1357
1388
 
1358
1389
  <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
1359
1390
 
1360
-
1361
1391
  ### 2. 适用场景
1362
1392
 
1363
1393
  该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
@@ -1383,7 +1413,6 @@ class Client extends TencentCloudCommon.AbstractClient {
1383
1413
  <td>第三方子企业A员工</td>
1384
1414
  <td>第三方子企业A员工</td>
1385
1415
  </tr>
1386
-
1387
1416
  <tr>
1388
1417
  <td>场景二</td>
1389
1418
  <td>第三方子企业A员工</td>
@@ -1417,8 +1446,62 @@ class Client extends TencentCloudCommon.AbstractClient {
1417
1446
 
1418
1447
  ### 7.合同组暂不支持抄送功能
1419
1448
  */
1420
- async ChannelCreateFlowGroupByFiles(req, cb) {
1421
- return this.request("ChannelCreateFlowGroupByFiles", req, cb);
1449
+ async ChannelCreateFlowGroupByTemplates(req, cb) {
1450
+ return this.request("ChannelCreateFlowGroupByTemplates", req, cb);
1451
+ }
1452
+ /**
1453
+ * 获取出证报告任务执行结果,返回报告 URL。
1454
+
1455
+ 注意:
1456
+
1457
+ - 使用此功能`需搭配出证套餐` ,使用前请联系对接的客户经理沟通。
1458
+ - 需调用创建并返回出证报告接口<a href="https://qian.tencent.com/developers/partnerApis/certificate/CreateChannelFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>获取报告编号后调用当前接口获取报告链接。
1459
+
1460
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
1461
+ */
1462
+ async DescribeChannelFlowEvidenceReport(req, cb) {
1463
+ return this.request("DescribeChannelFlowEvidenceReport", req, cb);
1464
+ }
1465
+ /**
1466
+ * 此接口(OperateChannelTemplate)用于针对第三方应用平台模板库中的模板对子客企业发布授权的查询和设置。
1467
+ 平台模板库中的模板的位置在控制台 企业应用管理 中下面的应用模板库管理目录, 可以参照下图位置
1468
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/7f2b6c94164b3e931efc9a037e0400f7.png)
1469
+
1470
+ # 支持的操作
1471
+
1472
+ ## 1. 查询模板的子客企业授权 (OperateType=SELECT)
1473
+ - 查询模板的授权子企业列表
1474
+
1475
+ ## 2. 修改模板的子客企业授权 (OperateType=UPDATE)
1476
+ - 当模板未发布时,可以修改模板的模板授权范围是**所有第三方应用合作企业**(AuthTag设置为all)或者**指定第三方应用合作企业**(AuthTag设置为part),**当模板发布后,不可做此修改**
1477
+ - 如果模板是部分授权, 可通过ProxyOrganizationOpenIds增加子客的授权范围。
1478
+
1479
+ ## 3. 取消模板的子客企业授权 (OperateType=DELETE)
1480
+ - 对子客企业进行模板库中模板授权范围的进行删除操作。
1481
+ - 主要对于手动领取的模板,去除授权后子客在模板库中看不到,就无法再领取了。但是**已经领取过成为自有模板的不会同步删除**。
1482
+ - 对于自动领取的模板,由于已经下发,更改授权不会影响。
1483
+ - 如果要同步删除子客自有模板库中的模板,请使用OperateType=UPDATE+Available参数处理。
1484
+ */
1485
+ async OperateChannelTemplate(req, cb) {
1486
+ return this.request("OperateChannelTemplate", req, cb);
1487
+ }
1488
+ /**
1489
+ * 此接口(SyncProxyOrganizationOperators)用于同步 第三方平台子客企业经办人列表,主要是同步经办人的离职状态。
1490
+ 子客Web控制台的组织架构管理,依赖于第三方应用平台的,无法在页面针对员工做新增/更新/离职等操作, 必须通过 API 来操作。
1491
+
1492
+ - **新增员工的场景**: 通过本接口提前导入员工列表, 然后调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>分享给对应的员工进行实名, 新增员工后员工的状态为**未实名**, 通过链接实名后状态变为**已实名**, 已实名员工就可以参与合同的发起。
1493
+
1494
+ - **员工离职的场景**: 通过本接口将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了, 同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空, 再次加入公司会从零开始) , 若员工信息有误可通过离职后在新增来解决, 离职员工状态为**离职**。
1495
+
1496
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/7a27a6bb0e4d39c2f6aa2a0b39946181/channel_SyncProxyOrganizationOperators.png)
1497
+
1498
+ **注**:
1499
+ - 新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理
1500
+ - <font color='red'>超管和法人无法通过此接口离职</font>, 需要超管和法人将权限转移给其他人后才可通过此接口离职
1501
+ - 新增员工的场景同ID不同员工会覆盖掉上一个同ID的员工, 如果上一个员工已经实名则不会被覆盖
1502
+ */
1503
+ async SyncProxyOrganizationOperators(req, cb) {
1504
+ return this.request("SyncProxyOrganizationOperators", req, cb);
1422
1505
  }
1423
1506
  /**
1424
1507
  * 本接口(ChannelCreateEmbedWebUrl)用于创建可嵌入web页面的URL(此web页面可以通过iframe方式嵌入到贵方系统的网页中),支持以下类型的Web链接创建:
@@ -1437,26 +1520,6 @@ class Client extends TencentCloudCommon.AbstractClient {
1437
1520
  async ChannelCreateEmbedWebUrl(req, cb) {
1438
1521
  return this.request("ChannelCreateEmbedWebUrl", req, cb);
1439
1522
  }
1440
- /**
1441
- * 此接口用于查询合同或者合同组的详情信息,支持查询多个(数量不能超过100)。
1442
-
1443
- 适用场景:可用于主动查询某个合同或者合同组的详情信息。
1444
-
1445
- 注: `只能查询本企业创建的合同(创建合同用的Agent和此接口用的Agent数据最好一致) `
1446
- */
1447
- async DescribeFlowDetailInfo(req, cb) {
1448
- return this.request("DescribeFlowDetailInfo", req, cb);
1449
- }
1450
- /**
1451
- * 通过此接口(ChannelDescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。可以支持单个子客和整个应用下所有子客的查询。
1452
- <ul>
1453
- <li>对于单个子客企业的查询,通过指定子客的唯一标识(Agent.ProxyOrganizationOpenId)来查询该子客消耗详情</li>
1454
- <li>对于整个应用下所有企业的查询,不需要指定子客的唯一标识,只需要传入渠道应用标识(Agent.AppId)直接查询整个应用下所有子客企业消耗详情</li>
1455
- </ul>
1456
- */
1457
- async ChannelDescribeBillUsageDetail(req, cb) {
1458
- return this.request("ChannelDescribeBillUsageDetail", req, cb);
1459
- }
1460
1523
  /**
1461
1524
  * 获取个人用户自动签的开通链接。
1462
1525
 
@@ -1465,57 +1528,5 @@ class Client extends TencentCloudCommon.AbstractClient {
1465
1528
  async ChannelCreateUserAutoSignEnableUrl(req, cb) {
1466
1529
  return this.request("ChannelCreateUserAutoSignEnableUrl", req, cb);
1467
1530
  }
1468
- /**
1469
- * 批量清理未认证的企业认证流程。
1470
-
1471
- 此接口用来清除企业方认证信息填写错误,批量清理认证中的认证流信息。
1472
- 为接口[提交子企业批量认证链接创建任务](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 接口的扩展接口。即在批量认证过程中,当发起认证企业发现超管信息错误的时候,可以将当前超管下的所有认证流企业清除。
1473
-
1474
- 注意:
1475
- **这个接口的操作人必须跟生成批量认证链接接口的应用号一致,才可以调用,否则会返回当前操作人没有认证中的企业认证流**
1476
- */
1477
- async DeleteOrganizationAuthorizations(req, cb) {
1478
- return this.request("DeleteOrganizationAuthorizations", req, cb);
1479
- }
1480
- /**
1481
- * 您可以通过合同流程ID查询相关的<font color="red"><b>填写控件</b></font>信息及其内容。这包括控件的归属方、控件的填写状态(是否已填写)以及具体的填写内容。
1482
-
1483
- 无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件,均包含在查询结果中。
1484
-
1485
- ![image](https://qcloudimg.tencent-cloud.cn/raw/08f6ea50d3ae88b51c280c2b17c2a126.png)
1486
- ### 2. 哪些控件会出现在结果里边?
1487
- **A.不返回的控件类型:**
1488
- - 动态表格
1489
- - 附件控件
1490
- - 水印控件
1491
-
1492
- **B.返回的控件类型:**
1493
- - 单行文本
1494
- - 多行文本
1495
- - 勾选框控件
1496
- - 数字控件
1497
- - 日期控件
1498
- - 图片控件(图片下载地址)
1499
- - 邮箱控件
1500
- - 地址控件
1501
- - 学历控件
1502
- - 性别控件
1503
- - 省市区控件
1504
-
1505
- ### 3.怎么授权?
1506
-
1507
- 此接口需要授权, 有两种开通权限的途径
1508
-
1509
- **第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图
1510
- 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
1511
-
1512
- ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
1513
-
1514
- **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
1515
- ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
1516
- */
1517
- async ChannelDescribeFlowComponents(req, cb) {
1518
- return this.request("ChannelDescribeFlowComponents", req, cb);
1519
- }
1520
1531
  }
1521
1532
  exports.Client = Client;