tencentcloud-sdk-nodejs-ess 4.0.724 → 4.0.726

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs-ess",
-  "version": "4.0.724",
+  "version": "4.0.726",
   "description": "Tencent Cloud API NODEJS SDK",
   "main": "tencentcloud/index.js",
   "scripts": {

package/products.md

@@ -48,7 +48,7 @@
 | cdwch | [云数据仓库 ClickHouse](https://cloud.tencent.com/document/product/1299) | 2023-09-08 01:20:53 |
 | cdwpg | [云数据仓库 PostgreSQL](https://cloud.tencent.com/document/product/878) | 2023-10-24 01:08:56 |
 | cfg | [混沌演练平台](https://cloud.tencent.com/document/product/1500) | 2023-10-10 01:10:06 |
-| cfs | [文件存储](https://cloud.tencent.com/document/product/582) | 2023-09-01 01:09:12 |
+| cfs | [文件存储](https://cloud.tencent.com/document/product/582) | 2023-11-09 01:08:52 |
 | cfw | [云防火墙](https://cloud.tencent.com/document/product/1132) | 2023-10-27 01:19:30 |
 | chdfs | [云 HDFS](https://cloud.tencent.com/document/product/1105) | 2023-08-17 01:47:49 |
 | ciam | [账号风控平台](https://cloud.tencent.com/document/product/1441) | 2023-07-06 01:13:25 |
@@ -72,21 +72,21 @@
 | cwp | [主机安全](https://cloud.tencent.com/document/product/296) | 2023-10-27 01:29:35 |
 | cws | [漏洞扫描服务](https://cloud.tencent.com/document/product) | 2019-11-22 12:16:15 |
 | cynosdb | [TDSQL-C MySQL 版](https://cloud.tencent.com/document/product/1003) | 2023-10-23 00:08:10 |
-| dasb | [T-Sec-堡垒机（BH）](https://cloud.tencent.com/document/product/1025) | 2023-10-12 01:46:01 |
+| dasb | [T-Sec-堡垒机（BH）](https://cloud.tencent.com/document/product/1025) | 2023-11-09 01:11:47 |
 | dataintegration | [数据接入平台](https://cloud.tencent.com/document/product/1591) | 2022-07-26 15:32:15 |
 | dayu | [DDoS 高防包](https://cloud.tencent.com/document/product/1021) | 2023-05-18 01:20:11 |
 | dbbrain | [数据库智能管家 DBbrain](https://cloud.tencent.com/document/product/1130) | 2023-10-09 01:12:39 |
 | dbdc | [云数据库独享集群](https://cloud.tencent.com/document/product/1322) | 2023-08-22 01:11:33 |
 | dc | [专线接入](https://cloud.tencent.com/document/product/216) | 2023-08-17 02:50:46 |
 | dcdb | [TDSQL MySQL 版](https://cloud.tencent.com/document/product/557) | 2023-10-30 00:33:47 |
-| dlc | [数据湖计算 DLC](https://cloud.tencent.com/document/product/1342) | 2023-11-08 01:31:54 |
-| dnspod | [DNSPod](https://cloud.tencent.com/document/product/1427) | 2023-11-03 01:13:17 |
+| dlc | [数据湖计算 DLC](https://cloud.tencent.com/document/product/1342) | 2023-11-09 01:12:27 |
+| dnspod | [DNSPod](https://cloud.tencent.com/document/product/1427) | 2023-11-09 01:12:46 |
 | domain | [域名注册](https://cloud.tencent.com/document/product/242) | 2023-10-20 01:14:01 |
 | drm | [数字版权管理](https://cloud.tencent.com/document/product/1000) | 2023-11-07 01:34:47 |
 | ds | [文档服务](https://cloud.tencent.com/document/product/869) | 2023-08-17 02:59:40 |
 | dsgc | [数据安全治理中心](https://cloud.tencent.com/document/product/1087) | 2023-10-17 01:15:42 |
 | dtf | [分布式事务](https://cloud.tencent.com/document/product/1224) | 2022-04-04 06:38:57 |
-| dts | [数据传输服务](https://cloud.tencent.com/document/product/571) | 2023-10-23 15:36:37 |
+| dts | [数据传输服务](https://cloud.tencent.com/document/product/571) | 2023-11-09 01:13:23 |
 | eb | [事件总线](https://cloud.tencent.com/document/product/1359) | 2023-10-31 01:45:32 |
 | ecc | [英文作文批改](https://cloud.tencent.com/document/product/1076) | 2023-09-13 01:42:58 |
 | ecdn | [全站加速网络](https://cloud.tencent.com/document/product/570) | 2023-08-17 03:03:04 |
@@ -95,8 +95,8 @@
 | eis | [数据连接器](https://cloud.tencent.com/document/product/1270) | 2023-08-10 01:17:44 |
 | emr | [弹性 MapReduce](https://cloud.tencent.com/document/product/589) | 2023-10-16 01:15:50 |
 | es | [Elasticsearch Service](https://cloud.tencent.com/document/product/845) | 2023-10-30 00:42:05 |
-| ess | [腾讯电子签企业版](https://cloud.tencent.com/document/product/1323) | 2023-11-08 01:38:53 |
-| essbasic | [腾讯电子签（基础版）](https://cloud.tencent.com/document/product/1420) | 2023-11-08 01:39:50 |
+| ess | [腾讯电子签企业版](https://cloud.tencent.com/document/product/1323) | 2023-11-09 01:14:12 |
+| essbasic | [腾讯电子签（基础版）](https://cloud.tencent.com/document/product/1420) | 2023-11-09 01:14:31 |
 | facefusion | [人脸融合](https://cloud.tencent.com/document/product/670) | 2023-09-18 01:48:33 |
 | faceid | [人脸核身](https://cloud.tencent.com/document/product/1007) | 2023-10-20 01:16:02 |
 | fmu | [人脸试妆](https://cloud.tencent.com/document/product/1172) | 2023-08-17 03:12:49 |
@@ -124,12 +124,12 @@
 | iotvideo | [物联网智能视频服务](https://cloud.tencent.com/document/product/1131) | 2023-10-31 01:58:13 |
 | iotvideoindustry | [物联网智能视频服务（行业版）](https://cloud.tencent.com/document/product/1361) | 2023-08-17 03:44:44 |
 | irp | [智能推荐平台](https://cloud.tencent.com/document/product/1541) | 2023-09-22 02:00:51 |
-| iss | [智能视图计算平台](https://cloud.tencent.com/document/product/1344) | 2023-10-27 01:53:51 |
+| iss | [智能视图计算平台](https://cloud.tencent.com/document/product/1344) | 2023-11-09 01:16:39 |
 | ivld | [媒体智能标签](https://cloud.tencent.com/document/product/1509) | 2023-05-18 01:35:21 |
 | keewidb | [云数据库 KeeWiDB](https://cloud.tencent.com/document/product/1520) | 2023-07-19 01:29:34 |
 | kms | [密钥管理系统](https://cloud.tencent.com/document/product/573) | 2023-08-17 03:51:31 |
-| lcic | [实时互动-教育版](https://cloud.tencent.com/document/product/1639) | 2023-10-23 00:14:04 |
-| lighthouse | [轻量应用服务器](https://cloud.tencent.com/document/product/1207) | 2023-11-07 01:54:12 |
+| lcic | [实时互动-教育版](https://cloud.tencent.com/document/product/1639) | 2023-11-09 01:19:33 |
+| lighthouse | [轻量应用服务器](https://cloud.tencent.com/document/product/1207) | 2023-11-09 01:19:51 |
 | live | [云直播CSS](https://cloud.tencent.com/document/product/267) | 2023-10-26 01:18:09 |
 | lowcode | [云开发低码](https://cloud.tencent.com/document/product/1301) | 2022-04-04 06:56:51 |
 | lp | [登录保护](https://cloud.tencent.com/document/product/1190) | 2022-04-04 06:56:52 |
@@ -164,7 +164,7 @@
 | rkp | [风险探针](https://cloud.tencent.com/document/product/1169) | 2023-08-17 04:33:51 |
 | rp | [注册保护](https://cloud.tencent.com/document/product/1191) | 2022-04-04 07:04:06 |
 | rum | [前端性能监控](https://cloud.tencent.com/document/product/1464) | 2023-10-13 01:22:31 |
-| scf | [云函数](https://cloud.tencent.com/document/product/583) | 2023-10-31 02:17:15 |
+| scf | [云函数](https://cloud.tencent.com/document/product/583) | 2023-11-09 01:22:49 |
 | ses | [邮件推送](https://cloud.tencent.com/document/product/1288) | 2023-11-07 02:07:25 |
 | smh | [智能媒资托管](https://cloud.tencent.com/document/product/1339) | 2023-07-11 01:37:49 |
 | smop | [腾讯安心用户运营平台](https://cloud.tencent.com/document/product/1310) | 2023-05-18 01:47:59 |
@@ -197,7 +197,7 @@
 | tcss | [容器安全服务](https://cloud.tencent.com/document/product/1285) | 2023-11-01 01:21:35 |
 | tdcpg | [TDSQL-C PostgreSQL 版](https://cloud.tencent.com/document/product/1556) | 2023-06-21 01:36:25 |
 | tdid | [分布式身份](https://cloud.tencent.com/document/product/1439) | 2023-07-24 01:49:20 |
-| tdmq | [消息队列 TDMQ](https://cloud.tencent.com/document/product/1179) | 2023-11-08 02:14:24 |
+| tdmq | [消息队列 TDMQ](https://cloud.tencent.com/document/product/1179) | 2023-11-09 01:25:09 |
 | tds | [设备安全](https://cloud.tencent.com/document/product/1628) | 2023-05-18 01:55:50 |
 | tem | [弹性微服务](https://cloud.tencent.com/document/product/1371) | 2023-08-30 01:25:15 |
 | teo | [边缘安全加速平台](https://cloud.tencent.com/document/product/1552) | 2023-11-07 16:01:35 |
@@ -210,7 +210,7 @@
 | tiia | [图像分析](https://cloud.tencent.com/document/product/865) | 2023-09-01 01:23:47 |
 | tione | [TI-ONE 训练平台](https://cloud.tencent.com/document/product/851) | 2023-11-07 02:22:04 |
 | tiw | [互动白板](https://cloud.tencent.com/document/product/1137) | 2023-11-01 01:23:35 |
-| tke | [容器服务](https://cloud.tencent.com/document/product/457) | 2023-11-08 02:19:23 |
+| tke | [容器服务](https://cloud.tencent.com/document/product/457) | 2023-11-09 01:26:28 |
 | tkgdq | [腾讯知识图谱数据查询](https://cloud.tencent.com/document/product) | 2020-03-10 00:51:44 |
 | tms | [文本内容安全](https://cloud.tencent.com/document/product/1124) | 2023-10-25 01:27:42 |
 | tmt | [机器翻译](https://cloud.tencent.com/document/product/551) | 2023-09-27 01:26:36 |
@@ -221,16 +221,16 @@
 | trro | [远程实时操控](https://cloud.tencent.com/document/product/1584) | 2023-07-18 01:53:24 |
 | trtc | [实时音视频](https://cloud.tencent.com/document/product/647) | 2023-10-31 02:39:19 |
 | tse | [微服务引擎 TSE](https://cloud.tencent.com/document/product/1364) | 2023-10-20 01:26:31 |
-| tsf | [微服务平台 TSF](https://cloud.tencent.com/document/product/649) | 2023-10-11 02:39:14 |
+| tsf | [微服务平台 TSF](https://cloud.tencent.com/document/product/649) | 2023-11-09 01:27:51 |
 | tsw | [微服务观测平台 TSW](https://cloud.tencent.com/document/product/1311) | 2023-05-18 02:04:00 |
 | tts | [语音合成](https://cloud.tencent.com/document/product/1073) | 2023-09-19 01:29:02 |
 | ump | [客流数字化平台](https://cloud.tencent.com/document/product/1320) | 2023-08-17 05:50:27 |
 | vm | [视频内容安全](https://cloud.tencent.com/document/product/1265) | 2023-05-18 02:04:19 |
 | vms | [语音消息](https://cloud.tencent.com/document/product/1128) | 2023-08-17 05:50:56 |
 | vod | [云点播](https://cloud.tencent.com/document/product/266) | 2023-11-07 02:30:32 |
-| vpc | [私有网络](https://cloud.tencent.com/document/product/215) | 2023-11-06 00:23:58 |
+| vpc | [私有网络](https://cloud.tencent.com/document/product/215) | 2023-11-09 01:29:06 |
 | vrs | [声音复刻](https://cloud.tencent.com/document/product/1283) | 2023-11-03 01:27:03 |
-| waf | [Web 应用防火墙](https://cloud.tencent.com/document/product/627) | 2023-11-08 02:29:51 |
+| waf | [Web 应用防火墙](https://cloud.tencent.com/document/product/627) | 2023-11-08 10:49:05 |
 | wav | [企业微信汽车行业版](https://cloud.tencent.com/document/product/1318) | 2023-07-18 01:59:28 |
 | wedata | [数据开发治理平台 WeData](https://cloud.tencent.com/document/product/1267) | 2023-11-07 02:48:57 |
 | weilingwith | [微瓴同业开放平台](https://cloud.tencent.com/document/product/1693) | 2023-09-12 09:30:48 |

package/src/services/ess/v20201111/ess_client.ts

@@ -303,20 +303,23 @@ export class Client extends TencentCloudCommon.AbstractClient {
 
   /**
      * 此接口（DescribeFlowTemplates）用于查询本企业模板列表信息。
->  一个模板通常会包含以下结构信息
->- 模板基本信息
->- 发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
->- 填写控件 Components
->- 签署控件 SignComponents
->- 生成模板的文件基础信息 FileInfos
 
-![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
-
-当模板较多或模板中的控件较多时，可以通过查询模板接口更方便的获取模板列表，以及每个模板内的控件信息。
 
-适用场景：
+**适用场景**
 该接口常用来配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">模板发起合同-创建电子文档</a>接口，作为创建电子文档的前置接口使用。
 通过此接口查询到模板信息后，再通过调用创建电子文档接口，指定模板ID，指定模板中需要的填写控件内容等，完成电子文档的创建。
+
+**一个模板通常会包含以下结构信息** 
+
+- 模板模版ID, 模板名字等基本信息
+- 发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
+- 发起方和签署方的填写控件 Components
+- 签署方的签署控件 SignComponents
+
+![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
+
+模版中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
+![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
      */
   async DescribeFlowTemplates(
     req: DescribeFlowTemplatesRequest,
@@ -762,10 +765,8 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");
   }
 
   /**
-     * 此接口（DescribeIntegrationRoles）用于分页查询企业角色列表，列表按照角色创建时间升序排列。
-
-注：`法人角色是系统保留角色，因此返回列表中不含法人角色。`
-     */
+   * 此接口（DescribeIntegrationRoles）用于分页查询企业角色列表，列表按照角色创建时间升序排列。
+   */
   async DescribeIntegrationRoles(
     req: DescribeIntegrationRolesRequest,
     cb?: (error: string, rep: DescribeIntegrationRolesResponse) => void
@@ -1123,7 +1124,7 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");
   }
 
   /**
-   * 查询企业使用情况
+   * 通过此接口（DescribeBillUsageDetail）查询该企业的套餐消耗详情。
    */
   async DescribeBillUsageDetail(
     req: DescribeBillUsageDetailRequest,

package/src/services/ess/v20201111/ess_models.ts

@@ -41,7 +41,8 @@ export interface BillUsageDetail {
    */
   FlowId?: string
   /**
-   * 经办人名称
+   * 合同经办人名称
+如果有多个经办人用分号隔开。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   OperatorName?: string
@@ -57,12 +58,39 @@ export interface BillUsageDetail {
    */
   FlowName?: string
   /**
-   * 0 还没有发起 1等待签署 2部分签署 3拒签 4已签署 5已过期 6已撤销 7还没有预发起 8等待填写 9部分填写 10拒填 11已解除
+   * 当前合同状态,如下是状态码对应的状态。
+0-还没有发起
+1-等待签署
+2-部分签署 
+3-拒签
+4-已签署 
+5-已过期 
+6-已撤销 
+7-还没有预发起
+8-等待填写
+9-部分填写 
+10-拒填
+11-已解除
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Status?: number
   /**
    * 套餐类型
+对应关系如下
+CloudEnterprise-企业版合同
+SingleSignature-单方签章
+CloudProve-签署报告
+CloudOnlineSign-腾讯会议在线签约
+ChannelWeCard-微工卡
+SignFlow-合同套餐
+SignFace-签署意愿（人脸识别）
+SignPassword-签署意愿（密码）
+SignSMS-签署意愿（短信）
+PersonalEssAuth-签署人实名（腾讯电子签认证）
+PersonalThirdAuth-签署人实名（信任第三方认证）
+OrgEssAuth-签署企业实名
+FlowNotify-短信通知
+AuthService-企业工商信息查询
 注意：此字段可能返回 null，表示取不到有效值。
    */
   QuotaType?: string
@@ -72,17 +100,18 @@ export interface BillUsageDetail {
    */
   UseCount?: number
   /**
-   * 消耗的时间戳
+   * 消耗的时间戳，格式为Unix标准时间戳（秒）。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   CostTime?: number
   /**
-   * 套餐名称
+   * 消耗的套餐名称
 注意：此字段可能返回 null，表示取不到有效值。
    */
   QuotaName?: string
   /**
-   *  消耗类型	1.扣费 2.撤销返还
+   * 消耗类型
+1.扣费 2.撤销返还
 注意：此字段可能返回 null，表示取不到有效值。
    */
   CostType?: number
@@ -5202,6 +5231,10 @@ export interface CreatePrepareFlowResponse {
    * 发起流程的web页面链接，有效期5分钟
    */
   Url?: string
+  /**
+   * 创建的合同id（还未实际发起），每次调用会生成新的id，用户可以记录此字段对应后续页面发起的合同，若在页面上未成功发起，则此字段无效。
+   */
+  FlowId?: string
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -6398,17 +6431,17 @@ export interface DeleteStaffsResult {
  */
 export interface DescribeBillUsageDetailRequest {
   /**
-   * 查询开始时间，时间跨度不能大于31天
+   * 查询开始时间字符串，格式为yyyymmdd,时间跨度不能大于31天
    */
   StartTime: string
   /**
-   * 查询结束时间，时间跨度不能大于31天
+   * 查询结束时间字符串，格式为yyyymmdd,时间跨度不能大于31天
    */
   EndTime: string
   /**
    * 指定分页返回第几页的数据，如果不传默认返回第一页，页码从 0 开始，即首页为 0
    */
-  Offset: number
+  Offset?: number
   /**
    * 指定分页每页返回的数据条数，如果不传默认为 50，单页最大支持 50。
    */
@@ -6433,8 +6466,8 @@ AuthService-企业工商信息查询
    */
   QuotaType?: string
   /**
-   * 非必填，查询某个渠道企业的消耗情况。
-关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }

package/tencentcloud/services/ess/v20201111/ess_client.d.ts

@@ -47,20 +47,23 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
     CancelFlow(req: CancelFlowRequest, cb?: (error: string, rep: CancelFlowResponse) => void): Promise<CancelFlowResponse>;
     /**
        * 此接口（DescribeFlowTemplates）用于查询本企业模板列表信息。
-  >  一个模板通常会包含以下结构信息
-  >- 模板基本信息
-  >- 发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
-  >- 填写控件 Components
-  >- 签署控件 SignComponents
-  >- 生成模板的文件基础信息 FileInfos
   
-  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
-  
-  当模板较多或模板中的控件较多时，可以通过查询模板接口更方便的获取模板列表，以及每个模板内的控件信息。
   
-  适用场景：
+  **适用场景**
   该接口常用来配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">模板发起合同-创建电子文档</a>接口，作为创建电子文档的前置接口使用。
   通过此接口查询到模板信息后，再通过调用创建电子文档接口，指定模板ID，指定模板中需要的填写控件内容等，完成电子文档的创建。
+  
+  **一个模板通常会包含以下结构信息**
+  
+  - 模板模版ID, 模板名字等基本信息
+  - 发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
+  - 发起方和签署方的填写控件 Components
+  - 签署方的签署控件 SignComponents
+  
+  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
+  
+  模版中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
+  ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
        */
     DescribeFlowTemplates(req: DescribeFlowTemplatesRequest, cb?: (error: string, rep: DescribeFlowTemplatesResponse) => void): Promise<DescribeFlowTemplatesResponse>;
     /**
@@ -320,10 +323,8 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     CreateSeal(req: CreateSealRequest, cb?: (error: string, rep: CreateSealResponse) => void): Promise<CreateSealResponse>;
     /**
-       * 此接口（DescribeIntegrationRoles）用于分页查询企业角色列表，列表按照角色创建时间升序排列。
-  
-  注：`法人角色是系统保留角色，因此返回列表中不含法人角色。`
-       */
+     * 此接口（DescribeIntegrationRoles）用于分页查询企业角色列表，列表按照角色创建时间升序排列。
+     */
     DescribeIntegrationRoles(req: DescribeIntegrationRolesRequest, cb?: (error: string, rep: DescribeIntegrationRolesResponse) => void): Promise<DescribeIntegrationRolesResponse>;
     /**
      * 此接口（CreateIntegrationDepartment）用于创建企业的部门信息，支持绑定客户系统部门ID。
@@ -537,7 +538,7 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     CancelUserAutoSignEnableUrl(req: CancelUserAutoSignEnableUrlRequest, cb?: (error: string, rep: CancelUserAutoSignEnableUrlResponse) => void): Promise<CancelUserAutoSignEnableUrlResponse>;
     /**
-     * 查询企业使用情况
+     * 通过此接口（DescribeBillUsageDetail）查询该企业的套餐消耗详情。
      */
     DescribeBillUsageDetail(req: DescribeBillUsageDetailRequest, cb?: (error: string, rep: DescribeBillUsageDetailResponse) => void): Promise<DescribeBillUsageDetailResponse>;
     /**

package/tencentcloud/services/ess/v20201111/ess_client.js

@@ -78,20 +78,23 @@ class Client extends TencentCloudCommon.AbstractClient {
     }
     /**
        * 此接口（DescribeFlowTemplates）用于查询本企业模板列表信息。
-  >  一个模板通常会包含以下结构信息
-  >- 模板基本信息
-  >- 发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
-  >- 填写控件 Components
-  >- 签署控件 SignComponents
-  >- 生成模板的文件基础信息 FileInfos
   
-  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
-  
-  当模板较多或模板中的控件较多时，可以通过查询模板接口更方便的获取模板列表，以及每个模板内的控件信息。
   
-  适用场景：
+  **适用场景**
   该接口常用来配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">模板发起合同-创建电子文档</a>接口，作为创建电子文档的前置接口使用。
   通过此接口查询到模板信息后，再通过调用创建电子文档接口，指定模板ID，指定模板中需要的填写控件内容等，完成电子文档的创建。
+  
+  **一个模板通常会包含以下结构信息**
+  
+  - 模板模版ID, 模板名字等基本信息
+  - 发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
+  - 发起方和签署方的填写控件 Components
+  - 签署方的签署控件 SignComponents
+  
+  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
+  
+  模版中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
+  ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
        */
     async DescribeFlowTemplates(req, cb) {
         return this.request("DescribeFlowTemplates", req, cb);
@@ -413,10 +416,8 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("CreateSeal", req, cb);
     }
     /**
-       * 此接口（DescribeIntegrationRoles）用于分页查询企业角色列表，列表按照角色创建时间升序排列。
-  
-  注：`法人角色是系统保留角色，因此返回列表中不含法人角色。`
-       */
+     * 此接口（DescribeIntegrationRoles）用于分页查询企业角色列表，列表按照角色创建时间升序排列。
+     */
     async DescribeIntegrationRoles(req, cb) {
         return this.request("DescribeIntegrationRoles", req, cb);
     }
@@ -678,7 +679,7 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("CancelUserAutoSignEnableUrl", req, cb);
     }
     /**
-     * 查询企业使用情况
+     * 通过此接口（DescribeBillUsageDetail）查询该企业的套餐消耗详情。
      */
     async DescribeBillUsageDetail(req, cb) {
         return this.request("DescribeBillUsageDetail", req, cb);

package/tencentcloud/services/ess/v20201111/ess_models.d.ts

@@ -23,7 +23,8 @@ export interface BillUsageDetail {
      */
     FlowId?: string;
     /**
-     * 经办人名称
+     * 合同经办人名称
+  如果有多个经办人用分号隔开。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     OperatorName?: string;
@@ -39,12 +40,39 @@ export interface BillUsageDetail {
      */
     FlowName?: string;
     /**
-     * 0 还没有发起 1等待签署 2部分签署 3拒签 4已签署 5已过期 6已撤销 7还没有预发起 8等待填写 9部分填写 10拒填 11已解除
+     * 当前合同状态,如下是状态码对应的状态。
+  0-还没有发起
+  1-等待签署
+  2-部分签署
+  3-拒签
+  4-已签署
+  5-已过期
+  6-已撤销
+  7-还没有预发起
+  8-等待填写
+  9-部分填写
+  10-拒填
+  11-已解除
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Status?: number;
     /**
      * 套餐类型
+  对应关系如下
+  CloudEnterprise-企业版合同
+  SingleSignature-单方签章
+  CloudProve-签署报告
+  CloudOnlineSign-腾讯会议在线签约
+  ChannelWeCard-微工卡
+  SignFlow-合同套餐
+  SignFace-签署意愿（人脸识别）
+  SignPassword-签署意愿（密码）
+  SignSMS-签署意愿（短信）
+  PersonalEssAuth-签署人实名（腾讯电子签认证）
+  PersonalThirdAuth-签署人实名（信任第三方认证）
+  OrgEssAuth-签署企业实名
+  FlowNotify-短信通知
+  AuthService-企业工商信息查询
   注意：此字段可能返回 null，表示取不到有效值。
      */
     QuotaType?: string;
@@ -54,17 +82,18 @@ export interface BillUsageDetail {
      */
     UseCount?: number;
     /**
-     * 消耗的时间戳
+     * 消耗的时间戳，格式为Unix标准时间戳（秒）。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     CostTime?: number;
     /**
-     * 套餐名称
+     * 消耗的套餐名称
   注意：此字段可能返回 null，表示取不到有效值。
      */
     QuotaName?: string;
     /**
-     *  消耗类型	1.扣费 2.撤销返还
+     * 消耗类型
+  1.扣费 2.撤销返还
   注意：此字段可能返回 null，表示取不到有效值。
      */
     CostType?: number;
@@ -5035,6 +5064,10 @@ export interface CreatePrepareFlowResponse {
      * 发起流程的web页面链接，有效期5分钟
      */
     Url?: string;
+    /**
+     * 创建的合同id（还未实际发起），每次调用会生成新的id，用户可以记录此字段对应后续页面发起的合同，若在页面上未成功发起，则此字段无效。
+     */
+    FlowId?: string;
     /**
      * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
      */
@@ -6201,17 +6234,17 @@ export interface DeleteStaffsResult {
  */
 export interface DescribeBillUsageDetailRequest {
     /**
-     * 查询开始时间，时间跨度不能大于31天
+     * 查询开始时间字符串，格式为yyyymmdd,时间跨度不能大于31天
      */
     StartTime: string;
     /**
-     * 查询结束时间，时间跨度不能大于31天
+     * 查询结束时间字符串，格式为yyyymmdd,时间跨度不能大于31天
      */
     EndTime: string;
     /**
      * 指定分页返回第几页的数据，如果不传默认返回第一页，页码从 0 开始，即首页为 0
      */
-    Offset: number;
+    Offset?: number;
     /**
      * 指定分页每页返回的数据条数，如果不传默认为 50，单页最大支持 50。
      */
@@ -6236,8 +6269,8 @@ export interface DescribeBillUsageDetailRequest {
      */
     QuotaType?: string;
     /**
-     * 非必填，查询某个渠道企业的消耗情况。
-  关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+     * 代理企业和员工的信息。
+  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
      */
     Agent?: Agent;
 }