tencentcloud-sdk-nodejs-essbasic 4.0.1015 → 4.0.1020

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.
@@ -198,6 +198,7 @@ import {
198
198
  ChannelDeleteRoleRequest,
199
199
  CreateBatchOrganizationRegistrationTasksRequest,
200
200
  ChannelCreateBatchQuickSignUrlResponse,
201
+ CreateBatchOrganizationAuthorizationUrlResponse,
201
202
  CreatePartnerAutoSignAuthUrlRequest,
202
203
  ChannelCreateBatchCancelFlowUrlRequest,
203
204
  ChannelDescribeAccountBillDetailResponse,
@@ -255,6 +256,7 @@ import {
255
256
  DescribeChannelOrganizationsResponse,
256
257
  ChannelCreateOrganizationBatchSignUrlResponse,
257
258
  EmbedUrlOption,
259
+ CreateBatchOrganizationAuthorizationUrlRequest,
258
260
  UsageDetail,
259
261
  ChannelCreateBatchCancelFlowUrlResponse,
260
262
  OperateChannelTemplateRequest,
@@ -286,28 +288,6 @@ export class Client extends TencentCloudCommon.AbstractClient {
286
288
  super("essbasic.tencentcloudapi.com", "2021-05-26", clientConfig)
287
289
  }
288
290
 
289
- /**
290
- * 此接口(ChannelDeleteSealPolicies)用于删除已指定员工印章授权信息,删除员工的印章授权后,该员工使用印章进行盖章时,将需要提交印章授权申请且通过审核后才能使用该印章进行签署。
291
- */
292
- async ChannelDeleteSealPolicies(
293
- req: ChannelDeleteSealPoliciesRequest,
294
- cb?: (error: string, rep: ChannelDeleteSealPoliciesResponse) => void
295
- ): Promise<ChannelDeleteSealPoliciesResponse> {
296
- return this.request("ChannelDeleteSealPolicies", req, cb)
297
- }
298
-
299
- /**
300
- * 给医疗个人自动签许可续期。续期成功后,可对医疗自动签许可追加一年有效期,只可续期一次。
301
-
302
- 注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
303
- */
304
- async ChannelRenewAutoSignLicense(
305
- req: ChannelRenewAutoSignLicenseRequest,
306
- cb?: (error: string, rep: ChannelRenewAutoSignLicenseResponse) => void
307
- ): Promise<ChannelRenewAutoSignLicenseResponse> {
308
- return this.request("ChannelRenewAutoSignLicense", req, cb)
309
- }
310
-
311
291
  /**
312
292
  * 提交企业流程审批结果
313
293
  **当前存在两种审核操作:**
@@ -333,53 +313,6 @@ export class Client extends TencentCloudCommon.AbstractClient {
333
313
  return this.request("ChannelCreateFlowSignReview", req, cb)
334
314
  }
335
315
 
336
- /**
337
- * 管理企业扩展服务
338
-
339
- - **直接开通的情形:** 若在操作过程中接口没有返回跳转链接,这表明无需进行任何跳转操作。此时,相应的企业拓展服务将会直接被开通或关闭。
340
-
341
- - **需要法人或者超管签署开通协议的情形:** 当需要开通以下企业拓展服务时, 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成服务的开通操作。
342
- - **AUTO_SIGN(企业自动签)**
343
- - **DOWNLOAD_FLOW(授权渠道下载合同)**
344
-
345
- 注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人`
346
-
347
-
348
- 对应的扩展服务能力可以在控制台的【扩展服务】中找到
349
- ![image](https://qcloudimg.tencent-cloud.cn/raw/99eebd37883ec55ed1f1df3a57aee60a.png)
350
- */
351
- async ModifyExtendedService(
352
- req: ModifyExtendedServiceRequest,
353
- cb?: (error: string, rep: ModifyExtendedServiceResponse) => void
354
- ): Promise<ModifyExtendedServiceResponse> {
355
- return this.request("ModifyExtendedService", req, cb)
356
- }
357
-
358
- /**
359
- * 此接口(ChannelCreateMultiFlowSignQRCode)用于创建一码多签签署码。
360
-
361
- **适用场景**:
362
- 签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
363
-
364
- **注意**:
365
- 1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**, 若是B2C模板,还要满足以下任意一个条件
366
- - 模板中配置的签署顺序是无序
367
- - B端企业的签署方式是静默签署
368
- - B端企业是非首位签署
369
- 2. 通过扫描一码多签签署码发起的合同,合同涉及到的回调消息可参考文档[合同发起及签署相关回调
370
- ]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
371
- 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)
372
-
373
- 签署码的样式如下图:
374
- ![image](https://qcloudimg.tencent-cloud.cn/raw/27317cf5aacb094fb1dc6f94179a5148.png )
375
- */
376
- async ChannelCreateMultiFlowSignQRCode(
377
- req: ChannelCreateMultiFlowSignQRCodeRequest,
378
- cb?: (error: string, rep: ChannelCreateMultiFlowSignQRCodeResponse) => void
379
- ): Promise<ChannelCreateMultiFlowSignQRCodeResponse> {
380
- return this.request("ChannelCreateMultiFlowSignQRCode", req, cb)
381
- }
382
-
383
316
  /**
384
317
  * 此接口(ChannelModifyRole)用来更新企业自定义角色。
385
318
 
@@ -395,89 +328,18 @@ export class Client extends TencentCloudCommon.AbstractClient {
395
328
  }
396
329
 
397
330
  /**
398
- * 接口(ChannelCreateFlowByFiles)用PDF文件创建签署流程。
399
-
400
- 适用场景:适用非制式的合同文件签署,开发者有每个签署流程的PDF,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
401
-
402
- **注**:
403
- <ul>
404
- <li>此接口静默签(企业自动签)能力为白名单功能,使用前请联系对接的客户经理沟通。</li>
405
- <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号(FileIds)进行使用。整体的逻辑如下图</li>
406
- </ul>
407
-
408
- ![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
409
-
410
- **可以作为发起方和签署方的角色列表**
411
- <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>
412
-
413
-
414
- **注**:
415
- `1. 发起合同时候, 作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
416
-
417
- `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
418
-
419
- `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(过期,拒签,签署完成,解除完成等状态不会返还额度)`
420
-
421
- `4. 静默(自动)签署不支持合同签署方存在填写功能`
422
-
423
- <font color="red">相关视频指引</font> <br>
424
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
425
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
426
- */
427
- async ChannelCreateFlowByFiles(
428
- req: ChannelCreateFlowByFilesRequest,
429
- cb?: (error: string, rep: ChannelCreateFlowByFilesResponse) => void
430
- ): Promise<ChannelCreateFlowByFilesResponse> {
431
- return this.request("ChannelCreateFlowByFiles", req, cb)
432
- }
433
-
434
- /**
435
- * 获取区块链存证证书查看链接/二维码接口
436
-
437
- 适用场景:企业员工可以通过此接口生成合同区块链存证证书的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
438
-
439
- [点击查看区块链存证证书样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
440
-
441
- 注:
442
- <ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
443
- <li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成证书查看二维码/短链。</li>
444
- <li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
445
- <li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证证书,请妥善保管好二维码或链接。</li></ul>
446
- */
447
- async CreateFlowBlockchainEvidenceUrl(
448
- req: CreateFlowBlockchainEvidenceUrlRequest,
449
- cb?: (error: string, rep: CreateFlowBlockchainEvidenceUrlResponse) => void
450
- ): Promise<CreateFlowBlockchainEvidenceUrlResponse> {
451
- return this.request("CreateFlowBlockchainEvidenceUrl", req, cb)
452
- }
453
-
454
- /**
455
- * 此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID,然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
456
- ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
457
-
458
-
459
- 注:
460
- `异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间`
461
- */
462
- async DescribeBatchOrganizationRegistrationUrls(
463
- req: DescribeBatchOrganizationRegistrationUrlsRequest,
464
- cb?: (error: string, rep: DescribeBatchOrganizationRegistrationUrlsResponse) => void
465
- ): Promise<DescribeBatchOrganizationRegistrationUrlsResponse> {
466
- return this.request("DescribeBatchOrganizationRegistrationUrls", req, cb)
467
- }
468
-
469
- /**
470
- * 1. 可以**通过图片**为子客企业代创建印章,图片最大5MB
471
-
472
- 2. 可以**系统创建**子客企业代创建印章, 系统创建的印章样子下图(样式可以调整)
331
+ * 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时,若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
332
+ - [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
333
+ - [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)
334
+ - [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo)
473
335
 
474
- ![image](https://dyn.ess.tencent.cn/guide/capi/CreateSealByImage.png)
336
+ 2. 同一合同组,同一签署人可以多次提交签署审批结果,签署时的最后一个“审批结果”有效。
475
337
  */
476
- async CreateSealByImage(
477
- req: CreateSealByImageRequest,
478
- cb?: (error: string, rep: CreateSealByImageResponse) => void
479
- ): Promise<CreateSealByImageResponse> {
480
- return this.request("CreateSealByImage", req, cb)
338
+ async CreateFlowGroupSignReview(
339
+ req: CreateFlowGroupSignReviewRequest,
340
+ cb?: (error: string, rep: CreateFlowGroupSignReviewResponse) => void
341
+ ): Promise<CreateFlowGroupSignReviewResponse> {
342
+ return this.request("CreateFlowGroupSignReview", req, cb)
481
343
  }
482
344
 
483
345
  /**
@@ -516,42 +378,18 @@ export class Client extends TencentCloudCommon.AbstractClient {
516
378
  }
517
379
 
518
380
  /**
519
- * 分页查询企业角色列表,法人的角色是系统保留角色,不会返回,按照角色创建时间升序排列。
520
-
521
-
522
- <font color="red">系统默认角色</font>说明可参考下表
523
-
524
- | 角色名称| 建议授予对象 | 角色描述 |
525
- | --- | --- | --- |
526
- | **超级管理员** |电子签业务最高权限,可以授权给法务/企业法人/业务负责人等 | 所有功能和数据管理权限,只能设置一位超管。 |
527
- | **业务管理员**|IT 系统负责人,可以授权给CTO等 | 企业合同模块、印章模块、模板模块等全量功能及数据权限。 |
528
- | **经办人**|企业法务负责人等 | 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看企业所有合同数据。 |
529
- | **业务员**|销售员、采购员 等| 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看自己相关所有合同数据。 |
381
+ * 此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID,然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
382
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
530
383
 
531
- 附件:<a href="https://dyn.ess.tencent.cn/guide/apivideo/roles.xlsx" target="_blank">点击下载角色对应的权限点的excel文档</a>
532
- */
533
- async ChannelDescribeRoles(
534
- req: ChannelDescribeRolesRequest,
535
- cb?: (error: string, rep: ChannelDescribeRolesResponse) => void
536
- ): Promise<ChannelDescribeRolesResponse> {
537
- return this.request("ChannelDescribeRoles", req, cb)
538
- }
539
384
 
540
- /**
541
- * 此接口(ChannelCreateConvertTaskApi)用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
542
- 前提条件:源文件已经通过 <a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>完成上传,并得到了源文件的资源Id。<br />
543
- 适用场景1:已经上传了一个word文件,希望将该word文件转换成pdf文件后发起合同
544
- 适用场景2:已经上传了一个jpg图片文件,希望将该图片文件转换成pdf文件后发起合同<br />
545
- 转换文件是一个耗时操作,若想查看转换任务是否完成,可以通过<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelGetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
546
- 注:
547
- 1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
548
- 2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
385
+ 注:
386
+ `异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间`
549
387
  */
550
- async ChannelCreateConvertTaskApi(
551
- req: ChannelCreateConvertTaskApiRequest,
552
- cb?: (error: string, rep: ChannelCreateConvertTaskApiResponse) => void
553
- ): Promise<ChannelCreateConvertTaskApiResponse> {
554
- return this.request("ChannelCreateConvertTaskApi", req, cb)
388
+ async DescribeBatchOrganizationRegistrationUrls(
389
+ req: DescribeBatchOrganizationRegistrationUrlsRequest,
390
+ cb?: (error: string, rep: DescribeBatchOrganizationRegistrationUrlsResponse) => void
391
+ ): Promise<DescribeBatchOrganizationRegistrationUrlsResponse> {
392
+ return this.request("DescribeBatchOrganizationRegistrationUrls", req, cb)
555
393
  }
556
394
 
557
395
  /**
@@ -569,462 +407,432 @@ export class Client extends TencentCloudCommon.AbstractClient {
569
407
  }
570
408
 
571
409
  /**
572
- * 查询企业扩展服务的授权详情(列表),当前支持查询以下内容:
573
-
574
- 1. **企业自动签**
575
- 2. **批量签署**
410
+ * 该接口用于在使用视频认证方式签署合同后,获取用户的签署人脸认证视频。
576
411
 
412
+ 1. 该接口**仅适用于在H5端签署**的合同,**在通过视频认证后**获取认证的视频内容。
413
+ 2. 该接口**不支持小程序端**的签署认证的视频获取。
414
+ 3. 请在**签署完成后的三天内**获取视频,**过期后将无法获取**。
577
415
 
578
- 注: <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
416
+ **注意:该接口需要开通白名单,请联系客户经理开通后使用。**
579
417
  */
580
- async DescribeExtendedServiceAuthDetail(
581
- req: DescribeExtendedServiceAuthDetailRequest,
582
- cb?: (error: string, rep: DescribeExtendedServiceAuthDetailResponse) => void
583
- ): Promise<DescribeExtendedServiceAuthDetailResponse> {
584
- return this.request("DescribeExtendedServiceAuthDetail", req, cb)
418
+ async ChannelDescribeSignFaceVideo(
419
+ req: ChannelDescribeSignFaceVideoRequest,
420
+ cb?: (error: string, rep: ChannelDescribeSignFaceVideoResponse) => void
421
+ ): Promise<ChannelDescribeSignFaceVideoResponse> {
422
+ return this.request("ChannelDescribeSignFaceVideo", req, cb)
585
423
  }
586
424
 
587
425
  /**
588
- * 在已启动的签署流程中,可对签署截止日期进行延期操作,主要分为以下两个层面:
589
- 1. <b> 合同(流程)层面</b>:仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
590
- 2. <b> 签署人层面</b> :需提供流程ID和签署人ID。此操作针对特定签署人进行延期,特别是对于有序合同(流程),签署截止时间不得超过后续签署人的流程截止时间。
591
-
592
- 此接口存在以下限制:
593
- 1. 执行操作的员工须为<font color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
594
- 2. 延长整个签署流程时,<font color="red">应至少有一方尚未签署</font>(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
595
- 3. 延长整个签署流程时,新的签署截止日期应晚于已设定的签署截止日期和当前日期。
596
- 4. 延长签署方截止时间时,<font color="red">签署方不能处于流程完结或已终止状态</font>(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
597
- 5. 延长签署方截止时间时,新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同,还需早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
598
- 6. <font color="red">不支持操作合同组合同</font>。
426
+ * 通过此接口,删除员工绑定的角色,支持以电子签userId、客户系统userId两种方式调用。
599
427
 
600
- 合同(流程)层面截止时间子企业控制台展示的位置:
601
- ![image](https://qcloudimg.tencent-cloud.cn/raw/f0f88c0eb49a926da9a86e5a6e9efa8b.png)
428
+ 对应控制台的操作如下图
429
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/5b41194d3cb3f2058ec0ba0fb5ebc6a6.png)
602
430
  */
603
- async ModifyFlowDeadline(
604
- req: ModifyFlowDeadlineRequest,
605
- cb?: (error: string, rep: ModifyFlowDeadlineResponse) => void
606
- ): Promise<ModifyFlowDeadlineResponse> {
607
- return this.request("ModifyFlowDeadline", req, cb)
431
+ async ChannelDeleteRoleUsers(
432
+ req: ChannelDeleteRoleUsersRequest,
433
+ cb?: (error: string, rep: ChannelDeleteRoleUsersResponse) => void
434
+ ): Promise<ChannelDeleteRoleUsersResponse> {
435
+ return this.request("ChannelDeleteRoleUsers", req, cb)
608
436
  }
609
437
 
610
438
  /**
611
- * 撤销签署流程接口
612
-
613
- 适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
439
+ * 创建跳转小程序查看或签署的链接
614
440
 
615
- - **可撤回合同状态**:未全部签署完成
616
- - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
441
+ **腾讯电子签小程序的AppID 和 原始Id如下:**
617
442
 
618
- 注:
619
- - 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
620
- - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
621
- - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
622
- - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
443
+ | 小程序 | AppID | 原始ID |
444
+ | ------------ | ------------ | ------------ |
445
+ | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
446
+ | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
447
+
448
+ **主要使用场景EndPoint分类**
449
+
450
+ |EndPoint| 场景| 说明和示例|
451
+ | ---- | ---- | --- |
452
+ | WEIXINAPP | 短链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序(与腾讯电子签官方短信提醒用户签署形式一样)<br> 示例: https://essurl.cn/x9nvWU8fTg|
453
+ | LONGURL2WEIXINAPP | 长链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
454
+ | 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 |
455
+ |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 |
456
+ |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 |
623
457
  */
624
- async ChannelCancelFlow(
625
- req: ChannelCancelFlowRequest,
626
- cb?: (error: string, rep: ChannelCancelFlowResponse) => void
627
- ): Promise<ChannelCancelFlowResponse> {
628
- return this.request("ChannelCancelFlow", req, cb)
458
+ async CreateSignUrls(
459
+ req: CreateSignUrlsRequest,
460
+ cb?: (error: string, rep: CreateSignUrlsResponse) => void
461
+ ): Promise<CreateSignUrlsResponse> {
462
+ return this.request("CreateSignUrls", req, cb)
629
463
  }
630
464
 
631
465
  /**
632
- * 通过此接口,可以创建企业批量签署链接,员工只需点击链接即可跳转至控制台进行批量签署。
466
+ * 此接口(ChannelCreateBoundFlows)用于子客企业领取未归属给员工的合同,将合同领取给当前员工,合同不能重复领取。
633
467
 
634
- 注:
635
- - 员工必须在企业下完成实名认证,且需作为批量签署合同的签署方或者领取方。
636
- - 仅支持传入待签署或者待领取的合同,待填写暂不支持。
637
- - 员工批量签署,支持多种签名方式,包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
638
468
 
639
- 签署的嵌入页面长相如下:
640
- ![image](https://qcloudimg.tencent-cloud.cn/raw/a4754bc835a3f837ddec1e28b02ed9c0.png)
469
+ **未归属合同发起方式**
470
+ 指定对应企业的OrganizationOpenId和OrganizationName而不指定具体的参与人(OpenId/名字/手机号等), 则合同进入待领取状态, 示例代码如下
471
+ ```
472
+ FlowApprovers: []*essbasic.FlowApproverInfo{
473
+ {
474
+ ApproverType: common.StringPtr("ORGANIZATION"),
475
+ OrganizationOpenId: common.StringPtr("org_dianziqian"),
476
+ OrganizationName: common.StringPtr("典子谦示例企业"),
477
+ }
478
+ },
479
+ ```
480
+
481
+ 可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
482
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/a34d0cc56ec871613e94dfc6252bc072.png)
483
+
484
+ 注:
485
+ 1. 支持批量领取, 如果有一个合同流程无法领取会导致接口报错, 使得所有合同都领取失败
486
+ 2. 只有企业的<font color="red">超管或者法人</font>才能进行合同的领取
641
487
  */
642
- async ChannelCreateOrganizationBatchSignUrl(
643
- req: ChannelCreateOrganizationBatchSignUrlRequest,
644
- cb?: (error: string, rep: ChannelCreateOrganizationBatchSignUrlResponse) => void
645
- ): Promise<ChannelCreateOrganizationBatchSignUrlResponse> {
646
- return this.request("ChannelCreateOrganizationBatchSignUrl", req, cb)
488
+ async ChannelCreateBoundFlows(
489
+ req: ChannelCreateBoundFlowsRequest,
490
+ cb?: (error: string, rep: ChannelCreateBoundFlowsResponse) => void
491
+ ): Promise<ChannelCreateBoundFlowsResponse> {
492
+ return this.request("ChannelCreateBoundFlows", req, cb)
647
493
  }
648
494
 
649
495
  /**
650
- * 通过接口[批量撤销合同流程](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelBatchCancelFlows)或者[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateBatchCancelFlowUrl)发起批量撤销任务后,可通过此接口查询批量撤销任务的结果。
651
- */
652
- async DescribeCancelFlowsTask(
653
- req: DescribeCancelFlowsTaskRequest,
654
- cb?: (error: string, rep: DescribeCancelFlowsTaskResponse) => void
655
- ): Promise<DescribeCancelFlowsTaskResponse> {
656
- return this.request("DescribeCancelFlowsTask", req, cb)
657
- }
496
+ * 创建一个用于他方自动签授权的链接(可选择他方授权或我方授权)。通过这个链接,合作方企业可以直接进入小程序,进行自动签授权操作。
658
497
 
659
- /**
660
- * 将指定印章授权给第三方平台子客企业下的某些员工
661
- */
662
- async ChannelCreateSealPolicy(
663
- req: ChannelCreateSealPolicyRequest,
664
- cb?: (error: string, rep: ChannelCreateSealPolicyResponse) => void
665
- ): Promise<ChannelCreateSealPolicyResponse> {
666
- return this.request("ChannelCreateSealPolicy", req, cb)
498
+ 如果授权企业尚未开通企业自动签功能,该链接还将引导他们首先开通本企业的自动签服务
499
+
500
+
501
+ 注:
502
+ 1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
503
+ 2. 已经在授权中或者授权成功的企业,无法重复授权
504
+ 3. 授权企业和被授权企业必须都是已认证企业
505
+ 4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
506
+
507
+ **该接口效果同控制台: 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
508
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/091823fd4f02af7dda416fa10ca65f2d.png)
509
+ */
510
+ async CreatePartnerAutoSignAuthUrl(
511
+ req: CreatePartnerAutoSignAuthUrlRequest,
512
+ cb?: (error: string, rep: CreatePartnerAutoSignAuthUrlResponse) => void
513
+ ): Promise<CreatePartnerAutoSignAuthUrlResponse> {
514
+ return this.request("CreatePartnerAutoSignAuthUrl", req, cb)
667
515
  }
668
516
 
669
517
  /**
670
- * 该接口用于发起合同后,生成个人/企业用户的批量待办链接。
671
- **注意:**
672
- 1. 该接口可生成签署人的批量、合同组签署/查看链接 。
673
- 2. 该签署链接**有效期为30分钟**,过期后将失效,如需签署可重新创建批量签署链接 。
674
- 4. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
675
- 跳转到小程序的实现,参考微信官方文档(分为<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>。
676
- 6. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
518
+ * 用来创建嵌入式页面个性化主题配置(例如是否展示电子签logo、定义主题色等),该接口配合其他所有可嵌入页面接口使用
519
+ 创建配置对当前第三方应用全局生效,如果多次调用,会以最后一次的配置为准
677
520
  */
678
- async ChannelCreateBatchQuickSignUrl(
679
- req: ChannelCreateBatchQuickSignUrlRequest,
680
- cb?: (error: string, rep: ChannelCreateBatchQuickSignUrlResponse) => void
681
- ): Promise<ChannelCreateBatchQuickSignUrlResponse> {
682
- return this.request("ChannelCreateBatchQuickSignUrl", req, cb)
521
+ async ChannelCreateWebThemeConfig(
522
+ req: ChannelCreateWebThemeConfigRequest,
523
+ cb?: (error: string, rep: ChannelCreateWebThemeConfigResponse) => void
524
+ ): Promise<ChannelCreateWebThemeConfigResponse> {
525
+ return this.request("ChannelCreateWebThemeConfig", req, cb)
683
526
  }
684
527
 
685
528
  /**
686
- * 接口(CreateFlowsByTemplates)用于使用模板批量创建签署流程。当前可批量发起合同(签署流程)数量为1-20个。
687
- 如若在模板中配置了动态表格, 上传的附件必须为A4大小
688
- 合同发起人必须在电子签已经进行实名。
529
+ * 指定需要批量催办的签署流程ID,批量催办合同,最多100个。需要符合以下条件的合同才可被催办
530
+ 1. 合同中当前状态为 **待签署** 的签署人是催办的对象
531
+ 2. **每个合同只能催办一次**
689
532
 
690
- ### 一. 整体的逻辑如下
533
+ **催办的效果**: 对方会收到如下的短信通知
691
534
 
692
- ![image](https://qcloudimg.tencent-cloud.cn/raw/e193519d4383fa74782a9e19147ef01a/CreateFlowsByTemplates.png)
535
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/3caf94b7f540fa5736270d38528d3a7b.png)
693
536
 
694
- ### 二. 可以作为发起方和签署方的角色列表
695
537
 
696
- <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>
538
+ **注**:`合同催办是白名单功能,请联系客户经理申请开白后使用`
539
+ */
540
+ async ChannelCreateFlowReminds(
541
+ req: ChannelCreateFlowRemindsRequest,
542
+ cb?: (error: string, rep: ChannelCreateFlowRemindsResponse) => void
543
+ ): Promise<ChannelCreateFlowRemindsResponse> {
544
+ return this.request("ChannelCreateFlowReminds", req, cb)
545
+ }
697
546
 
547
+ /**
548
+ * 通过合同编号批量撤销合同,单次最多支持撤销100份合同。
698
549
 
550
+ 适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
699
551
 
552
+ - **可撤回合同状态**:未全部签署完成
553
+ - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
700
554
 
701
- ### 三. 填充模板中定义的填写控件
702
- 模板中配置的<font color="red">发起人填充控件</font>可以通过本接口的**FormFields数组**字段填充
555
+ 批量撤销结果可以通过接口返回的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)主动查询。
703
556
 
704
- ![image](https://qcloudimg.tencent-cloud.cn/raw/37457e0e450fc221effddfcb8b1bad55.png)
705
- 填充的传参示例如下
706
557
 
707
- ```
708
- request.FormFields = [{
709
- "ComponentName": "项目的名字",
710
- "ComponentValue": "休闲山庄"
711
- }, {
712
- "ComponentName": "项目的地址",
713
- "ComponentValue": "凤凰山北侧",
714
- }, {
715
- "ComponentName": "范围",
716
- "ComponentValue": "凤凰山至107国道",
717
- }, {
718
- "ComponentName": "面积",
719
- "ComponentValue": "100亩",
720
- }, {
721
- "ComponentName": "基本情况",
722
- "ComponentValue": "完好",
723
- }, , {
724
- "ComponentName": "用途",
725
- "ComponentValue": "经营农家乐",
726
- }
727
- ]
728
- ```
729
- 合成后合同样子示例
558
+ 注:
559
+ - 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
560
+ - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
561
+ - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
562
+ - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
563
+ */
564
+ async ChannelBatchCancelFlows(
565
+ req: ChannelBatchCancelFlowsRequest,
566
+ cb?: (error: string, rep: ChannelBatchCancelFlowsResponse) => void
567
+ ): Promise<ChannelBatchCancelFlowsResponse> {
568
+ return this.request("ChannelBatchCancelFlows", req, cb)
569
+ }
730
570
 
731
- ![image](https://qcloudimg.tencent-cloud.cn/raw/140a2fb771ac66a185d0a000d37485f6.png)
571
+ /**
572
+ * **适用场景**:
573
+ 当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口动态补充签署人。同一签署人只允许补充一人,最终实际签署人取决于谁先领取合同完成签署。
732
574
 
575
+ **接口使用说明**:
733
576
 
577
+ 1.本接口现已支持批量补充签署人
734
578
 
735
- ### 四. 注意
736
- 1. 发起合同时候, 作为<font color="red">发起方的第三方子企业A员工的企业和员工必须经过实名</font>, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名
579
+ 2.当<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中指定需要补充的FlowId时,可以对指定合同补充签署人;可以指定多个相同发起方的不同合同在完成批量补充
737
580
 
738
- 2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明
581
+ 3.当<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中指定需要补充的FlowId时,是对指定的合同补充多个指定的签署人
739
582
 
740
- 3. <font color="red">调用接口发起合同成功就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(过期,拒签,签署完成,解除完成等状态不会返还额度)
583
+ 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作为补充的合同
741
584
 
742
- 4. <font color="red">静默(自动)签署不支持合同签署方存在填写</font>
585
+ 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作为补充的合同
743
586
 
744
- 5. <font color="red">在下一步创建签署链接前,建议等待DocumentFill </font> <a href="https://qian.tencent.com/developers/partner/callback_types_file_resources">PDF合成完成的回调</a>或者睡眠几秒,尤其是当模板中存在动态表格等复杂填写控件时,因为合成过程可能会耗费秒级别的时间。
745
587
 
588
+ 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,则传参错误
746
589
 
747
- <font color="red">相关视频指引</font> <br>
748
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
749
- 2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateFlowsByTemplates.mp4" target="_blank">【用模板创建签署流程】编写示例视频教程</a><br>
590
+ **限制条件**:
591
+ 1. 本企业(发起方企业)企业签署人仅支持通过企业名称+姓名+手机号进行补充。
592
+ 2. 个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
750
593
  */
751
- async CreateFlowsByTemplates(
752
- req: CreateFlowsByTemplatesRequest,
753
- cb?: (error: string, rep: CreateFlowsByTemplatesResponse) => void
754
- ): Promise<CreateFlowsByTemplatesResponse> {
755
- return this.request("CreateFlowsByTemplates", req, cb)
594
+ async ChannelCreateFlowApprovers(
595
+ req: ChannelCreateFlowApproversRequest,
596
+ cb?: (error: string, rep: ChannelCreateFlowApproversResponse) => void
597
+ ): Promise<ChannelCreateFlowApproversResponse> {
598
+ return this.request("ChannelCreateFlowApprovers", req, cb)
756
599
  }
757
600
 
758
601
  /**
759
- * 通过此接口可以关闭个人用户自动签功能。
760
- 无需对应的用户刷脸等方式同意即可关闭。
602
+ * 获取个人用户认证证书图片下载URL
761
603
 
762
- 注意:
604
+ 个人用户认证证书图片样式如下图
763
605
 
764
- <ul><li>处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。</li>
765
- <li>如果此用户在开通时候绑定过个人自动签账号许可, 关闭此用户的自动签不会归还个人自动签账号许可的额度。</li></ul>
606
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/d568bc0f101bef582f7af2cb5ab7a715.png)
607
+
608
+ 注:
609
+ <ul>
610
+ <li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
611
+ <li>专为电子处方单(医疗自动签)特定场景使用。在使用前,请务必与您的客户经理联系以确认已经开通电子处方单功能 </li>
612
+ </ul>
766
613
  */
767
- async ChannelDisableUserAutoSign(
768
- req: ChannelDisableUserAutoSignRequest,
769
- cb?: (error: string, rep: ChannelDisableUserAutoSignResponse) => void
770
- ): Promise<ChannelDisableUserAutoSignResponse> {
771
- return this.request("ChannelDisableUserAutoSign", req, cb)
614
+ async CreatePersonAuthCertificateImage(
615
+ req: CreatePersonAuthCertificateImageRequest,
616
+ cb?: (error: string, rep: CreatePersonAuthCertificateImageResponse) => void
617
+ ): Promise<CreatePersonAuthCertificateImageResponse> {
618
+ return this.request("CreatePersonAuthCertificateImage", req, cb)
772
619
  }
773
620
 
774
621
  /**
775
- * 该接口用于在使用视频认证方式签署合同后,获取用户的签署人脸认证视频。
622
+ * 提交申请出证报告任务并返回报告ID。
776
623
 
777
- 1. 该接口**仅适用于在H5端签署**的合同,**在通过视频认证后**获取认证的视频内容。
778
- 2. 该接口**不支持小程序端**的签署认证的视频获取。
779
- 3. 请在**签署完成后的三天内**获取视频,**过期后将无法获取**。
624
+ 注意:
625
+ - 使用此功能**需搭配出证套餐** ,使用前请联系对接的客户经理沟通。
626
+ - 操作人必须是**发起方或者签署方企业的(非走授权书认证)法人或者超管**。
627
+ - 合同流程必须**所有参与方已经签署完成**。
628
+ - 出证过程需一定时间,建议在**提交出证任务后的24小时之后**,通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
780
629
 
781
- **注意:该接口需要开通白名单,请联系客户经理开通后使用。**
630
+
631
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
782
632
  */
783
- async ChannelDescribeSignFaceVideo(
784
- req: ChannelDescribeSignFaceVideoRequest,
785
- cb?: (error: string, rep: ChannelDescribeSignFaceVideoResponse) => void
786
- ): Promise<ChannelDescribeSignFaceVideoResponse> {
787
- return this.request("ChannelDescribeSignFaceVideo", req, cb)
633
+ async CreateChannelFlowEvidenceReport(
634
+ req: CreateChannelFlowEvidenceReportRequest,
635
+ cb?: (error: string, rep: CreateChannelFlowEvidenceReportResponse) => void
636
+ ): Promise<CreateChannelFlowEvidenceReportResponse> {
637
+ return this.request("CreateChannelFlowEvidenceReport", req, cb)
788
638
  }
789
639
 
790
640
  /**
791
- * 此接口查询子企业电子印章。<br />
792
-
793
- 注:
794
- 1. 此操作要求操作者具备<b>印章查询权限</b>(若调用者尚无此权限,请联系超级管理员前往Web控制台【组织管理】->【角色管理】添加相应权限)。
795
- */
796
- async ChannelDescribeOrganizationSeals(
797
- req: ChannelDescribeOrganizationSealsRequest,
798
- cb?: (error: string, rep: ChannelDescribeOrganizationSealsResponse) => void
799
- ): Promise<ChannelDescribeOrganizationSealsResponse> {
800
- return this.request("ChannelDescribeOrganizationSeals", req, cb)
641
+ * 本接口(ChannelCreatePreparedPersonalEsign)用于创建导入个人印章(处方单场景专用,使用此接口请与客户经理确认)。
642
+ */
643
+ async ChannelCreatePreparedPersonalEsign(
644
+ req: ChannelCreatePreparedPersonalEsignRequest,
645
+ cb?: (error: string, rep: ChannelCreatePreparedPersonalEsignResponse) => void
646
+ ): Promise<ChannelCreatePreparedPersonalEsignResponse> {
647
+ return this.request("ChannelCreatePreparedPersonalEsign", req, cb)
801
648
  }
802
649
 
803
650
  /**
804
- * 此接口(SyncProxyOrganization)用于同步第三方平台子客企业信息,包括企业名称、企业营业执照、企业统一社会信用代码和法人姓名等,便于子客企业在企业激活过程中无需手动上传营业执照或补充企业信息。
805
-
806
- 注意:
651
+ * 接口(ChannelCreateFlowByFiles)用PDF文件创建签署流程。
807
652
 
808
- - **需要在<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>前同步的企业信息**, 否则会出现信息同步没有用的情形
809
- - **企业信息需要和营业执照信息对应**, 否则会出现激活过程验证不通过的问题
653
+ 适用场景:适用非制式的合同文件签署,开发者有每个签署流程的PDF,可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
810
654
 
811
- ![image](https://qcloudimg.tencent-cloud.cn/raw/7ec91b79a0a4860e77c9ff9f4a5f13ad/channel_SyncProxyOrganization2.png)
655
+ **注**:
656
+ <ul>
657
+ <li>此接口静默签(企业自动签)能力为白名单功能,使用前请联系对接的客户经理沟通。</li>
658
+ <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号(FileIds)进行使用。整体的逻辑如下图</li>
659
+ </ul>
812
660
 
661
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
813
662
 
814
- - **企业统一社会信用代码**: 对应上图中的**1**
815
- - **第三方平台子客企业名称**: 对应上图中的**2**
816
- - **企业法定代表人的名字**:对应上图中的**3**
817
- - **企业详细住所**:对应上图中的**4**
818
- */
819
- async SyncProxyOrganization(
820
- req: SyncProxyOrganizationRequest,
821
- cb?: (error: string, rep: SyncProxyOrganizationResponse) => void
822
- ): Promise<SyncProxyOrganizationResponse> {
823
- return this.request("SyncProxyOrganization", req, cb)
824
- }
663
+ **可以作为发起方和签署方的角色列表**
664
+ <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>
825
665
 
826
- /**
827
- * 通过此接口,删除员工绑定的角色,支持以电子签userId、客户系统userId两种方式调用。
828
666
 
829
- 对应控制台的操作如下图
830
- ![image](https://qcloudimg.tencent-cloud.cn/raw/5b41194d3cb3f2058ec0ba0fb5ebc6a6.png)
831
- */
832
- async ChannelDeleteRoleUsers(
833
- req: ChannelDeleteRoleUsersRequest,
834
- cb?: (error: string, rep: ChannelDeleteRoleUsersResponse) => void
835
- ): Promise<ChannelDeleteRoleUsersResponse> {
836
- return this.request("ChannelDeleteRoleUsers", req, cb)
837
- }
667
+ **注**:
668
+ `1. 发起合同时候, 作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
838
669
 
839
- /**
840
- * 通过此接口(DescribeTemplates)查询该第三方平台子客企业在电子签拥有的有效模板,不包括第三方平台模板。
670
+ `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
841
671
 
842
- **适用场景**
843
- 该接口常用来配合<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>接口,作为创建合同的前置接口使用。
844
- 通过此接口查询到模板信息后,再通过调用创建合同的接口,指定模板ID,指定模板中需要的填写控件内容等,完成合同文档的创建。
672
+ `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(过期,拒签,签署完成,解除完成等状态不会返还额度)`
845
673
 
846
- **模板的来源**
847
- 子客企业的模板有两种途径获取
848
- - 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
849
- - 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
674
+ `4. 静默(自动)签署不支持合同签署方存在填写功能`
850
675
 
851
- **一个模板通常会包含以下结构信息**
676
+ <font color="red">相关视频指引</font> <br>
677
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
678
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
679
+ */
680
+ async ChannelCreateFlowByFiles(
681
+ req: ChannelCreateFlowByFilesRequest,
682
+ cb?: (error: string, rep: ChannelCreateFlowByFilesResponse) => void
683
+ ): Promise<ChannelCreateFlowByFilesResponse> {
684
+ return this.request("ChannelCreateFlowByFiles", req, cb)
685
+ }
852
686
 
853
- - 模板ID, 模板名字等基本信息
854
- - 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
855
- - 发起方和签署方的填写控件 Components
856
- - 签署方的签署控件 SignComponents
687
+ /**
688
+ * 1. 可以**通过图片**为子客企业代创建印章,图片最大5MB
857
689
 
858
- ![image](https://qcloudimg.tencent-cloud.cn/raw/ab81fa948a0a6fea14f48cac91d0e36a/channel_DescribeTemplates.png)
690
+ 2. 可以**系统创建**子客企业代创建印章, 系统创建的印章样子下图(样式可以调整)
859
691
 
860
- 模板中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
692
+ ![image](https://dyn.ess.tencent.cn/guide/capi/CreateSealByImage.png)
693
+ */
694
+ async CreateSealByImage(
695
+ req: CreateSealByImageRequest,
696
+ cb?: (error: string, rep: CreateSealByImageResponse) => void
697
+ ): Promise<CreateSealByImageResponse> {
698
+ return this.request("CreateSealByImage", req, cb)
699
+ }
861
700
 
862
- ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
701
+ /**
702
+ * 此接口(ChannelCreateConvertTaskApi)用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
703
+ 前提条件:源文件已经通过 <a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>完成上传,并得到了源文件的资源Id。<br />
704
+ 适用场景1:已经上传了一个word文件,希望将该word文件转换成pdf文件后发起合同
705
+ 适用场景2:已经上传了一个jpg图片文件,希望将该图片文件转换成pdf文件后发起合同<br />
706
+ 转换文件是一个耗时操作,若想查看转换任务是否完成,可以通过<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelGetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
707
+ 注:
708
+ 1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
709
+ 2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
710
+ */
711
+ async ChannelCreateConvertTaskApi(
712
+ req: ChannelCreateConvertTaskApiRequest,
713
+ cb?: (error: string, rep: ChannelCreateConvertTaskApiResponse) => void
714
+ ): Promise<ChannelCreateConvertTaskApiResponse> {
715
+ return this.request("ChannelCreateConvertTaskApi", req, cb)
716
+ }
863
717
 
718
+ /**
719
+ * 撤销签署流程接口
864
720
 
865
- **注意**
721
+ 适用场景:如果某个合同流程当前至少还有一方没有签署,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
866
722
 
867
- >1. 查询条件TemplateId、TemplateName与ChannelTemplateId可同时存在,即可查询同时满足这些条件的模板。
868
- >2. TemplateId 和TemplateIds互为独立,若两个参数都传入,则以TemplateId为准
723
+ - **可撤回合同状态**:未全部签署完成
724
+ - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
869
725
 
870
- <font color="red">相关视频指引</font> <br>
871
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
726
+ 注:
727
+ - 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
728
+ - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
729
+ - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
730
+ - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
872
731
  */
873
- async DescribeTemplates(
874
- req: DescribeTemplatesRequest,
875
- cb?: (error: string, rep: DescribeTemplatesResponse) => void
876
- ): Promise<DescribeTemplatesResponse> {
877
- return this.request("DescribeTemplates", req, cb)
732
+ async ChannelCancelFlow(
733
+ req: ChannelCancelFlowRequest,
734
+ cb?: (error: string, rep: ChannelCancelFlowResponse) => void
735
+ ): Promise<ChannelCancelFlowResponse> {
736
+ return this.request("ChannelCancelFlow", req, cb)
878
737
  }
879
738
 
880
739
  /**
881
- * 该接口用于批量创建企业认证链接, 可以支持PC浏览器,H5和小程序三种途径。
882
- 此接口为异步提交任务接口,需要与[查询子企业批量认证链接](https://qcloudimg.tencent-cloud.cn/raw/1d3737991b2a3be78002bd78a47d6917.png)配合使用,整体流程如下图。
883
- ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
884
-
740
+ * 接口(CreateFlowsByTemplates)用于使用模板批量创建签署流程。当前可批量发起合同(签署流程)数量为1-20个。
741
+ 如若在模板中配置了动态表格, 上传的附件必须为A4大小
742
+ 合同发起人必须在电子签已经进行实名。
885
743
 
744
+ ### 一. 整体的逻辑如下
886
745
 
887
- **注意**
746
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/e193519d4383fa74782a9e19147ef01a/CreateFlowsByTemplates.png)
888
747
 
889
- 1. 单次最多创建10个子企业。
890
- 2. 一天内,同一家企业最多创建8000个子企业。
891
- 3. 同一批创建的子客户不能重复,包括企业名称、企业统一信用代码和子客户经办人openId。
892
- 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>。
748
+ ### 二. 可以作为发起方和签署方的角色列表
893
749
 
750
+ <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>
894
751
 
895
752
 
896
- **腾讯电子签小程序的AppID 和 原始Id如下:**
897
753
 
898
- | 小程序 | AppID | 原始ID |
899
- | ------------ | ------------ | ------------ |
900
- | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
901
- | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
902
- */
903
- async CreateBatchOrganizationRegistrationTasks(
904
- req: CreateBatchOrganizationRegistrationTasksRequest,
905
- cb?: (error: string, rep: CreateBatchOrganizationRegistrationTasksResponse) => void
906
- ): Promise<CreateBatchOrganizationRegistrationTasksResponse> {
907
- return this.request("CreateBatchOrganizationRegistrationTasks", req, cb)
908
- }
909
754
 
910
- /**
911
- * 激活或续期子客企业, 在激活状态下,企业可以正常发起合同;在非激活状态下,企业仅能查看和签署合同。
755
+ ### 三. 填充模板中定义的填写控件
756
+ 模板中配置的<font color="red">发起人填充控件</font>可以通过本接口的**FormFields数组**字段填充
912
757
 
913
- **1. 激活**:使用一个许可证将子客企业从未激活状态转变为激活状态。**激活状态的有效期为一年,一年后将自动回到未激活状态**。
758
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/37457e0e450fc221effddfcb8b1bad55.png)
759
+ 填充的传参示例如下
914
760
 
915
- **2. 续期**:使用一个许可证将已激活的子客企业的有效期延长一年。只有处于激活状态的子企业才能进行续期操作(**若处于非激活状态,则需先激活**)。您可以使用多个许可证对同一子客企业进行多次续费。
761
+ ```
762
+ request.FormFields = [{
763
+ "ComponentName": "项目的名字",
764
+ "ComponentValue": "休闲山庄"
765
+ }, {
766
+ "ComponentName": "项目的地址",
767
+ "ComponentValue": "凤凰山北侧",
768
+ }, {
769
+ "ComponentName": "范围",
770
+ "ComponentValue": "凤凰山至107国道",
771
+ }, {
772
+ "ComponentName": "面积",
773
+ "ComponentValue": "100亩",
774
+ }, {
775
+ "ComponentName": "基本情况",
776
+ "ComponentValue": "完好",
777
+ }, , {
778
+ "ComponentName": "用途",
779
+ "ComponentValue": "经营农家乐",
780
+ }
781
+ ]
782
+ ```
783
+ 合成后合同样子示例
916
784
 
785
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/140a2fb771ac66a185d0a000d37485f6.png)
917
786
 
918
- 该接口的效果同:**【企业应用管理】 -> 【子客企业管理】 -> 【激活】或者【续期】**
919
787
 
920
- ![image](https://qcloudimg.tencent-cloud.cn/raw/cd63761ca6e814c64b4ecf131555b74e.png)
921
788
 
789
+ ### 四. 注意
790
+ 1. 发起合同时候, 作为<font color="red">发起方的第三方子企业A员工的企业和员工必须经过实名</font>, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名
922
791
 
923
- 如果不想调用此接口或者页面点击进行激活或续期,可以在【应用扩展服务】中打开自动激活或续期,在许可证充足的情况下会自动激活或续期子客企业
792
+ 2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明
924
793
 
925
- ![image](https://qcloudimg.tencent-cloud.cn/raw/2ccb37ef6bde463c15c39fdda789216f.png)
926
- */
927
- async CreateChannelSubOrganizationActive(
928
- req: CreateChannelSubOrganizationActiveRequest,
929
- cb?: (error: string, rep: CreateChannelSubOrganizationActiveResponse) => void
930
- ): Promise<CreateChannelSubOrganizationActiveResponse> {
931
- return this.request("CreateChannelSubOrganizationActive", req, cb)
932
- }
794
+ 3. <font color="red">调用接口发起合同成功就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。(过期,拒签,签署完成,解除完成等状态不会返还额度)
933
795
 
934
- /**
935
- * 此接口(UploadFiles)文件上传。<br/>
796
+ 4. <font color="red">静默(自动)签署不支持合同签署方存在填写</font>
936
797
 
937
- 适用场景:用于合同,印章的文件上传。文件上传以后,
938
- 如果是PDF格式文件可配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>接口进行合同流程的发起
939
- 如果是其他类型可以配合<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务</a>接口转换成PDF文件
798
+ 5. <font color="red">在下一步创建签署链接前,建议等待DocumentFill </font> <a href="https://qian.tencent.com/developers/partner/callback_types_file_resources">PDF合成完成的回调</a>或者睡眠几秒,尤其是当模板中存在动态表格等复杂填写控件时,因为合成过程可能会耗费秒级别的时间。
940
799
 
941
- 注:
942
- 1. 图片类型(png/jpg/jpeg)限制大小为5M以下, PDF/word/excel等其他格式限制大小为60M以下
943
- 2. <font color='red'>此接口调用时需要单独设置Domain请求域名 </font>, 联调开发环境为 <font color='red'>file.test.ess.tencent.cn</font>,正式环境需要设置为<font color='red'>file.ess.tencent.cn</font>,代码示例
944
- ```
945
- HttpProfile httpProfile = new HttpProfile();
946
- httpProfile.setEndpoint("file.test.ess.tencent.cn");
947
- ```
948
800
 
949
801
  <font color="red">相关视频指引</font> <br>
950
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
802
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
803
+ 2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateFlowsByTemplates.mp4" target="_blank">【用模板创建签署流程】编写示例视频教程</a><br>
951
804
  */
952
- async UploadFiles(
953
- req: UploadFilesRequest,
954
- cb?: (error: string, rep: UploadFilesResponse) => void
955
- ): Promise<UploadFilesResponse> {
956
- return this.request("UploadFiles", req, cb)
805
+ async CreateFlowsByTemplates(
806
+ req: CreateFlowsByTemplatesRequest,
807
+ cb?: (error: string, rep: CreateFlowsByTemplatesResponse) => void
808
+ ): Promise<CreateFlowsByTemplatesResponse> {
809
+ return this.request("CreateFlowsByTemplates", req, cb)
957
810
  }
958
811
 
959
812
  /**
960
- * 该接口用于获取个人授权执业章给企业的二维码,需要个人用户通过微信扫码。
961
-
962
- 扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
813
+ * 此接口(ChannelCreateRole)用来创建企业自定义角色。
963
814
 
964
- 个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
815
+ 适用场景1:创建当前企业的自定义角色,并且创建时不进行权限的设置(PermissionGroups 参数不传),角色中的权限内容可通过接口 ChannelModifyRole 完成更新。
965
816
 
966
- **注意**
967
- 1. 该二维码**有效期为7天**,过期后将失效,可重新创建。
968
-
969
-
970
- 整体流程入下图
971
-
972
- ![image](https://qcloudimg.tencent-cloud.cn/raw/21b6b56dbc796c9d6f402d6ce6febb07.png)
817
+ 适用场景2:创建当前企业的自定义角色,并且创建时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考[查询角色列表接口](https://qian.tencent.com/developers/partnerApis/accounts/ChannelDescribeRoles) 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
973
818
  */
974
- async CreateEmployeeQualificationSealQrCode(
975
- req: CreateEmployeeQualificationSealQrCodeRequest,
976
- cb?: (error: string, rep: CreateEmployeeQualificationSealQrCodeResponse) => void
977
- ): Promise<CreateEmployeeQualificationSealQrCodeResponse> {
978
- return this.request("CreateEmployeeQualificationSealQrCode", req, cb)
819
+ async ChannelCreateRole(
820
+ req: ChannelCreateRoleRequest,
821
+ cb?: (error: string, rep: ChannelCreateRoleResponse) => void
822
+ ): Promise<ChannelCreateRoleResponse> {
823
+ return this.request("ChannelCreateRole", req, cb)
979
824
  }
980
825
 
981
826
  /**
982
- * 此接口(CreateConsoleLoginUrl)用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。
983
-
984
- Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态,进入不同的流程,主要情况分类如下:
985
- <table>
986
- <thead>
987
- <tr>
988
- <th>子客企业状态</th>
989
- <th>子客企业员工状态</th>
990
- <th>点击链接进入的流程</th>
991
- </tr>
992
- </thead>
993
- <tbody>
994
- <tr>
995
- <td>企业未激活</td>
996
- <td>员工未认证</td>
997
- <td>进入企业激活流程,首次完成企业激活流程的员工会成为超管</td>
998
- </tr>
999
- <tr>
1000
- <td>企业已激活</td>
1001
- <td>员工未认证</td>
1002
- <td>进入员工认证并加入企业流程</td>
1003
- </tr>
1004
- <tr>
1005
- <td>企业已激活</td>
1006
- <td>员工已认证</td>
1007
- <td>进入子客企业Web控制台</td>
1008
- </tr>
1009
- </tbody>
1010
- </table>
1011
- 如果是企业激活流程,需要注意如下情况:
1012
-
1013
- 1. 若在激活过程中,**更换用户OpenID重新生成链接,之前的认证会被清理**。因此不要在企业认证过程生成多个链接给多人同时操作,会导致认证过程互相影响。
1014
- 2. 若您认证中发现信息有误需要重新认证,**可通过更换用户OpenID重新生成链接的方式,来清理掉已有的流程**。
1015
-
1016
- 系统的渠道企业, 应用, 子客企业, 子客员工的组织形式
1017
- ![image](https://qcloudimg.tencent-cloud.cn/raw/77677faeea26c9d7f37474597c81fe01.png)
1018
-
1019
-
1020
- <font color="red">相关视频指引</font> <br>
1021
- 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-createconsoleloginin.mp4" target="_blank">【生成子客登录链接】代码编写 & 子企业认证示例</a><br>
827
+ * 生成用印申请审批链接,审批人可以通过此链接进入小程序进行审批。
828
+ p.s.
829
+ Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批人打开。
1022
830
  */
1023
- async CreateConsoleLoginUrl(
1024
- req: CreateConsoleLoginUrlRequest,
1025
- cb?: (error: string, rep: CreateConsoleLoginUrlResponse) => void
1026
- ): Promise<CreateConsoleLoginUrlResponse> {
1027
- return this.request("CreateConsoleLoginUrl", req, cb)
831
+ async DescribeChannelSealPolicyWorkflowUrl(
832
+ req: DescribeChannelSealPolicyWorkflowUrlRequest,
833
+ cb?: (error: string, rep: DescribeChannelSealPolicyWorkflowUrlResponse) => void
834
+ ): Promise<DescribeChannelSealPolicyWorkflowUrlResponse> {
835
+ return this.request("DescribeChannelSealPolicyWorkflowUrl", req, cb)
1028
836
  }
1029
837
 
1030
838
  /**
@@ -1037,103 +845,6 @@ Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表
1037
845
  return this.request("ChannelCreateOrganizationModifyQrCode", req, cb)
1038
846
  }
1039
847
 
1040
- /**
1041
- * 通过此接口指定合同、签署人、填写控件等信息,生成嵌入式链接,此链接可以嵌入到其他网页或者直接打开,打开后进入发起页面。在此页面上,合同信息和签署人信息均不可更改。
1042
-
1043
- 注意:
1044
- 1. <font color="red">仅支持在PC浏览器</font>上进行操作和使用。
1045
- 2. 在使用<font color="red">模板发起合同时,需指定RecipientId</font>以明确参与方在模板中所扮演的角色。
1046
-
1047
- **嵌入式签署人-各种场景传参说明**:
1048
-
1049
- <table>
1050
- <thead>
1051
- <tr>
1052
- <th>场景编号</th>
1053
- <th>可作为签署方的类型</th>
1054
- <th>签署方传参说明</th>
1055
- </tr>
1056
- </thead>
1057
-
1058
- <tbody>
1059
- <tr>
1060
- <td>场景一</td>
1061
- <td>第三方子企业员工</td>
1062
- <td>OpenId、OrganizationName、OrganizationOpenId必传 ,ApproverType设置为0</td>
1063
- </tr>
1064
- <tr>
1065
- <td>场景二</td>
1066
- <td>SaaS平台企业员工</td>
1067
- <td>Name、Mobile、OrganizationName必传,NotChannelOrganization=True。 ApproverType设置为0</td>
1068
- </tr>
1069
- <tr>
1070
- <td>场景三</td>
1071
- <td>个人/自然人</td>
1072
- <td>Name、Mobile必传, ApproverType设置为1</td>
1073
- </tr>
1074
- </tbody>
1075
- </table>
1076
-
1077
- 嵌入的页面样式如下:
1078
- ![image](https://qcloudimg.tencent-cloud.cn/raw/b2ae013fb4d747891dd3815bbe897208.png)
1079
- */
1080
- async ChannelCreatePrepareFlow(
1081
- req: ChannelCreatePrepareFlowRequest,
1082
- cb?: (error: string, rep: ChannelCreatePrepareFlowResponse) => void
1083
- ): Promise<ChannelCreatePrepareFlowResponse> {
1084
- return this.request("ChannelCreatePrepareFlow", req, cb)
1085
- }
1086
-
1087
- /**
1088
- * 通过合同编号生成批量撤销合同的链接,单次最多支持撤销100份合同, 返回的链接需要有此权限的人<font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>在<font color='red'>**手机端**</font>打开, 跳转到腾讯电子签小程序输入撤销原因来进行撤销合同
1089
-
1090
- 适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
1091
-
1092
- - **可撤回合同状态**:未全部签署完成
1093
- - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
1094
-
1095
- 批量撤销结果可以通过接口返回的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)主动查询。
1096
-
1097
- 注:
1098
- - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
1099
- - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
1100
- - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
1101
- */
1102
- async ChannelCreateBatchCancelFlowUrl(
1103
- req: ChannelCreateBatchCancelFlowUrlRequest,
1104
- cb?: (error: string, rep: ChannelCreateBatchCancelFlowUrlResponse) => void
1105
- ): Promise<ChannelCreateBatchCancelFlowUrlResponse> {
1106
- return this.request("ChannelCreateBatchCancelFlowUrl", req, cb)
1107
- }
1108
-
1109
- /**
1110
- * 此接口(ChannelDeleteRole)用来删除企业自定义角色。
1111
-
1112
- 注:**系统角色不可删除。**
1113
- */
1114
- async ChannelDeleteRole(
1115
- req: ChannelDeleteRoleRequest,
1116
- cb?: (error: string, rep: ChannelDeleteRoleResponse) => void
1117
- ): Promise<ChannelDeleteRoleResponse> {
1118
- return this.request("ChannelDeleteRole", req, cb)
1119
- }
1120
-
1121
- /**
1122
- * 此接口(ChannelGetTaskResultApi)用来查询转换任务的状态。如需发起转换任务,请使用<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行资源文件的转换操作<br />
1123
- 前提条件:已调用 <a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换,并得到了返回的转换任务Id。<br />
1124
-
1125
- 适用场景:已创建一个文件转换任务,想查询该文件转换任务的状态,或获取转换后的文件资源ID。<br />
1126
- 注:
1127
- 1. `大文件转换所需的时间可能会比较长。`
1128
- 2. `本接口返回的文件资源ID就是PDF资源ID,可以直接用于【用PDF文件创建签署流程】接口发起合同。`
1129
- */
1130
- async ChannelGetTaskResultApi(
1131
- req: ChannelGetTaskResultApiRequest,
1132
- cb?: (error: string, rep: ChannelGetTaskResultApiResponse) => void
1133
- ): Promise<ChannelGetTaskResultApiResponse> {
1134
- return this.request("ChannelGetTaskResultApi", req, cb)
1135
- }
1136
-
1137
848
  /**
1138
849
  * 接口(ChannelCreateDynamicFlowApprover)用来补充<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>发起的动态合同的签署人信息
1139
850
  **注**:
@@ -1151,96 +862,6 @@ Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表
1151
862
  return this.request("ChannelCreateDynamicFlowApprover", req, cb)
1152
863
  }
1153
864
 
1154
- /**
1155
- * 此接口(ChannelUpdateSealStatus)用于第三方应用平台为子客企业更新印章状态。
1156
- */
1157
- async ChannelUpdateSealStatus(
1158
- req: ChannelUpdateSealStatusRequest,
1159
- cb?: (error: string, rep: ChannelUpdateSealStatusResponse) => void
1160
- ): Promise<ChannelUpdateSealStatusResponse> {
1161
- return this.request("ChannelUpdateSealStatus", req, cb)
1162
- }
1163
-
1164
- /**
1165
- * 通过此接口,创建小程序批量签署链接,个人/企业员工点击此链接即可跳转小程序进行批量签署。
1166
- 请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。
1167
-
1168
- 注:
1169
- - 使用此接口生成链接,需要提前开通 `个人签署方仅校验手机号` 功能,在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
1170
- - 个人参与方点击链接后需短信验证码才能查看合同内容。
1171
- - 个人用户批量签署,需要传Name,Mobile,IdCardNumber(IdCardType) 参数。
1172
- - saas企业员工用户批量签署,在传递了姓名等基本信息参数的情况下,还需要传OrganizationName(参与方所在企业名称)参数生成签署链接,<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。
1173
- - 子客企业员工用户批量签署,需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证,且OpenId对应员工此子客下已经实名</font>。Name,Mobile, IdCard等信息此时可以不传,系统会查询此OpenId实名信息自动补充。
1174
- - 生成批量签署链接时,合同目标参与方状态需为<font color="red">待签署</font>状态。
1175
- - 个人批量签署进行的合同的签名区, 全部变成<font color="red">手写签名</font>(不管合同里边设置的签名限制)来进行。
1176
- - 不支持签署方含有签批控件,或设置了签署方在签署时自行添加签署控件功能的合同进行批量签署。
1177
- */
1178
- async ChannelCreateBatchSignUrl(
1179
- req: ChannelCreateBatchSignUrlRequest,
1180
- cb?: (error: string, rep: ChannelCreateBatchSignUrlResponse) => void
1181
- ): Promise<ChannelCreateBatchSignUrlResponse> {
1182
- return this.request("ChannelCreateBatchSignUrl", req, cb)
1183
- }
1184
-
1185
- /**
1186
- * 此接口(ChannelCreateBoundFlows)用于子客企业领取未归属给员工的合同,将合同领取给当前员工,合同不能重复领取。
1187
-
1188
-
1189
- **未归属合同发起方式**
1190
- 指定对应企业的OrganizationOpenId和OrganizationName而不指定具体的参与人(OpenId/名字/手机号等), 则合同进入待领取状态, 示例代码如下
1191
- ```
1192
- FlowApprovers: []*essbasic.FlowApproverInfo{
1193
- {
1194
- ApproverType: common.StringPtr("ORGANIZATION"),
1195
- OrganizationOpenId: common.StringPtr("org_dianziqian"),
1196
- OrganizationName: common.StringPtr("典子谦示例企业"),
1197
- }
1198
- },
1199
- ```
1200
-
1201
- 可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
1202
- ![image](https://qcloudimg.tencent-cloud.cn/raw/a34d0cc56ec871613e94dfc6252bc072.png)
1203
-
1204
- 注:
1205
- 1. 支持批量领取, 如果有一个合同流程无法领取会导致接口报错, 使得所有合同都领取失败
1206
- 2. 只有企业的<font color="red">超管或者法人</font>才能进行合同的领取
1207
- */
1208
- async ChannelCreateBoundFlows(
1209
- req: ChannelCreateBoundFlowsRequest,
1210
- cb?: (error: string, rep: ChannelCreateBoundFlowsResponse) => void
1211
- ): Promise<ChannelCreateBoundFlowsResponse> {
1212
- return this.request("ChannelCreateBoundFlows", req, cb)
1213
- }
1214
-
1215
- /**
1216
- * 获取设置自动签印章小程序链接。
1217
-
1218
- 注意:
1219
- <ul><li>需要<code>企业开通自动签</code>后使用。</li>
1220
- <li>仅支持<code>已经开通了自动签的个人</code>更换自动签印章。</li>
1221
- <li>链接有效期默认7天,<code>最多30天</code>。</li>
1222
- <li>该接口的链接适用于<code>小程序</code>端。</li>
1223
- <li>该接口不会扣除您的合同套餐,暂不参与计费。</li></ul>
1224
- */
1225
- async ChannelCreateUserAutoSignSealUrl(
1226
- req: ChannelCreateUserAutoSignSealUrlRequest,
1227
- cb?: (error: string, rep: ChannelCreateUserAutoSignSealUrlResponse) => void
1228
- ): Promise<ChannelCreateUserAutoSignSealUrlResponse> {
1229
- return this.request("ChannelCreateUserAutoSignSealUrl", req, cb)
1230
- }
1231
-
1232
- /**
1233
- * 通过此接口获取个人用户自动签的开通状态。
1234
-
1235
- 注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
1236
- */
1237
- async ChannelDescribeUserAutoSignStatus(
1238
- req: ChannelDescribeUserAutoSignStatusRequest,
1239
- cb?: (error: string, rep: ChannelDescribeUserAutoSignStatusResponse) => void
1240
- ): Promise<ChannelDescribeUserAutoSignStatusResponse> {
1241
- return this.request("ChannelDescribeUserAutoSignStatus", req, cb)
1242
- }
1243
-
1244
865
  /**
1245
866
  * 该接口用于获取创建法人章的二维码,需要通过微信扫描。扫描后将跳转到腾讯电子签署,进入到创建法人章的流程。
1246
867
 
@@ -1273,63 +894,49 @@ Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表
1273
894
  }
1274
895
 
1275
896
  /**
1276
- * 用来创建嵌入式页面个性化主题配置(例如是否展示电子签logo、定义主题色等),该接口配合其他所有可嵌入页面接口使用
1277
- 创建配置对当前第三方应用全局生效,如果多次调用,会以最后一次的配置为准
897
+ * 此接口(GetDownloadFlowUrl)用户获取合同控制台下载页面链接, 点击链接后会跳转至本企业合同管理控制台(会筛选出传入的合同列表), 点击**下载**按钮后就会下载传入的合同列表, 下载页面如下图
898
+ ![image](https://dyn.ess.tencent.cn/guide/capi/channel_GetDownloadFlowUrl.png)
899
+
900
+ 注:
901
+ <ul>
902
+ <li>仅支持下载 <b>本企业</b> 下合同,链接会 <b>登录企业控制台</b> </li>
903
+ <li> <b>链接仅可使用一次</b>,不可重复使用</li>
904
+ </ul>
1278
905
  */
1279
- async ChannelCreateWebThemeConfig(
1280
- req: ChannelCreateWebThemeConfigRequest,
1281
- cb?: (error: string, rep: ChannelCreateWebThemeConfigResponse) => void
1282
- ): Promise<ChannelCreateWebThemeConfigResponse> {
1283
- return this.request("ChannelCreateWebThemeConfig", req, cb)
906
+ async GetDownloadFlowUrl(
907
+ req: GetDownloadFlowUrlRequest,
908
+ cb?: (error: string, rep: GetDownloadFlowUrlResponse) => void
909
+ ): Promise<GetDownloadFlowUrlResponse> {
910
+ return this.request("GetDownloadFlowUrl", req, cb)
1284
911
  }
1285
912
 
1286
913
  /**
1287
- * 该接口用于发起合同后,生成用户的签署链接 <br/>
914
+ * 此接口查询子企业电子印章。<br />
1288
915
 
1289
- **注意**
1290
- 1. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接 。
1291
- 2. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。配置方式请参考:<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
1292
- 如需跳转到小程序的实现,参考微信官方文档(分为<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>。
1293
- 3. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
916
+ 注:
917
+ 1. 此操作要求操作者具备<b>印章查询权限</b>(若调用者尚无此权限,请联系超级管理员前往Web控制台【组织管理】->【角色管理】添加相应权限)。
1294
918
  */
1295
- async ChannelCreateFlowSignUrl(
1296
- req: ChannelCreateFlowSignUrlRequest,
1297
- cb?: (error: string, rep: ChannelCreateFlowSignUrlResponse) => void
1298
- ): Promise<ChannelCreateFlowSignUrlResponse> {
1299
- return this.request("ChannelCreateFlowSignUrl", req, cb)
919
+ async ChannelDescribeOrganizationSeals(
920
+ req: ChannelDescribeOrganizationSealsRequest,
921
+ cb?: (error: string, rep: ChannelDescribeOrganizationSealsResponse) => void
922
+ ): Promise<ChannelDescribeOrganizationSealsResponse> {
923
+ return this.request("ChannelDescribeOrganizationSeals", req, cb)
1300
924
  }
1301
925
 
1302
926
  /**
1303
- * 发起解除协议的主要应用场景为:基于一份已经签署的合同(签署流程),进行解除操作。
1304
- 解除协议的模板是官方提供,经过提供法务审核,暂不支持自定义。具体用法可以参考文档[合同解除](https://qian.tencent.com/developers/partner/flow_release)。
927
+ * 查询企业扩展服务的授权详情(列表),当前支持查询以下内容:
1305
928
 
1306
- 注意:
1307
- <ul><li><code>原合同必须签署完</code>成后才能发起解除协议。</li>
1308
- <li>只有原合同企业类型的参与人才能发起解除协议,<code>个人参与方不能发起解除协议</code>。</li>
1309
- <li>原合同个人类型参与人必须是解除协议的参与人,<code>不能更换其他第三方个人</code>参与解除协议。</li>
1310
- <li>如果原合同企业参与人无法参与解除协议,可以指定同企业具有同等权限的<code>企业员工代为处理</code>。</li>
1311
- <li>发起解除协议同发起其他企业合同一样,也会参与合同<code>扣费</code>,扣费标准同其他类型合同。</li>
1312
- <li>在解除协议签署完毕后,原合同及解除协议均变为已解除状态。</li>
1313
- <li>非原合同企业参与人发起解除协议时,需要有<code>解除合同的权限</code>。</li>
1314
- </ul>
1315
- */
1316
- async ChannelCreateReleaseFlow(
1317
- req: ChannelCreateReleaseFlowRequest,
1318
- cb?: (error: string, rep: ChannelCreateReleaseFlowResponse) => void
1319
- ): Promise<ChannelCreateReleaseFlowResponse> {
1320
- return this.request("ChannelCreateReleaseFlow", req, cb)
1321
- }
929
+ 1. **企业自动签**
930
+ 2. **批量签署**
1322
931
 
1323
- /**
1324
- * 获取企业员工信息, 可以获取员工的名字,OpenId,UserId和简述的角色等信息,支持设置过滤条件以筛选员工查询结果。
1325
932
 
1326
- **注**:通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/SyncProxyOrganizationOperators" target="_blank">企业员工新增或离职</a>接口增加的新员工或者离职的员工也会在列表中。
933
+ 注: <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
1327
934
  */
1328
- async ChannelDescribeEmployees(
1329
- req: ChannelDescribeEmployeesRequest,
1330
- cb?: (error: string, rep: ChannelDescribeEmployeesResponse) => void
1331
- ): Promise<ChannelDescribeEmployeesResponse> {
1332
- return this.request("ChannelDescribeEmployees", req, cb)
935
+ async DescribeExtendedServiceAuthDetail(
936
+ req: DescribeExtendedServiceAuthDetailRequest,
937
+ cb?: (error: string, rep: DescribeExtendedServiceAuthDetailResponse) => void
938
+ ): Promise<DescribeExtendedServiceAuthDetailResponse> {
939
+ return this.request("DescribeExtendedServiceAuthDetail", req, cb)
1333
940
  }
1334
941
 
1335
942
  /**
@@ -1346,47 +953,6 @@ Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表
1346
953
  return this.request("CreateCloseOrganizationUrl", req, cb)
1347
954
  }
1348
955
 
1349
- /**
1350
- * 通过合同编号批量撤销合同,单次最多支持撤销100份合同。
1351
-
1352
- 适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
1353
-
1354
- - **可撤回合同状态**:未全部签署完成
1355
- - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
1356
-
1357
- 批量撤销结果可以通过接口返回的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)主动查询。
1358
-
1359
-
1360
- 注:
1361
- - 有对应合同撤销权限的人: <font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>
1362
- - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
1363
- - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
1364
- - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
1365
- */
1366
- async ChannelBatchCancelFlows(
1367
- req: ChannelBatchCancelFlowsRequest,
1368
- cb?: (error: string, rep: ChannelBatchCancelFlowsResponse) => void
1369
- ): Promise<ChannelBatchCancelFlowsResponse> {
1370
- return this.request("ChannelBatchCancelFlows", req, cb)
1371
- }
1372
-
1373
- /**
1374
- * 该接口用于结束动态签署方2.0的合同流程。
1375
-
1376
-
1377
- **功能开通**
1378
- - 动态签署方2.0功能的使用需要先<font color="red">联系产品经理开通模块化计费功能</font>,然后到控制台中打开此功能。详细的使用说明请参考<a href="https://qian.tencent.com/developers/company/dynamic_signer_v2" target="_blank">动态签署方2.0</a>文档。
1379
-
1380
- **使用条件**
1381
- - 此接口只能在<font color="red">合同处于非终态且<b>所有的签署方都已经完成签署</b></font>。一旦合同进入终态(例如:过期、拒签、撤销或者调用过此接口成功过),将无法通过此接口结束合同流程。
1382
- */
1383
- async ArchiveDynamicFlow(
1384
- req: ArchiveDynamicFlowRequest,
1385
- cb?: (error: string, rep: ArchiveDynamicFlowResponse) => void
1386
- ): Promise<ArchiveDynamicFlowResponse> {
1387
- return this.request("ArchiveDynamicFlow", req, cb)
1388
- }
1389
-
1390
956
  /**
1391
957
  * 该接口 (PrepareFlows) 用于创建待发起文件
1392
958
  用户通过该接口进入签署流程发起的确认页面,进行发起信息二次确认, 如果确认则进行正常发起。
@@ -1400,133 +966,25 @@ Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表
1400
966
  }
1401
967
 
1402
968
  /**
1403
- * 创建跳转小程序查看或签署的链接
1404
-
1405
- **腾讯电子签小程序的AppID 和 原始Id如下:**
1406
-
1407
- | 小程序 | AppID | 原始ID |
1408
- | ------------ | ------------ | ------------ |
1409
- | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
1410
- | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
1411
-
1412
- **主要使用场景EndPoint分类**
1413
-
1414
- |EndPoint| 场景| 说明和示例|
1415
- | ---- | ---- | --- |
1416
- | WEIXINAPP | 短链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序(与腾讯电子签官方短信提醒用户签署形式一样)<br> 示例: https://essurl.cn/x9nvWU8fTg|
1417
- | LONGURL2WEIXINAPP | 长链跳转腾讯电子签小程序签署场景 | 点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
1418
- | 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 |
1419
- |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 |
1420
- |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 |
1421
- */
1422
- async CreateSignUrls(
1423
- req: CreateSignUrlsRequest,
1424
- cb?: (error: string, rep: CreateSignUrlsResponse) => void
1425
- ): Promise<CreateSignUrlsResponse> {
1426
- return this.request("CreateSignUrls", req, cb)
1427
- }
1428
-
1429
- /**
1430
- * 此接口(GetDownloadFlowUrl)用户获取合同控制台下载页面链接, 点击链接后会跳转至本企业合同管理控制台(会筛选出传入的合同列表), 点击**下载**按钮后就会下载传入的合同列表, 下载页面如下图
1431
- ![image](https://dyn.ess.tencent.cn/guide/capi/channel_GetDownloadFlowUrl.png)
1432
-
1433
- 注:
1434
- <ul>
1435
- <li>仅支持下载 <b>本企业</b> 下合同,链接会 <b>登录企业控制台</b> </li>
1436
- <li> <b>链接仅可使用一次</b>,不可重复使用</li>
1437
- </ul>
1438
- */
1439
- async GetDownloadFlowUrl(
1440
- req: GetDownloadFlowUrlRequest,
1441
- cb?: (error: string, rep: GetDownloadFlowUrlResponse) => void
1442
- ): Promise<GetDownloadFlowUrlResponse> {
1443
- return this.request("GetDownloadFlowUrl", req, cb)
1444
- }
1445
-
1446
- /**
1447
- * **适用场景**:
1448
- 当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口动态补充签署人。同一签署人只允许补充一人,最终实际签署人取决于谁先领取合同完成签署。
1449
-
1450
- **接口使用说明**:
1451
-
1452
- 1.本接口现已支持批量补充签署人
1453
-
1454
- 2.当<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中指定需要补充的FlowId时,可以对指定合同补充签署人;可以指定多个相同发起方的不同合同在完成批量补充
1455
-
1456
- 3.当<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中指定需要补充的FlowId时,是对指定的合同补充多个指定的签署人
1457
-
1458
- 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作为补充的合同
1459
-
1460
- 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作为补充的合同
1461
-
1462
-
1463
- 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,则传参错误
1464
-
1465
- **限制条件**:
1466
- 1. 本企业(发起方企业)企业签署人仅支持通过企业名称+姓名+手机号进行补充。
1467
- 2. 个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
1468
- */
1469
- async ChannelCreateFlowApprovers(
1470
- req: ChannelCreateFlowApproversRequest,
1471
- cb?: (error: string, rep: ChannelCreateFlowApproversResponse) => void
1472
- ): Promise<ChannelCreateFlowApproversResponse> {
1473
- return this.request("ChannelCreateFlowApprovers", req, cb)
1474
- }
1475
-
1476
- /**
1477
- * 获取个人用户认证证书图片下载URL
1478
-
1479
- 个人用户认证证书图片样式如下图
1480
-
1481
- ![image](https://qcloudimg.tencent-cloud.cn/raw/d568bc0f101bef582f7af2cb5ab7a715.png)
1482
-
1483
- 注:
1484
- <ul>
1485
- <li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
1486
- <li>专为电子处方单(医疗自动签)特定场景使用。在使用前,请务必与您的客户经理联系以确认已经开通电子处方单功能 </li>
1487
- </ul>
1488
- */
1489
- async CreatePersonAuthCertificateImage(
1490
- req: CreatePersonAuthCertificateImageRequest,
1491
- cb?: (error: string, rep: CreatePersonAuthCertificateImageResponse) => void
1492
- ): Promise<CreatePersonAuthCertificateImageResponse> {
1493
- return this.request("CreatePersonAuthCertificateImage", req, cb)
1494
- }
1495
-
1496
- /**
1497
- * 创建一个用于他方自动签授权的链接(可选择他方授权或我方授权)。通过这个链接,合作方企业可以直接进入小程序,进行自动签授权操作。
1498
-
1499
- 如果授权企业尚未开通企业自动签功能,该链接还将引导他们首先开通本企业的自动签服务
1500
-
1501
-
1502
- 注:
1503
- 1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
1504
- 2. 已经在授权中或者授权成功的企业,无法重复授权
1505
- 3. 授权企业和被授权企业必须都是已认证企业
1506
- 4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
969
+ * 分页查询企业角色列表,法人的角色是系统保留角色,不会返回,按照角色创建时间升序排列。
1507
970
 
1508
- **该接口效果同控制台: 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
1509
- ![image](https://qcloudimg.tencent-cloud.cn/raw/091823fd4f02af7dda416fa10ca65f2d.png)
1510
- */
1511
- async CreatePartnerAutoSignAuthUrl(
1512
- req: CreatePartnerAutoSignAuthUrlRequest,
1513
- cb?: (error: string, rep: CreatePartnerAutoSignAuthUrlResponse) => void
1514
- ): Promise<CreatePartnerAutoSignAuthUrlResponse> {
1515
- return this.request("CreatePartnerAutoSignAuthUrl", req, cb)
1516
- }
1517
971
 
1518
- /**
1519
- * 此接口(ChannelCreateRole)用来创建企业自定义角色。
972
+ <font color="red">系统默认角色</font>说明可参考下表
1520
973
 
1521
- 适用场景1:创建当前企业的自定义角色,并且创建时不进行权限的设置(PermissionGroups 参数不传),角色中的权限内容可通过接口 ChannelModifyRole 完成更新。
974
+ | 角色名称| 建议授予对象 | 角色描述 |
975
+ | --- | --- | --- |
976
+ | **超级管理员** |电子签业务最高权限,可以授权给法务/企业法人/业务负责人等 | 所有功能和数据管理权限,只能设置一位超管。 |
977
+ | **业务管理员**|IT 系统负责人,可以授权给CTO等 | 企业合同模块、印章模块、模板模块等全量功能及数据权限。 |
978
+ | **经办人**|企业法务负责人等 | 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看企业所有合同数据。 |
979
+ | **业务员**|销售员、采购员 等| 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看自己相关所有合同数据。 |
1522
980
 
1523
- 适用场景2:创建当前企业的自定义角色,并且创建时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考[查询角色列表接口](https://qian.tencent.com/developers/partnerApis/accounts/ChannelDescribeRoles) 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
981
+ 附件:<a href="https://dyn.ess.tencent.cn/guide/apivideo/roles.xlsx" target="_blank">点击下载角色对应的权限点的excel文档</a>
1524
982
  */
1525
- async ChannelCreateRole(
1526
- req: ChannelCreateRoleRequest,
1527
- cb?: (error: string, rep: ChannelCreateRoleResponse) => void
1528
- ): Promise<ChannelCreateRoleResponse> {
1529
- return this.request("ChannelCreateRole", req, cb)
983
+ async ChannelDescribeRoles(
984
+ req: ChannelDescribeRolesRequest,
985
+ cb?: (error: string, rep: ChannelDescribeRolesResponse) => void
986
+ ): Promise<ChannelDescribeRolesResponse> {
987
+ return this.request("ChannelDescribeRoles", req, cb)
1530
988
  }
1531
989
 
1532
990
  /**
@@ -1566,342 +1024,911 @@ Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表
1566
1024
  }
1567
1025
 
1568
1026
  /**
1569
- * 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时,若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
1570
- - [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
1571
- - [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)
1572
- - [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo)
1027
+ * 查询渠道子客企业信息时,可以支持单个子客和整个应用下所有子客的查询。返回的信息包括超管、法人的信息以及当前企业的认证状态等信息。
1573
1028
 
1574
- 2. 同一合同组,同一签署人可以多次提交签署审批结果,签署时的最后一个“审批结果”有效。
1029
+ - 对于单个企业的查询,通过**指定子客的唯一标识**来查询该子客的企业信息
1030
+ - 对于整个应用下所有企业的查询,**不需要指定子客的唯一标识**,直接查询整个应用下所有子客企业的企业信息
1575
1031
  */
1576
- async CreateFlowGroupSignReview(
1577
- req: CreateFlowGroupSignReviewRequest,
1578
- cb?: (error: string, rep: CreateFlowGroupSignReviewResponse) => void
1579
- ): Promise<CreateFlowGroupSignReviewResponse> {
1580
- return this.request("CreateFlowGroupSignReview", req, cb)
1032
+ async DescribeChannelOrganizations(
1033
+ req: DescribeChannelOrganizationsRequest,
1034
+ cb?: (error: string, rep: DescribeChannelOrganizationsResponse) => void
1035
+ ): Promise<DescribeChannelOrganizationsResponse> {
1036
+ return this.request("DescribeChannelOrganizations", req, cb)
1581
1037
  }
1582
1038
 
1583
1039
  /**
1584
- * 使用此接口,用来绑定企业实名员工的角色,
1585
- 支持以电子签userId、客户系统openId两种方式进行绑定。
1040
+ * 支持企业进行批量初始化操作:
1586
1041
 
1587
- 对应控制台的操作如下图
1588
- ![image](https://qcloudimg.tencent-cloud.cn/raw/5b41194d3cb3f2058ec0ba0fb5ebc6a6.png)
1042
+ 此接口存在以下限制:
1043
+ 1. 批量操作的企业需要已经完成电子签的认证流程。
1044
+ 2. 通过此接口生成的链接在小程序端进行操作时,操作人需要是<font color="red">所有企业的超管或法人</font>。
1045
+ 3. 批量操作的企业,需要是本方第三方应用下的企业。
1046
+ 4. <font color="red">操作链接过期时间默认为生成链接后7天。</font>
1589
1047
  */
1590
- async ChannelCreateUserRoles(
1591
- req: ChannelCreateUserRolesRequest,
1592
- cb?: (error: string, rep: ChannelCreateUserRolesResponse) => void
1593
- ): Promise<ChannelCreateUserRolesResponse> {
1594
- return this.request("ChannelCreateUserRoles", req, cb)
1048
+ async CreateBatchInitOrganizationUrl(
1049
+ req: CreateBatchInitOrganizationUrlRequest,
1050
+ cb?: (error: string, rep: CreateBatchInitOrganizationUrlResponse) => void
1051
+ ): Promise<CreateBatchInitOrganizationUrlResponse> {
1052
+ return this.request("CreateBatchInitOrganizationUrl", req, cb)
1595
1053
  }
1596
1054
 
1597
1055
  /**
1598
- * 此接口(ChannelCancelUserAutoSignEnableUrl)用来撤销发送给个人用户的自动签开通链接,撤销后对应的个人用户开通链接失效。若个人用户已经完成开通,将无法撤销。(处方单场景专用,使用此接口请与客户经理确认)
1056
+ * 通过此接口(ChannelDescribeAccountBillDetail)查询该第三方平台子客账号计费详情。
1057
+ <ul>
1058
+ <li>对于渠道客户企业的查询,通过指定渠道企业的唯一标识(Agent.ProxyOrganizationId)来查询子客账号消耗详情</li>
1059
+ </ul>
1060
+ */
1061
+ async ChannelDescribeAccountBillDetail(
1062
+ req: ChannelDescribeAccountBillDetailRequest,
1063
+ cb?: (error: string, rep: ChannelDescribeAccountBillDetailResponse) => void
1064
+ ): Promise<ChannelDescribeAccountBillDetailResponse> {
1065
+ return this.request("ChannelDescribeAccountBillDetail", req, cb)
1066
+ }
1067
+
1068
+ /**
1069
+ * 您可以通过合同流程ID查询相关的<font color="red"><b>填写控件</b></font>信息及其内容。这包括控件的归属方、控件的填写状态(是否已填写)以及具体的填写内容。
1070
+
1071
+ 无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件,均包含在查询结果中。
1072
+
1073
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/08f6ea50d3ae88b51c280c2b17c2a126.png)
1074
+ ### 2. 哪些控件会出现在结果里边?
1075
+ **A.不返回的控件类型:**
1076
+ - 动态表格
1077
+ - 附件控件
1078
+ - 水印控件
1079
+
1080
+ **B.返回的控件类型:**
1081
+ - 单行文本
1082
+ - 多行文本
1083
+ - 勾选框控件
1084
+ - 数字控件
1085
+ - 日期控件
1086
+ - 图片控件(图片下载地址)
1087
+ - 邮箱控件
1088
+ - 地址控件
1089
+ - 学历控件
1090
+ - 性别控件
1091
+ - 省市区控件
1092
+
1093
+ ### 3.怎么授权?
1094
+
1095
+ 此接口需要授权, 有两种开通权限的途径
1096
+
1097
+ **第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图
1098
+ 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
1099
+
1100
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
1101
+
1102
+ **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
1103
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
1104
+ */
1105
+ async ChannelDescribeFlowComponents(
1106
+ req: ChannelDescribeFlowComponentsRequest,
1107
+ cb?: (error: string, rep: ChannelDescribeFlowComponentsResponse) => void
1108
+ ): Promise<ChannelDescribeFlowComponentsResponse> {
1109
+ return this.request("ChannelDescribeFlowComponents", req, cb)
1110
+ }
1111
+
1112
+ /**
1113
+ * 此接口(ChannelDeleteSealPolicies)用于删除已指定员工印章授权信息,删除员工的印章授权后,该员工使用印章进行盖章时,将需要提交印章授权申请且通过审核后才能使用该印章进行签署。
1599
1114
  */
1600
- async ChannelCancelUserAutoSignEnableUrl(
1601
- req: ChannelCancelUserAutoSignEnableUrlRequest,
1602
- cb?: (error: string, rep: ChannelCancelUserAutoSignEnableUrlResponse) => void
1603
- ): Promise<ChannelCancelUserAutoSignEnableUrlResponse> {
1604
- return this.request("ChannelCancelUserAutoSignEnableUrl", req, cb)
1115
+ async ChannelDeleteSealPolicies(
1116
+ req: ChannelDeleteSealPoliciesRequest,
1117
+ cb?: (error: string, rep: ChannelDeleteSealPoliciesResponse) => void
1118
+ ): Promise<ChannelDeleteSealPoliciesResponse> {
1119
+ return this.request("ChannelDeleteSealPolicies", req, cb)
1605
1120
  }
1606
1121
 
1607
1122
  /**
1608
- * 生成用印申请审批链接,审批人可以通过此链接进入小程序进行审批。
1609
- p.s.
1610
- Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批人打开。
1123
+ * 此接口(ChannelCreateMultiFlowSignQRCode)用于创建一码多签签署码。
1124
+
1125
+ **适用场景**:
1126
+ 签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
1127
+
1128
+ **注意**:
1129
+ 1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**, 若是B2C模板,还要满足以下任意一个条件
1130
+ - 模板中配置的签署顺序是无序
1131
+ - B端企业的签署方式是静默签署
1132
+ - B端企业是非首位签署
1133
+ 2. 通过扫描一码多签签署码发起的合同,合同涉及到的回调消息可参考文档[合同发起及签署相关回调
1134
+ ]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
1135
+ 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)
1136
+
1137
+ 签署码的样式如下图:
1138
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/27317cf5aacb094fb1dc6f94179a5148.png )
1611
1139
  */
1612
- async DescribeChannelSealPolicyWorkflowUrl(
1613
- req: DescribeChannelSealPolicyWorkflowUrlRequest,
1614
- cb?: (error: string, rep: DescribeChannelSealPolicyWorkflowUrlResponse) => void
1615
- ): Promise<DescribeChannelSealPolicyWorkflowUrlResponse> {
1616
- return this.request("DescribeChannelSealPolicyWorkflowUrl", req, cb)
1140
+ async ChannelCreateMultiFlowSignQRCode(
1141
+ req: ChannelCreateMultiFlowSignQRCodeRequest,
1142
+ cb?: (error: string, rep: ChannelCreateMultiFlowSignQRCodeResponse) => void
1143
+ ): Promise<ChannelCreateMultiFlowSignQRCodeResponse> {
1144
+ return this.request("ChannelCreateMultiFlowSignQRCode", req, cb)
1617
1145
  }
1618
1146
 
1619
1147
  /**
1620
- * 查询渠道子客企业信息时,可以支持单个子客和整个应用下所有子客的查询。返回的信息包括超管、法人的信息以及当前企业的认证状态等信息。
1148
+ * 管理企业扩展服务
1621
1149
 
1622
- - 对于单个企业的查询,通过**指定子客的唯一标识**来查询该子客的企业信息
1623
- - 对于整个应用下所有企业的查询,**不需要指定子客的唯一标识**,直接查询整个应用下所有子客企业的企业信息
1150
+ - **直接开通的情形:** 若在操作过程中接口没有返回跳转链接,这表明无需进行任何跳转操作。此时,相应的企业拓展服务将会直接被开通或关闭。
1151
+
1152
+ - **需要法人或者超管签署开通协议的情形:** 当需要开通以下企业拓展服务时, 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员(超管)或法人。由他们点击该链接,完成服务的开通操作。
1153
+ - **AUTO_SIGN(企业自动签)**
1154
+ - **DOWNLOAD_FLOW(授权渠道下载合同)**
1155
+
1156
+ 注意: `在调用此接口以管理企业扩展服务时,操作者( Agent.ProxyOperator.OpenId)必须是企业的超级管理员(超管)或法人`
1157
+
1158
+
1159
+ 对应的扩展服务能力可以在控制台的【扩展服务】中找到
1160
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/99eebd37883ec55ed1f1df3a57aee60a.png)
1624
1161
  */
1625
- async DescribeChannelOrganizations(
1626
- req: DescribeChannelOrganizationsRequest,
1627
- cb?: (error: string, rep: DescribeChannelOrganizationsResponse) => void
1628
- ): Promise<DescribeChannelOrganizationsResponse> {
1629
- return this.request("DescribeChannelOrganizations", req, cb)
1162
+ async ModifyExtendedService(
1163
+ req: ModifyExtendedServiceRequest,
1164
+ cb?: (error: string, rep: ModifyExtendedServiceResponse) => void
1165
+ ): Promise<ModifyExtendedServiceResponse> {
1166
+ return this.request("ModifyExtendedService", req, cb)
1630
1167
  }
1631
1168
 
1632
1169
  /**
1633
- * 指定需要批量催办的签署流程ID,批量催办合同,最多100个。需要符合以下条件的合同才可被催办
1634
- 1. 合同中当前状态为 **待签署** 的签署人是催办的对象
1635
- 2. **每个合同只能催办一次**
1170
+ * 获取区块链存证证书查看链接/二维码接口
1636
1171
 
1637
- **催办的效果**: 对方会收到如下的短信通知
1172
+ 适用场景:企业员工可以通过此接口生成合同区块链存证证书的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
1638
1173
 
1639
- ![image](https://qcloudimg.tencent-cloud.cn/raw/3caf94b7f540fa5736270d38528d3a7b.png)
1174
+ [点击查看区块链存证证书样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
1640
1175
 
1176
+ 注:
1177
+ <ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
1178
+ <li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成证书查看二维码/短链。</li>
1179
+ <li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
1180
+ <li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证证书,请妥善保管好二维码或链接。</li></ul>
1181
+ */
1182
+ async CreateFlowBlockchainEvidenceUrl(
1183
+ req: CreateFlowBlockchainEvidenceUrlRequest,
1184
+ cb?: (error: string, rep: CreateFlowBlockchainEvidenceUrlResponse) => void
1185
+ ): Promise<CreateFlowBlockchainEvidenceUrlResponse> {
1186
+ return this.request("CreateFlowBlockchainEvidenceUrl", req, cb)
1187
+ }
1641
1188
 
1642
- **注**:`合同催办是白名单功能,请联系客户经理申请开白后使用`
1189
+ /**
1190
+ * 此接口用于获取企业批量认证链接-单链接包含多条认证流。
1191
+
1192
+ 前提条件:已调用 [CreateBatchOrganizationRegistrationTasks创建子企业批量认证链接任务接口](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接DescribeBatchOrganizationRegistrationUrls](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 确保认证任务已经完成。
1193
+
1194
+ 异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间。
1195
+ 此链接包含多条认证流程,使用该链接可以批量的对企业进行认证。
1643
1196
  */
1644
- async ChannelCreateFlowReminds(
1645
- req: ChannelCreateFlowRemindsRequest,
1646
- cb?: (error: string, rep: ChannelCreateFlowRemindsResponse) => void
1647
- ): Promise<ChannelCreateFlowRemindsResponse> {
1648
- return this.request("ChannelCreateFlowReminds", req, cb)
1197
+ async CreateBatchOrganizationAuthorizationUrl(
1198
+ req: CreateBatchOrganizationAuthorizationUrlRequest,
1199
+ cb?: (error: string, rep: CreateBatchOrganizationAuthorizationUrlResponse) => void
1200
+ ): Promise<CreateBatchOrganizationAuthorizationUrlResponse> {
1201
+ return this.request("CreateBatchOrganizationAuthorizationUrl", req, cb)
1202
+ }
1203
+
1204
+ /**
1205
+ * 该接口用于发起合同后,生成个人/企业用户的批量待办链接。
1206
+ **注意:**
1207
+ 1. 该接口可生成签署人的批量、合同组签署/查看链接 。
1208
+ 2. 该签署链接**有效期为30分钟**,过期后将失效,如需签署可重新创建批量签署链接 。
1209
+ 4. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
1210
+ 跳转到小程序的实现,参考微信官方文档(分为<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>。
1211
+ 6. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
1212
+ */
1213
+ async ChannelCreateBatchQuickSignUrl(
1214
+ req: ChannelCreateBatchQuickSignUrlRequest,
1215
+ cb?: (error: string, rep: ChannelCreateBatchQuickSignUrlResponse) => void
1216
+ ): Promise<ChannelCreateBatchQuickSignUrlResponse> {
1217
+ return this.request("ChannelCreateBatchQuickSignUrl", req, cb)
1218
+ }
1219
+
1220
+ /**
1221
+ * 通过此接口可以关闭个人用户自动签功能。
1222
+ 无需对应的用户刷脸等方式同意即可关闭。
1223
+
1224
+ 注意:
1225
+
1226
+ <ul><li>处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。</li>
1227
+ <li>如果此用户在开通时候绑定过个人自动签账号许可, 关闭此用户的自动签不会归还个人自动签账号许可的额度。</li></ul>
1228
+ */
1229
+ async ChannelDisableUserAutoSign(
1230
+ req: ChannelDisableUserAutoSignRequest,
1231
+ cb?: (error: string, rep: ChannelDisableUserAutoSignResponse) => void
1232
+ ): Promise<ChannelDisableUserAutoSignResponse> {
1233
+ return this.request("ChannelDisableUserAutoSign", req, cb)
1234
+ }
1235
+
1236
+ /**
1237
+ * 该接口用于批量创建企业认证链接, 可以支持PC浏览器,H5和小程序三种途径。
1238
+ 此接口为异步提交任务接口,需要与[查询子企业批量认证链接](https://qcloudimg.tencent-cloud.cn/raw/1d3737991b2a3be78002bd78a47d6917.png)配合使用,整体流程如下图。
1239
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
1240
+
1241
+
1242
+
1243
+ **注意**
1244
+
1245
+ 1. 单次最多创建10个子企业。
1246
+ 2. 一天内,同一家企业最多创建8000个子企业。
1247
+ 3. 同一批创建的子客户不能重复,包括企业名称、企业统一信用代码和子客户经办人openId。
1248
+ 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>。
1249
+
1250
+
1251
+
1252
+ **腾讯电子签小程序的AppID 和 原始Id如下:**
1253
+
1254
+ | 小程序 | AppID | 原始ID |
1255
+ | ------------ | ------------ | ------------ |
1256
+ | 腾讯电子签(正式版) | wxa023b292fd19d41d | gh_da88f6188665 |
1257
+ | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
1258
+ */
1259
+ async CreateBatchOrganizationRegistrationTasks(
1260
+ req: CreateBatchOrganizationRegistrationTasksRequest,
1261
+ cb?: (error: string, rep: CreateBatchOrganizationRegistrationTasksResponse) => void
1262
+ ): Promise<CreateBatchOrganizationRegistrationTasksResponse> {
1263
+ return this.request("CreateBatchOrganizationRegistrationTasks", req, cb)
1649
1264
  }
1650
1265
 
1651
- /**
1652
- * 提交申请出证报告任务并返回报告ID。
1266
+ /**
1267
+ * 该接口用于获取个人授权执业章给企业的二维码,需要个人用户通过微信扫码。
1268
+
1269
+ 扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
1270
+
1271
+ 个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
1272
+
1273
+ **注意**
1274
+ 1. 该二维码**有效期为7天**,过期后将失效,可重新创建。
1275
+
1276
+
1277
+ 整体流程入下图
1278
+
1279
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/21b6b56dbc796c9d6f402d6ce6febb07.png)
1280
+ */
1281
+ async CreateEmployeeQualificationSealQrCode(
1282
+ req: CreateEmployeeQualificationSealQrCodeRequest,
1283
+ cb?: (error: string, rep: CreateEmployeeQualificationSealQrCodeResponse) => void
1284
+ ): Promise<CreateEmployeeQualificationSealQrCodeResponse> {
1285
+ return this.request("CreateEmployeeQualificationSealQrCode", req, cb)
1286
+ }
1287
+
1288
+ /**
1289
+ * 此接口(ChannelGetTaskResultApi)用来查询转换任务的状态。如需发起转换任务,请使用<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行资源文件的转换操作<br />
1290
+ 前提条件:已调用 <a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换,并得到了返回的转换任务Id。<br />
1291
+
1292
+ 适用场景:已创建一个文件转换任务,想查询该文件转换任务的状态,或获取转换后的文件资源ID。<br />
1293
+ 注:
1294
+ 1. `大文件转换所需的时间可能会比较长。`
1295
+ 2. `本接口返回的文件资源ID就是PDF资源ID,可以直接用于【用PDF文件创建签署流程】接口发起合同。`
1296
+ */
1297
+ async ChannelGetTaskResultApi(
1298
+ req: ChannelGetTaskResultApiRequest,
1299
+ cb?: (error: string, rep: ChannelGetTaskResultApiResponse) => void
1300
+ ): Promise<ChannelGetTaskResultApiResponse> {
1301
+ return this.request("ChannelGetTaskResultApi", req, cb)
1302
+ }
1303
+
1304
+ /**
1305
+ * 获取设置自动签印章小程序链接。
1306
+
1307
+ 注意:
1308
+ <ul><li>需要<code>企业开通自动签</code>后使用。</li>
1309
+ <li>仅支持<code>已经开通了自动签的个人</code>更换自动签印章。</li>
1310
+ <li>链接有效期默认7天,<code>最多30天</code>。</li>
1311
+ <li>该接口的链接适用于<code>小程序</code>端。</li>
1312
+ <li>该接口不会扣除您的合同套餐,暂不参与计费。</li></ul>
1313
+ */
1314
+ async ChannelCreateUserAutoSignSealUrl(
1315
+ req: ChannelCreateUserAutoSignSealUrlRequest,
1316
+ cb?: (error: string, rep: ChannelCreateUserAutoSignSealUrlResponse) => void
1317
+ ): Promise<ChannelCreateUserAutoSignSealUrlResponse> {
1318
+ return this.request("ChannelCreateUserAutoSignSealUrl", req, cb)
1319
+ }
1320
+
1321
+ /**
1322
+ * 激活或续期子客企业, 在激活状态下,企业可以正常发起合同;在非激活状态下,企业仅能查看和签署合同。
1323
+
1324
+ **1. 激活**:使用一个许可证将子客企业从未激活状态转变为激活状态。**激活状态的有效期为一年,一年后将自动回到未激活状态**。
1325
+
1326
+ **2. 续期**:使用一个许可证将已激活的子客企业的有效期延长一年。只有处于激活状态的子企业才能进行续期操作(**若处于非激活状态,则需先激活**)。您可以使用多个许可证对同一子客企业进行多次续费。
1327
+
1328
+
1329
+ 该接口的效果同:**【企业应用管理】 -> 【子客企业管理】 -> 【激活】或者【续期】**
1330
+
1331
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/cd63761ca6e814c64b4ecf131555b74e.png)
1332
+
1333
+
1334
+ 如果不想调用此接口或者页面点击进行激活或续期,可以在【应用扩展服务】中打开自动激活或续期,在许可证充足的情况下会自动激活或续期子客企业
1335
+
1336
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/2ccb37ef6bde463c15c39fdda789216f.png)
1337
+ */
1338
+ async CreateChannelSubOrganizationActive(
1339
+ req: CreateChannelSubOrganizationActiveRequest,
1340
+ cb?: (error: string, rep: CreateChannelSubOrganizationActiveResponse) => void
1341
+ ): Promise<CreateChannelSubOrganizationActiveResponse> {
1342
+ return this.request("CreateChannelSubOrganizationActive", req, cb)
1343
+ }
1344
+
1345
+ /**
1346
+ * 通过此接口(DescribeTemplates)查询该第三方平台子客企业在电子签拥有的有效模板,不包括第三方平台模板。
1347
+
1348
+ **适用场景**
1349
+ 该接口常用来配合<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>接口,作为创建合同的前置接口使用。
1350
+ 通过此接口查询到模板信息后,再通过调用创建合同的接口,指定模板ID,指定模板中需要的填写控件内容等,完成合同文档的创建。
1351
+
1352
+ **模板的来源**
1353
+ 子客企业的模板有两种途径获取
1354
+ - 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
1355
+ - 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
1356
+
1357
+ **一个模板通常会包含以下结构信息**
1358
+
1359
+ - 模板ID, 模板名字等基本信息
1360
+ - 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
1361
+ - 发起方和签署方的填写控件 Components
1362
+ - 签署方的签署控件 SignComponents
1363
+
1364
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/ab81fa948a0a6fea14f48cac91d0e36a/channel_DescribeTemplates.png)
1365
+
1366
+ 模板中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
1367
+
1368
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
1369
+
1370
+
1371
+ **注意**
1372
+
1373
+ >1. 查询条件TemplateId、TemplateName与ChannelTemplateId可同时存在,即可查询同时满足这些条件的模板。
1374
+ >2. TemplateId 和TemplateIds互为独立,若两个参数都传入,则以TemplateId为准
1375
+
1376
+ <font color="red">相关视频指引</font> <br>
1377
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
1378
+ */
1379
+ async DescribeTemplates(
1380
+ req: DescribeTemplatesRequest,
1381
+ cb?: (error: string, rep: DescribeTemplatesResponse) => void
1382
+ ): Promise<DescribeTemplatesResponse> {
1383
+ return this.request("DescribeTemplates", req, cb)
1384
+ }
1385
+
1386
+ /**
1387
+ * 此接口(ChannelCancelUserAutoSignEnableUrl)用来撤销发送给个人用户的自动签开通链接,撤销后对应的个人用户开通链接失效。若个人用户已经完成开通,将无法撤销。(处方单场景专用,使用此接口请与客户经理确认)
1388
+ */
1389
+ async ChannelCancelUserAutoSignEnableUrl(
1390
+ req: ChannelCancelUserAutoSignEnableUrlRequest,
1391
+ cb?: (error: string, rep: ChannelCancelUserAutoSignEnableUrlResponse) => void
1392
+ ): Promise<ChannelCancelUserAutoSignEnableUrlResponse> {
1393
+ return this.request("ChannelCancelUserAutoSignEnableUrl", req, cb)
1394
+ }
1395
+
1396
+ /**
1397
+ * 此接口(UploadFiles)文件上传。<br/>
1398
+
1399
+ 适用场景:用于合同,印章的文件上传。文件上传以后,
1400
+ 如果是PDF格式文件可配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>接口进行合同流程的发起
1401
+ 如果是其他类型可以配合<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务</a>接口转换成PDF文件
1402
+
1403
+ 注:
1404
+ 1. 图片类型(png/jpg/jpeg)限制大小为5M以下, PDF/word/excel等其他格式限制大小为60M以下
1405
+ 2. <font color='red'>此接口调用时需要单独设置Domain请求域名 </font>, 联调开发环境为 <font color='red'>file.test.ess.tencent.cn</font>,正式环境需要设置为<font color='red'>file.ess.tencent.cn</font>,代码示例
1406
+ ```
1407
+ HttpProfile httpProfile = new HttpProfile();
1408
+ httpProfile.setEndpoint("file.test.ess.tencent.cn");
1409
+ ```
1410
+
1411
+ <font color="red">相关视频指引</font> <br>
1412
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
1413
+ */
1414
+ async UploadFiles(
1415
+ req: UploadFilesRequest,
1416
+ cb?: (error: string, rep: UploadFilesResponse) => void
1417
+ ): Promise<UploadFilesResponse> {
1418
+ return this.request("UploadFiles", req, cb)
1419
+ }
1420
+
1421
+ /**
1422
+ * 该接口用于发起合同后,生成用户的签署链接 <br/>
1423
+
1424
+ **注意**
1425
+ 1. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接 。
1426
+ 2. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。配置方式请参考:<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
1427
+ 如需跳转到小程序的实现,参考微信官方文档(分为<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>。
1428
+ 3. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
1429
+ */
1430
+ async ChannelCreateFlowSignUrl(
1431
+ req: ChannelCreateFlowSignUrlRequest,
1432
+ cb?: (error: string, rep: ChannelCreateFlowSignUrlResponse) => void
1433
+ ): Promise<ChannelCreateFlowSignUrlResponse> {
1434
+ return this.request("ChannelCreateFlowSignUrl", req, cb)
1435
+ }
1436
+
1437
+ /**
1438
+ * 此接口(CreateChannelOrganizationInfoChangeUrl)用于创建子客企业信息变更链接。
1439
+
1440
+ <h3 id="1">支持变更链接类型,通过入参 Endpoint 指定,默认为WEIXINAPP。</h3>
1441
+
1442
+ <h4 id="WEIXINAPP">WEIXINAPP</h4>
1443
+ <p>创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。</p>
1444
+
1445
+ <h4 id="APP">APP</h4>
1446
+ <p>创建变更小程序链接,可从第三方App跳转到微信腾讯电子签小程序进行更换。</p>
1447
+
1448
+
1449
+ <h3 id="2">支持创建企业超管变更链接或企业基础信息变更链接,通过入参 ChangeType 指定。</h3>
1450
+
1451
+ <h4 id="1-企业超管变更">1. 企业超管变更</h4>
1452
+
1453
+ <p>换成企业的其他员工来当超管</p>
1454
+
1455
+ <h4 id="2-企业基础信息变更">2. 企业基础信息变更</h4>
1456
+
1457
+ <h5 id="可以变动">可以变动</h5>
1458
+
1459
+ <ul>
1460
+ <li>企业名称<br>
1461
+ </li>
1462
+ <li>法定代表人姓名(新法人有邀请链接)<br>
1463
+ </li>
1464
+ <li>企业地址和所在地</li>
1465
+ </ul>
1466
+
1467
+ <h5 id="不可变动">不可变动</h5>
1468
+
1469
+ <ul>
1470
+ <li>统一社会信用代码<br>
1471
+ </li>
1472
+ <li>企业主体类型</li>
1473
+ </ul>
1474
+
1475
+ <p>如果企业名称变动会引起下面的变动</p>
1476
+
1477
+ <ul>
1478
+ <li>合同: 老合同不做任何处理, 新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
1479
+ <li>印章: 会删除所有的印章所有的机构公章,合同专用章,财务专用章和人事专用章, 然后用新企业名称生成新的机构公章,合同专用章,财务专用章和人事专用章, 而法人章不会处理</li>
1480
+ <li>证书: 企业证书会重新请求CA机构用新企业名称生成新的证书</li>
1481
+ </ul>
1482
+
1483
+
1484
+ 注意:
1485
+ 1. 生成的电子签小程序链接<font color='red'>只能由企业的法人或者超管</font>点击后进行操作, 其他员工打开后会提示“无权查看该内容”
1486
+ 2. 法人可以无需生成链接,直接在电子签小程序中更换本企业的超管
1487
+ */
1488
+ async CreateChannelOrganizationInfoChangeUrl(
1489
+ req: CreateChannelOrganizationInfoChangeUrlRequest,
1490
+ cb?: (error: string, rep: CreateChannelOrganizationInfoChangeUrlResponse) => void
1491
+ ): Promise<CreateChannelOrganizationInfoChangeUrlResponse> {
1492
+ return this.request("CreateChannelOrganizationInfoChangeUrl", req, cb)
1493
+ }
1494
+
1495
+ /**
1496
+ * 接口(ChannelCreateFlowGroupByFiles)用于使用 PDF 文件创建合同组签署流程。
1497
+
1498
+ - 该接口允许通过选择多个模板一次性创建多个合同,这些合同被组织在一个合同组中。
1499
+ - 每个签署方将收到一个签署链接,通过这个链接可以访问并签署合同组中的所有合同。
1500
+ - 合同组中的合同必须作为一个整体进行签署,不能将合同组拆分成单独的合同进行逐一签署。
1501
+
1502
+ <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
1503
+
1504
+
1505
+ ### 2. 适用场景
1506
+
1507
+ 该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
1508
+
1509
+ ### 3. 发起方要求和签署方实名要求
1510
+ - **发起方要求**:作为合同发起方的第三方子企业A的员工必须进行实名认证。
1511
+ - **签署方要求**:签署方可以是多种身份(如第三方子企业的员工、个人、SaaS平台企业员工),其中企业和员工可以不进行实名认证。
1512
+
1513
+ **可以作为发起方和签署方的角色列表**
1514
+
1515
+ <table>
1516
+ <thead>
1517
+ <tr>
1518
+ <th>场景编号</th>
1519
+ <th>可作为发起方类型</th>
1520
+ <th>可作为签署方的类型</th>
1521
+ </tr>
1522
+ </thead>
1523
+
1524
+ <tbody>
1525
+ <tr>
1526
+ <td>场景一</td>
1527
+ <td>第三方子企业A员工</td>
1528
+ <td>第三方子企业A员工</td>
1529
+ </tr>
1530
+
1531
+ <tr>
1532
+ <td>场景二</td>
1533
+ <td>第三方子企业A员工</td>
1534
+ <td>第三方子企业B员工</td>
1535
+ </tr>
1536
+
1537
+ <tr>
1538
+ <td>场景三</td>
1539
+ <td>第三方子企业A员工</td>
1540
+ <td>个人/自然人</td>
1541
+ </tr>
1542
+
1543
+ <tr>
1544
+ <td>场景四</td>
1545
+ <td>第三方子企业A员工</td>
1546
+ <td>SaaS平台企业员工</td>
1547
+ </tr>
1548
+ </tbody>
1549
+ </table>
1550
+
1551
+ ### 4. 签署方参数差异
1552
+ - 根据签署方的不同类型(第三方子企业的员工、个人、SaaS平台企业员工),传递的参数也不同。具体参数的结构和要求可以参考开发者中心提供的 `FlowApproverInfo` 结构体说明。
1553
+
1554
+ ### 5. 合同额度的扣减与返还
1555
+ - **扣减时机**:合同一旦发起,相关的合同额度就会被扣减,合同组下面的每个合同都要扣减一个合同额度。
1556
+ - **返还条件**:只有在合同被撤销且没有任何签署方签署过,或者只有自动签署的情况下,合同额度才会被返还。
1557
+ - **不返还的情况**:如果合同已过期、被拒签、签署完成或已解除,合同额度将不会被返还。
1558
+
1559
+ ### 6. 静默(自动)签署的限制
1560
+ - 在使用静默(自动)签署功能时,合同签署方不能有填写控件。<font color="red">此接口静默签(企业自动签)能力为白名单功能</font>,使用前请联系对接的客户经理沟通。
1561
+
1562
+ ### 7.合同组暂不支持抄送功能
1563
+ */
1564
+ async ChannelCreateFlowGroupByFiles(
1565
+ req: ChannelCreateFlowGroupByFilesRequest,
1566
+ cb?: (error: string, rep: ChannelCreateFlowGroupByFilesResponse) => void
1567
+ ): Promise<ChannelCreateFlowGroupByFilesResponse> {
1568
+ return this.request("ChannelCreateFlowGroupByFiles", req, cb)
1569
+ }
1570
+
1571
+ /**
1572
+ * 此接口用于查询合同或者合同组的详情信息,支持查询多个(数量不能超过100)。
1573
+
1574
+ 适用场景:可用于主动查询某个合同或者合同组的详情信息。
1575
+
1576
+ 注: `只能查询本企业创建的合同(创建合同用的Agent和此接口用的Agent数据最好一致) `
1577
+ */
1578
+ async DescribeFlowDetailInfo(
1579
+ req: DescribeFlowDetailInfoRequest,
1580
+ cb?: (error: string, rep: DescribeFlowDetailInfoResponse) => void
1581
+ ): Promise<DescribeFlowDetailInfoResponse> {
1582
+ return this.request("DescribeFlowDetailInfo", req, cb)
1583
+ }
1584
+
1585
+ /**
1586
+ * 通过此接口(ChannelDescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。可以支持单个子客和整个应用下所有子客的查询。
1587
+ <ul>
1588
+ <li>对于单个子客企业的查询,通过指定子客的唯一标识(Agent.ProxyOrganizationOpenId)来查询该子客消耗详情</li>
1589
+ <li>对于整个应用下所有企业的查询,不需要指定子客的唯一标识,只需要传入渠道应用标识(Agent.AppId)直接查询整个应用下所有子客企业消耗详情</li>
1590
+ </ul>
1591
+ */
1592
+ async ChannelDescribeBillUsageDetail(
1593
+ req: ChannelDescribeBillUsageDetailRequest,
1594
+ cb?: (error: string, rep: ChannelDescribeBillUsageDetailResponse) => void
1595
+ ): Promise<ChannelDescribeBillUsageDetailResponse> {
1596
+ return this.request("ChannelDescribeBillUsageDetail", req, cb)
1597
+ }
1598
+
1599
+ /**
1600
+ * 批量清理未认证的企业认证流程。
1601
+
1602
+ 此接口用来清除企业方认证信息填写错误,批量清理认证中的认证流信息。
1603
+ 为接口[提交子企业批量认证链接创建任务](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 接口的扩展接口。即在批量认证过程中,当发起认证企业发现超管信息错误的时候,可以将当前超管下的所有认证流企业清除。
1604
+
1605
+ 注意:
1606
+ **这个接口的操作人必须跟生成批量认证链接接口的应用号一致,才可以调用,否则会返回当前操作人没有认证中的企业认证流**
1607
+ */
1608
+ async DeleteOrganizationAuthorizations(
1609
+ req: DeleteOrganizationAuthorizationsRequest,
1610
+ cb?: (error: string, rep: DeleteOrganizationAuthorizationsResponse) => void
1611
+ ): Promise<DeleteOrganizationAuthorizationsResponse> {
1612
+ return this.request("DeleteOrganizationAuthorizations", req, cb)
1613
+ }
1614
+
1615
+ /**
1616
+ * 在已启动的签署流程中,可对签署截止日期进行延期操作,主要分为以下两个层面:
1617
+ 1. <b> 合同(流程)层面</b>:仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
1618
+ 2. <b> 签署人层面</b> :需提供流程ID和签署人ID。此操作针对特定签署人进行延期,特别是对于有序合同(流程),签署截止时间不得超过后续签署人的流程截止时间。
1619
+
1620
+ 此接口存在以下限制:
1621
+ 1. 执行操作的员工须为<font color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
1622
+ 2. 延长整个签署流程时,<font color="red">应至少有一方尚未签署</font>(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
1623
+ 3. 延长整个签署流程时,新的签署截止日期应晚于已设定的签署截止日期和当前日期。
1624
+ 4. 延长签署方截止时间时,<font color="red">签署方不能处于流程完结或已终止状态</font>(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
1625
+ 5. 延长签署方截止时间时,新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同,还需早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
1626
+ 6. <font color="red">不支持操作合同组合同</font>。
1627
+
1628
+ 合同(流程)层面截止时间子企业控制台展示的位置:
1629
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/f0f88c0eb49a926da9a86e5a6e9efa8b.png)
1630
+ */
1631
+ async ModifyFlowDeadline(
1632
+ req: ModifyFlowDeadlineRequest,
1633
+ cb?: (error: string, rep: ModifyFlowDeadlineResponse) => void
1634
+ ): Promise<ModifyFlowDeadlineResponse> {
1635
+ return this.request("ModifyFlowDeadline", req, cb)
1636
+ }
1637
+
1638
+ /**
1639
+ * 通过此接口,可以创建企业批量签署链接,员工只需点击链接即可跳转至控制台进行批量签署。
1640
+
1641
+ 注:
1642
+ - 员工必须在企业下完成实名认证,且需作为批量签署合同的签署方或者领取方。
1643
+ - 仅支持传入待签署或者待领取的合同,待填写暂不支持。
1644
+ - 员工批量签署,支持多种签名方式,包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
1645
+
1646
+ 签署的嵌入页面长相如下:
1647
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/a4754bc835a3f837ddec1e28b02ed9c0.png)
1648
+ */
1649
+ async ChannelCreateOrganizationBatchSignUrl(
1650
+ req: ChannelCreateOrganizationBatchSignUrlRequest,
1651
+ cb?: (error: string, rep: ChannelCreateOrganizationBatchSignUrlResponse) => void
1652
+ ): Promise<ChannelCreateOrganizationBatchSignUrlResponse> {
1653
+ return this.request("ChannelCreateOrganizationBatchSignUrl", req, cb)
1654
+ }
1655
+
1656
+ /**
1657
+ * 将指定印章授权给第三方平台子客企业下的某些员工
1658
+ */
1659
+ async ChannelCreateSealPolicy(
1660
+ req: ChannelCreateSealPolicyRequest,
1661
+ cb?: (error: string, rep: ChannelCreateSealPolicyResponse) => void
1662
+ ): Promise<ChannelCreateSealPolicyResponse> {
1663
+ return this.request("ChannelCreateSealPolicy", req, cb)
1664
+ }
1665
+
1666
+ /**
1667
+ * 通过接口[批量撤销合同流程](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelBatchCancelFlows)或者[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateBatchCancelFlowUrl)发起批量撤销任务后,可通过此接口查询批量撤销任务的结果。
1668
+ */
1669
+ async DescribeCancelFlowsTask(
1670
+ req: DescribeCancelFlowsTaskRequest,
1671
+ cb?: (error: string, rep: DescribeCancelFlowsTaskResponse) => void
1672
+ ): Promise<DescribeCancelFlowsTaskResponse> {
1673
+ return this.request("DescribeCancelFlowsTask", req, cb)
1674
+ }
1675
+
1676
+ /**
1677
+ * 此接口(CreateConsoleLoginUrl)用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。
1678
+
1679
+ Web链接访问后,会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态,进入不同的流程,主要情况分类如下:
1680
+ <table>
1681
+ <thead>
1682
+ <tr>
1683
+ <th>子客企业状态</th>
1684
+ <th>子客企业员工状态</th>
1685
+ <th>点击链接进入的流程</th>
1686
+ </tr>
1687
+ </thead>
1688
+ <tbody>
1689
+ <tr>
1690
+ <td>企业未激活</td>
1691
+ <td>员工未认证</td>
1692
+ <td>进入企业激活流程,首次完成企业激活流程的员工会成为超管</td>
1693
+ </tr>
1694
+ <tr>
1695
+ <td>企业已激活</td>
1696
+ <td>员工未认证</td>
1697
+ <td>进入员工认证并加入企业流程</td>
1698
+ </tr>
1699
+ <tr>
1700
+ <td>企业已激活</td>
1701
+ <td>员工已认证</td>
1702
+ <td>进入子客企业Web控制台</td>
1703
+ </tr>
1704
+ </tbody>
1705
+ </table>
1706
+ 如果是企业激活流程,需要注意如下情况:
1707
+
1708
+ 1. 若在激活过程中,**更换用户OpenID重新生成链接,之前的认证会被清理**。因此不要在企业认证过程生成多个链接给多人同时操作,会导致认证过程互相影响。
1709
+ 2. 若您认证中发现信息有误需要重新认证,**可通过更换用户OpenID重新生成链接的方式,来清理掉已有的流程**。
1653
1710
 
1654
- 注意:
1655
- - 使用此功能**需搭配出证套餐** ,使用前请联系对接的客户经理沟通。
1656
- - 操作人必须是**发起方或者签署方企业的(非走授权书认证)法人或者超管**。
1657
- - 合同流程必须**所有参与方已经签署完成**。
1658
- - 出证过程需一定时间,建议在**提交出证任务后的24小时之后**,通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
1711
+ 系统的渠道企业, 应用, 子客企业, 子客员工的组织形式
1712
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/77677faeea26c9d7f37474597c81fe01.png)
1659
1713
 
1660
1714
 
1661
- ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
1715
+ <font color="red">相关视频指引</font> <br>
1716
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-createconsoleloginin.mp4" target="_blank">【生成子客登录链接】代码编写 & 子企业认证示例</a><br>
1662
1717
  */
1663
- async CreateChannelFlowEvidenceReport(
1664
- req: CreateChannelFlowEvidenceReportRequest,
1665
- cb?: (error: string, rep: CreateChannelFlowEvidenceReportResponse) => void
1666
- ): Promise<CreateChannelFlowEvidenceReportResponse> {
1667
- return this.request("CreateChannelFlowEvidenceReport", req, cb)
1718
+ async CreateConsoleLoginUrl(
1719
+ req: CreateConsoleLoginUrlRequest,
1720
+ cb?: (error: string, rep: CreateConsoleLoginUrlResponse) => void
1721
+ ): Promise<CreateConsoleLoginUrlResponse> {
1722
+ return this.request("CreateConsoleLoginUrl", req, cb)
1668
1723
  }
1669
1724
 
1670
1725
  /**
1671
- * 接口(ChannelCreateFlowGroupByTemplates)用于通过多模板创建合同组签署流程。
1672
-
1673
- - 该接口允许通过选择多个模板一次性创建多个合同,这些合同被组织在一个合同组中。
1674
- - 每个签署方将收到一个签署链接,通过这个链接可以访问并签署合同组中的所有合同。
1675
- - 合同组中的合同必须作为一个整体进行签署,不能将合同组拆分成单独的合同进行逐一签署。
1676
-
1677
- <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
1678
-
1679
- ### 2. 适用场景
1680
-
1681
- 该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
1726
+ * 通过此接口指定合同、签署人、填写控件等信息,生成嵌入式链接,此链接可以嵌入到其他网页或者直接打开,打开后进入发起页面。在此页面上,合同信息和签署人信息均不可更改。
1682
1727
 
1683
- ### 3. 发起方要求和签署方实名要求
1684
- - **发起方要求**:作为合同发起方的第三方子企业A的员工必须进行实名认证。
1685
- - **签署方要求**:签署方可以是多种身份(如第三方子企业的员工、个人、SaaS平台企业员工),其中企业和员工可以不进行实名认证。
1728
+ 注意:
1729
+ 1. <font color="red">仅支持在PC浏览器</font>上进行操作和使用。
1730
+ 2. 在使用<font color="red">模板发起合同时,需指定RecipientId</font>以明确参与方在模板中所扮演的角色。
1686
1731
 
1687
- **可以作为发起方和签署方的角色列表**
1732
+ **嵌入式签署人-各种场景传参说明**:
1688
1733
 
1689
1734
  <table>
1690
1735
  <thead>
1691
1736
  <tr>
1692
1737
  <th>场景编号</th>
1693
- <th>可作为发起方类型</th>
1694
1738
  <th>可作为签署方的类型</th>
1739
+ <th>签署方传参说明</th>
1695
1740
  </tr>
1696
1741
  </thead>
1697
1742
 
1698
1743
  <tbody>
1699
1744
  <tr>
1700
1745
  <td>场景一</td>
1701
- <td>第三方子企业A员工</td>
1702
- <td>第三方子企业A员工</td>
1746
+ <td>第三方子企业员工</td>
1747
+ <td>OpenId、OrganizationName、OrganizationOpenId必传 ,ApproverType设置为0</td>
1703
1748
  </tr>
1704
1749
  <tr>
1705
1750
  <td>场景二</td>
1706
- <td>第三方子企业A员工</td>
1707
- <td>第三方子企业B员工</td>
1751
+ <td>SaaS平台企业员工</td>
1752
+ <td>Name、Mobile、OrganizationName必传,NotChannelOrganization=True。 ApproverType设置为0</td>
1708
1753
  </tr>
1709
-
1710
1754
  <tr>
1711
1755
  <td>场景三</td>
1712
- <td>第三方子企业A员工</td>
1713
1756
  <td>个人/自然人</td>
1714
- </tr>
1715
-
1716
- <tr>
1717
- <td>场景四</td>
1718
- <td>第三方子企业A员工</td>
1719
- <td>SaaS平台企业员工</td>
1757
+ <td>Name、Mobile必传, ApproverType设置为1</td>
1720
1758
  </tr>
1721
1759
  </tbody>
1722
1760
  </table>
1723
1761
 
1724
- ### 4. 签署方参数差异
1725
- - 根据签署方的不同类型(第三方子企业的员工、个人、SaaS平台企业员工),传递的参数也不同。具体参数的结构和要求可以参考开发者中心提供的 `FlowApproverInfo` 结构体说明。
1762
+ 嵌入的页面样式如下:
1763
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/b2ae013fb4d747891dd3815bbe897208.png)
1764
+ */
1765
+ async ChannelCreatePrepareFlow(
1766
+ req: ChannelCreatePrepareFlowRequest,
1767
+ cb?: (error: string, rep: ChannelCreatePrepareFlowResponse) => void
1768
+ ): Promise<ChannelCreatePrepareFlowResponse> {
1769
+ return this.request("ChannelCreatePrepareFlow", req, cb)
1770
+ }
1726
1771
 
1727
- ### 5. 合同额度的扣减与返还
1728
- - **扣减时机**:合同一旦发起,相关的合同额度就会被扣减,合同组下面的每个合同都要扣减一个合同额度。
1729
- - **返还条件**:只有在合同被撤销且没有任何签署方签署过,或者只有自动签署的情况下,合同额度才会被返还。
1730
- - **不返还的情况**:如果合同已过期、被拒签、签署完成或已解除,合同额度将不会被返还。
1772
+ /**
1773
+ * 通过合同编号生成批量撤销合同的链接,单次最多支持撤销100份合同, 返回的链接需要有此权限的人<font color='red'>**合同的发起人(并已经授予撤销权限)或者发起人所在企业的超管、法人**</font>在<font color='red'>**手机端**</font>打开, 跳转到腾讯电子签小程序输入撤销原因来进行撤销合同
1731
1774
 
1732
- ### 6. 静默(自动)签署的限制
1733
- - 在使用静默(自动)签署功能时,合同签署方不能有填写控件。<font color="red">此接口静默签(企业自动签)能力为白名单功能</font>,使用前请联系对接的客户经理沟通。
1775
+ 适用场景:如果某个合同当前**至少还有一方没有签署**,则可通过该接口取消该合同流程。常用于合同发错、内容填错,需要及时撤销的场景。
1734
1776
 
1735
- ### 7.合同组暂不支持抄送功能
1777
+ - **可撤回合同状态**:未全部签署完成
1778
+ - **不撤回合同状态**:已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
1779
+
1780
+ 批量撤销结果可以通过接口返回的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)主动查询。
1781
+
1782
+ 注:
1783
+ - 签署完毕的合同需要双方走解除流程将合同作废,可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
1784
+ - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同,才会返还合同额度。</font>
1785
+ - 撤销后可以看合同PDF内容的人员: 发起方的超管, 发起方自己,发起方撤销合同的操作人员,已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员, 其他参与人员看不到合同的内容。
1736
1786
  */
1737
- async ChannelCreateFlowGroupByTemplates(
1738
- req: ChannelCreateFlowGroupByTemplatesRequest,
1739
- cb?: (error: string, rep: ChannelCreateFlowGroupByTemplatesResponse) => void
1740
- ): Promise<ChannelCreateFlowGroupByTemplatesResponse> {
1741
- return this.request("ChannelCreateFlowGroupByTemplates", req, cb)
1787
+ async ChannelCreateBatchCancelFlowUrl(
1788
+ req: ChannelCreateBatchCancelFlowUrlRequest,
1789
+ cb?: (error: string, rep: ChannelCreateBatchCancelFlowUrlResponse) => void
1790
+ ): Promise<ChannelCreateBatchCancelFlowUrlResponse> {
1791
+ return this.request("ChannelCreateBatchCancelFlowUrl", req, cb)
1742
1792
  }
1743
1793
 
1744
1794
  /**
1745
- * 支持企业进行批量初始化操作:
1795
+ * 此接口(ChannelDeleteRole)用来删除企业自定义角色。
1746
1796
 
1747
- 此接口存在以下限制:
1748
- 1. 批量操作的企业需要已经完成电子签的认证流程。
1749
- 2. 通过此接口生成的链接在小程序端进行操作时,操作人需要是<font color="red">所有企业的超管或法人</font>。
1750
- 3. 批量操作的企业,需要是本方第三方应用下的企业。
1751
- 4. <font color="red">操作链接过期时间默认为生成链接后7天。</font>
1797
+ 注:**系统角色不可删除。**
1752
1798
  */
1753
- async CreateBatchInitOrganizationUrl(
1754
- req: CreateBatchInitOrganizationUrlRequest,
1755
- cb?: (error: string, rep: CreateBatchInitOrganizationUrlResponse) => void
1756
- ): Promise<CreateBatchInitOrganizationUrlResponse> {
1757
- return this.request("CreateBatchInitOrganizationUrl", req, cb)
1799
+ async ChannelDeleteRole(
1800
+ req: ChannelDeleteRoleRequest,
1801
+ cb?: (error: string, rep: ChannelDeleteRoleResponse) => void
1802
+ ): Promise<ChannelDeleteRoleResponse> {
1803
+ return this.request("ChannelDeleteRole", req, cb)
1758
1804
  }
1759
1805
 
1760
1806
  /**
1761
- * 此接口(CreateChannelOrganizationInfoChangeUrl)用于创建子客企业信息变更链接。
1762
-
1763
- <h3 id="1">支持变更链接类型,通过入参 Endpoint 指定,默认为WEIXINAPP。</h3>
1764
-
1765
- <h4 id="WEIXINAPP">WEIXINAPP</h4>
1766
- <p>创建变更短链。需要在移动端打开,会跳转到微信腾讯电子签小程序进行更换。</p>
1767
-
1768
- <h4 id="APP">APP</h4>
1769
- <p>创建变更小程序链接,可从第三方App跳转到微信腾讯电子签小程序进行更换。</p>
1770
-
1771
-
1772
- <h3 id="2">支持创建企业超管变更链接或企业基础信息变更链接,通过入参 ChangeType 指定。</h3>
1773
-
1774
- <h4 id="1-企业超管变更">1. 企业超管变更</h4>
1775
-
1776
- <p>换成企业的其他员工来当超管</p>
1777
-
1778
- <h4 id="2-企业基础信息变更">2. 企业基础信息变更</h4>
1779
-
1780
- <h5 id="可以变动">可以变动</h5>
1781
-
1782
- <ul>
1783
- <li>企业名称<br>
1784
- </li>
1785
- <li>法定代表人姓名(新法人有邀请链接)<br>
1786
- </li>
1787
- <li>企业地址和所在地</li>
1788
- </ul>
1789
-
1790
- <h5 id="不可变动">不可变动</h5>
1807
+ * 此接口(SyncProxyOrganization)用于同步第三方平台子客企业信息,包括企业名称、企业营业执照、企业统一社会信用代码和法人姓名等,便于子客企业在企业激活过程中无需手动上传营业执照或补充企业信息。
1791
1808
 
1792
- <ul>
1793
- <li>统一社会信用代码<br>
1794
- </li>
1795
- <li>企业主体类型</li>
1796
- </ul>
1809
+ 注意:
1797
1810
 
1798
- <p>如果企业名称变动会引起下面的变动</p>
1811
+ - **需要在<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>前同步的企业信息**, 否则会出现信息同步没有用的情形
1812
+ - **企业信息需要和营业执照信息对应**, 否则会出现激活过程验证不通过的问题
1799
1813
 
1800
- <ul>
1801
- <li>合同: 老合同不做任何处理, 新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
1802
- <li>印章: 会删除所有的印章所有的机构公章,合同专用章,财务专用章和人事专用章, 然后用新企业名称生成新的机构公章,合同专用章,财务专用章和人事专用章, 而法人章不会处理</li>
1803
- <li>证书: 企业证书会重新请求CA机构用新企业名称生成新的证书</li>
1804
- </ul>
1814
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/7ec91b79a0a4860e77c9ff9f4a5f13ad/channel_SyncProxyOrganization2.png)
1805
1815
 
1806
1816
 
1807
- 注意:
1808
- 1. 生成的电子签小程序链接<font color='red'>只能由企业的法人或者超管</font>点击后进行操作, 其他员工打开后会提示“无权查看该内容”
1809
- 2. 法人可以无需生成链接,直接在电子签小程序中更换本企业的超管
1817
+ - **企业统一社会信用代码**: 对应上图中的**1**
1818
+ - **第三方平台子客企业名称**: 对应上图中的**2**
1819
+ - **企业法定代表人的名字**:对应上图中的**3**
1820
+ - **企业详细住所**:对应上图中的**4**
1810
1821
  */
1811
- async CreateChannelOrganizationInfoChangeUrl(
1812
- req: CreateChannelOrganizationInfoChangeUrlRequest,
1813
- cb?: (error: string, rep: CreateChannelOrganizationInfoChangeUrlResponse) => void
1814
- ): Promise<CreateChannelOrganizationInfoChangeUrlResponse> {
1815
- return this.request("CreateChannelOrganizationInfoChangeUrl", req, cb)
1822
+ async SyncProxyOrganization(
1823
+ req: SyncProxyOrganizationRequest,
1824
+ cb?: (error: string, rep: SyncProxyOrganizationResponse) => void
1825
+ ): Promise<SyncProxyOrganizationResponse> {
1826
+ return this.request("SyncProxyOrganization", req, cb)
1816
1827
  }
1817
1828
 
1818
1829
  /**
1819
- * 此接口(SyncProxyOrganizationOperators)用于同步 第三方平台子客企业经办人列表,主要是同步经办人的离职状态。
1820
- 子客Web控制台的组织架构管理,依赖于第三方应用平台的,无法在页面针对员工做新增/更新/离职等操作, 必须通过 API 来操作。
1830
+ * 此接口(ChannelUpdateSealStatus)用于第三方应用平台为子客企业更新印章状态。
1831
+ */
1832
+ async ChannelUpdateSealStatus(
1833
+ req: ChannelUpdateSealStatusRequest,
1834
+ cb?: (error: string, rep: ChannelUpdateSealStatusResponse) => void
1835
+ ): Promise<ChannelUpdateSealStatusResponse> {
1836
+ return this.request("ChannelUpdateSealStatus", req, cb)
1837
+ }
1821
1838
 
1822
- - **新增员工的场景**: 通过本接口提前导入员工列表, 然后调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>分享给对应的员工进行实名, 新增员工后员工的状态为**未实名**, 通过链接实名后状态变为**已实名**, 已实名员工就可以参与合同的发起。
1839
+ /**
1840
+ * 通过此接口,创建小程序批量签署链接,个人/企业员工点击此链接即可跳转小程序进行批量签署。
1841
+ 请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。
1823
1842
 
1824
- - **员工离职的场景**: 通过本接口将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了, 同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空, 再次加入公司会从零开始) , 若员工信息有误可通过离职后在新增来解决, 离职员工状态为**离职**。
1843
+ 注:
1844
+ - 使用此接口生成链接,需要提前开通 `个人签署方仅校验手机号` 功能,在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
1845
+ - 个人参与方点击链接后需短信验证码才能查看合同内容。
1846
+ - 个人用户批量签署,需要传Name,Mobile,IdCardNumber(IdCardType) 参数。
1847
+ - saas企业员工用户批量签署,在传递了姓名等基本信息参数的情况下,还需要传OrganizationName(参与方所在企业名称)参数生成签署链接,<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。
1848
+ - 子客企业员工用户批量签署,需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证,且OpenId对应员工此子客下已经实名</font>。Name,Mobile, IdCard等信息此时可以不传,系统会查询此OpenId实名信息自动补充。
1849
+ - 生成批量签署链接时,合同目标参与方状态需为<font color="red">待签署</font>状态。
1850
+ - 个人批量签署进行的合同的签名区, 全部变成<font color="red">手写签名</font>(不管合同里边设置的签名限制)来进行。
1851
+ - 不支持签署方含有签批控件,或设置了签署方在签署时自行添加签署控件功能的合同进行批量签署。
1852
+ */
1853
+ async ChannelCreateBatchSignUrl(
1854
+ req: ChannelCreateBatchSignUrlRequest,
1855
+ cb?: (error: string, rep: ChannelCreateBatchSignUrlResponse) => void
1856
+ ): Promise<ChannelCreateBatchSignUrlResponse> {
1857
+ return this.request("ChannelCreateBatchSignUrl", req, cb)
1858
+ }
1825
1859
 
1826
- ![image](https://qcloudimg.tencent-cloud.cn/raw/7a27a6bb0e4d39c2f6aa2a0b39946181/channel_SyncProxyOrganizationOperators.png)
1860
+ /**
1861
+ * 给医疗个人自动签许可续期。续期成功后,可对医疗自动签许可追加一年有效期,只可续期一次。
1827
1862
 
1828
- **注**:
1829
- - 新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理
1830
- - <font color='red'>超管和法人无法通过此接口离职</font>, 需要超管和法人将权限转移给其他人后才可通过此接口离职
1831
- - 新增员工的场景同ID不同员工会覆盖掉上一个同ID的员工, 如果上一个员工已经实名则不会被覆盖
1863
+ 注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
1832
1864
  */
1833
- async SyncProxyOrganizationOperators(
1834
- req: SyncProxyOrganizationOperatorsRequest,
1835
- cb?: (error: string, rep: SyncProxyOrganizationOperatorsResponse) => void
1836
- ): Promise<SyncProxyOrganizationOperatorsResponse> {
1837
- return this.request("SyncProxyOrganizationOperators", req, cb)
1865
+ async ChannelRenewAutoSignLicense(
1866
+ req: ChannelRenewAutoSignLicenseRequest,
1867
+ cb?: (error: string, rep: ChannelRenewAutoSignLicenseResponse) => void
1868
+ ): Promise<ChannelRenewAutoSignLicenseResponse> {
1869
+ return this.request("ChannelRenewAutoSignLicense", req, cb)
1838
1870
  }
1839
1871
 
1840
1872
  /**
1841
- * 通过此接口(ChannelDescribeAccountBillDetail)查询该第三方平台子客账号计费详情。
1842
- <ul>
1843
- <li>对于渠道客户企业的查询,通过指定渠道企业的唯一标识(Agent.ProxyOrganizationId)来查询子客账号消耗详情</li>
1844
- </ul>
1873
+ * 通过此接口获取个人用户自动签的开通状态。
1874
+
1875
+ 注意: `处方单等特殊场景专用,此接口为白名单功能,使用前请联系对接的客户经理沟通。`
1845
1876
  */
1846
- async ChannelDescribeAccountBillDetail(
1847
- req: ChannelDescribeAccountBillDetailRequest,
1848
- cb?: (error: string, rep: ChannelDescribeAccountBillDetailResponse) => void
1849
- ): Promise<ChannelDescribeAccountBillDetailResponse> {
1850
- return this.request("ChannelDescribeAccountBillDetail", req, cb)
1877
+ async ChannelDescribeUserAutoSignStatus(
1878
+ req: ChannelDescribeUserAutoSignStatusRequest,
1879
+ cb?: (error: string, rep: ChannelDescribeUserAutoSignStatusResponse) => void
1880
+ ): Promise<ChannelDescribeUserAutoSignStatusResponse> {
1881
+ return this.request("ChannelDescribeUserAutoSignStatus", req, cb)
1851
1882
  }
1852
1883
 
1853
1884
  /**
1854
- * 获取出证报告任务执行结果,返回报告 URL。
1885
+ * 发起解除协议的主要应用场景为:基于一份已经签署的合同(签署流程),进行解除操作。
1886
+ 解除协议的模板是官方提供,经过提供法务审核,暂不支持自定义。具体用法可以参考文档[合同解除](https://qian.tencent.com/developers/partner/flow_release)。
1855
1887
 
1856
1888
  注意:
1889
+ <ul><li><code>原合同必须签署完</code>成后才能发起解除协议。</li>
1890
+ <li>只有原合同企业类型的参与人才能发起解除协议,<code>个人参与方不能发起解除协议</code>。</li>
1891
+ <li>原合同个人类型参与人必须是解除协议的参与人,<code>不能更换其他第三方个人</code>参与解除协议。</li>
1892
+ <li>如果原合同企业参与人无法参与解除协议,可以指定同企业具有同等权限的<code>企业员工代为处理</code>。</li>
1893
+ <li>发起解除协议同发起其他企业合同一样,也会参与合同<code>扣费</code>,扣费标准同其他类型合同。</li>
1894
+ <li>在解除协议签署完毕后,原合同及解除协议均变为已解除状态。</li>
1895
+ <li>非原合同企业参与人发起解除协议时,需要有<code>解除合同的权限</code>。</li>
1896
+ </ul>
1897
+ */
1898
+ async ChannelCreateReleaseFlow(
1899
+ req: ChannelCreateReleaseFlowRequest,
1900
+ cb?: (error: string, rep: ChannelCreateReleaseFlowResponse) => void
1901
+ ): Promise<ChannelCreateReleaseFlowResponse> {
1902
+ return this.request("ChannelCreateReleaseFlow", req, cb)
1903
+ }
1857
1904
 
1858
- - 使用此功能`需搭配出证套餐` ,使用前请联系对接的客户经理沟通。
1859
- - 需调用创建并返回出证报告接口<a href="https://qian.tencent.com/developers/partnerApis/certificate/CreateChannelFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>获取报告编号后调用当前接口获取报告链接。
1905
+ /**
1906
+ * 获取企业员工信息, 可以获取员工的名字,OpenId,UserId和简述的角色等信息,支持设置过滤条件以筛选员工查询结果。
1860
1907
 
1861
- ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
1908
+ **注**:通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/SyncProxyOrganizationOperators" target="_blank">企业员工新增或离职</a>接口增加的新员工或者离职的员工也会在列表中。
1862
1909
  */
1863
- async DescribeChannelFlowEvidenceReport(
1864
- req: DescribeChannelFlowEvidenceReportRequest,
1865
- cb?: (error: string, rep: DescribeChannelFlowEvidenceReportResponse) => void
1866
- ): Promise<DescribeChannelFlowEvidenceReportResponse> {
1867
- return this.request("DescribeChannelFlowEvidenceReport", req, cb)
1910
+ async ChannelDescribeEmployees(
1911
+ req: ChannelDescribeEmployeesRequest,
1912
+ cb?: (error: string, rep: ChannelDescribeEmployeesResponse) => void
1913
+ ): Promise<ChannelDescribeEmployeesResponse> {
1914
+ return this.request("ChannelDescribeEmployees", req, cb)
1868
1915
  }
1869
1916
 
1870
1917
  /**
1871
- * 此接口(OperateChannelTemplate)用于针对第三方应用平台模板库中的模板对子客企业发布授权的查询和设置。
1872
- 平台模板库中的模板的位置在控制台 企业应用管理 中下面的应用模板库管理目录, 可以参照下图位置
1873
- ![image](https://qcloudimg.tencent-cloud.cn/raw/7f2b6c94164b3e931efc9a037e0400f7.png)
1874
-
1875
- # 支持的操作
1918
+ * 该接口用于结束动态签署方2.0的合同流程。
1876
1919
 
1877
- ## 1. 查询模板的子客企业授权 (OperateType=SELECT)
1878
- - 查询模板的授权子企业列表
1879
1920
 
1880
- ## 2. 修改模板的子客企业授权 (OperateType=UPDATE)
1881
- - 当模板未发布时,可以修改模板的模板授权范围是**所有第三方应用合作企业**(AuthTag设置为all)或者**指定第三方应用合作企业**(AuthTag设置为part),**当模板发布后,不可做此修改**
1882
- - 如果模板是部分授权, 可通过ProxyOrganizationOpenIds增加子客的授权范围。
1921
+ **功能开通**
1922
+ - 动态签署方2.0功能的使用需要先<font color="red">联系产品经理开通模块化计费功能</font>,然后到控制台中打开此功能。详细的使用说明请参考<a href="https://qian.tencent.com/developers/company/dynamic_signer_v2" target="_blank">动态签署方2.0</a>文档。
1883
1923
 
1884
- ## 3. 取消模板的子客企业授权 (OperateType=DELETE)
1885
- - 对子客企业进行模板库中模板授权范围的进行删除操作。
1886
- - 主要对于手动领取的模板,去除授权后子客在模板库中看不到,就无法再领取了。但是**已经领取过成为自有模板的不会同步删除**。
1887
- - 对于自动领取的模板,由于已经下发,更改授权不会影响。
1888
- - 如果要同步删除子客自有模板库中的模板,请使用OperateType=UPDATE+Available参数处理。
1924
+ **使用条件**
1925
+ - 此接口只能在<font color="red">合同处于非终态且<b>所有的签署方都已经完成签署</b></font>。一旦合同进入终态(例如:过期、拒签、撤销或者调用过此接口成功过),将无法通过此接口结束合同流程。
1889
1926
  */
1890
- async OperateChannelTemplate(
1891
- req: OperateChannelTemplateRequest,
1892
- cb?: (error: string, rep: OperateChannelTemplateResponse) => void
1893
- ): Promise<OperateChannelTemplateResponse> {
1894
- return this.request("OperateChannelTemplate", req, cb)
1895
- }
1896
-
1897
- /**
1898
- * 本接口(ChannelCreatePreparedPersonalEsign)用于创建导入个人印章(处方单场景专用,使用此接口请与客户经理确认)。
1899
- */
1900
- async ChannelCreatePreparedPersonalEsign(
1901
- req: ChannelCreatePreparedPersonalEsignRequest,
1902
- cb?: (error: string, rep: ChannelCreatePreparedPersonalEsignResponse) => void
1903
- ): Promise<ChannelCreatePreparedPersonalEsignResponse> {
1904
- return this.request("ChannelCreatePreparedPersonalEsign", req, cb)
1927
+ async ArchiveDynamicFlow(
1928
+ req: ArchiveDynamicFlowRequest,
1929
+ cb?: (error: string, rep: ArchiveDynamicFlowResponse) => void
1930
+ ): Promise<ArchiveDynamicFlowResponse> {
1931
+ return this.request("ArchiveDynamicFlow", req, cb)
1905
1932
  }
1906
1933
 
1907
1934
  /**
@@ -1920,7 +1947,21 @@ Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批
1920
1947
  }
1921
1948
 
1922
1949
  /**
1923
- * 接口(ChannelCreateFlowGroupByFiles)用于使用 PDF 文件创建合同组签署流程。
1950
+ * 使用此接口,用来绑定企业实名员工的角色,
1951
+ 支持以电子签userId、客户系统openId两种方式进行绑定。
1952
+
1953
+ 对应控制台的操作如下图
1954
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/5b41194d3cb3f2058ec0ba0fb5ebc6a6.png)
1955
+ */
1956
+ async ChannelCreateUserRoles(
1957
+ req: ChannelCreateUserRolesRequest,
1958
+ cb?: (error: string, rep: ChannelCreateUserRolesResponse) => void
1959
+ ): Promise<ChannelCreateUserRolesResponse> {
1960
+ return this.request("ChannelCreateUserRoles", req, cb)
1961
+ }
1962
+
1963
+ /**
1964
+ * 接口(ChannelCreateFlowGroupByTemplates)用于通过多模板创建合同组签署流程。
1924
1965
 
1925
1966
  - 该接口允许通过选择多个模板一次性创建多个合同,这些合同被组织在一个合同组中。
1926
1967
  - 每个签署方将收到一个签署链接,通过这个链接可以访问并签署合同组中的所有合同。
@@ -1928,7 +1969,6 @@ Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批
1928
1969
 
1929
1970
  <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
1930
1971
 
1931
-
1932
1972
  ### 2. 适用场景
1933
1973
 
1934
1974
  该接口适用于需要一次性完成多份合同签署的情况,多份合同一般具有关联性,用户以目录的形式查看合同。
@@ -1954,7 +1994,6 @@ Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批
1954
1994
  <td>第三方子企业A员工</td>
1955
1995
  <td>第三方子企业A员工</td>
1956
1996
  </tr>
1957
-
1958
1997
  <tr>
1959
1998
  <td>场景二</td>
1960
1999
  <td>第三方子企业A员工</td>
@@ -1988,11 +2027,77 @@ Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批
1988
2027
 
1989
2028
  ### 7.合同组暂不支持抄送功能
1990
2029
  */
1991
- async ChannelCreateFlowGroupByFiles(
1992
- req: ChannelCreateFlowGroupByFilesRequest,
1993
- cb?: (error: string, rep: ChannelCreateFlowGroupByFilesResponse) => void
1994
- ): Promise<ChannelCreateFlowGroupByFilesResponse> {
1995
- return this.request("ChannelCreateFlowGroupByFiles", req, cb)
2030
+ async ChannelCreateFlowGroupByTemplates(
2031
+ req: ChannelCreateFlowGroupByTemplatesRequest,
2032
+ cb?: (error: string, rep: ChannelCreateFlowGroupByTemplatesResponse) => void
2033
+ ): Promise<ChannelCreateFlowGroupByTemplatesResponse> {
2034
+ return this.request("ChannelCreateFlowGroupByTemplates", req, cb)
2035
+ }
2036
+
2037
+ /**
2038
+ * 获取出证报告任务执行结果,返回报告 URL。
2039
+
2040
+ 注意:
2041
+
2042
+ - 使用此功能`需搭配出证套餐` ,使用前请联系对接的客户经理沟通。
2043
+ - 需调用创建并返回出证报告接口<a href="https://qian.tencent.com/developers/partnerApis/certificate/CreateChannelFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>获取报告编号后调用当前接口获取报告链接。
2044
+
2045
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
2046
+ */
2047
+ async DescribeChannelFlowEvidenceReport(
2048
+ req: DescribeChannelFlowEvidenceReportRequest,
2049
+ cb?: (error: string, rep: DescribeChannelFlowEvidenceReportResponse) => void
2050
+ ): Promise<DescribeChannelFlowEvidenceReportResponse> {
2051
+ return this.request("DescribeChannelFlowEvidenceReport", req, cb)
2052
+ }
2053
+
2054
+ /**
2055
+ * 此接口(OperateChannelTemplate)用于针对第三方应用平台模板库中的模板对子客企业发布授权的查询和设置。
2056
+ 平台模板库中的模板的位置在控制台 企业应用管理 中下面的应用模板库管理目录, 可以参照下图位置
2057
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/7f2b6c94164b3e931efc9a037e0400f7.png)
2058
+
2059
+ # 支持的操作
2060
+
2061
+ ## 1. 查询模板的子客企业授权 (OperateType=SELECT)
2062
+ - 查询模板的授权子企业列表
2063
+
2064
+ ## 2. 修改模板的子客企业授权 (OperateType=UPDATE)
2065
+ - 当模板未发布时,可以修改模板的模板授权范围是**所有第三方应用合作企业**(AuthTag设置为all)或者**指定第三方应用合作企业**(AuthTag设置为part),**当模板发布后,不可做此修改**
2066
+ - 如果模板是部分授权, 可通过ProxyOrganizationOpenIds增加子客的授权范围。
2067
+
2068
+ ## 3. 取消模板的子客企业授权 (OperateType=DELETE)
2069
+ - 对子客企业进行模板库中模板授权范围的进行删除操作。
2070
+ - 主要对于手动领取的模板,去除授权后子客在模板库中看不到,就无法再领取了。但是**已经领取过成为自有模板的不会同步删除**。
2071
+ - 对于自动领取的模板,由于已经下发,更改授权不会影响。
2072
+ - 如果要同步删除子客自有模板库中的模板,请使用OperateType=UPDATE+Available参数处理。
2073
+ */
2074
+ async OperateChannelTemplate(
2075
+ req: OperateChannelTemplateRequest,
2076
+ cb?: (error: string, rep: OperateChannelTemplateResponse) => void
2077
+ ): Promise<OperateChannelTemplateResponse> {
2078
+ return this.request("OperateChannelTemplate", req, cb)
2079
+ }
2080
+
2081
+ /**
2082
+ * 此接口(SyncProxyOrganizationOperators)用于同步 第三方平台子客企业经办人列表,主要是同步经办人的离职状态。
2083
+ 子客Web控制台的组织架构管理,依赖于第三方应用平台的,无法在页面针对员工做新增/更新/离职等操作, 必须通过 API 来操作。
2084
+
2085
+ - **新增员工的场景**: 通过本接口提前导入员工列表, 然后调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>分享给对应的员工进行实名, 新增员工后员工的状态为**未实名**, 通过链接实名后状态变为**已实名**, 已实名员工就可以参与合同的发起。
2086
+
2087
+ - **员工离职的场景**: 通过本接口将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了, 同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空, 再次加入公司会从零开始) , 若员工信息有误可通过离职后在新增来解决, 离职员工状态为**离职**。
2088
+
2089
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/7a27a6bb0e4d39c2f6aa2a0b39946181/channel_SyncProxyOrganizationOperators.png)
2090
+
2091
+ **注**:
2092
+ - 新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理
2093
+ - <font color='red'>超管和法人无法通过此接口离职</font>, 需要超管和法人将权限转移给其他人后才可通过此接口离职
2094
+ - 新增员工的场景同ID不同员工会覆盖掉上一个同ID的员工, 如果上一个员工已经实名则不会被覆盖
2095
+ */
2096
+ async SyncProxyOrganizationOperators(
2097
+ req: SyncProxyOrganizationOperatorsRequest,
2098
+ cb?: (error: string, rep: SyncProxyOrganizationOperatorsResponse) => void
2099
+ ): Promise<SyncProxyOrganizationOperatorsResponse> {
2100
+ return this.request("SyncProxyOrganizationOperators", req, cb)
1996
2101
  }
1997
2102
 
1998
2103
  /**
@@ -2016,34 +2121,6 @@ Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批
2016
2121
  return this.request("ChannelCreateEmbedWebUrl", req, cb)
2017
2122
  }
2018
2123
 
2019
- /**
2020
- * 此接口用于查询合同或者合同组的详情信息,支持查询多个(数量不能超过100)。
2021
-
2022
- 适用场景:可用于主动查询某个合同或者合同组的详情信息。
2023
-
2024
- 注: `只能查询本企业创建的合同(创建合同用的Agent和此接口用的Agent数据最好一致) `
2025
- */
2026
- async DescribeFlowDetailInfo(
2027
- req: DescribeFlowDetailInfoRequest,
2028
- cb?: (error: string, rep: DescribeFlowDetailInfoResponse) => void
2029
- ): Promise<DescribeFlowDetailInfoResponse> {
2030
- return this.request("DescribeFlowDetailInfo", req, cb)
2031
- }
2032
-
2033
- /**
2034
- * 通过此接口(ChannelDescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。可以支持单个子客和整个应用下所有子客的查询。
2035
- <ul>
2036
- <li>对于单个子客企业的查询,通过指定子客的唯一标识(Agent.ProxyOrganizationOpenId)来查询该子客消耗详情</li>
2037
- <li>对于整个应用下所有企业的查询,不需要指定子客的唯一标识,只需要传入渠道应用标识(Agent.AppId)直接查询整个应用下所有子客企业消耗详情</li>
2038
- </ul>
2039
- */
2040
- async ChannelDescribeBillUsageDetail(
2041
- req: ChannelDescribeBillUsageDetailRequest,
2042
- cb?: (error: string, rep: ChannelDescribeBillUsageDetailResponse) => void
2043
- ): Promise<ChannelDescribeBillUsageDetailResponse> {
2044
- return this.request("ChannelDescribeBillUsageDetail", req, cb)
2045
- }
2046
-
2047
2124
  /**
2048
2125
  * 获取个人用户自动签的开通链接。
2049
2126
 
@@ -2055,64 +2132,4 @@ Agent参数中的OpenId 必须为审批者的openId,且链接必须由审批
2055
2132
  ): Promise<ChannelCreateUserAutoSignEnableUrlResponse> {
2056
2133
  return this.request("ChannelCreateUserAutoSignEnableUrl", req, cb)
2057
2134
  }
2058
-
2059
- /**
2060
- * 批量清理未认证的企业认证流程。
2061
-
2062
- 此接口用来清除企业方认证信息填写错误,批量清理认证中的认证流信息。
2063
- 为接口[提交子企业批量认证链接创建任务](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 接口的扩展接口。即在批量认证过程中,当发起认证企业发现超管信息错误的时候,可以将当前超管下的所有认证流企业清除。
2064
-
2065
- 注意:
2066
- **这个接口的操作人必须跟生成批量认证链接接口的应用号一致,才可以调用,否则会返回当前操作人没有认证中的企业认证流**
2067
- */
2068
- async DeleteOrganizationAuthorizations(
2069
- req: DeleteOrganizationAuthorizationsRequest,
2070
- cb?: (error: string, rep: DeleteOrganizationAuthorizationsResponse) => void
2071
- ): Promise<DeleteOrganizationAuthorizationsResponse> {
2072
- return this.request("DeleteOrganizationAuthorizations", req, cb)
2073
- }
2074
-
2075
- /**
2076
- * 您可以通过合同流程ID查询相关的<font color="red"><b>填写控件</b></font>信息及其内容。这包括控件的归属方、控件的填写状态(是否已填写)以及具体的填写内容。
2077
-
2078
- 无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件,均包含在查询结果中。
2079
-
2080
- ![image](https://qcloudimg.tencent-cloud.cn/raw/08f6ea50d3ae88b51c280c2b17c2a126.png)
2081
- ### 2. 哪些控件会出现在结果里边?
2082
- **A.不返回的控件类型:**
2083
- - 动态表格
2084
- - 附件控件
2085
- - 水印控件
2086
-
2087
- **B.返回的控件类型:**
2088
- - 单行文本
2089
- - 多行文本
2090
- - 勾选框控件
2091
- - 数字控件
2092
- - 日期控件
2093
- - 图片控件(图片下载地址)
2094
- - 邮箱控件
2095
- - 地址控件
2096
- - 学历控件
2097
- - 性别控件
2098
- - 省市区控件
2099
-
2100
- ### 3.怎么授权?
2101
-
2102
- 此接口需要授权, 有两种开通权限的途径
2103
-
2104
- **第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图
2105
- 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
2106
-
2107
- ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
2108
-
2109
- **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
2110
- ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
2111
- */
2112
- async ChannelDescribeFlowComponents(
2113
- req: ChannelDescribeFlowComponentsRequest,
2114
- cb?: (error: string, rep: ChannelDescribeFlowComponentsResponse) => void
2115
- ): Promise<ChannelDescribeFlowComponentsResponse> {
2116
- return this.request("ChannelDescribeFlowComponents", req, cb)
2117
- }
2118
2135
  }