tencentcloud-sdk-ess 3.0.660 → 3.0.662

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9eed30651867f40a38aa3196b66dabb8e2515a2b
-  data.tar.gz: 961e2478e0a7529f550a907ed111e5f2b7427354
+  metadata.gz: 405ece100c210c07ca12170473e6a139f6c2ebc6
+  data.tar.gz: a87239a5750fe47cef63eaa5fa4db194b85d1671
 SHA512:
-  metadata.gz: 0823a3c206f92087891e07317f92aeb3640e3adfe01012b76028820f66b9b27b8a7ee554b469a32a1badeae7d724e6052ff01812321a0f1dfb934700904248ac
-  data.tar.gz: 2813e4efbb3c840c2fd89654bf4f9791cd1193fc47b82a6cf086da6b0e4ca93a71a9df3fcde8bcce7a6ae3e7b0f763ded7929aae21affee8a719989e15e7745b
+  metadata.gz: a86fc6f889f465dde267ca1c31e30ea4e50f32ff60c68e748bd4b0204d0285e47d19cd51adc86c74957019bab1d445d421c01c17f11f1e7eb593d5c29b72b346
+  data.tar.gz: fd9e5329d024aa89190847b7f35b8878a2ace5fc4d1793d237c538c49dca4b6e6ff6c7655bd6a0eec7a81c66c64aaac50ed672b8786e294de0721330d7062664

data/lib/VERSION

@@ -1 +1 @@
-3.0.660
+3.0.662

data/lib/v20201111/client.rb

@@ -29,7 +29,7 @@ module TencentCloud
         end
 
 
-        # 将电子签系统员工userId与客户系统员工openId进行绑定
+        # 此接口（BindEmployeeUserIdWithClientOpenId）用于将电子签系统员工UserId与客户系统员工OpenId进行绑定。
 
         # @param request: Request instance for BindEmployeeUserIdWithClientOpenId.
         # @type request: :class:`Tencentcloud::ess::V20201111::BindEmployeeUserIdWithClientOpenIdRequest`
@@ -159,6 +159,36 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口，创建小程序批量签署链接，个人/企业员工点击此链接即可跳转小程序进行批量签署。
+        # 请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。
+
+        # 注：
+        # - 参与人点击链接后需短信验证码才能查看合同内容。
+        # - 企业用户批量签署，需要传OrganizationName（参与方所在企业名称）参数生成签署链接，`请确保此企业已完成腾讯电子签企业认证`。
+        # - 个人批量签署，签名区`仅支持手写签名`。
+
+        # @param request: Request instance for CreateBatchSignUrl.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateBatchSignUrlRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateBatchSignUrlResponse`
+        def CreateBatchSignUrl(request)
+          body = send_request('CreateBatchSignUrl', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateBatchSignUrlResponse.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
+
         # 此接口（CreateConvertTaskApi）用来将word、excel、图片、txt类型文件转换为PDF文件。<br />
         # 前提条件：源文件已经通过 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">文件上传接口</a>完成上传，并得到了源文件的资源Id。<br />
         # 适用场景1：已经上传了一个word文件，希望将该word文件转换成pdf文件后发起合同
@@ -451,10 +481,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 提交企业签署流程审批结果
-        # 适用场景:
-        # 在通过接口(CreateFlow 或者CreateFlowByFiles)创建签署流程时，若指定了参数 NeedSignReview 为true，且发起方企业作为签署方参与了流程签署，则可以调用此接口提交企业内部签署审批结果。
-        # 若签署流程状态正常，且本企业存在签署方未签署，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
+        # 提交签署流程审批结果的适用场景包括：
+        # 1. 在使用模板（CreateFlow）或文件（CreateFlowByFiles）创建签署流程时，若指定了参数NeedSignReview为true，且发起方企业作为签署方参与了流程签署，则可以调用此接口提交企业内部签署审批结果。自动签署也需要进行审核通过才会进行签署。
+        # 2. 若签署流程状态正常，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
 
         # @param request: Request instance for CreateFlowSignReview.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowSignReviewRequest`
@@ -509,7 +538,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过此接口，创建企业的部门，支持绑定客户系统部门ID。
+        # 此接口（CreateIntegrationDepartment）用于创建企业的部门信息，支持绑定客户系统部门ID。
 
         # @param request: Request instance for CreateIntegrationDepartment.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateIntegrationDepartmentRequest`
@@ -533,8 +562,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建员工,此接口会发送提醒员工实名的短信，如果通过手机号发现员工已经创建，则不会重新创建，会发送短信提醒员工实名
-        # 注意：此接口支持企微组织架构的 openid 创建员工，这种场景下传递明文的企微 openid 到WeworkOpenId字段即可（企微明文的 openid 一定要在应用的可见范围内才行），通过企微创建的员工，会发送企微消息去提醒实名
+        # 此接口（CreateIntegrationEmployees）用于创建企业员工。调用成功后会给员工发送提醒员工实名的短信。若通过手机号发现员工已经创建，则不会重新创建，但会发送短信提醒员工实名。另外，此接口还支持通过企微组织架构的openid 创建员工（将WeworkOpenId字段设置为企微员工明文的openid，但需确保该企微员工在应用的可见范围内），该场景下，员工会接收到提醒实名的企微消息。
 
         # @param request: Request instance for CreateIntegrationEmployees.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateIntegrationEmployeesRequest`
@@ -934,7 +962,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过此接口，删除企业的部门。
+        # 此接口（DeleteIntegrationDepartment）用于删除企业的部门信息。
 
         # @param request: Request instance for DeleteIntegrationDepartment.
         # @type request: :class:`Tencentcloud::ess::V20201111::DeleteIntegrationDepartmentRequest`
@@ -958,10 +986,11 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 移除员工
-        # 这里分两个场景
-        # 如果不传交接人的ReceiveUserId或者ReceiveOpenId，则会直接把这个人进行离职
-        # 如果传了交接人，会把离职人未处理完的合同交接给交接人后再离职
+        # 该接口（DeleteIntegrationEmployees）用于移除企业员工，同时可选择是否进行离职交接。
+        # -  如果不设置交接人的ReceiveUserId或ReceiveOpenId，则该员工将被直接移除而不进行交接操作。
+        # -  如果设置了ReceiveUserId或ReceiveOpenId，该员工未处理的合同将会被系统交接给设置的交接人，然后再对该员工进行离职操作。
+
+        # 注：`1. 超管或法人身份的员工不能被删除。2. 员工存在待处理合同且无人交接时不能被删除。`
 
         # @param request: Request instance for DeleteIntegrationEmployees.
         # @type request: :class:`Tencentcloud::ess::V20201111::DeleteIntegrationEmployeesRequest`
@@ -1231,7 +1260,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过此接口，查询企业的部门，支持查询单个部门节点或单个部门节点及一级子节点部门列表。
+        # 此接口（DescribeIntegrationDepartments）用于查询企业的部门信息列表，支持查询单个部门节点或单个部门节点及一级子节点部门列表。
 
         # @param request: Request instance for DescribeIntegrationDepartments.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationDepartmentsRequest`
@@ -1255,7 +1284,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查询企业员工列表，每次返回的数据量最大为20
+        # 此接口（DescribeIntegrationEmployees）用于分页查询企业员工信息列表，支持设置过滤条件以筛选员工查询结果。
 
         # @param request: Request instance for DescribeIntegrationEmployees.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationEmployeesRequest`
@@ -1305,7 +1334,8 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 此API接口用户查询加入集团的成员企业
+        # 此API接口用来查询加入集团的成员企业信息
+        # 适用场景：子企业在加入集团后，主企业可能通过此接口获取到所有的子企业列表，方便进行展示和统计
 
         # @param request: Request instance for DescribeOrganizationGroupOrganizations.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeOrganizationGroupOrganizationsRequest`
@@ -1493,7 +1523,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过此接口，更新企业的部门信息，支持更新部门名、客户系统部门ID、部门序列号。
+        # 此接口（ModifyIntegrationDepartment）用于更新企业的部门信息，支持更新部门名称、客户系统部门ID和部门序号等信息。
 
         # @param request: Request instance for ModifyIntegrationDepartment.
         # @type request: :class:`Tencentcloud::ess::V20201111::ModifyIntegrationDepartmentRequest`
@@ -1577,7 +1607,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 将存在绑定关系的电子签系统员工userId与客户系统员工openId进行解绑
+        # 此接口（UnbindEmployeeUserIdWithClientOpenId）用于解除电子签系统员工UserId与客户系统员工OpenId之间的绑定关系。
+
+        # 注：`在调用此接口时，需确保OpenId已通过调用`<a href="https://qian.tencent.com/developers/companyApis/staffs/BindEmployeeUserIdWithClientOpenId" target="_blank">BindEmployeeUserIdWithClientOpenId</a>`接口与电子签系统的UserId绑定过。若OpenId未经过绑定，则无法使用此接口进行解绑操作。`
 
         # @param request: Request instance for UnbindEmployeeUserIdWithClientOpenId.
         # @type request: :class:`Tencentcloud::ess::V20201111::UnbindEmployeeUserIdWithClientOpenIdRequest`

data/lib/v20201111/models.rb

@@ -22,7 +22,9 @@ module TencentCloud
         # @param Name: 超管名
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Name: String
-        # @param Mobile: 超管手机号
+        # @param Mobile: 超管手机号，打码显示
+        # 示例值：138****1569
+
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Mobile: String
 
@@ -377,13 +379,16 @@ module TencentCloud
 
       # BindEmployeeUserIdWithClientOpenId请求参数结构体
       class BindEmployeeUserIdWithClientOpenIdRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 用户信息，OpenId与UserId二选一必填一个，OpenId是第三方客户ID，userId是用户实名后的电子签生成的ID,当传入客户系统openId，传入的openId需与电子签员工userId绑定，且参数Channel必填，Channel值为INTEGRATE；当传入参数UserId，Channel无需指定。（参数参考示例）
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param UserId: 电子签系统员工UserId
+        # @param UserId: 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)；或者通过<a href="https://qian.tencent.com/developers/companyApis/staffs/DescribeIntegrationEmployees" target="_blank">DescribeIntegrationEmployees</a>接口获取。
         # @type UserId: String
-        # @param OpenId: 客户系统OpenId
+        # @param OpenId: 员工在贵司业务系统中的唯一身份标识，用于与腾讯电子签账号进行映射，确保在同一企业内不会出现重复。 该标识最大长度为64位字符串，仅支持包含26个英文字母和数字0-9的字符。
         # @type OpenId: String
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :UserId, :OpenId, :Agent
@@ -411,7 +416,8 @@ module TencentCloud
 
       # BindEmployeeUserIdWithClientOpenId返回参数结构体
       class BindEmployeeUserIdWithClientOpenIdResponse < TencentCloud::Common::AbstractModel
-        # @param Status: 绑定是否成功，1表示成功，0表示失败
+        # @param Status: 绑定是否成功。
+        # <ul><li>**0**：失败</li><li>**1**：成功</li></ul>
         # @type Status: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -1057,6 +1063,130 @@ module TencentCloud
         end
       end
 
+      # CreateBatchSignUrl请求参数结构体
+      class CreateBatchSignUrlRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Name: 签署方经办人的姓名。
+        # 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
+
+        # 注：`请确保和合同中填入的一致`
+        # @type Name: String
+        # @param Mobile: 手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
+        # 请确认手机号所有方为此业务通知方。
+
+        # 注：`请确保和合同中填入的一致,  若无法保持一致，请确保在发起和生成批量签署链接时传入相同的参与方证件信息`
+        # @type Mobile: String
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param IdCardType: 证件类型，支持以下类型
+        # <ul><li>ID_CARD : 居民身份证 (默认值)</li>
+        # <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+        # <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
+
+        # 注：`请确保和合同中填入的一致`
+        # @type IdCardType: String
+        # @param IdCardNumber: 证件号码，应符合以下规则
+        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+        # <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+        # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
+
+        # 注：`请确保和合同中填入的一致`
+        # @type IdCardNumber: String
+        # @param NotifyType: 通知用户方式：
+        # <ul>
+        # <li>**NONE** : 不通知（默认）</li>
+        # <li>**SMS** : 短信通知（发送短信通知到Mobile参数所传的手机号）</li>
+        # </ul>
+        # @type NotifyType: String
+        # @param FlowIds: 本次需要批量签署的合同流程ID列表。
+        # 可以不传,  如不传则是发给对方的所有待签署合同流程。
+        # @type FlowIds: Array
+        # @param OrganizationName: 目标签署人的企业名称，签署人如果是企业员工身份，需要传此参数。
+
+        # 注：
+        # <ul>
+        # <li>请确认该名称与企业营业执照中注册的名称一致。</li>
+        # <li>如果名称中包含英文括号()，请使用中文括号（）代替。</li>
+        # <li>请确保此企业已完成腾讯电子签企业认证。</li>
+        # </ul>
+        # @type OrganizationName: String
+        # @param JumpToDetail: 是否直接跳转至合同内容页面进行签署
+        # <ul>
+        # <li>**false**: 会跳转至批量合同流程的列表,  点击需要批量签署合同后进入合同内容页面进行签署(默认)</li>
+        # <li>**true**: 跳过合同流程列表, 直接进入合同内容页面进行签署</li>
+        # </ul>
+        # @type JumpToDetail: Boolean
+
+        attr_accessor :Operator, :Name, :Mobile, :Agent, :IdCardType, :IdCardNumber, :NotifyType, :FlowIds, :OrganizationName, :JumpToDetail
+
+        def initialize(operator=nil, name=nil, mobile=nil, agent=nil, idcardtype=nil, idcardnumber=nil, notifytype=nil, flowids=nil, organizationname=nil, jumptodetail=nil)
+          @Operator = operator
+          @Name = name
+          @Mobile = mobile
+          @Agent = agent
+          @IdCardType = idcardtype
+          @IdCardNumber = idcardnumber
+          @NotifyType = notifytype
+          @FlowIds = flowids
+          @OrganizationName = organizationname
+          @JumpToDetail = jumptodetail
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @Name = params['Name']
+          @Mobile = params['Mobile']
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @IdCardType = params['IdCardType']
+          @IdCardNumber = params['IdCardNumber']
+          @NotifyType = params['NotifyType']
+          @FlowIds = params['FlowIds']
+          @OrganizationName = params['OrganizationName']
+          @JumpToDetail = params['JumpToDetail']
+        end
+      end
+
+      # CreateBatchSignUrl返回参数结构体
+      class CreateBatchSignUrlResponse < TencentCloud::Common::AbstractModel
+        # @param SignUrl: 批量签署链接，以短链形式返回，短链的有效期参考回参中的 ExpiredTime。
+
+        # 注: `非小程序和APP集成使用`
+        # @type SignUrl: String
+        # @param ExpiredTime: 链接过期时间以 Unix 时间戳格式表示，默认生成链接时间起，往后7天有效期。过期后短链将失效，无法打开。
+        # @type ExpiredTime: Integer
+        # @param MiniAppPath: 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
+
+        # 注: `小程序和APP集成使用`
+        # @type MiniAppPath: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :SignUrl, :ExpiredTime, :MiniAppPath, :RequestId
+
+        def initialize(signurl=nil, expiredtime=nil, miniapppath=nil, requestid=nil)
+          @SignUrl = signurl
+          @ExpiredTime = expiredtime
+          @MiniAppPath = miniapppath
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @SignUrl = params['SignUrl']
+          @ExpiredTime = params['ExpiredTime']
+          @MiniAppPath = params['MiniAppPath']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateConvertTaskApi请求参数结构体
       class CreateConvertTaskApiRequest < TencentCloud::Common::AbstractModel
         # @param ResourceType: 需要进行转换的资源文件类型
@@ -2136,30 +2266,33 @@ module TencentCloud
 
       # CreateFlowSignReview请求参数结构体
       class CreateFlowSignReviewRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowId: 签署流程编号
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+        # 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         # @type FlowId: String
-        # @param ReviewType: 企业内部审核结果
-        # PASS: 通过
-        # REJECT: 拒绝
+        # @param ReviewType: 企业审核结果
+        # <ul><li>PASS: 通过</li>
+        # <li>REJECT: 拒绝</li></ul>
         # @type ReviewType: String
-        # @param ReviewMessage: 审核原因
-        # 当ReviewType 是REJECT 时此字段必填,字符串长度不超过200
+        # @param ReviewMessage: 审核结果原因，
+        # 字符串长度不超过200
+        # 当ReviewType 是拒绝（REJECT） 时此字段必填。
         # @type ReviewMessage: String
         # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param RecipientId: 审核签署节点使用 非必填 如果填写则审核该签署节点。给个人审核时必填。
+        # @param RecipientId: 审核签署节点人标识，
+        # 用来标识审核的签署方。
+        # 如果签署审核节点是个人， 此参数必填。
         # @type RecipientId: String
-        # @param OperateType: 操作类型：（接口通过该字段区分操作类型）
+        # @param OperateType: 操作类型：（接口通过该字段区分不同的操作类型）
 
-        # SignReview:签署审核
-        # CreateReview:发起审核
+        # <ul><li>SignReview: 签署审核（默认）</li>
+        # <li>CreateReview: 创建审核</li></ul>
 
-        # 默认：SignReview；SignReview:签署审核
-
-        # 该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程
-        # 若发起个人审核，则指定该字段为：SignReview
+        # 如果审核节点是个人，则操作类型只能为SignReview。
         # @type OperateType: String
 
         attr_accessor :Operator, :FlowId, :ReviewType, :ReviewMessage, :Agent, :RecipientId, :OperateType
@@ -2302,18 +2435,19 @@ module TencentCloud
         # @param Operator: 执行本接口操作的员工信息。
         # 注: `在调用此接口时，请确保指定的员工已获得组织架构管理权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param DeptName: 部门名称，不超过50个字符
+        # @param DeptName: 部门名称，最大长度为50个字符。
         # @type DeptName: String
-        # @param Agent: 代理企业和员工的信息。
-        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param ParentDeptId: 电子签父部门ID，与ParentDeptOpenId二选一,优先ParentDeptId,都为空时自动填充至根节点下
+        # @param ParentDeptId: 电子签父部门ID。
+        # 注：`如果同时指定了ParentDeptId与ParentDeptOpenId参数，系统将优先使用ParentDeptId。当二者都未指定时，创建的新部门将自动填充至根节点部门下。`
         # @type ParentDeptId: String
-        # @param ParentDeptOpenId: 第三方平台中父部门ID,与ParentDeptId二选一,优先ParentDeptId,都为空时自动填充至根节点下
+        # @param ParentDeptOpenId: 第三方平台中父部门ID。
+        # 注：`如果同时指定了ParentDeptId与ParentDeptOpenId参数，系统将优先使用ParentDeptId。当二者都未指定时，创建的新部门将自动填充至根节点部门下。`
         # @type ParentDeptOpenId: String
-        # @param DeptOpenId: 客户系统部门ID，不超过64个字符
+        # @param DeptOpenId: 客户系统部门ID，最大长度为64个字符。
         # @type DeptOpenId: String
-        # @param OrderNo: 排序号,1~30000范围内
+        # @param OrderNo: 排序号，支持设置的数值范围为1~30000。同一父部门下，排序号越大，部门顺序越靠前。
         # @type OrderNo: Integer
 
         attr_accessor :Operator, :DeptName, :Agent, :ParentDeptId, :ParentDeptOpenId, :DeptOpenId, :OrderNo
@@ -2347,7 +2481,7 @@ module TencentCloud
 
       # CreateIntegrationDepartment返回参数结构体
       class CreateIntegrationDepartmentResponse < TencentCloud::Common::AbstractModel
-        # @param DeptId: 电子签部门ID
+        # @param DeptId: 电子签部门ID。建议开发者保存此部门ID，方便后续查询或修改部门信息。
         # @type DeptId: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -2367,13 +2501,15 @@ module TencentCloud
 
       # CreateIntegrationEmployees请求参数结构体
       class CreateIntegrationEmployeesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，userId必填
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Employees: 待创建员工的信息，不超过20个。
-        # 所有类型的企业支持的入参：Mobile和DisplayName必填,OpenId、Email和Department.DepartmentId选填，其他字段暂不支持。
-        # 企微类型的企业特有支持的入参：WeworkOpenId，传入此字段无需在传入其他信息
+        # @param Employees: 待创建员工的信息，最多不超过20个。
+        # 其中入参Mobile和DisplayName必填，OpenId、Email和Department.DepartmentId选填，其他字段暂不支持设置。
+        # 在创建企微企业员工场景下，只需传入WeworkOpenId，无需再传其他信息。
         # @type Employees: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :Employees, :Agent
@@ -2406,7 +2542,7 @@ module TencentCloud
 
       # CreateIntegrationEmployees返回参数结构体
       class CreateIntegrationEmployeesResponse < TencentCloud::Common::AbstractModel
-        # @param CreateEmployeeResult: 创建员工的结果
+        # @param CreateEmployeeResult: 创建员工的结果。包含创建成功的数据与创建失败数据。
         # @type CreateEmployeeResult: :class:`Tencentcloud::Ess.v20201111.models.CreateStaffResult`
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -3714,12 +3850,13 @@ module TencentCloud
         # @param Operator: 执行本接口操作的员工信息。
         # 注: `在调用此接口时，请确保指定的员工已获得组织架构管理权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param DeptId: 电子签中的部门id,通过DescribeIntegrationDepartments接口可获得
+        # @param DeptId: 电子签中的部门ID，通过<a href="https://qian.tencent.com/developers/companyApis/organizations/DescribeIntegrationDepartments" target="_blank">DescribeIntegrationDepartments</a>接口可获得。
         # @type DeptId: String
         # @param Agent: 代理企业和员工的信息。
         # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param ReceiveDeptId: 交接部门ID。待删除部门中的合同、印章和模板数据，交接至该部门ID下，未填写交接至公司根部门。
+        # @param ReceiveDeptId: 交接部门ID。
+        # 待删除部门中的合同、印章和模板数据，将会被交接至该部门ID下；若未填写则交接至公司根部门。
         # @type ReceiveDeptId: String
 
         attr_accessor :Operator, :DeptId, :Agent, :ReceiveDeptId
@@ -3763,11 +3900,15 @@ module TencentCloud
 
       # DeleteIntegrationEmployees请求参数结构体
       class DeleteIntegrationEmployeesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，userId必填
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Employees: 待移除员工的信息，userId和openId二选一，必填一个，如果需要指定交接人的话，ReceiveUserId或者ReceiveOpenId字段二选一
+        # @param Employees: 待移除员工的信息。应符合以下规则：
+        # <ul><li>UserId和OpenId不可同时为空。</li>
+        # <li>若需要进行离职交接，交接人信息ReceiveUserId和ReceiveOpenId不可同时为空。否则视为不进行离职交接。</li></ul>
         # @type Employees: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId需填充子企业Id
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :Employees, :Agent
@@ -3800,7 +3941,9 @@ module TencentCloud
 
       # DeleteIntegrationEmployees返回参数结构体
       class DeleteIntegrationEmployeesResponse < TencentCloud::Common::AbstractModel
-        # @param DeleteEmployeeResult: 员工删除数据
+        # @param DeleteEmployeeResult: 员工删除结果。包含成功数据与失败数据。
+        # <ul><li>**成功数据**：展示员工姓名、手机号与电子签平台UserId</li>
+        # <li>**失败数据**：展示员工电子签平台UserId、第三方平台OpenId和失败原因</li></ul>
         # @type DeleteEmployeeResult: :class:`Tencentcloud::Ess.v20201111.models.DeleteStaffsResult`
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -3972,11 +4115,11 @@ module TencentCloud
         end
       end
 
-      # 集成版员工部门信息
+      # 集成版员工部门信息。
       class Department < TencentCloud::Common::AbstractModel
-        # @param DepartmentId: 部门id
+        # @param DepartmentId: 部门ID。
         # @type DepartmentId: String
-        # @param DepartmentName: 部门名称
+        # @param DepartmentName: 部门名称。
         # @type DepartmentName: String
 
         attr_accessor :DepartmentId, :DepartmentName
@@ -4538,14 +4681,18 @@ module TencentCloud
         # @param Operator: 执行本接口操作的员工信息。
         # 注: `在调用此接口时，请确保指定的员工已获得组织架构管理权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param QueryType: 查询类型 0-查询单个部门节点 1-单个部门节点及一级子节点部门列表
+        # @param QueryType: 查询类型，支持以下类型：
+        # <ul><li>**0**：查询单个部门节点列表，不包含子节点部门信息</li>
+        # <li>**1**：查询单个部门节点级一级子节点部门信息列表</li></ul>
         # @type QueryType: Integer
         # @param Agent: 代理企业和员工的信息。
         # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param DeptId: 部门ID,与DeptOpenId二选一,优先DeptId,都为空时获取根节点数据
+        # @param DeptId: 查询的部门ID。
+        # 注：`如果同时指定了DeptId与DeptOpenId参数，系统将优先使用DeptId参数进行查询。当二者都未指定时，系统将返回根节点部门数据。`
         # @type DeptId: String
-        # @param DeptOpenId: 客户系统部门ID,与DeptId二选一,优先DeptId,都为空时获取根节点数据
+        # @param DeptOpenId: 查询的客户系统部门ID。
+        # 注：`如果同时指定了DeptId与DeptOpenId参数，系统将优先使用DeptId参数进行查询。当二者都未指定时，系统将返回根节点部门数据。`
         # @type DeptOpenId: String
 
         attr_accessor :Operator, :QueryType, :Agent, :DeptId, :DeptOpenId
@@ -4575,7 +4722,7 @@ module TencentCloud
 
       # DescribeIntegrationDepartments返回参数结构体
       class DescribeIntegrationDepartmentsResponse < TencentCloud::Common::AbstractModel
-        # @param Departments: 部门列表
+        # @param Departments: 部门信息列表。部门信息根据部门排序号OrderNo降序排列，根据部门创建时间升序排列。
         # @type Departments: Array
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -4602,18 +4749,25 @@ module TencentCloud
 
       # DescribeIntegrationEmployees请求参数结构体
       class DescribeIntegrationEmployeesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，userId必填
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Limit: 指定每页多少条数据，单页最大20
+        # @param Limit: 指定分页每页返回的数据条数，单页最大支持 20。
         # @type Limit: Integer
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param Filters: 查询过滤实名用户，Key为Status，Values为["IsVerified"]，查询过滤未实名用户，Key为Status，Values为["NotVerified"]
-        # 查询某个部门的用户，Key为DepartmentId，Values为["DepartmentId"]
-        # 根据用户Id查询员工时，Key为UserId，Values为["UserId"]
-        # 根据第三方系统openId过滤查询员工时,Key为StaffOpenId,Values为["OpenId","OpenId",...]
+        # @param Filters: 查询的关键字段，支持Key-Values查询。可选键值如下：
+        # <ul>
+        #   <li>Key:**"Status"**，根据实名状态查询员工，Values可选：
+        #     <ul><li>**["IsVerified"]**：查询已实名的员工</li><li>**["NotVerified"]**：查询未实名的员工</li></ul></li>
+        #   <li>Key:**"DepartmentId"**，根据部门ID查询部门下的员工，Values为指定的部门ID：**["DepartmentId"]**</li>
+        #   <li>Key:**"UserId"**，根据用户ID查询员工，Values为指定的用户ID：**["UserId"]**</li>
+        #   <li>Key:**"UserWeWorkOpenId"**，根据用户企微账号ID查询员工，Values为指定用户的企微账号ID：**["UserWeWorkOpenId"]**</li>
+        #   <li>Key:**"StaffOpenId"**，根据第三方系统用户OpenId查询员工，Values为第三方系统用户OpenId列表：**["OpenId1","OpenId2",...]**</li>
+        # </ul>
         # @type Filters: Array
-        # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大20000
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页。页码从 0 开始，即首页为 0，最大20000。
         # @type Offset: Integer
 
         attr_accessor :Operator, :Limit, :Agent, :Filters, :Offset
@@ -4650,15 +4804,15 @@ module TencentCloud
 
       # DescribeIntegrationEmployees返回参数结构体
       class DescribeIntegrationEmployeesResponse < TencentCloud::Common::AbstractModel
-        # @param Employees: 员工数据列表
+        # @param Employees: 员工信息列表。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Employees: Array
-        # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大20000
+        # @param Offset: 指定分页返回第几页的数据。页码从 0 开始，即首页为 0，最大20000。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Offset: Integer
-        # @param Limit: 指定每页多少条数据，单页最大20
+        # @param Limit: 指定分页每页返回的数据条数，单页最大支持 20。
         # @type Limit: Integer
-        # @param TotalCount: 符合条件的员工数量
+        # @param TotalCount: 符合条件的员工数量。
         # @type TotalCount: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -4788,19 +4942,28 @@ module TencentCloud
 
       # DescribeOrganizationGroupOrganizations请求参数结构体
       class DescribeOrganizationGroupOrganizationsRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，userId必填
+        # @param Operator: 执行本接口操作的员工信息,userId必填。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Limit: 指定每页多少条数据，单页最大1000
+        # @param Limit: 指定分页每页返回的数据条数，单页最大1000
         # @type Limit: Integer
-        # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页，页码从 0 开始，即首页为 0
         # @type Offset: Integer
         # @param Name: 查询成员企业的企业名，模糊匹配
         # @type Name: String
-        # @param Status: 成员企业加入集团的当前状态:1-待授权;2-已授权待激活;3-拒绝授权;4-已解除;5-已加入
+        # @param Status: 成员企业加入集团的当前状态
+        # <ul><li> **1**：待授权</li>
+        # <li> **2**：已授权待激活</li>
+        # <li> **3**：拒绝授权</li>
+        # <li> **4**：已解除</li>
+        # <li> **5**：已加入</li>
+        # </ul>
         # @type Status: Integer
         # @param Export: 是否导出当前成员企业数据
+        # <ul><li> **false**：不导出（默认值）</li>
+        # <li> **true**：导出</li></ul>
         # @type Export: Boolean
-        # @param Id: 成员企业机构 ID，在PC控制台 集团管理可获取
+        # @param Id: 成员企业机构 ID，32 位字符串，在PC控制台 集团管理可获取
         # @type Id: String
 
         attr_accessor :Operator, :Limit, :Offset, :Name, :Status, :Export, :Id
@@ -4831,10 +4994,10 @@ module TencentCloud
 
       # DescribeOrganizationGroupOrganizations返回参数结构体
       class DescribeOrganizationGroupOrganizationsResponse < TencentCloud::Common::AbstractModel
-        # @param Total: 查询到的符合条件的成员企业总数量
+        # @param Total: 符合查询条件的资源实例总数量。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Total: Integer
-        # @param JoinedTotal: 已授权待激活的企业数量
+        # @param JoinedTotal: 已授权待激活的子企业总数量
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type JoinedTotal: Integer
         # @param ActivedTotal: 已加入的企业数量(废弃,请使用ActivatedTotal)
@@ -4846,7 +5009,7 @@ module TencentCloud
         # @param List: 成员企业信息列表
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type List: Array
-        # @param ActivatedTotal: 已加入的企业数量
+        # @param ActivatedTotal: 已加入的子企业总数量
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ActivatedTotal: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -5331,11 +5494,12 @@ module TencentCloud
       class FailedUpdateStaffData < TencentCloud::Common::AbstractModel
         # @param DisplayName: 用户传入的名称
         # @type DisplayName: String
-        # @param Mobile: 用户传入的手机号
+        # @param Mobile: 用户传入的手机号，明文展示
         # @type Mobile: String
         # @param Reason: 失败原因
         # @type Reason: String
-        # @param UserId: 用户Id
+        # @param UserId: 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
         # @type UserId: String
         # @param OpenId: 员工在第三方平台的openId
         # @type OpenId: String
@@ -6445,13 +6609,20 @@ module TencentCloud
         # @param Alias: 成员企业别名
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Alias: String
-        # @param OrganizationId: 成员企业id
+        # @param OrganizationId: 成员企业id，为 32 位字符串，可在电子签PC 控制台，企业设置->企业电子签账号 获取
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type OrganizationId: String
-        # @param UpdateTime: 更新时间，时间戳，单位秒
+        # @param UpdateTime: 记录更新时间， unix时间戳，单位秒
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type UpdateTime: Integer
-        # @param Status: 成员企业加入集团的当前状态:1-待授权;2-已授权待激活;3-拒绝授权;4-已解除;5-已加入
+        # @param Status: 成员企业加入集团的当前状态
+        # <ul><li> **1**：待授权</li>
+        # <li> **2**：已授权待激活</li>
+        # <li> **3**：拒绝授权</li>
+        # <li> **4**：已解除</li>
+        # <li> **5**：已加入</li>
+        # </ul>
+
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Status: Integer
         # @param IsMainOrganization: 是否为集团主企业
@@ -6463,16 +6634,18 @@ module TencentCloud
         # @param AdminInfo: 企业超管信息
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type AdminInfo: :class:`Tencentcloud::Ess.v20201111.models.Admin`
-        # @param License: 企业许可证
+        # @param License: 企业许可证Id，此字段暂时不需要关注
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type License: String
-        # @param LicenseExpireTime: 企业许可证过期时间，时间戳，单位秒
+        # @param LicenseExpireTime: 企业许可证过期时间，unix时间戳，单位秒
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type LicenseExpireTime: Integer
-        # @param JoinTime: 成员企业加入集团时间，时间戳，单位秒
+        # @param JoinTime: 成员企业加入集团时间，unix时间戳，单位秒
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type JoinTime: Integer
-        # @param FlowEngineEnable: 是否使用自建审批流引擎（即不是企微审批流引擎），true-是，false-否
+        # @param FlowEngineEnable: 是否使用自建审批流引擎（即不是企微审批流引擎）
+        # <ul><li> **true**：是</li>
+        # <li> **false**：否</li></ul>
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowEngineEnable: Boolean
 
@@ -6587,10 +6760,10 @@ module TencentCloud
 
       # 部门信息
       class IntegrationDepartment < TencentCloud::Common::AbstractModel
-        # @param DeptId: 部门ID
+        # @param DeptId: 部门ID。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type DeptId: String
-        # @param DeptName: 部门名
+        # @param DeptName: 部门名。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type DeptName: String
         # @param ParentDeptId: 父部门ID
@@ -6599,7 +6772,7 @@ module TencentCloud
         # @param DeptOpenId: 客户系统部门ID
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type DeptOpenId: String
-        # @param OrderNo: 序列号
+        # @param OrderNo: 序列号。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type OrderNo: Integer
 
@@ -6684,18 +6857,18 @@ module TencentCloud
         # @param Operator: 执行本接口操作的员工信息。
         # 注: `在调用此接口时，请确保指定的员工已获得组织架构管理权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param DeptId: 电子签部门ID,通过DescribeIntegrationDepartments接口可以获取
+        # @param DeptId: 电子签部门ID，通过<a href="https://qian.tencent.com/developers/companyApis/organizations/DescribeIntegrationDepartments" target="_blank">DescribeIntegrationDepartments</a>接口获得。
         # @type DeptId: String
         # @param Agent: 代理企业和员工的信息。
         # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param ParentDeptId: 电子签父部门ID，通过DescribeIntegrationDepartments接口可以获取
+        # @param ParentDeptId: 电子签父部门ID，通过<a href="https://qian.tencent.com/developers/companyApis/organizations/DescribeIntegrationDepartments" target="_blank">DescribeIntegrationDepartments</a>接口获得。
         # @type ParentDeptId: String
-        # @param DeptName: 部门名称，不超过50个字符
+        # @param DeptName: 部门名称，最大长度为50个字符。
         # @type DeptName: String
-        # @param DeptOpenId: 客户系统部门ID，不超过64个字符
+        # @param DeptOpenId: 客户系统部门ID，最大长度为64个字符。
         # @type DeptOpenId: String
-        # @param OrderNo: 排序号,1~30000范围内
+        # @param OrderNo: 排序号，支持设置的数值范围为1~30000。同一父部门下，排序号越大，部门顺序越靠前。
         # @type OrderNo: Integer
 
         attr_accessor :Operator, :DeptId, :Agent, :ParentDeptId, :DeptName, :DeptOpenId, :OrderNo
@@ -7452,50 +7625,52 @@ module TencentCloud
         end
       end
 
-      # 企业员工信息
+      # 企业员工信息。
       class Staff < TencentCloud::Common::AbstractModel
-        # @param UserId: 用户在电子签平台的id
-        # 注：创建和更新场景无需填写
+        # @param UserId: 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 注：`创建和更新场景无需填写。`
         # @type UserId: String
-        # @param DisplayName: 显示的用户名/昵称
+        # @param DisplayName: 显示的用户名/昵称。
         # @type DisplayName: String
-        # @param Mobile: 用户手机号
+        # @param Mobile: 用户手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
         # @type Mobile: String
-        # @param Email: 用户邮箱
+        # @param Email: 用户邮箱。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Email: String
-        # @param OpenId: 用户在第三方平台id，如需在此接口提醒员工实名，该参数不传
+        # @param OpenId: 用户在第三方平台ID。
+        # 注：`如需在此接口提醒员工实名，该参数不传。`
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type OpenId: String
-        # @param Roles: 员工角色
-        # 注：创建和更新场景无需填写
+        # @param Roles: 员工角色信息。
+        # 注：`创建和更新场景无需填写。`
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Roles: Array
-        # @param Department: 员工部门
+        # @param Department: 员工部门信息。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Department: :class:`Tencentcloud::Ess.v20201111.models.Department`
-        # @param Verified: 员工是否实名
-        # 注：创建和更新场景无需填写
+        # @param Verified: 员工是否实名。
+        # 注：`创建和更新场景无需填写。`
         # @type Verified: Boolean
-        # @param CreatedOn: 员工创建时间戳，单位秒
-        # 注：创建和更新场景无需填写
+        # @param CreatedOn: 员工创建时间戳，单位秒。
+        # 注：`创建和更新场景无需填写。`
         # @type CreatedOn: Integer
-        # @param VerifiedOn: 员工实名时间戳，单位秒
-        # 注：创建和更新场景无需填写
+        # @param VerifiedOn: 员工实名时间戳，单位秒。
+        # 注：`创建和更新场景无需填写。`
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type VerifiedOn: Integer
-        # @param QuiteJob: 员工是否离职：0-未离职，1-离职
-        # 注：创建和更新场景无需填写
+        # @param QuiteJob: 员工是否离职：
+        # <ul><li>**0**：未离职</li><li>**1**：离职</li></ul>
+        # 注：`创建和更新场景无需填写。`
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type QuiteJob: Integer
-        # @param ReceiveUserId: 员工离职交接人用户id
-        # 注：创建和更新场景无需填写
+        # @param ReceiveUserId: 员工离职交接人用户ID。
+        # 注：`创建和更新场景无需填写。`
         # @type ReceiveUserId: String
-        # @param ReceiveOpenId: 员工离职交接人用户OpenId
-        # 注：创建和更新场景无需填写
+        # @param ReceiveOpenId: 员工离职交接人用户OpenId。
+        # 注：`创建和更新场景无需填写。`
         # @type ReceiveOpenId: String
-        # @param WeworkOpenId: 企业微信用户账号ID
-        # 注：仅企微类型的企业创建员工接口支持该字段
+        # @param WeworkOpenId: 企业微信用户账号ID。
+        # 注：`仅企微类型的企业创建员工接口支持该字段。`
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type WeworkOpenId: String
 
@@ -7546,12 +7721,12 @@ module TencentCloud
         end
       end
 
-      # 集成版企业角色信息
+      # 集成版企业角色信息。
       class StaffRole < TencentCloud::Common::AbstractModel
-        # @param RoleId: 角色id
+        # @param RoleId: 角色ID。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type RoleId: String
-        # @param RoleName: 角色名称
+        # @param RoleName: 角色名称。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type RoleName: String
 
@@ -7698,9 +7873,10 @@ module TencentCloud
       class SuccessUpdateStaffData < TencentCloud::Common::AbstractModel
         # @param DisplayName: 传入的用户名称
         # @type DisplayName: String
-        # @param Mobile: 传入的手机号
+        # @param Mobile: 传入的手机号，没有打码
         # @type Mobile: String
-        # @param UserId: 用户Id
+        # @param UserId: 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
         # @type UserId: String
 
         attr_accessor :DisplayName, :Mobile, :UserId
@@ -7893,13 +8069,17 @@ module TencentCloud
 
       # UnbindEmployeeUserIdWithClientOpenId请求参数结构体
       class UnbindEmployeeUserIdWithClientOpenIdRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 用户信息，OpenId与UserId二选一必填一个，OpenId是第三方客户ID，userId是用户实名后的电子签生成的ID,当传入客户系统openId，传入的openId需与电子签员工userId绑定，且参数Channel必填，Channel值为INTEGRATE；当传入参数UserId，Channel无需指定(参数用法参考示例)
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param UserId: 电子签系统员工UserId
+        # @param UserId: 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
         # @type UserId: String
-        # @param OpenId: 客户系统OpenId
+        # @param OpenId: 员工在贵司业务系统中的唯一身份标识，用于与腾讯电子签账号进行映射，确保在同一企业内不会出现重复。
+        # 该标识最大长度为64位字符串，仅支持包含26个英文字母和数字0-9的字符。
         # @type OpenId: String
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :UserId, :OpenId, :Agent
@@ -7927,7 +8107,9 @@ module TencentCloud
 
       # UnbindEmployeeUserIdWithClientOpenId返回参数结构体
       class UnbindEmployeeUserIdWithClientOpenIdResponse < TencentCloud::Common::AbstractModel
-        # @param Status: 解绑是否成功，1表示成功，0表示失败
+        # @param Status: 解绑是否成功。
+        # <ul><li> **0**：失败 </li>
+        # <li> **1**：成功 </li></ul>
         # @type Status: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -7947,13 +8129,15 @@ module TencentCloud
 
       # UpdateIntegrationEmployees请求参数结构体
       class UpdateIntegrationEmployeesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 当前用户信息，UserId必填
+        # @param Operator: 执行本接口操作的员工信息,UserId必填。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param Employees: 员工信息，不超过100个。
         # 根据UserId或OpenId更新员工，必填一个，优先UserId。
         # 可更新Mobile、DisplayName、Email和Department.DepartmentId字段，其他字段暂不支持
         # @type Employees: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId需填充子企业Id
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :Employees, :Agent

metadata

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