tencentcloud-sdk-ess 3.0.586 → 3.0.588

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cf082cc9a4690d1c5e5c65ab94140dd18342b24e
-  data.tar.gz: c32bc680797a19fc8c1f8726e7a080bd19f99ad8
+  metadata.gz: 9b2cc592637437a2e22161fcccf00166ddbeab36
+  data.tar.gz: da12a7f1b1a2b764d9f0277cdd5e5e8789611e66
 SHA512:
-  metadata.gz: 7bbd76f51a5dcee1c468ccb191dada4752a2f9945d6b3e1710dca0a70e7e583e86e4dfaccf4062fa0e9e83ec0adcc7309f10c49f1bb461cba1e4ffc1793ae6ed
-  data.tar.gz: 7b21b3fd59ba71ad33189413cc0b4cba19374c3dc62501d216edf7f80f43e135313b99c646f424f16d3e8eb34bad365e5fee0134316ecd29ed041656d9bf265e
+  metadata.gz: 99d3dd59a23fc32ca7c583871cd472af68288e28e9b089796965c08201f61d616c5f1c7660c280caf51673afd16f0d033bfaa90e189026a913c8d97539c6611d
+  data.tar.gz: 95c8a78fc4fb92f97de028ec1a50f446ddd7da3a750d1c5dad2255fc9535d29e316ca7dc125f5f3144e9d04751aba4086e3d816873db6ca823ea9d051548fc1b

data/lib/VERSION

@@ -1 +1 @@
-3.0.586
+3.0.588

data/lib/v20201111/client.rb

@@ -393,6 +393,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口，创建企业的部门，支持绑定客户系统部门ID。
+
+        # @param request: Request instance for CreateIntegrationDepartment.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateIntegrationDepartmentRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateIntegrationDepartmentResponse`
+        def CreateIntegrationDepartment(request)
+          body = send_request('CreateIntegrationDepartment', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateIntegrationDepartmentResponse.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
+
         # 创建员工,如需在此接口提醒员工实名，入参Employees的OpenId不传
 
         # @param request: Request instance for CreateIntegrationEmployees.
@@ -629,6 +653,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口，删除企业的部门。
+
+        # @param request: Request instance for DeleteIntegrationDepartment.
+        # @type request: :class:`Tencentcloud::ess::V20201111::DeleteIntegrationDepartmentRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::DeleteIntegrationDepartmentResponse`
+        def DeleteIntegrationDepartment(request)
+          body = send_request('DeleteIntegrationDepartment', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DeleteIntegrationDepartmentResponse.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 DeleteIntegrationEmployees.
@@ -826,6 +874,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口，查询企业的部门，支持查询单个部门节点或单个部门节点及一级子节点部门列表。
+
+        # @param request: Request instance for DescribeIntegrationDepartments.
+        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationDepartmentsRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationDepartmentsResponse`
+        def DescribeIntegrationDepartments(request)
+          body = send_request('DescribeIntegrationDepartments', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeIntegrationDepartmentsResponse.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
+
         # 查询企业员工列表，每次返回的数据量最大为20
 
         # @param request: Request instance for DescribeIntegrationEmployees.
@@ -1070,6 +1142,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口，更新企业的部门信息，支持更新部门名、客户系统部门ID、部门序列号。
+
+        # @param request: Request instance for ModifyIntegrationDepartment.
+        # @type request: :class:`Tencentcloud::ess::V20201111::ModifyIntegrationDepartmentRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::ModifyIntegrationDepartmentResponse`
+        def ModifyIntegrationDepartment(request)
+          body = send_request('ModifyIntegrationDepartment', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ModifyIntegrationDepartmentResponse.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
+
         # 此接口用于发起流程
         # 适用场景：见创建签署流程接口。
         # 注：该接口是“创建电子文档”接口的后置接口，用于激活包含完整合同信息（模板及内容信息）的流程。激活后的流程就是一份待签署的电子合同。

data/lib/v20201111/models.rb

@@ -1560,6 +1560,65 @@ module TencentCloud
         end
       end
 
+      # CreateIntegrationDepartment请求参数结构体
+      class CreateIntegrationDepartmentRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 操作人信息，UserId必填且需拥有组织架构管理权限
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param DeptName: 部门名称，不超过50个字符
+        # @type DeptName: String
+        # @param ParentDeptId: 电子签父部门ID，与ParentDeptOpenId二选一,优先ParentDeptId,都为空时自动填充至根节点下
+        # @type ParentDeptId: String
+        # @param ParentDeptOpenId: 第三方平台中父部门ID,与ParentDeptId二选一,优先ParentDeptId,都为空时自动填充至根节点下
+        # @type ParentDeptOpenId: String
+        # @param DeptOpenId: 客户系统部门ID，不超过64个字符
+        # @type DeptOpenId: String
+        # @param OrderNo: 排序号,1~30000范围内
+        # @type OrderNo: Integer
+
+        attr_accessor :Operator, :DeptName, :ParentDeptId, :ParentDeptOpenId, :DeptOpenId, :OrderNo
+        
+        def initialize(operator=nil, deptname=nil, parentdeptid=nil, parentdeptopenid=nil, deptopenid=nil, orderno=nil)
+          @Operator = operator
+          @DeptName = deptname
+          @ParentDeptId = parentdeptid
+          @ParentDeptOpenId = parentdeptopenid
+          @DeptOpenId = deptopenid
+          @OrderNo = orderno
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @DeptName = params['DeptName']
+          @ParentDeptId = params['ParentDeptId']
+          @ParentDeptOpenId = params['ParentDeptOpenId']
+          @DeptOpenId = params['DeptOpenId']
+          @OrderNo = params['OrderNo']
+        end
+      end
+
+      # CreateIntegrationDepartment返回参数结构体
+      class CreateIntegrationDepartmentResponse < TencentCloud::Common::AbstractModel
+        # @param DeptId: 电子签部门ID
+        # @type DeptId: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :DeptId, :RequestId
+        
+        def initialize(deptid=nil, requestid=nil)
+          @DeptId = deptid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @DeptId = params['DeptId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateIntegrationEmployees请求参数结构体
       class CreateIntegrationEmployeesRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 操作人信息，userId必填
@@ -2297,6 +2356,49 @@ module TencentCloud
         end
       end
 
+      # DeleteIntegrationDepartment请求参数结构体
+      class DeleteIntegrationDepartmentRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 操作人信息，UserId必填且需拥有组织架构管理权限
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param DeptId: 电子签中的部门id
+        # @type DeptId: String
+        # @param ReceiveDeptId: 交接部门ID。待删除部门中的合同、印章和模版数据，交接至该部门ID下，未填写交接至公司根部门。
+        # @type ReceiveDeptId: String
+
+        attr_accessor :Operator, :DeptId, :ReceiveDeptId
+        
+        def initialize(operator=nil, deptid=nil, receivedeptid=nil)
+          @Operator = operator
+          @DeptId = deptid
+          @ReceiveDeptId = receivedeptid
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @DeptId = params['DeptId']
+          @ReceiveDeptId = params['ReceiveDeptId']
+        end
+      end
+
+      # DeleteIntegrationDepartment返回参数结构体
+      class DeleteIntegrationDepartmentResponse < TencentCloud::Common::AbstractModel
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RequestId
+        
+        def initialize(requestid=nil)
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DeleteIntegrationEmployees请求参数结构体
       class DeleteIntegrationEmployeesRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 操作人信息，userId必填
@@ -2894,6 +2996,64 @@ module TencentCloud
         end
       end
 
+      # DescribeIntegrationDepartments请求参数结构体
+      class DescribeIntegrationDepartmentsRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 操作人信息，UserId必填且需拥有组织架构管理权限
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param QueryType: 查询类型 0-查询单个部门节点 1-单个部门节点及一级子节点部门列表
+        # @type QueryType: Integer
+        # @param DeptId: 部门ID,与DeptOpenId二选一,优先DeptId,都为空时获取根节点数据
+        # @type DeptId: String
+        # @param DeptOpenId: 客户系统部门ID,与DeptId二选一,优先DeptId,都为空时获取根节点数据
+        # @type DeptOpenId: String
+
+        attr_accessor :Operator, :QueryType, :DeptId, :DeptOpenId
+        
+        def initialize(operator=nil, querytype=nil, deptid=nil, deptopenid=nil)
+          @Operator = operator
+          @QueryType = querytype
+          @DeptId = deptid
+          @DeptOpenId = deptopenid
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @QueryType = params['QueryType']
+          @DeptId = params['DeptId']
+          @DeptOpenId = params['DeptOpenId']
+        end
+      end
+
+      # DescribeIntegrationDepartments返回参数结构体
+      class DescribeIntegrationDepartmentsResponse < TencentCloud::Common::AbstractModel
+        # @param Departments: 部门列表
+        # @type Departments: Array
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Departments, :RequestId
+        
+        def initialize(departments=nil, requestid=nil)
+          @Departments = departments
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['Departments'].nil?
+            @Departments = []
+            params['Departments'].each do |i|
+              integrationdepartment_tmp = IntegrationDepartment.new
+              integrationdepartment_tmp.deserialize(i)
+              @Departments << integrationdepartment_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeIntegrationEmployees请求参数结构体
       class DescribeIntegrationEmployeesRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 操作人信息，userId必填
@@ -3857,10 +4017,14 @@ module TencentCloud
         # @type ApproverOption: :class:`Tencentcloud::Ess.v20201111.models.ApproverOption`
         # @param JumpUrl: 签署完前端跳转的url，暂未使用
         # @type JumpUrl: String
+        # @param SignId: 签署ID
+        # - 发起流程时系统自动补充
+        # - 创建签署链接时，可以通过查询详情接口获得签署人的SignId，然后可传入此值为该签署人创建签署链接，无需再传姓名、手机号、证件号等其他信息
+        # @type SignId: String
 
-        attr_accessor :ApproverType, :OrganizationName, :ApproverName, :ApproverMobile, :ApproverIdCardType, :ApproverIdCardNumber, :RecipientId, :VerifyChannel, :NotifyType, :IsFullText, :PreReadTime, :UserId, :Required, :ApproverSource, :CustomApproverTag, :RegisterInfo, :ApproverOption, :JumpUrl
+        attr_accessor :ApproverType, :OrganizationName, :ApproverName, :ApproverMobile, :ApproverIdCardType, :ApproverIdCardNumber, :RecipientId, :VerifyChannel, :NotifyType, :IsFullText, :PreReadTime, :UserId, :Required, :ApproverSource, :CustomApproverTag, :RegisterInfo, :ApproverOption, :JumpUrl, :SignId
         
-        def initialize(approvertype=nil, organizationname=nil, approvername=nil, approvermobile=nil, approveridcardtype=nil, approveridcardnumber=nil, recipientid=nil, verifychannel=nil, notifytype=nil, isfulltext=nil, prereadtime=nil, userid=nil, required=nil, approversource=nil, customapprovertag=nil, registerinfo=nil, approveroption=nil, jumpurl=nil)
+        def initialize(approvertype=nil, organizationname=nil, approvername=nil, approvermobile=nil, approveridcardtype=nil, approveridcardnumber=nil, recipientid=nil, verifychannel=nil, notifytype=nil, isfulltext=nil, prereadtime=nil, userid=nil, required=nil, approversource=nil, customapprovertag=nil, registerinfo=nil, approveroption=nil, jumpurl=nil, signid=nil)
           @ApproverType = approvertype
           @OrganizationName = organizationname
           @ApproverName = approvername
@@ -3879,6 +4043,7 @@ module TencentCloud
           @RegisterInfo = registerinfo
           @ApproverOption = approveroption
           @JumpUrl = jumpurl
+          @SignId = signid
         end
 
         def deserialize(params)
@@ -3906,6 +4071,7 @@ module TencentCloud
             @ApproverOption.deserialize(params['ApproverOption'])
           end
           @JumpUrl = params['JumpUrl']
+          @SignId = params['SignId']
         end
       end
 
@@ -4324,6 +4490,43 @@ module TencentCloud
         end
       end
 
+      # 部门信息
+      class IntegrationDepartment < TencentCloud::Common::AbstractModel
+        # @param DeptId: 部门ID
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DeptId: String
+        # @param DeptName: 部门名
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DeptName: String
+        # @param ParentDeptId: 父部门ID
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ParentDeptId: String
+        # @param DeptOpenId: 客户系统部门ID
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type DeptOpenId: String
+        # @param OrderNo: 序列号
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OrderNo: Integer
+
+        attr_accessor :DeptId, :DeptName, :ParentDeptId, :DeptOpenId, :OrderNo
+        
+        def initialize(deptid=nil, deptname=nil, parentdeptid=nil, deptopenid=nil, orderno=nil)
+          @DeptId = deptid
+          @DeptName = deptname
+          @ParentDeptId = parentdeptid
+          @DeptOpenId = deptopenid
+          @OrderNo = orderno
+        end
+
+        def deserialize(params)
+          @DeptId = params['DeptId']
+          @DeptName = params['DeptName']
+          @ParentDeptId = params['ParentDeptId']
+          @DeptOpenId = params['DeptOpenId']
+          @OrderNo = params['OrderNo']
+        end
+      end
+
       # 主企业员工账号信息
       class IntegrationMainOrganizationUser < TencentCloud::Common::AbstractModel
         # @param MainOrganizationId: 主企业id
@@ -4397,6 +4600,61 @@ module TencentCloud
         end
       end
 
+      # ModifyIntegrationDepartment请求参数结构体
+      class ModifyIntegrationDepartmentRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 操作人信息，UserId必填且需拥有组织架构管理权限
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param DeptId: 电子签部门ID
+        # @type DeptId: String
+        # @param ParentDeptId: 电子签父部门ID
+        # @type ParentDeptId: String
+        # @param DeptName: 部门名称，不超过50个字符
+        # @type DeptName: String
+        # @param DeptOpenId: 客户系统部门ID，不超过64个字符
+        # @type DeptOpenId: String
+        # @param OrderNo: 排序号,1~30000范围内
+        # @type OrderNo: Integer
+
+        attr_accessor :Operator, :DeptId, :ParentDeptId, :DeptName, :DeptOpenId, :OrderNo
+        
+        def initialize(operator=nil, deptid=nil, parentdeptid=nil, deptname=nil, deptopenid=nil, orderno=nil)
+          @Operator = operator
+          @DeptId = deptid
+          @ParentDeptId = parentdeptid
+          @DeptName = deptname
+          @DeptOpenId = deptopenid
+          @OrderNo = orderno
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @DeptId = params['DeptId']
+          @ParentDeptId = params['ParentDeptId']
+          @DeptName = params['DeptName']
+          @DeptOpenId = params['DeptOpenId']
+          @OrderNo = params['OrderNo']
+        end
+      end
+
+      # ModifyIntegrationDepartment返回参数结构体
+      class ModifyIntegrationDepartmentResponse < TencentCloud::Common::AbstractModel
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RequestId
+        
+        def initialize(requestid=nil)
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RequestId = params['RequestId']
+        end
+      end
+
       # 持有的电子印章信息
       class OccupiedSeal < TencentCloud::Common::AbstractModel
         # @param SealId: 电子印章编号

metadata

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