tencentcloud-sdk-ess 3.0.1009 → 3.0.1011

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cea25ecc5504264e59077909c6698d709adc2ada
-  data.tar.gz: a844892967d5f54281756a5e049501259d493ae5
+  metadata.gz: aa9f02653dac5fa74b69ef8fb7f04412a05caf5e
+  data.tar.gz: 642828eb9e66fc1e49098b5a8c37bb83ddb20eef
 SHA512:
-  metadata.gz: a9ec724b249e6f22052f94e59bf68438d4289730dc3f56418d4210964df8c2bd140dc626a603021afdaffcaaf302aeb952935d87b42295373b168b25a41cffa1
-  data.tar.gz: a7aa3da64d1093001d66ae367563d06e89e262dea65dcd4125dd4aa74a724ebc9b8acfd804864afd194c6df94fcd727dc8f85a571159ec8e24264cdece2ac479
+  metadata.gz: e03a076a911d725d7c71d556c11767d353f87fd5c6d904a43a4510c02a6c46eb4ec03ea3620b24a8b1607f585143919aa23a873a2dabcf764300e508a536aea4
+  data.tar.gz: 44bab2b45e1618ba05eeb343538cadcf8cdc940b597d2df0122499099ad05b53be0bce9fd6412691810b407448f1368779867b2ef914bc39c23cf8850f80967a

data/lib/VERSION

@@ -1 +1 @@
-3.0.1009
+3.0.1011

data/lib/v20201111/client.rb

@@ -939,6 +939,37 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 该接口用于将合同中本企业当前经办人转为本企业其他员工进行操作。
+
+        # 注意：
+        # 1. 转交的目标经办人需要已经加入企业，且完成实名。
+        # 2. 仅企业拥有`超管`、`法人`或者`合同管理员`角色的员工才有调用本接口的权限。如果使用主带子方式调用，请确保您已经加入子企业，且账号在子企业中担任任一上述角色。
+        # 3. 仅支持当前经办人为待签署或待填写状态时进行转交操作。
+        # 4. 若原合同有填写控件，且当前经办人已经完成填写，则不支持进行转交。
+        # 5. 若当前经办人已签署完成，或者处于签署流程中，则不支持进行转交。
+
+        # @param request: Request instance for CreateFlowForwards.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowForwardsRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateFlowForwardsResponse`
+        def CreateFlowForwards(request)
+          body = send_request('CreateFlowForwards', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateFlowForwardsResponse.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
+
         # 此接口（CreateFlowGroupByFiles）可用于通过多个文件创建合同组签署流程。使用该接口需要先依赖[多文件上传](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口返回的FileIds。
 
         # - 该接口允许通过PDF资源ID一次性创建多个合同，这些合同被组织在一个合同组中。

data/lib/v20201111/models.rb

@@ -3233,6 +3233,80 @@ module TencentCloud
         end
       end
 
+      # CreateFlowForwards请求参数结构体
+      class CreateFlowForwardsRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param TargetUserId: 合同对应参与方需要修改的目标经办人。其UserId可在企业控制台中组织管理里面找到。或者使用获取员工信息接口得到。
+
+        # 注意：`需要保证目标经办人已经加入企业且已实名`
+        # @type TargetUserId: String
+        # @param FlowForwardInfos: 企业签署方的合同及对应签署方
+        # @type FlowForwardInfos: Array
+        # @param Agent: 代理企业和员工的信息。在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+
+        attr_accessor :Operator, :TargetUserId, :FlowForwardInfos, :Agent
+
+        def initialize(operator=nil, targetuserid=nil, flowforwardinfos=nil, agent=nil)
+          @Operator = operator
+          @TargetUserId = targetuserid
+          @FlowForwardInfos = flowforwardinfos
+          @Agent = agent
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @TargetUserId = params['TargetUserId']
+          unless params['FlowForwardInfos'].nil?
+            @FlowForwardInfos = []
+            params['FlowForwardInfos'].each do |i|
+              flowforwardinfo_tmp = FlowForwardInfo.new
+              flowforwardinfo_tmp.deserialize(i)
+              @FlowForwardInfos << flowforwardinfo_tmp
+            end
+          end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+        end
+      end
+
+      # CreateFlowForwards返回参数结构体
+      class CreateFlowForwardsResponse < TencentCloud::Common::AbstractModel
+        # @param FailedFlows: 失败的合同id以及错误详情
+        # @type FailedFlows: Array
+        # @param SuccessFlows: 成功的合同id
+        # @type SuccessFlows: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :FailedFlows, :SuccessFlows, :RequestId
+
+        def initialize(failedflows=nil, successflows=nil, requestid=nil)
+          @FailedFlows = failedflows
+          @SuccessFlows = successflows
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['FailedFlows'].nil?
+            @FailedFlows = []
+            params['FailedFlows'].each do |i|
+              flowforwardresult_tmp = FlowForwardResult.new
+              flowforwardresult_tmp.deserialize(i)
+              @FailedFlows << flowforwardresult_tmp
+            end
+          end
+          @SuccessFlows = params['SuccessFlows']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateFlowGroupByFiles请求参数结构体
       class CreateFlowGroupByFilesRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。
@@ -9182,10 +9256,8 @@ module TencentCloud
       # 删除员工失败数据
       class FailedDeleteStaffData < TencentCloud::Common::AbstractModel
         # @param UserId: 员工在电子签的userId
-        # 注意：此字段可能返回 null，表示取不到有效值。
         # @type UserId: String
         # @param OpenId: 员工在第三方平台的openId
-        # 注意：此字段可能返回 null，表示取不到有效值。
         # @type OpenId: String
         # @param Reason: 失败原因
         # @type Reason: String
@@ -10018,6 +10090,46 @@ module TencentCloud
         end
       end
 
+      # 合同转交相关信息
+      class FlowForwardInfo < TencentCloud::Common::AbstractModel
+        # @param FlowId: 合同流程ID，为32位字符串。此接口的合同流程ID需要由[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)接口创建得到。
+        # @type FlowId: String
+        # @param RecipientId: 签署方经办人在合同中的参与方ID，为32位字符串。
+        # @type RecipientId: String
+
+        attr_accessor :FlowId, :RecipientId
+
+        def initialize(flowid=nil, recipientid=nil)
+          @FlowId = flowid
+          @RecipientId = recipientid
+        end
+
+        def deserialize(params)
+          @FlowId = params['FlowId']
+          @RecipientId = params['RecipientId']
+        end
+      end
+
+      # 转交合同结果
+      class FlowForwardResult < TencentCloud::Common::AbstractModel
+        # @param FlowId: 合同流程ID为32位字符串。您可以登录腾讯电子签控制台，在 "合同" -> "合同中心" 中查看某个合同的FlowId（在页面中展示为合同ID）。[点击查看FlowId在控制台中的位置](https://qcloudimg.tencent-cloud.cn/raw/0a83015166cfe1cb043d14f9ec4bd75e.png)。
+        # @type FlowId: String
+        # @param ErrorDetail: 如果失败，返回的错误细节。
+        # @type ErrorDetail: String
+
+        attr_accessor :FlowId, :ErrorDetail
+
+        def initialize(flowid=nil, errordetail=nil)
+          @FlowId = flowid
+          @ErrorDetail = errordetail
+        end
+
+        def deserialize(params)
+          @FlowId = params['FlowId']
+          @ErrorDetail = params['ErrorDetail']
+        end
+      end
+
       # 合同组相关信息，指定合同组子合同和签署方的信息，用于补充动态签署人。
       class FlowGroupApproverInfo < TencentCloud::Common::AbstractModel
         # @param FlowId: 合同流程ID。
@@ -10889,7 +11001,6 @@ module TencentCloud
       # 意愿核身点头确认模式结果
       class IntentionActionResult < TencentCloud::Common::AbstractModel
         # @param Details: 意愿核身结果详细数据，与每段点头确认过程一一对应
-        # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Details: Array
 
         attr_accessor :Details

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.1009
+  version: 3.0.1011
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-02 00:00:00.000000000 Z
+date: 2025-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common