tencentcloud-sdk-python-essbasic 3.0.1102__py2.py3-none-any.whl → 3.0.1113__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1102'
+__version__ = '3.0.1113'

tencentcloud/essbasic/v20210526/errorcodes.py

@@ -38,6 +38,9 @@ FAILEDOPERATION_FLOWNUMEXCEED = 'FailedOperation.FlowNumExceed'
 # 已授权。
 FAILEDOPERATION_HASAUTHORIZED = 'FailedOperation.HasAuthorized'
 
+# 自动签许可额度不足
+FAILEDOPERATION_LICENSENOQUOTA = 'FailedOperation.LicenseNoQuota'
+
 # 无角色授权，请确认数据是否存在
 FAILEDOPERATION_NOROLEAUTH = 'FailedOperation.NoRoleAuth'
 
@@ -257,7 +260,7 @@ INVALIDPARAMETER_RESOURCETYPE = 'InvalidParameter.ResourceType'
 # 角色ID不正确
 INVALIDPARAMETER_ROLEID = 'InvalidParameter.RoleId'
 
-# 文件内容敏感信息。
+# 上传的文件包含敏感（不合规）的内容，请确认。
 INVALIDPARAMETER_SENSITIVEFILECONTENT = 'InvalidParameter.SensitiveFileContent'
 
 # 参数错误，不合法的签署控件类型，请修改后重试。

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`
@@ -339,7 +347,7 @@ class EssbasicClient(AbstractClient):
 
         限制条件：
         1. 本企业（发起方企业）企业签署人仅支持通过企业名称+姓名+手机号进行补充。
-        2. 个人签署人仅支持通过姓名+手机号进行补充。
+        2. 个人签署人支持通过姓名+手机号进行补充，补充动态签署人时：若个人用户已完成实名，则可通过姓名+证件号码进行补充。
 
         :param request: Request instance for ChannelCreateFlowApprovers.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowApproversRequest`
@@ -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. 静默（自动）签署不支持合同签署方存在填写功能`
 
@@ -1154,7 +1162,11 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelDescribeBillUsageDetail(self, request):
-        """通过此接口（ChannelDescribeBillUsageDetail）查询该第三方平台子客企业的套餐消耗详情。
+        """通过此接口（ChannelDescribeBillUsageDetail）查询该第三方平台子客企业的套餐消耗详情。可以支持单个子客和整个应用下所有子客的查询。
+        <ul>
+        <li>对于单个子客企业的查询，通过指定子客的唯一标识(Agent.ProxyOrganizationOpenId)来查询该子客消耗详情</li>
+        <li>对于整个应用下所有企业的查询，不需要指定子客的唯一标识，只需要传入渠道应用标识(Agent.AppId)直接查询整个应用下所有子客企业消耗详情</li>
+        </ul>
 
         :param request: Request instance for ChannelDescribeBillUsageDetail.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelDescribeBillUsageDetailRequest`
@@ -1438,6 +1450,31 @@ class EssbasicClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def ChannelRenewAutoSignLicense(self, request):
+        """给医疗个人自动签许可续期。续期成功后，可对医疗自动签许可追加一年有效期，只可续期一次。
+
+        注意: `处方单等特殊场景专用，此接口为白名单功能，使用前请联系对接的客户经理沟通。`
+
+        :param request: Request instance for ChannelRenewAutoSignLicense.
+        :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelRenewAutoSignLicenseRequest`
+        :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelRenewAutoSignLicenseResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ChannelRenewAutoSignLicense", params, headers=headers)
+            response = json.loads(body)
+            model = models.ChannelRenewAutoSignLicenseResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def ChannelUpdateSealStatus(self, request):
         """此接口（ChannelUpdateSealStatus）用于第三方应用平台为子客企业更新印章状态。
 
@@ -1807,7 +1844,7 @@ class EssbasicClient(AbstractClient):
 
         2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明
 
-        3. <font color="red">调用接口发起合同成功就会扣减合同的额度</font>, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度）
+        3. <font color="red">调用接口发起合同成功就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）
 
         4. <font color="red">静默（自动）签署不支持合同签署方存在填写</font>
 
@@ -1957,6 +1994,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。