tencentcloud-sdk-essbasic 3.0.694 → 3.0.695

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f03e4987042c0a918a16d1893c49fa5be52603dc
-  data.tar.gz: 9f079cce878c38fa3f08190c4244418b02d9f0c2
+  metadata.gz: 30a5ceb47a62b7f419bd84e3dee631d20f0f3529
+  data.tar.gz: 520be7505e717ec39c30b3750a2a733c2e7cb695
 SHA512:
-  metadata.gz: 25e95c4ff85e82970488b1311ac7582a2f18d1249b7c14fad9252f077bb2dafe0f65b4b8afb06ec4c63cee40408bd3d7a231d11d6d5e0c3cb1cf2dc680548d12
-  data.tar.gz: 7f6f779ea99c5cc432d1a216370e57a5757c3613240bd85944fff6aa9acf43efe519f1c0be12e38b46af3fab01f85d6b9a377e91a24acbdd2dc5087265bc0119
+  metadata.gz: c98753e5e97c5fcb0470273ceac46d96e3588e273b071bc678acf7afd213fea41171769483d01166c96ba9af04f721840c833c9ce5deb123265b16d2c0eed3cc
+  data.tar.gz: 367ac848a05c75fa14507716fc86657df91a9b874c704ff354ad1c14cfea0c4f756642c23ffd02908f808198017225d246b169ea1f430fa74474ec8efb63822c

data/lib/VERSION

@@ -1 +1 @@
-3.0.694
+3.0.695

data/lib/v20210526/client.rb

@@ -1093,7 +1093,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 用于分页查询企业员工信息列表，支持设置过滤条件以筛选员工查询结果。
+        # 获取企业员工信息, 可以获取员工的名字,OpenId,UserId和简述的角色等信息，支持设置过滤条件以筛选员工查询结果。
+
+        # **注**:通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/SyncProxyOrganizationOperators" target="_blank">企业员工新增或离职</a>接口增加的新员工或者离职的员工也会在列表中。
 
         # @param request: Request instance for ChannelDescribeEmployees.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelDescribeEmployeesRequest`
@@ -1990,9 +1992,20 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 此接口（SyncProxyOrganization）用于同步第三方平台子客企业信息，包括企业名称，企业营业执照，企业统一社会信用代码和法人姓名等，便于子客企业在企业激活过程中无需手动上传营业执照或补充企业信息。注意：
-        # 1. 需要在子客企业激活前调用该接口，如果您的企业已经提交企业信息或者企业已经激活，同步的企业信息将不会生效。
-        # 2. 如果您同时传递了营业执照信息和企业名称等信息，在认证过程中将以营业执照中的企业信息为准，请注意企业信息需要和营业执照信息对应。
+        # 此接口（SyncProxyOrganization）用于同步第三方平台子客企业信息，包括企业名称、企业营业执照、企业统一社会信用代码和法人姓名等，便于子客企业在企业激活过程中无需手动上传营业执照或补充企业信息。
+
+        # 注意：
+
+        # - **需要在<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>前同步的企业信息**, 否则会出现信息同步没有用的情形
+        # - **企业信息需要和营业执照信息对应**,  否则会出现激活过程验证不通过的问题
+
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/7ec91b79a0a4860e77c9ff9f4a5f13ad/channel_SyncProxyOrganization2.png)
+
+
+        # - **企业统一社会信用代码**: 对应上图中的**1**
+        # - **第三方平台子客企业名称**: 对应上图中的**2**
+        # - **企业法定代表人的名字**:对应上图中的**3**
+        # - **企业详细住所**:对应上图中的**4**
 
         # @param request: Request instance for SyncProxyOrganization.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::SyncProxyOrganizationRequest`
@@ -2018,7 +2031,7 @@ module TencentCloud
 
         # 此接口（SyncProxyOrganizationOperators）用于同步 第三方平台子客企业经办人列表，主要是同步经办人的离职状态。子客Web控制台的组织架构管理，是依赖于第三方应用平台的，无法针对员工做新增/更新/离职等操作。
 
-        # - **新增员工的的场景**:    提前导入员工列表, 然后调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>分享给对应的员工进行实名, 新增员工后员工的状态为**未实名**, 通过链接实名后状态变为**已实名**, 已实名员工就可以参与合同的发起和签署
+        # - **新增员工的场景**:    提前导入员工列表, 然后调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>分享给对应的员工进行实名, 新增员工后员工的状态为**未实名**, 通过链接实名后状态变为**已实名**, 已实名员工就可以参与合同的发起和签署
 
         # - **员工离职的场景**: 将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了,   同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空,  再次加入公司会从零开始) ,  若员工信息有误可通过离职后在新增来解决,  离职员工状态为**离职**
 
@@ -2027,7 +2040,7 @@ module TencentCloud
         # **注**:
         # -  新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理
         # -  <font color='red'>超管和法人无法通过此接口离职</font>,  需要超管和法人将权限转移给其他人后才可通过此接口离职
-        # - 新增员工的的场景同ID不同员工会覆盖掉上一个同ID的员工, 如果上一个员工已经实名则不会被覆盖
+        # - 新增员工的场景同ID不同员工会覆盖掉上一个同ID的员工, 如果上一个员工已经实名则不会被覆盖
 
         # @param request: Request instance for SyncProxyOrganizationOperators.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::SyncProxyOrganizationOperatorsRequest`

data/lib/v20210526/models.rb

@@ -2982,12 +2982,14 @@ module TencentCloud
         # @type Limit: Integer
         # @param Filters: 查询的关键字段，支持Key-Values查询。可选键值如下：
         # <ul>
-        #   <li>Key:**"Status"**，根据实名状态查询员工，Values可选：
-        #     <ul><li>**["IsVerified"]**：查询已实名的员工</li><li>**["QuiteJob"]**：查询离职员工</li></ul></li>
-        #   <li>Key:**"StaffOpenId"**，根据第三方系统用户OpenId查询员工，Values为第三方系统用户OpenId列表：**["OpenId1","OpenId2",...]**</li>
+        #   <li>Key:**"Status"**，Values: **["IsVerified"]**, 查询已实名的员工</li>
+        #   <li>Key:**"Status"**，Values: **["QuiteJob"]**, 查询离职员工</li>
+        #   <li>Key:**"StaffOpenId"**，Values: **["OpenId1","OpenId2",...]**, 根据第三方系统用户OpenId查询员工</li>
         # </ul>
+        # 注: `同名字的Key的过滤条件会冲突,  只能填写一个`
         # @type Filters: Array
-        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页。页码从 0 开始，即首页为 0，最大20000。
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页。
+        # 页码从 0 开始，即首页为 0，最大20000。
         # @type Offset: Integer
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -7122,8 +7124,8 @@ module TencentCloud
         # @param SignerName: 申请证书的主体的名字
 
         # 如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下
-        # **企业**:  ESS@企业名称@编码
-        # **个人**: ESS@个人姓名@证件号@808854
+        # **企业**:  ESS@企业名称@平台生成的数字编码
+        # **个人**: ESS@个人姓名@证件号@平台生成的数字编码
 
         # 如果在其他平台签署的, 主体的名字参考其他平台的说明
         # @type SignerName: String
@@ -8010,30 +8012,43 @@ module TencentCloud
 
       # SyncProxyOrganization请求参数结构体
       class SyncProxyOrganizationRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用信息
-        # 此接口Agent.AppId、Agent.ProxyOrganizationOpenId必填
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.AppId</li>
+        # <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+        # </ul>
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param ProxyOrganizationName: 第三方平台子客企业名称，最大长度64个字符
+        # @param ProxyOrganizationName: 第三方平台子客企业名称，请确认该名称与企业营业执照中注册的名称一致。
+        # 注: `如果名称中包含英文括号()，请使用中文括号（）代替。`
         # @type ProxyOrganizationName: String
         # @param BusinessLicense: 营业执照正面照(PNG或JPG) base64格式, 大小不超过5M
         # @type BusinessLicense: String
         # @param UniformSocialCreditCode: 第三方平台子客企业统一社会信用代码，最大长度200个字符
         # @type UniformSocialCreditCode: String
-        # @param ProxyLegalName: 第三方平台子客企业法人/负责人姓名
+        # @param ProxyLegalName: 第三方平台子客企业法定代表人的名字
         # @type ProxyLegalName: String
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
-        # @param ProxyLegalIdCardType: 第三方平台子客企业法人/负责人证件类型，默认居民身份证（ID_CARD）类型，暂不支持其他类型
+        # @param ProxyLegalIdCardType: 第三方平台子客企业法定代表人的证件类型，支持以下类型
+        # <ul><li>ID_CARD : 居民身份证 (默认值)</li></ul>
+        # 注: `现在仅支持ID_CARD居民身份证类型`
         # @type ProxyLegalIdCardType: String
-        # @param ProxyLegalIdCardNumber: 第三方平台子客企业法人/负责人证件号
+        # @param ProxyLegalIdCardNumber: 第三方平台子客企业法定代表人的证件号码, 应符合以下规则
+        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
         # @type ProxyLegalIdCardNumber: String
+        # @param ProxyAddress: 第三方平台子客企业详细住所，最大长度500个字符
+
+        # 注：`需要符合省市区详情的格式例如： XX省XX市XX区街道具体地址`
+        # @type ProxyAddress: String
 
-        attr_accessor :Agent, :ProxyOrganizationName, :BusinessLicense, :UniformSocialCreditCode, :ProxyLegalName, :Operator, :ProxyLegalIdCardType, :ProxyLegalIdCardNumber
+        attr_accessor :Agent, :ProxyOrganizationName, :BusinessLicense, :UniformSocialCreditCode, :ProxyLegalName, :Operator, :ProxyLegalIdCardType, :ProxyLegalIdCardNumber, :ProxyAddress
         extend Gem::Deprecate
         deprecate :Operator, :none, 2023, 11
         deprecate :Operator=, :none, 2023, 11
 
-        def initialize(agent=nil, proxyorganizationname=nil, businesslicense=nil, uniformsocialcreditcode=nil, proxylegalname=nil, operator=nil, proxylegalidcardtype=nil, proxylegalidcardnumber=nil)
+        def initialize(agent=nil, proxyorganizationname=nil, businesslicense=nil, uniformsocialcreditcode=nil, proxylegalname=nil, operator=nil, proxylegalidcardtype=nil, proxylegalidcardnumber=nil, proxyaddress=nil)
           @Agent = agent
           @ProxyOrganizationName = proxyorganizationname
           @BusinessLicense = businesslicense
@@ -8042,6 +8057,7 @@ module TencentCloud
           @Operator = operator
           @ProxyLegalIdCardType = proxylegalidcardtype
           @ProxyLegalIdCardNumber = proxylegalidcardnumber
+          @ProxyAddress = proxyaddress
         end
 
         def deserialize(params)
@@ -8059,6 +8075,7 @@ module TencentCloud
           end
           @ProxyLegalIdCardType = params['ProxyLegalIdCardType']
           @ProxyLegalIdCardNumber = params['ProxyLegalIdCardNumber']
+          @ProxyAddress = params['ProxyAddress']
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-essbasic
 version: !ruby/object:Gem::Version
-  version: 3.0.694
+  version: 3.0.695
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-06 00:00:00.000000000 Z
+date: 2023-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common