tencentcloud-sdk-ess 3.0.900 → 3.0.902

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a1d08f573b860290ac4d53d17f57eda40ce931b3
-  data.tar.gz: 2a801ced7ba8a2172577a061b53d2945f21e71f0
+  metadata.gz: e01203e493cbbf6c647a4f40b87c6cb186051e3d
+  data.tar.gz: 536d56b93f137f364dac38f495619d9cfd7232d0
 SHA512:
-  metadata.gz: 4a3b4eaee4b93a7924bd459fa86d09c6205cd83c6afb26a371299d9e18cc08eeab14e1455e4ff0b0130c9ad258ea0b59bf2b05340a65502fc0d25a71338bbd35
-  data.tar.gz: 1f3d10e75cf85cf15790e372d7a1a536459bfcafe997ced5c66abc00c164629b567615dad9396c0643e97bc98f621f046dbbe5d6132adf1ccde2db9aafd01330
+  metadata.gz: d1b07b448afd7815ab611240819447eeb20970aed0dc09e4c56fac8796c41267a366be7a2352e482b1f81f8a64485446cec9da2c56595bd1e47f6289f927d242
+  data.tar.gz: 308b1bda176a54847d317e0784cb42db713e878bbe4bffc15b7ee7580244c62054f908e212017792e738d208212fb426fb0b86bc991bf329864bc0287fcb19e6

data/lib/VERSION

@@ -1 +1 @@
-3.0.900
+3.0.902

data/lib/v20201111/client.rb

@@ -1259,10 +1259,22 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口（CreateOrganizationAuthUrl）用于生成创建企业认证链接。
-        # 用于业务方系统自己生成认证链接进行跳转.而不用电子签自带的生成链接
+        # 本接口（CreateOrganizationAuthUrl）的主要功能是生成合作企业的认证链接。
 
-        # 注： **此接口需要购买单独的实名套餐包方可调用，如有需求请联系对接人员评估**
+        # 在生成链接的过程中，可以提供一部分已知信息，以便为对方进行认证流程提供便利。
+
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/7ec91b79a0a4860e77c9ff9f4a5f13ad/channel_SyncProxyOrganization2.png)
+
+
+        # - **企业统一社会信用代码**: 对应上图中的**1**
+        # - **企业名称**: 对应上图中的**2**
+        # - **企业法定代表人的名字**:对应上图中的**3**
+        # - **企业详细住所**:对应上图中的**4**
+
+
+
+
+        # <b>注</b>：此接口需要 <font  color="red"><b>购买单独的实名套餐包</b></font>方可调用，如有需求请联系对接人员评估
 
         # @param request: Request instance for CreateOrganizationAuthUrl.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateOrganizationAuthUrlRequest`
@@ -2344,6 +2356,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询企业认证状态
+
+        # @param request: Request instance for DescribeOrganizationAuthStatus.
+        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeOrganizationAuthStatusRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeOrganizationAuthStatusResponse`
+        def DescribeOrganizationAuthStatus(request)
+          body = send_request('DescribeOrganizationAuthStatus', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeOrganizationAuthStatusResponse.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
+
         # 此API接口用来查询加入集团的成员企业信息
         # 适用场景：子企业在加入集团后，主企业可能通过此接口获取到所有的子企业列表，方便进行展示和统计
 

data/lib/v20201111/models.rb

@@ -482,6 +482,44 @@ module TencentCloud
         end
       end
 
+      # 企业认证信息
+      class AuthRecord < TencentCloud::Common::AbstractModel
+        # @param OperatorName: 经办人姓名。
+        # @type OperatorName: String
+        # @param OperatorMobile: 经办人手机号。
+        # @type OperatorMobile: String
+        # @param AuthType: 认证授权方式：
+        # <ul><li> **0**：未选择授权方式（默认值）</li>
+        # <li> **1**：上传授权书</li>
+        # <li> **2**：法人授权</li>
+        # <li> **3**：法人认证</li></ul>
+        # @type AuthType: Integer
+        # @param AuditStatus: 企业认证授权书审核状态：
+        # <ul><li> **0**：未提交授权书（默认值）</li>
+        # <li> **1**：审核通过</li>
+        # <li> **2**：审核驳回</li>
+        # <li> **3**：审核中</li>
+        # <li> **4**：AI识别中</li>
+        # <li> **5**：客户确认AI信息</li></ul>
+        # @type AuditStatus: Integer
+
+        attr_accessor :OperatorName, :OperatorMobile, :AuthType, :AuditStatus
+
+        def initialize(operatorname=nil, operatormobile=nil, authtype=nil, auditstatus=nil)
+          @OperatorName = operatorname
+          @OperatorMobile = operatormobile
+          @AuthType = authtype
+          @AuditStatus = auditstatus
+        end
+
+        def deserialize(params)
+          @OperatorName = params['OperatorName']
+          @OperatorMobile = params['OperatorMobile']
+          @AuthType = params['AuthType']
+          @AuditStatus = params['AuditStatus']
+        end
+      end
+
       # 授权用户
       class AuthorizedUser < TencentCloud::Common::AbstractModel
         # @param UserId: 电子签系统中的用户id
@@ -4106,21 +4144,28 @@ module TencentCloud
         # @param Operator: 操作人信息
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param AuthorizationTypes: 指定授权方式 支持多选:
-        # 1-上传授权书方式
-        # 2- 法人授权方式
-        # 3- 法人身份认证方式
+
+        # <ul>
+        # <li><strong>1</strong>:上传授权书方式</li>
+        # <li><strong>2</strong>: 法人授权方式</li>
+        # <li><strong>3</strong>: 法人身份认证方式</li>
+        # </ul>
         # @type AuthorizationTypes: Array
-        # @param OrganizationName: 企业名称
-        # EndPointType=“H5”或者"SHORT_H5"时，该参数必填
+        # @param OrganizationName: 认证企业名称，请确认该名称与企业营业执照中注册的名称一致。
+
+        # 注：
+
+        # 1. `如果名称中包含英文括号()，请使用中文括号（）代替。`
+
+        # 2. `EndPointType=“H5”或者"SHORT_H5"时，该参数必填`
         # @type OrganizationName: String
         # @param UniformSocialCreditCode: 企业统一社会信用代码
         # @type UniformSocialCreditCode: String
-        # @param LegalName: 法人姓名
+        # @param LegalName: 企业法人的姓名
         # @type LegalName: String
-        # @param AutoJumpUrl: 认证完成跳转链接
+        # @param AutoJumpUrl: 认证完成跳回的链接，最长500个字符
         # @type AutoJumpUrl: String
         # @param OrganizationAddress: 营业执照企业地址
-        # 示例：xx省xx市xx县/区xx街道
         # @type OrganizationAddress: String
         # @param AdminName: 认证人姓名
         # @type AdminName: String
@@ -4128,49 +4173,37 @@ module TencentCloud
         # @type AdminMobile: String
         # @param AdminIdCardNumber: 认证人身份证号
         # @type AdminIdCardNumber: String
-        # @param AdminIdCardType: 认证人证件类型
-        # 支持以下类型
-        # <ul><li>ID_CARD : 中国大陆居民身份证  (默认值)</li>
-        # <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
-        # <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
+        # @param AdminIdCardType: 认证人证件类型， 支持以下类型
+        # <ul><li><b>ID_CARD</b> : 中国大陆居民身份证  (默认值)</li>
+        # <li><b>HONGKONG_AND_MACAO</b>  : 港澳居民来往内地通行证</li>
+        # <li><b>HONGKONG_MACAO_AND_TAIWAN</b>  : 港澳台居民居住证(格式同居民身份证)</li></ul>
         # @type AdminIdCardType: String
-        # @param UniformSocialCreditCodeSame: 营业执照的社会信用代码保持一致
-        # false 关闭-默认
-        # true 开启
+        # @param UniformSocialCreditCodeSame: 对方打开链接认证时，对方填写的营业执照的社会信用代码是否与接口上传上来的要保持一致。<ul><li><b>false（默认值）</b>：关闭状态，实际认证时允许与接口传递的信息存在不一致。</li><li><b>true</b>：启用状态，实际认证时必须与接口传递的信息完全相符。</li></ul>
         # @type UniformSocialCreditCodeSame: Boolean
-        # @param LegalNameSame: 法人姓名保持一致
-        # false 关闭-默认
-        # true 开启
+        # @param LegalNameSame: 对方打开链接认证时，法人姓名是否要与接口传递上来的保持一致。<ul><li><b>false（默认值）</b>：关闭状态，实际认证时允许与接口传递的信息存在不一致。</li><li><b>true</b>：启用状态，实际认证时必须与接口传递的信息完全相符。</li></ul>
         # @type LegalNameSame: Boolean
-        # @param AdminNameSame: 认证人姓名一致
-        # false 关闭-默认
-        # true 开启
-        # 注意：
-        # 开启后在认证过程前会校验拦截
+        # @param AdminNameSame: 对方打开链接认证时，认证人姓名是否要与接口传递上来的保持一致。<ul><li><b>false（默认值）</b>：关闭状态，实际认证时允许与接口传递的信息存在不一致。</li><li><b>true</b>：启用状态，实际认证时必须与接口传递的信息完全相符。</li></ul>
         # @type AdminNameSame: Boolean
-        # @param AdminIdCardNumberSame: 认证人居民身份证件号一致
-        # false 关闭-默认
-        # true 开启
-        # 注意：
-        # 开启后在认证过程前会校验拦截
+        # @param AdminIdCardNumberSame: 对方打开链接认证时，认证人居民身份证件号是否要与接口传递上来的保持一致。<ul><li><b>false（默认值）</b>：关闭状态，实际认证时允许与接口传递的信息存在不一致。</li><li><b>true</b>：启用状态，实际认证时必须与接口传递的信息完全相符。</li></ul>
         # @type AdminIdCardNumberSame: Boolean
-        # @param AdminMobileSame: 认证人手机号一致
-        # false 关闭-默认
-        # true 开启
-        # 注意：
-        # 开启后在认证过程前会校验拦截
+        # @param AdminMobileSame: 对方打开链接认证时，认证人手机号是否要与接口传递上来的保持一致。<ul>
+        # <li><b>false（默认值）</b>：关闭状态，实际认证时允许与接口传递的信息存在不一致。</li>
+        # <li><b>true</b>：启用状态，实际认证时必须与接口传递的信息完全相符。</li>
+        # </ul>
         # @type AdminMobileSame: Boolean
-        # @param OrganizationNameSame: 企业名称保持一致
-        # false 关闭-默认
-        # true 开启
+        # @param OrganizationNameSame: 对方打开链接认证时，企业名称是否要与接口传递上来的保持一致。<ul><li><b>false（默认值）</b>：关闭状态，实际认证时允许与接口传递的信息存在不一致。</li><li><b>true</b>：启用状态，实际认证时必须与接口传递的信息完全相符。</li></ul>
         # @type OrganizationNameSame: Boolean
-        # @param BusinessLicense: 营业执照正面照(PNG或JPG) base64格式, 大小不超过5M
+        # @param BusinessLicense: 营业执照正面照（支持PNG或JPG格式）需以base64格式提供，且文件大小不得超过5MB。
         # @type BusinessLicense: String
         # @param Endpoint: 跳转链接类型：
-        # "PC"-PC端认证链接
-        # "APP"-全屏或半屏跳转小程序链接
-        # “H5”-H5页面认证链接 "SHORT_H5"- H5认证短链
-        # "SHORT_URL"- 跳转小程序短链
+
+        # <ul>
+        # <li><b>PC</b>：适用于PC端的认证链接</li>
+        # <li><b>APP</b>：用于全屏或半屏跳转的小程序链接</li>
+        # <li><b>SHORT_URL</b>：跳转小程序的链接的短链形式</li>
+        # <li><b>H5</b>：适用于H5页面的认证链接</li>
+        # <li><b>SHORT_H5</b>：H5认证链接的短链形式</li>
+        # </ul>
         # @type Endpoint: String
 
         attr_accessor :Operator, :AuthorizationTypes, :OrganizationName, :UniformSocialCreditCode, :LegalName, :AutoJumpUrl, :OrganizationAddress, :AdminName, :AdminMobile, :AdminIdCardNumber, :AdminIdCardType, :UniformSocialCreditCodeSame, :LegalNameSame, :AdminNameSame, :AdminIdCardNumberSame, :AdminMobileSame, :OrganizationNameSame, :BusinessLicense, :Endpoint
@@ -4225,13 +4258,11 @@ module TencentCloud
 
       # CreateOrganizationAuthUrl返回参数结构体
       class CreateOrganizationAuthUrlResponse < TencentCloud::Common::AbstractModel
-        # @param AuthUrl: “H5”-H5长连接
-        # "SHORT_H5"- H5短链
-        # "APP"-小程序
-        # "PC"-PC浏览器
-        # 链接有效期统一30天
+        # @param AuthUrl: 生成的认证链接。
+
+        # 注： `链接有效期统一30天`
         # @type AuthUrl: String
-        # @param ExpiredTime: 链接过期时间戳
+        # @param ExpiredTime: 链接过期时间，格式为Unix标准时间戳（秒）
         # @type ExpiredTime: Integer
         # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -7515,6 +7546,79 @@ module TencentCloud
         end
       end
 
+      # DescribeOrganizationAuthStatus请求参数结构体
+      class DescribeOrganizationAuthStatusRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。 支持填入集团子公司经办人 userId 代发合同。  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param OrganizationName: 组织机构名称。 请确认该名称与企业营业执照中注册的名称一致。 如果名称中包含英文括号()，请使用中文括号（）代替。
+        # @type OrganizationName: String
+        # @param UniformSocialCreditCode: 企业统一社会信用代码
+        # 注意：OrganizationName和UniformSocialCreditCode不能同时为空
+        # @type UniformSocialCreditCode: String
+        # @param LegalName: 法人姓名
+        # @type LegalName: String
+
+        attr_accessor :Operator, :OrganizationName, :UniformSocialCreditCode, :LegalName
+
+        def initialize(operator=nil, organizationname=nil, uniformsocialcreditcode=nil, legalname=nil)
+          @Operator = operator
+          @OrganizationName = organizationname
+          @UniformSocialCreditCode = uniformsocialcreditcode
+          @LegalName = legalname
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @OrganizationName = params['OrganizationName']
+          @UniformSocialCreditCode = params['UniformSocialCreditCode']
+          @LegalName = params['LegalName']
+        end
+      end
+
+      # DescribeOrganizationAuthStatus返回参数结构体
+      class DescribeOrganizationAuthStatusResponse < TencentCloud::Common::AbstractModel
+        # @param IsVerified: 企业是否已认证
+        # @type IsVerified: Boolean
+        # @param AuthStatus: 企业认证状态 0-未认证 1-认证中 2-已认证
+        # @type AuthStatus: Integer
+        # @param AuthRecords: 企业认证信息
+        # @type AuthRecords: Array
+        # @param OrganizationId: 企业在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "更多"->"企业设置"->"企业中心"- 中查看企业电子签账号。
+        # p.s. 只有当前企业认证成功的时候返回
+        # @type OrganizationId: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :IsVerified, :AuthStatus, :AuthRecords, :OrganizationId, :RequestId
+
+        def initialize(isverified=nil, authstatus=nil, authrecords=nil, organizationid=nil, requestid=nil)
+          @IsVerified = isverified
+          @AuthStatus = authstatus
+          @AuthRecords = authrecords
+          @OrganizationId = organizationid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @IsVerified = params['IsVerified']
+          @AuthStatus = params['AuthStatus']
+          unless params['AuthRecords'].nil?
+            @AuthRecords = []
+            params['AuthRecords'].each do |i|
+              authrecord_tmp = AuthRecord.new
+              authrecord_tmp.deserialize(i)
+              @AuthRecords << authrecord_tmp
+            end
+          end
+          @OrganizationId = params['OrganizationId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeOrganizationGroupOrganizations请求参数结构体
       class DescribeOrganizationGroupOrganizationsRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息,userId必填。

metadata

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