tencentcloud-sdk-ess 3.0.402 → 3.0.405

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c4e22724ee37c274caf4a995650398b6e2717ca0
-  data.tar.gz: 80c99f6550ecb8465b5b6dce5e8a100e8792227c
+  metadata.gz: 39cc4e0613d50fcdecb043429192de0d6c7ff320
+  data.tar.gz: 5b9f2c8fd172a30b24871d374cb332def5649583
 SHA512:
-  metadata.gz: 70d2852b9f7dfbe7cb5ce4beb0fd41c041023a5550aa7d310de3f1d997b94b39dd8a3508d7d0bb62b44bad3f1a740d7c052776ba6aa04206c2aab93ee2865f9c
-  data.tar.gz: 9fe4b4a8358991eb52a94c68e34fbdf0832db850f5e01a200692e3823a7ee11f022ee4bbec0beea33e9f759ccdd75977ebec7bcbf434289f81cbf7cbbcac5ce7
+  metadata.gz: 664ae12f3ff2f1b77443b1ca034db79f15e6b01719cffd3c48c9da3c7ac42de3f32733f92b0b653ef7944d382fb8748f00da9eff71b5f39b023b0aaa10b12bb6
+  data.tar.gz: d8944d7950bc7a9d23d8c6ca8d4c68312088a2a7c046bd11d76048004b0ae9170f915e91013b64a4fd96ae5443574f5c0c2b0cd29ebcaf8bd33932245f162adb

data/lib/VERSION

@@ -1 +1 @@
-3.0.402
+3.0.405

data/lib/v20201111/client.rb

@@ -181,6 +181,34 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 补充签署流程本企业签署人信息
+        # 适用场景：在通过模版或者文件发起合同时，若未指定本企业签署人信息，则流程发起后，可以调用此接口补充签署人。
+        # 同一签署人可以补充多个员工作为候选签署人,最终签署人取决于谁先领取合同完成签署。
+
+        # 注：目前暂时只支持补充来源于企业微信的员工作为候选签署人
+
+        # @param request: Request instance for CreateFlowApprovers.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowApproversRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateFlowApproversResponse`
+        def CreateFlowApprovers(request)
+          body = send_request('CreateFlowApprovers', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateFlowApproversResponse.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
+
         # 此接口（CreateFlowByFiles）用来通过上传后的pdf资源编号来创建待签署的合同流程。
         # 适用场景1：适用非制式的合同文件签署。一般开发者自己有完整的签署文件，可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
         # 适用场景2：可通过该接口传入制式合同文件，同时在指定位置添加签署控件。可以起到接口创建临时模板的效果。如果是标准的制式文件，建议使用模板功能生成模板ID进行合同流程的生成。
@@ -370,6 +398,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询合同详情
+        # 适用场景：可用于主动查询某个合同详情信息。
+
+        # @param request: Request instance for DescribeFlowInfo.
+        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeFlowInfoRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeFlowInfoResponse`
+        def DescribeFlowInfo(request)
+          body = send_request('DescribeFlowInfo', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeFlowInfoResponse.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

@@ -59,10 +59,16 @@ module TencentCloud
         # @type VerifyChannel: Array
         # @param PreReadTime: 合同的强制预览时间：3~300s，未指定则按合同页数计算
         # @type PreReadTime: Integer
+        # @param UserId: 签署人userId，非企微场景不使用此字段
+        # @type UserId: String
+        # @param ApproverSource: 签署人用户来源,企微侧用户请传入：WEWORKAPP
+        # @type ApproverSource: String
+        # @param CustomApproverTag: 客户自定义签署人标识，64位长度，保证唯一，非企微场景不使用此字段
+        # @type CustomApproverTag: String
 
-        attr_accessor :ApproverType, :ApproverName, :ApproverMobile, :SignComponents, :OrganizationName, :ApproverIdCardNumber, :ApproverIdCardType, :NotifyType, :ApproverRole, :VerifyChannel, :PreReadTime
+        attr_accessor :ApproverType, :ApproverName, :ApproverMobile, :SignComponents, :OrganizationName, :ApproverIdCardNumber, :ApproverIdCardType, :NotifyType, :ApproverRole, :VerifyChannel, :PreReadTime, :UserId, :ApproverSource, :CustomApproverTag
         
-        def initialize(approvertype=nil, approvername=nil, approvermobile=nil, signcomponents=nil, organizationname=nil, approveridcardnumber=nil, approveridcardtype=nil, notifytype=nil, approverrole=nil, verifychannel=nil, prereadtime=nil)
+        def initialize(approvertype=nil, approvername=nil, approvermobile=nil, signcomponents=nil, organizationname=nil, approveridcardnumber=nil, approveridcardtype=nil, notifytype=nil, approverrole=nil, verifychannel=nil, prereadtime=nil, userid=nil, approversource=nil, customapprovertag=nil)
           @ApproverType = approvertype
           @ApproverName = approvername
           @ApproverMobile = approvermobile
@@ -74,6 +80,9 @@ module TencentCloud
           @ApproverRole = approverrole
           @VerifyChannel = verifychannel
           @PreReadTime = prereadtime
+          @UserId = userid
+          @ApproverSource = approversource
+          @CustomApproverTag = customapprovertag
         end
 
         def deserialize(params)
@@ -95,6 +104,9 @@ module TencentCloud
           @ApproverRole = params['ApproverRole']
           @VerifyChannel = params['VerifyChannel']
           @PreReadTime = params['PreReadTime']
+          @UserId = params['UserId']
+          @ApproverSource = params['ApproverSource']
+          @CustomApproverTag = params['CustomApproverTag']
         end
       end
 
@@ -580,6 +592,56 @@ module TencentCloud
         end
       end
 
+      # CreateFlowApprovers请求参数结构体
+      class CreateFlowApproversRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 调用方用户信息，userId 必填
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param FlowId: 签署流程编号
+        # @type FlowId: String
+        # @param Approvers: 补充签署人信息
+        # @type Approvers: Array
+
+        attr_accessor :Operator, :FlowId, :Approvers
+        
+        def initialize(operator=nil, flowid=nil, approvers=nil)
+          @Operator = operator
+          @FlowId = flowid
+          @Approvers = approvers
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @FlowId = params['FlowId']
+          unless params['Approvers'].nil?
+            @Approvers = []
+            params['Approvers'].each do |i|
+              fillapproverinfo_tmp = FillApproverInfo.new
+              fillapproverinfo_tmp.deserialize(i)
+              @Approvers << fillapproverinfo_tmp
+            end
+          end
+        end
+      end
+
+      # CreateFlowApprovers返回参数结构体
+      class CreateFlowApproversResponse < 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
+
       # CreateFlowByFiles请求参数结构体
       class CreateFlowByFilesRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 调用方用户信息，userId 必填
@@ -1239,6 +1301,56 @@ module TencentCloud
         end
       end
 
+      # DescribeFlowInfo请求参数结构体
+      class DescribeFlowInfoRequest < TencentCloud::Common::AbstractModel
+        # @param FlowIds: 需要查询的流程ID列表，限制最大100个
+        # @type FlowIds: Array
+        # @param Operator: 调用方用户信息
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+
+        attr_accessor :FlowIds, :Operator
+        
+        def initialize(flowids=nil, operator=nil)
+          @FlowIds = flowids
+          @Operator = operator
+        end
+
+        def deserialize(params)
+          @FlowIds = params['FlowIds']
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+        end
+      end
+
+      # DescribeFlowInfo返回参数结构体
+      class DescribeFlowInfoResponse < TencentCloud::Common::AbstractModel
+        # @param FlowDetailInfos: 签署流程信息
+        # @type FlowDetailInfos: Array
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :FlowDetailInfos, :RequestId
+        
+        def initialize(flowdetailinfos=nil, requestid=nil)
+          @FlowDetailInfos = flowdetailinfos
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['FlowDetailInfos'].nil?
+            @FlowDetailInfos = []
+            params['FlowDetailInfos'].each do |i|
+              flowdetailinfo_tmp = FlowDetailInfo.new
+              flowdetailinfo_tmp.deserialize(i)
+              @FlowDetailInfos << flowdetailinfo_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeFlowTemplates请求参数结构体
       class DescribeFlowTemplatesRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 调用方用户信息，userId 必填
@@ -1408,6 +1520,32 @@ module TencentCloud
         end
       end
 
+      # 补充签署人信息
+      class FillApproverInfo < TencentCloud::Common::AbstractModel
+        # @param RecipientId: 签署人签署Id
+        # @type RecipientId: String
+        # @param ApproverSource: 签署人来源
+        # WEWORKAPP: 企业微信
+        # @type ApproverSource: String
+        # @param CustomUserId: 企业自定义账号Id
+        # WEWORKAPP场景下指企业自有应用获取企微明文的userid
+        # @type CustomUserId: String
+
+        attr_accessor :RecipientId, :ApproverSource, :CustomUserId
+        
+        def initialize(recipientid=nil, approversource=nil, customuserid=nil)
+          @RecipientId = recipientid
+          @ApproverSource = approversource
+          @CustomUserId = customuserid
+        end
+
+        def deserialize(params)
+          @RecipientId = params['RecipientId']
+          @ApproverSource = params['ApproverSource']
+          @CustomUserId = params['CustomUserId']
+        end
+      end
+
       # 查询过滤条件
       class Filter < TencentCloud::Common::AbstractModel
         # @param Key: 查询过滤条件的Key
@@ -1428,6 +1566,87 @@ module TencentCloud
         end
       end
 
+      # 签署人详情信息
+      class FlowApproverDetail < TencentCloud::Common::AbstractModel
+        # @param ApproveMessage: 签署人信息
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ApproveMessage: String
+        # @param ApproveName: 签署人名字
+        # @type ApproveName: String
+        # @param ApproveStatus: 签署人的状态
+        # 0：还没有发起
+        # 1：流程中 没有开始处理
+        # 2：待处理
+        # 3：签署态
+        # 4：拒绝态
+        # 5：过期没人处理
+        # 6：取消态
+        # 7：还没有预发起
+        # 8：待填写
+        # 9：因为各种原因而终止
+        # @type ApproveStatus: Integer
+        # @param ReceiptId: 模板配置时候的签署人id,与控件绑定
+        # @type ReceiptId: String
+        # @param CustomUserId: 客户自定义userId
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CustomUserId: String
+        # @param Mobile: 签署人手机号
+        # @type Mobile: String
+        # @param SignOrder: 签署顺序
+        # @type SignOrder: Integer
+        # @param ApproveTime: 签署人签署时间
+        # @type ApproveTime: Integer
+        # @param ApproveType: 参与者类型
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ApproveType: String
+        # @param ApproverSource: 签署人侧用户来源
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ApproverSource: String
+        # @param CustomApproverTag: 客户自定义签署人标识
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CustomApproverTag: String
+        # @param OrganizationId: 签署人企业Id
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OrganizationId: String
+        # @param OrganizationName: 签署人企业名称
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OrganizationName: String
+
+        attr_accessor :ApproveMessage, :ApproveName, :ApproveStatus, :ReceiptId, :CustomUserId, :Mobile, :SignOrder, :ApproveTime, :ApproveType, :ApproverSource, :CustomApproverTag, :OrganizationId, :OrganizationName
+        
+        def initialize(approvemessage=nil, approvename=nil, approvestatus=nil, receiptid=nil, customuserid=nil, mobile=nil, signorder=nil, approvetime=nil, approvetype=nil, approversource=nil, customapprovertag=nil, organizationid=nil, organizationname=nil)
+          @ApproveMessage = approvemessage
+          @ApproveName = approvename
+          @ApproveStatus = approvestatus
+          @ReceiptId = receiptid
+          @CustomUserId = customuserid
+          @Mobile = mobile
+          @SignOrder = signorder
+          @ApproveTime = approvetime
+          @ApproveType = approvetype
+          @ApproverSource = approversource
+          @CustomApproverTag = customapprovertag
+          @OrganizationId = organizationid
+          @OrganizationName = organizationname
+        end
+
+        def deserialize(params)
+          @ApproveMessage = params['ApproveMessage']
+          @ApproveName = params['ApproveName']
+          @ApproveStatus = params['ApproveStatus']
+          @ReceiptId = params['ReceiptId']
+          @CustomUserId = params['CustomUserId']
+          @Mobile = params['Mobile']
+          @SignOrder = params['SignOrder']
+          @ApproveTime = params['ApproveTime']
+          @ApproveType = params['ApproveType']
+          @ApproverSource = params['ApproverSource']
+          @CustomApproverTag = params['CustomApproverTag']
+          @OrganizationId = params['OrganizationId']
+          @OrganizationName = params['OrganizationName']
+        end
+      end
+
       # 流程信息摘要
       class FlowBrief < TencentCloud::Common::AbstractModel
         # @param FlowId: 流程的编号
@@ -1513,14 +1732,18 @@ module TencentCloud
         # @type IsFullText: Boolean
         # @param PreReadTime: 签署前置条件：阅读时长限制，默认为不需要
         # @type PreReadTime: Integer
-        # @param UserId: 签署方经办人的用户ID,和签署方经办人姓名+手机号+证件必须有一个
+        # @param UserId: 签署方经办人的用户ID,和签署方经办人姓名+手机号+证件必须有一个。非企微场景不使用此字段
         # @type UserId: String
         # @param Required: 当前只支持true，默认为true
         # @type Required: Boolean
+        # @param ApproverSource: 签署人用户来源,企微侧用户请传入：WEWORKAPP
+        # @type ApproverSource: String
+        # @param CustomApproverTag: 客户自定义签署人标识，64位长度，保证唯一。非企微场景不使用此字段
+        # @type CustomApproverTag: String
 
-        attr_accessor :ApproverType, :OrganizationName, :ApproverName, :ApproverMobile, :ApproverIdCardType, :ApproverIdCardNumber, :RecipientId, :VerifyChannel, :NotifyType, :IsFullText, :PreReadTime, :UserId, :Required
+        attr_accessor :ApproverType, :OrganizationName, :ApproverName, :ApproverMobile, :ApproverIdCardType, :ApproverIdCardNumber, :RecipientId, :VerifyChannel, :NotifyType, :IsFullText, :PreReadTime, :UserId, :Required, :ApproverSource, :CustomApproverTag
         
-        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)
+        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)
           @ApproverType = approvertype
           @OrganizationName = organizationname
           @ApproverName = approvername
@@ -1534,6 +1757,8 @@ module TencentCloud
           @PreReadTime = prereadtime
           @UserId = userid
           @Required = required
+          @ApproverSource = approversource
+          @CustomApproverTag = customapprovertag
         end
 
         def deserialize(params)
@@ -1550,6 +1775,68 @@ module TencentCloud
           @PreReadTime = params['PreReadTime']
           @UserId = params['UserId']
           @Required = params['Required']
+          @ApproverSource = params['ApproverSource']
+          @CustomApproverTag = params['CustomApproverTag']
+        end
+      end
+
+      # 此结构体(FlowDetailInfo)描述的是合同(流程)的详细信息
+      class FlowDetailInfo < TencentCloud::Common::AbstractModel
+        # @param FlowId: 合同(流程)的Id
+        # @type FlowId: String
+        # @param FlowName: 合同(流程)的名字
+        # @type FlowName: String
+        # @param FlowType: 合同(流程)的类型
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowType: String
+        # @param FlowStatus: 合同(流程)的状态
+        # 1：未签署
+        # 2：部分签署
+        # 3：已退回
+        # 4：完成签署
+        # 5：已过期
+        # 6：已取消
+        # @type FlowStatus: Integer
+        # @param FlowMessage: 合同(流程)的信息
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowMessage: String
+        # @param FlowDescription: 流程的描述
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowDescription: String
+        # @param CreatedOn: 合同(流程)的创建时间戳
+        # @type CreatedOn: Integer
+        # @param FlowApproverInfos: 合同(流程)的签署人数组
+        # @type FlowApproverInfos: Array
+
+        attr_accessor :FlowId, :FlowName, :FlowType, :FlowStatus, :FlowMessage, :FlowDescription, :CreatedOn, :FlowApproverInfos
+        
+        def initialize(flowid=nil, flowname=nil, flowtype=nil, flowstatus=nil, flowmessage=nil, flowdescription=nil, createdon=nil, flowapproverinfos=nil)
+          @FlowId = flowid
+          @FlowName = flowname
+          @FlowType = flowtype
+          @FlowStatus = flowstatus
+          @FlowMessage = flowmessage
+          @FlowDescription = flowdescription
+          @CreatedOn = createdon
+          @FlowApproverInfos = flowapproverinfos
+        end
+
+        def deserialize(params)
+          @FlowId = params['FlowId']
+          @FlowName = params['FlowName']
+          @FlowType = params['FlowType']
+          @FlowStatus = params['FlowStatus']
+          @FlowMessage = params['FlowMessage']
+          @FlowDescription = params['FlowDescription']
+          @CreatedOn = params['CreatedOn']
+          unless params['FlowApproverInfos'].nil?
+            @FlowApproverInfos = []
+            params['FlowApproverInfos'].each do |i|
+              flowapproverdetail_tmp = FlowApproverDetail.new
+              flowapproverdetail_tmp.deserialize(i)
+              @FlowApproverInfos << flowapproverdetail_tmp
+            end
+          end
         end
       end
 
@@ -1992,7 +2279,7 @@ module TencentCloud
         # @type Caller: :class:`Tencentcloud::Ess.v20201111.models.Caller`
         # @param FileInfos: 上传文件内容数组，最多支持20个文件
         # @type FileInfos: Array
-        # @param FileUrls: 上传文件链接数组，最多支持20个URL
+        # @param FileUrls: 不再使用，上传文件链接数组，最多支持20个URL
         # @type FileUrls: String
         # @param CoverRect: 此参数只对 PDF 文件有效。是否将pdf灰色矩阵置白
         # true--是，处理置白

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.402
+  version: 3.0.405
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-01 00:00:00.000000000 Z
+date: 2022-09-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common