tencentcloud-sdk-ess 3.0.662 → 3.0.664

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 405ece100c210c07ca12170473e6a139f6c2ebc6
-  data.tar.gz: a87239a5750fe47cef63eaa5fa4db194b85d1671
+  metadata.gz: 3ca3937a416e9ca4ca12bc73ec016f4c5b1a9476
+  data.tar.gz: 9884ddae648a4332bcb2da28eeebdc78c21ce4a3
 SHA512:
-  metadata.gz: a86fc6f889f465dde267ca1c31e30ea4e50f32ff60c68e748bd4b0204d0285e47d19cd51adc86c74957019bab1d445d421c01c17f11f1e7eb593d5c29b72b346
-  data.tar.gz: fd9e5329d024aa89190847b7f35b8878a2ace5fc4d1793d237c538c49dca4b6e6ff6c7655bd6a0eec7a81c66c64aaac50ed672b8786e294de0721330d7062664
+  metadata.gz: db212b0a0d4361265d634d22ec685cb505ed1ef4f0af46df7bb4ee92b06249d6eafbc15ce1d19f14f285df8c16efb1c785ef6cfeab467cde9d4acf7848e7ac94
+  data.tar.gz: b7c365a7dce0c39b9097a79dc9fb5219c3ac66122fd87dbe19ba5c962b70d0176825d5bca67bee9d11d60cb38cd51fbcb4f58b83b5b1ac7e176fd841c5dcafcc

data/lib/VERSION

@@ -1 +1 @@
-3.0.662
+3.0.664

data/lib/v20201111/client.rb

@@ -220,9 +220,11 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建签署流程电子文档
-        # 适用场景：见创建签署流程接口。
-        # 注：该接口需要给对应的流程指定一个模板id，并且填充该模板中需要补充的信息。需要配置<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow" target="_blank">创建签署流程</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用, 具体逻辑可以参考下图:
+        # 创建签署流程电子文档<br />
+        # 适用场景：见创建签署流程接口。<br />
+        # 点击查看<a href="https://qian.tencent.com/developers/startFlows/CreateFlow" target="_blank">通过模板创建签署流程</a>
+        # <a href="https://qian.tencent.com/developers/startFlows/CreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>。<br />
+        # 注：该接口需要给对应的流程指定一个模板id，并且填充该模板中需要补充的信息。需要配置<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow" target="_blank">创建签署流程</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。具体逻辑可以参考下图:
 
         # <svg id="SvgjsSvg1077" width="304" height="505" xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svgjs="http://svgjs.com/svgjs"><defs id="SvgjsDefs1078"><pattern patternUnits="userSpaceOnUse" id="pattern_mark_0" width="300" height="300"><text x="150" y="100" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><pattern patternUnits="userSpaceOnUse" id="pattern_mark_1" width="300" height="300"><text x="150" y="200" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><marker id="SvgjsMarker1096" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1097" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker><marker id="SvgjsMarker1108" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1109" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker><marker id="SvgjsMarker1120" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1121" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker><marker id="SvgjsMarker1140" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1141" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker></defs><rect id="svgbackgroundid" width="304" height="505" fill="transparent"></rect><rect id="SvgjsRect1080" width="304" height="505" fill="url(#pattern_mark_0)"></rect><rect id="SvgjsRect1081" width="304" height="505" fill="url(#pattern_mark_1)"></rect><g id="SvgjsG1082" transform="translate(58,121)"><path id="SvgjsPath1083" d="M 0 0L 221 0L 221 262L 0 262Z" stroke-dasharray="3,4" stroke="rgba(33,41,48,1)" stroke-width="1" fill-opacity="1" fill="#ffffff"></path><g id="SvgjsG1084"><text id="SvgjsText1085" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="201px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="120.375" transform="rotate(0)"></text></g></g><g id="SvgjsG1086" transform="translate(88,140.00000000000006)"><path id="SvgjsPath1087" d="M 0 0L 161 0L 161 48L 0 48Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1088"><text id="SvgjsText1089" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="141px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="4.875" transform="rotate(0)"><tspan id="SvgjsTspan1090" dy="16" x="80.5"><tspan id="SvgjsTspan1091" style="text-decoration:;fill: rgb(28, 30, 33);">CreateFlow</tspan></tspan><tspan id="SvgjsTspan1092" dy="16" x="80.5"><tspan id="SvgjsTspan1093" style="text-decoration:;">创建签署流程</tspan></tspan></text></g></g><g id="SvgjsG1094"><path id="SvgjsPath1095" d="M168.5 188.50000000000006L168.5 200.83333333333337L168.5 200.83333333333337L168.5 211.86666666666667" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1096)"></path></g><g id="SvgjsG1098" transform="translate(104.25,213.66666666666669)"><path id="SvgjsPath1099" d="M 0 0L 128.5 0L 128.5 55L 0 55Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1100"><text id="SvgjsText1101" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="109px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="8.375" transform="rotate(0)"><tspan id="SvgjsTspan1102" dy="16" x="64.5"><tspan id="SvgjsTspan1103" style="text-decoration:;fill: rgb(28, 30, 33);">CreateDocument</tspan></tspan><tspan id="SvgjsTspan1104" dy="16" x="64.5"><tspan id="SvgjsTspan1105" style="text-decoration:;">创建电子文档</tspan></tspan></text></g></g><g id="SvgjsG1106"><path id="SvgjsPath1107" d="M168.5 269.16666666666674L168.5 281.5L168.5 281.5L168.5 292.5333333333334" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1108)"></path></g><g id="SvgjsG1110" transform="translate(96.75,294.33333333333337)"><path id="SvgjsPath1111" d="M 0 0L 143.5 0L 143.5 65L 0 65Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1112"><text id="SvgjsText1113" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="124px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="13.375" transform="rotate(0)"><tspan id="SvgjsTspan1114" dy="16" x="72"><tspan id="SvgjsTspan1115" style="text-decoration:;fill: rgb(28, 30, 33);">StartFlow</tspan></tspan><tspan id="SvgjsTspan1116" dy="16" x="72"><tspan id="SvgjsTspan1117" style="text-decoration:;">发起签署流程</tspan></tspan></text></g></g><g id="SvgjsG1118"><path id="SvgjsPath1119" d="M168.5 359.83333333333337L168.5 392.16666666666674L168.5 392.16666666666674L168.5 423.20000000000005" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1120)"></path></g><g id="SvgjsG1122" transform="translate(106.25,425)"><path id="SvgjsPath1123" d="M 0 0L 124.5 0L 124.5 55L 0 55Z" stroke="rgba(33,41,48,1)" stroke-width="1" fill-opacity="1" fill="#ffffff"></path><g id="SvgjsG1124"><text id="SvgjsText1125" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="105px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="8.375" transform="rotate(0)"><tspan id="SvgjsTspan1126" dy="16" x="62.5"><tspan id="SvgjsTspan1127" style="text-decoration:;">开始签署</tspan></tspan><tspan id="SvgjsTspan1128" dy="16" x="62.5"><tspan id="SvgjsTspan1129" style="text-decoration:;">(小程序/H5等)</tspan></tspan></text></g></g><g id="SvgjsG1130" transform="translate(120.5,25)"><path id="SvgjsPath1131" d="M 0 0L 96 0L 96 54L 0 54Z" stroke="rgba(33,41,48,1)" stroke-width="1" fill-opacity="1" fill="#ffffff"></path><g id="SvgjsG1132"><text id="SvgjsText1133" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="76px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="7.875" transform="rotate(0)"><tspan id="SvgjsTspan1134" dy="16" x="48"><tspan id="SvgjsTspan1135" style="text-decoration:;">控制台创建</tspan></tspan><tspan id="SvgjsTspan1136" dy="16" x="48"><tspan id="SvgjsTspan1137" style="text-decoration:;">模板</tspan></tspan></text></g></g><g id="SvgjsG1138"><path id="SvgjsPath1139" d="M168.5 79.5L168.5 109.5L168.5 109.5L168.5 138.20000000000005" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1140)"></path></g><g id="SvgjsG1142" transform="translate(25,114)"><path id="SvgjsPath1143" d="M 0 0L 100 0L 100 40L 0 40Z" stroke="none" fill="none"></path><g id="SvgjsG1144"><text id="SvgjsText1145" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="100px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="9.375" transform="rotate(0)"><tspan id="SvgjsTspan1146" dy="16" x="50"><tspan id="SvgjsTspan1147" style="text-decoration:;">API</tspan></tspan></text></g></g></svg>
 
@@ -741,9 +743,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建快速发起流程
-        # <br/>适用场景：用户通过API 合同文件及签署信息，并可通过我们返回的URL在页面完成签署控件等信息的编辑与确认，快速发起合同.
-        # <br/>注：该接口文件的resourceId 是通过上传文件之后获取的。
+        # 创建发起流程web页面
+        # <br/>适用场景：通过该接口（CreatePrepareFlow）传入合同文件/模板编号及签署人信息，可获得发起流程的可嵌入页面，在页面完成签署控件等信息的编辑与确认后，快速发起流程。
+        # <br/>注：该接口包含模板/文件发起流程的全部功能，调用接口后不会立即发起，需在可嵌入页面点击按钮进行发起流程。
 
         # @param request: Request instance for CreatePrepareFlow.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreatePrepareFlowRequest`
@@ -887,7 +889,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 对企业员工进行印章授权
+        # 本接口（CreateSealPolicy）用于对企业员工进行印章授权
 
         # @param request: Request instance for CreateSealPolicy.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateSealPolicyRequest`
@@ -937,8 +939,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 用来创建嵌入式页面个性化主题配置（例如是否展示电子签logo、定义主题色等），该接口配合其他所有可嵌入页面接口使用
-        # 创建配置对当前企业全局生效，如果多次调用，会以最后一次的配置为准
+        # 用来设置本企业嵌入式页面个性化主题配置（例如是否展示电子签logo、定义主题色等），设置后获取的web签署界面都会使用此配置进行展示。
+
+        # 如果多次调用，会以最后一次的配置为准
 
         # @param request: Request instance for CreateWebThemeConfig.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateWebThemeConfigRequest`
@@ -1038,7 +1041,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 撤销员工持有的印章权限
+        # 本接口（DeleteSealPolicies）用于撤销企业员工持有的印章权限
 
         # @param request: Request instance for DeleteSealPolicies.
         # @type request: :class:`Tencentcloud::ess::V20201111::DeleteSealPoliciesRequest`
@@ -1091,7 +1094,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查询文件下载URL。
+        # 本接口（DescribeFileUrls）用于查询文件的下载URL。
         # 适用场景：通过传参合同流程编号，下载对应的合同PDF文件流到本地。
 
         # @param request: Request instance for DescribeFileUrls.
@@ -1143,7 +1146,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查询流程填写控件内容，可以根据流程Id查询该流程相关联的填写控件信息和填写内容。
+        # 查询流程填写控件内容，可以根据合同流程ID查询该合同流程相关联的填写控件信息和填写内容。
 
         # @param request: Request instance for DescribeFlowComponents.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeFlowComponentsRequest`
@@ -1199,7 +1202,8 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查询合同详情
+        # 接口用户查询合同流程的详情信息, 支持查询多个(数量不能超过100)
+
         # 适用场景：可用于主动查询某个合同详情信息。
 
         # @param request: Request instance for DescribeFlowInfo.
@@ -1224,13 +1228,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口用于查询本企业模板列表。
-
-        # 当模板较多或模板中的控件较多时，可以通过查询模板接口更方便的获取模板列表，以及每个模板内的控件信息。
-
-        # > **适用场景**
-        # >
-        # >  该接口常用来配合“模板发起合同-创建电子文档”接口作为前置的接口使用。
+        # 此接口（DescribeFlowTemplates）用于查询本企业模板列表信息。
         # >  一个模板通常会包含以下结构信息
         # >- 模板基本信息
         # >- 发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
@@ -1238,6 +1236,12 @@ module TencentCloud
         # >- 签署控件 SignComponents
         # >- 生成模板的文件基础信息 FileInfos
 
+        # 当模板较多或模板中的控件较多时，可以通过查询模板接口更方便的获取模板列表，以及每个模板内的控件信息。
+
+        # 适用场景：
+        # 该接口常用来配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">模板发起合同-创建电子文档</a>接口，作为创建电子文档的前置接口使用。
+        # 通过此接口查询到模板信息后，再通过调用创建电子文档接口，指定模板ID，指定模板中需要的填写控件内容等，完成电子文档的创建。
+
         # @param request: Request instance for DescribeFlowTemplates.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeFlowTemplatesRequest`
         # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeFlowTemplatesResponse`
@@ -1688,7 +1692,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 对流程的合同文件进行数字签名验证，判断文件是否被篡改。
+        # 对合同流程文件进行数字签名验证，判断数字签名是否有效，合同文件内容是否被篡改。
 
         # @param request: Request instance for VerifyPdf.
         # @type request: :class:`Tencentcloud::ess::V20201111::VerifyPdfRequest`

data/lib/v20201111/models.rb

@@ -1288,6 +1288,7 @@ module TencentCloud
         # @param NeedPreview: 是否为预览模式，取值如下：
         # <ul><li> **false**：非预览模式（默认），会产生合同流程并返回合同流程编号FlowId。</li>
         # <li> **true**：预览模式，不产生合同流程，不返回合同流程编号FlowId，而是返回预览链接PreviewUrl，有效期为300秒，用于查看真实发起后合同的样子。</li></ul>
+        # 注: `当使用的模板中存在动态表格控件时，预览结果中没有动态表格的填写内容`
         # @type NeedPreview: Boolean
         # @param PreviewType: 预览模式下产生的预览链接类型
         # <ul><li> **0** :(默认) 文件流 ,点开后后下载预览的合同PDF文件 </li>
@@ -1349,7 +1350,8 @@ module TencentCloud
         # @type DocumentId: String
         # @param PreviewFileUrl: 合同预览链接URL。
 
-        # 注：如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL
+        # 注: `1.如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL`
+        # `2.当使用的模板中存在动态表格控件时，预览结果中没有动态表格的填写内容`
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type PreviewFileUrl: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -1969,44 +1971,44 @@ module TencentCloud
       # 创建合同个性化参数
       class CreateFlowOption < TencentCloud::Common::AbstractModel
         # @param CanEditFlow: 是否允许修改发起合同时确认弹窗的合同信息（合同名称、合同类型、签署截止时间），若不允许编辑，则表单字段将被禁止输入。
-        # <br/>true：允许编辑（默认），<br/>false：不允许编辑<br/>默认：false：不允许编辑
+        # <br/>true：允许编辑<br/>false：不允许编辑（默认值）<br/>
         # @type CanEditFlow: Boolean
         # @param CanEditFormField: 是否允许编辑模板控件
         # <br/>true:允许编辑模板控件信息
-        # <br/>false:不允许编辑模板控件信息
-        # <br/>默认false:不允许编辑模板控件信息
+        # <br/>false:不允许编辑模板控件信息（默认值）
+        # <br/>
         # @type CanEditFormField: Boolean
         # @param HideShowFlowName: 发起页面隐藏合同名称展示
         # <br/>true:发起页面隐藏合同名称展示
-        # <br/>false:发起页面不隐藏合同名称展示
-        # <br/>默认false:发起页面不隐藏合同名称展示
+        # <br/>false:发起页面不隐藏合同名称展示（默认值）
+        # <br/>
         # @type HideShowFlowName: Boolean
         # @param HideShowFlowType: 发起页面隐藏合同类型展示
         # <br/>true:发起页面隐藏合同类型展示
-        # <br/>false:发起页面不隐藏合同类型展示
-        # <br/>默认false:发起页面不隐藏合同类型展示
+        # <br/>false:发起页面不隐藏合同类型展示（默认值）
+        # <br/>
         # @type HideShowFlowType: Boolean
         # @param HideShowDeadline: 发起页面隐藏合同截止日期展示
         # <br/>true:发起页面隐藏合同截止日期展示
-        # <br/>false:发起页面不隐藏合同截止日期展示
-        # <br/>默认false:发起页面不隐藏合同截止日期展示
+        # <br/>false:发起页面不隐藏合同截止日期展示（默认值）
+        # <br/>
         # @type HideShowDeadline: Boolean
         # @param CanSkipAddApprover: 发起页面允许跳过添加签署人环节
         # <br/>true:发起页面允许跳过添加签署人环节
-        # <br/>false:发起页面不允许跳过添加签署人环节
-        # <br/>默认false:发起页面不允许跳过添加签署人环节
+        # <br/>false:发起页面不允许跳过添加签署人环节（默认值）
+        # <br/>
         # @type CanSkipAddApprover: Boolean
         # @param SkipUploadFile: 文件发起页面跳过文件上传步骤
         # <br/>true:文件发起页面跳过文件上传步骤
-        # <br/>false:文件发起页面不跳过文件上传步骤
-        # <br/>默认false:文件发起页面不跳过文件上传步骤
+        # <br/>false:文件发起页面不跳过文件上传步骤（默认值）
+        # <br/>
         # @type SkipUploadFile: Boolean
         # @param ForbidEditFillComponent: 禁止编辑填写控件
         # <br/>true:禁止编辑填写控件
-        # <br/>false:允许编辑填写控件
-        # <br/>默认false:允许编辑填写控件
+        # <br/>false:允许编辑填写控件（默认值）
+        # <br/>
         # @type ForbidEditFillComponent: Boolean
-        # @param CustomCreateFlowDescription: 定制化发起合同弹窗的描述信息，描述信息最长500
+        # @param CustomCreateFlowDescription: 定制化发起合同弹窗的描述信息，描述信息最长500字符
         # @type CustomCreateFlowDescription: String
 
         attr_accessor :CanEditFlow, :CanEditFormField, :HideShowFlowName, :HideShowFlowType, :HideShowDeadline, :CanSkipAddApprover, :SkipUploadFile, :ForbidEditFillComponent, :CustomCreateFlowDescription
@@ -2997,67 +2999,79 @@ module TencentCloud
 
       # CreatePrepareFlow请求参数结构体
       class CreatePrepareFlowRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+        # 支持填入集团子公司经办人 userId 代发合同。
+
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param ResourceId: 资源id，与ResourceType对应
+        # @param ResourceId: 资源id，与ResourceType相对应，取值范围：
+        # <ul>
+        # <li>文件Id（通过UploadFiles获取文件资源Id）</li>
+        # <li>模板Id</li>
+        # </ul>
         # @type ResourceId: String
-        # @param FlowName: 合同名称
+        # @param FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         # @type FlowName: String
-        # @param Unordered: 是否顺序签署
-        # true:无序签
-        # false:顺序签
+        # @param Unordered: 合同流程的签署顺序类型：
+        # <ul><li> **false**：(默认)有序签署, 本合同多个参与人需要依次签署 </li>
+        # <li> **true**：无序签署, 本合同多个参与人没有先后签署限制</li></ul>
         # @type Unordered: Boolean
-        # @param Deadline: 签署流程的签署截止时间。
-        # 值为unix时间戳,精确到秒
-        # 不传默认为当前时间一年后
+        # @param Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的365天时截止。
         # @type Deadline: Integer
         # @param UserFlowTypeId: 用户自定义合同类型Id
 
-        # 该id为电子签企业内的合同类型id， 可以在自定义合同类型处获取
+        # 该id为电子签企业内的合同类型id， 可以在控制台-合同-自定义合同类型处获取
+        # 注: `该参数如果和FlowType同时传，以该参数优先生效`
         # @type UserFlowTypeId: String
-        # @param FlowType: 合同类型名称
-        # 该字段用于客户自定义合同类型
-        # 建议使用时指定合同类型，便于之后合同分类以及查看
-        # 如果合同类型与自定义的合同类型描述一致，会自动归类到自定义的合同类型处，如果不一致，则会创建一个新的自定义合同类型
+        # @param FlowType: 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为200个字符，仅限中文、字母、数字和下划线组成。
         # @type FlowType: String
-        # @param Approvers: 签署流程参与者信息，最大限制50方
+        # @param Approvers: 合同流程的参与方列表，最多可支持50个参与方，可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息，具体定义可以参考开发者中心的ApproverInfo结构体。
+
+        # 如果合同流程是有序签署，Approvers列表中参与人的顺序就是默认的签署顺序，请确保列表中参与人的顺序符合实际签署顺序。
         # @type Approvers: Array
-        # @param IntelligentStatus: 打开智能添加填写区
-        # 默认开启，打开:"OPEN"
-        #  关闭："CLOSE"
+        # @param IntelligentStatus: 开启或者关闭智能添加填写区：
+        # <ul><li> **OPEN**：开启（默认值）</li>
+        # <li> **CLOSE**：关闭</li></ul>
         # @type IntelligentStatus: String
-        # @param ResourceType: 资源类型，
-        # 1：模板
-        # 2：文件，
-        # 不传默认为2：文件
+        # @param ResourceType: 资源类型，取值有：
+        # <ul><li> **1**：模板</li>
+        # <li> **2**：文件（默认值）</li></ul>
         # @type ResourceType: Integer
-        # @param Components: 发起方填写控件
-        # 该类型控件由发起方完成填写
+        # @param Components: 该字段已废弃，请使用InitiatorComponents
         # @type Components: :class:`Tencentcloud::Ess.v20201111.models.Component`
         # @param FlowOption: 发起合同个性化参数
         # 用于满足创建及页面操作过程中的个性化要求
         # 具体定制化内容详见数据接口说明
         # @type FlowOption: :class:`Tencentcloud::Ess.v20201111.models.CreateFlowOption`
-        # @param NeedSignReview: 是否开启发起方签署审核
-        # true:开启发起方签署审核
-        # false:不开启发起方签署审核
-        # 默认false:不开启发起方签署审核
+        # @param NeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+        # <ul><li> **false**：（默认）不需要审批，直接签署。</li>
+        # <li> **true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
+        # 企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
+        # <ul><li> 如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
+        # <li> 如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
+        # 注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
         # @type NeedSignReview: Boolean
-        # @param NeedCreateReview: 开启发起方发起合同审核
-        # true:开启发起方发起合同审核
-        # false:不开启发起方发起合同审核
-        # 默认false:不开启发起方发起合同审核
+        # @param NeedCreateReview: 发起方企业的签署人进行发起操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。
+
+        # 若设置为true，发起审核结果需通过接口 CreateFlowSignReview 通知电子签，审核通过后，发起方企业签署人方可进行发起操作，否则会阻塞其发起操作。
+
         # @type NeedCreateReview: Boolean
-        # @param UserData: 用户自定义参数
+        # @param UserData: 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为 20480长度。
+
+        # 在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
         # @type UserData: String
-        # @param FlowId: 合同id,用于通过已web页面发起的合同id快速生成一个web发起合同链接
+        # @param FlowId: 合同Id：用于通过一个已发起的合同快速生成一个发起流程web链接
+        # 注: `该参数必须是一个待发起审核的合同id，并且还未审核通过`
         # @type FlowId: String
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param InitiatorComponents: 模板或者合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体
+        # @type InitiatorComponents: Array
 
-        attr_accessor :Operator, :ResourceId, :FlowName, :Unordered, :Deadline, :UserFlowTypeId, :FlowType, :Approvers, :IntelligentStatus, :ResourceType, :Components, :FlowOption, :NeedSignReview, :NeedCreateReview, :UserData, :FlowId, :Agent
+        attr_accessor :Operator, :ResourceId, :FlowName, :Unordered, :Deadline, :UserFlowTypeId, :FlowType, :Approvers, :IntelligentStatus, :ResourceType, :Components, :FlowOption, :NeedSignReview, :NeedCreateReview, :UserData, :FlowId, :Agent, :InitiatorComponents
 
-        def initialize(operator=nil, resourceid=nil, flowname=nil, unordered=nil, deadline=nil, userflowtypeid=nil, flowtype=nil, approvers=nil, intelligentstatus=nil, resourcetype=nil, components=nil, flowoption=nil, needsignreview=nil, needcreatereview=nil, userdata=nil, flowid=nil, agent=nil)
+        def initialize(operator=nil, resourceid=nil, flowname=nil, unordered=nil, deadline=nil, userflowtypeid=nil, flowtype=nil, approvers=nil, intelligentstatus=nil, resourcetype=nil, components=nil, flowoption=nil, needsignreview=nil, needcreatereview=nil, userdata=nil, flowid=nil, agent=nil, initiatorcomponents=nil)
           @Operator = operator
           @ResourceId = resourceid
           @FlowName = flowname
@@ -3075,6 +3089,7 @@ module TencentCloud
           @UserData = userdata
           @FlowId = flowid
           @Agent = agent
+          @InitiatorComponents = initiatorcomponents
         end
 
         def deserialize(params)
@@ -3114,12 +3129,20 @@ module TencentCloud
             @Agent = Agent.new
             @Agent.deserialize(params['Agent'])
           end
+          unless params['InitiatorComponents'].nil?
+            @InitiatorComponents = []
+            params['InitiatorComponents'].each do |i|
+              component_tmp = Component.new
+              component_tmp.deserialize(i)
+              @InitiatorComponents << component_tmp
+            end
+          end
         end
       end
 
       # CreatePrepareFlow返回参数结构体
       class CreatePrepareFlowResponse < TencentCloud::Common::AbstractModel
-        # @param Url: 快速发起预览链接，有效期5分钟
+        # @param Url: 发起流程的web页面链接，有效期5分钟
         # @type Url: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -3141,18 +3164,20 @@ module TencentCloud
       class CreatePreparedPersonalEsignRequest < TencentCloud::Common::AbstractModel
         # @param UserName: 个人用户姓名
         # @type UserName: String
-        # @param IdCardNumber: 身份证件号码
+        # @param IdCardNumber: 证件号码，应符合以下规则
+        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+        # <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+        # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         # @type IdCardNumber: String
-        # @param SealName: 印章名称
+        # @param SealName: 印章名称，长度1-50个字。
         # @type SealName: String
-        # @param Operator: 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId代发合同。
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param IdCardType: 身份证件类型:
-        # ID_CARD 身份证
-        # PASSPORT 护照
-        # HONGKONG_AND_MACAO 中国香港
-        # FOREIGN_ID_CARD 境外身份
-        # HONGKONG_MACAO_AND_TAIWAN 中国台湾
+        # @param IdCardType: 证件类型，支持以下类型
+        # <ul><li>ID_CARD : 居民身份证 (默认值)</li>
+        # <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+        # <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
         # @type IdCardType: String
         # @param SealImage: 印章图片的base64
         # 注：已废弃
@@ -3171,16 +3196,19 @@ module TencentCloud
         # RED 红色,
         # BLUE 蓝色。
         # @type SealColor: String
-        # @param ProcessSeal: 是否处理印章
-        # 默认不做印章处理。
-        # 取值：false：不做任何处理；
-        # true：做透明化处理和颜色增强。
+        # @param ProcessSeal: 是否处理印章，默认不做印章处理。
+        # 取值如下：
+        # <ul>
+        # <li>false：不做任何处理；</li>
+        # <li>true：做透明化处理和颜色增强。</li>
+        # </ul>
         # @type ProcessSeal: Boolean
         # @param FileId: 印章图片文件 id
         # 取值：
         # 填写的FileId通过UploadFiles接口上传文件获取。
         # @type FileId: String
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
         # @param LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。一旦绑定后，将扣减购买的个人自动签账号许可一次（1年有效期），不可解绑释放。不传默认为绑定自动签账号许可。 0-绑定个人自动签账号许可，开通后将扣减购买的个人自动签账号许可一次 1-不绑定，发起合同时将按标准合同套餐进行扣减
         # @type LicenseType: Integer
@@ -3233,7 +3261,8 @@ module TencentCloud
 
       # CreatePreparedPersonalEsign返回参数结构体
       class CreatePreparedPersonalEsignResponse < TencentCloud::Common::AbstractModel
-        # @param SealId: 导入生成的印章ID
+        # @param SealId: 导入生成的印章ID，为32位字符串。
+        # 建议开发者保存此印章ID，开头实名认证后，通过此 ID查询导入的印章。
         # @type SealId: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -3448,11 +3477,14 @@ module TencentCloud
 
       # CreateSealPolicy请求参数结构体
       class CreateSealPolicyRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param Users: 用户在电子文件签署平台标识信息，具体参考UserInfo结构体。可跟下面的UserIds可叠加起作用
         # @type Users: Array
-        # @param SealId: 印章ID
+        # @param SealId: 电子印章ID，为32位字符串。
+        # 建议开发者保留此印章ID，后续指定签署区印章或者操作印章需此印章ID。
+        # 可登录腾讯电子签控制台，在 "印章"->"印章中心"选择查看的印章，在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
         # @type SealId: String
         # @param Expired: 授权有效期。时间戳秒级
         # @type Expired: Integer
@@ -3460,7 +3492,8 @@ module TencentCloud
         # @type UserIds: Array
         # @param Policy: 印章授权内容
         # @type Policy: String
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :Users, :SealId, :Expired, :UserIds, :Policy, :Agent
@@ -3501,7 +3534,8 @@ module TencentCloud
 
       # CreateSealPolicy返回参数结构体
       class CreateSealPolicyResponse < TencentCloud::Common::AbstractModel
-        # @param UserIds: 最终授权成功的。其他的跳过的是已经授权了的
+        # @param UserIds: 最终授权成功的用户ID，在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
         # @type UserIds: Array
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -3534,10 +3568,12 @@ module TencentCloud
         # 如果要使用图片上传请传字段 Image
         # @type GenerateSource: String
         # @param SealType: 电子印章类型：
-        # OFFICIAL-公章；
-        # CONTRACT-合同专用章;
-        # FINANCE-合财务专用章;
-        # PERSONNEL-人事专用章.
+        # <ul>
+        # <li>OFFICIAL-公章；</li>
+        # <li>CONTRACT-合同专用章;</li>
+        # <li>FINANCE-合财务专用章;</li>
+        # <li>PERSONNEL-人事专用章.</li>
+        # </ul>
         # @type SealType: String
         # @param FileName: 电子印章图片文件名称，1-50个中文字符。
         # @type FileName: String
@@ -3562,16 +3598,20 @@ module TencentCloud
         # @type SealCentralType: String
         # @param FileToken: 通过文件上传时，服务端生成的电子印章上传图片的token
         # @type FileToken: String
-        # @param SealStyle: 印章样式:
+        # @param SealStyle: 印章样式，取值如下:
 
-        # cycle:圆形印章;
-        # ellipse:椭圆印章;
-        # 注：默认圆形印章
+        # <ul>
+        # <li>cycle:圆形印章;</li>
+        # <li>ellipse:椭圆印章;</li>
+        # <li>注：默认圆形印章</li>
+        # </ul>
         # @type SealStyle: String
         # @param SealSize: 印章尺寸取值描述：
-        # 42_42 圆形企业公章直径42mm；
-        # 40_40 圆形企业印章直径40mm；
-        # 45_30 椭圆形印章45mm x 30mm;
+        # <ul>
+        # <li>42_42 圆形企业公章直径42mm；</li>
+        # <li>40_40 圆形企业印章直径40mm；</li>
+        # <li>45_30 椭圆形印章45mm x 30mm;</li>
+        # </ul>
         # @type SealSize: String
 
         attr_accessor :Operator, :SealName, :Agent, :GenerateSource, :SealType, :FileName, :Image, :Width, :Height, :Color, :SealHorizontalText, :SealChordText, :SealCentralType, :FileToken, :SealStyle, :SealSize
@@ -3623,7 +3663,9 @@ module TencentCloud
 
       # CreateSeal返回参数结构体
       class CreateSealResponse < TencentCloud::Common::AbstractModel
-        # @param SealId: 电子印章编号
+        # @param SealId: 电子印章ID，为32位字符串。
+        # 建议开发者保留此印章ID，后续指定签署区印章或者操作印章需此印章ID。
+        # 可登录腾讯电子签控制台，在 "印章"->"印章中心"选择查看的印章，在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
         # @type SealId: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -3797,7 +3839,7 @@ module TencentCloud
         # <ul><li> **EMBED_WEB_THEME**：嵌入式主题（默认），web页面嵌入的主题风格配置</li>
         # </ul>
         # @type ThemeType: String
-        # @param WebThemeConfig: 主题配置
+        # @param WebThemeConfig: 电子签logo是否展示，主体颜色等配置项
         # @type WebThemeConfig: :class:`Tencentcloud::Ess.v20201111.models.WebThemeConfig`
         # @param Agent: 代理企业和员工的信息。
         # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
@@ -4027,15 +4069,21 @@ module TencentCloud
 
       # DeleteSealPolicies请求参数结构体
       class DeleteSealPoliciesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param PolicyIds: 印章授权编码数组。这个参数跟下面的SealId其中一个必填，另外一个可选填
         # @type PolicyIds: Array
-        # @param SealId: 印章ID。这个参数跟上面的PolicyIds其中一个必填，另外一个可选填
+        # @param SealId: 电子印章ID，为32位字符串。
+        # 建议开发者保留此印章ID，后续指定签署区印章或者操作印章需此印章ID。
+        # 可登录腾讯电子签控制台，在 "印章"->"印章中心"选择查看的印章，在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
+        # 注：印章ID。这个参数跟上面的PolicyIds其中一个必填，另外一个可选填。
         # @type SealId: String
-        # @param UserIds: 待授权的员工ID
+        # @param UserIds: 待授权的员工ID，员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
         # @type UserIds: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :PolicyIds, :SealId, :UserIds, :Agent
@@ -4203,24 +4251,38 @@ module TencentCloud
 
       # DescribeFileUrls请求参数结构体
       class DescribeFileUrlsRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，UserId 必填
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param BusinessType: 文件对应的业务类型，目前支持：
-        # - 流程 "FLOW"，如需下载合同文件请选择此项
-        # - 模板 "TEMPLATE"
-        # - 文档 "DOCUMENT"
-        # - 印章  “SEAL”
+        # <ul>
+        # <li>FLOW 如需下载合同文件请选择此项</li>
+        # <li>TEMPLATE 如需下载模板文件请选择此项</li>
+        # <li>DOCUMENT 如需下载文档文件请选择此项</li>
+        # <li>SEAL 如需下载印章图片请选择此项</li>
+        # </ul>
         # @type BusinessType: String
-        # @param BusinessIds: 业务编号的数组，如流程编号、模板编号、文档编号、印章编号。如需下载合同文件请传入FlowId
-        # 最大支持20个资源
+        # @param BusinessIds: 业务编号的数组，取值如下：
+        # <ul>
+        # <li>流程编号</li>
+        # <li>模板编号</li>
+        # <li>文档编号</li>
+        # <li>印章编号</li>
+        # <li>如需下载合同文件请传入FlowId，最大支持20个资源</li>
+        # </ul>
         # @type BusinessIds: Array
         # @param FileName: 下载后的文件命名，只有FileType为zip的时候生效
         # @type FileName: String
-        # @param FileType: 文件类型，"JPG", "PDF","ZIP"等
+        # @param FileType: 要下载的文件类型，取值如下：
+        # <ul>
+        # <li>JPG</li>
+        # <li>PDF</li>
+        # <li>ZIP</li>
+        # </ul>
         # @type FileType: String
-        # @param Offset: 指定资源起始偏移量，默认0
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页，页码从 0 开始，即首页为 0，最大 1000。
         # @type Offset: Integer
-        # @param Limit: 指定资源数量，查询全部资源则传入-1
+        # @param Limit: 指定分页每页返回的数据条数，如果不传默认为 20，单页最大支持 100。
         # @type Limit: Integer
         # @param UrlTtl: 下载url过期时间，单位秒。0: 按默认值5分钟，允许范围：1s~24x60x60s(1天)
         # @type UrlTtl: Integer
@@ -4371,11 +4433,15 @@ module TencentCloud
 
       # DescribeFlowComponents请求参数结构体
       class DescribeFlowComponentsRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作者信息
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowId: 流程(合同)的编号
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+        # 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         # @type FlowId: String
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :FlowId, :Agent
@@ -4401,7 +4467,7 @@ module TencentCloud
 
       # DescribeFlowComponents返回参数结构体
       class DescribeFlowComponentsResponse < TencentCloud::Common::AbstractModel
-        # @param RecipientComponentInfos: 流程关联的填写控件信息，按照参与方进行分类返回。
+        # @param RecipientComponentInfos: 合同流程关联的填写控件信息，按照参与方进行分类返回。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type RecipientComponentInfos: Array
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -4490,13 +4556,13 @@ module TencentCloud
 
       # DescribeFlowInfo请求参数结构体
       class DescribeFlowInfoRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param FlowIds: 需要查询的流程ID列表，限制最大100个
 
         # 如果查询合同组的信息,不要传此参数
         # @type FlowIds: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
         # @param FlowGroupId: 合同组ID, 如果传此参数会忽略FlowIds入参
         #  所以如传此参数不要传FlowIds参数
@@ -4529,7 +4595,7 @@ module TencentCloud
       class DescribeFlowInfoResponse < TencentCloud::Common::AbstractModel
         # @param FlowDetailInfos: 签署流程信息
         # @type FlowDetailInfos: Array
-        # @param FlowGroupId: 合同组ID
+        # @param FlowGroupId: 合同组ID，为32位字符串
         # @type FlowGroupId: String
         # @param FlowGroupName: 合同组名称
         # @type FlowGroupName: String
@@ -4562,28 +4628,32 @@ module TencentCloud
 
       # DescribeFlowTemplates请求参数结构体
       class DescribeFlowTemplatesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方员工/经办人信息
-        # UserId 必填，在企业控制台组织架构中可以查到员工的UserId
-        # 注：请保证员工有相关的角色权限
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Agent: 代理相关应用信息
-        # 如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param ContentType: 查询内容类型
-        # 0-模板列表及详情（默认）
-        # 1-仅模板列表
+        # @param ContentType: 查询内容控制
+
+        # <ul><li>**0**：模板列表及详情（默认）</li>
+        # <li>**1**：仅模板列表</li></ul>
         # @type ContentType: Integer
         # @param Filters: 搜索条件，本字段用于指定模板Id进行查询。
-        # Key：template-id
-        # Values：需要查询的模板Id列表
+        # Key：template-id Values：需要查询的模板Id列表
         # @type Filters: Array
-        # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默从第一页返回。页码从0开始，即首页为0。
+        # @param Offset: 查询结果分页返回，指定从第几页返回数据，和Limit参数配合使用。
+
+        # 注：`1.offset从0开始，即第一页为0。`
+        # `2.默认从第一页返回。`
         # @type Offset: Integer
-        # @param Limit: 指定每页多少条数据，如果不传默认为20，单页最大200。
+        # @param Limit: 指定每页返回的数据条数，和Offset参数配合使用。
+
+        # 注：`1.默认值为20，单页做大值为200。`
         # @type Limit: Integer
-        # @param ApplicationId: 用于查询指定应用号下单模板列表。
-        # ApplicationId不为空，查询指定应用下的模板列表
-        # ApplicationId为空，查询所有应用下的模板列表
+        # @param ApplicationId: 指定查询的应用号，指定后查询该应用号下的模板列表。
+
+        # 注：`1.ApplicationId为空时，查询所有应用下的模板列表。`
         # @type ApplicationId: String
         # @param IsChannel: 默认为false，查询SaaS模板库列表；
         # 为true，查询第三方应用集成平台企业模板库管理列表
@@ -4647,9 +4717,9 @@ module TencentCloud
 
       # DescribeFlowTemplates返回参数结构体
       class DescribeFlowTemplatesResponse < TencentCloud::Common::AbstractModel
-        # @param Templates: 模板详情列表
+        # @param Templates: 模板详情列表数据
         # @type Templates: Array
-        # @param TotalCount: 查询到的总数
+        # @param TotalCount: 查询到的模板总数
         # @type TotalCount: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -5050,36 +5120,46 @@ module TencentCloud
 
       # DescribeOrganizationSeals请求参数结构体
       class DescribeOrganizationSealsRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Limit: 返回最大数量，最大为100
+        # @param Limit: 指定分页每页返回的数据条数，如果不传默认为 20，单页最大支持 200。
         # @type Limit: Integer
-        # @param Offset: 偏移量，默认为0，最大为20000
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页，页码从 0 开始，即首页为 0，最大 20000。
         # @type Offset: Integer
-        # @param InfoType: 查询信息类型，为0时不返回授权用户，为1时返回
+        # @param InfoType: 查询信息类型，取值如下：
+        # <ul>
+        # <li>0不返回授权用户</li>
+        # <li>1返回授权用户信息</li>
+        # </ul>
         # @type InfoType: Integer
         # @param SealId: 印章id（没有输入返回所有）
         # @type SealId: String
         # @param SealTypes: 印章类型列表（都是组织机构印章）。
         # 为空时查询所有类型的印章。
         # 目前支持以下类型：
-        # OFFICIAL：企业公章；
-        # CONTRACT：合同专用章；
-        # ORGANIZATION_SEAL：企业印章(图片上传创建)；
-        # LEGAL_PERSON_SEAL：法定代表人章
+        # <ul>
+        # <li>OFFICIAL：企业公章；</li>
+        # <li>CONTRACT：合同专用章；</li>
+        # <li>ORGANIZATION_SEAL：企业印章(图片上传创建)；</li>
+        # <li>LEGAL_PERSON_SEAL：法定代表人章</li>
+        # </ul>
         # @type SealTypes: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
         # @param SealStatuses: 查询的印章状态列表。
-        # 取值为空，只查询启用状态的印章；
-        # 取值ALL，查询所有状态的印章；
-        # 取值CHECKING，查询待审核的印章；
-        # 取值SUCCESS，查询启用状态的印章；
-        # 取值FAIL，查询印章审核拒绝的印章；
-        # 取值DISABLE，查询已停用的印章；
-        # 取值STOPPED，查询已终止的印章；
-        # 取值VOID，查询已作废的印章；
-        # 取值INVALID，查询已失效的印章；
+        # <ul>
+        # <li>空，只查询启用状态的印章；</li>
+        # <li>ALL，查询所有状态的印章；</li>
+        # <li>CHECKING，查询待审核的印章；</li>
+        # <li>SUCCESS，查询启用状态的印章；</li>
+        # <li>FAIL，查询印章审核拒绝的印章；</li>
+        # <li>DISABLE，查询已停用的印章；</li>
+        # <li>STOPPED，查询已终止的印章；</li>
+        # <li>VOID，查询已作废的印章；</li>
+        # <li>INVALID，查询已失效的印章；</li>
+        # </ul>
         # @type SealStatuses: Array
 
         attr_accessor :Operator, :Limit, :Offset, :InfoType, :SealId, :SealTypes, :Agent, :SealStatuses
@@ -6095,40 +6175,28 @@ module TencentCloud
 
       # 此结构体(FlowDetailInfo)描述的是合同(流程)的详细信息
       class FlowDetailInfo < TencentCloud::Common::AbstractModel
-        # @param FlowId: 合同(流程)的ID
+        # @param FlowId: 合同流程ID，为32位字符串。
         # @type FlowId: String
-        # @param FlowName: 合同(流程)的名字
+        # @param FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         # @type FlowName: String
-        # @param FlowType: 合同(流程)的类型
+        # @param FlowType: 合同流程的类别分类（如销售合同/入职合同等）。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowType: String
-        # @param FlowStatus: 流程状态
-        # - 0 还没有发起
-        # - 1 待签署
-        # - 2 部分签署
-        # - 3 已拒签
-        # - 4 已签署
-        # - 5 已过期
-        # - 6 已撤销
-        # - 7 还没有预发起
-        # - 8 等待填写
-        # - 9 部分填写
-        # - 10 拒填
-        # - 21 已解除
+        # @param FlowStatus: 合同流程当前的签署状态, 会存在下列的状态值 <ul><li> **0** : 未开启流程(合同中不存在填写环节)</li> <li> **1** : 待签署</li> <li> **2** : 部分签署</li> <li> **3** : 已拒签</li> <li> **4** : 已签署</li> <li> **5** : 已过期</li> <li> **6** : 已撤销</li> <li> **7** : 未开启流程(合同中存在填写环节)</li> <li> **8** : 等待填写</li> <li> **9** : 部分填写</li> <li> **10** : 已拒填</li> <li> **21** : 已解除</li></ul>
         # @type FlowStatus: Integer
-        # @param FlowMessage: 合同(流程)的信息
+        # @param FlowMessage: 当合同流程状态为已拒签（即 FlowStatus=3）或已撤销（即 FlowStatus=6）时，此字段 FlowMessage 为拒签或撤销原因。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowMessage: String
-        # @param FlowDescription: 流程的描述
+        # @param FlowDescription: 合同流程描述信息。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowDescription: String
-        # @param CreatedOn: 合同(流程)的创建时间戳，单位秒
+        # @param CreatedOn: 合同流程的创建时间戳，格式为Unix标准时间戳（秒）。
         # @type CreatedOn: Integer
-        # @param FlowApproverInfos: 合同(流程)的签署方数组
+        # @param FlowApproverInfos: 合同流程的签署方数组
         # @type FlowApproverInfos: Array
-        # @param CcInfos: 合同(流程)的关注方信息列表
+        # @param CcInfos: 合同流程的关注方信息数组
         # @type CcInfos: Array
-        # @param Creator: 合同发起人UserId
+        # @param Creator: 合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Creator: String
 
@@ -7358,11 +7426,13 @@ module TencentCloud
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type RecipientId: String
         # @param RecipientFillStatus: 参与方填写状态
-        # 0-未填写
-        # 1-已填写
+        # <ul><li>0-未填写</li>
+        # <li>1-已填写</li></ul>
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type RecipientFillStatus: String
         # @param IsPromoter: 是否为发起方
+        # <ul><li>true-发起方</li>
+        # <li>false-参与方</li></ul>
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type IsPromoter: Boolean
         # @param Components: 填写控件列表
@@ -8383,16 +8453,22 @@ module TencentCloud
 
       # VerifyPdf请求参数结构体
       class VerifyPdfRequest < TencentCloud::Common::AbstractModel
-        # @param FlowId: 流程ID
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         # @type FlowId: String
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
-        attr_accessor :FlowId, :Operator
+        attr_accessor :FlowId, :Operator, :Agent
 
-        def initialize(flowid=nil, operator=nil)
+        def initialize(flowid=nil, operator=nil, agent=nil)
           @FlowId = flowid
           @Operator = operator
+          @Agent = agent
         end
 
         def deserialize(params)
@@ -8401,16 +8477,31 @@ module TencentCloud
             @Operator = UserInfo.new
             @Operator.deserialize(params['Operator'])
           end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
         end
       end
 
       # VerifyPdf返回参数结构体
       class VerifyPdfResponse < TencentCloud::Common::AbstractModel
-        # @param VerifyResult: 验签结果，1-文件未被篡改，全部签名在腾讯电子签完成； 2-文件未被篡改，部分签名在腾讯电子签完成；3-文件被篡改；4-异常：文件内没有签名域；5-异常：文件签名格式错误
+        # @param VerifyResult: 验签结果代码，代码的含义如下：
+
+        # <ul><li>**1**：文件未被篡改，全部签名在腾讯电子签完成。</li>
+        # <li>**2**：文件未被篡改，部分签名在腾讯电子签完成。</li>
+        # <li>**3**：文件被篡改。</li>
+        # <li>**4**：异常：文件内没有签名域。</li>
+        # <li>**5**：异常：文件签名格式错误。</li></ul>
         # @type VerifyResult: Integer
-        # @param PdfVerifyResults: 验签结果详情，每个签名域对应的验签结果。状态值：1-验签成功，在电子签签署；2-验签成功，在其他平台签署；3-验签失败；4-pdf文件没有签名域；5-文件签名格式错误
+        # @param PdfVerifyResults: 验签结果详情，每个签名域对应的验签结果。状态值如下
+        # <ul><li> **1** :验签成功，在电子签签署</li>
+        # <li> **2** :验签成功，在其他平台签署</li>
+        # <li> **3** :验签失败</li>
+        # <li> **4** :pdf文件没有签名域</li>
+        # <li> **5** :文件签名格式错误</li></ul>
         # @type PdfVerifyResults: Array
-        # @param VerifySerialNo: 验签序列号
+        # @param VerifySerialNo: 验签序列号, 为11为数组组成的字符串
         # @type VerifySerialNo: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.662
+  version: 3.0.664
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-19 00:00:00.000000000 Z
+date: 2023-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common