tencentcloud-sdk-ess 3.0.645 → 3.0.647

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c788f971220de21540c758670254e17ffde37113
-  data.tar.gz: 3725b3c64e1af410daed7196291eaaffcdb2ffcf
+  metadata.gz: 7094c506b8bd8b4154c84c120b9aef167698fee9
+  data.tar.gz: ed87f58ebdb89ab48ba8c1a7528ef9488dd789e2
 SHA512:
-  metadata.gz: c5499ee283050e4fc19aa403e9cfdd10e2ad3012c80058521c48aa705e9d65a7d4c1b6d7ab19c6561e3b3e44652181bfa554b562da7e8400520b325acb21c337
-  data.tar.gz: 248befd4edb9283f41ff89535d22ca4a1fc089c760ccb146cb9250f0edfcf50b356ac0634f77d3efc09437c73ada67adcd51cba63f6d445785f082d0d2bb1761
+  metadata.gz: a11977ac5aac958d620fce31cf16ec137c4b8740c486fc66ade838e70c6f2953cd8f6aa54932980c6baf2e6e5f94ec1e3e1bb6f6f818059b8cc0cd2240c594ab
+  data.tar.gz: 848c78e751f2391fe3212bb057cf2a63f5b0af0a2a1435314003ff7a9381398de73c6c863b124f2fd144a7b6ba9cdfa79944910dbdbacae2f66191f8f9440d9a

data/lib/VERSION

@@ -1 +1 @@
-3.0.645
+3.0.647

data/lib/v20201111/client.rb

@@ -184,7 +184,6 @@ module TencentCloud
         end
 
         # 上传了word、excel、图片文件后，通过该接口发起文件转换任务，将word、excel、图片文件转换为pdf文件。
-        # 注：如果是集团代子企业发起任务场景，可以通过对Agent参数（未列在入参列表）设置代理的相关应用信息来支持，Agent参数设置可以参考CreateFlow接口的Agent相关说明。
 
         # @param request: Request instance for CreateConvertTaskApi.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateConvertTaskApiRequest`
@@ -551,6 +550,39 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
+
+        # 适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
+
+        # 适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。
+        # 适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
+
+        # 适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
+
+        # 注意事项：SaaS角色和集团角色对应的权限树是不一样的。
+
+        # @param request: Request instance for CreateIntegrationRole.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateIntegrationRoleRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateIntegrationRoleResponse`
+        def CreateIntegrationRole(request)
+          body = send_request('CreateIntegrationRole', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateIntegrationRoleResponse.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
+
         # 绑定员工与对应角色
 
         # @param request: Request instance for CreateIntegrationUserRoles.
@@ -585,6 +617,10 @@ module TencentCloud
         # - B端企业的签署方式是静默签署
         # - B端企业是非首位签署
 
+        #  通过一码多扫二维码发起的合同，涉及到的合同回调消息可参考文档[合同发起以及签署相关回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign)
+
+        # 用户通过签署二维码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/company/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
+
         # @param request: Request instance for CreateMultiFlowSignQRCode.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateMultiFlowSignQRCodeRequest`
         # @rtype: :class:`Tencentcloud::ess::V20201111::CreateMultiFlowSignQRCodeResponse`
@@ -1437,6 +1473,39 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 此接口（ModifyIntegrationRole）用来更新企业自定义的SaaS角色或集团角色。
+
+        # 适用场景1：更新当前企业的自定义SaaS角色或集团角色，并且更新时不进行角色中权限的更新（PermissionGroups 参数不传）。
+
+        # 适用场景2：更新当前企业的自定义SaaS角色或集团角色，并且更新时进行角色中权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。
+        # 适用场景3：更新集团角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
+
+        # 适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
+
+        # 注意事项：SaaS角色和集团角色对应的权限树是不一样的。
+
+        # @param request: Request instance for ModifyIntegrationRole.
+        # @type request: :class:`Tencentcloud::ess::V20201111::ModifyIntegrationRoleRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::ModifyIntegrationRoleResponse`
+        def ModifyIntegrationRole(request)
+          body = send_request('ModifyIntegrationRole', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ModifyIntegrationRoleResponse.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
+
         # 此接口用于发起流程
         # 适用场景：见创建签署流程接口。
         # 注：该接口是“创建电子文档”接口的后置接口，用于激活包含完整合同信息（模板及内容信息）的流程。激活后的流程就是一份待签署的电子合同。
@@ -1542,7 +1611,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 对流程的合同文件进行验证，判断文件是否合法。
+        # 对流程的合同文件进行数字签名验证，判断文件是否被篡改。
 
         # @param request: Request instance for VerifyPdf.
         # @type request: :class:`Tencentcloud::ess::V20201111::VerifyPdfRequest`

data/lib/v20201111/models.rb

@@ -74,7 +74,7 @@ module TencentCloud
         end
       end
 
-      # 参与者信息
+      # 参与者信息。
       class ApproverInfo < TencentCloud::Common::AbstractModel
         # @param ApproverType: 在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:
         # **0**：企业
@@ -87,10 +87,8 @@ module TencentCloud
         # @param ApproverName: 签署方经办人的姓名。
         # 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         # @type ApproverName: String
-        # @param ApproverMobile: 本企业的签署方经办人的员工UserId
-        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
-
-        # 注: `若传该字段，则签署方经办人的其他信息（如签署方经办人的姓名、证件号码、手机号码等）将被忽略。`
+        # @param ApproverMobile: 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
+        # 请确认手机号所有方为此合同签署方。
         # @type ApproverMobile: String
         # @param OrganizationName: 组织机构名称。
         # 请确认该名称与企业营业执照中注册的名称一致。
@@ -1048,15 +1046,13 @@ module TencentCloud
         # @type ResourceId: String
         # @param Operator: 调用方用户信息，userId 必填
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Agent: 应用号信息
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
         # @param Organization: 暂未开放
         # @type Organization: :class:`Tencentcloud::Ess.v20201111.models.OrganizationInfo`
 
         attr_accessor :ResourceType, :ResourceName, :ResourceId, :Operator, :Agent, :Organization
         extend Gem::Deprecate
-        deprecate :Agent, :none, 2023, 8
-        deprecate :Agent=, :none, 2023, 8
         deprecate :Organization, :none, 2023, 8
         deprecate :Organization=, :none, 2023, 8
 
@@ -2307,6 +2303,84 @@ module TencentCloud
         end
       end
 
+      # CreateIntegrationRole请求参数结构体
+      class CreateIntegrationRoleRequest < TencentCloud::Common::AbstractModel
+        # @param Name: 角色名称，最大长度为20个字符，仅限中文、字母、数字和下划线组成。
+        # @type Name: String
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+        # 支持填入集团子公司经办人 userId 代发合同。
+
+        # 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Description: 角色描述，最大长度为50个字符
+        # @type Description: String
+        # @param IsGroupRole: 角色类型，0:saas角色，1:集团角色
+        # 默认0，saas角色
+        # @type IsGroupRole: Integer
+        # @param PermissionGroups: 权限树
+        # @type PermissionGroups: Array
+        # @param SubOrganizationIds: 集团角色的话，需要传递集团子企业列表，如果是全选，则传1
+        # @type SubOrganizationIds: String
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+
+        attr_accessor :Name, :Operator, :Description, :IsGroupRole, :PermissionGroups, :SubOrganizationIds, :Agent
+
+        def initialize(name=nil, operator=nil, description=nil, isgrouprole=nil, permissiongroups=nil, suborganizationids=nil, agent=nil)
+          @Name = name
+          @Operator = operator
+          @Description = description
+          @IsGroupRole = isgrouprole
+          @PermissionGroups = permissiongroups
+          @SubOrganizationIds = suborganizationids
+          @Agent = agent
+        end
+
+        def deserialize(params)
+          @Name = params['Name']
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @Description = params['Description']
+          @IsGroupRole = params['IsGroupRole']
+          unless params['PermissionGroups'].nil?
+            @PermissionGroups = []
+            params['PermissionGroups'].each do |i|
+              permissiongroup_tmp = PermissionGroup.new
+              permissiongroup_tmp.deserialize(i)
+              @PermissionGroups << permissiongroup_tmp
+            end
+          end
+          @SubOrganizationIds = params['SubOrganizationIds']
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+        end
+      end
+
+      # CreateIntegrationRole返回参数结构体
+      class CreateIntegrationRoleResponse < TencentCloud::Common::AbstractModel
+        # @param RoleId: 角色id
+        # @type RoleId: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RoleId, :RequestId
+
+        def initialize(roleid=nil, requestid=nil)
+          @RoleId = roleid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RoleId = params['RoleId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateIntegrationUserRoles请求参数结构体
       class CreateIntegrationUserRolesRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 操作人信息，UserId必填
@@ -2391,18 +2465,19 @@ module TencentCloud
         # @param UserData: 用户自定义字段
         # <br/>回调的时候会进行透传，长度需要小于20480
         # @type UserData: String
-        # @param CallbackUrl: 回调地址,最大长度1000字符串
-        # <br/>回调时机：用户通过签署二维码发起签署流程时，企业额度不足导致失败
+        # @param CallbackUrl: 已废弃，回调配置统一使用企业应用管理-应用集成-企业版应用中的配置
+        # <br/> 通过一码多扫二维码发起的合同，回调消息可参考文档 https://qian.tencent.com/developers/company/callback_types_contracts_sign
+        # <br/> 用户通过签署二维码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档 https://qian.tencent.com/developers/company/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83
         # @type CallbackUrl: String
-        # @param Agent: 应用信息
+        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
         # @param ApproverRestrictions: 限制二维码用户条件（已弃用）
         # @type ApproverRestrictions: :class:`Tencentcloud::Ess.v20201111.models.ApproverRestriction`
 
         attr_accessor :Operator, :TemplateId, :FlowName, :MaxFlowNum, :FlowEffectiveDay, :QrEffectiveDay, :Restrictions, :UserData, :CallbackUrl, :Agent, :ApproverRestrictions
         extend Gem::Deprecate
-        deprecate :Agent, :none, 2023, 8
-        deprecate :Agent=, :none, 2023, 8
+        deprecate :CallbackUrl, :none, 2023, 8
+        deprecate :CallbackUrl=, :none, 2023, 8
         deprecate :ApproverRestrictions, :none, 2023, 8
         deprecate :ApproverRestrictions=, :none, 2023, 8
 
@@ -2562,14 +2637,17 @@ module TencentCloud
         # @type IdCardType: String
         # @param IdCardNumber: 身份证件号码
         # @type IdCardNumber: String
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
-        attr_accessor :Operator, :UserName, :IdCardType, :IdCardNumber
+        attr_accessor :Operator, :UserName, :IdCardType, :IdCardNumber, :Agent
 
-        def initialize(operator=nil, username=nil, idcardtype=nil, idcardnumber=nil)
+        def initialize(operator=nil, username=nil, idcardtype=nil, idcardnumber=nil, agent=nil)
           @Operator = operator
           @UserName = username
           @IdCardType = idcardtype
           @IdCardNumber = idcardnumber
+          @Agent = agent
         end
 
         def deserialize(params)
@@ -2580,6 +2658,10 @@ module TencentCloud
           @UserName = params['UserName']
           @IdCardType = params['IdCardType']
           @IdCardNumber = params['IdCardNumber']
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
         end
       end
 
@@ -2587,18 +2669,38 @@ module TencentCloud
       class CreatePersonAuthCertificateImageResponse < TencentCloud::Common::AbstractModel
         # @param AuthCertUrl: 个人用户证明证书的下载链接
         # @type AuthCertUrl: String
+        # @param ImageCertId: 证书图片上的证书编号，20位数字
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ImageCertId: String
+        # @param SerialNumber: 图片证明对应的CA证书序列号
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type SerialNumber: String
+        # @param ValidFrom: CA证书颁发时间戳
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ValidFrom: Integer
+        # @param ValidTo: CA证书有效截止时间戳
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ValidTo: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :AuthCertUrl, :RequestId
+        attr_accessor :AuthCertUrl, :ImageCertId, :SerialNumber, :ValidFrom, :ValidTo, :RequestId
 
-        def initialize(authcerturl=nil, requestid=nil)
+        def initialize(authcerturl=nil, imagecertid=nil, serialnumber=nil, validfrom=nil, validto=nil, requestid=nil)
           @AuthCertUrl = authcerturl
+          @ImageCertId = imagecertid
+          @SerialNumber = serialnumber
+          @ValidFrom = validfrom
+          @ValidTo = validto
           @RequestId = requestid
         end
 
         def deserialize(params)
           @AuthCertUrl = params['AuthCertUrl']
+          @ImageCertId = params['ImageCertId']
+          @SerialNumber = params['SerialNumber']
+          @ValidFrom = params['ValidFrom']
+          @ValidTo = params['ValidTo']
           @RequestId = params['RequestId']
         end
       end
@@ -2607,7 +2709,7 @@ module TencentCloud
       class CreatePrepareFlowRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 调用方用户信息，userId 必填
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param ResourceId: 资源Id，通过多文件上传（UploadFiles）接口获得
+        # @param ResourceId: 资源id，与ResourceType对应
         # @type ResourceId: String
         # @param FlowName: 合同名称
         # @type FlowName: String
@@ -2620,19 +2722,24 @@ module TencentCloud
         # 不传默认为当前时间一年后
         # @type Deadline: Integer
         # @param UserFlowTypeId: 用户自定义合同类型Id
-        # 该id为电子签企业内的合同类型id
+
+        # 该id为电子签企业内的合同类型id， 可以在自定义合同类型处获取
         # @type UserFlowTypeId: String
+        # @param FlowType: 合同类型名称
+        # 该字段用于客户自定义合同类型
+        # 建议使用时指定合同类型，便于之后合同分类以及查看
+        # 如果合同类型与自定义的合同类型描述一致，会自动归类到自定义的合同类型处，如果不一致，则会创建一个新的自定义合同类型
+        # @type FlowType: String
         # @param Approvers: 签署流程参与者信息，最大限制50方
         # @type Approvers: Array
         # @param IntelligentStatus: 打开智能添加填写区
-        # (默认开启，打开:"OPEN"
+        # 默认开启，打开:"OPEN"
         #  关闭："CLOSE"
         # @type IntelligentStatus: String
         # @param ResourceType: 资源类型，
-        # 1：文件，
-        # 2：模板
-        # 不传默认为1：文件
-        # 目前仅支持文件
+        # 1：模板
+        # 2：文件，
+        # 不传默认为2：文件
         # @type ResourceType: Integer
         # @param Components: 发起方填写控件
         # 该类型控件由发起方完成填写
@@ -2655,22 +2762,19 @@ module TencentCloud
         # @type UserData: String
         # @param FlowId: 合同id,用于通过已web页面发起的合同id快速生成一个web发起合同链接
         # @type FlowId: String
-        # @param FlowType: 合同类型名称
-        # 该字段用于客户自定义合同类型
-        # 建议使用时指定合同类型，便于之后合同分类以及查看
-        # @type FlowType: String
         # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
-        attr_accessor :Operator, :ResourceId, :FlowName, :Unordered, :Deadline, :UserFlowTypeId, :Approvers, :IntelligentStatus, :ResourceType, :Components, :FlowOption, :NeedSignReview, :NeedCreateReview, :UserData, :FlowId, :FlowType, :Agent
+        attr_accessor :Operator, :ResourceId, :FlowName, :Unordered, :Deadline, :UserFlowTypeId, :FlowType, :Approvers, :IntelligentStatus, :ResourceType, :Components, :FlowOption, :NeedSignReview, :NeedCreateReview, :UserData, :FlowId, :Agent
 
-        def initialize(operator=nil, resourceid=nil, flowname=nil, unordered=nil, deadline=nil, userflowtypeid=nil, approvers=nil, intelligentstatus=nil, resourcetype=nil, components=nil, flowoption=nil, needsignreview=nil, needcreatereview=nil, userdata=nil, flowid=nil, flowtype=nil, agent=nil)
+        def initialize(operator=nil, resourceid=nil, flowname=nil, unordered=nil, deadline=nil, userflowtypeid=nil, flowtype=nil, approvers=nil, intelligentstatus=nil, resourcetype=nil, components=nil, flowoption=nil, needsignreview=nil, needcreatereview=nil, userdata=nil, flowid=nil, agent=nil)
           @Operator = operator
           @ResourceId = resourceid
           @FlowName = flowname
           @Unordered = unordered
           @Deadline = deadline
           @UserFlowTypeId = userflowtypeid
+          @FlowType = flowtype
           @Approvers = approvers
           @IntelligentStatus = intelligentstatus
           @ResourceType = resourcetype
@@ -2680,7 +2784,6 @@ module TencentCloud
           @NeedCreateReview = needcreatereview
           @UserData = userdata
           @FlowId = flowid
-          @FlowType = flowtype
           @Agent = agent
         end
 
@@ -2694,6 +2797,7 @@ module TencentCloud
           @Unordered = params['Unordered']
           @Deadline = params['Deadline']
           @UserFlowTypeId = params['UserFlowTypeId']
+          @FlowType = params['FlowType']
           unless params['Approvers'].nil?
             @Approvers = []
             params['Approvers'].each do |i|
@@ -2716,7 +2820,6 @@ module TencentCloud
           @NeedCreateReview = params['NeedCreateReview']
           @UserData = params['UserData']
           @FlowId = params['FlowId']
-          @FlowType = params['FlowType']
           unless params['Agent'].nil?
             @Agent = Agent.new
             @Agent.deserialize(params['Agent'])
@@ -3787,7 +3890,8 @@ module TencentCloud
         # @type CcToken: String
         # @param Scene: 暂不开放
         # @type Scene: String
-        # @param Agent: 应用相关信息
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :BusinessType, :BusinessIds, :FileName, :FileType, :Offset, :Limit, :UrlTtl, :CcToken, :Scene, :Agent
@@ -3796,8 +3900,6 @@ module TencentCloud
         deprecate :CcToken=, :none, 2023, 8
         deprecate :Scene, :none, 2023, 8
         deprecate :Scene=, :none, 2023, 8
-        deprecate :Agent, :none, 2023, 8
-        deprecate :Agent=, :none, 2023, 8
 
         def initialize(operator=nil, businesstype=nil, businessids=nil, filename=nil, filetype=nil, offset=nil, limit=nil, urlttl=nil, cctoken=nil, scene=nil, agent=nil)
           @Operator = operator
@@ -4436,7 +4538,8 @@ module TencentCloud
         # @param Filters: 查询的关键字段:
         # Key:"RoleType",Values:["1"]查询系统角色，Values:["2"]查询自定义角色
         # Key:"RoleStatus",Values:["1"]查询启用角色，Values:["2"]查询禁用角色
-        # Key:"IsGroupRole"，Values:["0"],查询非集团角色，Values:["1"]表示查询集团角色
+        # Key:"IsGroupRole"，Values:["0"]:查询非集团角色，Values:["1"]表示查询集团角色
+        # Key:"IsReturnPermissionGroup"，Values:["0"]:表示接口不返回角色对应的权限树字段，Values:["1"]表示接口返回角色对应的权限树字段
         # @type Filters: Array
         # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大2000
         # @type Offset: Integer
@@ -4633,10 +4736,21 @@ module TencentCloud
         # @type SealTypes: Array
         # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-
-        attr_accessor :Operator, :Limit, :Offset, :InfoType, :SealId, :SealTypes, :Agent
-
-        def initialize(operator=nil, limit=nil, offset=nil, infotype=nil, sealid=nil, sealtypes=nil, agent=nil)
+        # @param SealStatuses: 查询的印章状态列表。
+        # 取值为空，只查询启用状态的印章；
+        # 取值ALL，查询所有状态的印章；
+        # 取值CHECKING，查询待审核的印章；
+        # 取值SUCCESS，查询启用状态的印章；
+        # 取值FAIL，查询印章审核拒绝的印章；
+        # 取值DISABLE，查询已停用的印章；
+        # 取值STOPPED，查询已终止的印章；
+        # 取值VOID，查询已作废的印章；
+        # 取值INVALID，查询以失效的印章；
+        # @type SealStatuses: Array
+
+        attr_accessor :Operator, :Limit, :Offset, :InfoType, :SealId, :SealTypes, :Agent, :SealStatuses
+
+        def initialize(operator=nil, limit=nil, offset=nil, infotype=nil, sealid=nil, sealtypes=nil, agent=nil, sealstatuses=nil)
           @Operator = operator
           @Limit = limit
           @Offset = offset
@@ -4644,6 +4758,7 @@ module TencentCloud
           @SealId = sealid
           @SealTypes = sealtypes
           @Agent = agent
+          @SealStatuses = sealstatuses
         end
 
         def deserialize(params)
@@ -4660,6 +4775,7 @@ module TencentCloud
             @Agent = Agent.new
             @Agent.deserialize(params['Agent'])
           end
+          @SealStatuses = params['SealStatuses']
         end
       end
 
@@ -5329,44 +5445,42 @@ module TencentCloud
         end
       end
 
-      # 流程信息摘要
+      # 合同流程的基础信息
       class FlowBrief < TencentCloud::Common::AbstractModel
-        # @param FlowId: 流程的编号ID
+        # @param FlowId: 合同流程ID，为32位字符串。
         # @type FlowId: String
-        # @param FlowName: 流程的名称
+        # @param FlowName: 合同流程的名称。
         # @type FlowName: String
-        # @param FlowDescription: 流程的描述信息
+        # @param FlowDescription: 合同流程描述信息。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowDescription: String
-        # @param FlowType: 流程的类型
+        # @param FlowType: 合同流程的类别分类（如销售合同/入职合同等）。
         # @type FlowType: String
-        # @param FlowStatus: 流程状态
-        # - 0 还没有发起
-        # - 1 待签署
-        # - 2 部分签署
-        # - 3 已拒签
-        # - 4 已签署
-        # - 5 已过期
-        # - 6 已撤销
-        # - 7 还没有预发起
-        # - 8 等待填写
-        # - 9 部分填写
-        # - 10 拒填
-        # - 21 已解除
+        # @param FlowStatus: 合同流程当前的签署状态, 会存在下列的状态值
+        # <ul><li> **0** : 未开启流程(合同中不存在填写环节)</li>
+        # <li> **1** : 待签署</li>
+        # <li> **2** : 部分签署</li>
+        # <li> **3** : 已拒签</li>
+        # <li> **4** : 已签署</li>
+        # <li> **5** : 已过期</li>
+        # <li> **6** : 已撤销</li>
+        # <li> **7** : 未开启流程(合同中存在填写环节)</li>
+        # <li> **8** : 等待填写</li>
+        # <li> **9** : 部分填写</li>
+        # <li> **10** : 已拒填</li>
+        # <li> **21** : 已解除</li></ul>
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowStatus: Integer
-        # @param CreatedOn: 流程创建的时间戳，单位秒
+        # @param CreatedOn: 合同流程创建时间，格式为Unix标准时间戳（秒）。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type CreatedOn: Integer
-        # @param FlowMessage: 当合同被拒签或者取消后(当FlowStatus=3或者FlowStatus=6的时候)
-        # 此字段展示拒签或者取消的原因描述
-
+        # @param FlowMessage: 当合同流程状态为已拒签（即 FlowStatus=3）或已撤销（即 FlowStatus=6）时，此字段 FlowMessage 为拒签或撤销原因。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowMessage: String
-        # @param Creator:  合同发起人userId
+        # @param Creator:  合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Creator: String
-        # @param Deadline: 合同过期时间，时间戳，单位秒
+        # @param Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒）。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Deadline: Integer
 
@@ -5411,7 +5525,7 @@ module TencentCloud
         # 注: 个人自动签场景为白名单功能, 使用前请联系对接的客户经理沟通。
         # @type ApproverType: Integer
         # @param OrganizationName: 签署人企业名称
-        # <br/>当approverType=1 或 approverType=3时，必须指定
+        # 当approverType=0 或 approverType=3时，必须指定
 
         # @type OrganizationName: String
         # @param ApproverName: 签署方经办人姓名
@@ -5487,8 +5601,12 @@ module TencentCloud
         # 	SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
         # @type ComponentLimitType: Array
         # @param ApproverVerifyTypes: 合同查看方式<br/>默认1 -实名查看 <br/>2-短信验证码查看(企业签署方暂不支持该方式)
+
+        # > 注意:此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主.
         # @type ApproverVerifyTypes: Array
         # @param ApproverSignTypes: 合同签署方式(默认1,2) <br/>1-人脸认证 <br/>2-签署密码 <br/>3-运营商三要素
+
+        # > 注意:此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主.
         # @type ApproverSignTypes: Array
 
         attr_accessor :ApproverType, :OrganizationName, :ApproverName, :ApproverMobile, :ApproverIdCardType, :ApproverIdCardNumber, :RecipientId, :VerifyChannel, :NotifyType, :IsFullText, :PreReadTime, :UserId, :Required, :ApproverSource, :CustomApproverTag, :RegisterInfo, :ApproverOption, :JumpUrl, :SignId, :ApproverNeedSignReview, :SignComponents, :Components, :ComponentLimitType, :ApproverVerifyTypes, :ApproverSignTypes
@@ -5972,15 +6090,13 @@ module TencentCloud
         # @type TaskId: String
         # @param Operator: 操作人信息,UserId必填
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Agent: 应用号信息
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
         # @param Organization: 暂未开放
         # @type Organization: :class:`Tencentcloud::Ess.v20201111.models.OrganizationInfo`
 
         attr_accessor :TaskId, :Operator, :Agent, :Organization
         extend Gem::Deprecate
-        deprecate :Agent, :none, 2023, 8
-        deprecate :Agent=, :none, 2023, 8
         deprecate :Organization, :none, 2023, 8
         deprecate :Organization=, :none, 2023, 8
 
@@ -6168,15 +6284,19 @@ module TencentCloud
         # @param SubOrgIdList: 管辖的子企业列表
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type SubOrgIdList: Array
+        # @param PermissionGroups: 权限树
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type PermissionGroups: Array
 
-        attr_accessor :RoleId, :RoleName, :RoleStatus, :IsGroupRole, :SubOrgIdList
+        attr_accessor :RoleId, :RoleName, :RoleStatus, :IsGroupRole, :SubOrgIdList, :PermissionGroups
 
-        def initialize(roleid=nil, rolename=nil, rolestatus=nil, isgrouprole=nil, suborgidlist=nil)
+        def initialize(roleid=nil, rolename=nil, rolestatus=nil, isgrouprole=nil, suborgidlist=nil, permissiongroups=nil)
           @RoleId = roleid
           @RoleName = rolename
           @RoleStatus = rolestatus
           @IsGroupRole = isgrouprole
           @SubOrgIdList = suborgidlist
+          @PermissionGroups = permissiongroups
         end
 
         def deserialize(params)
@@ -6185,6 +6305,14 @@ module TencentCloud
           @RoleStatus = params['RoleStatus']
           @IsGroupRole = params['IsGroupRole']
           @SubOrgIdList = params['SubOrgIdList']
+          unless params['PermissionGroups'].nil?
+            @PermissionGroups = []
+            params['PermissionGroups'].each do |i|
+              permissiongroup_tmp = PermissionGroup.new
+              permissiongroup_tmp.deserialize(i)
+              @PermissionGroups << permissiongroup_tmp
+            end
+          end
         end
       end
 
@@ -6369,6 +6497,83 @@ module TencentCloud
         end
       end
 
+      # ModifyIntegrationRole请求参数结构体
+      class ModifyIntegrationRoleRequest < TencentCloud::Common::AbstractModel
+        # @param RoleId: 角色Id，可通过接口 DescribeIntegrationRoles 查询获取
+        # @type RoleId: String
+        # @param Name: 角色名称，最大长度为20个字符，仅限中文、字母、数字和下划线组成。
+        # @type Name: String
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+        # 支持填入集团子公司经办人 userId 代发合同。
+
+        # 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Description: 角色描述，最大长度为50个字符
+        # @type Description: String
+        # @param PermissionGroups: 权限树
+        # @type PermissionGroups: Array
+        # @param SubOrganizationIds: 集团角色的话，需要传递集团子企业列表，如果是全选，则传1
+        # @type SubOrganizationIds: Array
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+
+        attr_accessor :RoleId, :Name, :Operator, :Description, :PermissionGroups, :SubOrganizationIds, :Agent
+
+        def initialize(roleid=nil, name=nil, operator=nil, description=nil, permissiongroups=nil, suborganizationids=nil, agent=nil)
+          @RoleId = roleid
+          @Name = name
+          @Operator = operator
+          @Description = description
+          @PermissionGroups = permissiongroups
+          @SubOrganizationIds = suborganizationids
+          @Agent = agent
+        end
+
+        def deserialize(params)
+          @RoleId = params['RoleId']
+          @Name = params['Name']
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @Description = params['Description']
+          unless params['PermissionGroups'].nil?
+            @PermissionGroups = []
+            params['PermissionGroups'].each do |i|
+              permissiongroup_tmp = PermissionGroup.new
+              permissiongroup_tmp.deserialize(i)
+              @PermissionGroups << permissiongroup_tmp
+            end
+          end
+          @SubOrganizationIds = params['SubOrganizationIds']
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+        end
+      end
+
+      # ModifyIntegrationRole返回参数结构体
+      class ModifyIntegrationRoleResponse < TencentCloud::Common::AbstractModel
+        # @param RoleId: 角色id
+        # @type RoleId: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RoleId, :RequestId
+
+        def initialize(roleid=nil, requestid=nil)
+          @RoleId = roleid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RoleId = params['RoleId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # 持有的电子印章信息
       class OccupiedSeal < TencentCloud::Common::AbstractModel
         # @param SealId: 电子印章编号
@@ -6541,6 +6746,119 @@ module TencentCloud
         end
       end
 
+      # 权限树节点权限
+      class Permission < TencentCloud::Common::AbstractModel
+        # @param Name: 权限名称
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Name: String
+        # @param Key: 权限key
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Key: String
+        # @param Type: 权限类型 1前端，2后端
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Type: Integer
+        # @param Hide: 是否隐藏
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Hide: Integer
+        # @param DataLabel: 数据权限标签 1:表示根节点，2:表示叶子结点
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DataLabel: Integer
+        # @param DataType: 数据权限独有，1:关联其他模块鉴权，2:表示关联自己模块鉴权
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DataType: Integer
+        # @param DataRange: 数据权限独有，表示数据范围，1：全公司，2:部门及下级部门，3:自己
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DataRange: Integer
+        # @param DataTo: 关联权限, 表示这个功能权限要受哪个数据权限管控
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DataTo: String
+        # @param ParentKey: 父级权限key
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ParentKey: String
+        # @param IsChecked: 是否选中
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type IsChecked: Boolean
+        # @param Children: 子权限集合
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Children: Array
+
+        attr_accessor :Name, :Key, :Type, :Hide, :DataLabel, :DataType, :DataRange, :DataTo, :ParentKey, :IsChecked, :Children
+
+        def initialize(name=nil, key=nil, type=nil, hide=nil, datalabel=nil, datatype=nil, datarange=nil, datato=nil, parentkey=nil, ischecked=nil, children=nil)
+          @Name = name
+          @Key = key
+          @Type = type
+          @Hide = hide
+          @DataLabel = datalabel
+          @DataType = datatype
+          @DataRange = datarange
+          @DataTo = datato
+          @ParentKey = parentkey
+          @IsChecked = ischecked
+          @Children = children
+        end
+
+        def deserialize(params)
+          @Name = params['Name']
+          @Key = params['Key']
+          @Type = params['Type']
+          @Hide = params['Hide']
+          @DataLabel = params['DataLabel']
+          @DataType = params['DataType']
+          @DataRange = params['DataRange']
+          @DataTo = params['DataTo']
+          @ParentKey = params['ParentKey']
+          @IsChecked = params['IsChecked']
+          unless params['Children'].nil?
+            @Children = []
+            params['Children'].each do |i|
+              permission_tmp = Permission.new
+              permission_tmp.deserialize(i)
+              @Children << permission_tmp
+            end
+          end
+        end
+      end
+
+      # 权限树中的权限组
+      class PermissionGroup < TencentCloud::Common::AbstractModel
+        # @param GroupName: 权限组名称
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type GroupName: String
+        # @param GroupKey: 权限组key
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type GroupKey: String
+        # @param Hide: 是否隐藏分组，0否1是
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Hide: Integer
+        # @param Permissions: 权限集合
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Permissions: Array
+
+        attr_accessor :GroupName, :GroupKey, :Hide, :Permissions
+
+        def initialize(groupname=nil, groupkey=nil, hide=nil, permissions=nil)
+          @GroupName = groupname
+          @GroupKey = groupkey
+          @Hide = hide
+          @Permissions = permissions
+        end
+
+        def deserialize(params)
+          @GroupName = params['GroupName']
+          @GroupKey = params['GroupKey']
+          @Hide = params['Hide']
+          unless params['Permissions'].nil?
+            @Permissions = []
+            params['Permissions'].each do |i|
+              permission_tmp = Permission.new
+              permission_tmp.deserialize(i)
+              @Permissions << permission_tmp
+            end
+          end
+        end
+      end
+
       # 流程中参与方的信息结构
       class Recipient < TencentCloud::Common::AbstractModel
         # @param RecipientId: 签署参与者ID，唯一标识
@@ -7647,7 +7965,7 @@ module TencentCloud
       class VerifyPdfResponse < TencentCloud::Common::AbstractModel
         # @param VerifyResult: 验签结果，1-文件未被篡改，全部签名在腾讯电子签完成； 2-文件未被篡改，部分签名在腾讯电子签完成；3-文件被篡改；4-异常：文件内没有签名域；5-异常：文件签名格式错误
         # @type VerifyResult: Integer
-        # @param PdfVerifyResults: 验签结果详情,内部状态1-验签成功，在电子签签署；2-验签成功，在其他平台签署；3-验签失败；4-pdf文件没有签名域；5-文件签名格式错误
+        # @param PdfVerifyResults: 验签结果详情，每个签名域对应的验签结果。状态值：1-验签成功，在电子签签署；2-验签成功，在其他平台签署；3-验签失败；4-pdf文件没有签名域；5-文件签名格式错误
         # @type PdfVerifyResults: Array
         # @param VerifySerialNo: 验签序列号
         # @type VerifySerialNo: String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.645
+  version: 3.0.647
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-28 00:00:00.000000000 Z
+date: 2023-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common