tencentcloud-sdk-ess 3.0.1082 → 3.0.1086

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a8cd9f000d43ca73d12e573da5165a3d8c0e4933
-  data.tar.gz: ac5393a85e8bf6a8ef02f8ed74f92c49b88efa7d
+  metadata.gz: 149c2b972f0af66d5c1e67017cb4c4b6e8bf440f
+  data.tar.gz: 1093c6da696e216b48fce553e2df1ba1cb224e8c
 SHA512:
-  metadata.gz: 0509d59339bb3de04290f17c38fed962e61b12e1511186e5506966eaa078e72915ef7d12237929880da68f6d0f8f0a74050ca5dbb40c582ad3bcc37b1b281cd2
-  data.tar.gz: c5ffd81a776d5b017f5ec831fc5fa34d51afe9d3d600ddc0fcce00cb86a11ff654f2f3764fcb8faea98f4c60e0812a8e55785812dcbd7b1fc1cc4fa90a2f7e18
+  metadata.gz: 6f39acef13576e5843c7204a9aff7fbf0e472b5e8041913fbdb3aa9e14c10dcad7f436dc76a878ef0eaf9d2dec17cde79aa4778fff03e4bd45bd10d0f0a84b4a
+  data.tar.gz: cdf9070bbd1c71b524d0819bcd009668da4f3a637298655e2235b37e1942bb1b68768d73b521b19980c2b7ab75acb42b161cf1043a5d527f30165a45b1006bf8

data/lib/VERSION

@@ -1 +1 @@
-3.0.1082
+3.0.1086

data/lib/v20201111/client.rb

@@ -943,6 +943,8 @@ module TencentCloud
 
         # 提交申请出证报告任务并返回报告ID。
 
+        # 出证报告的示例样式可以参考 [出征报告.PDF](https://qcloudimg.tencent-cloud.cn/raw/a55214fcddaebbd1582cc9c57cc6cf1b.pdf)
+
         # 注意：
         # <ul><li>使用此功能`需搭配出证套餐` ，使用前请联系对接的客户经理沟通。</li>
         # <li>操作人必须是`发起方或者签署方企业的(非走授权书认证)法人或者超管`。</li>
@@ -1455,6 +1457,33 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 本接口（CreateModifyAdminAuthorizationUrl）用于重新上传超管授权书。
+
+        # 注意:
+        # 1. 重新上传超管授权书，必须是审核失败的情况下才能重新上传,可以通过回调[!授权书认证审核结果回调](https://qian.tencent.com/developers/company/callback_types_staffs#%E5%8D%81%E5%85%AD-%E6%8E%88%E6%9D%83%E4%B9%A6%E8%AE%A4%E8%AF%81%E5%AE%A1%E6%A0%B8%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)得到
+
+        # @param request: Request instance for CreateModifyAdminAuthorizationUrl.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateModifyAdminAuthorizationUrlRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateModifyAdminAuthorizationUrlResponse`
+        def CreateModifyAdminAuthorizationUrl(request)
+          body = send_request('CreateModifyAdminAuthorizationUrl', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateModifyAdminAuthorizationUrlResponse.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
+
         # 此接口（CreateMultiFlowSignQRCode）用于创建一码多签签署码。
 
         # **适用场景**:
@@ -2281,6 +2310,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 本接口（DescribeBatchOrganizationRegistrationTasks）用于查询企业批量认证任务状态。
+
+        # @param request: Request instance for DescribeBatchOrganizationRegistrationTasks.
+        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeBatchOrganizationRegistrationTasksRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeBatchOrganizationRegistrationTasksResponse`
+        def DescribeBatchOrganizationRegistrationTasks(request)
+          body = send_request('DescribeBatchOrganizationRegistrationTasks', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeBatchOrganizationRegistrationTasksResponse.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
+
         # 此接口用于获取企业批量认证异步任务的状态及结果。
 
         # 前提条件：已调用 CreateBatchOrganizationRegistrationTasks创建企业批量认证链接任务接口，并得到了任务Id。

data/lib/v20201111/models.rb

@@ -719,6 +719,55 @@ module TencentCloud
         end
       end
 
+      # 批量认证企业任务详情信息，其中包括 TaskId，状态信息等等。
+      class BatchOrganizationRegistrationTasksDetails < TencentCloud::Common::AbstractModel
+        # @param TaskId: 生成注册链接的任务Id
+        # @type TaskId: String
+        # @param Status: 批量创建企业任务的状态
+        # <ul>
+        # <li>Processing</li>
+        # <li>Create</li>
+        # <li>Submit</li>
+        # <li>Authorization</li>
+        # <li>Failed</li>
+        # </ul>
+
+        # 各个状态所代表的含义如下表格所示：
+        # <table>
+        # <thead align="center" valign="center">
+        # <tr><th>任务状态名称</th><th>任务状态详情</th></tr>
+        # </thead>
+        # <tbody>
+        # <tr><th align="center" valign="center">Processing</th><th>企业认证任务处理中，用户调用了<a href="https://qian.tencent.com/developers/companyApis/organizations/CreateBatchOrganizationRegistrationTasks">CreateBatchOrganizationRegistrationTasks</a>接口，但是任务还在处理中的状态</th></tr>
+        # <tr><th align="center" valign="center">Create</th><th>创建企业认证链接任务完成，可以调用生成任务链接接口</th></tr>
+        # <tr><th align="center" valign="center">Submit</th><th>企业认证任务已提交,到如下界面之后，会变为这个状态
+
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/acbcec8c7a71de14d9c041e3b8ca8b3f.png)</th></tr>
+        # <tr><th align="center" valign="center">Authorization</th><th>企业认证任务认证成功,点击下图下一步，进入到授权书上传或者法人认证，则会变为这个状态
+
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/c52448354871cffa729da8db4e3a6f18.png)</th></tr>
+        # <tr><th align="center" valign="center">Failed</th><th>企业认证任务失败</th></tr>
+        # </tbody>
+        # </table>
+        # @type Status: String
+        # @param ErrorMessage: 如果任务失败,会返回错误信息
+        # @type ErrorMessage: String
+
+        attr_accessor :TaskId, :Status, :ErrorMessage
+
+        def initialize(taskid=nil, status=nil, errormessage=nil)
+          @TaskId = taskid
+          @Status = status
+          @ErrorMessage = errormessage
+        end
+
+        def deserialize(params)
+          @TaskId = params['TaskId']
+          @Status = params['Status']
+          @ErrorMessage = params['ErrorMessage']
+        end
+      end
+
       # 用户计费使用情况详情
       class BillUsageDetail < TencentCloud::Common::AbstractModel
         # @param FlowId: 合同流程ID，为32位字符串。
@@ -1807,14 +1856,25 @@ module TencentCloud
         # <li>SHORT_H5：生成H5跳转短链</li>
         # </ul>
         # @type Endpoint: String
+        # @param BatchAuthMethod: 认证链接使用单链接还是多链接模式
+
+        # <ul>
+        # <li>0 - 多链接(默认)，指批量生成链接， 每一个企业会拥有一个认证链接，然后分别认证</li>
+        # <li>1 - 单链接 ， 指批量生成链接，然后会将多个链接聚合成一个链接，进行认证</li>
+        # </ul>
+
+        # p.s.
+        # 请注意， 如果使用单链接的模式并且认证方式是授权书方式的时候，必须在接口中传递超管授权书。
+        # @type BatchAuthMethod: Integer
 
-        attr_accessor :Operator, :RegistrationOrganizations, :Agent, :Endpoint
+        attr_accessor :Operator, :RegistrationOrganizations, :Agent, :Endpoint, :BatchAuthMethod
 
-        def initialize(operator=nil, registrationorganizations=nil, agent=nil, endpoint=nil)
+        def initialize(operator=nil, registrationorganizations=nil, agent=nil, endpoint=nil, batchauthmethod=nil)
           @Operator = operator
           @RegistrationOrganizations = registrationorganizations
           @Agent = agent
           @Endpoint = endpoint
+          @BatchAuthMethod = batchauthmethod
         end
 
         def deserialize(params)
@@ -1835,6 +1895,7 @@ module TencentCloud
             @Agent.deserialize(params['Agent'])
           end
           @Endpoint = params['Endpoint']
+          @BatchAuthMethod = params['BatchAuthMethod']
         end
       end
 
@@ -4715,6 +4776,66 @@ module TencentCloud
         end
       end
 
+      # CreateModifyAdminAuthorizationUrl请求参数结构体
+      class CreateModifyAdminAuthorizationUrlRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param AuthorizationId: 企业认证流Id，可以通过回调[授权书认证审核结果回调](https://qian.tencent.com/developers/company/callback_types_staffs#%E5%8D%81%E5%85%AD-%E6%8E%88%E6%9D%83%E4%B9%A6%E8%AE%A4%E8%AF%81%E5%AE%A1%E6%A0%B8%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)得到
+        # @type AuthorizationId: String
+        # @param Endpoint: 要跳转的链接类型<ul><li> **HTTP**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型  ，此时返回长链 (默认类型)</li><li>**HTTP_SHORT_URL**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型，此时返回短链</li><li>**APP**： 第三方APP或小程序跳转电子签小程序的path,  APP或者小程序跳转适合此类型</li><li>**PC**： 跳转电子签web 端控制台的链接。</li></ul>
+        # @type Endpoint: String
+
+        attr_accessor :Operator, :Agent, :AuthorizationId, :Endpoint
+
+        def initialize(operator=nil, agent=nil, authorizationid=nil, endpoint=nil)
+          @Operator = operator
+          @Agent = agent
+          @AuthorizationId = authorizationid
+          @Endpoint = endpoint
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @AuthorizationId = params['AuthorizationId']
+          @Endpoint = params['Endpoint']
+        end
+      end
+
+      # CreateModifyAdminAuthorizationUrl返回参数结构体
+      class CreateModifyAdminAuthorizationUrlResponse < TencentCloud::Common::AbstractModel
+        # @param Url: 变更企业超管授权书链接。
+        # 没有有效期限制。
+
+        # 注意：
+        # 此链接仅能由当时认证企业的认证人使用。
+        # @type Url: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Url, :RequestId
+
+        def initialize(url=nil, requestid=nil)
+          @Url = url
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Url = params['Url']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateMultiFlowSignQRCode请求参数结构体
       class CreateMultiFlowSignQRCodeRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。
@@ -7408,6 +7529,65 @@ module TencentCloud
         end
       end
 
+      # DescribeBatchOrganizationRegistrationTasks请求参数结构体
+      class DescribeBatchOrganizationRegistrationTasksRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param TaskIds: 企业批量认证链接的子任务 SubTaskId，该 SubTaskId 是通过接口[查询企业批量认证链接](https://qian.tencent.com/developers/companyApis/organizations/DescribeBatchOrganizationRegistrationUrls)可以得到。
+        # @type TaskIds: Array
+
+        attr_accessor :Operator, :Agent, :TaskIds
+
+        def initialize(operator=nil, agent=nil, taskids=nil)
+          @Operator = operator
+          @Agent = agent
+          @TaskIds = taskids
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @TaskIds = params['TaskIds']
+        end
+      end
+
+      # DescribeBatchOrganizationRegistrationTasks返回参数结构体
+      class DescribeBatchOrganizationRegistrationTasksResponse < TencentCloud::Common::AbstractModel
+        # @param Details: 企业批量任务状态明细
+        # @type Details: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Details, :RequestId
+
+        def initialize(details=nil, requestid=nil)
+          @Details = details
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['Details'].nil?
+            @Details = []
+            params['Details'].each do |i|
+              batchorganizationregistrationtasksdetails_tmp = BatchOrganizationRegistrationTasksDetails.new
+              batchorganizationregistrationtasksdetails_tmp.deserialize(i)
+              @Details << batchorganizationregistrationtasksdetails_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeBatchOrganizationRegistrationUrls请求参数结构体
       class DescribeBatchOrganizationRegistrationUrlsRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.1082
+  version: 3.0.1086
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-06-16 00:00:00.000000000 Z
+date: 2025-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common