tencentcloud-sdk-ess 3.0.384 → 3.0.387

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a4334c59112619aed2b085442c9a5b26ea118d19
-  data.tar.gz: 0b68715c351cccacc6039b102c79605e977293ba
+  metadata.gz: 33503f0ccc0b93764f53f418655dcac5fbe77b19
+  data.tar.gz: 7d92d42725926657621e38898aa23cc56d06175d
 SHA512:
-  metadata.gz: de5ee88b9f85ff9a1da282c9d000813b9d28f3ff37ae2742ae27e0796a718a12ade8ba7067c855d98fec87e4836b213e1aa6ea18d079e0674f26545395030957
-  data.tar.gz: bfeaa2fe268ad6a0452cc1fc4ba4293dc82c115d04b88909330825a7bc4a84b84a98c560447bb00bd83f6cc231156ea79d65ce1d27b21ea23aea6346e52047c1
+  metadata.gz: 9fa55903e8ed28564c482018fcdab8644d84d714cb61e2e0b6083b5028cc6ed3ea01158644f6a4844547be3344aabc301630f02e04975f75f60c8ac850ddb8cd
+  data.tar.gz: 94e7946f8fef2898e91c39cdbf2a728927d0eff9058a07eaa1e37b97cec9b5457bedb8b5fd454895b230d1851f35b7ee3077edc150136aebec7a6f427b959997

data/lib/VERSION

@@ -1 +1 @@
-3.0.384
+3.0.387

data/lib/v20201111/client.rb

@@ -208,6 +208,33 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 提交企业签署流程审批结果
+        # 适用场景:
+        # 在通过接口(CreateFlow 或者CreateFlowByFiles)创建签署流程时，若指定了参数 NeedSignReview 为true,则可以调用此接口提交企业内部签署审批结果。
+        # 若签署流程状态正常，且本企业存在签署方未签署，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
+
+        # @param request: Request instance for CreateFlowSignReview.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowSignReviewRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateFlowSignReviewResponse`
+        def CreateFlowSignReview(request)
+          body = send_request('CreateFlowSignReview', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateFlowSignReviewResponse.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
+
         # 此接口（CreateMultiFlowSignQRCode）用于创建一码多扫流程签署二维码。
         # 适用场景：无需填写签署人信息，可通过模板id生成签署二维码，签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景，例如：劳务工招工、大批量员工入职等场景。
         # 适用的模板仅限于B2C（1、无序签署，2、顺序签署时B静默签署，3、顺序签署时B非首位签署）、单C的模板，且模板中发起方没有填写控件。

data/lib/v20201111/models.rb

@@ -586,7 +586,7 @@ module TencentCloud
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param FlowName: 签署流程名称,最大长度200个字符
         # @type FlowName: String
-        # @param Approvers: 签署参与者信息
+        # @param Approvers: 签署参与者信息，最大限制50方
         # @type Approvers: Array
         # @param FileIds: 签署pdf文件的资源编号列表，通过UploadFiles接口获取
         # @type FileIds: Array
@@ -612,12 +612,17 @@ module TencentCloud
         # @type Unordered: Boolean
         # @param CustomShowMap: 合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
         # @type CustomShowMap: String
+        # @param NeedSignReview: 发起方企业的签署人进行签署操作是否需要企业内部审批。
+        # 若设置为true,审核结果需通过接口 CreateFlowSignReview 通知电子签，审核通过后，发起方企业签署人方可进行签署操作，否则会阻塞其签署操作。
+
+        # 注：企业可以通过此功能与企业内部的审批流程进行关联，支持手动、静默签署合同。
+        # @type NeedSignReview: Boolean
         # @param Agent: 应用号信息
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
-        attr_accessor :Operator, :FlowName, :Approvers, :FileIds, :FlowType, :Components, :CcInfos, :NeedPreview, :FlowDescription, :Deadline, :Unordered, :CustomShowMap, :Agent
+        attr_accessor :Operator, :FlowName, :Approvers, :FileIds, :FlowType, :Components, :CcInfos, :NeedPreview, :FlowDescription, :Deadline, :Unordered, :CustomShowMap, :NeedSignReview, :Agent
         
-        def initialize(operator=nil, flowname=nil, approvers=nil, fileids=nil, flowtype=nil, components=nil, ccinfos=nil, needpreview=nil, flowdescription=nil, deadline=nil, unordered=nil, customshowmap=nil, agent=nil)
+        def initialize(operator=nil, flowname=nil, approvers=nil, fileids=nil, flowtype=nil, components=nil, ccinfos=nil, needpreview=nil, flowdescription=nil, deadline=nil, unordered=nil, customshowmap=nil, needsignreview=nil, agent=nil)
           @Operator = operator
           @FlowName = flowname
           @Approvers = approvers
@@ -630,6 +635,7 @@ module TencentCloud
           @Deadline = deadline
           @Unordered = unordered
           @CustomShowMap = customshowmap
+          @NeedSignReview = needsignreview
           @Agent = agent
         end
 
@@ -670,6 +676,7 @@ module TencentCloud
           @Deadline = params['Deadline']
           @Unordered = params['Unordered']
           @CustomShowMap = params['CustomShowMap']
+          @NeedSignReview = params['NeedSignReview']
           unless params['Agent'].nil?
             @Agent = Agent.new
             @Agent.deserialize(params['Agent'])
@@ -708,7 +715,7 @@ module TencentCloud
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param FlowName: 签署流程名称,最大长度200个字符
         # @type FlowName: String
-        # @param Approvers: 签署流程参与者信息
+        # @param Approvers: 签署流程参与者信息，最大限制50方
         # @type Approvers: Array
         # @param FlowType: 签署流程的类型(如销售合同/入职合同等)，最大长度200个字符
         # @type FlowType: String
@@ -730,14 +737,19 @@ module TencentCloud
         # @type Unordered: Boolean
         # @param CustomShowMap: 合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
         # @type CustomShowMap: String
+        # @param NeedSignReview: 发起方企业的签署人进行签署操作是否需要企业内部审批。
+        # 若设置为true,审核结果需通过接口 CreateFlowSignReview 通知电子签，审核通过后，发起方企业签署人方可进行签署操作，否则会阻塞其签署操作。
+
+        # 注：企业可以通过此功能与企业内部的审批流程进行关联，支持手动、静默签署合同。
+        # @type NeedSignReview: Boolean
         # @param RelatedFlowId: 暂未开放
         # @type RelatedFlowId: String
         # @param Agent: 应用相关信息
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
-        attr_accessor :Operator, :FlowName, :Approvers, :FlowType, :ClientToken, :CallbackUrl, :DeadLine, :UserData, :FlowDescription, :Unordered, :CustomShowMap, :RelatedFlowId, :Agent
+        attr_accessor :Operator, :FlowName, :Approvers, :FlowType, :ClientToken, :CallbackUrl, :DeadLine, :UserData, :FlowDescription, :Unordered, :CustomShowMap, :NeedSignReview, :RelatedFlowId, :Agent
         
-        def initialize(operator=nil, flowname=nil, approvers=nil, flowtype=nil, clienttoken=nil, callbackurl=nil, deadline=nil, userdata=nil, flowdescription=nil, unordered=nil, customshowmap=nil, relatedflowid=nil, agent=nil)
+        def initialize(operator=nil, flowname=nil, approvers=nil, flowtype=nil, clienttoken=nil, callbackurl=nil, deadline=nil, userdata=nil, flowdescription=nil, unordered=nil, customshowmap=nil, needsignreview=nil, relatedflowid=nil, agent=nil)
           @Operator = operator
           @FlowName = flowname
           @Approvers = approvers
@@ -749,6 +761,7 @@ module TencentCloud
           @FlowDescription = flowdescription
           @Unordered = unordered
           @CustomShowMap = customshowmap
+          @NeedSignReview = needsignreview
           @RelatedFlowId = relatedflowid
           @Agent = agent
         end
@@ -775,6 +788,7 @@ module TencentCloud
           @FlowDescription = params['FlowDescription']
           @Unordered = params['Unordered']
           @CustomShowMap = params['CustomShowMap']
+          @NeedSignReview = params['NeedSignReview']
           @RelatedFlowId = params['RelatedFlowId']
           unless params['Agent'].nil?
             @Agent = Agent.new
@@ -803,6 +817,63 @@ module TencentCloud
         end
       end
 
+      # CreateFlowSignReview请求参数结构体
+      class CreateFlowSignReviewRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 调用方用户信息，userId 必填
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param FlowId: 签署流程编号
+        # @type FlowId: String
+        # @param ReviewType: 企业内部审核结果
+        # PASS: 通过
+        # REJECT: 拒绝
+        # @type ReviewType: String
+        # @param ReviewMessage: 审核原因
+        # 当ReviewType 是REJECT 时此字段必填,字符串长度不超过200
+        # @type ReviewMessage: String
+        # @param Agent: 应用相关信息
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+
+        attr_accessor :Operator, :FlowId, :ReviewType, :ReviewMessage, :Agent
+        
+        def initialize(operator=nil, flowid=nil, reviewtype=nil, reviewmessage=nil, agent=nil)
+          @Operator = operator
+          @FlowId = flowid
+          @ReviewType = reviewtype
+          @ReviewMessage = reviewmessage
+          @Agent = agent
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @FlowId = params['FlowId']
+          @ReviewType = params['ReviewType']
+          @ReviewMessage = params['ReviewMessage']
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+        end
+      end
+
+      # CreateFlowSignReview返回参数结构体
+      class CreateFlowSignReviewResponse < 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
+
       # CreateMultiFlowSignQRCode请求参数结构体
       class CreateMultiFlowSignQRCodeRequest < TencentCloud::Common::AbstractModel
         # @param TemplateId: 模板ID

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.384
+  version: 3.0.387
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-10 00:00:00.000000000 Z
+date: 2022-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common