tencentcloud-sdk-nodejs 4.0.1017 → 4.0.1019

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