tencentcloud-sdk-ess 3.0.827 → 3.0.829

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b94aab86e9540ce60b090989f1301894288997ca
-  data.tar.gz: 52cd756df4c284b55d7d3cb198af5dc88f36f525
+  metadata.gz: b815a16cc1a4a511cacb834c7ec183cc24aa02a3
+  data.tar.gz: 400a92bbd2f3c43b45a26bf11a20ce736e22dd33
 SHA512:
-  metadata.gz: aa4e3f1759977346ecac946bba1c9d4f1364a7ace735ecfa901eba5a8d42bb9d92abc17e20e93da144ddc5ca90142b4114376a501dd994ff68aa381ea6c2aa71
-  data.tar.gz: bb3813e708e0ceb50dd3d2c0d0360861e0d371c9f8a157e25902ec0b68bfb4ee9dc3019c51e91539a13262381bf9a598491c0fc5fde88e48875fc9568af9555b
+  metadata.gz: e4be56af2afb9ce036f7c8eff53dc9ab991abeb66747d5fb44c9a8927134e282d49a9f18b3e735105630b860a731b375bd9252554491f58499610937c874ae18
+  data.tar.gz: 53d4a065289fbb3272a845fa344b543b4cb0964709b73f10d45cbf38892a0506ef2b2b1e12cbd77fc510629a4f4051214ea6061eb2c9e237fbc80a8e355cba1a

data/lib/VERSION

@@ -1 +1 @@
-3.0.827
+3.0.829

data/lib/v20201111/client.rb

@@ -264,14 +264,13 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过此接口，创建小程序批量签署链接，个人/企业员工点击此链接即可跳转小程序进行批量签署。
-        # 请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。
+        # 通过此接口，可以创建小程序批量签署链接，个人/企业员工可通过此链接跳转至小程序进行批量签署。请确保生成链接时的身份信息与签署合同参与方的信息保持一致。
 
-        # 注：
-        # - 使用此接口生成链接，需要提前开通 `使用手机号验证签署方身份` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
-        # - 参与人点击链接后需短信验证码才能查看合同内容。
-        # - 企业用户批量签署，需要传OrganizationName（参与方所在企业名称）参数生成签署链接，`请确保此企业已完成腾讯电子签企业认证`。
-        # - 个人批量签署，签名区`仅支持手写签名`。
+        # 注意事项：
+        # - 使用此接口生成链接，需要贵企业先开通 <font color="red">使用手机号验证签署方身份 </font>功能。您可以在 <b>【腾讯电子签网页端】->【企业设置】->【拓展服务】</b>中找到该功能。
+        # - 生成批量签署链接时，<font color="red">合同目标参与方的状态必须为<b>待签署</b>状态</font>。签署人人点击链接后需要输入短信验证码才能查看合同内容。
+        # - 企业员工批量签署链接：需要传入签署方所在企业名称，用户名字和手机号（或者身份证件信息）参数来生成签署链接。<font color="red">该签署方企业必须已完成腾讯电子签企业认证</font>
+        # - 个人批量签署链接：需要传入签署方用户名字和手机号（或者身份证件信息）参数来生成签署链接。<font color="red">签名区仅支持手写签名</font>
 
         # @param request: Request instance for CreateBatchSignUrl.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateBatchSignUrlRequest`
@@ -964,6 +963,36 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口，创建子企业激活记录，集团企业管理员可针对未激活的成员企业进行激活。
+        # 激活子企业时请保证子企业 lisence 充足。
+        # 这个操作与页面端激活成员企业操作类似
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/c4e76fbac92e4ce451a03601c964793b.png)
+
+        # p.s.
+        # 此接口只能用于激活，不能用于续期。
+
+        # @param request: Request instance for CreateIntegrationSubOrganizationActiveRecord.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateIntegrationSubOrganizationActiveRecordRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateIntegrationSubOrganizationActiveRecordResponse`
+        def CreateIntegrationSubOrganizationActiveRecord(request)
+          body = send_request('CreateIntegrationSubOrganizationActiveRecord', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateIntegrationSubOrganizationActiveRecordResponse.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
+
         # 此接口用于赋予员工指定的角色权限，如需解绑请使用 DeleteIntegrationRoleUsers 接口。
 
         # @param request: Request instance for CreateIntegrationUserRoles.
@@ -1083,6 +1112,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 生成集团加入链接，分享至子企业超管或者法人，子企业管理员可通过链接加入集团。
+        # 注意:调用当前接口的企业 必须为集团企业。如何成为集团企业可以参考下面的文档[集团操作文档](https://qian.tencent.com/document/86707)
+
+        # @param request: Request instance for CreateOrganizationGroupInvitationLink.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateOrganizationGroupInvitationLinkRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateOrganizationGroupInvitationLinkResponse`
+        def CreateOrganizationGroupInvitationLink(request)
+          body = send_request('CreateOrganizationGroupInvitationLink', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateOrganizationGroupInvitationLinkResponse.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
+
         # 此接口（CreateOrganizationInfoChangeUrl）用于创建企业信息变更链接，支持创建企业超管变更链接或企业基础信息变更链接，通过入参ChangeType指定。
 
 

data/lib/v20201111/models.rb

@@ -3508,6 +3508,49 @@ module TencentCloud
         end
       end
 
+      # CreateIntegrationSubOrganizationActiveRecord请求参数结构体
+      class CreateIntegrationSubOrganizationActiveRecordRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。 支持填入集团子公司经办人 userId 代发合同。  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param SubOrganizationIds: 待激活成员企业ID集合
+        # @type SubOrganizationIds: Array
+
+        attr_accessor :Operator, :SubOrganizationIds
+
+        def initialize(operator=nil, suborganizationids=nil)
+          @Operator = operator
+          @SubOrganizationIds = suborganizationids
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @SubOrganizationIds = params['SubOrganizationIds']
+        end
+      end
+
+      # CreateIntegrationSubOrganizationActiveRecord返回参数结构体
+      class CreateIntegrationSubOrganizationActiveRecordResponse < TencentCloud::Common::AbstractModel
+        # @param FailedSubOrganizationIds: 激活失败的成员企业ID集合
+        # @type FailedSubOrganizationIds: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :FailedSubOrganizationIds, :RequestId
+
+        def initialize(failedsuborganizationids=nil, requestid=nil)
+          @FailedSubOrganizationIds = failedsuborganizationids
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @FailedSubOrganizationIds = params['FailedSubOrganizationIds']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateIntegrationUserRoles请求参数结构体
       class CreateIntegrationUserRolesRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
@@ -3934,6 +3977,72 @@ module TencentCloud
         end
       end
 
+      # CreateOrganizationGroupInvitationLink请求参数结构体
+      class CreateOrganizationGroupInvitationLinkRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。 支持填入集团子公司经办人 userId 代发合同。  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param ExpireTime: 到期时间（以秒为单位的时间戳），其上限为30天的有效期限。
+        # @type ExpireTime: Integer
+
+        attr_accessor :Operator, :ExpireTime
+
+        def initialize(operator=nil, expiretime=nil)
+          @Operator = operator
+          @ExpireTime = expiretime
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @ExpireTime = params['ExpireTime']
+        end
+      end
+
+      # CreateOrganizationGroupInvitationLink返回参数结构体
+      class CreateOrganizationGroupInvitationLinkResponse < TencentCloud::Common::AbstractModel
+        # @param Link: 加入集团二维码链接，子企业的管理员可以直接扫码进入。
+        # 注意:1. 该链接有效期时间为ExpireTime，同时需要注意保密，不要外泄给无关用户。2. 该链接不支持小程序嵌入，仅支持<b>移动端浏览器</b>打开。3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
+        # @type Link: String
+        # @param ExpireTime: 到期时间（以秒为单位的时间戳）
+        # @type ExpireTime: Integer
+        # @param JumpUrl: 加入集团短链接。
+        # 注意:
+        # 1. 该链接有效期时间为ExpireTime，同时需要注意保密，不要外泄给无关用户。
+        # 2. 该链接不支持小程序嵌入，仅支持<b>移动端浏览器</b>打开。
+        # 3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
+        # @type JumpUrl: String
+        # @param MiniAppPath: 腾讯电子签小程序加入集团链接。
+
+        # <li>小程序和APP集成使用</li>
+        # <li>得到的链接类似于`pages/guide?shortKey=yDw***k1xFc5`, 用法可以参考：<a href="https://qian.tencent.com/developers/company/openwxminiprogram" target="_blank">跳转电子签小程序</a></li>
+
+
+        # 注： <font color="red">生成的链路后面不能再增加参数</font>
+        # @type MiniAppPath: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Link, :ExpireTime, :JumpUrl, :MiniAppPath, :RequestId
+
+        def initialize(link=nil, expiretime=nil, jumpurl=nil, miniapppath=nil, requestid=nil)
+          @Link = link
+          @ExpireTime = expiretime
+          @JumpUrl = jumpurl
+          @MiniAppPath = miniapppath
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Link = params['Link']
+          @ExpireTime = params['ExpireTime']
+          @JumpUrl = params['JumpUrl']
+          @MiniAppPath = params['MiniAppPath']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateOrganizationInfoChangeUrl请求参数结构体
       class CreateOrganizationInfoChangeUrlRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。
@@ -10334,9 +10443,11 @@ module TencentCloud
         # @param AdminName: 组织机构超管姓名。
         # 在注册流程中，必须是超管本人进行操作。
         # 如果法人做为超管管理组织机构,超管姓名就是法人姓名
+        # 如果入参中传递超管授权书PowerOfAttorneys，则此参数为必填参数。
         # @type AdminName: String
-        # @param AdminMobile: 组织机构超管姓名。
+        # @param AdminMobile: 组织机构超管手机号。
         # 在注册流程中，这个手机号必须跟操作人在电子签注册的个人手机号一致。
+        # 如果入参中传递超管授权书PowerOfAttorneys，则此参数为必填参数
         # @type AdminMobile: String
         # @param AuthorizationTypes: 可选的此企业允许的授权方式, 可以设置的方式有:
         # 1：上传授权书
@@ -10349,7 +10460,7 @@ module TencentCloud
         # `2. 如果当前的企业类型是政府/事业单位, 则只支持上传授权书+对公打款`
         # `3. 如果当前操作人是法人,则是法人认证`
         # @type AuthorizationTypes: Array
-        # @param AdminIdCardNumber: 认证人身份证号
+        # @param AdminIdCardNumber: 认证人身份证号，如果入参中传递超管授权书PowerOfAttorneys，则此参数为必填参数
         # @type AdminIdCardNumber: String
         # @param AdminIdCardType: 认证人证件类型
         # 支持以下类型
@@ -10359,10 +10470,16 @@ module TencentCloud
         # @type AdminIdCardType: String
         # @param BusinessLicense: 营业执照正面照(PNG或JPG) base64格式, 大小不超过5M
         # @type BusinessLicense: String
+        # @param PowerOfAttorneys: 授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。
+        # p.s. 如果上传授权书 ，需遵循以下条件
+        # 1. 超管的信息（超管姓名，超管身份证，超管手机号）必须为必填参数。
+        # 2. 超管的个人身份必须在电子签已经实名。
+        # 2. 认证方式AuthorizationTypes必须只能是上传授权书方式
+        # @type PowerOfAttorneys: Array
 
-        attr_accessor :OrganizationName, :UniformSocialCreditCode, :LegalName, :Address, :AdminName, :AdminMobile, :AuthorizationTypes, :AdminIdCardNumber, :AdminIdCardType, :BusinessLicense
+        attr_accessor :OrganizationName, :UniformSocialCreditCode, :LegalName, :Address, :AdminName, :AdminMobile, :AuthorizationTypes, :AdminIdCardNumber, :AdminIdCardType, :BusinessLicense, :PowerOfAttorneys
 
-        def initialize(organizationname=nil, uniformsocialcreditcode=nil, legalname=nil, address=nil, adminname=nil, adminmobile=nil, authorizationtypes=nil, adminidcardnumber=nil, adminidcardtype=nil, businesslicense=nil)
+        def initialize(organizationname=nil, uniformsocialcreditcode=nil, legalname=nil, address=nil, adminname=nil, adminmobile=nil, authorizationtypes=nil, adminidcardnumber=nil, adminidcardtype=nil, businesslicense=nil, powerofattorneys=nil)
           @OrganizationName = organizationname
           @UniformSocialCreditCode = uniformsocialcreditcode
           @LegalName = legalname
@@ -10373,6 +10490,7 @@ module TencentCloud
           @AdminIdCardNumber = adminidcardnumber
           @AdminIdCardType = adminidcardtype
           @BusinessLicense = businesslicense
+          @PowerOfAttorneys = powerofattorneys
         end
 
         def deserialize(params)
@@ -10386,6 +10504,7 @@ module TencentCloud
           @AdminIdCardNumber = params['AdminIdCardNumber']
           @AdminIdCardType = params['AdminIdCardType']
           @BusinessLicense = params['BusinessLicense']
+          @PowerOfAttorneys = params['PowerOfAttorneys']
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.827
+  version: 3.0.829
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-05-21 00:00:00.000000000 Z
+date: 2024-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common