tencentcloud-sdk-essbasic 3.0.677 → 3.0.678

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 7d7b9164d15568ef698abbf80d1038fab73c9ff1
4
- data.tar.gz: 89f3637ed68b5c8c334a345080d68aa43c8556bd
3
+ metadata.gz: 2bfd7dbd5a5de34e7cfdfab8c533cf28fbb688ad
4
+ data.tar.gz: 1d66d53c9b02c505ff17172a124f450b90e4a2f8
5
5
  SHA512:
6
- metadata.gz: f3b8ef653b74051204873dbdac65b7a1f4c8df216a4743d1a1033070328863193f8225ad52e2d0a691664e8c5ff2b4a3a24815a3c03f6aa28f3a06be98cce13e
7
- data.tar.gz: 4f9cbe644fbdcd94ade56784b6b1952690a39d85c9a68e58fa4dd457a3d034f6ef113c9c5114da29bc241592b7eb5951a204a801ccff1b56fc48e882c07f61ae
6
+ metadata.gz: d2235a8aa9c65e364afb46854497f2e4cb57e891e84349ad2b112e33799879d9c6ac2e9161133a2bbd8a66f21f654e4cf3889e28c0fa53fc062e0ff0331fe29b
7
+ data.tar.gz: 4b1b1fb1fc85b3a5efd1a892eab8d40f7b3544edfcf415894aacf708321dfa3598b5769acfe6d20723b4410928889e8fea583086d2de7c3a6ede8194cf278776
data/lib/VERSION CHANGED
@@ -1 +1 @@
1
- 3.0.677
1
+ 3.0.678
@@ -2,12 +2,12 @@
2
2
 
3
3
  require 'tencentcloud-sdk-common'
4
4
 
5
- require_relative 'v20210526/client'
6
- require_relative 'v20210526/models'
7
-
8
5
  require_relative 'v20201222/client'
9
6
  require_relative 'v20201222/models'
10
7
 
8
+ require_relative 'v20210526/client'
9
+ require_relative 'v20210526/models'
10
+
11
11
  module TencentCloud
12
12
  module Essbasic
13
13
  end
@@ -303,7 +303,9 @@ module TencentCloud
303
303
  raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
304
304
  end
305
305
 
306
- # 接口(ChannelCreateFlowByFiles)用于通过文件创建签署流程。此接口静默签能力不可直接使用,请联系客户经理申请使用
306
+ # 接口(ChannelCreateFlowByFiles)用PDF文件创建签署流程。
307
+
308
+ # 注: `此接口静默签(企业自动签)能力为白名单功能,使用前请联系对接的客户经理沟通。`
307
309
 
308
310
  # @param request: Request instance for ChannelCreateFlowByFiles.
309
311
  # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowByFilesRequest`
@@ -86,6 +86,8 @@ module TencentCloud
86
86
  # 签署方信息,发起合同后可获取到对应的签署方信息,如角色ID,角色名称
87
87
  class ApproverItem < TencentCloud::Common::AbstractModel
88
88
  # @param SignId: 签署方唯一编号
89
+
90
+ # 在动态签署人场景下,可以用此编号确定参与方
89
91
  # 注意:此字段可能返回 null,表示取不到有效值。
90
92
  # @type SignId: String
91
93
  # @param RecipientId: 签署方角色编号
@@ -1051,56 +1053,102 @@ module TencentCloud
1051
1053
 
1052
1054
  # ChannelCreateFlowByFiles请求参数结构体
1053
1055
  class ChannelCreateFlowByFilesRequest < TencentCloud::Common::AbstractModel
1054
- # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 均必填。
1056
+ # @param Agent: 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
1057
+
1058
+ # 此接口下面信息必填。
1059
+ # <ul>
1060
+ # <li>渠道应用标识: Agent.ProxyOrganizationOpenId</li>
1061
+ # <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
1062
+ # <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
1063
+ # </ul>
1055
1064
  # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
1056
- # @param FlowName: 签署流程名称,长度不超过200个字符
1065
+ # @param FlowName: 合同流程的名称(可自定义此名称),长度不能超过200,只能由中文、字母、数字和下划线组成。
1057
1066
  # @type FlowName: String
1058
- # @param FlowDescription: 签署流程的描述,长度不超过1000个字符
1067
+ # @param FlowDescription: 合同流程描述信息(可自定义此描述),最大长度1000个字符。
1059
1068
  # @type FlowDescription: String
1060
- # @param FlowApprovers: 签署流程签约方列表,最多不超过50个参与方
1069
+ # @param FlowApprovers: 合同流程的参与方列表, 最多可支持50个参与方,可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息,具体定义可以参考开发者中心的<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo" target="_blank">FlowApproverInfo结构体</a>。
1070
+
1071
+ # 如果合同流程是有序签署,Approvers列表中参与人的顺序就是默认的签署顺序, 请确保列表中参与人的顺序符合实际签署顺序。
1061
1072
  # @type FlowApprovers: Array
1062
- # @param FileIds: 签署文件资源Id列表,目前仅支持单个文件
1073
+ # @param FileIds: 本合同流程需包含的PDF文件资源编号列表,通过<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">UploadFiles</a>接口获取PDF文件资源编号。
1074
+
1075
+ # 注: `目前,此接口仅支持单个文件发起。`
1063
1076
  # @type FileIds: Array
1064
- # @param Components: 签署文件中的发起方的填写控件,需要在发起的时候进行填充
1077
+ # @param Components: 模板或者合同中的填写控件列表,列表中可支持下列多种填写控件,控件的详细定义参考开发者中心的Component结构体
1078
+ # <ul><li>单行文本控件</li>
1079
+ # <li>多行文本控件</li>
1080
+ # <li>勾选框控件</li>
1081
+ # <li>数字控件</li>
1082
+ # <li>图片控件</li>
1083
+ # <li>数据表格等填写控件</li></ul>
1065
1084
  # @type Components: Array
1066
- # @param Deadline: 签署流程的签署截止时间。
1067
- # 值为unix时间戳,精确到秒,不传默认为当前时间一年后
1068
- # 不能早于当前时间
1085
+ # @param Deadline: 合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
1086
+ # 如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。
1069
1087
  # @type Deadline: Integer
1070
- # @param CallbackUrl: 签署流程回调地址,长度不超过255个字符
1071
- # 如果不传递回调地址, 则默认是配置应用号时候使用的回调地址
1088
+ # @param CallbackUrl: 执行结果的回调URL,长度不超过255个字符,该URL仅支持HTTP或HTTPS协议,建议采用HTTPS协议以保证数据传输的安全性。
1089
+ # 腾讯电子签服务器将通过POST方式,application/json格式通知执行结果,请确保外网可以正常访问该URL。
1090
+ # 回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/partner/callback_data_types" target="_blank">回调通知</a>模块。
1091
+
1092
+ # 注:
1093
+ # `如果不传递回调地址, 则默认是配置应用号时候使用的回调地址`
1072
1094
  # @type CallbackUrl: String
1073
- # @param Unordered: 合同签署顺序类型
1074
- # true - 无序签,
1075
- # false - 顺序签,
1076
- # 默认为false,即有序签署。
1077
- # 有序签署时以传入FlowApprovers数组的顺序作为签署顺序
1095
+ # @param Unordered: 合同流程的签署顺序类型:
1096
+ # <ul><li> **false**:(默认)有序签署, 本合同多个参与人需要依次签署 </li>
1097
+ # <li> **true**:无序签署, 本合同多个参与人没有先后签署限制</li></ul>
1098
+
1099
+ #
1100
+ # `有序签署时以传入FlowApprovers数组的顺序作为签署顺序`
1078
1101
  # @type Unordered: Boolean
1079
- # @param FlowType: 签署流程的类型,长度不超过255个字符
1102
+ # @param FlowType: 合同流程的类别分类(可自定义名称,如销售合同/入职合同等),最大长度为255个字符,仅限中文、字母、数字和下划线组成。
1080
1103
  # @type FlowType: String
1081
- # @param CustomShowMap: 合同显示的页卡模板,说明:只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名},且N不能超过签署人的数量,N从1开始
1104
+ # @param CustomShowMap: 您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板,模板中支持以下变量:
1105
+ # <ul><li>{合同名称} </li>
1106
+ # <li>{发起方企业} </li>
1107
+ # <li>{发起方姓名} </li>
1108
+ # <li>{签署方N企业}</li>
1109
+ # <li>{签署方N姓名}</li></ul>
1110
+ # 其中,N表示签署方的编号,从1开始,不能超过签署人的数量。
1111
+
1112
+ # 例如,如果是腾讯公司张三发给李四名称为“租房合同”的合同,您可以将此字段设置为:`合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名}`,则小程序中列表页展示此合同为以下样子
1113
+
1114
+ # 合同名称:租房合同
1115
+ # 发起方:腾讯公司(张三)
1116
+ # 签署方:李四
1117
+
1082
1118
  # @type CustomShowMap: String
1083
- # @param CustomerData: 业务信息,最大长度1000个字符。
1119
+ # @param CustomerData: 调用方自定义的个性化字段(可自定义此名称),并以base64方式编码,支持的最大数据大小为 1000长度。
1120
+
1121
+ # 在合同状态变更的回调信息等场景中,该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/partner/callback_types_contracts_sign" target="_blank">回调通知</a>模块。
1084
1122
  # @type CustomerData: String
1085
- # @param NeedSignReview: 发起方企业的签署人进行签署操作是否需要企业内部审批。 若设置为true,审核结果需通过接口 ChannelCreateFlowSignReview 通知电子签,审核通过后,发起方企业签署人方可进行签署操作,否则会阻塞其签署操作。 注:企业可以通过此功能与企业内部的审批流程进行关联,支持手动、静默签署合同。
1123
+ # @param NeedSignReview: 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
1124
+ # <ul><li> **false**:(默认)不需要审批,直接签署。</li>
1125
+ # <li> **true**:需要走审批流程。当到对应参与人签署时,会阻塞其签署操作,等待企业内部审批完成。</li></ul>
1126
+ # 企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
1127
+ # <ul><li> 如果企业通知腾讯电子签平台审核通过,签署方可继续签署动作。</li>
1128
+ # <li> 如果企业通知腾讯电子签平台审核未通过,平台将继续阻塞签署方的签署动作,直到企业通知平台审核通过。</li></ul>
1129
+ # 注:`此功能可用于与企业内部的审批流程进行关联,支持手动、静默签署合同`
1086
1130
  # @type NeedSignReview: Boolean
1087
1131
  # @param ApproverVerifyType: 签署人校验方式
1088
1132
  # VerifyCheck: 人脸识别(默认)
1089
1133
  # MobileCheck:手机号验证,用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容(当手写签名方式为OCR_ESIGN时,该校验方式无效,因为这种签名方式依赖实名认证)
1090
1134
  # 参数说明:可选人脸识别或手机号验证两种方式,若选择后者,未实名个人签署方在签署合同时,无需经过实名认证和意愿确认两次人脸识别,该能力仅适用于个人签署方。
1091
1135
  # @type ApproverVerifyType: String
1092
- # @param SignBeanTag: 标识是否允许发起后添加控件。
1093
- # 0为不允许
1094
- # 1为允许。
1095
- # 如果为1,创建的时候不能有签署控件,只能创建后添加。注意发起后添加控件功能不支持添加骑缝章和签批控件
1136
+ # @param SignBeanTag: 签署方签署控件(印章/签名等)的生成方式:
1137
+ # <ul><li> **0**:在合同流程发起时,由发起人指定签署方的签署控件的位置和数量。</li>
1138
+ # <li> **1**:签署方在签署时自行添加签署控件,可以拖动位置和控制数量。</li></ul>
1139
+
1140
+ # 注:
1141
+ # `发起后添加控件功能不支持添加签批控件`
1096
1142
  # @type SignBeanTag: Integer
1097
- # @param CcInfos: 被抄送人信息列表
1143
+ # @param CcInfos: 合同流程的抄送人列表,最多可支持50个抄送人,抄送人可查看合同内容及签署进度,但无需参与合同签署。
1098
1144
  # @type CcInfos: Array
1099
- # @param CcNotifyType: 给关注人发送短信通知的类型,
1100
- # 0-合同发起时通知
1101
- # 1-签署完成后通知
1145
+ # @param CcNotifyType: 可以设置以下时间节点来给抄送人发送短信通知来查看合同内容:
1146
+ # <ul><li> **0**:合同发起时通知(默认值)</li>
1147
+ # <li> **1**:签署完成后通知</li></ul>
1102
1148
  # @type CcNotifyType: Integer
1103
- # @param AutoSignScene: 个人自动签场景。发起自动签署时,需设置对应自动签署场景,目前仅支持场景:处方单-E_PRESCRIPTION_AUTO_SIGN
1149
+ # @param AutoSignScene: 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传:
1150
+ # <ul><li> **E_PRESCRIPTION_AUTO_SIGN**:处方单(医疗自动签) </li></ul>
1151
+ # 注: `个人自动签名场景是白名单功能,使用前请与对接的客户经理联系沟通。`
1104
1152
  # @type AutoSignScene: String
1105
1153
  # @param Operator: 操作者的信息,不用传
1106
1154
  # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -3582,13 +3630,7 @@ module TencentCloud
3582
3630
  # 2 FontSize: 范围12-72
3583
3631
  # 3 FontAlign: Left/Right/Center,左对齐/居中/右对齐
3584
3632
  # 4 FontColor:字符串类型,格式为RGB颜色数字
3585
- # 参数样例: "ComponentExtra": "{\"FontColor\":\"255,0,0\",\"FontSize\":12}"
3586
-
3587
- # TEXT/MULTI_LINE_TEXT控件可以指定
3588
- # 1 Font:目前只支持黑体、宋体
3589
- # 2 FontSize: 范围12-72
3590
- # 3 FontAlign: Left/Right/Center,左对齐/居中/右对齐
3591
- # 例如:{"FontSize":12}
3633
+ # 参数样例:{\"FontColor\":\"255,0,0\",\"FontSize\":12}
3592
3634
 
3593
3635
  # ComponentType为FILL_IMAGE时,支持以下参数:
3594
3636
  # NotMakeImageCenter:bool。是否设置图片居中。false:居中(默认)。 true: 不居中
@@ -5240,53 +5282,68 @@ module TencentCloud
5240
5282
  # 其中签署方FlowApproverInfo需要传递的参数
5241
5283
  # 非单C、单B、B2C合同,ApproverType、RecipientId(模板发起合同时)必传,建议都传。
5242
5284
 
5243
- # 其他身份标识
5285
+ # 其他身份标识,注:`如果发起的是动态签署方(即ApproverOption.FillType指定为1),可以不指定具体签署人信息`
5244
5286
 
5245
5287
  # <ul><li>1-个人:Name、Mobile必传</li>
5246
5288
  # <li>2-第三方平台子客企业指定经办人:OpenId必传,OrgName必传、OrgOpenId必传;</li>
5247
5289
  # <li>3-第三方平台子客企业不指定经办人:OrgName必传、OrgOpenId必传;</li>
5248
- # <li>4-非第三方平台子客企业:Name、Mobile必传,OrgName必传,且NotChannelOrganization=True。</li></ul>
5290
+ # <li>4-非第三方平台子客企业(平台企业):Name、Mobile必传,OrgName必传,且NotChannelOrganization=True。</li></ul>
5249
5291
 
5250
5292
  # RecipientId参数:
5251
5293
  # 从DescribeTemplates接口中,可以得到模板下的签署方Recipient列表,根据模板自定义的Rolename在此结构体中确定其RecipientId。
5252
5294
  class FlowApproverInfo < TencentCloud::Common::AbstractModel
5253
- # @param Name: 签署人姓名,最大长度50个字符
5295
+ # @param Name: 签署方经办人的姓名。
5296
+ # 经办人的姓名将用于身份认证和电子签名,请确保填写的姓名为签署方的真实姓名,而非昵称等代名。
5254
5297
  # @type Name: String
5255
- # @param IdCardType: 签署人的证件类型
5256
- # 1.ID_CARD 居民身份证
5257
- # 2.HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证
5258
- # 3.HONGKONG_AND_MACAO 港澳居民来往内地通行证
5259
- # 4.OTHER_CARD_TYPE 其他(需要使用该类型请先联系运营经理)
5298
+ # @param IdCardType: 签署方经办人的证件类型,支持以下类型
5299
+ # <ul><li>ID_CARD : 居民身份证 (默认值)</li>
5300
+ # <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
5301
+ # <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
5302
+ # <li>OTHER_CARD_TYPE : 其他证件</li></ul>
5303
+
5304
+ # 注: `其他证件类型为白名单功能,使用前请联系对接的客户经理沟通。`
5260
5305
  # @type IdCardType: String
5261
- # @param IdCardNumber: 签署人证件号(长度不超过18位)
5306
+ # @param IdCardNumber: 签署方经办人的证件号码,应符合以下规则
5307
+ # <ul><li>居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。</li>
5308
+ # <li>港澳居民来往内地通行证号码应为9位字符串,第1位为“C”,第2位为英文字母(但“I”、“O”除外),后7位为阿拉伯数字。</li>
5309
+ # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。</li></ul>
5262
5310
  # @type IdCardNumber: String
5263
- # @param Mobile: 签署人手机号,脱敏显示。大陆手机号为11位,暂不支持海外手机号。
5311
+ # @param Mobile: 签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符), 不支持海外手机号。
5312
+ # 请确认手机号所有方为此合同签署方。
5264
5313
  # @type Mobile: String
5265
- # @param OrganizationName: 企业签署方工商营业执照上的企业名称,签署方为非发起方企业场景下必传,最大长度64个字符;
5314
+ # @param OrganizationName: 组织机构名称。
5315
+ # 请确认该名称与企业营业执照中注册的名称一致。
5316
+ # 如果名称中包含英文括号(),请使用中文括号()代替。
5266
5317
  # @type OrganizationName: String
5267
- # @param NotChannelOrganization: 指定签署人非第三方平台子客企业下员工,在ApproverType为ORGANIZATION时指定。
5268
- # 默认为false,即签署人位于同一个第三方平台应用号下;默认为false,即签署人位于同一个第三方应用号下;
5318
+ # @param NotChannelOrganization: 指定签署人非第三方平台子客企业下员工还是SaaS平台企业,在ApproverType为ORGANIZATION时指定。
5319
+ # <ul>
5320
+ # <li>false: 默认值,第三方平台子客企业下员工</li>
5321
+ # <li>true: SaaS平台企业下的员工</li>
5322
+ # </ul>
5269
5323
  # @type NotChannelOrganization: Boolean
5270
- # @param OpenId: 用户侧第三方id,最大长度64个字符
5324
+ # @param OpenId: 第三方平台子客企业员工的唯一标识,长度不能超过64,只能由字母和数字组成
5325
+
5271
5326
  # 当签署方为同一第三方平台下的员工时,该字段若不指定,则发起【待领取】的流程
5272
5327
  # @type OpenId: String
5273
- # @param OrganizationOpenId: 企业签署方在同一第三方平台应用下的其他合作企业OpenId,签署方为非发起方企业场景下必传,最大长度64个字符;
5328
+ # @param OrganizationOpenId: 同应用下第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样,签署方为非发起方企业场景下必传,最大长度64个字符
5274
5329
  # @type OrganizationOpenId: String
5275
- # @param ApproverType: 签署人类型
5276
- # PERSON-个人/自然人;
5277
- # PERSON_AUTO_SIGN-个人自动签署,适用于个人自动签场景
5278
- # 注: 个人自动签场景为白名单功能, 使用前请联系对接的客户经理沟通。
5279
- # ORGANIZATION-企业(企业签署方或模板发起时的企业静默签);
5280
- # ENTERPRISESERVER-企业自动签(他方企业自动签署或文件发起时的本方企业自动签)
5281
-
5282
- # 若要实现他方企业(同一应用下)自动签,需要满足3个条件:
5283
- # 条件1:ApproverType 设置为ENTERPRISESERVER
5284
- # 条件2:子客之间完成授权
5285
- # 条件3:联系对接的客户经理沟通
5330
+ # @param ApproverType: 在指定签署方时,可选择企业B端或个人C端等不同的参与者类型,可选类型如下:
5331
+ # <ul><li> **PERSON** :个人/自然人</li>
5332
+ # <li> **PERSON_AUTO_SIGN** :个人/自然人自动签署,适用于个人自动签场景</li>
5333
+ # <li> **ORGANIZATION** :企业/企业员工(企业签署方或模板发起时的企业静默签)</li>
5334
+ # <li> **ENTERPRISESERVER** :企业/企业员自动签(他方企业自动签署或文件发起时的本方企业自动签)</li></ul>
5335
+
5336
+ # 注:
5337
+ # `1. 个人自动签场景(PERSON_AUTO_SIGN)为白名单功能, 使用前请联系对接的客户经理沟通。`
5338
+ # `2. 若要实现他方企业(同一应用下)自动签,需要满足3个条件:`
5339
+ # <ul><li>条件1:ApproverType 设置为ENTERPRISESERVER</li>
5340
+ # <li>条件2:子客之间完成授权</li>
5341
+ # <li>条件3:联系对接的客户经理沟通如何使用</li></ul>
5286
5342
  # @type ApproverType: String
5287
5343
  # @param RecipientId: 签署流程签署人在模板中对应的签署人Id;在非单方签署、以及非B2C签署的场景下必传,用于指定当前签署方在签署流程中的位置;
5288
5344
  # @type RecipientId: String
5289
- # @param Deadline: 签署截止时间戳,默认一年
5345
+ # @param Deadline: 本签署人在此合同流程的签署截止时间,格式为Unix标准时间戳(秒),如果未设置签署截止时间,则默认为合同流程创建后的365天时截止。
5346
+ # 如果在签署截止时间前未完成签署,则合同状态会变为已过期,导致合同作废。
5290
5347
  # @type Deadline: Integer
5291
5348
  # @param CallbackUrl: 签署完回调url,最大长度1000个字符
5292
5349
  # @type CallbackUrl: String
@@ -5298,11 +5355,19 @@ module TencentCloud
5298
5355
  # ESIGN -- 个人印章类型
5299
5356
  # SYSTEM_ESIGN -- 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署)
5300
5357
  # @type ComponentLimitType: Array
5301
- # @param PreReadTime: 合同的强制预览时间:3~300s,未指定则按合同页数计算
5358
+ # @param PreReadTime: 签署方在签署合同之前,需要强制阅读合同的时长,可指定为3秒至300秒之间的任意值。
5359
+
5360
+ # 若未指定阅读时间,则会按照合同页数大小计算阅读时间,计算规则如下:
5361
+ # <ul>
5362
+ # <li>合同页数少于等于2页,阅读时间为3秒;</li>
5363
+ # <li>合同页数为3到5页,阅读时间为5秒;</li>
5364
+ # <li>合同页数大于等于6页,阅读时间为10秒。</li>
5365
+ # </ul>
5302
5366
  # @type PreReadTime: Integer
5303
5367
  # @param JumpUrl: 签署完前端跳转的url,此字段的用法场景请联系客户经理确认
5304
5368
  # @type JumpUrl: String
5305
- # @param ApproverOption: 签署人个性化能力值
5369
+ # @param ApproverOption: 可以控制签署方在签署合同时能否进行某些操作,例如拒签、转交他人等。
5370
+ # 详细操作可以参考开发者中心的ApproverOption结构体。
5306
5371
  # @type ApproverOption: :class:`Tencentcloud::Essbasic.v20210526.models.ApproverOption`
5307
5372
  # @param ApproverNeedSignReview: 当前签署方进行签署操作是否需要企业内部审批,true 则为需要
5308
5373
  # @type ApproverNeedSignReview: Boolean
@@ -5317,14 +5382,17 @@ module TencentCloud
5317
5382
  # - 发起流程时系统自动补充
5318
5383
  # - 创建签署链接时,可以通过查询详情接口获得签署人的SignId,然后可传入此值为该签署人创建签署链接,无需再传姓名、手机号、证件号等其他信息
5319
5384
  # @type SignId: String
5320
- # @param NotifyType: SMS: 短信(需确保“电子签短信通知签署方”功能是开启状态才能生效); NONE: 不发信息
5321
- # 默认为SMS(签署方为子客时该字段不生效)
5385
+ # @param NotifyType: 通知签署方经办人的方式, 有以下途径:
5386
+ # <ul><li> **SMS** :(默认)短信</li>
5387
+ # <li> **NONE** : 不通知</li></ul>
5388
+
5389
+ # 注: `签署方为第三方子客企业时会被置为NONE, 不会发短信通知`
5322
5390
  # @type NotifyType: String
5323
5391
  # @param AddSignComponentsLimits: [通过文件创建签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles)时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型(骑缝章、普通章法人章等)和具体的印章(印章ID)或签名方式。
5324
5392
 
5325
5393
  # 注:`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章(通过传递ComponentValue,支持多个),他方企业或个人只支持限制控件类型。`
5326
5394
  # @type AddSignComponentsLimits: Array
5327
- # @param ApproverRoleName: 自定义签署方角色名称
5395
+ # @param ApproverRoleName: 自定义签署人角色名,如收款人、开具人、见证人等
5328
5396
  # @type ApproverRoleName: String
5329
5397
 
5330
5398
  attr_accessor :Name, :IdCardType, :IdCardNumber, :Mobile, :OrganizationName, :NotChannelOrganization, :OpenId, :OrganizationOpenId, :ApproverType, :RecipientId, :Deadline, :CallbackUrl, :SignComponents, :ComponentLimitType, :PreReadTime, :JumpUrl, :ApproverOption, :ApproverNeedSignReview, :ApproverVerifyTypes, :ApproverSignTypes, :SignId, :NotifyType, :AddSignComponentsLimits, :ApproverRoleName
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: tencentcloud-sdk-essbasic
3
3
  version: !ruby/object:Gem::Version
4
- version: 3.0.677
4
+ version: 3.0.678
5
5
  platform: ruby
6
6
  authors:
7
7
  - Tencent Cloud
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-10-16 00:00:00.000000000 Z
11
+ date: 2023-10-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: tencentcloud-sdk-common
@@ -33,11 +33,11 @@ executables: []
33
33
  extensions: []
34
34
  extra_rdoc_files: []
35
35
  files:
36
- - lib/v20201222/client.rb
37
- - lib/v20201222/models.rb
38
36
  - lib/tencentcloud-sdk-essbasic.rb
39
- - lib/v20210526/client.rb
37
+ - lib/v20201222/models.rb
38
+ - lib/v20201222/client.rb
40
39
  - lib/v20210526/models.rb
40
+ - lib/v20210526/client.rb
41
41
  - lib/VERSION
42
42
  homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
43
43
  licenses: