tencentcloud-sdk-ess 3.0.755 → 3.0.756

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 79aca56a6c60e2eafbe734e361ef165f64033857
-  data.tar.gz: cbc810338fb4bfc7e309d5cb4ad4924aec72b14c
+  metadata.gz: d53a8719dfa7df3a9bf0be317a98bd255f9ae648
+  data.tar.gz: 8aa1e2b26d1da12a91997760dc0154ec2cd52782
 SHA512:
-  metadata.gz: 558d5712cbceddfbef3f225d344303c03676295a74307d4a3ef74892b93c1f5ba4444d0944d3028d9a1c41d1f2a24e12c40ad20c953f7151a29be2007a1d564d
-  data.tar.gz: 6220b61e6d8407c86311c12bc91133a5c4001929a1bbece276742f3cbf14459e61c36d050f8fa82d6e473ae33c2700155b7824c68e043639e57aca23d5e5857e
+  metadata.gz: 1af94f60d9ab386e1b6d13aa77e1298b64d66eeab456a8a9cc58726fa80fb20272dc3f3c47a1ac4926cab1d1f6ee364a3861b828ca47aa0654c14355e20cb2e7
+  data.tar.gz: 022f6b544dacb1c42eb46ccc55c6dd9985809528f0aa67609bb7788cda1a0f8cd8365e276eb51b3c28a75652ec822e0ac8a98b9a06615f96e667ddc0fd4c73a5

data/lib/VERSION

@@ -1 +1 @@
-3.0.755
+3.0.756

data/lib/v20201111/client.rb

@@ -378,8 +378,9 @@ module TencentCloud
         # 注：**静默（自动）签署不支持合同签署方存在填写**功能
         # <br>
 
-        # <font color="red">相关视频指引</font>
-        # <a href="https://dyn.ess.tencent.cn/guide/apivideo/createflow_seversign.mp4" target="_blank">创建静默（自动）签署模板和开通自动签署</a>
+        # <font color="red">相关视频指引</font> <br>
+        # 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/createflow_seversign.mp4" target="_blank">创建静默（自动）签署模板和开通自动签署</a><br>
+        # 2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/flow_document_start.mp4" target="_blank">用模版创建发起合同</a><br>
 
         # @param request: Request instance for CreateFlow.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowRequest`
@@ -2017,6 +2018,40 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 在已发起的签署流程中，我们支持对签署截止日期进行延期操作，主要涉及以下两个维度：
+        # 1. 合同（流程）维度：只需要传递流程ID，无需传递签署人ID。这将对尚未设定签署截止时间的合同（流程）和发起合同（流程）时的签署人进行延期操作。
+        # 2. 签署人维度：需要传递流程ID和签署人ID。此操作将对签署人进行延期操作，尤其对于有序的合同（流程），签署截止时间不能超过后一位合同（流程）签署人的流程截止时间。
+
+        # 此接口有如下限制条件：
+        # 1. 执行操作的员工需为发起方企业的超级管理员、法定代表人或签署流程的发起人。
+        # 2. 在延长整个签署流程时，签署流程应至少还有一方未签署（即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态）。
+        # 3. 在延长整个签署流程时，新的签署截止日期应晚于合同已设定的签署截止日期和当前日期。
+        # 4. 在延长签署方的截止时间时，签署方不能处于流程完结或已终止状态（即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态）。
+        # 5. 在延长签署方的截止时间时，签署方的新签署截止日期应晚于当前日期和签署方已设定的截止日期。若为有序合同，还应早于或等于下一签署人的截止日期，且早于签署流程整体的截止日期。
+        # 6. 不支持操作合同组合同。
+
+        # @param request: Request instance for ModifyFlowDeadline.
+        # @type request: :class:`Tencentcloud::ess::V20201111::ModifyFlowDeadlineRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::ModifyFlowDeadlineResponse`
+        def ModifyFlowDeadline(request)
+          body = send_request('ModifyFlowDeadline', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ModifyFlowDeadlineResponse.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
+
         # 此接口（ModifyIntegrationDepartment）用于更新企业的部门信息，支持更新部门名称、客户系统部门ID和部门序号等信息。
 
         # @param request: Request instance for ModifyIntegrationDepartment.

data/lib/v20201111/models.rb

@@ -216,10 +216,14 @@ module TencentCloud
         # @type AddSignComponentsLimits: Array
         # @param SignInstructionContent: 签署须知：支持传入富文本，最长字数：500个中文字符
         # @type SignInstructionContent: String
+        # @param Deadline: 签署人的签署截止时间，格式为Unix标准时间戳（秒）
 
-        attr_accessor :ApproverType, :ApproverName, :ApproverMobile, :OrganizationName, :SignComponents, :ApproverIdCardType, :ApproverIdCardNumber, :NotifyType, :ApproverRole, :ApproverRoleName, :VerifyChannel, :PreReadTime, :UserId, :ApproverSource, :CustomApproverTag, :ApproverOption, :ApproverVerifyTypes, :ApproverSignTypes, :ApproverNeedSignReview, :AddSignComponentsLimits, :SignInstructionContent
+        # 注: `若不设置此参数，则默认使用合同的截止时间，此参数暂不支持合同组子合同`
+        # @type Deadline: Integer
+
+        attr_accessor :ApproverType, :ApproverName, :ApproverMobile, :OrganizationName, :SignComponents, :ApproverIdCardType, :ApproverIdCardNumber, :NotifyType, :ApproverRole, :ApproverRoleName, :VerifyChannel, :PreReadTime, :UserId, :ApproverSource, :CustomApproverTag, :ApproverOption, :ApproverVerifyTypes, :ApproverSignTypes, :ApproverNeedSignReview, :AddSignComponentsLimits, :SignInstructionContent, :Deadline
 
-        def initialize(approvertype=nil, approvername=nil, approvermobile=nil, organizationname=nil, signcomponents=nil, approveridcardtype=nil, approveridcardnumber=nil, notifytype=nil, approverrole=nil, approverrolename=nil, verifychannel=nil, prereadtime=nil, userid=nil, approversource=nil, customapprovertag=nil, approveroption=nil, approververifytypes=nil, approversigntypes=nil, approverneedsignreview=nil, addsigncomponentslimits=nil, signinstructioncontent=nil)
+        def initialize(approvertype=nil, approvername=nil, approvermobile=nil, organizationname=nil, signcomponents=nil, approveridcardtype=nil, approveridcardnumber=nil, notifytype=nil, approverrole=nil, approverrolename=nil, verifychannel=nil, prereadtime=nil, userid=nil, approversource=nil, customapprovertag=nil, approveroption=nil, approververifytypes=nil, approversigntypes=nil, approverneedsignreview=nil, addsigncomponentslimits=nil, signinstructioncontent=nil, deadline=nil)
           @ApproverType = approvertype
           @ApproverName = approvername
           @ApproverMobile = approvermobile
@@ -241,6 +245,7 @@ module TencentCloud
           @ApproverNeedSignReview = approverneedsignreview
           @AddSignComponentsLimits = addsigncomponentslimits
           @SignInstructionContent = signinstructioncontent
+          @Deadline = deadline
         end
 
         def deserialize(params)
@@ -282,6 +287,7 @@ module TencentCloud
             end
           end
           @SignInstructionContent = params['SignInstructionContent']
+          @Deadline = params['Deadline']
         end
       end
 
@@ -7199,13 +7205,18 @@ module TencentCloud
         # 注：
         # `不指定该值时，默认为签署方自行选择。`
         # @type SignTypeSelector: Integer
+        # @param Deadline: Deadline
+        # 签署人的签署截止时间，格式为Unix标准时间戳（秒）
 
-        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, :SignTypeSelector
+        # 注: `若不设置此参数，则默认使用合同的截止时间，此参数暂不支持合同组子合同`
+        # @type Deadline: Integer
+
+        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, :SignTypeSelector, :Deadline
         extend Gem::Deprecate
         deprecate :JumpUrl, :none, 2024, 1
         deprecate :JumpUrl=, :none, 2024, 1
 
-        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, approverneedsignreview=nil, signcomponents=nil, components=nil, componentlimittype=nil, approververifytypes=nil, approversigntypes=nil, signtypeselector=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, approverneedsignreview=nil, signcomponents=nil, components=nil, componentlimittype=nil, approververifytypes=nil, approversigntypes=nil, signtypeselector=nil, deadline=nil)
           @ApproverType = approvertype
           @OrganizationName = organizationname
           @ApproverName = approvername
@@ -7232,6 +7243,7 @@ module TencentCloud
           @ApproverVerifyTypes = approververifytypes
           @ApproverSignTypes = approversigntypes
           @SignTypeSelector = signtypeselector
+          @Deadline = deadline
         end
 
         def deserialize(params)
@@ -7281,6 +7293,7 @@ module TencentCloud
           @ApproverVerifyTypes = params['ApproverVerifyTypes']
           @ApproverSignTypes = params['ApproverSignTypes']
           @SignTypeSelector = params['SignTypeSelector']
+          @Deadline = params['Deadline']
         end
       end
 
@@ -8250,6 +8263,66 @@ module TencentCloud
         end
       end
 
+      # ModifyFlowDeadline请求参数结构体
+      class ModifyFlowDeadlineRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # <ul><li>建议开发者妥善保存此流程ID，以便于顺利进行后续操作。</li>
+        # <li>可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。</li></ul>
+        # @type FlowId: String
+        # @param Deadline: 签署流程或签署人新的签署截止时间，格式为Unix标准时间戳（秒）
+        # @type Deadline: Integer
+        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param RecipientId: 签署方角色编号，为32位字符串
+        # <ul><li>若指定了此参数，则只调整签署流程中此签署人的签署截止时间，否则调整合同整体的签署截止时间（合同截止时间+发起时未设置签署人截止时间的参与人的签署截止时间）</li>
+        # <li>通过[用PDF文件创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles)发起合同，或通过[模板发起合同-创建电子文档](https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument)时，返回参数[Approvers](https://qian.tencent.com/developers/companyApis/dataTypes/#approveritem)会返回此信息，建议开发者妥善保存</li>
+        # <li>也可通过[查询合同流程的详情信息](https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo)接口查询签署人的RecipientId编号</li></ul>
+        # @type RecipientId: String
+
+        attr_accessor :Operator, :FlowId, :Deadline, :Agent, :RecipientId
+
+        def initialize(operator=nil, flowid=nil, deadline=nil, agent=nil, recipientid=nil)
+          @Operator = operator
+          @FlowId = flowid
+          @Deadline = deadline
+          @Agent = agent
+          @RecipientId = recipientid
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @FlowId = params['FlowId']
+          @Deadline = params['Deadline']
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @RecipientId = params['RecipientId']
+        end
+      end
+
+      # ModifyFlowDeadline返回参数结构体
+      class ModifyFlowDeadlineResponse < 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
+
       # ModifyIntegrationDepartment请求参数结构体
       class ModifyIntegrationDepartmentRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.755
+  version: 3.0.756
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-22 00:00:00.000000000 Z
+date: 2024-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,8 +33,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/v20201111/client.rb
 - lib/v20201111/models.rb
+- lib/v20201111/client.rb
 - lib/tencentcloud-sdk-ess.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby