tencentcloud-sdk-python-ess 3.1.81__tar.gz → 3.1.82__tar.gz

{tencentcloud_sdk_python_ess-3.1.81 → tencentcloud_sdk_python_ess-3.1.82}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-ess
-Version: 3.1.81
+Version: 3.1.82
 Summary: Tencent Cloud Ess SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.81
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.82
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_ess-3.1.81 → tencentcloud_sdk_python_ess-3.1.82}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-ess',
-    install_requires=["tencentcloud-sdk-python-common>=3.1.81,<4.0.0"],
+    install_requires=["tencentcloud-sdk-python-common>=3.1.82,<4.0.0"],
     
     version=tencentcloud.__version__,
     description='Tencent Cloud Ess SDK for Python',

{tencentcloud_sdk_python_ess-3.1.81 → tencentcloud_sdk_python_ess-3.1.82}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.81'
+__version__ = '3.1.82'

{tencentcloud_sdk_python_ess-3.1.81 → tencentcloud_sdk_python_ess-3.1.82}/tencentcloud/ess/v20201111/models.py

@@ -391,170 +391,60 @@ class ApproverInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ApproverType: 在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:
-**0**：企业
-**1**：个人
-**3**：企业静默签署
-注：`类型为3（企业静默签署）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。`
-**7**: 个人自动签署，适用于个人自动签场景。
-注: `个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。`
+        :param _ApproverType: <p>在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:<br><strong>0</strong>：企业<br><strong>1</strong>：个人<br><strong>3</strong>：企业静默签署<br>注：<code>类型为3（企业静默签署）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。</code><br><strong>7</strong>: 个人自动签署，适用于个人自动签场景。<br>注: <code>个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。</code></p>
         :type ApproverType: int
-        :param _ApproverName: 签署方经办人的姓名。
-经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
+        :param _ApproverName: <p>签署方经办人的姓名。<br>经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。</p>
         :type ApproverName: str
-        :param _ApproverMobile: 签署方经办人手机号码， 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。
-请确认手机号所有方为此合同签署方。
+        :param _ApproverMobile: <p>签署方经办人手机号码， 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。<br>请确认手机号所有方为此合同签署方。</p>
         :type ApproverMobile: str
-        :param _OrganizationName: 组织机构名称。
-请确认该名称与企业营业执照中注册的名称一致。
-如果名称中包含英文括号()，请使用中文括号（）代替。
-如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
-
+        :param _OrganizationName: <p>组织机构名称。<br>请确认该名称与企业营业执照中注册的名称一致。<br>如果名称中包含英文括号()，请使用中文括号（）代替。<br>如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。</p>
         :type OrganizationName: str
-        :param _SignComponents: 【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】合同中的该名签署方的签署控件列表，列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
-<ul><li> 个人签名/印章</li>
-<li> 企业印章</li>
-<li> 骑缝章等签署控件</li></ul>
-
-![image](https://qcloudimg.tencent-cloud.cn/raw/91757a7f9188ccf3057a4a8979cf3f93.png)
+        :param _SignComponents: <p>【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】合同中的该名签署方的签署控件列表，列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体</p><ul><li> 个人签名/印章</li><li> 企业印章</li><li> 骑缝章等签署控件</li></ul><p><img src="https://qcloudimg.tencent-cloud.cn/raw/91757a7f9188ccf3057a4a8979cf3f93.png" alt="image"></p>
         :type SignComponents: list of Component
-        :param _ApproverIdCardType: 签署方经办人的证件类型，支持以下类型，样式可以参考<a href="https://qian.tencent.com/developers/partner/id_card_support/" target="_blank">常见个人证件类型介绍</a>
-<ul><li>ID_CARD 中国大陆居民身份证  (默认值)</li>
-<li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
-<li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
-<li>OTHER_CARD_TYPE 其他证件</li></ul>
-
-
-
-
-注: 
-1. <b>其他证件类型为白名单功能</b>，使用前请联系对接的客户经理沟通。
-2. 港澳居民来往内地通行证 和  港澳台居民居住证 类型的签署人<b>至少要过一次大陆的海关</b>才能使用。
+        :param _ApproverIdCardType: <p>签署方经办人的证件类型，支持以下类型，样式可以参考<a href="https://qian.tencent.com/developers/partner/id_card_support/" target="_blank">常见个人证件类型介绍</a></p><ul><li>ID_CARD 中国大陆居民身份证  (默认值)</li><li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li><li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li><li>OTHER_CARD_TYPE 其他证件</li></ul><p>注: </p><ol><li><b>其他证件类型为白名单功能</b>，使用前请联系对接的客户经理沟通。</li><li>港澳居民来往内地通行证 和  港澳台居民居住证 类型的签署人<b>至少要过一次大陆的海关</b>才能使用。</li></ol>
         :type ApproverIdCardType: str
-        :param _ApproverIdCardNumber: 签署方经办人的证件号码，应符合以下规则
-<ul><li>中国大陆居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>中国港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给中国香港居民，“M”字头签发给中国澳门居民；第2位至第11位为数字。</li>
-<li>中国港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
+        :param _ApproverIdCardNumber: <p>签署方经办人的证件号码，应符合以下规则</p><ul><li>中国大陆居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li><li>中国港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给中国香港居民，“M”字头签发给中国澳门居民；第2位至第11位为数字。</li><li>中国港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type ApproverIdCardNumber: str
-        :param _NotifyType: 通知签署方经办人的方式,  有以下途径:
-<ul><li>  **sms**  :  (默认)短信</li>
-<li>   **none**   : 不通知</li></ul>
-
-注意：
-`如果使用的是通过文件发起合同（CreateFlowByFiles），NotifyType必须 是 sms 才会发送短信`
+        :param _NotifyType: <p>通知签署方经办人的方式,  有以下途径:</p><ul><li>  **sms**  :  (默认)短信</li><li>  **email**  :  邮箱</li><li>  **all**  :  短信+邮箱</li><li>   **none**   : 不通知</li></ul><p>注意：<br><code>如果使用的是通过文件发起合同（CreateFlowByFiles），NotifyType必须 是 sms 才会发送短信</code></p><p>枚举值：</p><ul><li>sms： 短信通知</li><li>email： 邮件通知</li><li>all： 短信+邮件通知</li><li>none： 不做任何形式的通知</li></ul>
         :type NotifyType: str
-        :param _ApproverRole: 收据场景设置签署人角色类型, 可以设置如下<b>类型</b>:
-<ul><li> **1**  :收款人</li>
-<li>   **2**   :开具人</li>
-<li>   **3** :见证人</li></ul>
-注: `收据场景为白名单功能，使用前请联系对接的客户经理沟通。`
+        :param _ApproverRole: <p>收据场景设置签署人角色类型, 可以设置如下<b>类型</b>:</p><ul><li> **1**  :收款人</li><li>   **2**   :开具人</li><li>   **3** :见证人</li></ul>注: <code>收据场景为白名单功能，使用前请联系对接的客户经理沟通。</code>
         :type ApproverRole: int
-        :param _ApproverRoleName: 可以自定义签署人角色名：收款人、开具人、见证人等，长度不能超过20，只能由中文、字母、数字和下划线组成。
-
-注: `如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的`
+        :param _ApproverRoleName: <p>可以自定义签署人角色名：收款人、开具人、见证人等，长度不能超过20，只能由中文、字母、数字和下划线组成。</p><p>注: <code>如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的</code></p>
         :type ApproverRoleName: str
-        :param _VerifyChannel: <font color="red">【已不再使用】</font>签署意愿确认渠道，默认为WEIXINAPP:人脸识别
-
-注: 该字段已不再使用, 请用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
+        :param _VerifyChannel: <p><font color="red">【已不再使用】</font>签署意愿确认渠道，默认为WEIXINAPP:人脸识别</p><p>注: 该字段已不再使用, 请用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置</p>
         :type VerifyChannel: list of str
-        :param _PreReadTime: 签署方在签署合同之前，需要强制阅读合同的时长，可指定为3秒至300秒之间的任意值。
-
-若未指定阅读时间，则会按照合同页数大小计算阅读时间，计算规则如下：
-<ul><li>合同页数少于等于2页，阅读时间为3秒；</li>
-<li>合同页数为3到5页，阅读时间为5秒；</li>
-<li>合同页数大于等于6页，阅读时间为10秒。</li></ul>
+        :param _PreReadTime: <p>签署方在签署合同之前，需要强制阅读合同的时长，可指定为3秒至300秒之间的任意值。</p><p>若未指定阅读时间，则会按照合同页数大小计算阅读时间，计算规则如下：</p><ul><li>合同页数少于等于2页，阅读时间为3秒；</li><li>合同页数为3到5页，阅读时间为5秒；</li><li>合同页数大于等于6页，阅读时间为10秒。</li></ul>
         :type PreReadTime: int
-        :param _UserId: 签署人userId，仅支持本企业的员工userid， 可在控制台组织管理处获得
-
-注： 
-如果传进来的<font color="red">UserId已经实名， 则忽略ApproverName，ApproverIdCardType，ApproverIdCardNumber，ApproverMobile这四个入参</font>（会用此UserId实名的身份证和登录的手机号覆盖）
+        :param _UserId: <p>签署人userId，仅支持本企业的员工userid， 可在控制台组织管理处获得</p><p>注：<br>如果传进来的<font color="red">UserId已经实名， 则忽略ApproverName，ApproverIdCardType，ApproverIdCardNumber，ApproverMobile这四个入参</font>（会用此UserId实名的身份证和登录的手机号覆盖）</p>
         :type UserId: str
-        :param _ApproverSource: 在企微场景下使用，需设置参数为**WEWORKAPP**，以表明合同来源于企微。
+        :param _ApproverSource: <p>在企微场景下使用，需设置参数为<strong>WEWORKAPP</strong>，以表明合同来源于企微。</p>
         :type ApproverSource: str
-        :param _CustomApproverTag: 在企业微信场景下，表明该合同流程为或签，其最大长度为64位字符串。
-所有参与或签的人员均需具备该标识。
-注意，在合同中，不同的或签参与人必须保证其CustomApproverTag唯一。
-如果或签签署人为本方企业微信参与人，则需要指定ApproverSource参数为WEWORKAPP。
+        :param _CustomApproverTag: <p>在企业微信场景下，表明该合同流程为或签，其最大长度为64位字符串。<br>所有参与或签的人员均需具备该标识。<br>注意，在合同中，不同的或签参与人必须保证其CustomApproverTag唯一。<br>如果或签签署人为本方企业微信参与人，则需要指定ApproverSource参数为WEWORKAPP。</p>
         :type CustomApproverTag: str
-        :param _ApproverOption: 可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人等。
-详细操作可以参考开发者中心的ApproverOption结构体。
+        :param _ApproverOption: <p>可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人等。<br>详细操作可以参考开发者中心的ApproverOption结构体。</p>
         :type ApproverOption: :class:`tencentcloud.ess.v20201111.models.ApproverOption`
-        :param _ApproverVerifyTypes: 【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】指定个人签署方查看合同的校验方式,可以传值如下:
-<ul><li>  **1**   : （默认）人脸识别,人脸识别后才能合同内容</li>
-<li>  **2**  : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）
-</li></ul>
-注: 
-<ul><li>如果合同流程设置ApproverVerifyType查看合同的校验方式,    则忽略此签署人的查看合同的校验方式</li>
-<li>此字段可传多个校验方式</li></ul>
-
-
+        :param _ApproverVerifyTypes: <p>【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】指定个人签署方查看合同的校验方式,可以传值如下:</p><ul><li>  **1**   : （默认）人脸识别,人脸识别后才能合同内容</li><li>  **2**  : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）</li></ul>注: <ul><li>如果合同流程设置ApproverVerifyType查看合同的校验方式,    则忽略此签署人的查看合同的校验方式</li><li>此字段可传多个校验方式</li></ul>
         :type ApproverVerifyTypes: list of int
-        :param _ApproverSignTypes: 【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】您可以指定签署方签署合同的认证校验方式，可传递以下值：
-<ul><li>**1**：人脸认证，需进行人脸识别成功后才能签署合同；</li>
-<li>**2**：签署密码，需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署；</li>
-<li>**3**：运营商三要素，需到运营商处比对手机号实名信息（名字、手机号、证件号）校验一致才能成功进行合同签署。（如果是港澳台客户，建议不要选择这个）</li>
-<li>**5**：设备指纹识别，需要对比手机机主预留的指纹信息，校验一致才能成功进行合同签署。（iOS系统暂不支持该校验方式）</li>
-<li>**6**：设备面容识别，需要对比手机机主预留的人脸信息，校验一致才能成功进行合同签署。（Android系统暂不支持该校验方式）</li></ul>
-
-
-默认为：
-1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)
-
-注：
-1. 用<font color='red'>模板创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color='red'>在创建合同重新指定无效</font>
-2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/company/mobile_support)得到具体的支持说明
-3. 校验方式不允许只包含<font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>，至少需要再增加一种其他校验方式。
-4. <font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>只支持小程序使用，其他端暂不支持。
+        :param _ApproverSignTypes: <p>【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】您可以指定签署方签署合同的认证校验方式，可传递以下值：</p><ul><li>**1**：人脸认证，需进行人脸识别成功后才能签署合同；</li><li>**2**：签署密码，需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署；</li><li>**3**：运营商三要素，需到运营商处比对手机号实名信息（名字、手机号、证件号）校验一致才能成功进行合同签署。（如果是港澳台客户，建议不要选择这个）</li><li>**5**：设备指纹识别，需要对比手机机主预留的指纹信息，校验一致才能成功进行合同签署。（iOS系统暂不支持该校验方式）</li><li>**6**：设备面容识别，需要对比手机机主预留的人脸信息，校验一致才能成功进行合同签署。（Android系统暂不支持该校验方式）</li></ul><p>默认为：<br>1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)</p><p>注：</p><ol><li>用<font color="red">模板创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color="red">在创建合同重新指定无效</font></li><li>运营商三要素认证方式对手机号运营商及前缀有限制,可以参考<a href="https://qian.tencent.com/developers/company/mobile_support">运营商支持列表类</a>得到具体的支持说明</li><li>校验方式不允许只包含<font color="red">设备指纹识别</font>和<font color="red">设备面容识别</font>，至少需要再增加一种其他校验方式。</li><li><font color="red">设备指纹识别</font>和<font color="red">设备面容识别</font>只支持小程序使用，其他端暂不支持。</li></ol>
         :type ApproverSignTypes: list of int
-        :param _ApproverNeedSignReview: 此签署人（员工或者个人）签署前，是否需要发起方企业审批，取值如下：
-<ul><li>**false**：（默认）不需要审批，直接签署。</li>
-<li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
-企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
-<ul><li>如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
-<li>如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
-
-注：`此功能可用于与发起方企业内部的审批流程进行关联，支持手动、静默签署合同`
-
-![image](https://qcloudimg.tencent-cloud.cn/raw/b14d5188ed0229d1401e74a9a49cab6d.png)
+        :param _ApproverNeedSignReview: <p>此签署人（员工或者个人）签署前，是否需要发起方企业审批，取值如下：</p><ul><li>**false**：（默认）不需要审批，直接签署。</li><li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果<ul><li>如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li><li>如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul><p>注：<code>此功能可用于与发起方企业内部的审批流程进行关联，支持手动、静默签署合同</code></p><p><img src="https://qcloudimg.tencent-cloud.cn/raw/b14d5188ed0229d1401e74a9a49cab6d.png" alt="image"></p>
         :type ApproverNeedSignReview: bool
-        :param _AddSignComponentsLimits: 【在用文件发起合同场景下才有效】在调用[用PDF文件创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles)创建合同时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID或者印章类型）或签名方式。
-
-注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
+        :param _AddSignComponentsLimits: <p>【在用文件发起合同场景下才有效】在调用<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles">用PDF文件创建签署流程</a>创建合同时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID或者印章类型）或签名方式。</p><p>注：<code>限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。</code></p>
         :type AddSignComponentsLimits: list of ComponentLimit
-        :param _SignInstructionContent: 签署须知：支持传入富文本，最长字数：500个中文字符
+        :param _SignInstructionContent: <p>签署须知：支持传入富文本，最长字数：500个中文字符</p>
         :type SignInstructionContent: str
-        :param _Deadline: 签署人的签署截止时间，格式为Unix标准时间戳（秒）
-
-注: `若不设置此参数，则默认使用合同的截止时间，此参数暂不支持合同组子合同`
+        :param _Deadline: <p>签署人的签署截止时间，格式为Unix标准时间戳（秒）</p><p>注: <code>若不设置此参数，则默认使用合同的截止时间，此参数暂不支持合同组子合同</code></p>
         :type Deadline: int
-        :param _Components: 【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】签署人在合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体
-<ul><li>单行文本控件</li>
-<li>多行文本控件</li>
-<li>勾选框控件</li>
-<li>数字控件</li>
-<li>图片控件</li>
-</ul>
-
-具体使用说明可参考[为签署方指定填写控件](https://qian.tencent.cn/developers/company/createFlowByFiles/#指定签署方填写控件)
-
-注：`此参数仅在通过文件发起合同或者合同组时生效`
-
-![image](https://qcloudimg.tencent-cloud.cn/raw/e004195ee4cb98a7f9bc12eb4a0a0b77.png)
+        :param _Components: <p>【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】签署人在合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体</p><ul><li>单行文本控件</li><li>多行文本控件</li><li>勾选框控件</li><li>数字控件</li><li>图片控件</li></ul><p>具体使用说明可参考<a href="https://qian.tencent.cn/developers/company/createFlowByFiles/#指定签署方填写控件">为签署方指定填写控件</a></p><p>注：<code>此参数仅在通过文件发起合同或者合同组时生效</code></p><p><img src="https://qcloudimg.tencent-cloud.cn/raw/e004195ee4cb98a7f9bc12eb4a0a0b77.png" alt="image"></p>
         :type Components: list of Component
-        :param _SignEndpoints: 进入签署流程的限制，目前支持以下选项：
-<ul><li> <b>空值（默认）</b> :无限制，可在任何场景进入签署流程。</li><li> <b>link</b> :选择此选项后，将无法通过控制台或电子签小程序列表进入填写或签署操作，仅可预览合同。填写或签署流程只能通过短信或发起方提供的专用链接进行。</li></ul>
+        :param _SignEndpoints: <p>进入签署流程的限制，目前支持以下选项：</p><ul><li> <b>空值（默认）</b> :无限制，可在任何场景进入签署流程。</li><li> <b>link</b> :选择此选项后，将无法通过控制台或电子签小程序列表进入填写或签署操作，仅可预览合同。填写或签署流程只能通过短信或发起方提供的专用链接进行。</li></ul>
         :type SignEndpoints: list of str
-        :param _RegisterInfo: 快速注册相关信息
-
+        :param _RegisterInfo: <p>快速注册相关信息</p>
         :type RegisterInfo: :class:`tencentcloud.ess.v20201111.models.RegisterInfo`
-        :param _NotSaveContact: 是否不保存联系人
-默认 false 保存联系人  true 不保存联系人
-
-设置这个参数为保存联系人的时候,他方企业签署人会被保存进发起人的联系人中。
-联系人查看可登录[电子签控制台](https://test.qian.tencent.cn/console/) 进行查看。
-如下图位置：
-![](https://qcloudimg.tencent-cloud.cn/raw/fb8a22cd615d24c21acfa0e37e2cd873.png)
+        :param _NotSaveContact: <p>是否不保存联系人<br>默认 false 保存联系人  true 不保存联系人</p><p>设置这个参数为保存联系人的时候,他方企业签署人会被保存进发起人的联系人中。<br>联系人查看可登录<a href="https://test.qian.tencent.cn/console/">电子签控制台</a> 进行查看。<br>如下图位置：<br><img src="https://qcloudimg.tencent-cloud.cn/raw/fb8a22cd615d24c21acfa0e37e2cd873.png" alt=""></p>
         :type NotSaveContact: bool
+        :param _ApproverEmail: <p>客户指定的邮箱信息</p>
+        :type ApproverEmail: str
         """
         self._ApproverType = None
         self._ApproverName = None
@@ -582,16 +472,11 @@ class ApproverInfo(AbstractModel):
         self._SignEndpoints = None
         self._RegisterInfo = None
         self._NotSaveContact = None
+        self._ApproverEmail = None
 
     @property
     def ApproverType(self):
-        r"""在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:
-**0**：企业
-**1**：个人
-**3**：企业静默签署
-注：`类型为3（企业静默签署）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。`
-**7**: 个人自动签署，适用于个人自动签场景。
-注: `个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。`
+        r"""<p>在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:<br><strong>0</strong>：企业<br><strong>1</strong>：个人<br><strong>3</strong>：企业静默签署<br>注：<code>类型为3（企业静默签署）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。</code><br><strong>7</strong>: 个人自动签署，适用于个人自动签场景。<br>注: <code>个人自动签场景为白名单功能，使用前请联系对接的客户经理沟通。</code></p>
         :rtype: int
         """
         return self._ApproverType
@@ -602,8 +487,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverName(self):
-        r"""签署方经办人的姓名。
-经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
+        r"""<p>签署方经办人的姓名。<br>经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。</p>
         :rtype: str
         """
         return self._ApproverName
@@ -614,8 +498,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverMobile(self):
-        r"""签署方经办人手机号码， 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。
-请确认手机号所有方为此合同签署方。
+        r"""<p>签署方经办人手机号码， 支持中国大陆手机号11位数字(无需加+86前缀或其他字符)。<br>请确认手机号所有方为此合同签署方。</p>
         :rtype: str
         """
         return self._ApproverMobile
@@ -626,11 +509,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def OrganizationName(self):
-        r"""组织机构名称。
-请确认该名称与企业营业执照中注册的名称一致。
-如果名称中包含英文括号()，请使用中文括号（）代替。
-如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
-
+        r"""<p>组织机构名称。<br>请确认该名称与企业营业执照中注册的名称一致。<br>如果名称中包含英文括号()，请使用中文括号（）代替。<br>如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。</p>
         :rtype: str
         """
         return self._OrganizationName
@@ -641,12 +520,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def SignComponents(self):
-        r"""【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】合同中的该名签署方的签署控件列表，列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体
-<ul><li> 个人签名/印章</li>
-<li> 企业印章</li>
-<li> 骑缝章等签署控件</li></ul>
-
-![image](https://qcloudimg.tencent-cloud.cn/raw/91757a7f9188ccf3057a4a8979cf3f93.png)
+        r"""<p>【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】合同中的该名签署方的签署控件列表，列表中可支持下列多种签署控件,控件的详细定义参考开发者中心的Component结构体</p><ul><li> 个人签名/印章</li><li> 企业印章</li><li> 骑缝章等签署控件</li></ul><p><img src="https://qcloudimg.tencent-cloud.cn/raw/91757a7f9188ccf3057a4a8979cf3f93.png" alt="image"></p>
         :rtype: list of Component
         """
         return self._SignComponents
@@ -657,18 +531,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverIdCardType(self):
-        r"""签署方经办人的证件类型，支持以下类型，样式可以参考<a href="https://qian.tencent.com/developers/partner/id_card_support/" target="_blank">常见个人证件类型介绍</a>
-<ul><li>ID_CARD 中国大陆居民身份证  (默认值)</li>
-<li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
-<li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
-<li>OTHER_CARD_TYPE 其他证件</li></ul>
-
-
-
-
-注: 
-1. <b>其他证件类型为白名单功能</b>，使用前请联系对接的客户经理沟通。
-2. 港澳居民来往内地通行证 和  港澳台居民居住证 类型的签署人<b>至少要过一次大陆的海关</b>才能使用。
+        r"""<p>签署方经办人的证件类型，支持以下类型，样式可以参考<a href="https://qian.tencent.com/developers/partner/id_card_support/" target="_blank">常见个人证件类型介绍</a></p><ul><li>ID_CARD 中国大陆居民身份证  (默认值)</li><li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li><li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li><li>OTHER_CARD_TYPE 其他证件</li></ul><p>注: </p><ol><li><b>其他证件类型为白名单功能</b>，使用前请联系对接的客户经理沟通。</li><li>港澳居民来往内地通行证 和  港澳台居民居住证 类型的签署人<b>至少要过一次大陆的海关</b>才能使用。</li></ol>
         :rtype: str
         """
         return self._ApproverIdCardType
@@ -679,10 +542,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverIdCardNumber(self):
-        r"""签署方经办人的证件号码，应符合以下规则
-<ul><li>中国大陆居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>中国港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给中国香港居民，“M”字头签发给中国澳门居民；第2位至第11位为数字。</li>
-<li>中国港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
+        r"""<p>签署方经办人的证件号码，应符合以下规则</p><ul><li>中国大陆居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li><li>中国港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给中国香港居民，“M”字头签发给中国澳门居民；第2位至第11位为数字。</li><li>中国港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :rtype: str
         """
         return self._ApproverIdCardNumber
@@ -693,12 +553,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def NotifyType(self):
-        r"""通知签署方经办人的方式,  有以下途径:
-<ul><li>  **sms**  :  (默认)短信</li>
-<li>   **none**   : 不通知</li></ul>
-
-注意：
-`如果使用的是通过文件发起合同（CreateFlowByFiles），NotifyType必须 是 sms 才会发送短信`
+        r"""<p>通知签署方经办人的方式,  有以下途径:</p><ul><li>  **sms**  :  (默认)短信</li><li>  **email**  :  邮箱</li><li>  **all**  :  短信+邮箱</li><li>   **none**   : 不通知</li></ul><p>注意：<br><code>如果使用的是通过文件发起合同（CreateFlowByFiles），NotifyType必须 是 sms 才会发送短信</code></p><p>枚举值：</p><ul><li>sms： 短信通知</li><li>email： 邮件通知</li><li>all： 短信+邮件通知</li><li>none： 不做任何形式的通知</li></ul>
         :rtype: str
         """
         return self._NotifyType
@@ -709,11 +564,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverRole(self):
-        r"""收据场景设置签署人角色类型, 可以设置如下<b>类型</b>:
-<ul><li> **1**  :收款人</li>
-<li>   **2**   :开具人</li>
-<li>   **3** :见证人</li></ul>
-注: `收据场景为白名单功能，使用前请联系对接的客户经理沟通。`
+        r"""<p>收据场景设置签署人角色类型, 可以设置如下<b>类型</b>:</p><ul><li> **1**  :收款人</li><li>   **2**   :开具人</li><li>   **3** :见证人</li></ul>注: <code>收据场景为白名单功能，使用前请联系对接的客户经理沟通。</code>
         :rtype: int
         """
         return self._ApproverRole
@@ -724,9 +575,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverRoleName(self):
-        r"""可以自定义签署人角色名：收款人、开具人、见证人等，长度不能超过20，只能由中文、字母、数字和下划线组成。
-
-注: `如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的`
+        r"""<p>可以自定义签署人角色名：收款人、开具人、见证人等，长度不能超过20，只能由中文、字母、数字和下划线组成。</p><p>注: <code>如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的</code></p>
         :rtype: str
         """
         return self._ApproverRoleName
@@ -737,9 +586,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def VerifyChannel(self):
-        r"""<font color="red">【已不再使用】</font>签署意愿确认渠道，默认为WEIXINAPP:人脸识别
-
-注: 该字段已不再使用, 请用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置
+        r"""<p><font color="red">【已不再使用】</font>签署意愿确认渠道，默认为WEIXINAPP:人脸识别</p><p>注: 该字段已不再使用, 请用ApproverSignTypes签署人签署合同时的认证方式代替, 新客户可请用ApproverSignTypes来设置</p>
         :rtype: list of str
         """
         return self._VerifyChannel
@@ -750,12 +597,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def PreReadTime(self):
-        r"""签署方在签署合同之前，需要强制阅读合同的时长，可指定为3秒至300秒之间的任意值。
-
-若未指定阅读时间，则会按照合同页数大小计算阅读时间，计算规则如下：
-<ul><li>合同页数少于等于2页，阅读时间为3秒；</li>
-<li>合同页数为3到5页，阅读时间为5秒；</li>
-<li>合同页数大于等于6页，阅读时间为10秒。</li></ul>
+        r"""<p>签署方在签署合同之前，需要强制阅读合同的时长，可指定为3秒至300秒之间的任意值。</p><p>若未指定阅读时间，则会按照合同页数大小计算阅读时间，计算规则如下：</p><ul><li>合同页数少于等于2页，阅读时间为3秒；</li><li>合同页数为3到5页，阅读时间为5秒；</li><li>合同页数大于等于6页，阅读时间为10秒。</li></ul>
         :rtype: int
         """
         return self._PreReadTime
@@ -766,10 +608,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def UserId(self):
-        r"""签署人userId，仅支持本企业的员工userid， 可在控制台组织管理处获得
-
-注： 
-如果传进来的<font color="red">UserId已经实名， 则忽略ApproverName，ApproverIdCardType，ApproverIdCardNumber，ApproverMobile这四个入参</font>（会用此UserId实名的身份证和登录的手机号覆盖）
+        r"""<p>签署人userId，仅支持本企业的员工userid， 可在控制台组织管理处获得</p><p>注：<br>如果传进来的<font color="red">UserId已经实名， 则忽略ApproverName，ApproverIdCardType，ApproverIdCardNumber，ApproverMobile这四个入参</font>（会用此UserId实名的身份证和登录的手机号覆盖）</p>
         :rtype: str
         """
         return self._UserId
@@ -780,7 +619,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverSource(self):
-        r"""在企微场景下使用，需设置参数为**WEWORKAPP**，以表明合同来源于企微。
+        r"""<p>在企微场景下使用，需设置参数为<strong>WEWORKAPP</strong>，以表明合同来源于企微。</p>
         :rtype: str
         """
         return self._ApproverSource
@@ -791,10 +630,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def CustomApproverTag(self):
-        r"""在企业微信场景下，表明该合同流程为或签，其最大长度为64位字符串。
-所有参与或签的人员均需具备该标识。
-注意，在合同中，不同的或签参与人必须保证其CustomApproverTag唯一。
-如果或签签署人为本方企业微信参与人，则需要指定ApproverSource参数为WEWORKAPP。
+        r"""<p>在企业微信场景下，表明该合同流程为或签，其最大长度为64位字符串。<br>所有参与或签的人员均需具备该标识。<br>注意，在合同中，不同的或签参与人必须保证其CustomApproverTag唯一。<br>如果或签签署人为本方企业微信参与人，则需要指定ApproverSource参数为WEWORKAPP。</p>
         :rtype: str
         """
         return self._CustomApproverTag
@@ -805,8 +641,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverOption(self):
-        r"""可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人等。
-详细操作可以参考开发者中心的ApproverOption结构体。
+        r"""<p>可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人等。<br>详细操作可以参考开发者中心的ApproverOption结构体。</p>
         :rtype: :class:`tencentcloud.ess.v20201111.models.ApproverOption`
         """
         return self._ApproverOption
@@ -817,15 +652,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverVerifyTypes(self):
-        r"""【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】指定个人签署方查看合同的校验方式,可以传值如下:
-<ul><li>  **1**   : （默认）人脸识别,人脸识别后才能合同内容</li>
-<li>  **2**  : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）
-</li></ul>
-注: 
-<ul><li>如果合同流程设置ApproverVerifyType查看合同的校验方式,    则忽略此签署人的查看合同的校验方式</li>
-<li>此字段可传多个校验方式</li></ul>
-
-
+        r"""<p>【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】指定个人签署方查看合同的校验方式,可以传值如下:</p><ul><li>  **1**   : （默认）人脸识别,人脸识别后才能合同内容</li><li>  **2**  : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）</li></ul>注: <ul><li>如果合同流程设置ApproverVerifyType查看合同的校验方式,    则忽略此签署人的查看合同的校验方式</li><li>此字段可传多个校验方式</li></ul>
         :rtype: list of int
         """
         return self._ApproverVerifyTypes
@@ -836,22 +663,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverSignTypes(self):
-        r"""【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】您可以指定签署方签署合同的认证校验方式，可传递以下值：
-<ul><li>**1**：人脸认证，需进行人脸识别成功后才能签署合同；</li>
-<li>**2**：签署密码，需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署；</li>
-<li>**3**：运营商三要素，需到运营商处比对手机号实名信息（名字、手机号、证件号）校验一致才能成功进行合同签署。（如果是港澳台客户，建议不要选择这个）</li>
-<li>**5**：设备指纹识别，需要对比手机机主预留的指纹信息，校验一致才能成功进行合同签署。（iOS系统暂不支持该校验方式）</li>
-<li>**6**：设备面容识别，需要对比手机机主预留的人脸信息，校验一致才能成功进行合同签署。（Android系统暂不支持该校验方式）</li></ul>
-
-
-默认为：
-1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)
-
-注：
-1. 用<font color='red'>模板创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color='red'>在创建合同重新指定无效</font>
-2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/company/mobile_support)得到具体的支持说明
-3. 校验方式不允许只包含<font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>，至少需要再增加一种其他校验方式。
-4. <font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>只支持小程序使用，其他端暂不支持。
+        r"""<p>【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】您可以指定签署方签署合同的认证校验方式，可传递以下值：</p><ul><li>**1**：人脸认证，需进行人脸识别成功后才能签署合同；</li><li>**2**：签署密码，需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署；</li><li>**3**：运营商三要素，需到运营商处比对手机号实名信息（名字、手机号、证件号）校验一致才能成功进行合同签署。（如果是港澳台客户，建议不要选择这个）</li><li>**5**：设备指纹识别，需要对比手机机主预留的指纹信息，校验一致才能成功进行合同签署。（iOS系统暂不支持该校验方式）</li><li>**6**：设备面容识别，需要对比手机机主预留的人脸信息，校验一致才能成功进行合同签署。（Android系统暂不支持该校验方式）</li></ul><p>默认为：<br>1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)</p><p>注：</p><ol><li>用<font color="red">模板创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color="red">在创建合同重新指定无效</font></li><li>运营商三要素认证方式对手机号运营商及前缀有限制,可以参考<a href="https://qian.tencent.com/developers/company/mobile_support">运营商支持列表类</a>得到具体的支持说明</li><li>校验方式不允许只包含<font color="red">设备指纹识别</font>和<font color="red">设备面容识别</font>，至少需要再增加一种其他校验方式。</li><li><font color="red">设备指纹识别</font>和<font color="red">设备面容识别</font>只支持小程序使用，其他端暂不支持。</li></ol>
         :rtype: list of int
         """
         return self._ApproverSignTypes
@@ -862,16 +674,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def ApproverNeedSignReview(self):
-        r"""此签署人（员工或者个人）签署前，是否需要发起方企业审批，取值如下：
-<ul><li>**false**：（默认）不需要审批，直接签署。</li>
-<li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
-企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
-<ul><li>如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
-<li>如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
-
-注：`此功能可用于与发起方企业内部的审批流程进行关联，支持手动、静默签署合同`
-
-![image](https://qcloudimg.tencent-cloud.cn/raw/b14d5188ed0229d1401e74a9a49cab6d.png)
+        r"""<p>此签署人（员工或者个人）签署前，是否需要发起方企业审批，取值如下：</p><ul><li>**false**：（默认）不需要审批，直接签署。</li><li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果<ul><li>如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li><li>如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul><p>注：<code>此功能可用于与发起方企业内部的审批流程进行关联，支持手动、静默签署合同</code></p><p><img src="https://qcloudimg.tencent-cloud.cn/raw/b14d5188ed0229d1401e74a9a49cab6d.png" alt="image"></p>
         :rtype: bool
         """
         return self._ApproverNeedSignReview
@@ -882,9 +685,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def AddSignComponentsLimits(self):
-        r"""【在用文件发起合同场景下才有效】在调用[用PDF文件创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles)创建合同时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID或者印章类型）或签名方式。
-
-注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
+        r"""<p>【在用文件发起合同场景下才有效】在调用<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles">用PDF文件创建签署流程</a>创建合同时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID或者印章类型）或签名方式。</p><p>注：<code>限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。</code></p>
         :rtype: list of ComponentLimit
         """
         return self._AddSignComponentsLimits
@@ -895,7 +696,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def SignInstructionContent(self):
-        r"""签署须知：支持传入富文本，最长字数：500个中文字符
+        r"""<p>签署须知：支持传入富文本，最长字数：500个中文字符</p>
         :rtype: str
         """
         return self._SignInstructionContent
@@ -906,9 +707,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def Deadline(self):
-        r"""签署人的签署截止时间，格式为Unix标准时间戳（秒）
-
-注: `若不设置此参数，则默认使用合同的截止时间，此参数暂不支持合同组子合同`
+        r"""<p>签署人的签署截止时间，格式为Unix标准时间戳（秒）</p><p>注: <code>若不设置此参数，则默认使用合同的截止时间，此参数暂不支持合同组子合同</code></p>
         :rtype: int
         """
         return self._Deadline
@@ -919,19 +718,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def Components(self):
-        r"""【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】签署人在合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体
-<ul><li>单行文本控件</li>
-<li>多行文本控件</li>
-<li>勾选框控件</li>
-<li>数字控件</li>
-<li>图片控件</li>
-</ul>
-
-具体使用说明可参考[为签署方指定填写控件](https://qian.tencent.cn/developers/company/createFlowByFiles/#指定签署方填写控件)
-
-注：`此参数仅在通过文件发起合同或者合同组时生效`
-
-![image](https://qcloudimg.tencent-cloud.cn/raw/e004195ee4cb98a7f9bc12eb4a0a0b77.png)
+        r"""<p>【在用文件发起合同场景下才有效，模板发起场景下需要在模板中配置】签署人在合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体</p><ul><li>单行文本控件</li><li>多行文本控件</li><li>勾选框控件</li><li>数字控件</li><li>图片控件</li></ul><p>具体使用说明可参考<a href="https://qian.tencent.cn/developers/company/createFlowByFiles/#指定签署方填写控件">为签署方指定填写控件</a></p><p>注：<code>此参数仅在通过文件发起合同或者合同组时生效</code></p><p><img src="https://qcloudimg.tencent-cloud.cn/raw/e004195ee4cb98a7f9bc12eb4a0a0b77.png" alt="image"></p>
         :rtype: list of Component
         """
         return self._Components
@@ -942,8 +729,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def SignEndpoints(self):
-        r"""进入签署流程的限制，目前支持以下选项：
-<ul><li> <b>空值（默认）</b> :无限制，可在任何场景进入签署流程。</li><li> <b>link</b> :选择此选项后，将无法通过控制台或电子签小程序列表进入填写或签署操作，仅可预览合同。填写或签署流程只能通过短信或发起方提供的专用链接进行。</li></ul>
+        r"""<p>进入签署流程的限制，目前支持以下选项：</p><ul><li> <b>空值（默认）</b> :无限制，可在任何场景进入签署流程。</li><li> <b>link</b> :选择此选项后，将无法通过控制台或电子签小程序列表进入填写或签署操作，仅可预览合同。填写或签署流程只能通过短信或发起方提供的专用链接进行。</li></ul>
         :rtype: list of str
         """
         return self._SignEndpoints
@@ -954,8 +740,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def RegisterInfo(self):
-        r"""快速注册相关信息
-
+        r"""<p>快速注册相关信息</p>
         :rtype: :class:`tencentcloud.ess.v20201111.models.RegisterInfo`
         """
         return self._RegisterInfo
@@ -966,13 +751,7 @@ class ApproverInfo(AbstractModel):
 
     @property
     def NotSaveContact(self):
-        r"""是否不保存联系人
-默认 false 保存联系人  true 不保存联系人
-
-设置这个参数为保存联系人的时候,他方企业签署人会被保存进发起人的联系人中。
-联系人查看可登录[电子签控制台](https://test.qian.tencent.cn/console/) 进行查看。
-如下图位置：
-![](https://qcloudimg.tencent-cloud.cn/raw/fb8a22cd615d24c21acfa0e37e2cd873.png)
+        r"""<p>是否不保存联系人<br>默认 false 保存联系人  true 不保存联系人</p><p>设置这个参数为保存联系人的时候,他方企业签署人会被保存进发起人的联系人中。<br>联系人查看可登录<a href="https://test.qian.tencent.cn/console/">电子签控制台</a> 进行查看。<br>如下图位置：<br><img src="https://qcloudimg.tencent-cloud.cn/raw/fb8a22cd615d24c21acfa0e37e2cd873.png" alt=""></p>
         :rtype: bool
         """
         return self._NotSaveContact
@@ -981,6 +760,17 @@ class ApproverInfo(AbstractModel):
     def NotSaveContact(self, NotSaveContact):
         self._NotSaveContact = NotSaveContact
 
+    @property
+    def ApproverEmail(self):
+        r"""<p>客户指定的邮箱信息</p>
+        :rtype: str
+        """
+        return self._ApproverEmail
+
+    @ApproverEmail.setter
+    def ApproverEmail(self, ApproverEmail):
+        self._ApproverEmail = ApproverEmail
+
 
     def _deserialize(self, params):
         self._ApproverType = params.get("ApproverType")
@@ -1028,6 +818,7 @@ class ApproverInfo(AbstractModel):
             self._RegisterInfo = RegisterInfo()
             self._RegisterInfo._deserialize(params.get("RegisterInfo"))
         self._NotSaveContact = params.get("NotSaveContact")
+        self._ApproverEmail = params.get("ApproverEmail")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -12311,23 +12102,26 @@ class CreateFlowRemindsRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 执行本接口操作的员工信息。
-注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        :param _Operator: <p>执行本接口操作的员工信息。<br>注: <code>在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。</code></p>
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _FlowIds: 需执行催办的签署流程ID数组，最多包含100个。
+        :param _FlowIds: <p>需执行催办的签署流程ID数组，最多包含100个。</p>
         :type FlowIds: list of str
-        :param _Agent: 代理企业和员工的信息。
-在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        :param _Agent: <p>代理企业和员工的信息。<br>在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。</p>
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
+        :param _RemindTypes: <p>指定通知方式，枚举值：SMS / EMAIL；为空则按签署人原始 NotifyType 处理</p>
+        :type RemindTypes: list of str
+        :param _RemindEmailInfos: <p>邮箱覆盖列表，为指定签署人使用特定邮箱发送邮件催办</p>
+        :type RemindEmailInfos: list of RemindEmailInfo
         """
         self._Operator = None
         self._FlowIds = None
         self._Agent = None
+        self._RemindTypes = None
+        self._RemindEmailInfos = None
 
     @property
     def Operator(self):
-        r"""执行本接口操作的员工信息。
-注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        r"""<p>执行本接口操作的员工信息。<br>注: <code>在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。</code></p>
         :rtype: :class:`tencentcloud.ess.v20201111.models.UserInfo`
         """
         return self._Operator
@@ -12338,7 +12132,7 @@ class CreateFlowRemindsRequest(AbstractModel):
 
     @property
     def FlowIds(self):
-        r"""需执行催办的签署流程ID数组，最多包含100个。
+        r"""<p>需执行催办的签署流程ID数组，最多包含100个。</p>
         :rtype: list of str
         """
         return self._FlowIds
@@ -12349,8 +12143,7 @@ class CreateFlowRemindsRequest(AbstractModel):
 
     @property
     def Agent(self):
-        r"""代理企业和员工的信息。
-在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        r"""<p>代理企业和员工的信息。<br>在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。</p>
         :rtype: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         return self._Agent
@@ -12359,6 +12152,28 @@ class CreateFlowRemindsRequest(AbstractModel):
     def Agent(self, Agent):
         self._Agent = Agent
 
+    @property
+    def RemindTypes(self):
+        r"""<p>指定通知方式，枚举值：SMS / EMAIL；为空则按签署人原始 NotifyType 处理</p>
+        :rtype: list of str
+        """
+        return self._RemindTypes
+
+    @RemindTypes.setter
+    def RemindTypes(self, RemindTypes):
+        self._RemindTypes = RemindTypes
+
+    @property
+    def RemindEmailInfos(self):
+        r"""<p>邮箱覆盖列表，为指定签署人使用特定邮箱发送邮件催办</p>
+        :rtype: list of RemindEmailInfo
+        """
+        return self._RemindEmailInfos
+
+    @RemindEmailInfos.setter
+    def RemindEmailInfos(self, RemindEmailInfos):
+        self._RemindEmailInfos = RemindEmailInfos
+
 
     def _deserialize(self, params):
         if params.get("Operator") is not None:
@@ -12368,6 +12183,13 @@ class CreateFlowRemindsRequest(AbstractModel):
         if params.get("Agent") is not None:
             self._Agent = Agent()
             self._Agent._deserialize(params.get("Agent"))
+        self._RemindTypes = params.get("RemindTypes")
+        if params.get("RemindEmailInfos") is not None:
+            self._RemindEmailInfos = []
+            for item in params.get("RemindEmailInfos"):
+                obj = RemindEmailInfo()
+                obj._deserialize(item)
+                self._RemindEmailInfos.append(obj)
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -12385,7 +12207,7 @@ class CreateFlowRemindsResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _RemindFlowRecords: 合同催办结果的详细信息列表。
+        :param _RemindFlowRecords: <p>合同催办结果的详细信息列表。</p>
         :type RemindFlowRecords: list of RemindFlowRecords
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -12395,7 +12217,7 @@ class CreateFlowRemindsResponse(AbstractModel):
 
     @property
     def RemindFlowRecords(self):
-        r"""合同催办结果的详细信息列表。
+        r"""<p>合同催办结果的详细信息列表。</p>
         :rtype: list of RemindFlowRecords
         """
         return self._RemindFlowRecords
@@ -42549,6 +42371,57 @@ class RelieveInfo(AbstractModel):
         
 
 
+class RemindEmailInfo(AbstractModel):
+    r"""催办邮件结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _SignId: <p>签署编号</p>
+        :type SignId: str
+        :param _ApproverEmail: <p>指定邮箱地址，催办时使用此邮箱替代 DB 中存储的邮箱</p>
+        :type ApproverEmail: str
+        """
+        self._SignId = None
+        self._ApproverEmail = None
+
+    @property
+    def SignId(self):
+        r"""<p>签署编号</p>
+        :rtype: str
+        """
+        return self._SignId
+
+    @SignId.setter
+    def SignId(self, SignId):
+        self._SignId = SignId
+
+    @property
+    def ApproverEmail(self):
+        r"""<p>指定邮箱地址，催办时使用此邮箱替代 DB 中存储的邮箱</p>
+        :rtype: str
+        """
+        return self._ApproverEmail
+
+    @ApproverEmail.setter
+    def ApproverEmail(self, ApproverEmail):
+        self._ApproverEmail = ApproverEmail
+
+
+    def _deserialize(self, params):
+        self._SignId = params.get("SignId")
+        self._ApproverEmail = params.get("ApproverEmail")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
 class RemindFlowRecords(AbstractModel):
     r"""催办接口返回的详细信息。
 

{tencentcloud_sdk_python_ess-3.1.81 → tencentcloud_sdk_python_ess-3.1.82}/tencentcloud_sdk_python_ess.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-ess
-Version: 3.1.81
+Version: 3.1.82
 Summary: Tencent Cloud Ess SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.81
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.82
 
 ============================
 Tencent Cloud SDK for Python

tencentcloud_sdk_python_ess-3.1.82/tencentcloud_sdk_python_ess.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common<4.0.0,>=3.1.82

tencentcloud_sdk_python_ess-3.1.81/tencentcloud_sdk_python_ess.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common<4.0.0,>=3.1.81