tencentcloud-sdk-essbasic 3.0.931 → 3.0.933

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d31ee36bfd7c132f96c55583549de59cb8749726
-  data.tar.gz: 5689e5248f5bc07020382bb6c5cc67d093c4f476
+  metadata.gz: f661b7f8c4b35ee9f453652909cd34e4a1252029
+  data.tar.gz: 141811ab3d492e63edbfacdf6fb8cb9cf5d0d766
 SHA512:
-  metadata.gz: 1eb4fb0c58550ac1f48900555d8b2674c81d158eedbca89507dd5713b3a9dd6dc093bc24325f4d51d1ab03fe1393b164e44e3c2798b0fc7571a9c6b4a0bd4949
-  data.tar.gz: da9d5b1604d2d8140d9827fd6cd4abbd6a755108f2bedd37157c9e3721dfad14bfd7cc2c98941d74130d1dfa04e81865c202715d03f473531b56e2c395348245
+  metadata.gz: 3bceed185b2a367d6d5316fb02179d19847cc1e829af5bdf9217ecff4d25cbd657571a90e728daaa384ff0bb72ca3b2a5d8e7ea996d484585022e7ec71d21efe
+  data.tar.gz: 7982570bd4f099d82356bce2a927d13d876e789dec6326b119be9d20177a6b1b66e5893ee1b989fd21d9e7c03a6b212bd3e91d4dbaf2743b6f90bb757b9aa5fb

data/lib/VERSION

@@ -1 +1 @@
-3.0.931
+3.0.933

data/lib/v20210526/client.rb

@@ -363,10 +363,25 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 适用场景：
+        # **适用场景**：
         # 当通过模板或文件发起合同时，若未指定企业签署人信息，则可调用此接口动态补充签署人。同一签署人只允许补充一人，最终实际签署人取决于谁先领取合同完成签署。
 
-        # 限制条件：
+        # **接口使用说明**：
+
+        # 1.本接口现已支持批量补充签署人
+
+        # 2.当<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中指定需要补充的FlowId时，可以对指定合同补充签署人；可以指定多个相同发起方的不同合同在完成批量补充
+
+        # 3.当<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中指定需要补充的FlowId时，是对指定的合同补充多个指定的签署人
+
+        # 4.如果同时指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId，仅使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId作为补充的合同
+
+        # 5.如果部分指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId，又指定了<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId；那么<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>存在指定的FlowId，则使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId，不存在则使用<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId作为补充的合同
+
+
+        # 6.如果同时未指定了<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId和<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口入参</a>中的FlowId，则传参错误
+
+        # **限制条件**：
         # 1. 本企业（发起方企业）企业签署人仅支持通过企业名称+姓名+手机号进行补充。
         # 2. 个人签署人支持通过姓名+手机号进行补充，补充动态签署人时：若个人用户已完成实名，则可通过姓名+证件号码进行补充。
 
@@ -445,19 +460,21 @@ module TencentCloud
 
         # 接口（ChannelCreateFlowGroupByFiles）用于使用 PDF 文件创建合同组签署流程。
 
-        # 合同组是将多个合同签署流程组织在一起，多个合同同时创建，每个签署方得到一个签署链接，`一次完成合同组中多个合同的签署`。合同组的合同`不能拆分一个一个签署`，只能作为一个整体签署。
+        # - 该接口允许通过选择多个模板一次性创建多个合同，这些合同被组织在一个合同组中。
+        # - 每个签署方将收到一个签署链接，通过这个链接可以访问并签署合同组中的所有合同。
+        # - 合同组中的合同必须作为一个整体进行签署，不能将合同组拆分成单独的合同进行逐一签署。
 
-        # 适用场景：该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+        # <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png"   width="400" />
 
 
 
-        # **注**:
-        # <ul>
-        # <li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
-        # <li>合同组暂不支持抄送功能</li>
-        # <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号（FileIds）进行使用。</li>
-        # </ul>
+        # ### 1. 适用场景
 
+        # 该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+
+        # ### 2. 发起方要求和签署方实名要求
+        # - **发起方要求**：作为合同发起方的第三方子企业A的员工必须进行实名认证。
+        # - **签署方要求**：签署方可以是多种身份（如第三方子企业的员工、个人、SaaS平台企业员工），其中企业和员工可以不进行实名认证。
         # **可以作为发起方和签署方的角色列表**
         # <table>
         # <thead>
@@ -478,37 +495,35 @@ module TencentCloud
         # <tr>
         # <td>场景二</td>
         # <td>第三方子企业A员工</td>
-        # <td>第三方子企业B(不指定经办人)</td>
-        # </tr>
-
-        # <tr>
-        # <td>场景三</td>
-        # <td>第三方子企业A员工</td>
         # <td>第三方子企业B员工</td>
         # </tr>
 
         # <tr>
-        # <td>场景四</td>
+        # <td>场景三</td>
         # <td>第三方子企业A员工</td>
         # <td>个人/自然人</td>
         # </tr>
 
         # <tr>
-        # <td>场景五</td>
+        # <td>场景四</td>
         # <td>第三方子企业A员工</td>
         # <td>SaaS平台企业员工</td>
         # </tr>
         # </tbody>
         # </table>
 
-        # **注**:
-        # `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+        # ### 3. 签署方参数差异
+        # - 根据签署方的不同类型（第三方子企业的员工、个人、SaaS平台企业员工），传递的参数也不同。具体参数的结构和要求可以参考开发者中心提供的 `FlowApproverInfo` 结构体说明。
 
-        # `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
+        # ### 4. 合同额度的扣减与返还
+        # - **扣减时机**：合同一旦发起，相关的合同额度就会被扣减，合同组下面的每个合同都要扣减一个合同额度。
+        # - **返还条件**：只有在合同被撤销且没有任何签署方签署过，或者只有自动签署的情况下，合同额度才会被返还。
+        # - **不返还的情况**：如果合同已过期、被拒签、签署完成或已解除，合同额度将不会被返还。
 
-        # `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
+        # ### 5. 静默（自动）签署的限制
+        # - 在使用静默（自动）签署功能时，合同签署方不能有填写控件。<font color="red">此接口静默签(企业自动签)能力为白名单功能</font>，使用前请联系对接的客户经理沟通。
 
-        # `4. 静默（自动）签署不支持合同签署方存在填写功能`
+        # ### 6.合同组暂不支持抄送功能
 
         # @param request: Request instance for ChannelCreateFlowGroupByFiles.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowGroupByFilesRequest`
@@ -534,16 +549,21 @@ module TencentCloud
 
         # 接口（ChannelCreateFlowGroupByTemplates）用于通过多模板创建合同组签署流程。
 
-        # 合同组是将多个合同签署流程组织在一起，多个合同同时创建，每个签署方得到一个签署链接，`一次完成合同组中多个合同的签署`。合同组的合同`不能拆分一个一个签署`，只能作为一个整体签署。
+        # - 该接口允许通过选择多个模板一次性创建多个合同，这些合同被组织在一个合同组中。
+        # - 每个签署方将收到一个签署链接，通过这个链接可以访问并签署合同组中的所有合同。
+        # - 合同组中的合同必须作为一个整体进行签署，不能将合同组拆分成单独的合同进行逐一签署。
 
-        # 适用场景：该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+        # <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png"   width="400" />
 
-        # **注**:
-        # <ul>
-        # <li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
-        # <li>合同组暂不支持抄送功能</li>
-        # </ul>
 
+
+        # ### 1. 适用场景
+
+        # 该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+
+        # ### 2. 发起方要求和签署方实名要求
+        # - **发起方要求**：作为合同发起方的第三方子企业A的员工必须进行实名认证。
+        # - **签署方要求**：签署方可以是多种身份（如第三方子企业的员工、个人、SaaS平台企业员工），其中企业和员工可以不进行实名认证。
         # **可以作为发起方和签署方的角色列表**
         # <table>
         # <thead>
@@ -560,41 +580,38 @@ module TencentCloud
         # <td>第三方子企业A员工</td>
         # <td>第三方子企业A员工</td>
         # </tr>
-
         # <tr>
         # <td>场景二</td>
         # <td>第三方子企业A员工</td>
-        # <td>第三方子企业B(不指定经办人)</td>
-        # </tr>
-
-        # <tr>
-        # <td>场景三</td>
-        # <td>第三方子企业A员工</td>
         # <td>第三方子企业B员工</td>
         # </tr>
 
         # <tr>
-        # <td>场景四</td>
+        # <td>场景三</td>
         # <td>第三方子企业A员工</td>
         # <td>个人/自然人</td>
         # </tr>
 
         # <tr>
-        # <td>场景五</td>
+        # <td>场景四</td>
         # <td>第三方子企业A员工</td>
         # <td>SaaS平台企业员工</td>
         # </tr>
         # </tbody>
         # </table>
 
-        # **注**:
-        # `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+        # ### 3. 签署方参数差异
+        # - 根据签署方的不同类型（第三方子企业的员工、个人、SaaS平台企业员工），传递的参数也不同。具体参数的结构和要求可以参考开发者中心提供的 `FlowApproverInfo` 结构体说明。
 
-        # `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
+        # ### 4. 合同额度的扣减与返还
+        # - **扣减时机**：合同一旦发起，相关的合同额度就会被扣减，合同组下面的每个合同都要扣减一个合同额度。
+        # - **返还条件**：只有在合同被撤销且没有任何签署方签署过，或者只有自动签署的情况下，合同额度才会被返还。
+        # - **不返还的情况**：如果合同已过期、被拒签、签署完成或已解除，合同额度将不会被返还。
 
-        # `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
+        # ### 5. 静默（自动）签署的限制
+        # - 在使用静默（自动）签署功能时，合同签署方不能有填写控件。<font color="red">此接口静默签(企业自动签)能力为白名单功能</font>，使用前请联系对接的客户经理沟通。
 
-        # `4. 静默（自动）签署不支持合同签署方存在填写功能`
+        # ### 6.合同组暂不支持抄送功能
 
         # @param request: Request instance for ChannelCreateFlowGroupByTemplates.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowGroupByTemplatesRequest`
@@ -901,7 +918,7 @@ module TencentCloud
         end
 
         # 发起解除协议的主要应用场景为：基于一份已经签署的合同(签署流程)，进行解除操作。
-        # 解除协议的模板是官方提供，经过提供法务审核，暂不支持自定义。
+        # 解除协议的模板是官方提供，经过提供法务审核，暂不支持自定义。具体用法可以参考文档[合同解除](https://qian.tencent.com/developers/partner/flow_release)。
 
         # 注意：
         # <ul><li><code>原合同必须签署完</code>成后才能发起解除协议。</li>
@@ -1445,9 +1462,10 @@ module TencentCloud
         # 此接口（ChannelGetTaskResultApi）用来查询转换任务的状态。如需发起转换任务，请使用<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行资源文件的转换操作<br />
         # 前提条件：已调用 <a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换，并得到了返回的转换任务Id。<br />
 
-        # 适用场景：已创建一个文件转换任务，想查询该文件转换任务的状态，或获取转换后的文件资源Id。<br />
+        # 适用场景：已创建一个文件转换任务，想查询该文件转换任务的状态，或获取转换后的文件资源ID。<br />
         # 注：
-        # 1. `大文件转换所需的时间可能会比较长`
+        # 1. `大文件转换所需的时间可能会比较长。`
+        # 2. `本接口返回的文件资源ID就是PDF资源ID，可以直接用于【用PDF文件创建签署流程】接口发起合同。`
 
         # @param request: Request instance for ChannelGetTaskResultApi.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelGetTaskResultApiRequest`
@@ -1793,6 +1811,34 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 创建企业注销链接
+
+        # 系统将返回操作链接。贵方需要主动联系并通知企业的超级管理员（超管）或法人。由他们点击该链接，完成企业的注销操作。
+
+        # 注意： `在调用此接口以管理企业扩展服务时，操作者（ Agent.ProxyOperator.OpenId）必须是企业的超级管理员（超管）或法人。`
+
+        # @param request: Request instance for CreateCloseOrganizationUrl.
+        # @type request: :class:`Tencentcloud::essbasic::V20210526::CreateCloseOrganizationUrlRequest`
+        # @rtype: :class:`Tencentcloud::essbasic::V20210526::CreateCloseOrganizationUrlResponse`
+        def CreateCloseOrganizationUrl(request)
+          body = send_request('CreateCloseOrganizationUrl', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateCloseOrganizationUrlResponse.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
+
         # 此接口（CreateConsoleLoginUrl）用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。
 
         # Web链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态，进入不同的流程，主要情况分类如下：
@@ -2208,6 +2254,36 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 批量清理未认证的企业认证流程。
+
+        # 此接口用来清除企业方认证信息填写错误，批量清理认证中的认证流信息。
+        # 为接口[提交子企业批量认证链接创建任务](https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks) 和[查询子企业批量认证链接](https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls) 接口的扩展接口。即在批量认证过程中，当发起认证企业发现超管信息错误的时候，可以将当前超管下的所有认证流企业清除。
+
+        # 注意：
+        # **这个接口的操作人必须跟生成批量认证链接接口的应用号一致，才可以调用，否则会返回当前操作人没有认证中的企业认证流**
+
+        # @param request: Request instance for DeleteOrganizationAuthorizations.
+        # @type request: :class:`Tencentcloud::essbasic::V20210526::DeleteOrganizationAuthorizationsRequest`
+        # @rtype: :class:`Tencentcloud::essbasic::V20210526::DeleteOrganizationAuthorizationsResponse`
+        def DeleteOrganizationAuthorizations(request)
+          body = send_request('DeleteOrganizationAuthorizations', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DeleteOrganizationAuthorizationsResponse.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
+
         # 此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID，然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
         # ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
 
@@ -2440,10 +2516,19 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 获取合同流程PDF的下载链接，可以下载签署中、签署完的此子企业创建的合同
+        # 获取合同流程PDF的下载链接，可以下载签署中、签署完的此子企业创建的合同。
+
+
 
-        # **注意**:
-        # 有两种开通权限的途径
+
+        # ### 1. 确保合同的PDF已经合成后，再调用本接口。
+        #  用户创建合同或者提交签署动作后，后台需要1~3秒的时间就进行合同PDF合成或者签名，为了确保您下载的是签署完成的完整合同文件，我们建议采取下面两种方式的一种来<font color="red"><b>确保PDF已经合成完成，然后在调用本接口</b></font>。
+
+        # **第一种**：请确保您的系统配置了[接收合同完成通知的回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign)功能。一旦所有参与方签署完毕，我们的系统将自动向您提供的回调地址发送完成通知。
+
+        # **第二种**：通过调用我们的[获取合同信息](https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo)接口来主动检查合同的签署状态。请仅在确认合同状态为“全部签署完成”后，进行文件的下载操作。
+
+        # ### 2. 有两种开通下载权限的途径。
 
         # **第一种**:   需第三方应用的子企业登录控制台进行授权,  授权在**企业中心**的**授权管理**区域,  界面如下图。
         # 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
@@ -2453,6 +2538,7 @@ module TencentCloud
         # **第二种**: 渠道方企业在**企业应用管理**的配置界面打开需要配置的应用，点击**应用扩展服务**开通此功能，需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
         # 注:
         # 1. `请注意如果第三方应用的子客主动关闭了渠道端下载渠道子客合同功能开关，那么渠道方开通了此功能也无法下载子客的合同文件`
+
         # ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
 
         # @param request: Request instance for DescribeResourceUrlsByFlows.
@@ -2596,7 +2682,6 @@ module TencentCloud
         # - **需要法人或者超管签署开通协议的情形：** 当需要开通以下企业拓展服务时， 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员（超管）或法人。由他们点击该链接，完成服务的开通操作。
         #   - **AUTO_SIGN（企业自动签）**
         #   - **DOWNLOAD_FLOW（授权渠道下载合同）**
-        #   - **OVERSEA_SIGN（企业与港澳台居民签署合同）**
 
         # 注意： `在调用此接口以管理企业扩展服务时，操作者（ Agent.ProxyOperator.OpenId）必须是企业的超级管理员（超管）或法人`
 

data/lib/v20210526/models.rb

@@ -129,7 +129,7 @@ module TencentCloud
         # @type HideOneKeySign: Boolean
         # @param FillType: 签署人信息补充类型，默认无需补充。
 
-        # <ul><li> **1** : ( 动态签署人（可发起合同后再补充签署人信息）注：`企业自动签不支持动态补充`</li></ul>
+        # <ul><li> **1** :  动态签署人（可发起合同后再补充签署人信息）注：`企业自动签不支持动态补充`</li></ul>
 
         # 注：
         # `使用动态签署人能力前，需登陆腾讯电子签控制台打开服务开关`
@@ -1498,7 +1498,10 @@ module TencentCloud
 
         # - 如果不指定，则使用姓名和手机号进行补充。
         # @type Approvers: Array
-        # @param FlowId: 合同流程ID，为32位字符串。 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # - 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+        # - 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
+        # - <font color="red">不建议继续使用</font>，请使用<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#fillapproverinfo/" target="_blank">补充签署人结构体</a>中的FlowId指定合同
         # @type FlowId: String
         # @param FillApproverType: 签署人信息补充方式
 
@@ -5490,6 +5493,65 @@ module TencentCloud
         end
       end
 
+      # CreateCloseOrganizationUrl请求参数结构体
+      class CreateCloseOrganizationUrlRequest < TencentCloud::Common::AbstractModel
+        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
+        # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
+
+        attr_accessor :Agent
+
+        def initialize(agent=nil)
+          @Agent = agent
+        end
+
+        def deserialize(params)
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+        end
+      end
+
+      # CreateCloseOrganizationUrl返回参数结构体
+      class CreateCloseOrganizationUrlResponse < TencentCloud::Common::AbstractModel
+        # @param ExpiredOn: 链接有效期，unix时间戳，精确到秒
+        # @type ExpiredOn: Integer
+        # @param LongUrl: H5跳转到电子签小程序链接, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序
+        # @type LongUrl: String
+        # @param ShortUrl: H5跳转到电子签小程序链接的短链形式, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序
+        # @type ShortUrl: String
+        # @param MiniAppPath: APP或小程序跳转电子签小程序链接, 一般用于客户小程序或者APP跳转过来, 打开后进入腾讯电子签小程序
+        # @type MiniAppPath: String
+        # @param QrcodeUrl: 二维码链接
+        # @type QrcodeUrl: String
+        # @param WeixinQrcodeUrl: 直接跳转至电子签小程序的二维码链接，无需通过中转页。您需要自行将其转换为二维码，使用微信扫码后可直接进入。请注意，直接点击链接是无效的。
+        # @type WeixinQrcodeUrl: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :ExpiredOn, :LongUrl, :ShortUrl, :MiniAppPath, :QrcodeUrl, :WeixinQrcodeUrl, :RequestId
+
+        def initialize(expiredon=nil, longurl=nil, shorturl=nil, miniapppath=nil, qrcodeurl=nil, weixinqrcodeurl=nil, requestid=nil)
+          @ExpiredOn = expiredon
+          @LongUrl = longurl
+          @ShortUrl = shorturl
+          @MiniAppPath = miniapppath
+          @QrcodeUrl = qrcodeurl
+          @WeixinQrcodeUrl = weixinqrcodeurl
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @ExpiredOn = params['ExpiredOn']
+          @LongUrl = params['LongUrl']
+          @ShortUrl = params['ShortUrl']
+          @MiniAppPath = params['MiniAppPath']
+          @QrcodeUrl = params['QrcodeUrl']
+          @WeixinQrcodeUrl = params['WeixinQrcodeUrl']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateConsoleLoginUrl请求参数结构体
       class CreateConsoleLoginUrlRequest < TencentCloud::Common::AbstractModel
         # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容
@@ -5578,7 +5640,14 @@ module TencentCloud
 
         # <a href="https://qcloudimg.tencent-cloud.cn/raw/dd54f333140c711cf6a88e3801bcd178.png" target="_blank">点击查看头顶导航栏位置</a>
         # @type TopNavigationStatus: String
-        # @param AutoActive: 是否自动激活子客
+        # @param AutoActive: 是否自动激活子客企业，有下面两种选项：
+
+        # **false（默认设置）**：不自动激活子客户。您需要通过控制台或调用[激活或者续期子企业](https://qian.tencent.com/developers/partnerApis/accounts/CreateChannelSubOrganizationActive)接口手动完成激活过程。
+
+        # **true**：若持有的许可证充足，子客户企业注册完成后将自动激活，无需手动操作或访问控制台。
+
+        # <b>注</b>：如果<b>应用扩展服务</b>中的<b>自动激活子客企业</b>为打开态， 则忽略本接口的AutoActive这个参数（若持有的许可证充足，子客户企业注册完成后将自动激活），具体位置参考下图：
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/c3639b05503d3735bac483d17aa6b0a3.png)
         # @type AutoActive: Boolean
 
         attr_accessor :Agent, :ProxyOrganizationName, :UniformSocialCreditCode, :ProxyOperatorName, :ProxyOperatorMobile, :Module, :ModuleId, :MenuStatus, :Endpoint, :AutoJumpBackEvent, :AuthorizationTypes, :Operator, :ProxyOperatorIdCardNumber, :AutoJumpUrl, :TopNavigationStatus, :AutoActive
@@ -6397,7 +6466,10 @@ module TencentCloud
         # 第三方平台子客企业和员工必须已经过实名认证
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
         # @param FlowIds: 合同流程ID数组，最多支持100个。
-        # 注: `该参数和合同组编号必须二选一`
+
+        # 注:
+        # 1. 必须选择提供此参数或合同组编号中的一个。
+        # 2. 当生成类型（GenerateType）设为“ALL”时，不可提供多个流程ID。
         # @type FlowIds: Array
         # @param FlowGroupId: 合同组编号
         # 注：`该参数和合同流程ID数组必须二选一`
@@ -6414,17 +6486,14 @@ module TencentCloud
         # @type Endpoint: String
         # @param GenerateType: 签署链接生成类型，可以选择的类型如下
 
-        # <ul><li>**ALL**：(默认)全部签署方签署链接，此时不会给自动签署(静默签署)的签署方创建签署链接</li>
-        # <li>**CHANNEL**：第三方子企业员工签署方</li>
-        # <li>**NOT_CHANNEL**：SaaS平台企业员工签署方</li>
-        # <li>**PERSON**：个人/自然人签署方</li>
-        # <li>**FOLLOWER**：关注方，目前是合同抄送方</li>
-        # <li>**RECIPIENT**：获取RecipientId对应的签署链接，可用于生成动态签署人补充链接</li></ul>
+        # <ul><li><strong>ALL</strong>：（默认）为所有签署方生成签署链接，但不包括自动签署（静默签署）的签署方。注意：<strong>此中类型不支持多个合同ID（FlowIds）</strong>。</li>
+        # <li><strong>CHANNEL</strong>：适用于第三方子企业的员工签署方。</li>
+        # <li><strong>NOT_CHANNEL</strong>：适用于SaaS平台企业的员工签署方。</li>
+        # <li><strong>PERSON</strong>：适用于个人或自然人签署方。</li>
+        # <li><strong>FOLLOWER</strong>：适用于关注方，目前指合同的抄送方。</li>
+        # <li><strong>RECIPIENT</strong>：根据RecipientId生成对应的签署链接，适用于动态添加签署人的情况。</li></ul>
         # @type GenerateType: String
-        # @param OrganizationName: SaaS平台企业员工签署方的企业名称
-        # 如果名称中包含英文括号()，请使用中文括号（）代替。
-
-        # 注: `GenerateType为"NOT_CHANNEL"时必填`
+        # @param OrganizationName: SaaS平台企业员工签署方的企业名称如果名称中包含英文括号()，请使用中文括号（）代替。  注:  `1.GenerateType为"NOT_CHANNEL"时必填` `2.获取B端动态签署人领取链接时,可指定此字段来预先设定签署人的企业,预设后只能以该企业身份去领取合同并完成签署`
         # @type OrganizationName: String
         # @param Name: 合同流程里边参与方的姓名。
         # 注: `GenerateType为"PERSON"(即个人签署方)时必填`
@@ -6442,8 +6511,7 @@ module TencentCloud
         # <li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。</li>
         # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         # @type IdCardNumber: String
-        # @param OrganizationOpenId: 第三方平台子客企业的企业的标识, 即OrganizationOpenId
-        # 注: `GenerateType为"CHANNEL"时必填`
+        # @param OrganizationOpenId: 第三方平台子客企业的企业的标识, 即OrganizationOpenId。 注:  `1.GenerateType为"CHANNEL"时必填` `2.获取B端动态签署人领取链接时,可指定此字段来预先设定签署人的平台子客企业,预设后只能以该平台子客企业身份去领取合同并完成签署`
         # @type OrganizationOpenId: String
         # @param OpenId: 第三方平台子客企业员工的标识OpenId，GenerateType为"CHANNEL"时可用，指定到具体参与人, 仅展示已经实名的经办人信息
 
@@ -6566,6 +6634,97 @@ module TencentCloud
         end
       end
 
+      # 清理的企业认证流信息
+      class DeleteOrganizationAuthorizationInfo < TencentCloud::Common::AbstractModel
+        # @param AuthorizationId: 认证流 Id 是指在企业认证过程中，当前操作人的认证流程的唯一标识。每个企业在认证过程中只能有一条认证流认证成功。这意味着在同一认证过程内，一个企业只能有一个认证流程处于成功状态，以确保认证的唯一性和有效性。
+        # @type AuthorizationId: String
+        # @param OrganizationName: 认证的企业名称
+        # @type OrganizationName: String
+        # @param OrganizationOpenId: 第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样, 可以参考<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#agent" target="_blank">Agent结构体</a>
+        # @type OrganizationOpenId: String
+        # @param Errormessage: 清除认证流产生的错误信息
+        # @type Errormessage: String
+
+        attr_accessor :AuthorizationId, :OrganizationName, :OrganizationOpenId, :Errormessage
+
+        def initialize(authorizationid=nil, organizationname=nil, organizationopenid=nil, errormessage=nil)
+          @AuthorizationId = authorizationid
+          @OrganizationName = organizationname
+          @OrganizationOpenId = organizationopenid
+          @Errormessage = errormessage
+        end
+
+        def deserialize(params)
+          @AuthorizationId = params['AuthorizationId']
+          @OrganizationName = params['OrganizationName']
+          @OrganizationOpenId = params['OrganizationOpenId']
+          @Errormessage = params['Errormessage']
+        end
+      end
+
+      # DeleteOrganizationAuthorizations请求参数结构体
+      class DeleteOrganizationAuthorizationsRequest < TencentCloud::Common::AbstractModel
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.AppId</li>
+        # </ul>
+        # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
+        # @param AdminName: 认证人姓名，组织机构超管姓名。 在注册流程中，必须是超管本人进行操作。
+        # @type AdminName: String
+        # @param AdminMobile: 认证人手机号，组织机构超管手机号。 在注册流程中，必须是超管本人进行操作。
+        # @type AdminMobile: String
+
+        attr_accessor :Agent, :AdminName, :AdminMobile
+
+        def initialize(agent=nil, adminname=nil, adminmobile=nil)
+          @Agent = agent
+          @AdminName = adminname
+          @AdminMobile = adminmobile
+        end
+
+        def deserialize(params)
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @AdminName = params['AdminName']
+          @AdminMobile = params['AdminMobile']
+        end
+      end
+
+      # DeleteOrganizationAuthorizations返回参数结构体
+      class DeleteOrganizationAuthorizationsResponse < TencentCloud::Common::AbstractModel
+        # @param DeleteOrganizationAuthorizationInfos: 清理认证流的详细信息，包括企业名称、认证流唯一 ID 以及清理认证流过程中产生的错误信息。
+        # @type DeleteOrganizationAuthorizationInfos: Array
+        # @param Status: 批量清理认证流返回的状态值其中包括- 1 全部成功- 2 部分成功- 3 全部失败
+        # @type Status: Integer
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :DeleteOrganizationAuthorizationInfos, :Status, :RequestId
+
+        def initialize(deleteorganizationauthorizationinfos=nil, status=nil, requestid=nil)
+          @DeleteOrganizationAuthorizationInfos = deleteorganizationauthorizationinfos
+          @Status = status
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['DeleteOrganizationAuthorizationInfos'].nil?
+            @DeleteOrganizationAuthorizationInfos = []
+            params['DeleteOrganizationAuthorizationInfos'].each do |i|
+              deleteorganizationauthorizationinfo_tmp = DeleteOrganizationAuthorizationInfo.new
+              deleteorganizationauthorizationinfo_tmp.deserialize(i)
+              @DeleteOrganizationAuthorizationInfos << deleteorganizationauthorizationinfo_tmp
+            end
+          end
+          @Status = params['Status']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # 第三方应用集成员工部门信息
       class Department < TencentCloud::Common::AbstractModel
         # @param DepartmentId: 部门id
@@ -7648,7 +7807,9 @@ module TencentCloud
 
         # 注：`补充个人签署方时，若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。`
         # @type ApproverIdCardNumber: String
-        # @param FlowId: 合同流程ID，补充合同组子合同动态签署人时必传。
+        # @param FlowId: 合同流程ID
+        # - 补充合同组子合同动态签署人时必传。
+        # - 补充正常合同，请阅读：<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelCreateFlowApprovers/" target="_blank">补充签署人接口</a>接口使用说明
         # @type FlowId: String
 
         attr_accessor :RecipientId, :OpenId, :ApproverName, :ApproverMobile, :OrganizationName, :OrganizationOpenId, :NotChannelOrganization, :ApproverIdCardType, :ApproverIdCardNumber, :FlowId
@@ -7688,17 +7849,22 @@ module TencentCloud
         # @param ErrMessage: 补充失败错误说明
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ErrMessage: String
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowId: String
 
-        attr_accessor :RecipientId, :ErrMessage
+        attr_accessor :RecipientId, :ErrMessage, :FlowId
 
-        def initialize(recipientid=nil, errmessage=nil)
+        def initialize(recipientid=nil, errmessage=nil, flowid=nil)
           @RecipientId = recipientid
           @ErrMessage = errmessage
+          @FlowId = flowid
         end
 
         def deserialize(params)
           @RecipientId = params['RecipientId']
           @ErrMessage = params['ErrMessage']
+          @FlowId = params['FlowId']
         end
       end
 
@@ -9276,7 +9442,7 @@ module TencentCloud
         # @param OperateUrl: 操作跳转链接
         # <ul><li><strong>链接有效期：</strong> 跳转链接的有效期为24小时。</li>
         # <li><strong>没有返回链接的情形：</strong> 如果在操作时没有返回跳转链接，说明此次操作无需进行跳转，服务将会直接被开通或关闭。</li>
-        # <li><strong>返回链接的情形：</strong> 当操作类型为<b>OPEN（开通服务）</b>，并且扩展服务类型为<b>AUTO_SIGN（ 企业自动签署）</b>、<b>DOWNLOAD_FLOW（授权渠道下载合同）</b>或<b>OVERSEA_SIGN（企业与港澳台居民签署合同）</b>时，系统将返回一个操作链接。收到操作链接后，贵方需主动联系超级管理员（超管）或法人。<font color="red"><b>由超管或法人点击链接</b></font>，以完成服务的开通操作。</li>
+        # <li><strong>返回链接的情形：</strong> 当操作类型为<b>OPEN（开通服务）</b>，并且扩展服务类型为<b>AUTO_SIGN（ 企业自动签署）</b>、<b>DOWNLOAD_FLOW（授权渠道下载合同）</b>时，系统将返回一个操作链接。收到操作链接后，贵方需主动联系超级管理员（超管）或法人。<font color="red"><b>由超管或法人点击链接</b></font>，以完成服务的开通操作。</li>
         # </ul>
 
         # @type OperateUrl: String
@@ -10237,6 +10403,8 @@ module TencentCloud
         # @type ApproverSignComponentType: String
         # @param ApproverSignRole: 参与方在合同中的角色是按照创建合同的时候来排序的，解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`,  第三个叫`丙方`，以此类推。
         # 如果需改动此参与人的角色名字，可用此字段指定，由汉字,英文字符,数字组成，最大20个字。
+
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/973a820ab66d1ce57082c160c2b2d44a.png)
         # @type ApproverSignRole: String
         # @param ApproverSignSealId: 印章Id，签署控件类型为印章时，用于指定本企业签署方在解除协议中使用那个印章进行签署
         # @type ApproverSignSealId: String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-essbasic
 version: !ruby/object:Gem::Version
-  version: 3.0.931
+  version: 3.0.933
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-23 00:00:00.000000000 Z
+date: 2024-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common