tencentcloud-sdk-python-essbasic 3.0.1109__tar.gz → 3.0.1117__tar.gz

{tencentcloud-sdk-python-essbasic-3.0.1109 → tencentcloud-sdk-python-essbasic-3.0.1117}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-essbasic
-Version: 3.0.1109
+Version: 3.0.1117
 Summary: Tencent Cloud Essbasic SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

{tencentcloud-sdk-python-essbasic-3.0.1109 → tencentcloud-sdk-python-essbasic-3.0.1117}/setup.py

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

{tencentcloud-sdk-python-essbasic-3.0.1109 → tencentcloud-sdk-python-essbasic-3.0.1117}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1109'
+__version__ = '3.0.1117'

{tencentcloud-sdk-python-essbasic-3.0.1109 → tencentcloud-sdk-python-essbasic-3.0.1117}/tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -34,9 +34,13 @@ class EssbasicClient(AbstractClient):
         - **可撤回合同状态**：未全部签署完成
         - **不撤回合同状态**：已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
 
+        批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/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/partnerApis/operateFlows/DescribeCancelFlowsTask)主动查询。
+
+
         注:
         - 有对应合同撤销权限的人:  <font color='red'>**合同的发起人（并已经授予撤销权限）或者发起人所在企业的超管、法人**</font>
         - 签署完毕的合同需要双方走解除流程将合同作废，可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
+        - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。</font>
 
         :param request: Request instance for ChannelBatchCancelFlows.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelBatchCancelFlowsRequest`
@@ -69,6 +73,7 @@ class EssbasicClient(AbstractClient):
         注:
         - 有对应合同撤销权限的人:  <font color='red'>**合同的发起人（并已经授予撤销权限）或者发起人所在企业的超管、法人**</font>
         - 签署完毕的合同需要双方走解除流程将合同作废，可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
+        - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。</font>
 
         :param request: Request instance for ChannelCancelFlow.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCancelFlowRequest`
@@ -146,8 +151,11 @@ class EssbasicClient(AbstractClient):
         - **可撤回合同状态**：未全部签署完成
         - **不撤回合同状态**：已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
 
+        批量撤销结果可以通过接口返回的TaskId关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/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/partnerApis/operateFlows/DescribeCancelFlowsTask)主动查询。
+
         注:
         - 签署完毕的合同需要双方走解除流程将合同作废，可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>
+        - <font color='red'>只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。</font>
 
         :param request: Request instance for ChannelCreateBatchCancelFlowUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateBatchCancelFlowUrlRequest`
@@ -422,7 +430,7 @@ class EssbasicClient(AbstractClient):
 
         `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
-        `3. 合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度）`
+        `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）`
 
         `4. 静默（自动）签署不支持合同签署方存在填写功能`
 
@@ -510,7 +518,7 @@ class EssbasicClient(AbstractClient):
 
         `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
-        `3. 合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
+        `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
 
         `4. 静默（自动）签署不支持合同签署方存在填写功能`
 
@@ -595,7 +603,7 @@ class EssbasicClient(AbstractClient):
 
         `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
-        `3. 合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
+        `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
 
         `4. 静默（自动）签署不支持合同签署方存在填写功能`
 
@@ -901,7 +909,9 @@ class EssbasicClient(AbstractClient):
         <li>原合同个人类型参与人必须是解除协议的参与人，<code>不能更换其他第三方个人</code>参与解除协议。</li>
         <li>如果原合同企业参与人无法参与解除协议，可以指定同企业具有同等权限的<code>企业员工代为处理</code>。</li>
         <li>发起解除协议同发起其他企业合同一样，也会参与合同<code>扣费</code>，扣费标准同其他类型合同。</li>
-        <li>在解除协议发起之后，原合同的状态将转变为解除中。一旦解除协议签署完毕，原合同及解除协议均变为已解除状态。</li></ul>
+        <li>在解除协议发起之后，原合同的状态将转变为解除中。一旦解除协议签署完毕，原合同及解除协议均变为已解除状态。</li>
+        <li>非原合同企业参与人发起解除协议时，需要有<code>解除合同的权限</code>。</li>
+        </ul>
 
         :param request: Request instance for ChannelCreateReleaseFlow.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateReleaseFlowRequest`
@@ -1836,7 +1846,7 @@ class EssbasicClient(AbstractClient):
 
         2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明
 
-        3. <font color="red">调用接口发起合同成功就会扣减合同的额度</font>, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度）
+        3. <font color="red">调用接口发起合同成功就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）
 
         4. <font color="red">静默（自动）签署不支持合同签署方存在填写</font>
 
@@ -1986,6 +1996,29 @@ class EssbasicClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeCancelFlowsTask(self, request):
+        """通过接口[批量撤销合同流程](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelBatchCancelFlows)或者[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateBatchCancelFlowUrl)发起批量撤销任务后，可通过此接口查询批量撤销任务的结果。
+
+        :param request: Request instance for DescribeCancelFlowsTask.
+        :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeCancelFlowsTaskRequest`
+        :rtype: :class:`tencentcloud.essbasic.v20210526.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 DescribeChannelFlowEvidenceReport(self, request):
         """获取出证报告任务执行结果，返回报告 URL。
 

{tencentcloud-sdk-python-essbasic-3.0.1109 → tencentcloud-sdk-python-essbasic-3.0.1117}/tencentcloud/essbasic/v20210526/models.py

@@ -893,6 +893,51 @@ class BaseFlowInfo(AbstractModel):
         
 
 
+class CancelFailureFlow(AbstractModel):
+    """撤销失败的流程信息
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _FlowId: 签署流程编号，为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 CcInfo(AbstractModel):
     """抄送信息
 
@@ -1086,10 +1131,14 @@ class ChannelBatchCancelFlowsResponse(AbstractModel):
 
 注:  `如果全部撤销成功, 此数组为空数组`
         :type FailMessages: list of str
+        :param _TaskId: 批量撤销任务编号，为32位字符串，可用于[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask) 或关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/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._FailMessages = None
+        self._TaskId = None
         self._RequestId = None
 
     @property
@@ -1100,6 +1149,14 @@ class ChannelBatchCancelFlowsResponse(AbstractModel):
     def FailMessages(self, FailMessages):
         self._FailMessages = FailMessages
 
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -1111,6 +1168,7 @@ class ChannelBatchCancelFlowsResponse(AbstractModel):
 
     def _deserialize(self, params):
         self._FailMessages = params.get("FailMessages")
+        self._TaskId = params.get("TaskId")
         self._RequestId = params.get("RequestId")
 
 
@@ -1719,12 +1777,15 @@ class ChannelCreateBatchCancelFlowUrlResponse(AbstractModel):
 
 
         :type UrlExpireOn: str
+        :param _TaskId: 批量撤销任务编号，为32位字符串，可用于[查询批量撤销合同结果](https://qian.tencent.com/developers/partnerApis/operateFlows/DescribeCancelFlowsTask) 或关联[批量撤销任务结果回调](https://qian.tencent.com/developers/partner/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
@@ -1751,6 +1812,14 @@ class ChannelCreateBatchCancelFlowUrlResponse(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
@@ -1764,6 +1833,7 @@ class ChannelCreateBatchCancelFlowUrlResponse(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")
 
 
@@ -1991,7 +2061,7 @@ class ChannelCreateBatchSignUrlRequest(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>
 
 注：`请确保和合同中填入的一致`
@@ -2664,26 +2734,29 @@ class ChannelCreateFlowApproversRequest(AbstractModel):
 </ul>
 第三方平台子客企业和员工必须已经经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _FlowId: 合同流程ID，为32位字符串。 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
-        :type FlowId: str
         :param _Approvers: 补充企业签署人信息。
 
 - 如果发起方指定的补充签署人是企业签署人，则需要提供企业名称或者企业OpenId；
 
 - 如果不指定，则使用姓名和手机号进行补充。
         :type Approvers: list of FillApproverInfo
+        :param _FlowId: 合同流程ID，为32位字符串。 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
+        :type FlowId: str
         :param _FillApproverType: 签署人信息补充方式
 
 <ul><li>**1**: 表示往未指定签署人的节点，添加一个明确的签署人，支持企业或个人签署方。</li></ul>
         :type FillApproverType: int
         :param _Operator: 操作人信息
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
+        :param _FlowGroupId: 合同流程组的组ID, 在合同流程组场景下，生成合同流程组的签署链接时需要赋值
+        :type FlowGroupId: str
         """
         self._Agent = None
-        self._FlowId = None
         self._Approvers = None
+        self._FlowId = None
         self._FillApproverType = None
         self._Operator = None
+        self._FlowGroupId = None
 
     @property
     def Agent(self):
@@ -2693,14 +2766,6 @@ class ChannelCreateFlowApproversRequest(AbstractModel):
     def Agent(self, Agent):
         self._Agent = Agent
 
-    @property
-    def FlowId(self):
-        return self._FlowId
-
-    @FlowId.setter
-    def FlowId(self, FlowId):
-        self._FlowId = FlowId
-
     @property
     def Approvers(self):
         return self._Approvers
@@ -2709,6 +2774,14 @@ class ChannelCreateFlowApproversRequest(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
@@ -2725,22 +2798,31 @@ class ChannelCreateFlowApproversRequest(AbstractModel):
     def Operator(self, Operator):
         self._Operator = Operator
 
+    @property
+    def FlowGroupId(self):
+        return self._FlowGroupId
+
+    @FlowGroupId.setter
+    def FlowGroupId(self, FlowGroupId):
+        self._FlowGroupId = FlowGroupId
+
 
     def _deserialize(self, params):
         if params.get("Agent") is not None:
             self._Agent = Agent()
             self._Agent._deserialize(params.get("Agent"))
-        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")
         if params.get("Operator") is not None:
             self._Operator = UserInfo()
             self._Operator._deserialize(params.get("Operator"))
+        self._FlowGroupId = params.get("FlowGroupId")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -3322,11 +3404,14 @@ class ChannelCreateFlowGroupByFilesResponse(AbstractModel):
 `此数组的顺序和入参中的FlowGroupInfos顺序一致`
 注意：此字段可能返回 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
@@ -3345,6 +3430,14 @@ class ChannelCreateFlowGroupByFilesResponse(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
@@ -3357,6 +3450,12 @@ class ChannelCreateFlowGroupByFilesResponse(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")
 
 
@@ -3450,12 +3549,15 @@ class ChannelCreateFlowGroupByTemplatesResponse(AbstractModel):
         :param _TaskInfos: 复杂文档合成任务（如，包含动态表格的预览任务）的任务信息数组；
 如果文档需要异步合成，此字段会返回该异步任务的任务信息，后续可以通过ChannelGetTaskResultApi接口查询任务详情；
         :type TaskInfos: list of TaskInfo
+        :param _Approvers: 合同组签署方信息
+        :type Approvers: list of FlowGroupApprovers
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
         self._FlowGroupId = None
         self._FlowIds = None
         self._TaskInfos = None
+        self._Approvers = None
         self._RequestId = None
 
     @property
@@ -3482,6 +3584,14 @@ class ChannelCreateFlowGroupByTemplatesResponse(AbstractModel):
     def TaskInfos(self, TaskInfos):
         self._TaskInfos = TaskInfos
 
+    @property
+    def Approvers(self):
+        return self._Approvers
+
+    @Approvers.setter
+    def Approvers(self, Approvers):
+        self._Approvers = Approvers
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -3500,6 +3610,12 @@ class ChannelCreateFlowGroupByTemplatesResponse(AbstractModel):
                 obj = TaskInfo()
                 obj._deserialize(item)
                 self._TaskInfos.append(obj)
+        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")
 
 
@@ -4641,7 +4757,7 @@ class ChannelCreatePreparedPersonalEsignRequest(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个中文字符
@@ -8560,7 +8676,8 @@ class CommonFlowApprover(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，使用模板发起是，对应模板配置中的签署人RecipientId
@@ -11030,7 +11147,7 @@ class CreateSignUrlsRequest(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 _OrganizationOpenId: 第三方平台子客企业的企业的标识, 即OrganizationOpenId
@@ -11060,6 +11177,8 @@ class CreateSignUrlsRequest(AbstractModel):
 
 注：`使用此参数需要与flow_ids数量一致并且一一对应, 表示在对应同序号的流程中的参与角色ID`，
         :type RecipientIds: list of str
+        :param _FlowGroupUrlInfo: 合同组相关信息，指定合同组子合同和签署方的信息，用于补充动态签署人。
+        :type FlowGroupUrlInfo: :class:`tencentcloud.essbasic.v20210526.models.FlowGroupUrlInfo`
         """
         self._Agent = None
         self._FlowIds = None
@@ -11078,6 +11197,7 @@ class CreateSignUrlsRequest(AbstractModel):
         self._Operator = None
         self._Hides = None
         self._RecipientIds = None
+        self._FlowGroupUrlInfo = None
 
     @property
     def Agent(self):
@@ -11219,6 +11339,14 @@ class CreateSignUrlsRequest(AbstractModel):
     def RecipientIds(self, RecipientIds):
         self._RecipientIds = RecipientIds
 
+    @property
+    def FlowGroupUrlInfo(self):
+        return self._FlowGroupUrlInfo
+
+    @FlowGroupUrlInfo.setter
+    def FlowGroupUrlInfo(self, FlowGroupUrlInfo):
+        self._FlowGroupUrlInfo = FlowGroupUrlInfo
+
 
     def _deserialize(self, params):
         if params.get("Agent") is not None:
@@ -11242,6 +11370,9 @@ class CreateSignUrlsRequest(AbstractModel):
             self._Operator._deserialize(params.get("Operator"))
         self._Hides = params.get("Hides")
         self._RecipientIds = params.get("RecipientIds")
+        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:]
@@ -11450,6 +11581,139 @@ class DescribeBatchOrganizationRegistrationUrlsResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class DescribeCancelFlowsTaskRequest(AbstractModel):
+    """DescribeCancelFlowsTask请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+</ul>
+第三方平台子客企业和员工必须已经经过实名认证
+        :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
+        :param _TaskId: 批量撤销任务编号，为32位字符串，通过接口[批量撤销合同流程](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelBatchCancelFlows)或者[获取批量撤销签署流程腾讯电子签小程序链接](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateBatchCancelFlowUrl)获得。
+        :type TaskId: str
+        """
+        self._Agent = None
+        self._TaskId = None
+
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+
+    def _deserialize(self, params):
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
+        self._TaskId = params.get("TaskId")
+        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位字符串。
+        :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 DescribeChannelFlowEvidenceReportRequest(AbstractModel):
     """DescribeChannelFlowEvidenceReport请求参数结构体
 
@@ -13132,11 +13396,13 @@ class FillApproverInfo(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 _FlowId: 合同流程ID，补充合同组子合同动态签署人时必传。
+        :type FlowId: str
         """
         self._RecipientId = None
         self._OpenId = None
@@ -13147,6 +13413,7 @@ class FillApproverInfo(AbstractModel):
         self._NotChannelOrganization = None
         self._ApproverIdCardType = None
         self._ApproverIdCardNumber = None
+        self._FlowId = None
 
     @property
     def RecipientId(self):
@@ -13220,6 +13487,14 @@ class FillApproverInfo(AbstractModel):
     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")
@@ -13231,6 +13506,7 @@ class FillApproverInfo(AbstractModel):
         self._NotChannelOrganization = params.get("NotChannelOrganization")
         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:]
@@ -13681,7 +13957,7 @@ class FlowApproverInfo(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 _Mobile: 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)， 不支持海外手机号。
@@ -14622,6 +14898,103 @@ class FlowFileInfo(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 FlowGroupOptions(AbstractModel):
     """合同组的配置项信息包括：在合同组签署过程中，是否需要对每个子合同进行独立的意愿确认。
 
@@ -14671,6 +15044,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 FlowInfo(AbstractModel):
     """此结构体 (FlowInfo) 用于描述签署流程信息。
 
@@ -15551,8 +15962,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
@@ -16085,7 +16500,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: 组织机构名称。
@@ -17847,7 +18262,7 @@ class ReleasedApprover(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ApproverNumber: 签署人在原合同签署人列表中的顺序序号(从0开始，按顺序依次递增)。</br>
+        :param _ApproverNumber: 签署人在原合同签署人列表中的顺序序号(从0开始，按顺序依次递增)。
 可以通过<a href="https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo" target="_blank">DescribeFlowDetailInfo</a>接口查看原流程中的签署人列表。
         :type ApproverNumber: int
         :param _ApproverType: 指定签署人类型，目前支持
@@ -17863,7 +18278,8 @@ class ReleasedApprover(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 _Mobile: 签署人手机号。
@@ -17873,17 +18289,17 @@ class ReleasedApprover(AbstractModel):
 如果名称中包含英文括号()，请使用中文括号（）代替。
 如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
         :type OrganizationName: str
-        :param _OrganizationOpenId: 第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样, 可以参考<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#agent" target="_blank">Agent结构体</a>。</br>
+        :param _OrganizationOpenId: 第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样, 可以参考<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#agent" target="_blank">Agent结构体</a>。
 当为子客企业指定经办人时，此OrganizationOpenId必传。
         :type OrganizationOpenId: str
-        :param _OpenId: 第三方平台子客企业员工的唯一标识，长度不能超过64，只能由字母和数字组成。</br>
+        :param _OpenId: 第三方平台子客企业员工的唯一标识，长度不能超过64，只能由字母和数字组成。
 当签署方为同一第三方平台下的员工时，此OpenId必传。
         :type OpenId: str
         :param _ApproverSignComponentType: 签署控件类型，支持自定义企业签署方的签署控件类型
 <ul><li> **SIGN_SEAL**：默认为印章控件类型(默认值)</li>
 <li> **SIGN_SIGNATURE**：手写签名控件类型</li></ul>
         :type ApproverSignComponentType: str
-        :param _ApproverSignRole: 参与方在合同中的角色是按照创建合同的时候来排序的，解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`,  第三个叫`丙方`，以此类推。</br>
+        :param _ApproverSignRole: 参与方在合同中的角色是按照创建合同的时候来排序的，解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`,  第三个叫`丙方`，以此类推。
 如果需改动此参与人的角色名字，可用此字段指定，由汉字,英文字符,数字组成，最大20个字。
         :type ApproverSignRole: str
         """
@@ -19852,7 +20268,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-essbasic-3.0.1109 → tencentcloud-sdk-python-essbasic-3.0.1117}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-essbasic
-Version: 3.0.1109
+Version: 3.0.1117
 Summary: Tencent Cloud Essbasic SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

tencentcloud-sdk-python-essbasic-3.0.1117/tencentcloud_sdk_python_essbasic.egg-info/requires.txt

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

tencentcloud-sdk-python-essbasic-3.0.1109/tencentcloud_sdk_python_essbasic.egg-info/requires.txt

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