tencentcloud-sdk-essbasic 3.0.677 → 3.0.679

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7d7b9164d15568ef698abbf80d1038fab73c9ff1
-  data.tar.gz: 89f3637ed68b5c8c334a345080d68aa43c8556bd
+  metadata.gz: 038320bb7522ec5e0b68092a8e55cca800347ca8
+  data.tar.gz: 3b60421bde56f92c0b2215e316b90fa06e2a68d0
 SHA512:
-  metadata.gz: f3b8ef653b74051204873dbdac65b7a1f4c8df216a4743d1a1033070328863193f8225ad52e2d0a691664e8c5ff2b4a3a24815a3c03f6aa28f3a06be98cce13e
-  data.tar.gz: 4f9cbe644fbdcd94ade56784b6b1952690a39d85c9a68e58fa4dd457a3d034f6ef113c9c5114da29bc241592b7eb5951a204a801ccff1b56fc48e882c07f61ae
+  metadata.gz: 5c6d5eec0e0ac88104a95fb25e5b2fd280eac88bcd0d0cd4e78f241f3ed2101f1f87c953334da8687b62cfaf9285c10202c61d6a4d2057b0408399648e136dc5
+  data.tar.gz: 586f6cfc5c0fdcb9457ada941688f042c2dff53e15abe79c8e8efd534b0450f15e6d6f92a1852c00e8d1bd89290603389b36c42135708c05eccac2081fff4868

data/lib/VERSION

@@ -1 +1 @@
-3.0.677
+3.0.679

data/lib/v20210526/client.rb

@@ -303,7 +303,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 接口（ChannelCreateFlowByFiles）用于通过文件创建签署流程。此接口静默签能力不可直接使用，请联系客户经理申请使用
+        # 接口（ChannelCreateFlowByFiles）用PDF文件创建签署流程。
+
+        # 注: `此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。`
 
         # @param request: Request instance for ChannelCreateFlowByFiles.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowByFilesRequest`
@@ -1078,7 +1080,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 对流程的合同文件进行数字签名验证，判断文件是否被篡改。
+        # 对合同流程文件进行数字签名验证，判断数字签名是否有效，合同文件内容是否被篡改。
 
         # @param request: Request instance for ChannelVerifyPdf.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelVerifyPdfRequest`

data/lib/v20210526/models.rb

@@ -86,6 +86,8 @@ module TencentCloud
       # 签署方信息，发起合同后可获取到对应的签署方信息，如角色ID，角色名称
       class ApproverItem < TencentCloud::Common::AbstractModel
         # @param SignId: 签署方唯一编号
+
+        # 在动态签署人场景下，可以用此编号确定参与方
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type SignId: String
         # @param RecipientId: 签署方角色编号
@@ -1051,56 +1053,102 @@ module TencentCloud
 
       # ChannelCreateFlowByFiles请求参数结构体
       class ChannelCreateFlowByFilesRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 均必填。
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+        # <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+        # <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+        # </ul>
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param FlowName: 签署流程名称，长度不超过200个字符
+        # @param FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         # @type FlowName: String
-        # @param FlowDescription: 签署流程的描述，长度不超过1000个字符
+        # @param FlowDescription: 合同流程描述信息(可自定义此描述)，最大长度1000个字符。
         # @type FlowDescription: String
-        # @param FlowApprovers: 签署流程签约方列表，最多不超过50个参与方
+        # @param FlowApprovers: 合同流程的参与方列表, 最多可支持50个参与方，可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息，具体定义可以参考开发者中心的<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo" target="_blank">FlowApproverInfo结构体</a>。
+
+        # 如果合同流程是有序签署，Approvers列表中参与人的顺序就是默认的签署顺序, 请确保列表中参与人的顺序符合实际签署顺序。
         # @type FlowApprovers: Array
-        # @param FileIds: 签署文件资源Id列表，目前仅支持单个文件
+        # @param FileIds: 本合同流程需包含的PDF文件资源编号列表，通过<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">UploadFiles</a>接口获取PDF文件资源编号。
+
+        # 注: `目前，此接口仅支持单个文件发起。`
         # @type FileIds: Array
-        # @param Components: 签署文件中的发起方的填写控件，需要在发起的时候进行填充
+        # @param Components: 模板或者合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体
+        # <ul><li>单行文本控件</li>
+        # <li>多行文本控件</li>
+        # <li>勾选框控件</li>
+        # <li>数字控件</li>
+        # <li>图片控件</li>
+        # <li>数据表格等填写控件</li></ul>
         # @type Components: Array
-        # @param Deadline: 签署流程的签署截止时间。
-        # 值为unix时间戳,精确到秒,不传默认为当前时间一年后
-        # 不能早于当前时间
+        # @param Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的365天时截止。
+        # 如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
         # @type Deadline: Integer
-        # @param CallbackUrl: 签署流程回调地址，长度不超过255个字符
-        # 如果不传递回调地址， 则默认是配置应用号时候使用的回调地址
+        # @param CallbackUrl: 执行结果的回调URL，长度不超过255个字符，该URL仅支持HTTP或HTTPS协议，建议采用HTTPS协议以保证数据传输的安全性。
+        # 腾讯电子签服务器将通过POST方式，application/json格式通知执行结果，请确保外网可以正常访问该URL。
+        # 回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/partner/callback_data_types" target="_blank">回调通知</a>模块。
+
+        # 注:
+        # `如果不传递回调地址， 则默认是配置应用号时候使用的回调地址`
         # @type CallbackUrl: String
-        # @param Unordered: 合同签署顺序类型
-        # true - 无序签,
-        # false - 顺序签，
-        # 默认为false，即有序签署。
-        # 有序签署时以传入FlowApprovers数组的顺序作为签署顺序
+        # @param Unordered: 合同流程的签署顺序类型：
+        # <ul><li> **false**：(默认)有序签署, 本合同多个参与人需要依次签署 </li>
+        # <li> **true**：无序签署, 本合同多个参与人没有先后签署限制</li></ul>
+
+        # 注
+        # `有序签署时以传入FlowApprovers数组的顺序作为签署顺序`
         # @type Unordered: Boolean
-        # @param FlowType: 签署流程的类型，长度不超过255个字符
+        # @param FlowType: 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为255个字符，仅限中文、字母、数字和下划线组成。
         # @type FlowType: String
-        # @param CustomShowMap: 合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
+        # @param CustomShowMap: 您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板，模板中支持以下变量：
+        # <ul><li>{合同名称}   </li>
+        # <li>{发起方企业} </li>
+        # <li>{发起方姓名} </li>
+        # <li>{签署方N企业}</li>
+        # <li>{签署方N姓名}</li></ul>
+        # 其中，N表示签署方的编号，从1开始，不能超过签署人的数量。
+
+        # 例如，如果是腾讯公司张三发给李四名称为“租房合同”的合同，您可以将此字段设置为：`合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名}`，则小程序中列表页展示此合同为以下样子
+
+        # 合同名称：租房合同
+        # 发起方：腾讯公司(张三)
+        # 签署方：李四
+
         # @type CustomShowMap: String
-        # @param CustomerData: 业务信息，最大长度1000个字符。
+        # @param CustomerData: 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为 1000长度。
+
+        # 在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/partner/callback_types_contracts_sign" target="_blank">回调通知</a>模块。
         # @type CustomerData: String
-        # @param NeedSignReview: 发起方企业的签署人进行签署操作是否需要企业内部审批。 若设置为true,审核结果需通过接口 ChannelCreateFlowSignReview 通知电子签，审核通过后，发起方企业签署人方可进行签署操作，否则会阻塞其签署操作。  注：企业可以通过此功能与企业内部的审批流程进行关联，支持手动、静默签署合同。
+        # @param NeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+        # <ul><li> **false**：（默认）不需要审批，直接签署。</li>
+        # <li> **true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
+        # 企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
+        # <ul><li> 如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
+        # <li> 如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
+        # 注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
         # @type NeedSignReview: Boolean
         # @param ApproverVerifyType: 签署人校验方式
         # VerifyCheck: 人脸识别（默认）
         # MobileCheck：手机号验证，用户手机号和参与方手机号（ApproverMobile）相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）
         # 参数说明：可选人脸识别或手机号验证两种方式，若选择后者，未实名个人签署方在签署合同时，无需经过实名认证和意愿确认两次人脸识别，该能力仅适用于个人签署方。
         # @type ApproverVerifyType: String
-        # @param SignBeanTag: 标识是否允许发起后添加控件。
-        # 0为不允许
-        # 1为允许。
-        # 如果为1，创建的时候不能有签署控件，只能创建后添加。注意发起后添加控件功能不支持添加骑缝章和签批控件
+        # @param SignBeanTag: 签署方签署控件（印章/签名等）的生成方式：
+        # <ul><li> **0**：在合同流程发起时，由发起人指定签署方的签署控件的位置和数量。</li>
+        # <li> **1**：签署方在签署时自行添加签署控件，可以拖动位置和控制数量。</li></ul>
+
+        # 注:
+        # `发起后添加控件功能不支持添加签批控件`
         # @type SignBeanTag: Integer
-        # @param CcInfos: 被抄送人信息列表
+        # @param CcInfos: 合同流程的抄送人列表，最多可支持50个抄送人，抄送人可查看合同内容及签署进度，但无需参与合同签署。
         # @type CcInfos: Array
-        # @param CcNotifyType: 给关注人发送短信通知的类型，
-        # 0-合同发起时通知
-        # 1-签署完成后通知
+        # @param CcNotifyType: 可以设置以下时间节点来给抄送人发送短信通知来查看合同内容：
+        # <ul><li> **0**：合同发起时通知（默认值）</li>
+        # <li> **1**：签署完成后通知</li></ul>
         # @type CcNotifyType: Integer
-        # @param AutoSignScene: 个人自动签场景。发起自动签署时，需设置对应自动签署场景，目前仅支持场景：处方单-E_PRESCRIPTION_AUTO_SIGN
+        # @param AutoSignScene: 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传：
+        # <ul><li> **E_PRESCRIPTION_AUTO_SIGN**：处方单（医疗自动签）  </li></ul>
+        # 注: `个人自动签名场景是白名单功能，使用前请与对接的客户经理联系沟通。`
         # @type AutoSignScene: String
         # @param Operator: 操作者的信息，不用传
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -3335,9 +3383,11 @@ module TencentCloud
 
       # ChannelVerifyPdf请求参数结构体
       class ChannelVerifyPdfRequest < TencentCloud::Common::AbstractModel
-        # @param FlowId: 流程ID
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         # @type FlowId: String
-        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -3368,18 +3418,35 @@ module TencentCloud
 
       # ChannelVerifyPdf返回参数结构体
       class ChannelVerifyPdfResponse < TencentCloud::Common::AbstractModel
-        # @param VerifyResult: 验签结果，1-文件未被篡改，全部签名在腾讯电子签完成； 2-文件未被篡改，部分签名在腾讯电子签完成；3-文件被篡改；4-异常：文件内没有签名域；5-异常：文件签名格式错误
+        # @param VerifyResult: 验签结果代码，代码的含义如下：
+
+        # <ul><li>**1**：文件未被篡改，全部签名在腾讯电子签完成。</li>
+        # <li>**2**：文件未被篡改，部分签名在腾讯电子签完成。</li>
+        # <li>**3**：文件被篡改。</li>
+        # <li>**4**：异常：文件内没有签名域。</li>
+        # <li>**5**：异常：文件签名格式错误。</li></ul>
         # @type VerifyResult: Integer
-        # @param PdfVerifyResults: 验签结果详情,内部状态1-验签成功，在电子签签署；2-验签成功，在其他平台签署；3-验签失败；4-pdf文件没有签名域；5-文件签名格式错误
+        # @param PdfVerifyResults: 验签结果详情，每个签名域对应的验签结果。状态值如下
+        # <ul><li> **1** :验签成功，在电子签签署</li>
+        # <li> **2** :验签成功，在其他平台签署</li>
+        # <li> **3** :验签失败</li>
+        # <li> **4** :pdf文件没有签名域</li>
+        # <li> **5** :文件签名格式错误</li></ul>
         # @type PdfVerifyResults: Array
+        # @param VerifySerialNo: 验签序列号, 为11为数组组成的字符串
+        # @type VerifySerialNo: String
+        # @param PdfResourceMd5: 合同文件MD5哈希值
+        # @type PdfResourceMd5: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :VerifyResult, :PdfVerifyResults, :RequestId
+        attr_accessor :VerifyResult, :PdfVerifyResults, :VerifySerialNo, :PdfResourceMd5, :RequestId
 
-        def initialize(verifyresult=nil, pdfverifyresults=nil, requestid=nil)
+        def initialize(verifyresult=nil, pdfverifyresults=nil, verifyserialno=nil, pdfresourcemd5=nil, requestid=nil)
           @VerifyResult = verifyresult
           @PdfVerifyResults = pdfverifyresults
+          @VerifySerialNo = verifyserialno
+          @PdfResourceMd5 = pdfresourcemd5
           @RequestId = requestid
         end
 
@@ -3393,6 +3460,8 @@ module TencentCloud
               @PdfVerifyResults << pdfverifyresult_tmp
             end
           end
+          @VerifySerialNo = params['VerifySerialNo']
+          @PdfResourceMd5 = params['PdfResourceMd5']
           @RequestId = params['RequestId']
         end
       end
@@ -3582,13 +3651,7 @@ module TencentCloud
         # 2 FontSize： 范围12-72
         # 3 FontAlign： Left/Right/Center，左对齐/居中/右对齐
         # 4 FontColor：字符串类型，格式为RGB颜色数字
-        # 参数样例：    "ComponentExtra": "{\"FontColor\":\"255,0,0\",\"FontSize\":12}"
-
-        # TEXT/MULTI_LINE_TEXT控件可以指定
-        # 1 Font：目前只支持黑体、宋体
-        # 2 FontSize： 范围12-72
-        # 3 FontAlign： Left/Right/Center，左对齐/居中/右对齐
-        # 例如：{"FontSize":12}
+        # 参数样例：{\"FontColor\":\"255,0,0\",\"FontSize\":12}
 
         # ComponentType为FILL_IMAGE时，支持以下参数：
         # NotMakeImageCenter：bool。是否设置图片居中。false：居中（默认）。 true: 不居中
@@ -5240,53 +5303,68 @@ module TencentCloud
       # 其中签署方FlowApproverInfo需要传递的参数
       # 非单C、单B、B2C合同，ApproverType、RecipientId（模板发起合同时）必传，建议都传。
 
-      # 其他身份标识
+      # 其他身份标识，注：`如果发起的是动态签署方（即ApproverOption.FillType指定为1），可以不指定具体签署人信息`
 
       # <ul><li>1-个人：Name、Mobile必传</li>
       # <li>2-第三方平台子客企业指定经办人：OpenId必传，OrgName必传、OrgOpenId必传；</li>
       # <li>3-第三方平台子客企业不指定经办人：OrgName必传、OrgOpenId必传；</li>
-      # <li>4-非第三方平台子客企业：Name、Mobile必传，OrgName必传，且NotChannelOrganization=True。</li></ul>
+      # <li>4-非第三方平台子客企业(平台企业)：Name、Mobile必传，OrgName必传，且NotChannelOrganization=True。</li></ul>
 
       # RecipientId参数：
       # 从DescribeTemplates接口中，可以得到模板下的签署方Recipient列表，根据模板自定义的Rolename在此结构体中确定其RecipientId。
       class FlowApproverInfo < TencentCloud::Common::AbstractModel
-        # @param Name: 签署人姓名，最大长度50个字符
+        # @param Name: 签署方经办人的姓名。
+        # 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         # @type Name: String
-        # @param IdCardType: 签署人的证件类型
-        # 1.ID_CARD 居民身份证
-        # 2.HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证
-        # 3.HONGKONG_AND_MACAO 港澳居民来往内地通行证
-        # 4.OTHER_CARD_TYPE 其他（需要使用该类型请先联系运营经理）
+        # @param IdCardType: 签署方经办人的证件类型，支持以下类型
+        # <ul><li>ID_CARD : 居民身份证  (默认值)</li>
+        # <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+        # <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
+        # <li>OTHER_CARD_TYPE : 其他证件</li></ul>
+
+        # 注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
         # @type IdCardType: String
-        # @param IdCardNumber: 签署人证件号（长度不超过18位）
+        # @param IdCardNumber: 签署方经办人的证件号码，应符合以下规则
+        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+        # <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+        # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         # @type IdCardNumber: String
-        # @param Mobile: 签署人手机号，脱敏显示。大陆手机号为11位，暂不支持海外手机号。
+        # @param Mobile: 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)， 不支持海外手机号。
+        # 请确认手机号所有方为此合同签署方。
         # @type Mobile: String
-        # @param OrganizationName: 企业签署方工商营业执照上的企业名称，签署方为非发起方企业场景下必传，最大长度64个字符；
+        # @param OrganizationName: 组织机构名称。
+        # 请确认该名称与企业营业执照中注册的名称一致。
+        # 如果名称中包含英文括号()，请使用中文括号（）代替。
         # @type OrganizationName: String
-        # @param NotChannelOrganization: 指定签署人非第三方平台子客企业下员工，在ApproverType为ORGANIZATION时指定。
-        # 默认为false，即签署人位于同一个第三方平台应用号下；默认为false，即签署人位于同一个第三方应用号下；
+        # @param NotChannelOrganization: 指定签署人非第三方平台子客企业下员工还是SaaS平台企业，在ApproverType为ORGANIZATION时指定。
+        # <ul>
+        # <li>false: 默认值，第三方平台子客企业下员工</li>
+        # <li>true: SaaS平台企业下的员工</li>
+        # </ul>
         # @type NotChannelOrganization: Boolean
-        # @param OpenId: 用户侧第三方id，最大长度64个字符
+        # @param OpenId: 第三方平台子客企业员工的唯一标识，长度不能超过64，只能由字母和数字组成
+
         # 当签署方为同一第三方平台下的员工时，该字段若不指定，则发起【待领取】的流程
         # @type OpenId: String
-        # @param OrganizationOpenId: 企业签署方在同一第三方平台应用下的其他合作企业OpenId，签署方为非发起方企业场景下必传，最大长度64个字符；
+        # @param OrganizationOpenId: 同应用下第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样，签署方为非发起方企业场景下必传，最大长度64个字符
         # @type OrganizationOpenId: String
-        # @param ApproverType: 签署人类型
-        # PERSON-个人/自然人；
-        # PERSON_AUTO_SIGN-个人自动签署，适用于个人自动签场景
-        # 注: 个人自动签场景为白名单功能, 使用前请联系对接的客户经理沟通。
-        # ORGANIZATION-企业（企业签署方或模板发起时的企业静默签）；
-        # ENTERPRISESERVER-企业自动签（他方企业自动签署或文件发起时的本方企业自动签）
-
-        # 若要实现他方企业（同一应用下）自动签，需要满足3个条件：
-        # 条件1：ApproverType 设置为ENTERPRISESERVER
-        # 条件2：子客之间完成授权
-        # 条件3：联系对接的客户经理沟通
+        # @param ApproverType: 在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:
+        # <ul><li> **PERSON** :个人/自然人</li>
+        # <li> **PERSON_AUTO_SIGN** :个人/自然人自动签署，适用于个人自动签场景</li>
+        # <li> **ORGANIZATION** :企业/企业员工（企业签署方或模板发起时的企业静默签）</li>
+        # <li> **ENTERPRISESERVER** :企业/企业员自动签（他方企业自动签署或文件发起时的本方企业自动签）</li></ul>
+
+        # 注:
+        # `1. 个人自动签场景(PERSON_AUTO_SIGN)为白名单功能, 使用前请联系对接的客户经理沟通。`
+        # `2. 若要实现他方企业（同一应用下）自动签，需要满足3个条件：`
+        # <ul><li>条件1：ApproverType 设置为ENTERPRISESERVER</li>
+        # <li>条件2：子客之间完成授权</li>
+        # <li>条件3：联系对接的客户经理沟通如何使用</li></ul>
         # @type ApproverType: String
         # @param RecipientId: 签署流程签署人在模板中对应的签署人Id；在非单方签署、以及非B2C签署的场景下必传，用于指定当前签署方在签署流程中的位置；
         # @type RecipientId: String
-        # @param Deadline: 签署截止时间戳，默认一年
+        # @param Deadline: 本签署人在此合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的365天时截止。
+        # 如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
         # @type Deadline: Integer
         # @param CallbackUrl: 签署完回调url，最大长度1000个字符
         # @type CallbackUrl: String
@@ -5298,11 +5376,19 @@ module TencentCloud
         # 	ESIGN -- 个人印章类型
         # 	SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
         # @type ComponentLimitType: Array
-        # @param PreReadTime: 合同的强制预览时间：3~300s，未指定则按合同页数计算
+        # @param PreReadTime: 签署方在签署合同之前，需要强制阅读合同的时长，可指定为3秒至300秒之间的任意值。
+
+        # 若未指定阅读时间，则会按照合同页数大小计算阅读时间，计算规则如下：
+        # <ul>
+        # <li>合同页数少于等于2页，阅读时间为3秒；</li>
+        # <li>合同页数为3到5页，阅读时间为5秒；</li>
+        # <li>合同页数大于等于6页，阅读时间为10秒。</li>
+        # </ul>
         # @type PreReadTime: Integer
         # @param JumpUrl: 签署完前端跳转的url，此字段的用法场景请联系客户经理确认
         # @type JumpUrl: String
-        # @param ApproverOption: 签署人个性化能力值
+        # @param ApproverOption: 可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人等。
+        # 详细操作可以参考开发者中心的ApproverOption结构体。
         # @type ApproverOption: :class:`Tencentcloud::Essbasic.v20210526.models.ApproverOption`
         # @param ApproverNeedSignReview: 当前签署方进行签署操作是否需要企业内部审批，true 则为需要
         # @type ApproverNeedSignReview: Boolean
@@ -5317,14 +5403,17 @@ module TencentCloud
         # - 发起流程时系统自动补充
         # - 创建签署链接时，可以通过查询详情接口获得签署人的SignId，然后可传入此值为该签署人创建签署链接，无需再传姓名、手机号、证件号等其他信息
         # @type SignId: String
-        # @param NotifyType: SMS: 短信(需确保“电子签短信通知签署方”功能是开启状态才能生效); NONE: 不发信息
-        # 默认为SMS(签署方为子客时该字段不生效)
+        # @param NotifyType: 通知签署方经办人的方式, 有以下途径:
+        # <ul><li> **SMS** :(默认)短信</li>
+        # <li> **NONE** : 不通知</li></ul>
+
+        # 注: `签署方为第三方子客企业时会被置为NONE,   不会发短信通知`
         # @type NotifyType: String
         # @param AddSignComponentsLimits: [通过文件创建签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles)时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID）或签名方式。
 
         # 注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
         # @type AddSignComponentsLimits: Array
-        # @param ApproverRoleName: 自定义签署方角色名称
+        # @param ApproverRoleName: 自定义签署人角色名，如收款人、开具人、见证人等
         # @type ApproverRoleName: String
 
         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

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-essbasic
 version: !ruby/object:Gem::Version
-  version: 3.0.677
+  version: 3.0.679
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-16 00:00:00.000000000 Z
+date: 2023-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,11 +33,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/v20201222/client.rb
-- lib/v20201222/models.rb
-- lib/tencentcloud-sdk-essbasic.rb
-- lib/v20210526/client.rb
 - lib/v20210526/models.rb
+- lib/v20210526/client.rb
+- lib/tencentcloud-sdk-essbasic.rb
+- lib/v20201222/models.rb
+- lib/v20201222/client.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: