tencentcloud-sdk-nodejs 4.0.722 → 4.0.724

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 (69) hide show
  1. package/CHANGELOG.md +270 -0
  2. package/SERVICE_CHANGELOG.md +296 -49
  3. package/package.json +1 -1
  4. package/products.md +24 -24
  5. package/src/common/sdk_version.ts +1 -1
  6. package/src/services/aiart/v20221229/aiart_models.ts +9 -5
  7. package/src/services/car/v20220110/car_client.ts +1 -1
  8. package/src/services/ccc/v20200210/ccc_models.ts +6 -2
  9. package/src/services/ckafka/v20190819/ckafka_models.ts +1 -1
  10. package/src/services/clb/v20180317/clb_models.ts +4 -6
  11. package/src/services/cls/v20201016/cls_client.ts +15 -3
  12. package/src/services/cls/v20201016/cls_models.ts +54 -18
  13. package/src/services/ess/v20201111/ess_client.ts +23 -6
  14. package/src/services/ess/v20201111/ess_models.ts +345 -208
  15. package/src/services/essbasic/v20210526/essbasic_client.ts +45 -18
  16. package/src/services/essbasic/v20210526/essbasic_models.ts +140 -73
  17. package/src/services/lighthouse/v20200324/lighthouse_client.ts +29 -2
  18. package/src/services/lighthouse/v20200324/lighthouse_models.ts +98 -50
  19. package/src/services/mna/v20210119/mna_client.ts +15 -1
  20. package/src/services/mna/v20210119/mna_models.ts +90 -12
  21. package/src/services/ocr/v20181119/ocr_models.ts +43 -25
  22. package/src/services/ses/v20201002/ses_models.ts +5 -1
  23. package/src/services/tdmq/v20200217/tdmq_models.ts +41 -4
  24. package/src/services/teo/v20220901/teo_client.ts +46 -21
  25. package/src/services/teo/v20220901/teo_models.ts +91 -23
  26. package/src/services/tione/v20211111/tione_models.ts +1 -1
  27. package/src/services/waf/v20180125/waf_client.ts +20 -7
  28. package/src/services/waf/v20180125/waf_models.ts +118 -1
  29. package/src/services/wedata/v20210820/wedata_models.ts +14 -2
  30. package/tencentcloud/common/sdk_version.d.ts +1 -1
  31. package/tencentcloud/common/sdk_version.js +1 -1
  32. package/tencentcloud/services/aiart/v20221229/aiart_models.d.ts +9 -5
  33. package/tencentcloud/services/car/v20220110/car_client.d.ts +1 -1
  34. package/tencentcloud/services/car/v20220110/car_client.js +1 -1
  35. package/tencentcloud/services/ccc/v20200210/ccc_models.d.ts +6 -2
  36. package/tencentcloud/services/ckafka/v20190819/ckafka_models.d.ts +1 -1
  37. package/tencentcloud/services/clb/v20180317/clb_models.d.ts +4 -6
  38. package/tencentcloud/services/cls/v20201016/cls_client.d.ts +5 -1
  39. package/tencentcloud/services/cls/v20201016/cls_client.js +6 -0
  40. package/tencentcloud/services/cls/v20201016/cls_models.d.ts +52 -18
  41. package/tencentcloud/services/ess/v20201111/ess_client.d.ts +12 -4
  42. package/tencentcloud/services/ess/v20201111/ess_client.js +13 -3
  43. package/tencentcloud/services/ess/v20201111/ess_models.d.ts +341 -207
  44. package/tencentcloud/services/essbasic/v20210526/essbasic_client.d.ts +43 -16
  45. package/tencentcloud/services/essbasic/v20210526/essbasic_client.js +43 -16
  46. package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +140 -73
  47. package/tencentcloud/services/lighthouse/v20200324/lighthouse_client.d.ts +12 -1
  48. package/tencentcloud/services/lighthouse/v20200324/lighthouse_client.js +15 -0
  49. package/tencentcloud/services/lighthouse/v20200324/lighthouse_models.d.ts +94 -50
  50. package/tencentcloud/services/mna/v20210119/mna_client.d.ts +5 -1
  51. package/tencentcloud/services/mna/v20210119/mna_client.js +6 -0
  52. package/tencentcloud/services/mna/v20210119/mna_models.d.ts +86 -12
  53. package/tencentcloud/services/ocr/v20181119/ocr_models.d.ts +43 -25
  54. package/tencentcloud/services/ses/v20201002/ses_models.d.ts +6 -1
  55. package/tencentcloud/services/tdmq/v20200217/tdmq_models.d.ts +41 -4
  56. package/tencentcloud/services/teo/v20220901/teo_client.d.ts +16 -8
  57. package/tencentcloud/services/teo/v20220901/teo_client.js +22 -10
  58. package/tencentcloud/services/teo/v20220901/teo_models.d.ts +86 -23
  59. package/tencentcloud/services/tione/v20211111/tione_models.d.ts +1 -1
  60. package/tencentcloud/services/waf/v20180125/waf_client.d.ts +8 -4
  61. package/tencentcloud/services/waf/v20180125/waf_client.js +9 -3
  62. package/tencentcloud/services/waf/v20180125/waf_models.d.ts +115 -1
  63. package/tencentcloud/services/wedata/v20210820/wedata_models.d.ts +14 -2
  64. package/test/cls.v20201016.test.js +10 -0
  65. package/test/ess.v20201111.test.js +10 -0
  66. package/test/lighthouse.v20200324.test.js +20 -0
  67. package/test/mna.v20210119.test.js +10 -0
  68. package/test/teo.v20220901.test.js +26 -6
  69. package/test/waf.v20180125.test.js +12 -2
@@ -29,6 +29,70 @@ export interface DescribePersonCertificateResponse {
29
29
  RequestId?: string
30
30
  }
31
31
 
32
+ /**
33
+ * 用户计费使用情况详情
34
+ */
35
+ export interface BillUsageDetail {
36
+ /**
37
+ * 合同流程ID,为32位字符串。
38
+ 建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
39
+ 可登录腾讯电子签控制台,在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
40
+ 注意:此字段可能返回 null,表示取不到有效值。
41
+ */
42
+ FlowId?: string
43
+ /**
44
+ * 经办人名称
45
+ 注意:此字段可能返回 null,表示取不到有效值。
46
+ */
47
+ OperatorName?: string
48
+ /**
49
+ * 发起方组织机构名称
50
+ 注意:此字段可能返回 null,表示取不到有效值。
51
+ */
52
+ CreateOrganizationName?: string
53
+ /**
54
+ * 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
55
+ 该名称还将用于合同签署完成后的下载文件名。
56
+ 注意:此字段可能返回 null,表示取不到有效值。
57
+ */
58
+ FlowName?: string
59
+ /**
60
+ * 0 还没有发起 1等待签署 2部分签署 3拒签 4已签署 5已过期 6已撤销 7还没有预发起 8等待填写 9部分填写 10拒填 11已解除
61
+ 注意:此字段可能返回 null,表示取不到有效值。
62
+ */
63
+ Status?: number
64
+ /**
65
+ * 套餐类型
66
+ 注意:此字段可能返回 null,表示取不到有效值。
67
+ */
68
+ QuotaType?: string
69
+ /**
70
+ * 合同使用量
71
+ 注意:此字段可能返回 null,表示取不到有效值。
72
+ */
73
+ UseCount?: number
74
+ /**
75
+ * 消耗的时间戳
76
+ 注意:此字段可能返回 null,表示取不到有效值。
77
+ */
78
+ CostTime?: number
79
+ /**
80
+ * 套餐名称
81
+ 注意:此字段可能返回 null,表示取不到有效值。
82
+ */
83
+ QuotaName?: string
84
+ /**
85
+ * 消耗类型 1.扣费 2.撤销返还
86
+ 注意:此字段可能返回 null,表示取不到有效值。
87
+ */
88
+ CostType?: number
89
+ /**
90
+ * 备注
91
+ 注意:此字段可能返回 null,表示取不到有效值。
92
+ */
93
+ Remark?: string
94
+ }
95
+
32
96
  /**
33
97
  * CreateSeal请求参数结构体
34
98
  */
@@ -60,7 +124,7 @@ export interface CreateSealRequest {
60
124
  * 电子印章类型 , 可选类型如下:
61
125
  <ul><li>**OFFICIAL**: (默认)公章</li>
62
126
  <li>**CONTRACT**: 合同专用章;</li>
63
- <li>**FINANCE**: 合财务专用章;</li>
127
+ <li>**FINANCE**: 财务专用章;</li>
64
128
  <li>**PERSONNEL**: 人事专用章</li>
65
129
  </ul>
66
130
  注: `同企业下只能有一个公章, 重复创建会报错`
@@ -361,12 +425,10 @@ export interface CreateExtendedServiceAuthInfosRequest {
361
425
  */
362
426
  UserIds: Array<string>
363
427
  /**
364
- * 要查询的扩展服务类型。
365
- 默认为空,即查询当前支持的所有扩展服务信息。
366
- 若需查询单个扩展服务的开通情况,请传递相应的值,如下所示:
428
+ * 取值
367
429
  <ul><li>OPEN_SERVER_SIGN:企业自动签</li>
430
+ <li>BATCH_SIGN:批量签署</li>
368
431
  </ul>
369
-
370
432
  */
371
433
  ExtendServiceType?: string
372
434
  /**
@@ -405,36 +467,38 @@ export interface CreateMultiFlowSignQRCodeResponse {
405
467
  }
406
468
 
407
469
  /**
408
- * 签署链接信息
470
+ * 签署链接信息。
409
471
  */
410
472
  export interface FlowApproverUrlInfo {
411
473
  /**
412
- * 签署链接(短链形式呈现)。请注意保密,不要将其外泄给无关用户。
413
- 注: `注意该链接有效期为30分钟`
474
+ * 签署短链接。</br>
475
+ 注意:
476
+ - 该链接有效期为**30分钟**,同时需要注意保密,不要外泄给无关用户。
477
+ - 该链接不支持小程序嵌入,仅支持**移动端浏览器**打开。
414
478
  注意:此字段可能返回 null,表示取不到有效值。
415
479
  */
416
480
  SignUrl?: string
417
481
  /**
418
- * 签署参与人类型
419
- <ul><li> **1** :个人参与方</li></ul>
420
-
421
- 注: `现在仅支持个人参与方`
482
+ * 签署人类型。
483
+ - **1**: 个人
422
484
  注意:此字段可能返回 null,表示取不到有效值。
423
485
  */
424
486
  ApproverType?: number
425
487
  /**
426
- * 签署人姓名
488
+ * 签署人姓名。
427
489
  注意:此字段可能返回 null,表示取不到有效值。
428
490
  */
429
491
  ApproverName?: string
430
492
  /**
431
- * 签署人手机号
493
+ * 签署人手机号。
432
494
  注意:此字段可能返回 null,表示取不到有效值。
433
495
  */
434
496
  ApproverMobile?: string
435
497
  /**
436
- * 签署链接(长链形式呈现)。请注意保密,不要将其外泄给无关用户。
437
- 注: `注意该链接有效期为30分钟`
498
+ * 签署长链接。</br>
499
+ 注意:
500
+ - 该链接有效期为**30分钟**,同时需要注意保密,不要外泄给无关用户。
501
+ - 该链接不支持小程序嵌入,仅支持**移动端浏览器**打开。
438
502
  注意:此字段可能返回 null,表示取不到有效值。
439
503
  */
440
504
  LongUrl?: string
@@ -1485,6 +1549,7 @@ export interface DescribeIntegrationEmployeesRequest {
1485
1549
  <li>Key:**"UserId"**,根据用户ID查询员工,Values为指定的用户ID:**["UserId"]**</li>
1486
1550
  <li>Key:**"UserWeWorkOpenId"**,根据用户企微账号ID查询员工,Values为指定用户的企微账号ID:**["UserWeWorkOpenId"]**</li>
1487
1551
  <li>Key:**"StaffOpenId"**,根据第三方系统用户OpenId查询员工,Values为第三方系统用户OpenId列表:**["OpenId1","OpenId2",...]**</li>
1552
+ <li>Key:**"RoleId"**,根据电子签角色ID查询员工,Values为指定的角色ID,满足其中任意一个角色即可:**["RoleId1","RoleId2",...]**</li>
1488
1553
  </ul>
1489
1554
  */
1490
1555
  Filters?: Array<Filter>
@@ -1931,6 +1996,21 @@ export interface Permission {
1931
1996
  Children?: Array<Permission>
1932
1997
  }
1933
1998
 
1999
+ /**
2000
+ * DescribeFlowBriefs返回参数结构体
2001
+ */
2002
+ export interface DescribeFlowBriefsResponse {
2003
+ /**
2004
+ * 合同流程基础信息列表,包含流程的名称、状态、创建日期等基本信息。
2005
+ 注:`与入参 FlowIds 的顺序可能存在不一致的情况。`
2006
+ */
2007
+ FlowBriefs?: Array<FlowBrief>
2008
+ /**
2009
+ * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2010
+ */
2011
+ RequestId?: string
2012
+ }
2013
+
1934
2014
  /**
1935
2015
  * 企业员工信息。
1936
2016
  */
@@ -2385,47 +2465,57 @@ export interface PdfVerifyResult {
2385
2465
  */
2386
2466
  VerifyResult?: number
2387
2467
  /**
2388
- * 签署平台,如果文件是在腾讯电子签平台签署,则返回腾讯电子签,如果文件不在腾讯电子签平台签署,则返回其他平台。
2468
+ * 签署平台
2469
+ 如果文件是在腾讯电子签平台签署,则为**腾讯电子签**,
2470
+ 如果文件不在腾讯电子签平台签署,则为**其他平台**。
2389
2471
  */
2390
2472
  SignPlatform?: string
2391
2473
  /**
2392
- * 签署人名称
2474
+ * 申请证书的主体的名字
2475
+
2476
+ 如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下
2477
+ **企业**: ESS@企业名称@编码
2478
+ **个人**: ESS@个人姓名@证件号@808854
2479
+
2480
+ 如果在其他平台签署的, 主体的名字参考其他平台的说明
2393
2481
  */
2394
2482
  SignerName?: string
2395
2483
  /**
2396
- * 签署时间戳,单位秒
2484
+ * 签署时间的Unix时间戳,单位毫秒
2397
2485
  */
2398
2486
  SignTime?: number
2399
2487
  /**
2400
- * 签名算法
2488
+ * 证书签名算法, 如SHA1withRSA等算法
2401
2489
  */
2402
2490
  SignAlgorithm?: string
2403
2491
  /**
2404
- * 签名证书序列号
2492
+ * CA供应商下发给用户的证书编号
2493
+
2494
+ 注意:`腾讯电子签接入多家CA供应商以提供容灾能力,不同CA下发的证书编号区别较大,但基本都是由数字和字母组成,长度在200以下`。
2405
2495
  */
2406
2496
  CertSn?: string
2407
2497
  /**
2408
- * 证书起始时间戳,单位毫秒
2498
+ * 证书起始时间的Unix时间戳,单位毫秒
2409
2499
  */
2410
2500
  CertNotBefore?: number
2411
2501
  /**
2412
- * 证书过期时间戳,单位毫秒
2502
+ * 证书过期时间的时间戳,单位毫秒
2413
2503
  */
2414
2504
  CertNotAfter?: number
2415
2505
  /**
2416
- * 签名域横坐标,单位pt
2506
+ * 签名域横坐标,单位px
2417
2507
  */
2418
2508
  ComponentPosX?: number
2419
2509
  /**
2420
- * 签名域纵坐标,单位pt
2510
+ * 签名域纵坐标,单位px
2421
2511
  */
2422
2512
  ComponentPosY?: number
2423
2513
  /**
2424
- * 签名域宽度,单位pt
2514
+ * 签名域宽度,单位px
2425
2515
  */
2426
2516
  ComponentWidth?: number
2427
2517
  /**
2428
- * 签名域高度,单位pt
2518
+ * 签名域高度,单位px
2429
2519
  */
2430
2520
  ComponentHeight?: number
2431
2521
  /**
@@ -2701,47 +2791,151 @@ export interface CreateSchemeUrlResponse {
2701
2791
  }
2702
2792
 
2703
2793
  /**
2704
- * CreateUserAutoSignEnableUrl返回参数结构体
2794
+ * CreateFlowByFiles请求参数结构体
2705
2795
  */
2706
- export interface CreateUserAutoSignEnableUrlResponse {
2796
+ export interface CreateFlowByFilesRequest {
2707
2797
  /**
2708
- * 个人用户自动签的开通链接, 短链形式。过期时间受 `ExpiredTime` 参数控制。
2798
+ * 执行本接口操作的员工信息。使用此接口时,必须填写userId。
2799
+ 支持填入集团子公司经办人 userId 代发合同。
2800
+
2801
+ 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
2709
2802
  */
2710
- Url?: string
2803
+ Operator: UserInfo
2711
2804
  /**
2712
- * 腾讯电子签小程序的 AppID,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
2805
+ * 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
2713
2806
 
2714
- 注: `如果获取的是H5链接, 则不会返回此值`
2807
+ 该名称还将用于合同签署完成后的下载文件名。
2715
2808
  */
2716
- AppId?: string
2809
+ FlowName: string
2717
2810
  /**
2718
- * 腾讯电子签小程序的原始 Id, ,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
2811
+ * 合同流程的参与方列表,最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息,具体定义可以参考开发者中心的ApproverInfo结构体。
2719
2812
 
2720
- 注: `如果获取的是H5链接, 则不会返回此值`
2813
+ 如果合同流程是有序签署,Approvers列表中参与人的顺序就是默认的签署顺序,请确保列表中参与人的顺序符合实际签署顺序。
2721
2814
  */
2722
- AppOriginalId?: string
2815
+ Approvers: Array<ApproverInfo>
2723
2816
  /**
2724
- * 腾讯电子签小程序的跳转路径,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
2817
+ * 本合同流程需包含的PDF文件资源编号列表,通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">UploadFiles</a>接口获取PDF文件资源编号。
2725
2818
 
2726
- 注: `如果获取的是H5链接, 则不会返回此值`
2819
+ 注: `目前,此接口仅支持单个文件发起。`
2727
2820
  */
2728
- Path?: string
2821
+ FileIds: Array<string>
2729
2822
  /**
2730
- * base64 格式的跳转二维码图片,可通过微信扫描后跳转到腾讯电子签小程序的开通界面。
2823
+ * 合同流程描述信息(可自定义此描述),最大长度1000个字符。
2824
+ */
2825
+ FlowDescription?: string
2826
+ /**
2827
+ * 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为200个字符,仅限中文、字母、数字和下划线组成。
2828
+ */
2829
+ FlowType?: string
2830
+ /**
2831
+ * 模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
2832
+ <ul><li> 单行文本控件 </li>
2833
+ <li> 多行文本控件 </li>
2834
+ <li> 勾选框控件 </li>
2835
+ <li> 数字控件 </li>
2836
+ <li> 图片控件 </li>
2837
+ <li> 动态表格等填写控件</li></ul>
2838
+ */
2839
+ Components?: Array<Component>
2840
+ /**
2841
+ * 合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。
2731
2842
 
2732
- 注: `如果获取的是H5链接, 则不会返回此二维码图片`
2733
2843
  */
2734
- QrCode?: string
2844
+ CcInfos?: Array<CcInfo>
2735
2845
  /**
2736
- * 返回的链接类型
2737
- <ul><li> 空: 默认小程序端链接</li>
2738
- <li> **H5SIGN** : h5端链接</li></ul>
2846
+ * 可以设置以下时间节点来给抄送人发送短信通知来查看合同内容:
2847
+ <ul><li> **0**:合同发起时通知(默认值)</li>
2848
+ <li> **1**:签署完成后通知</li></ul>
2739
2849
  */
2740
- UrlType?: string
2850
+ CcNotifyType?: number
2741
2851
  /**
2742
- * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2852
+ * 是否为预览模式,取值如下:
2853
+ <ul><li> **false**:非预览模式(默认),会产生合同流程并返回合同流程编号FlowId。</li>
2854
+ <li> **true**:预览模式,不产生合同流程,不返回合同流程编号FlowId,而是返回预览链接PreviewUrl,有效期为300秒,用于查看真实发起后合同的样子。</li></ul>
2743
2855
  */
2744
- RequestId?: string
2856
+ NeedPreview?: boolean
2857
+ /**
2858
+ * 预览模式下产生的预览链接类型
2859
+ <ul><li> **0** :(默认) 文件流 ,点开后后下载预览的合同PDF文件 </li>
2860
+ <li> **1** :H5链接 ,点开后在浏览器中展示合同的样子</li></ul>
2861
+ 注: `此参数在NeedPreview 为true时有效`
2862
+
2863
+ */
2864
+ PreviewType?: number
2865
+ /**
2866
+ * 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
2867
+ 如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。
2868
+ */
2869
+ Deadline?: number
2870
+ /**
2871
+ * 合同到期提醒时间,为Unix标准时间戳(秒)格式,支持的范围是从发起时间开始到后10年内。
2872
+
2873
+ 到达提醒时间后,腾讯电子签会短信通知发起方企业合同提醒,可用于处理合同到期事务,如合同续签等事宜。
2874
+ */
2875
+ RemindedOn?: number
2876
+ /**
2877
+ * 合同流程的签署顺序类型:
2878
+ <ul><li> **false**:(默认)有序签署, 本合同多个参与人需要依次签署 </li>
2879
+ <li> **true**:无序签署, 本合同多个参与人没有先后签署限制</li></ul>
2880
+ */
2881
+ Unordered?: boolean
2882
+ /**
2883
+ * 您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板,模板中支持以下变量:
2884
+ <ul><li>{合同名称} </li>
2885
+ <li>{发起方企业} </li>
2886
+ <li>{发起方姓名} </li>
2887
+ <li>{签署方N企业}</li>
2888
+ <li>{签署方N姓名}</li></ul>
2889
+ 其中,N表示签署方的编号,从1开始,不能超过签署人的数量。
2890
+
2891
+ 例如,如果是腾讯公司张三发给李四名称为“租房合同”的合同,您可以将此字段设置为:`合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名}`,则小程序中列表页展示此合同为以下样子
2892
+
2893
+ 合同名称:租房合同
2894
+ 发起方:腾讯公司(张三)
2895
+ 签署方:李四
2896
+
2897
+
2898
+ */
2899
+ CustomShowMap?: string
2900
+ /**
2901
+ * 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
2902
+ <ul><li> **false**:(默认)不需要审批,直接签署。</li>
2903
+ <li> **true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。</li></ul>
2904
+ 企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
2905
+ <ul><li> 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。</li>
2906
+ <li> 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。</li></ul>
2907
+ 注:`此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同`
2908
+ */
2909
+ NeedSignReview?: boolean
2910
+ /**
2911
+ * 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 20480长度。
2912
+
2913
+ 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
2914
+ */
2915
+ UserData?: string
2916
+ /**
2917
+ * 指定个人签署方查看合同的校验方式
2918
+ <ul><li> **VerifyCheck** :(默认)人脸识别,人脸识别后才能合同内容 </li>
2919
+ <li> **MobileCheck** : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)</li></ul>
2920
+ */
2921
+ ApproverVerifyType?: string
2922
+ /**
2923
+ * 签署方签署控件(印章/签名等)的生成方式:
2924
+ <ul><li> **0**:在合同流程发起时,由发起人指定签署方的签署控件的位置和数量。</li>
2925
+ <li> **1**:签署方在签署时自行添加签署控件,可以拖动位置和控制数量。</li></ul>
2926
+ */
2927
+ SignBeanTag?: number
2928
+ /**
2929
+ * 代理企业和员工的信息。
2930
+ 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
2931
+ */
2932
+ Agent?: Agent
2933
+ /**
2934
+ * 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传:
2935
+ <ul><li> **E_PRESCRIPTION_AUTO_SIGN**:处方单(医疗自动签) </li></ul>
2936
+ 注: `个人自动签名场景是白名单功能,使用前请与对接的客户经理联系沟通。`
2937
+ */
2938
+ AutoSignScene?: string
2745
2939
  }
2746
2940
 
2747
2941
  /**
@@ -4082,154 +4276,6 @@ export interface DeleteIntegrationRoleUsersRequest {
4082
4276
  Agent?: Agent
4083
4277
  }
4084
4278
 
4085
- /**
4086
- * CreateFlowByFiles请求参数结构体
4087
- */
4088
- export interface CreateFlowByFilesRequest {
4089
- /**
4090
- * 执行本接口操作的员工信息。使用此接口时,必须填写userId。
4091
- 支持填入集团子公司经办人 userId 代发合同。
4092
-
4093
- 注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
4094
- */
4095
- Operator: UserInfo
4096
- /**
4097
- * 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
4098
-
4099
- 该名称还将用于合同签署完成后的下载文件名。
4100
- */
4101
- FlowName: string
4102
- /**
4103
- * 合同流程的参与方列表,最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息,具体定义可以参考开发者中心的ApproverInfo结构体。
4104
-
4105
- 如果合同流程是有序签署,Approvers列表中参与人的顺序就是默认的签署顺序,请确保列表中参与人的顺序符合实际签署顺序。
4106
- */
4107
- Approvers: Array<ApproverInfo>
4108
- /**
4109
- * 本合同流程需包含的PDF文件资源编号列表,通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">UploadFiles</a>接口获取PDF文件资源编号。
4110
-
4111
- 注: `目前,此接口仅支持单个文件发起。`
4112
- */
4113
- FileIds: Array<string>
4114
- /**
4115
- * 合同流程描述信息(可自定义此描述),最大长度1000个字符。
4116
- */
4117
- FlowDescription?: string
4118
- /**
4119
- * 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为200个字符,仅限中文、字母、数字和下划线组成。
4120
- */
4121
- FlowType?: string
4122
- /**
4123
- * 模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
4124
- <ul><li> 单行文本控件 </li>
4125
- <li> 多行文本控件 </li>
4126
- <li> 勾选框控件 </li>
4127
- <li> 数字控件 </li>
4128
- <li> 图片控件 </li>
4129
- <li> 动态表格等填写控件</li></ul>
4130
- */
4131
- Components?: Array<Component>
4132
- /**
4133
- * 合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。
4134
-
4135
- */
4136
- CcInfos?: Array<CcInfo>
4137
- /**
4138
- * 可以设置以下时间节点来给抄送人发送短信通知来查看合同内容:
4139
- <ul><li> **0**:合同发起时通知(默认值)</li>
4140
- <li> **1**:签署完成后通知</li></ul>
4141
- */
4142
- CcNotifyType?: number
4143
- /**
4144
- * 是否为预览模式,取值如下:
4145
- <ul><li> **false**:非预览模式(默认),会产生合同流程并返回合同流程编号FlowId。</li>
4146
- <li> **true**:预览模式,不产生合同流程,不返回合同流程编号FlowId,而是返回预览链接PreviewUrl,有效期为300秒,用于查看真实发起后合同的样子。</li></ul>
4147
- */
4148
- NeedPreview?: boolean
4149
- /**
4150
- * 预览模式下产生的预览链接类型
4151
- <ul><li> **0** :(默认) 文件流 ,点开后后下载预览的合同PDF文件 </li>
4152
- <li> **1** :H5链接 ,点开后在浏览器中展示合同的样子</li></ul>
4153
- 注: `此参数在NeedPreview 为true时有效`
4154
-
4155
- */
4156
- PreviewType?: number
4157
- /**
4158
- * 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
4159
- 如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。
4160
- */
4161
- Deadline?: number
4162
- /**
4163
- * 合同到期提醒时间,为Unix标准时间戳(秒)格式,支持的范围是从发起时间开始到后10年内。
4164
-
4165
- 到达提醒时间后,腾讯电子签会短信通知发起方企业合同提醒,可用于处理合同到期事务,如合同续签等事宜。
4166
- */
4167
- RemindedOn?: number
4168
- /**
4169
- * 合同流程的签署顺序类型:
4170
- <ul><li> **false**:(默认)有序签署, 本合同多个参与人需要依次签署 </li>
4171
- <li> **true**:无序签署, 本合同多个参与人没有先后签署限制</li></ul>
4172
- */
4173
- Unordered?: boolean
4174
- /**
4175
- * 您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板,模板中支持以下变量:
4176
- <ul><li>{合同名称} </li>
4177
- <li>{发起方企业} </li>
4178
- <li>{发起方姓名} </li>
4179
- <li>{签署方N企业}</li>
4180
- <li>{签署方N姓名}</li></ul>
4181
- 其中,N表示签署方的编号,从1开始,不能超过签署人的数量。
4182
-
4183
- 例如,如果是腾讯公司张三发给李四名称为“租房合同”的合同,您可以将此字段设置为:`合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名}`,则小程序中列表页展示此合同为以下样子
4184
-
4185
- 合同名称:租房合同
4186
- 发起方:腾讯公司(张三)
4187
- 签署方:李四
4188
-
4189
-
4190
- */
4191
- CustomShowMap?: string
4192
- /**
4193
- * 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
4194
- <ul><li> **false**:(默认)不需要审批,直接签署。</li>
4195
- <li> **true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。</li></ul>
4196
- 企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
4197
- <ul><li> 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。</li>
4198
- <li> 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。</li></ul>
4199
- 注:`此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同`
4200
- */
4201
- NeedSignReview?: boolean
4202
- /**
4203
- * 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 20480长度。
4204
-
4205
- 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
4206
- */
4207
- UserData?: string
4208
- /**
4209
- * 指定个人签署方查看合同的校验方式
4210
- <ul><li> **VerifyCheck** :(默认)人脸识别,人脸识别后才能合同内容 </li>
4211
- <li> **MobileCheck** : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)</li></ul>
4212
- */
4213
- ApproverVerifyType?: string
4214
- /**
4215
- * 签署方签署控件(印章/签名等)的生成方式:
4216
- <ul><li> **0**:在合同流程发起时,由发起人指定签署方的签署控件的位置和数量。</li>
4217
- <li> **1**:签署方在签署时自行添加签署控件,可以拖动位置和控制数量。</li></ul>
4218
- */
4219
- SignBeanTag?: number
4220
- /**
4221
- * 代理企业和员工的信息。
4222
- 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
4223
- */
4224
- Agent?: Agent
4225
- /**
4226
- * 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传:
4227
- <ul><li> **E_PRESCRIPTION_AUTO_SIGN**:处方单(医疗自动签) </li></ul>
4228
- 注: `个人自动签名场景是白名单功能,使用前请与对接的客户经理联系沟通。`
4229
- */
4230
- AutoSignScene?: string
4231
- }
4232
-
4233
4279
  /**
4234
4280
  * CreateFlowSignUrl请求参数结构体
4235
4281
  */
@@ -6211,6 +6257,68 @@ export interface CreateFlowGroupByTemplatesRequest {
6211
6257
  FlowGroupOptions?: FlowGroupOptions
6212
6258
  }
6213
6259
 
6260
+ /**
6261
+ * DescribeBillUsageDetail返回参数结构体
6262
+ */
6263
+ export interface DescribeBillUsageDetailResponse {
6264
+ /**
6265
+ * 总数
6266
+ */
6267
+ Total?: number
6268
+ /**
6269
+ * 消耗详情
6270
+ */
6271
+ Details?: Array<BillUsageDetail>
6272
+ /**
6273
+ * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
6274
+ */
6275
+ RequestId?: string
6276
+ }
6277
+
6278
+ /**
6279
+ * CreateUserAutoSignEnableUrl返回参数结构体
6280
+ */
6281
+ export interface CreateUserAutoSignEnableUrlResponse {
6282
+ /**
6283
+ * 个人用户自动签的开通链接, 短链形式。过期时间受 `ExpiredTime` 参数控制。
6284
+ */
6285
+ Url?: string
6286
+ /**
6287
+ * 腾讯电子签小程序的 AppID,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
6288
+
6289
+ 注: `如果获取的是H5链接, 则不会返回此值`
6290
+ */
6291
+ AppId?: string
6292
+ /**
6293
+ * 腾讯电子签小程序的原始 Id, ,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
6294
+
6295
+ 注: `如果获取的是H5链接, 则不会返回此值`
6296
+ */
6297
+ AppOriginalId?: string
6298
+ /**
6299
+ * 腾讯电子签小程序的跳转路径,用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
6300
+
6301
+ 注: `如果获取的是H5链接, 则不会返回此值`
6302
+ */
6303
+ Path?: string
6304
+ /**
6305
+ * base64 格式的跳转二维码图片,可通过微信扫描后跳转到腾讯电子签小程序的开通界面。
6306
+
6307
+ 注: `如果获取的是H5链接, 则不会返回此二维码图片`
6308
+ */
6309
+ QrCode?: string
6310
+ /**
6311
+ * 返回的链接类型
6312
+ <ul><li> 空: 默认小程序端链接</li>
6313
+ <li> **H5SIGN** : h5端链接</li></ul>
6314
+ */
6315
+ UrlType?: string
6316
+ /**
6317
+ * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
6318
+ */
6319
+ RequestId?: string
6320
+ }
6321
+
6214
6322
  /**
6215
6323
  * 流程签署二维码的签署信息,适用于客户系统整合二维码功能。
6216
6324
  通过链接,用户可直接访问电子签名小程序并签署合同。
@@ -6286,18 +6394,49 @@ export interface DeleteStaffsResult {
6286
6394
  }
6287
6395
 
6288
6396
  /**
6289
- * DescribeFlowBriefs返回参数结构体
6397
+ * DescribeBillUsageDetail请求参数结构体
6290
6398
  */
6291
- export interface DescribeFlowBriefsResponse {
6399
+ export interface DescribeBillUsageDetailRequest {
6292
6400
  /**
6293
- * 合同流程基础信息列表,包含流程的名称、状态、创建日期等基本信息。
6294
- 注:`与入参 FlowIds 的顺序可能存在不一致的情况。`
6401
+ * 查询开始时间,时间跨度不能大于31天
6295
6402
  */
6296
- FlowBriefs?: Array<FlowBrief>
6403
+ StartTime: string
6297
6404
  /**
6298
- * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
6405
+ * 查询结束时间,时间跨度不能大于31天
6299
6406
  */
6300
- RequestId?: string
6407
+ EndTime: string
6408
+ /**
6409
+ * 指定分页返回第几页的数据,如果不传默认返回第一页,页码从 0 开始,即首页为 0
6410
+ */
6411
+ Offset: number
6412
+ /**
6413
+ * 指定分页每页返回的数据条数,如果不传默认为 50,单页最大支持 50。
6414
+ */
6415
+ Limit?: number
6416
+ /**
6417
+ * 查询的套餐类型 (选填 )不传则查询所有套餐;
6418
+ 对应关系如下
6419
+ CloudEnterprise-企业版合同
6420
+ SingleSignature-单方签章
6421
+ CloudProve-签署报告
6422
+ CloudOnlineSign-腾讯会议在线签约
6423
+ ChannelWeCard-微工卡
6424
+ SignFlow-合同套餐
6425
+ SignFace-签署意愿(人脸识别)
6426
+ SignPassword-签署意愿(密码)
6427
+ SignSMS-签署意愿(短信)
6428
+ PersonalEssAuth-签署人实名(腾讯电子签认证)
6429
+ PersonalThirdAuth-签署人实名(信任第三方认证)
6430
+ OrgEssAuth-签署企业实名
6431
+ FlowNotify-短信通知
6432
+ AuthService-企业工商信息查询
6433
+ */
6434
+ QuotaType?: string
6435
+ /**
6436
+ * 非必填,查询某个渠道企业的消耗情况。
6437
+ 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
6438
+ */
6439
+ Agent?: Agent
6301
6440
  }
6302
6441
 
6303
6442
  /**
@@ -6627,12 +6766,10 @@ export interface DeleteExtendedServiceAuthInfosRequest {
6627
6766
  */
6628
6767
  UserIds: Array<string>
6629
6768
  /**
6630
- * 要查询的扩展服务类型。
6631
- 默认为空,即查询当前支持的所有扩展服务信息。
6632
- 若需查询单个扩展服务的开通情况,请传递相应的值,如下所示:
6769
+ * 取值如下所示:
6633
6770
  <ul><li>OPEN_SERVER_SIGN:企业自动签</li>
6771
+ <li>BATCH_SIGN:批量签署</li>
6634
6772
  </ul>
6635
-
6636
6773
  */
6637
6774
  ExtendServiceType?: string
6638
6775
  /**