tencentcloud-sdk-ess 3.0.658 → 3.0.660

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d082f169231143a032c3fc356d0d7a645eb6f0a5
-  data.tar.gz: 323b167fd95e76dde617be89ca4eaa6d075f675d
+  metadata.gz: 9eed30651867f40a38aa3196b66dabb8e2515a2b
+  data.tar.gz: 961e2478e0a7529f550a907ed111e5f2b7427354
 SHA512:
-  metadata.gz: 7268ec91991184f29b9ffcaf9e4b072c32df22765ab3ee4eb390567a60b925946f736fb5e05d666471d28fb9cecc023988e728910c3aecf638c8429a16c32415
-  data.tar.gz: 1c09c28a79a3d8e7913ec1d8571c58c4022a1262685c6f92fe570d1d1070b7278ae467780ebea33852068d1a43137bcb3f36d19d0550615bae6fd5fc89142fa7
+  metadata.gz: 0823a3c206f92087891e07317f92aeb3640e3adfe01012b76028820f66b9b27b8a7ee554b469a32a1badeae7d724e6052ff01812321a0f1dfb934700904248ac
+  data.tar.gz: 2813e4efbb3c840c2fd89654bf4f9791cd1193fc47b82a6cf086da6b0e4ca93a71a9df3fcde8bcce7a6ae3e7b0f763ded7929aae21affee8a719989e15e7745b

data/lib/VERSION

@@ -1 +1 @@
-3.0.658
+3.0.660

data/lib/v20201111/client.rb

@@ -218,7 +218,14 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口（CreateEmbedWebUrl）用于创建嵌入web的链接 本接口支持创建：创建印章，创建模板，修改模板，预览模板，预览合同流程的web链接 进入web连接后与当前控制台操作保持一致
+        # 本接口（CreateEmbedWebUrl）用于创建嵌入Web的链接，支持以下类型的Web链接创建：
+        # 1. 创建印章
+        # 2. 创建模板
+        # 3. 修改模板
+        # 4. 预览模板
+        # 5. 预览合同流程
+
+        # 用户可以通过这些链接快速将其集成到自己的系统中。
 
         # @param request: Request instance for CreateEmbedWebUrl.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateEmbedWebUrlRequest`
@@ -271,12 +278,13 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # ### 适用场景
-        # 在通过模板或者文件发起合同时，若未指定企业签署人信息，则流程发起后，可以调用此接口补充或签签署人。
-        # 同一签署人可以补充多个员工作为或签签署人,最终实际签署人取决于谁先领取合同完成签署。
-        # ### 限制条件
-        # -  本企业(发起方企业)支持通过企业微信UserId 或者 姓名+手机号补充
-        # - 他方企业仅支持通过姓名+手机号补充
+        # 适用场景：
+        # 当通过模板或文件发起合同时，若未指定企业签署人信息，则可调用此接口补充或添加签署人。同一签署人可补充多个员工作为或签署人，最终实际签署人取决于谁先领取合同完成签署。
+
+        # 限制条件：
+        # 1. 本企业（发起方企业）企业微信签署人仅支持通过企业微信UserId或姓名+手机号进行补充。
+        # 2. 本企业（发起方企业）非企业微信签署人仅支持通过姓名+手机号进行补充。
+        # 3. 他方企业仅支持通过姓名+手机号进行补充。
 
         # @param request: Request instance for CreateFlowApprovers.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowApproversRequest`
@@ -327,9 +335,15 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建出证报告并返回报告ID。
-        # 使用此功能需搭配出证套餐。
-        # 注意：出证过程需一定时间，建议在调用创建出证后的24小时之后，通过DescribeFlowEvidenceReport接口进行查询。
+        # 提交申请出证报告任务并返回报告ID。
+
+        # 注意：
+        # <ul><li>使用此功能`需搭配出证套餐` ，使用前请联系对接的客户经理沟通。</li>
+        # <li>操作人必须是`发起方或者签署方企业的(非走授权书认证)法人或者超管`。</li>
+        # <li>合同流程必须所有参与方`已经签署完成`。</li>
+        # <li>出证过程需一定时间，建议在`提交出证任务后的24小时之后`，通过<a href="https://qian.tencent.com/developers/companyApis/certificate/DescribeFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。</li></ul>
+
+        # <svg id="SvgjsSvg1006" width="262" height="229" 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="SvgjsDefs1007"><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="SvgjsMarker1021" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1022" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker></defs><rect id="svgbackgroundid" width="262" height="229" fill="transparent"></rect><rect id="SvgjsRect1009" width="262" height="229" fill="url(#pattern_mark_0)"></rect><rect id="SvgjsRect1010" width="262" height="229" fill="url(#pattern_mark_1)"></rect><g id="SvgjsG1011" transform="translate(31.75,25)"><path id="SvgjsPath1012" d="M 0 0L 198 0L 198 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1013"><text id="SvgjsText1014" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="178px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1015" dy="16" x="99"><tspan id="SvgjsTspan1016" style="text-decoration:;fill: rgb(28, 30, 33);">CreateFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1017" dy="16" x="99"><tspan id="SvgjsTspan1018" style="text-decoration:;fill: rgb(51, 51, 51);">提交申请出证报告任务</tspan></tspan></text></g></g><g id="SvgjsG1019"><path id="SvgjsPath1020" d="M130.75 84.5L130.75 114.5L130.75 114.5L130.75 143.2" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1021)"></path></g><g id="SvgjsG1023" transform="translate(25,145)"><path id="SvgjsPath1024" d="M 0 0L 211.5 0L 211.5 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1025"><text id="SvgjsText1026" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="192px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1027" dy="16" x="106"><tspan id="SvgjsTspan1028" style="text-decoration:;fill: rgb(28, 30, 33);">DescribeFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1029" dy="16" x="106"><tspan id="SvgjsTspan1030" style="text-decoration:;fill: rgb(51, 51, 51);">获取出证报告任务执行结果</tspan></tspan></text></g></g></svg>
 
         # @param request: Request instance for CreateFlowEvidenceReport.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowEvidenceReportRequest`
@@ -353,9 +367,11 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 此接口（CreateFlowGroupByFiles）通过多文件创建合同组签署流程。<br/>
-        # PDF资源Id 通过上传文件接口获取
-        # 此接口合同组中的子合同必须都是文件发起的合同
+        # 此接口（CreateFlowGroupByFiles）可用于通过多个文件创建合同组签署流程。
+
+        # 适用场景：该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+
+        # 注意事项：使用该接口需要先依赖[多文件上传](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口返回的FileIds。
 
         # @param request: Request instance for CreateFlowGroupByFiles.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowGroupByFilesRequest`
@@ -379,8 +395,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 此接口（CreateFlowGroupByTemplates）通过多模板创建合同组签署流程。<br/>
-        # 此接口合同组中的子合同必须都是模板发起的合同。 <br/>目前最大仅支持50个子合同
+        # 此接口（CreateFlowGroupByTemplates）可用于通过多个模板创建合同组签署流程。
+
+        # 适用场景：该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
 
         # @param request: Request instance for CreateFlowGroupByTemplates.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowGroupByTemplatesRequest`
@@ -574,7 +591,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 绑定员工与对应角色
+        # 此接口用于赋予员工指定的角色权限，如需解绑请使用 DeleteIntegrationRoleUsers 接口。
 
         # @param request: Request instance for CreateIntegrationUserRoles.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateIntegrationUserRolesRequest`
@@ -635,7 +652,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 使用此接口，您可以创建企业批量签署链接，员工只需点击链接即可跳转至控制台进行批量签署。</br>
+        # 使用此接口，您可以创建企业批量签署链接，员工只需点击链接即可跳转至控制台进行批量签署。<br/>
         # 附注：
         # - 员工必须在企业下完成实名认证，且需作为批量签署合同的签署方。
         # - 如有UserId，应以UserId为主要标识；如果没有UserId，则必须填写Name和Mobile信息。
@@ -668,7 +685,11 @@ module TencentCloud
 
         # ![image](https://dyn.ess.tencent.cn/guide/capi/CreatePersonAuthCertificateImage.png)
 
-        # 注:  `只能获取个人用户证明图片, 企业员工的暂不支持`
+        # 注:
+        # <ul>
+        # <li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
+        # <li>处方单等特殊场景专用，此接口为白名单功能，使用前请联系对接的客户经理沟通。  </li>
+        # </ul>
 
         # @param request: Request instance for CreatePersonAuthCertificateImage.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreatePersonAuthCertificateImageRequest`
@@ -888,7 +909,8 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 用来创建页面主题配置
+        # 用来创建嵌入式页面个性化主题配置（例如是否展示电子签logo、定义主题色等），该接口配合其他所有可嵌入页面接口使用
+        # 创建配置对当前企业全局生效，如果多次调用，会以最后一次的配置为准
 
         # @param request: Request instance for CreateWebThemeConfig.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateWebThemeConfigRequest`
@@ -963,7 +985,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 解绑员工与对应角色关系
+        # 解绑员工与对应角色的关系，如需绑定请使用 CreateIntegrationUserRoles 接口。
 
         # @param request: Request instance for DeleteIntegrationRoleUsers.
         # @type request: :class:`Tencentcloud::ess::V20201111::DeleteIntegrationRoleUsersRequest`
@@ -1116,7 +1138,15 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查询签署报告，返回报告 URL。需调用创建并返回出证报告接口（CreateFlowEvidenceReport）获取报告编号后调用当前接口获取报告链接。
+        # 获取出证报告任务执行结果，返回报告 URL。
+
+
+
+        # 注意：
+        # <ul><li>使用此功能`需搭配出证套餐` ，使用前请联系对接的客户经理沟通。</li>
+        # <li>需调用创建并返回出证报告接口<a href="https://qian.tencent.com/developers/companyApis/certificate/CreateFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>获取报告编号后调用当前接口获取报告链接。</li></ul>
+
+        # <svg id="SvgjsSvg1006" width="262" height="229" 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="SvgjsDefs1007"><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="SvgjsMarker1021" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1022" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker></defs><rect id="svgbackgroundid" width="262" height="229" fill="transparent"></rect><rect id="SvgjsRect1009" width="262" height="229" fill="url(#pattern_mark_0)"></rect><rect id="SvgjsRect1010" width="262" height="229" fill="url(#pattern_mark_1)"></rect><g id="SvgjsG1011" transform="translate(31.75,25)"><path id="SvgjsPath1012" d="M 0 0L 198 0L 198 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1013"><text id="SvgjsText1014" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="178px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1015" dy="16" x="99"><tspan id="SvgjsTspan1016" style="text-decoration:;fill: rgb(28, 30, 33);">CreateFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1017" dy="16" x="99"><tspan id="SvgjsTspan1018" style="text-decoration:;fill: rgb(51, 51, 51);">提交申请出证报告任务</tspan></tspan></text></g></g><g id="SvgjsG1019"><path id="SvgjsPath1020" d="M130.75 84.5L130.75 114.5L130.75 114.5L130.75 143.2" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1021)"></path></g><g id="SvgjsG1023" transform="translate(25,145)"><path id="SvgjsPath1024" d="M 0 0L 211.5 0L 211.5 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1025"><text id="SvgjsText1026" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="192px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1027" dy="16" x="106"><tspan id="SvgjsTspan1028" style="text-decoration:;fill: rgb(28, 30, 33);">DescribeFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1029" dy="16" x="106"><tspan id="SvgjsTspan1030" style="text-decoration:;fill: rgb(51, 51, 51);">获取出证报告任务执行结果</tspan></tspan></text></g></g></svg>
 
         # @param request: Request instance for DescribeFlowEvidenceReport.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeFlowEvidenceReportRequest`
@@ -1249,33 +1279,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 集团企业统一使用主代子进行操作，无需根据子企业账号进行转化查询，该接口需要屏蔽下线
-
-        # 通过子企业影子账号查询主企业员工账号
-
-        # @param request: Request instance for DescribeIntegrationMainOrganizationUser.
-        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationMainOrganizationUserRequest`
-        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationMainOrganizationUserResponse`
-        def DescribeIntegrationMainOrganizationUser(request)
-          body = send_request('DescribeIntegrationMainOrganizationUser', request.serialize)
-          response = JSON.parse(body)
-          if response['Response'].key?('Error') == false
-            model = DescribeIntegrationMainOrganizationUserResponse.new
-            model.deserialize(response['Response'])
-            model
-          else
-            code = response['Response']['Error']['Code']
-            message = response['Response']['Error']['Message']
-            reqid = response['Response']['RequestId']
-            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
-          end
-        rescue TencentCloud::Common::TencentCloudSDKException => e
-          raise e
-        rescue StandardError => e
-          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
-        end
+        # 此接口（DescribeIntegrationRoles）用于分页查询企业角色列表，列表按照角色创建时间升序排列。
 
-        # 分页查询企业角色列表，法人的角色是系统保留角色，不会返回，按照角色创建时间升序排列
+        # 注：`法人角色是系统保留角色，因此返回列表中不含法人角色。`
 
         # @param request: Request instance for DescribeIntegrationRoles.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationRolesRequest`

data/lib/v20201111/models.rb

@@ -343,7 +343,7 @@ module TencentCloud
         # @param LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。
 
         # <ul><li>**0**: (默认) 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人`</li>
-        # <li>**1**: 不使用个人自动签账号许可进行开通</li></ul>
+        # </ul>
         # @type LicenseType: Integer
 
         attr_accessor :UserInfo, :CertInfoCallback, :UserDefineSeal, :SealImgCallback, :CallbackUrl, :VerifyChannels, :LicenseType
@@ -1245,21 +1245,21 @@ module TencentCloud
         # @param Operator: 执行本接口操作的员工信息。
         # <br/>注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param EmbedType: WEB嵌入资源类型。
-        # <br/>CREATE_SEAL: 生成创建印章的嵌入页面
-        # <br/>CREATE_TEMPLATE：生成创建模板的嵌入页面
-        # <br/>MODIFY_TEMPLATE：生成编辑模板的嵌入页面
-        # <br/>PREVIEW_TEMPLATE：生成预览模板的嵌入页面
-        # <br/>PREVIEW_SEAL_LIST：生成预览印章列表的嵌入页面
-        # <br/>PREVIEW_SEAL_DETAIL：生成预览印章详情的嵌入页面
-        # <br/>EXTEND_SERVICE：生成拓展服务的嵌入页面
-        # <br/>PREVIEW_FLOW：生成预览合同的嵌入页面
-        # <br/>PREVIEW_FLOW_DETAIL：生成查看合同详情的嵌入页面
+        # @param EmbedType: WEB嵌入资源类型，支持以下类型
+        # <ul><li>CREATE_SEAL: 生成创建印章的嵌入页面</li>
+        # <li>CREATE_TEMPLATE：生成创建模板的嵌入页面</li>
+        # <li>MODIFY_TEMPLATE：生成编辑模板的嵌入页面</li>
+        # <li>PREVIEW_TEMPLATE：生成预览模板的嵌入页面</li>
+        # <li>PREVIEW_SEAL_LIST：生成预览印章列表的嵌入页面</li>
+        # <li>PREVIEW_SEAL_DETAIL：生成预览印章详情的嵌入页面</li>
+        # <li>EXTEND_SERVICE：生成拓展服务的嵌入页面</li>
+        # <li>PREVIEW_FLOW：生成预览合同的嵌入页面</li>
+        # <li>PREVIEW_FLOW_DETAIL：生成查看合同详情的嵌入页面</li></ul>
         # @type EmbedType: String
         # @param BusinessId: WEB嵌入的业务资源ID
-        # <br/>PREVIEW_SEAL_DETAIL，必填，取值为印章id
-        # <br/>MODIFY_TEMPLATE，PREVIEW_TEMPLATE，必填，取值为模板id
-        # <br/>PREVIEW_FLOW，PREVIEW_FLOW_DETAIL，必填，取值为合同id
+        # <ul><li>PREVIEW_SEAL_DETAIL，必填，取值为印章id</li>
+        # <li>MODIFY_TEMPLATE，PREVIEW_TEMPLATE，必填，取值为模板id</li>
+        # <li>PREVIEW_FLOW，PREVIEW_FLOW_DETAIL，必填，取值为合同id</li><ul>
         # @type BusinessId: String
         # @param Agent: 代理企业和员工的信息。
         # <br/>在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
@@ -1325,16 +1325,23 @@ module TencentCloud
 
       # CreateFlowApprovers请求参数结构体
       class CreateFlowApproversRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowId: 签署流程编号
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+        # 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         # @type FlowId: String
-        # @param Approvers: 补充签署人信息
+        # @param Approvers: 补充企业签署人信息。
+
+        # - 如果发起方指定的补充签署人是企业微信签署人（ApproverSource=WEWORKAPP），则需要提供企业微信UserId进行补充；
+
+        # - 如果不指定，则使用姓名和手机号进行补充。
         # @type Approvers: Array
-        # @param Initiator: 企微消息中的发起人
+        # @param Initiator: 在可定制的企业微信通知中，发起人可以根据具体需求进行自定义设置。
         # @type Initiator: String
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作
-
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :FlowId, :Approvers, :Initiator, :Agent
@@ -1631,14 +1638,14 @@ module TencentCloud
 
       # CreateFlowEvidenceReport返回参数结构体
       class CreateFlowEvidenceReportResponse < TencentCloud::Common::AbstractModel
-        # @param ReportId: 出证报告 ID，可用于DescribeFlowEvidenceReport接口查询出证PDF的下载地址
+        # @param ReportId: 出证报告 ID，可用于<a href="https://qian.tencent.com/developers/companyApis/certificate/DescribeFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>查询出证任务结果和出证PDF的下载URL
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ReportId: String
-        # @param Status: 出证任务执行的状态, 可能会有以下状态：
+        # @param Status: 出证任务执行的状态, 状态含义如下：
 
-        # <ul><li>EvidenceStatusExecuting：  出证任务在执行中</li>
-        # <li>EvidenceStatusSuccess：  出证任务执行成功</li>
-        # <li>EvidenceStatusFailed ： 出征任务执行失败</li></ul>
+        # <ul><li>**EvidenceStatusExecuting**：  出证任务在执行中</li>
+        # <li>**EvidenceStatusSuccess**：  出证任务执行成功</li>
+        # <li>**EvidenceStatusFailed** ： 出征任务执行失败</li></ul>
         # @type Status: String
         # @param ReportUrl: 此字段已经废除,不再使用.
         # 出证的PDF下载地址请调用DescribeChannelFlowEvidenceReport接口获取
@@ -1669,15 +1676,22 @@ module TencentCloud
 
       # CreateFlowGroupByFiles请求参数结构体
       class CreateFlowGroupByFilesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId 代发合同
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowGroupName: 合同（流程）组名称,最大长度200个字符
+        # @param FlowGroupName: 合同（流程）组名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         # @type FlowGroupName: String
         # @param FlowGroupInfos: 合同（流程）组的子合同信息，支持2-50个子合同
         # @type FlowGroupInfos: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param FlowGroupOptions: 合同（流程）组的配置项信息。包括是否通知本企业签署方，是否通知其他签署方
+        # @param FlowGroupOptions: 合同（流程）组的配置项信息。
+        # 其中包括：
+        # <ul>
+        # <li>是否通知本企业签署方</li>
+        # <li>是否通知其他签署方</li>
+        # </ul>
         # @type FlowGroupOptions: :class:`Tencentcloud::Ess.v20201111.models.FlowGroupOptions`
 
         attr_accessor :Operator, :FlowGroupName, :FlowGroupInfos, :Agent, :FlowGroupOptions
@@ -1743,15 +1757,22 @@ module TencentCloud
 
       # CreateFlowGroupByTemplates请求参数结构体
       class CreateFlowGroupByTemplatesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId 代发合同
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowGroupName: 合同组名称,最大长度200个字符
+        # @param FlowGroupName: 合同（流程）组名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         # @type FlowGroupName: String
-        # @param FlowGroupInfos: 合同组的子合同信息，支持2-50个子合同
+        # @param FlowGroupInfos: 合同（流程）组的子合同信息，支持2-50个子合同
         # @type FlowGroupInfos: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param FlowGroupOptions: 合同组的配置信息。包括是否通知本企业签署方，是否通知其他签署方
+        # @param FlowGroupOptions: 合同（流程）组的配置项信息。
+        # 其中包括：
+        # <ul>
+        # <li>是否通知本企业签署方</li>
+        # <li>是否通知其他签署方</li>
+        # </ul>
         # @type FlowGroupOptions: :class:`Tencentcloud::Ess.v20201111.models.FlowGroupOptions`
 
         attr_accessor :Operator, :FlowGroupName, :FlowGroupInfos, :Agent, :FlowGroupOptions
@@ -2486,13 +2507,13 @@ module TencentCloud
 
       # CreateIntegrationUserRoles请求参数结构体
       class CreateIntegrationUserRolesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，UserId必填
+        # @param Operator: 执行本接口操作的员工信息。 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param UserIds: 绑定角色的用户id列表，不能重复，不能大于 100 个
         # @type UserIds: Array
-        # @param RoleIds: 绑定角色的角色id列表，不能重复，不能大于 100，可以通过DescribeIntegrationRoles接口获取
+        # @param RoleIds: 绑定角色的角色id列表，不能重复，不能大于 100，可以通过DescribeIntegrationRoles接口获取角色信息
         # @type RoleIds: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :UserIds, :RoleIds, :Agent
@@ -2672,22 +2693,24 @@ module TencentCloud
 
         # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowIds: 请指定需执行批量签署的流程ID，数量范围为1-100。</br>
-        # 您可登录腾讯电子签控制台，浏览 "合同"->"合同中心" 以查阅某一合同的FlowId（在页面中显示为合同ID）。</br>
+        # @param FlowIds: 请指定需执行批量签署的流程ID，数量范围为1-100。
+        # 您可登录腾讯电子签控制台，浏览 "合同"->"合同中心" 以查阅某一合同的FlowId（在页面中显示为合同ID）。
         # 用户将利用链接对这些合同实施批量操作。
         # @type FlowIds: Array
         # @param Agent: 代理企业和员工的信息。
         # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param UserId: 员工在腾讯电子签平台的独特身份标识，为32位字符串。</br>
-        # 您可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查阅某位员工的UserId（在页面中显示为用户ID）。</br>
+        # @param UserId: 员工在腾讯电子签平台的独特身份标识，为32位字符串。
+        # 您可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查阅某位员工的UserId（在页面中显示为用户ID）。
         # UserId必须是传入合同（FlowId）中的签署人。
         # - 1. 若UserId为空，Name和Mobile 必须提供。
         # - 2. 若UserId 与 Name，Mobile均存在，将优先采用UserId对应的员工。
         # @type UserId: String
-        # @param Name: 员工姓名，必须与手机号码一起使用。</br> 如果UserId为空，则此字段不能为空。同时，姓名和手机号码必须与传入合同（FlowId）中的签署人信息一致。
+        # @param Name: 员工姓名，必须与手机号码一起使用。
+        # 如果UserId为空，则此字段不能为空。同时，姓名和手机号码必须与传入合同（FlowId）中的签署人信息一致。
         # @type Name: String
-        # @param Mobile: 员工手机号，必须与姓名一起使用。</br> 如果UserId为空，则此字段不能为空。同时，姓名和手机号码必须与传入合同（FlowId）中的签署人信息一致。
+        # @param Mobile: 员工手机号，必须与姓名一起使用。
+        #  如果UserId为空，则此字段不能为空。同时，姓名和手机号码必须与传入合同（FlowId）中的签署人信息一致。
         # @type Mobile: String
 
         attr_accessor :Operator, :FlowIds, :Agent, :UserId, :Name, :Mobile
@@ -3582,7 +3605,7 @@ module TencentCloud
 
       # CreateUserAutoSignEnableUrl返回参数结构体
       class CreateUserAutoSignEnableUrlResponse < TencentCloud::Common::AbstractModel
-        # @param Url: 个人用户自动签的开通链接, 短链形式
+        # @param Url: 个人用户自动签的开通链接, 短链形式。过期时间受 `ExpiredTime` 参数控制。
         # @type Url: String
         # @param AppId: 腾讯电子签小程序的 AppID，用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
 
@@ -3632,15 +3655,16 @@ module TencentCloud
 
       # CreateWebThemeConfig请求参数结构体
       class CreateWebThemeConfigRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息
+        # @param Operator: 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param ThemeType: 主题类型
-        # <br/>EMBED_WEB_THEME：嵌入式主题
-        # <br/>目前只支持EMBED_WEB_THEME，web页面嵌入的主题风格配置
+        # @param ThemeType: 主题类型，取值如下：
+        # <ul><li> **EMBED_WEB_THEME**：嵌入式主题（默认），web页面嵌入的主题风格配置</li>
+        # </ul>
         # @type ThemeType: String
         # @param WebThemeConfig: 主题配置
         # @type WebThemeConfig: :class:`Tencentcloud::Ess.v20201111.models.WebThemeConfig`
-        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :ThemeType, :WebThemeConfig, :Agent
@@ -3799,13 +3823,13 @@ module TencentCloud
 
       # DeleteIntegrationRoleUsers请求参数结构体
       class DeleteIntegrationRoleUsersRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，userId必填
+        # @param Operator: 执行本接口操作的员工信息。 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param RoleId: 角色id
+        # @param RoleId: 角色id，可以通过DescribeIntegrationRoles接口获取角色信息
         # @type RoleId: String
         # @param Users: 用户信息,最多 200 个用户，并且 UserId 和 OpenId 二选一，其他字段不需要传
         # @type Users: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :RoleId, :Users, :Agent
@@ -4265,7 +4289,7 @@ module TencentCloud
         # @param Operator: 执行本接口操作的员工信息。
         # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param ReportId: 签署报告编号
+        # @param ReportId: 签署报告编号, 由<a href="https://qian.tencent.com/developers/companyApis/certificate/CreateFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>产生
         # @type ReportId: String
         # @param Agent: 代理企业和员工的信息。
         # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
@@ -4294,15 +4318,14 @@ module TencentCloud
 
       # DescribeFlowEvidenceReport返回参数结构体
       class DescribeFlowEvidenceReportResponse < TencentCloud::Common::AbstractModel
-        # @param ReportUrl: 出证报告PDF的下载 URL
+        # @param ReportUrl: 出证报告PDF的下载 URL，`有效期为5分钟`，超过有效期后将无法再下载。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ReportUrl: String
-        # @param Status: 签署报告出证任务的状态
-        # <ul>
-        # <li>EvidenceStatusExecuting : 出证任务在执行中</li>
-        # <li>EvidenceStatusSuccess : 出证任务执行成功</li>
-        # <li>EvidenceStatusFailed : 出证任务执行失败</li>
-        # </ul>
+        # @param Status: 出证任务执行的状态, 状态含义如下：
+
+        # <ul><li>**EvidenceStatusExecuting**：  出证任务在执行中</li>
+        # <li>**EvidenceStatusSuccess**：  出证任务执行成功</li>
+        # <li>**EvidenceStatusFailed** ： 出征任务执行失败</li></ul>
         # @type Status: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -4666,64 +4689,30 @@ module TencentCloud
         end
       end
 
-      # DescribeIntegrationMainOrganizationUser请求参数结构体
-      class DescribeIntegrationMainOrganizationUserRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，userId必填
-        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-
-        attr_accessor :Operator
-
-        def initialize(operator=nil)
-          @Operator = operator
-        end
-
-        def deserialize(params)
-          unless params['Operator'].nil?
-            @Operator = UserInfo.new
-            @Operator.deserialize(params['Operator'])
-          end
-        end
-      end
-
-      # DescribeIntegrationMainOrganizationUser返回参数结构体
-      class DescribeIntegrationMainOrganizationUserResponse < TencentCloud::Common::AbstractModel
-        # @param IntegrationMainOrganizationUser: 主企业员工账号信息
-        # 注意：此字段可能返回 null，表示取不到有效值。
-        # @type IntegrationMainOrganizationUser: :class:`Tencentcloud::Ess.v20201111.models.IntegrationMainOrganizationUser`
-        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
-        # @type RequestId: String
-
-        attr_accessor :IntegrationMainOrganizationUser, :RequestId
-
-        def initialize(integrationmainorganizationuser=nil, requestid=nil)
-          @IntegrationMainOrganizationUser = integrationmainorganizationuser
-          @RequestId = requestid
-        end
-
-        def deserialize(params)
-          unless params['IntegrationMainOrganizationUser'].nil?
-            @IntegrationMainOrganizationUser = IntegrationMainOrganizationUser.new
-            @IntegrationMainOrganizationUser.deserialize(params['IntegrationMainOrganizationUser'])
-          end
-          @RequestId = params['RequestId']
-        end
-      end
-
       # DescribeIntegrationRoles请求参数结构体
       class DescribeIntegrationRolesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，UserId必填
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Limit: 指定每页多少条数据，单页最大200
+        # @param Limit: 指定分页每页返回的数据条数，单页最大支持 200。
         # @type Limit: Integer
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param Filters: 查询的关键字段:
-        # Key:"RoleType",Values:["1"]查询系统角色，Values:["2"]查询自定义角色
-        # Key:"RoleStatus",Values:["1"]查询启用角色，Values:["2"]查询禁用角色
-        # Key:"IsGroupRole"，Values:["0"]:查询非集团角色，Values:["1"]表示查询集团角色
-        # Key:"IsReturnPermissionGroup"，Values:["0"]:表示接口不返回角色对应的权限树字段，Values:["1"]表示接口返回角色对应的权限树字段
+        # @param Filters: 查询的关键字段，支持Key-Value单值查询。可选键值对如下：
+        # <ul>
+        #   <li>Key:"RoleType"，查询角色类型，Values可选：
+        #     <ul><li>**"1"**：查询系统角色</li><li>**"2"**：查询自定义角色</li></ul>
+        #   </li><li>Key:"RoleStatus"，查询角色状态，Values可选：
+        #     <ul><li>**"1"**：查询启用角色</li><li>**"2"**：查询禁用角色</li></ul>
+        #   </li><li>Key:"IsGroupRole"，是否查询集团角色，Values可选：
+        #     <ul><li>**"0"**：查询非集团角色</li><li>**"1"**：查询集团角色</li></ul>
+        #   </li><li>Key:"IsReturnPermissionGroup"，是否返回角色对应权限树，Values可选：
+        #     <ul><li>**"0"**：接口不返回角色对应的权限树字段</li><li>**"1"**：接口返回角色对应的权限树字段</li></ul>
+        #   </li>
+        # </ul>
         # @type Filters: Array
-        # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大2000
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页。页码从 0 开始，即首页为 0，最大2000。
         # @type Offset: Integer
 
         attr_accessor :Operator, :Limit, :Agent, :Filters, :Offset
@@ -4760,13 +4749,13 @@ module TencentCloud
 
       # DescribeIntegrationRoles返回参数结构体
       class DescribeIntegrationRolesResponse < TencentCloud::Common::AbstractModel
-        # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大2000
+        # @param Offset: 指定分页返回的页码。页码从0开始，最大为2000。
         # @type Offset: Integer
-        # @param Limit: 指定每页多少条数据，单页最大200
+        # @param Limit: 指定分页每页返回的数据条数，单页最大支持 200。
         # @type Limit: Integer
-        # @param TotalCount: 符合查询条件的总的角色数
+        # @param TotalCount: 符合查询条件的总角色数。
         # @type TotalCount: Integer
-        # @param IntegrateRoles: 企业角色信息列表
+        # @param IntegrateRoles: 企业角色信息列表。
         # @type IntegrateRoles: Array
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -5103,8 +5092,7 @@ module TencentCloud
         # @type LicenseTo: Integer
         # @param LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。
 
-        # <ul><li>**0**: 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人`</li>
-        # <li>**1**: 不使用个人自动签账号许可进行开通</li></ul>
+        # <ul><li>**0**: 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人`</li></ul>
         # @type LicenseType: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -5422,21 +5410,24 @@ module TencentCloud
 
       # 补充签署人信息
       # - RecipientId 必须指定
-      # -  通过企业自定义账号ID补充签署人时，ApproverSource 和 CustomUserId 必填，ApproverSource取值：WEWORKAPP
+      # -  通过企业微信自定义账号ID补充签署人时，ApproverSource 和 CustomUserId 必填，ApproverSource取值：WEWORKAPP
       # - 通过二要素（姓名/手机号）补充签署人时，ApproverName 和 ApproverMobile 必填，ApproverSource设置为空
       class FillApproverInfo < TencentCloud::Common::AbstractModel
-        # @param RecipientId: 对应模板中的参与方ID
+        # @param RecipientId: 签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。
+        # 模板发起合同时，该参数为必填项。
+        # 文件发起合同是，该参数无需传值。
+        # 如果开发者后序用合同模板发起合同，建议保存此值，在用合同模板发起合同中需此值绑定对应的签署经办人 。
         # @type RecipientId: String
         # @param ApproverSource: 签署人来源
         # WEWORKAPP: 企业微信
         # <br/>仅【企微或签】时指定WEWORKAPP
         # @type ApproverSource: String
-        # @param CustomUserId: 企业自定义账号ID
-        # <br/>当ApproverSource为WEWORKAPP的企微或签场景下，必须指企业自有应用获取企微明文的userid
+        # @param CustomUserId: 企业微信UserId
+        # <br/>当ApproverSource为WEWORKAPP的企微或签场景下，必须指企业自有应用获取企业微信的UserId
         # @type CustomUserId: String
-        # @param ApproverName: 补充签署人姓名
+        # @param ApproverName: 补充企业签署人员工姓名
         # @type ApproverName: String
-        # @param ApproverMobile: 补充签署人手机号
+        # @param ApproverMobile: 补充企业签署人员工手机号
         # @type ApproverMobile: String
 
         attr_accessor :RecipientId, :ApproverSource, :CustomUserId, :ApproverName, :ApproverMobile
@@ -5754,9 +5745,10 @@ module TencentCloud
         # <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
         # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         # @type ApproverIdCardNumber: String
-        # @param RecipientId: 签署方经办人在模板中的参与方ID
-        # <br/>模板发起合同时，该参数为必填项
-        # <br/>文件发起合同是，该参数无序传值
+        # @param RecipientId: 签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。
+        # 模板发起合同时，该参数为必填项。
+        # 文件发起合同是，该参数无需传值。
+        # 如果开发者后续用合同模板发起合同，建议保存此值，在用合同模板发起合同中需此值绑定对应的签署经办人 。
         # @type RecipientId: String
         # @param VerifyChannel: 签署意愿确认渠道，默认为WEIXINAPP:人脸识别
 
@@ -6021,34 +6013,63 @@ module TencentCloud
 
       # 此结构体(FlowGroupInfo)描述的是合同组(流程组)的单个合同(流程)信息
       class FlowGroupInfo < TencentCloud::Common::AbstractModel
-        # @param FlowName: 合同（流程）的名称
+        # @param FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
+        # 该名称还将用于合同签署完成后的下载文件名。
         # @type FlowName: String
-        # @param Approvers: 合同（流程）的签署方信息
+        # @param Approvers: 签署流程参与者信息，最大限制50方
+        # 注意 approver中的顺序需要和模板中的顺序保持一致， 否则会导致模板中配置的信息无效。
         # @type Approvers: Array
-        # @param FileIds: 发起合同（流程）的资源Id,此资源必须是PDF文件,来自UploadFiles,使用文件发起合同(流程)组时必传
+        # @param FileIds: 文件资源ID，通过多文件上传[UploadFiles](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口获得，为32位字符串。
+        # 建议开发者保存此资源ID，后续创建合同或创建合同流程需此资源ID。
         # @type FileIds: Array
-        # @param TemplateId: 发起合同（流程）的模板Id,用模板发起合同（流程）组时必填
+        # @param TemplateId: 合同模板ID，为32位字符串。
+        # 建议开发者保存此模板ID，后续用此模板发起合同流程需要此参数。
+        # 可登录腾讯电子签控制台，在 "模板"->"模板中心"->"列表展示设置"选中模板 ID 中查看某个模板的TemplateId(在页面中展示为模板ID)。
         # @type TemplateId: String
-        # @param FlowType: 合同（流程）的类型
+        # @param FlowType: 签署流程的类型(如销售合同/入职合同等)，最大长度200个字符
+        # 示例值：劳务合同
         # @type FlowType: String
-        # @param FlowDescription: 合同（流程）的描述
+        # @param FlowDescription: 签署流程描述,最大长度1000个字符
         # @type FlowDescription: String
-        # @param Deadline: 合同（流程）的截止时间戳，单位秒。默认是一年
+        # @param Deadline: 签署流程的签署截止时间。
+
+        # 值为unix时间戳,精确到秒,不传默认为当前时间一年后
+        # 示例值：1604912664
         # @type Deadline: Integer
         # @param CallbackUrl: 合同（流程）的回调地址
         # @type CallbackUrl: String
-        # @param UserData: 第三方平台传递过来的信息, 限制1024字符 格式必须是base64的
+        # @param UserData: 调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。
+        # 在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。
+        # 回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
         # @type UserData: String
-        # @param Unordered: 合同（流程）的签署是否是无序签, true - 无序。 false - 有序, 默认
+        # @param Unordered: 发送类型：
+        # true：无序签
+        # false：有序签
+        # 注：默认为false（有序签），请和模板中的配置保持一致
+        # 示例值：true
         # @type Unordered: Boolean
-        # @param Components: 合同（流程）发起方的填写控件, 由发起方进行在发起时进行填充
+        # @param Components: 模板或者合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体
+        # <ul><li>单行文本控件</li>
+        # <li>多行文本控件</li>
+        # <li>勾选框控件</li>
+        # <li>数字控件</li>
+        # <li>图片控件</li>
+        # <li>动态表格等填写控件</li></ul>
         # @type Components: Array
-        # @param NeedSignReview: 本企业（发起方）是否需要签署审批，若需要审批则只允许查看不允许签署，需要您调用接口CreateFlowSignReview提交审批结果。
+        # @param NeedSignReview: 发起方企业的签署人进行签署操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。
+        # 若设置为true，审核结果需通过接口 [CreateFlowSignReview](https://qian.tencent.com/developers/companyApis/operateFlows/CreateFlowSignReview) 通知电子签，审核通过后，发起方企业签署人方可进行签署操作，否则会阻塞其签署操作。
+
+        # 注：企业可以通过此功能与企业内部的审批流程进行关联，支持手动、静默签署合同。
+        # 示例值：true
         # @type NeedSignReview: Boolean
-        # @param AutoSignScene: 本企业（发起方）自动签署，需要您在发起合同时给印章控件指定自动签的印章。
+        # @param AutoSignScene: 个人自动签场景。发起自动签署时，需设置对应自动签署场景，目前仅支持场景：处方单-E_PRESCRIPTION_AUTO_SIGN
+        # 示例值：E_PRESCRIPTION_AUTO_SIGN
         # @type AutoSignScene: String
 
         attr_accessor :FlowName, :Approvers, :FileIds, :TemplateId, :FlowType, :FlowDescription, :Deadline, :CallbackUrl, :UserData, :Unordered, :Components, :NeedSignReview, :AutoSignScene
+        extend Gem::Deprecate
+        deprecate :CallbackUrl, :none, 2023, 9
+        deprecate :CallbackUrl=, :none, 2023, 9
 
         def initialize(flowname=nil, approvers=nil, fileids=nil, templateid=nil, flowtype=nil, flowdescription=nil, deadline=nil, callbackurl=nil, userdata=nil, unordered=nil, components=nil, needsignreview=nil, autosignscene=nil)
           @FlowName = flowname
@@ -6099,16 +6120,18 @@ module TencentCloud
 
       # 此结构体(FlowGroupOptions)描述的是合同组的个性化配置，支持控制是否发送短信、未实名个人签署方查看合同组时是否需要实名认证（仅在合同组文件发起配置时生效）
       class FlowGroupOptions < TencentCloud::Common::AbstractModel
-        # @param ApproverVerifyType: 发起合同（流程）组的合同（流程）签署人校验方式
-        # VerifyCheck: 人脸识别（默认）
-        # MobileCheck：手机号验证
+        # @param ApproverVerifyType: 签署人校验方式,支持以下类型
+        # <ul><li>VerifyCheck : 人脸识别 (默认值)</li>
+        # <li>MobileCheck : 手机号验证</li></ul>
         # 参数说明：此参数仅在合同组文件发起有效，可选人脸识别或手机号验证两种方式，若选择后者，未实名个人签署方在签署合同时，无需经过实名认证和意愿确认两次人脸识别，该能力仅适用于个人签署方。
         # @type ApproverVerifyType: String
         # @param SelfOrganizationApproverNotifyType: 发起合同（流程）组本方企业经办人通知方式
-        # 签署通知类型：sms--短信，none--不通知
+        # 签署通知类型，支持以下类型
+        # <ul><li>sms : 短信 (默认值)</li><li>none : 不通知</li></ul>
         # @type SelfOrganizationApproverNotifyType: String
         # @param OtherApproverNotifyType: 发起合同（流程）组他方经办人通知方式
-        # 签署通知类型：sms--短信，none--不通知
+        # 签署通知类型，支持以下类型
+        # <ul><li>sms : 短信 (默认值)</li><li>none : 不通知</li></ul>
         # @type OtherApproverNotifyType: String
 
         attr_accessor :ApproverVerifyType, :SelfOrganizationApproverNotifyType, :OtherApproverNotifyType
@@ -6599,33 +6622,6 @@ module TencentCloud
         end
       end
 
-      # 主企业员工账号信息
-      class IntegrationMainOrganizationUser < TencentCloud::Common::AbstractModel
-        # @param MainOrganizationId: 主企业id
-        # 注意：此字段可能返回 null，表示取不到有效值。
-        # @type MainOrganizationId: String
-        # @param MainUserId: 主企业员工UserId
-        # 注意：此字段可能返回 null，表示取不到有效值。
-        # @type MainUserId: String
-        # @param UserName: 主企业员工名
-        # 注意：此字段可能返回 null，表示取不到有效值。
-        # @type UserName: String
-
-        attr_accessor :MainOrganizationId, :MainUserId, :UserName
-
-        def initialize(mainorganizationid=nil, mainuserid=nil, username=nil)
-          @MainOrganizationId = mainorganizationid
-          @MainUserId = mainuserid
-          @UserName = username
-        end
-
-        def deserialize(params)
-          @MainOrganizationId = params['MainOrganizationId']
-          @MainUserId = params['MainUserId']
-          @UserName = params['UserName']
-        end
-      end
-
       # ModifyApplicationCallbackInfo请求参数结构体
       class ModifyApplicationCallbackInfoRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。
@@ -8262,13 +8258,12 @@ module TencentCloud
       # 页面主题配置
       class WebThemeConfig < TencentCloud::Common::AbstractModel
         # @param DisplaySignBrandLogo: 是否显示页面底部电子签logo，取值如下：
-        # <ul>
-        # <li> **true**：页面底部显示电子签logo</li>
-        # <li> **false**：页面底部不显示电子签logo（默认）</li>
-        # </ul>
+        # <ul><li> **true**：页面底部显示电子签logo</li>
+        # <li> **false**：页面底部不显示电子签logo（默认）</li></ul>
         # @type DisplaySignBrandLogo: Boolean
-        # @param WebEmbedThemeColor: 主题颜色
-        # <br/>支持十六进制颜色值以及RGB格式颜色值，例如：#D54941，rgb(213, 73, 65)
+        # @param WebEmbedThemeColor: 主题颜色：
+        # 支持十六进制颜色值以及RGB格式颜色值，例如：#D54941，rgb(213, 73, 65)
+        # <br/>
         # @type WebEmbedThemeColor: String
 
         attr_accessor :DisplaySignBrandLogo, :WebEmbedThemeColor

metadata

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