tencentcloud-sdk-python-ess 3.0.1110__tar.gz → 3.0.1116__tar.gz

{tencentcloud-sdk-python-ess-3.0.1110 → tencentcloud-sdk-python-ess-3.0.1116}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-ess
-Version: 3.0.1110
+Version: 3.0.1116
 Summary: Tencent Cloud Ess SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

{tencentcloud-sdk-python-ess-3.0.1110 → tencentcloud-sdk-python-ess-3.0.1116}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-ess',
-    install_requires=["tencentcloud-sdk-python-common==3.0.1110"],
+    install_requires=["tencentcloud-sdk-python-common==3.0.1116"],
     version=tencentcloud.__version__,
     description='Tencent Cloud Ess SDK for Python',
     long_description=open('README.rst').read(),

{tencentcloud-sdk-python-ess-3.0.1110 → tencentcloud-sdk-python-ess-3.0.1116}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1110'
+__version__ = '3.0.1116'

{tencentcloud-sdk-python-ess-3.0.1110 → tencentcloud-sdk-python-ess-3.0.1116}/tencentcloud/ess/v20201111/ess_client.py

@@ -63,7 +63,7 @@ class EssClient(AbstractClient):
         2. 有对应合同撤销权限的人:  <font color='red'>合同的发起人（并已经授予撤销权限）或者发起人所在企业的超管、法人</font>
         ![image](https://qcloudimg.tencent-cloud.cn/raw/1f9f07fea6a70766cd286e0d58682ee2.png)
 
-        3. <font color='red'>撤销合同会返还合同额度</font>
+        3. <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。</font>
 
         4.  撤销后可以看合同PDF内容的人员： 发起方的超管， 发起方自己，发起方撤销合同的操作人员，已经签署合同、已经填写合同、邀请填写已经补充信息的参与人员
 
@@ -147,13 +147,16 @@ class EssClient(AbstractClient):
         - **可撤回合同状态**：未全部签署完成
         - **不撤回合同状态**：已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
 
+        批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)或通过接口[查询批量撤销签署流程任务结果](https://qian.tencent.com/developers/companyApis/operateFlows/CreateBatchCancelFlowUrl)
+
+
         注：
         1. 如果合同流程中的参与方均已签署完毕，则无法通过该接口撤销合同，签署完毕的合同需要双方走解除流程将合同作废，可以参考<a href="https://qian.tencent.com/developers/companyApis/operateFlows/CreateReleaseFlow" target="_blank">发起解除合同流程</a>接口。
 
         2. 有对应合同撤销权限的人:  <font color='red'>合同的发起人（并已经授予撤销权限）或者发起人所在企业的超管、法人</font>
         ![image](https://qcloudimg.tencent-cloud.cn/raw/1f9f07fea6a70766cd286e0d58682ee2.png)
 
-        3. <font color='red'>撤销合同会返还合同额度</font>
+        3. <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。</font>
 
         :param request: Request instance for CreateBatchCancelFlowUrl.
         :type request: :class:`tencentcloud.ess.v20201111.models.CreateBatchCancelFlowUrlRequest`
@@ -515,7 +518,7 @@ class EssClient(AbstractClient):
         ![image](https://qcloudimg.tencent-cloud.cn/raw/f097a74b289e3e1acd740936bdfe9843.png)
 
         注：
-        -  合同**发起后就会扣减合同的额度**, 如果未签署完成时撤销合同会返还此额度（**过期，拒签，签署完成，解除完成等状态不会返还额度**）
+        -  合同**发起后就会扣减合同的额度**, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）
         - **静默（自动）签署不支持合同签署方存在填写**功能
 
         :param request: Request instance for CreateFlowByFiles.
@@ -1472,6 +1475,29 @@ class EssClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeCancelFlowsTask(self, request):
+        """通过[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/companyApis/operateFlows/CreateBatchCancelFlowUrl)发起批量撤销任务后，可通过此接口查询批量撤销任务的结果。
+
+        :param request: Request instance for DescribeCancelFlowsTask.
+        :type request: :class:`tencentcloud.ess.v20201111.models.DescribeCancelFlowsTaskRequest`
+        :rtype: :class:`tencentcloud.ess.v20201111.models.DescribeCancelFlowsTaskResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeCancelFlowsTask", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeCancelFlowsTaskResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeExtendedServiceAuthDetail(self, request):
         """查询企业扩展服务的授权详情（列表），当前支持查询以下内容：
         1. 企业自动签（本企业授权、集团企业授权、合作企业授权）
@@ -2181,9 +2207,9 @@ class EssClient(AbstractClient):
         ![image](https://qcloudimg.tencent-cloud.cn/raw/06f2bc0f1772d8deac2f92b5df61a5ac.png)
 
         注：
-        1.<font color="red">合同发起后就会扣减合同的额度</font>, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度）
+        1.<font color="red">合同发起后就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）
 
-        2.<font color="red">静默（自动）签署不支持合同签署方存在填写</font>功能
+        2.<font color="red">静默（自动）签署不支持非本企业合同签署方存在填写</font>功能
 
         3.<font color="red">在发起签署流程之前，建议等待 [PDF合成完成的回调](https://qian.tencent.com/developers/company/callback_types_file_resources)</font>，尤其是当模板中存在动态表格等复杂填写控件时，因为合成过程可能会耗费秒级别的时间。
 

{tencentcloud-sdk-python-ess-3.0.1110 → tencentcloud-sdk-python-ess-3.0.1116}/tencentcloud/ess/v20201111/models.py

@@ -243,12 +243,16 @@ class ApproverInfo(AbstractModel):
         :type ApproverIdCardType: str
         :param _ApproverIdCardNumber: 签署方经办人的证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</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 才会发送短信
+```
         :type NotifyType: str
         :param _ApproverRole: 收据场景设置签署人角色类型, 可以设置如下****类型****:
 <ul><li> **1**  :收款人</li>
@@ -673,6 +677,8 @@ class ApproverOption(AbstractModel):
 <ul><li> **false** : ( 默认)可以转他人处理</li>
 <li> **true** :不可以转他人处理</li></ul>
         :type NoTransfer: bool
+        :param _CanEditApprover: 允许编辑签署人信息（嵌入式使用） 默认true-可以编辑 false-不可以编辑
+        :type CanEditApprover: bool
         :param _FillType: 签署人信息补充类型，默认无需补充。
 
 <ul><li> **1** : ( 动态签署人（可发起合同后再补充签署人信息）注：`企业自动签不支持动态补充`</li>
@@ -690,6 +696,7 @@ class ApproverOption(AbstractModel):
         """
         self._NoRefuse = None
         self._NoTransfer = None
+        self._CanEditApprover = None
         self._FillType = None
         self._FlowReadLimit = None
 
@@ -709,6 +716,14 @@ class ApproverOption(AbstractModel):
     def NoTransfer(self, NoTransfer):
         self._NoTransfer = NoTransfer
 
+    @property
+    def CanEditApprover(self):
+        return self._CanEditApprover
+
+    @CanEditApprover.setter
+    def CanEditApprover(self, CanEditApprover):
+        self._CanEditApprover = CanEditApprover
+
     @property
     def FillType(self):
         return self._FillType
@@ -729,6 +744,7 @@ class ApproverOption(AbstractModel):
     def _deserialize(self, params):
         self._NoRefuse = params.get("NoRefuse")
         self._NoTransfer = params.get("NoTransfer")
+        self._CanEditApprover = params.get("CanEditApprover")
         self._FillType = params.get("FillType")
         self._FlowReadLimit = params.get("FlowReadLimit")
         memeber_set = set(params.keys())
@@ -1539,6 +1555,51 @@ class Caller(AbstractModel):
         
 
 
+class CancelFailureFlow(AbstractModel):
+    """撤销失败的流程信息
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _FlowId: 合同流程ID，为32位字符串。
+        :type FlowId: str
+        :param _Reason: 撤销失败原因
+        :type Reason: str
+        """
+        self._FlowId = None
+        self._Reason = None
+
+    @property
+    def FlowId(self):
+        return self._FlowId
+
+    @FlowId.setter
+    def FlowId(self, FlowId):
+        self._FlowId = FlowId
+
+    @property
+    def Reason(self):
+        return self._Reason
+
+    @Reason.setter
+    def Reason(self, Reason):
+        self._Reason = Reason
+
+
+    def _deserialize(self, params):
+        self._FlowId = params.get("FlowId")
+        self._Reason = params.get("Reason")
+        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 CancelFlowRequest(AbstractModel):
     """CancelFlow请求参数结构体
 
@@ -2551,12 +2612,15 @@ class CreateBatchCancelFlowUrlResponse(AbstractModel):
 
 例如:2023-07-28 17:25:59
         :type UrlExpireOn: str
+        :param _TaskId: 批量撤销任务编号，为32位字符串，可用于[查询批量撤销签署流程任务结果](https://qian.tencent.com/developers/companyApis/operateFlows/CreateBatchCancelFlowUrl) 或关联[批量撤销任务结果回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E6%89%B9%E9%87%8F%E6%92%A4%E9%94%80%E7%BB%93%E6%9E%9C%E5%9B%9E%E8%B0%83)
+        :type TaskId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
         self._BatchCancelFlowUrl = None
         self._FailMessages = None
         self._UrlExpireOn = None
+        self._TaskId = None
         self._RequestId = None
 
     @property
@@ -2583,6 +2647,14 @@ class CreateBatchCancelFlowUrlResponse(AbstractModel):
     def UrlExpireOn(self, UrlExpireOn):
         self._UrlExpireOn = UrlExpireOn
 
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -2596,6 +2668,7 @@ class CreateBatchCancelFlowUrlResponse(AbstractModel):
         self._BatchCancelFlowUrl = params.get("BatchCancelFlowUrl")
         self._FailMessages = params.get("FailMessages")
         self._UrlExpireOn = params.get("UrlExpireOn")
+        self._TaskId = params.get("TaskId")
         self._RequestId = params.get("RequestId")
 
 
@@ -2833,7 +2906,7 @@ class CreateBatchSignUrlRequest(AbstractModel):
         :type IdCardType: str
         :param _IdCardNumber: 证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。</li>
 <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
 
 注：`请确保和合同中填入的一致`
@@ -3724,16 +3797,16 @@ class CreateFlowApproversRequest(AbstractModel):
         :param _Operator: 执行本接口操作的员工信息。
 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _FlowId: 合同流程ID，为32位字符串。
-建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
-可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
-        :type FlowId: str
         :param _Approvers: 补充企业签署人信息。
 
 - 如果发起方指定的补充签署人是企业微信签署人（ApproverSource=WEWORKAPP），则需要提供企业微信UserId进行补充；
 
 - 如果不指定，则使用姓名和手机号进行补充。
         :type Approvers: list of FillApproverInfo
+        :param _FlowId: 合同流程ID，为32位字符串。
+建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
+        :type FlowId: str
         :param _FillApproverType: 签署人信息补充方式
 
 <ul><li>**0**: 添加或签人候选人，或签支持一个节点传多个签署人，不传值默认或签。
@@ -3745,13 +3818,16 @@ class CreateFlowApproversRequest(AbstractModel):
         :param _Agent: 代理企业和员工的信息。
 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
+        :param _FlowGroupId: 合同流程组的组ID, 在合同流程组场景下，生成合同流程组的签署链接时需要赋值
+        :type FlowGroupId: str
         """
         self._Operator = None
-        self._FlowId = None
         self._Approvers = None
+        self._FlowId = None
         self._FillApproverType = None
         self._Initiator = None
         self._Agent = None
+        self._FlowGroupId = None
 
     @property
     def Operator(self):
@@ -3761,14 +3837,6 @@ class CreateFlowApproversRequest(AbstractModel):
     def Operator(self, Operator):
         self._Operator = Operator
 
-    @property
-    def FlowId(self):
-        return self._FlowId
-
-    @FlowId.setter
-    def FlowId(self, FlowId):
-        self._FlowId = FlowId
-
     @property
     def Approvers(self):
         return self._Approvers
@@ -3777,6 +3845,14 @@ class CreateFlowApproversRequest(AbstractModel):
     def Approvers(self, Approvers):
         self._Approvers = Approvers
 
+    @property
+    def FlowId(self):
+        return self._FlowId
+
+    @FlowId.setter
+    def FlowId(self, FlowId):
+        self._FlowId = FlowId
+
     @property
     def FillApproverType(self):
         return self._FillApproverType
@@ -3801,23 +3877,32 @@ class CreateFlowApproversRequest(AbstractModel):
     def Agent(self, Agent):
         self._Agent = Agent
 
+    @property
+    def FlowGroupId(self):
+        return self._FlowGroupId
+
+    @FlowGroupId.setter
+    def FlowGroupId(self, FlowGroupId):
+        self._FlowGroupId = FlowGroupId
+
 
     def _deserialize(self, params):
         if params.get("Operator") is not None:
             self._Operator = UserInfo()
             self._Operator._deserialize(params.get("Operator"))
-        self._FlowId = params.get("FlowId")
         if params.get("Approvers") is not None:
             self._Approvers = []
             for item in params.get("Approvers"):
                 obj = FillApproverInfo()
                 obj._deserialize(item)
                 self._Approvers.append(obj)
+        self._FlowId = params.get("FlowId")
         self._FillApproverType = params.get("FillApproverType")
         self._Initiator = params.get("Initiator")
         if params.get("Agent") is not None:
             self._Agent = Agent()
             self._Agent._deserialize(params.get("Agent"))
+        self._FlowGroupId = params.get("FlowGroupId")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -4565,11 +4650,14 @@ class CreateFlowGroupByFilesResponse(AbstractModel):
         :param _FlowIds: 合同(流程)组中子合同列表.
 注意：此字段可能返回 null，表示取不到有效值。
         :type FlowIds: list of str
+        :param _Approvers: 合同组签署方信息。
+        :type Approvers: list of FlowGroupApprovers
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
         self._FlowGroupId = None
         self._FlowIds = None
+        self._Approvers = None
         self._RequestId = None
 
     @property
@@ -4588,6 +4676,14 @@ class CreateFlowGroupByFilesResponse(AbstractModel):
     def FlowIds(self, FlowIds):
         self._FlowIds = FlowIds
 
+    @property
+    def Approvers(self):
+        return self._Approvers
+
+    @Approvers.setter
+    def Approvers(self, Approvers):
+        self._Approvers = Approvers
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -4600,6 +4696,12 @@ class CreateFlowGroupByFilesResponse(AbstractModel):
     def _deserialize(self, params):
         self._FlowGroupId = params.get("FlowGroupId")
         self._FlowIds = params.get("FlowIds")
+        if params.get("Approvers") is not None:
+            self._Approvers = []
+            for item in params.get("Approvers"):
+                obj = FlowGroupApprovers()
+                obj._deserialize(item)
+                self._Approvers.append(obj)
         self._RequestId = params.get("RequestId")
 
 
@@ -4715,11 +4817,14 @@ class CreateFlowGroupByTemplatesResponse(AbstractModel):
         :param _FlowIds: 合同(流程)组中子合同列表.
 注意：此字段可能返回 null，表示取不到有效值。
         :type FlowIds: list of str
+        :param _Approvers: 合同组签署人信息。
+        :type Approvers: list of FlowGroupApprovers
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
         self._FlowGroupId = None
         self._FlowIds = None
+        self._Approvers = None
         self._RequestId = None
 
     @property
@@ -4738,6 +4843,14 @@ class CreateFlowGroupByTemplatesResponse(AbstractModel):
     def FlowIds(self, FlowIds):
         self._FlowIds = FlowIds
 
+    @property
+    def Approvers(self):
+        return self._Approvers
+
+    @Approvers.setter
+    def Approvers(self, Approvers):
+        self._Approvers = Approvers
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -4750,6 +4863,12 @@ class CreateFlowGroupByTemplatesResponse(AbstractModel):
     def _deserialize(self, params):
         self._FlowGroupId = params.get("FlowGroupId")
         self._FlowIds = params.get("FlowIds")
+        if params.get("Approvers") is not None:
+            self._Approvers = []
+            for item in params.get("Approvers"):
+                obj = FlowGroupApprovers()
+                obj._deserialize(item)
+                self._Approvers.append(obj)
         self._RequestId = params.get("RequestId")
 
 
@@ -4942,6 +5061,70 @@ class CreateFlowOption(AbstractModel):
         :param _CustomCreateFlowDescription: 定制化发起合同弹窗的描述信息，描述信息最长500字符
 
         :type CustomCreateFlowDescription: str
+        :param _ForbidAddApprover:   禁止添加签署方，若为true则在发起流程的可嵌入页面隐藏“添加签署人按钮”
+
+        :type ForbidAddApprover: str
+        :param _ForbidEditFlowProperties:   禁止设置设置签署流程属性 (顺序、合同签署认证方式等)，若为true则在发起流程的可嵌入页面隐藏签署流程设置面板
+
+        :type ForbidEditFlowProperties: str
+        :param _HideComponentTypes: 在发起流程的可嵌入页面要隐藏的控件列表，和 ShowComponentTypes 参数 只能二选一使用，具体的控件类型如下
+<ul><li>SIGN_SIGNATURE : 个人签名/印章</li>
+<li>SIGN_SEAL : 企业印章</li>
+<li>SIGN_PAGING_SEAL : 骑缝章</li>
+<li>SIGN_LEGAL_PERSON_SEAL : 法定代表人章</li>
+<li>SIGN_APPROVE : 签批</li>
+<li>SIGN_OPINION : 签署意见</li>
+<li>BUSI-FULL-NAME  : 企业全称</li>
+<li>BUSI-CREDIT-CODE : 统一社会信用代码</li>
+<li>BUSI-LEGAL-NAME : 法人/经营者姓名</li>
+<li>PERSONAL-NAME : 签署人姓名</li>
+<li>PERSONAL-MOBILE : 签署人手机号</li>
+<li>PERSONAL-IDCARD-TYPE : 签署人证件类型</li>
+<li>PERSONAL-IDCARD : 签署人证件号</li>
+<li>TEXT : 单行文本</li>
+<li>MULTI_LINE_TEXT : 多行文本</li>
+<li>CHECK_BOX : 勾选框</li>
+<li>SELECTOR : 选择器</li>
+<li>DIGIT : 数字</li>
+<li>DATE : 日期</li>
+<li>FILL_IMAGE : 图片</li>
+<li>ATTACHMENT : 附件</li>
+<li>EMAIL : 邮箱</li>
+<li>LOCATION : 地址</li>
+<li>EDUCATION : 学历</li>
+<li>GENDER : 性别</li>
+<li>DISTRICT : 省市区</li></ul>
+        :type HideComponentTypes: list of str
+        :param _ShowComponentTypes: 在发起流程的可嵌入页面要显示的控件列表，和 HideComponentTypes 参数 只能二选一使用，具体的控件类型如下
+<ul><li>SIGN_SIGNATURE : 个人签名/印章</li>
+<li>SIGN_SEAL : 企业印章</li>
+<li>SIGN_PAGING_SEAL : 骑缝章</li>
+<li>SIGN_LEGAL_PERSON_SEAL : 法定代表人章</li>
+<li>SIGN_APPROVE : 签批</li>
+<li>SIGN_OPINION : 签署意见</li>
+<li>BUSI-FULL-NAME  : 企业全称</li>
+<li>BUSI-CREDIT-CODE : 统一社会信用代码</li>
+<li>BUSI-LEGAL-NAME : 法人/经营者姓名</li>
+<li>PERSONAL-NAME : 签署人姓名</li>
+<li>PERSONAL-MOBILE : 签署人手机号</li>
+<li>PERSONAL-IDCARD-TYPE : 签署人证件类型</li>
+<li>PERSONAL-IDCARD : 签署人证件号</li>
+<li>TEXT : 单行文本</li>
+<li>MULTI_LINE_TEXT : 多行文本</li>
+<li>CHECK_BOX : 勾选框</li>
+<li>SELECTOR : 选择器</li>
+<li>DIGIT : 数字</li>
+<li>DATE : 日期</li>
+<li>FILL_IMAGE : 图片</li>
+<li>ATTACHMENT : 附件</li>
+<li>EMAIL : 邮箱</li>
+<li>LOCATION : 地址</li>
+<li>EDUCATION : 学历</li>
+<li>GENDER : 性别</li>
+<li>DISTRICT : 省市区</li></ul>
+        :type ShowComponentTypes: list of str
+        :param _ResultPageConfig: 发起流程的可嵌入页面结果页配置
+        :type ResultPageConfig: list of CreateResultPageConfig
         """
         self._CanEditFlow = None
         self._CanEditFormField = None
@@ -4952,6 +5135,11 @@ class CreateFlowOption(AbstractModel):
         self._SkipUploadFile = None
         self._ForbidEditFillComponent = None
         self._CustomCreateFlowDescription = None
+        self._ForbidAddApprover = None
+        self._ForbidEditFlowProperties = None
+        self._HideComponentTypes = None
+        self._ShowComponentTypes = None
+        self._ResultPageConfig = None
 
     @property
     def CanEditFlow(self):
@@ -5025,6 +5213,46 @@ class CreateFlowOption(AbstractModel):
     def CustomCreateFlowDescription(self, CustomCreateFlowDescription):
         self._CustomCreateFlowDescription = CustomCreateFlowDescription
 
+    @property
+    def ForbidAddApprover(self):
+        return self._ForbidAddApprover
+
+    @ForbidAddApprover.setter
+    def ForbidAddApprover(self, ForbidAddApprover):
+        self._ForbidAddApprover = ForbidAddApprover
+
+    @property
+    def ForbidEditFlowProperties(self):
+        return self._ForbidEditFlowProperties
+
+    @ForbidEditFlowProperties.setter
+    def ForbidEditFlowProperties(self, ForbidEditFlowProperties):
+        self._ForbidEditFlowProperties = ForbidEditFlowProperties
+
+    @property
+    def HideComponentTypes(self):
+        return self._HideComponentTypes
+
+    @HideComponentTypes.setter
+    def HideComponentTypes(self, HideComponentTypes):
+        self._HideComponentTypes = HideComponentTypes
+
+    @property
+    def ShowComponentTypes(self):
+        return self._ShowComponentTypes
+
+    @ShowComponentTypes.setter
+    def ShowComponentTypes(self, ShowComponentTypes):
+        self._ShowComponentTypes = ShowComponentTypes
+
+    @property
+    def ResultPageConfig(self):
+        return self._ResultPageConfig
+
+    @ResultPageConfig.setter
+    def ResultPageConfig(self, ResultPageConfig):
+        self._ResultPageConfig = ResultPageConfig
+
 
     def _deserialize(self, params):
         self._CanEditFlow = params.get("CanEditFlow")
@@ -5036,6 +5264,16 @@ class CreateFlowOption(AbstractModel):
         self._SkipUploadFile = params.get("SkipUploadFile")
         self._ForbidEditFillComponent = params.get("ForbidEditFillComponent")
         self._CustomCreateFlowDescription = params.get("CustomCreateFlowDescription")
+        self._ForbidAddApprover = params.get("ForbidAddApprover")
+        self._ForbidEditFlowProperties = params.get("ForbidEditFlowProperties")
+        self._HideComponentTypes = params.get("HideComponentTypes")
+        self._ShowComponentTypes = params.get("ShowComponentTypes")
+        if params.get("ResultPageConfig") is not None:
+            self._ResultPageConfig = []
+            for item in params.get("ResultPageConfig"):
+                obj = CreateResultPageConfig()
+                obj._deserialize(item)
+                self._ResultPageConfig.append(obj)
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -5985,22 +6223,24 @@ class CreateIntegrationEmployeesRequest(AbstractModel):
         :param _Agent: 代理企业和员工的信息。
 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
-        :param _InvitationNotifyType: 员工邀请方式可通过以下方式进行设置：
-
-**H5**：会生成H5的链接，点击链接进入H5的认证加入企业的逻辑。
-**SMS（默认）**：会通过短信或企业微信消息进行邀请。如果非企业微信场景，则是企业微信消息。其他场景则是短信通知，短信中包含链接，点击后进入微信小程序进行认证加入企业的逻辑。
+        :param _InvitationNotifyType: 员工邀请方式
+可通过以下途径进行设置：
+<ul><li>**SMS（默认）**：邀请将通过短信或企业微信消息发送。若场景非企业微信，则采用企业微信消息；其他情境下则使用短信通知。短信内含链接，点击后将进入微信小程序进行认证并加入企业的流程。</li><li>**H5**：将生成H5链接，用户点击链接后可进入H5页面进行认证并加入企业的流程。</li><li>**NONE**：系统会根据Endpoint生成签署链接，业务方需获取链接并通知客户。</li></ul>
         :type InvitationNotifyType: str
         :param _JumpUrl: 回跳地址，为认证成功后页面进行回跳的URL，请确保回跳地址的可用性。
 
 注：`只有在员工邀请方式（InvitationNotifyType参数）为H5场景下才生效， 其他方式下设置无效。`
 
         :type JumpUrl: str
+        :param _Endpoint: 要跳转的链接类型<ul><li> **HTTP**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型  ，此时返回长链 (默认类型)</li><li>**HTTP_SHORT_URL**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型，此时返回短链</li><li>**APP**： 第三方APP或小程序跳转电子签小程序的path,  APP或者小程序跳转适合此类型</li><li>**H5**： 第三方移动端浏览器进行嵌入，不支持小程序嵌入，过期时间一个月</li></ul>注意：InvitationNotifyType 和 Endpoint 的关系图<table><tbody><tr><td>通知类型（InvitationNotifyType）</td><td>Endpoint</td></tr><tr><td>SMS（默认）</td><td>不需要传递，会将 Endpoint 默认设置为HTTP_SHORT_URL</td></tr><tr><td>H5</td><td>不需要传递，会将 Endpoint 默认设置为 H5</td></tr><tr><td>NONE</td><td>所有 Endpoint 都支持（HTTP_URL/HTTP_SHORT_URL/H5/APP）默认为HTTP_SHORT_URL</td></tr></tbody></table>
+        :type Endpoint: str
         """
         self._Operator = None
         self._Employees = None
         self._Agent = None
         self._InvitationNotifyType = None
         self._JumpUrl = None
+        self._Endpoint = None
 
     @property
     def Operator(self):
@@ -6042,6 +6282,14 @@ class CreateIntegrationEmployeesRequest(AbstractModel):
     def JumpUrl(self, JumpUrl):
         self._JumpUrl = JumpUrl
 
+    @property
+    def Endpoint(self):
+        return self._Endpoint
+
+    @Endpoint.setter
+    def Endpoint(self, Endpoint):
+        self._Endpoint = Endpoint
+
 
     def _deserialize(self, params):
         if params.get("Operator") is not None:
@@ -6058,6 +6306,7 @@ class CreateIntegrationEmployeesRequest(AbstractModel):
             self._Agent._deserialize(params.get("Agent"))
         self._InvitationNotifyType = params.get("InvitationNotifyType")
         self._JumpUrl = params.get("JumpUrl")
+        self._Endpoint = params.get("Endpoint")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -6924,7 +7173,7 @@ class CreatePersonAuthCertificateImageRequest(AbstractModel):
         :type IdCardType: str
         :param _IdCardNumber: 证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。</li>
 <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type IdCardNumber: str
         :param _Agent: 代理企业和员工的信息。
@@ -7477,7 +7726,7 @@ class CreatePreparedPersonalEsignRequest(AbstractModel):
         :type UserName: str
         :param _IdCardNumber: 证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。。</li>
 <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type IdCardNumber: str
         :param _SealName: 印章名称，长度1-50个字。
@@ -7905,6 +8154,65 @@ class CreateReleaseFlowResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class CreateResultPageConfig(AbstractModel):
+    """发起流程的可嵌入页面操作结果页配置
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Type: <ul>
+  <li>0 : 发起审批成功页面（通过接口<a href="https://qian.tencent.com/developers/companyApis/embedPages/CreatePrepareFlow/" target="_blank">创建发起流程web页面</a>发起时设置了NeedCreateReview参数为true）</li>
+</ul>
+        :type Type: int
+        :param _Title: 结果页标题，不超过50字
+        :type Title: str
+        :param _Description: 结果页描述，不超过200字
+        :type Description: str
+        """
+        self._Type = None
+        self._Title = None
+        self._Description = None
+
+    @property
+    def Type(self):
+        return self._Type
+
+    @Type.setter
+    def Type(self, Type):
+        self._Type = Type
+
+    @property
+    def Title(self):
+        return self._Title
+
+    @Title.setter
+    def Title(self, Title):
+        self._Title = Title
+
+    @property
+    def Description(self):
+        return self._Description
+
+    @Description.setter
+    def Description(self, Description):
+        self._Description = Description
+
+
+    def _deserialize(self, params):
+        self._Type = params.get("Type")
+        self._Title = params.get("Title")
+        self._Description = params.get("Description")
+        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 CreateSchemeUrlRequest(AbstractModel):
     """CreateSchemeUrl请求参数结构体
 
@@ -7930,7 +8238,7 @@ class CreateSchemeUrlRequest(AbstractModel):
         :type IdCardType: str
         :param _IdCardNumber: 证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成(如存在X，请大写)。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母(但“I”、“O”除外)，后7位为阿拉伯数字。</li>
+<li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。</li>
 <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type IdCardNumber: str
         :param _EndPoint: 要跳转的链接类型
@@ -7974,6 +8282,8 @@ class CreateSchemeUrlRequest(AbstractModel):
 
 注：`生成动态签署人补充链接时必传。`
         :type RecipientId: str
+        :param _FlowGroupUrlInfo: 合同组相关信息，指定合同组子合同和签署方的信息，用于补充动态签署人。
+        :type FlowGroupUrlInfo: :class:`tencentcloud.ess.v20201111.models.FlowGroupUrlInfo`
         """
         self._Operator = None
         self._OrganizationName = None
@@ -7989,6 +8299,7 @@ class CreateSchemeUrlRequest(AbstractModel):
         self._Agent = None
         self._Hides = None
         self._RecipientId = None
+        self._FlowGroupUrlInfo = None
 
     @property
     def Operator(self):
@@ -8102,6 +8413,14 @@ class CreateSchemeUrlRequest(AbstractModel):
     def RecipientId(self, RecipientId):
         self._RecipientId = RecipientId
 
+    @property
+    def FlowGroupUrlInfo(self):
+        return self._FlowGroupUrlInfo
+
+    @FlowGroupUrlInfo.setter
+    def FlowGroupUrlInfo(self, FlowGroupUrlInfo):
+        self._FlowGroupUrlInfo = FlowGroupUrlInfo
+
 
     def _deserialize(self, params):
         if params.get("Operator") is not None:
@@ -8122,6 +8441,9 @@ class CreateSchemeUrlRequest(AbstractModel):
             self._Agent._deserialize(params.get("Agent"))
         self._Hides = params.get("Hides")
         self._RecipientId = params.get("RecipientId")
+        if params.get("FlowGroupUrlInfo") is not None:
+            self._FlowGroupUrlInfo = FlowGroupUrlInfo()
+            self._FlowGroupUrlInfo._deserialize(params.get("FlowGroupUrlInfo"))
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -10036,6 +10358,150 @@ class DescribeBillUsageDetailResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class DescribeCancelFlowsTaskRequest(AbstractModel):
+    """DescribeCancelFlowsTask请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Operator: 执行本接口操作的员工信息。
+<br/>注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
+        :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
+        :param _TaskId: 批量撤销任务编号，为32位字符串，通过接口[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/companyApis/operateFlows/CreateBatchCancelFlowUrl)获得。
+        :type TaskId: str
+        :param _Agent: 代理企业和员工的信息。
+<br/>在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
+        """
+        self._Operator = None
+        self._TaskId = None
+        self._Agent = None
+
+    @property
+    def Operator(self):
+        return self._Operator
+
+    @Operator.setter
+    def Operator(self, Operator):
+        self._Operator = Operator
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
+
+    def _deserialize(self, params):
+        if params.get("Operator") is not None:
+            self._Operator = UserInfo()
+            self._Operator._deserialize(params.get("Operator"))
+        self._TaskId = params.get("TaskId")
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
+        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 DescribeCancelFlowsTaskResponse(AbstractModel):
+    """DescribeCancelFlowsTask返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _TaskId: 批量撤销任务编号，为32位字符串，通过接口[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/companyApis/operateFlows/CreateBatchCancelFlowUrl)获得。
+        :type TaskId: str
+        :param _TaskStatus: 任务状态，需要关注的状态
+<ul><li>**PROCESSING**  - 任务执行中</li>
+<li>**END** - 任务处理完成</li>
+<li>**TIMEOUT** 任务超时未处理完成，用户未在批量撤销链接有效期内操作</li></ul>
+        :type TaskStatus: str
+        :param _SuccessFlowIds: 批量撤销成功的签署流程编号
+        :type SuccessFlowIds: list of str
+        :param _FailureFlows: 批量撤销失败的签署流程信息
+        :type FailureFlows: list of CancelFailureFlow
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._TaskId = None
+        self._TaskStatus = None
+        self._SuccessFlowIds = None
+        self._FailureFlows = None
+        self._RequestId = None
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+    @property
+    def TaskStatus(self):
+        return self._TaskStatus
+
+    @TaskStatus.setter
+    def TaskStatus(self, TaskStatus):
+        self._TaskStatus = TaskStatus
+
+    @property
+    def SuccessFlowIds(self):
+        return self._SuccessFlowIds
+
+    @SuccessFlowIds.setter
+    def SuccessFlowIds(self, SuccessFlowIds):
+        self._SuccessFlowIds = SuccessFlowIds
+
+    @property
+    def FailureFlows(self):
+        return self._FailureFlows
+
+    @FailureFlows.setter
+    def FailureFlows(self, FailureFlows):
+        self._FailureFlows = FailureFlows
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._TaskId = params.get("TaskId")
+        self._TaskStatus = params.get("TaskStatus")
+        self._SuccessFlowIds = params.get("SuccessFlowIds")
+        if params.get("FailureFlows") is not None:
+            self._FailureFlows = []
+            for item in params.get("FailureFlows"):
+                obj = CancelFailureFlow()
+                obj._deserialize(item)
+                self._FailureFlows.append(obj)
+        self._RequestId = params.get("RequestId")
+
+
 class DescribeExtendedServiceAuthDetailRequest(AbstractModel):
     """DescribeExtendedServiceAuthDetail请求参数结构体
 
@@ -13437,11 +13903,13 @@ WEWORKAPP: 企业微信
         :type ApproverIdCardType: str
         :param _ApproverIdCardNumber: 签署方经办人的证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。。</li>
 <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
 
 注：`补充个人签署方时，若该用户已在电子签完成实名则可通过指定姓名和证件类型、证件号码完成补充。`
         :type ApproverIdCardNumber: str
+        :param _FlowId: 合同流程ID，补充合同组子合同动态签署人时必传。
+        :type FlowId: str
         """
         self._RecipientId = None
         self._ApproverSource = None
@@ -13451,6 +13919,7 @@ WEWORKAPP: 企业微信
         self._OrganizationName = None
         self._ApproverIdCardType = None
         self._ApproverIdCardNumber = None
+        self._FlowId = None
 
     @property
     def RecipientId(self):
@@ -13516,6 +13985,14 @@ WEWORKAPP: 企业微信
     def ApproverIdCardNumber(self, ApproverIdCardNumber):
         self._ApproverIdCardNumber = ApproverIdCardNumber
 
+    @property
+    def FlowId(self):
+        return self._FlowId
+
+    @FlowId.setter
+    def FlowId(self, FlowId):
+        self._FlowId = FlowId
+
 
     def _deserialize(self, params):
         self._RecipientId = params.get("RecipientId")
@@ -13526,6 +14003,7 @@ WEWORKAPP: 企业微信
         self._OrganizationName = params.get("OrganizationName")
         self._ApproverIdCardType = params.get("ApproverIdCardType")
         self._ApproverIdCardNumber = params.get("ApproverIdCardNumber")
+        self._FlowId = params.get("FlowId")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -14228,7 +14706,7 @@ class FlowCreateApprover(AbstractModel):
         :type ApproverIdCardType: str
         :param _ApproverIdCardNumber: 证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。</li>
 <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type ApproverIdCardNumber: str
         :param _RecipientId: 签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。
@@ -14818,6 +15296,103 @@ class FlowDetailInfo(AbstractModel):
         
 
 
+class FlowGroupApproverInfo(AbstractModel):
+    """合同组相关信息，指定合同组子合同和签署方的信息，用于补充动态签署人。
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _FlowId: 合同流程ID。
+        :type FlowId: str
+        :param _RecipientId: 签署节点ID，用于生成动态签署人链接完成领取。注：`生成动态签署人补充链接时必传。`
+        :type RecipientId: str
+        """
+        self._FlowId = None
+        self._RecipientId = None
+
+    @property
+    def FlowId(self):
+        return self._FlowId
+
+    @FlowId.setter
+    def FlowId(self, FlowId):
+        self._FlowId = FlowId
+
+    @property
+    def RecipientId(self):
+        return self._RecipientId
+
+    @RecipientId.setter
+    def RecipientId(self, RecipientId):
+        self._RecipientId = RecipientId
+
+
+    def _deserialize(self, params):
+        self._FlowId = params.get("FlowId")
+        self._RecipientId = params.get("RecipientId")
+        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 FlowGroupApprovers(AbstractModel):
+    """合同组签署方信息
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _FlowId: 合同流程ID 
+注意：此字段可能返回 null，表示取不到有效值。
+        :type FlowId: str
+        :param _Approvers: 签署方信息，包含合同ID和角色ID用于定位RecipientId。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type Approvers: list of ApproverItem
+        """
+        self._FlowId = None
+        self._Approvers = None
+
+    @property
+    def FlowId(self):
+        return self._FlowId
+
+    @FlowId.setter
+    def FlowId(self, FlowId):
+        self._FlowId = FlowId
+
+    @property
+    def Approvers(self):
+        return self._Approvers
+
+    @Approvers.setter
+    def Approvers(self, Approvers):
+        self._Approvers = Approvers
+
+
+    def _deserialize(self, params):
+        self._FlowId = params.get("FlowId")
+        if params.get("Approvers") is not None:
+            self._Approvers = []
+            for item in params.get("Approvers"):
+                obj = ApproverItem()
+                obj._deserialize(item)
+                self._Approvers.append(obj)
+        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 FlowGroupInfo(AbstractModel):
     """此结构体(FlowGroupInfo)描述的是合同组(流程组)的单个合同(流程)信息
 
@@ -15099,6 +15674,44 @@ class FlowGroupOptions(AbstractModel):
         
 
 
+class FlowGroupUrlInfo(AbstractModel):
+    """合同组相关信息，指定合同组子合同和签署方的信息，用于补充动态签署人。
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _FlowGroupApproverInfos: 合同组子合同和签署方的信息，用于补充动态签署人。
+        :type FlowGroupApproverInfos: list of FlowGroupApproverInfo
+        """
+        self._FlowGroupApproverInfos = None
+
+    @property
+    def FlowGroupApproverInfos(self):
+        return self._FlowGroupApproverInfos
+
+    @FlowGroupApproverInfos.setter
+    def FlowGroupApproverInfos(self, FlowGroupApproverInfos):
+        self._FlowGroupApproverInfos = FlowGroupApproverInfos
+
+
+    def _deserialize(self, params):
+        if params.get("FlowGroupApproverInfos") is not None:
+            self._FlowGroupApproverInfos = []
+            for item in params.get("FlowGroupApproverInfos"):
+                obj = FlowGroupApproverInfo()
+                obj._deserialize(item)
+                self._FlowGroupApproverInfos.append(obj)
+        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 FormField(AbstractModel):
     """电子文档的控件填充信息。按照控件类型进行相应的填充。
 
@@ -16157,8 +16770,12 @@ class Intention(AbstractModel):
 注: `视频认证为白名单功能，使用前请联系对接的客户经理沟通。`
         :type IntentionType: int
         :param _IntentionQuestions: 意愿核身语音问答模式（即语音播报+语音回答）使用的文案，包括：系统语音播报的文本、需要核验的标准文本。当前仅支持1轮问答。
+
+注：`选择问答模式时，此字段可不传，不传则使用默认语音文本：请问，您是否同意签署本协议？可语音回复“同意”或“不同意”。`
         :type IntentionQuestions: list of IntentionQuestion
         :param _IntentionActions: 意愿核身（点头确认模式）使用的文案，若未使用意愿核身（点头确认模式），则该字段无需传入。当前仅支持一个提示文本。
+
+注：`选择点头模式时，此字段可不传，不传则使用默认语音文本：请问，您是否同意签署本协议？可点头同意。`
         :type IntentionActions: list of IntentionAction
         """
         self._IntentionType = None
@@ -17109,7 +17726,7 @@ class NeedReviewApproverInfo(AbstractModel):
         :type ApproverIdCardType: str
         :param _ApproverIdCardNumber: 签署方经办人的证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。</li>
 <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type ApproverIdCardNumber: str
         :param _OrganizationName: 组织机构名称。
@@ -19231,8 +19848,8 @@ class StartFlowResponse(AbstractModel):
 
 
 class SuccessCreateStaffData(AbstractModel):
-    """创建员工成功返回的信息
-    支持saas/企微/H5端进行加入。
+    """创建/修改员工成功返回的信息
+    现在支持saas/企微/H5端进行加入。
 
     """
 
@@ -19249,9 +19866,7 @@ class SuccessCreateStaffData(AbstractModel):
         :type Note: str
         :param _WeworkOpenId: 传入的企微账号id
         :type WeworkOpenId: str
-        :param _Url: H5端员工加入\实名链接
-
-只有入参 InvitationNotifyType = H5的时候才会进行返回。
+        :param _Url: 员工邀请返回链接 根据入参的 InvitationNotifyType 和 Endpoint 返回链接 <table><tbody><tr><td>链接类型</td><td>有效期</td><td>示例</td></tr><tr><td>HTTP_SHORT_URL（短链）</td><td>一天</td><td>https://test.essurl.cn/fvG7UBEd0F</td></tr><tr><td>HTTP（长链）</td><td>一天</td><td>https://res.ess.tencent.cn/cdn/h5-activity-dev/jump-mp.html?where=mini&from=MSG&to=USER_VERIFY&verifyToken=yDCVbUUckpwocmfpUySko7IS83LTV0u0&expireTime=1710840183</td></tr><tr><td>H5</td><td>30 天</td><td>https://quick.test.qian.tencent.cn/guide?Code=yDCVbUUckpwtvxqoUbTw4VBBjLbfAtW7&CodeType=QUICK&shortKey=yDCVbUY7lhqV7mZlCL2d</td></tr><tr><td>APP</td><td>一天</td><td>/pages/guide/index?to=USER_VERIFY&verifyToken=yDCVbUUckpwocm96UySko7ISvEIZH7Yz&expireTime=1710840455 </td></tr></tbody></table>
         :type Url: str
         """
         self._DisplayName = None
@@ -20006,21 +20621,19 @@ class UpdateIntegrationEmployeesRequest(AbstractModel):
         :param _Agent: 代理企业和员工的信息。
 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
-        :param _InvitationNotifyType: 员工邀请方式可通过以下方式进行设置：
-
-**H5**：会生成H5的链接，点击链接进入H5的认证加入企业的逻辑。
-**SMS（默认）**：会通过短信或企业微信消息进行邀请。如果非企业微信场景，则是企业微信消息。其他场景则是短信通知，短信中包含链接，点击后进入微信小程序进行认证加入企业的逻辑。
+        :param _InvitationNotifyType: 员工邀请方式可通过以下途径进行设置：<ul><li>**SMS（默认）**：邀请将通过短信或企业微信消息发送。若场景非企业微信，则采用企业微信消息；其他情境下则使用短信通知。短信内含链接，点击后将进入微信小程序进行认证并加入企业的流程。</li><li>**H5**：将生成H5链接，用户点击链接后可进入H5页面进行认证并加入企业的流程。</li><li>**NONE**：系统会根据Endpoint生成签署链接，业务方需获取链接并通知客户。</li></ul>
         :type InvitationNotifyType: str
-        :param _JumpUrl: 回跳地址，为认证成功后页面进行回跳的URL，请确保回跳地址的可用性。
-
-注：`只有在员工邀请方式（InvitationNotifyType参数）为H5场景下才生效， 其他方式下设置无效。`
+        :param _JumpUrl: 回跳地址，为认证成功后页面进行回跳的URL，请确保回跳地址的可用性。注：`只有在员工邀请方式（InvitationNotifyType参数）为H5场景下才生效， 其他方式下设置无效。`
         :type JumpUrl: str
+        :param _Endpoint: 要跳转的链接类型<ul><li> **HTTP**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型  ，此时返回长链 (默认类型)</li><li>**HTTP_SHORT_URL**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型，此时返回短链</li><li>**APP**： 第三方APP或小程序跳转电子签小程序的path,  APP或者小程序跳转适合此类型</li><li>**H5**： 第三方移动端浏览器进行嵌入，不支持小程序嵌入，过期时间一个月</li></ul>注意：InvitationNotifyType 和 Endpoint 的关系图<table><tbody><tr><td>通知类型（InvitationNotifyType）</td><td>Endpoint</td></tr><tr><td>SMS（默认）</td><td>不需要传递，会将 Endpoint 默认设置为HTTP_SHORT_URL</td></tr><tr><td>H5</td><td>不需要传递，会将 Endpoint 默认设置为 H5</td></tr><tr><td>NONE</td><td>所有 Endpoint 都支持（HTTP_URL/HTTP_SHORT_URL/H5/APP）默认为HTTP_SHORT_URL</td></tr></tbody></table>
+        :type Endpoint: str
         """
         self._Operator = None
         self._Employees = None
         self._Agent = None
         self._InvitationNotifyType = None
         self._JumpUrl = None
+        self._Endpoint = None
 
     @property
     def Operator(self):
@@ -20062,6 +20675,14 @@ class UpdateIntegrationEmployeesRequest(AbstractModel):
     def JumpUrl(self, JumpUrl):
         self._JumpUrl = JumpUrl
 
+    @property
+    def Endpoint(self):
+        return self._Endpoint
+
+    @Endpoint.setter
+    def Endpoint(self, Endpoint):
+        self._Endpoint = Endpoint
+
 
     def _deserialize(self, params):
         if params.get("Operator") is not None:
@@ -20078,6 +20699,7 @@ class UpdateIntegrationEmployeesRequest(AbstractModel):
             self._Agent._deserialize(params.get("Agent"))
         self._InvitationNotifyType = params.get("InvitationNotifyType")
         self._JumpUrl = params.get("JumpUrl")
+        self._Endpoint = params.get("Endpoint")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -20568,7 +21190,7 @@ class UserThreeFactor(AbstractModel):
         :type IdCardType: str
         :param _IdCardNumber: 证件号码，应符合以下规则
 <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳居民来往内地通行证号码共11位。第1位为字母，“H”字头签发给香港居民，“M”字头签发给澳门居民；第2位至第11位为数字。</li>
 <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type IdCardNumber: str
         """

{tencentcloud-sdk-python-ess-3.0.1110 → tencentcloud-sdk-python-ess-3.0.1116}/tencentcloud_sdk_python_ess.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-ess
-Version: 3.0.1110
+Version: 3.0.1116
 Summary: Tencent Cloud Ess SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

tencentcloud-sdk-python-ess-3.0.1116/tencentcloud_sdk_python_ess.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common==3.0.1116

tencentcloud-sdk-python-ess-3.0.1110/tencentcloud_sdk_python_ess.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common==3.0.1110