tencentcloud-sdk-essbasic 3.0.522 → 3.0.524

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4059d99d574329ce2746925b2ada811c0b2cb923
-  data.tar.gz: ac91dc28b8ff6bed8ce33df124feaa7c542629e8
+  metadata.gz: 7bb1f89998446d339b4f86a9a63f82725981f9e3
+  data.tar.gz: ea16493b218b773ff9867ef83978a925f0dd0079
 SHA512:
-  metadata.gz: abd5932e2c23470d4c53130ba0b7208a127a8010a48a0887efa9da0c7fd1e19900322d6013d34bc1b088591eb9a00865f2f38cc07a56d351b5285c00f267b0f3
-  data.tar.gz: 6a2d2da59ac5114fd13f6aa81bc8844bb70845c185051834825cbdb47eb111a8472d112de49989e87b8cdea6249cc8644e21da98dad0c88148d2c5d86ebda3ae
+  metadata.gz: 8627363aa7f2c968590bb2f4d3caa73c6fb86517c2b045058bd3245e372a994fb233a2f08f7cf6fe39efd0312bb70986e8b9ae97089d6557e73ba374ae4ad6a7
+  data.tar.gz: 7f0df18c74519d9e5977db560593834bf08c058706a7d6b2a3a4b6e04e17e6755d111c1e9cfd5f029dd923883f75523039d0f1b5788a60ad418ee3d81a049bb3

data/lib/VERSION

@@ -1 +1 @@
-3.0.522
+3.0.524

data/lib/v20210526/client.rb

@@ -333,6 +333,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 创建预发起合同
+
+        # @param request: Request instance for ChannelCreatePrepareFlow.
+        # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreatePrepareFlowRequest`
+        # @rtype: :class:`Tencentcloud::essbasic::V20210526::ChannelCreatePrepareFlowResponse`
+        def ChannelCreatePrepareFlow(request)
+          body = send_request('ChannelCreatePrepareFlow', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ChannelCreatePrepareFlowResponse.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/v20210526/models.rb

@@ -132,6 +132,65 @@ module TencentCloud
         end
       end
 
+      # 基础流程信息
+      class BaseFlowInfo < TencentCloud::Common::AbstractModel
+        # @param FlowName: 合同流程名称
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowName: String
+        # @param FlowType: 合同流程类型
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowType: String
+        # @param FlowDescription: 合同流程描述信息
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowDescription: String
+        # @param Deadline: 合同流程截止时间，unix时间戳
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Deadline: Integer
+        # @param Unordered: 是否顺序签署(true:无序签,false:顺序签)
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Unordered: Boolean
+        # @param IntelligentStatus: 打开智能添加填写区(默认开启，打开:"OPEN" 关闭："CLOSE")
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type IntelligentStatus: String
+        # @param FormFields: 填写控件内容
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FormFields: Array
+        # @param NeedSignReview: 本企业(发起方企业)是否需要签署审批，true：开启本企业签署审批
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type NeedSignReview: Boolean
+
+        attr_accessor :FlowName, :FlowType, :FlowDescription, :Deadline, :Unordered, :IntelligentStatus, :FormFields, :NeedSignReview
+        
+        def initialize(flowname=nil, flowtype=nil, flowdescription=nil, deadline=nil, unordered=nil, intelligentstatus=nil, formfields=nil, needsignreview=nil)
+          @FlowName = flowname
+          @FlowType = flowtype
+          @FlowDescription = flowdescription
+          @Deadline = deadline
+          @Unordered = unordered
+          @IntelligentStatus = intelligentstatus
+          @FormFields = formfields
+          @NeedSignReview = needsignreview
+        end
+
+        def deserialize(params)
+          @FlowName = params['FlowName']
+          @FlowType = params['FlowType']
+          @FlowDescription = params['FlowDescription']
+          @Deadline = params['Deadline']
+          @Unordered = params['Unordered']
+          @IntelligentStatus = params['IntelligentStatus']
+          unless params['FormFields'].nil?
+            @FormFields = []
+            params['FormFields'].each do |i|
+              formfield_tmp = FormField.new
+              formfield_tmp.deserialize(i)
+              @FormFields << formfield_tmp
+            end
+          end
+          @NeedSignReview = params['NeedSignReview']
+        end
+      end
+
       # 抄送信息
       class CcInfo < TencentCloud::Common::AbstractModel
         # @param Mobile: 被抄送人手机号，大陆11位手机号
@@ -959,6 +1018,104 @@ module TencentCloud
         end
       end
 
+      # ChannelCreatePrepareFlow请求参数结构体
+      class ChannelCreatePrepareFlowRequest < TencentCloud::Common::AbstractModel
+        # @param ResourceId: 资源id，与ResourceType对应
+        # @type ResourceId: String
+        # @param ResourceType: 资源类型，1：模版，目前仅支持模版，与ResourceId对应
+        # @type ResourceType: Integer
+        # @param FlowInfo: 合同流程基础信息
+        # @type FlowInfo: :class:`Tencentcloud::Essbasic.v20210526.models.BaseFlowInfo`
+        # @param FlowApproverList: 合同签署人信息
+        # @type FlowApproverList: Array
+        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 和 Agent.ProxyAppId 均必填
+        # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
+        # @param FlowOption: 合同流程配置信息
+        # @type FlowOption: :class:`Tencentcloud::Essbasic.v20210526.models.CreateFlowOption`
+        # @param FlowId: 该参数不可用，请通过获取 web 可嵌入接口获取合同流程预览 URL
+        # @type FlowId: String
+        # @param NeedPreview: 该参数不可用，请通过获取 web 可嵌入接口获取合同流程预览 URL
+        # @type NeedPreview: Boolean
+        # @param Organization: 企业机构信息，不用传
+        # @type Organization: :class:`Tencentcloud::Essbasic.v20210526.models.OrganizationInfo`
+        # @param Operator: 操作人（用户）信息，不用传
+        # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
+
+        attr_accessor :ResourceId, :ResourceType, :FlowInfo, :FlowApproverList, :Agent, :FlowOption, :FlowId, :NeedPreview, :Organization, :Operator
+        
+        def initialize(resourceid=nil, resourcetype=nil, flowinfo=nil, flowapproverlist=nil, agent=nil, flowoption=nil, flowid=nil, needpreview=nil, organization=nil, operator=nil)
+          @ResourceId = resourceid
+          @ResourceType = resourcetype
+          @FlowInfo = flowinfo
+          @FlowApproverList = flowapproverlist
+          @Agent = agent
+          @FlowOption = flowoption
+          @FlowId = flowid
+          @NeedPreview = needpreview
+          @Organization = organization
+          @Operator = operator
+        end
+
+        def deserialize(params)
+          @ResourceId = params['ResourceId']
+          @ResourceType = params['ResourceType']
+          unless params['FlowInfo'].nil?
+            @FlowInfo = BaseFlowInfo.new
+            @FlowInfo.deserialize(params['FlowInfo'])
+          end
+          unless params['FlowApproverList'].nil?
+            @FlowApproverList = []
+            params['FlowApproverList'].each do |i|
+              commonflowapprover_tmp = CommonFlowApprover.new
+              commonflowapprover_tmp.deserialize(i)
+              @FlowApproverList << commonflowapprover_tmp
+            end
+          end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          unless params['FlowOption'].nil?
+            @FlowOption = CreateFlowOption.new
+            @FlowOption.deserialize(params['FlowOption'])
+          end
+          @FlowId = params['FlowId']
+          @NeedPreview = params['NeedPreview']
+          unless params['Organization'].nil?
+            @Organization = OrganizationInfo.new
+            @Organization.deserialize(params['Organization'])
+          end
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+        end
+      end
+
+      # ChannelCreatePrepareFlow返回参数结构体
+      class ChannelCreatePrepareFlowResponse < TencentCloud::Common::AbstractModel
+        # @param PrepareFlowUrl: 预发起的合同链接
+        # @type PrepareFlowUrl: String
+        # @param PreviewFlowUrl: 合同发起后预览链接
+        # @type PreviewFlowUrl: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :PrepareFlowUrl, :PreviewFlowUrl, :RequestId
+        
+        def initialize(prepareflowurl=nil, previewflowurl=nil, requestid=nil)
+          @PrepareFlowUrl = prepareflowurl
+          @PreviewFlowUrl = previewflowurl
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @PrepareFlowUrl = params['PrepareFlowUrl']
+          @PreviewFlowUrl = params['PreviewFlowUrl']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # ChannelCreateReleaseFlow请求参数结构体
       class ChannelCreateReleaseFlowRequest < TencentCloud::Common::AbstractModel
         # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 和 Agent.ProxyAppId 均必填。
@@ -1522,6 +1679,108 @@ module TencentCloud
         end
       end
 
+      # 签署人配置信息
+      class CommonApproverOption < TencentCloud::Common::AbstractModel
+        # @param CanEditApprover: 是否允许修改签署人信息
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CanEditApprover: Boolean
+
+        attr_accessor :CanEditApprover
+        
+        def initialize(caneditapprover=nil)
+          @CanEditApprover = caneditapprover
+        end
+
+        def deserialize(params)
+          @CanEditApprover = params['CanEditApprover']
+        end
+      end
+
+      # 通用签署人信息
+      class CommonFlowApprover < TencentCloud::Common::AbstractModel
+        # @param NotChannelOrganization: 指定当前签署人为第三方应用集成子客，默认false：当前签署人为第三方应用集成子客，true：当前签署人为saas企业用户
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type NotChannelOrganization: Boolean
+        # @param ApproverType: 签署人类型,目前支持：0-企业签署人，1-个人签署人，3-企业静默签署人
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ApproverType: Integer
+        # @param OrganizationId: 企业id
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OrganizationId: String
+        # @param OrganizationOpenId: 企业OpenId，第三方应用集成非静默签子客企业签署人发起合同毕传
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OrganizationOpenId: String
+        # @param OrganizationName: 企业名称，第三方应用集成非静默签子客企业签署人必传，saas企业签署人必传
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OrganizationName: String
+        # @param UserId: 用户id
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type UserId: String
+        # @param OpenId: 用户openId，第三方应用集成非静默签子客企业签署人必传
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OpenId: String
+        # @param ApproverName: 签署人名称，saas企业签署人，个人签署人必传
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ApproverName: String
+        # @param ApproverMobile: 签署人手机号，saas企业签署人，个人签署人必传
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ApproverMobile: String
+        # @param RecipientId: 签署人Id，使用模版发起是，对应模版配置中的签署人RecipientId
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type RecipientId: String
+        # @param PreReadTime: 签署前置条件：阅读时长限制，不传默认10s,最大300s，最小3s
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type PreReadTime: Integer
+        # @param IsFullText: 签署前置条件：阅读全文限制
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type IsFullText: Boolean
+        # @param NotifyType: 通知类型：SMS（短信） NONE（不做通知）, 不传 默认SMS
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type NotifyType: String
+        # @param ApproverOption: 签署人配置
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ApproverOption: :class:`Tencentcloud::Essbasic.v20210526.models.CommonApproverOption`
+
+        attr_accessor :NotChannelOrganization, :ApproverType, :OrganizationId, :OrganizationOpenId, :OrganizationName, :UserId, :OpenId, :ApproverName, :ApproverMobile, :RecipientId, :PreReadTime, :IsFullText, :NotifyType, :ApproverOption
+        
+        def initialize(notchannelorganization=nil, approvertype=nil, organizationid=nil, organizationopenid=nil, organizationname=nil, userid=nil, openid=nil, approvername=nil, approvermobile=nil, recipientid=nil, prereadtime=nil, isfulltext=nil, notifytype=nil, approveroption=nil)
+          @NotChannelOrganization = notchannelorganization
+          @ApproverType = approvertype
+          @OrganizationId = organizationid
+          @OrganizationOpenId = organizationopenid
+          @OrganizationName = organizationname
+          @UserId = userid
+          @OpenId = openid
+          @ApproverName = approvername
+          @ApproverMobile = approvermobile
+          @RecipientId = recipientid
+          @PreReadTime = prereadtime
+          @IsFullText = isfulltext
+          @NotifyType = notifytype
+          @ApproverOption = approveroption
+        end
+
+        def deserialize(params)
+          @NotChannelOrganization = params['NotChannelOrganization']
+          @ApproverType = params['ApproverType']
+          @OrganizationId = params['OrganizationId']
+          @OrganizationOpenId = params['OrganizationOpenId']
+          @OrganizationName = params['OrganizationName']
+          @UserId = params['UserId']
+          @OpenId = params['OpenId']
+          @ApproverName = params['ApproverName']
+          @ApproverMobile = params['ApproverMobile']
+          @RecipientId = params['RecipientId']
+          @PreReadTime = params['PreReadTime']
+          @IsFullText = params['IsFullText']
+          @NotifyType = params['NotifyType']
+          unless params['ApproverOption'].nil?
+            @ApproverOption = CommonApproverOption.new
+            @ApproverOption.deserialize(params['ApproverOption'])
+          end
+        end
+      end
+
       # 此结构体 (Component) 用于描述控件属性。
 
       # 在通过文件发起合同时，对应的component有三种定位方式
@@ -1931,6 +2190,23 @@ module TencentCloud
         end
       end
 
+      # 创建合同配置信息
+      class CreateFlowOption < TencentCloud::Common::AbstractModel
+        # @param CanEditFlow: 是否允许修改合同信息
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CanEditFlow: Boolean
+
+        attr_accessor :CanEditFlow
+        
+        def initialize(caneditflow=nil)
+          @CanEditFlow = caneditflow
+        end
+
+        def deserialize(params)
+          @CanEditFlow = params['CanEditFlow']
+        end
+      end
+
       # CreateFlowsByTemplates请求参数结构体
       class CreateFlowsByTemplatesRequest < TencentCloud::Common::AbstractModel
         # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 和 Agent.ProxyAppId 均必填。
@@ -3833,8 +4109,8 @@ module TencentCloud
       # 如果需要指定B端（机构身份类型）签署人，其中ReleasedApprover需要传递的参数如下：
       # ApproverNumber, OrganizationName, ApproverType必传。
       # 对于其他身份标识
-      # - 渠道子客企业指定经办人：OpenId必传，OrganizationOpenId必传；
-      # - 非渠道合作企业：Name、Mobile必传。
+      # - 子客企业指定经办人：OpenId必传，OrganizationOpenId必传；
+      # - 非子客企业：Name、Mobile必传。
       class ReleasedApprover < TencentCloud::Common::AbstractModel
         # @param OrganizationName: 企业签署方工商营业执照上的企业名称，签署方为非发起方企业场景下必传，最大长度64个字符
         # @type OrganizationName: String
@@ -3854,10 +4130,10 @@ module TencentCloud
         # @type IdCardNumber: String
         # @param Mobile: 签署人手机号，脱敏显示。大陆手机号为11位，暂不支持海外手机号
         # @type Mobile: String
-        # @param OrganizationOpenId: 企业签署方在同一渠道下的其他合作企业OpenId，签署方为非发起方企业场景下必传，最大长度64个字符
+        # @param OrganizationOpenId: 企业签署方在同一第三方应用下的其他合作企业OpenId，签署方为非发起方企业场景下必传，最大长度64个字符
         # @type OrganizationOpenId: String
         # @param OpenId: 用户侧第三方id，最大长度64个字符
-        # 当签署方为同一渠道下的员工时，该字必传
+        # 当签署方为同一第三方应用下的员工时，该字必传
         # @type OpenId: String
 
         attr_accessor :OrganizationName, :ApproverNumber, :ApproverType, :Name, :IdCardType, :IdCardNumber, :Mobile, :OrganizationOpenId, :OpenId

metadata

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