tencentcloud-sdk-ess 3.0.791 → 3.0.793

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 01ed4fba0ef302b3aed9b5effb83bf80a39eae29
-  data.tar.gz: 4c5788cd1d8e874791a67ea6b78b0ae2c49003c2
+  metadata.gz: 71728512c8018ca143c1ea013366b4edc5e158ee
+  data.tar.gz: c61d875ff78057ada18c260d5bea026d51205186
 SHA512:
-  metadata.gz: 36f12e4902c1e85dbc7315112252511b791e7b8538d5e55ffd115239c603ac1fa58779f82a41f5ebe444bcfa7f7a5eed6e24b5e26ef746bb14349e570df6afe0
-  data.tar.gz: 2a6b5f6f5aaf1a12d9d9df9f79b1d98259b20959dcf52823bb69c0a527354333acf7ed25575415b53577ad783b92f394866fa3336749538db909ed742365dfd0
+  metadata.gz: fd25af89b8d3dc6e4c5279ea46fa70b30e6c2fc0b03a971aa62fa27507108cb8905d22f66a1cc415596f92e0848b165e7389a0e498dacd2de744ce281762c08d
+  data.tar.gz: e984f1a6edcd7c98571d994d1ba89f8169f33ca1a54512031442f9af27a9123377ceba519b86312de2e3ade23064dfbc764e5fc722e72ed2e361cf0d4d9b44dd

data/lib/VERSION

@@ -1 +1 @@
-3.0.791
+3.0.793

data/lib/v20201111/models.rb

@@ -359,8 +359,10 @@ module TencentCloud
         # @type CanEditApprover: Boolean
         # @param FillType: 签署人信息补充类型，默认无需补充。
 
-        # <ul><li> **1** : ( 动态签署人（可发起合同后再补充签署人信息）注：`企业自动签不支持动态补充`</li>
-        # </ul>
+        # <ul><li> **1** : ( 动态签署人（可发起合同后再补充签署人信息）注：`企业自动签不支持动态补充`</li></ul>
+
+        # 注：
+        # `使用动态签署人能力前，需登陆腾讯电子签控制台打开服务开关`
         # @type FillType: Integer
         # @param FlowReadLimit: 签署人阅读合同限制参数
         #  <br/>取值：
@@ -2658,9 +2660,9 @@ module TencentCloud
         # @param CustomCreateFlowDescription: 定制化发起合同弹窗的描述信息，描述信息最长500字符
         # @type CustomCreateFlowDescription: String
         # @param ForbidAddApprover:   禁止添加签署方，若为true则在发起流程的可嵌入页面隐藏“添加签署人按钮”
-        # @type ForbidAddApprover: String
+        # @type ForbidAddApprover: Boolean
         # @param ForbidEditFlowProperties:   禁止设置设置签署流程属性 (顺序、合同签署认证方式等)，若为true则在发起流程的可嵌入页面隐藏签署流程设置面板
-        # @type ForbidEditFlowProperties: String
+        # @type ForbidEditFlowProperties: Boolean
         # @param HideComponentTypes: 在发起流程的可嵌入页面要隐藏的控件列表，和 ShowComponentTypes 参数 只能二选一使用，具体的控件类型如下
         # <ul><li>SIGN_SIGNATURE : 个人签名/印章</li>
         # <li>SIGN_SEAL : 企业印章</li>
@@ -7499,13 +7501,12 @@ module TencentCloud
 
       # 创建流程的签署方信息
       class FlowCreateApprover < TencentCloud::Common::AbstractModel
-        # @param ApproverType: 在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:
-        # 0：企业
-        # 1：个人
-        # 3：企业静默签署
-        # 注：类型为3（企业静默签署）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。
-        # 7: 个人自动签署，适用于个人自动签场景。
-        # 注: 个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。
+        # @param ApproverType: 在指定签署方时，可以选择企业B端或个人C端等不同的参与者类型，可选类型如下：
+
+        # <ul><li> <b>0</b> :企业B端。</li>
+        # <li> <b>1</b> :个人C端。</li>
+        # <li> <b>3</b> :企业B端静默（自动）签署，无需签署人参与，自动签署可以参考<a href="https://qian.tencent.com/developers/company/autosign_guide" target="_blank" rel="noopener noreferrer">自动签署使用说明</a>文档。</li>
+        # <li> <b>7</b> :个人C端自动签署，适用于个人自动签场景。注: <b>个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。</b> </li></ul>
         # @type ApproverType: Integer
         # @param OrganizationName: 组织机构名称。
         # 请确认该名称与企业营业执照中注册的名称一致。
@@ -7519,15 +7520,14 @@ module TencentCloud
 
         # 在未指定签署人电子签UserId情况下，为必填参数
         # @type ApproverName: String
-        # @param ApproverMobile: 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
-        # 请确认手机号所有方为此合同签署方。
+        # @param ApproverMobile: 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。 此手机号用于通知和用户的实名认证等环境，请确认手机号所有方为此合同签署方。
 
-        # 在未指定签署人电子签UserId情况下，为必填参数
+        # 注：`在未指定签署人电子签UserId情况下，为必填参数`
         # @type ApproverMobile: String
         # @param ApproverIdCardType: 证件类型，支持以下类型
-        # <ul><li>ID_CARD : 居民身份证 (默认值)</li>
-        # <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
-        # <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
+        # <ul><li><b>ID_CARD</b>: 居民身份证 (默认值)</li>
+        # <li><b>HONGKONG_AND_MACAO</b> : 港澳居民来往内地通行证</li>
+        # <li><b>HONGKONG_MACAO_AND_TAIWAN</b> : 港澳台居民居住证(格式同居民身份证)</li></ul>
         # @type ApproverIdCardType: String
         # @param ApproverIdCardNumber: 证件号码，应符合以下规则
         # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
@@ -7535,29 +7535,39 @@ module TencentCloud
         # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         # @type ApproverIdCardNumber: String
         # @param RecipientId: 签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。
-        # 模板发起合同时，该参数为必填项。
-        # 文件发起合同时，该参数无需传值。
+
+        # <b>模板发起合同时，该参数为必填项，可以通过[查询模版信息接口](https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFlowTemplates)获得。</b>
+        # <b>文件发起合同时，该参数无需传值。</b>
+
         # 如果开发者后续用合同模板发起合同，建议保存此值，在用合同模板发起合同中需此值绑定对应的签署经办人 。
         # @type RecipientId: String
         # @param VerifyChannel: 签署意愿确认渠道，默认为WEIXINAPP:人脸识别
 
-        # 注: 将要废弃, 用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
+        # 注: <font color="red">将要废弃</font >, `用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置`
         # @type VerifyChannel: Array
         # @param NotifyType: 通知签署方经办人的方式,  有以下途径:
         # <ul><li>  **sms**  :  (默认)短信</li>
         # <li>   **none**   : 不通知</li></ul>
 
-        # 注: `发起方也是签署方时不给此签署方发送短信`
+        # 注: `既是发起方又是签署方时，不给此签署方发送短信`
         # @type NotifyType: String
         # @param IsFullText: 合同强制需要阅读全文，无需传此参数
         # @type IsFullText: Boolean
-        # @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 UserId: 签署人userId，仅支持本企业的员工userid， 可在控制台组织管理处获得
 
-        # 注: `若传此字段 则以userid的信息为主，会覆盖传递过来的签署人基本信息， 包括姓名，手机号，证件类型等信息`
+        # 注：
+        # 如果传进来的<font color="red">UserId已经实名， 则忽略ApproverName，ApproverIdCardType，ApproverIdCardNumber，ApproverMobile这四个入参</font>（会用此UserId实名的身份证和登录的手机号覆盖）
         # @type UserId: String
-        # @param Required: 字段已经废弃，当前只支持true，默认为true
+        # @param Required: <font color="red">字段已经废弃</font>，当前只支持true，默认为true
         # @type Required: Boolean
         # @param ApproverSource: 在企微场景下使用，需设置参数为**WEWORKAPP**，以表明合同来源于企微。
         # @type ApproverSource: String
@@ -7572,9 +7582,12 @@ module TencentCloud
         # @type ApproverOption: :class:`Tencentcloud::Ess.v20201111.models.ApproverOption`
         # @param JumpUrl: 签署完前端跳转的url，暂未使用
         # @type JumpUrl: String
-        # @param SignId: 签署ID
-        # - 发起流程时系统自动补充
-        # - 创建签署链接时，可以通过查询详情接口获得签署人的SignId，然后可传入此值为该签署人创建签署链接，无需再传姓名、手机号、证件号等其他信息
+        # @param SignId: 签署人的签署ID
+
+        # <ul>
+        # <li>在CreateFlow、CreatePrepareFlow等发起流程时不需要传入此参数，电子签后台系统会自动生成。</li>
+        # <li>在CreateFlowSignUrl、CreateBatchQuickSignUrl等生成签署链接时，可以通过查询详情接口获取签署人的SignId，然后可以将此值传入，为该签署人创建签署链接。这样可以避免重复传输姓名、手机号、证件号等其他信息。</li>
+        # </ul>
         # @type SignId: String
         # @param ApproverNeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
         # <ul><li>**false**：（默认）不需要审批，直接签署。</li>
@@ -7606,11 +7619,16 @@ module TencentCloud
 
         # `此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主`
         # @type Components: Array
-        # @param ComponentLimitType: 签署方控件类型为 SIGN_SIGNATURE时，可以指定签署方签名方式
-        # 	HANDWRITE – 手写签名
-        # 	OCR_ESIGN -- AI智能识别手写签名
-        # 	ESIGN -- 个人印章类型
-        # 	SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
+        # @param ComponentLimitType: 当签署方控件类型为 <b>SIGN_SIGNATURE</b> 时，可以指定签署方签名方式。如果不指定，签署人可以使用所有的签名类型，可指定的签名类型包括：
+
+        # <ul><li> <b>HANDWRITE</b> :手写签名。</li>
+        # <li> <b>OCR_ESIGN</b> :AI智能识别手写签名。</li>
+        # <li> <b>ESIGN</b> :个人印章类型。</li>
+        # <li> <b>IMG_ESIGN</b>  : 图片印章。该类型支持用户在签署将上传的PNG格式的图片作为签名。</li>
+        # <li> <b>SYSTEM_ESIGN</b> :系统签名。该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署。</li></ul>
+
+        # 各种签名的样式可以参考下图：
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/ee0498856c060c065628a0c5ba780d6b.jpg)
         # @type ComponentLimitType: Array
         # @param ApproverVerifyTypes: 指定个人签署方查看合同的校验方式,可以传值如下:
         # <ul><li>  **1**   : （默认）人脸识别,人脸识别后才能合同内容</li>
@@ -7641,8 +7659,7 @@ module TencentCloud
         # 注：
         # `不指定该值时，默认为签署方自行选择。`
         # @type SignTypeSelector: Integer
-        # @param Deadline: Deadline
-        # 签署人的签署截止时间，格式为Unix标准时间戳（秒）
+        # @param Deadline: 签署人的签署截止时间，格式为Unix标准时间戳（秒）, 超过此时间未签署的合同变成已过期状态，不能在继续签署
 
         # 注: `若不设置此参数，则默认使用合同的截止时间，此参数暂不支持合同组子合同`
         # @type Deadline: Integer

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.791
+  version: 3.0.793
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-03-26 00:00:00.000000000 Z
+date: 2024-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common