tencentcloud-sdk-python 3.0.1059__py2.py3-none-any.whl → 3.0.1062__py2.py3-none-any.whl

tencentcloud/ess/v20201111/ess_client.py

@@ -157,7 +157,7 @@ class EssClient(AbstractClient):
         """该接口用于发起合同后，生成个人用户的批量签署链接, 暂时不支持企业端签署。
         **注意：**
         1. 该接口目前仅支持签署人类型是**个人签署方的批量签署场景**(ApproverType=1)。
-        2. 该接口可生成批量签署链接的C端签署人**必须仅有手写签名和时间类型的签署控件**，**不支持填写控件** 。
+        2. 该接口可生成批量签署链接的C端签署人**必须仅有手写签名(控件类型为SIGN_SIGNATURE)和时间类型的签署控件**，**不支持填写控件** 。
         3. 请确保C端签署人在批量签署合同中**为待签署状态**，如需顺序签署请待前一位参与人签署完成后，再创建该C端用户的签署链接。
         4. 该签署链接**有效期为30分钟**，过期后将失效，如需签署可重新创建批量签署链接 。
         5. 该接口返回的签署链接适用于APP集成的场景，支持APP打开或浏览器直接打开，**不支持微信小程序嵌入**。
@@ -563,6 +563,36 @@ class EssClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateFlowGroupSignReview(self, request):
+        """提交合同组签署流程审批结果的适用场景包括：
+
+        1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时，若指定了以下参数 为true，则可以调用此接口提交企业内部签署审批结果。即使是自动签署也需要进行审核通过才会进行签署。
+          - [FlowGroupInfo.NeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#flowgroupinfo)
+          - [ApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#approverinfo)
+
+
+        2. 同一合同组，同一签署人可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
+
+        :param request: Request instance for CreateFlowGroupSignReview.
+        :type request: :class:`tencentcloud.ess.v20201111.models.CreateFlowGroupSignReviewRequest`
+        :rtype: :class:`tencentcloud.ess.v20201111.models.CreateFlowGroupSignReviewResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateFlowGroupSignReview", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateFlowGroupSignReviewResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateFlowReminds(self, request):
         """指定需要批量催办的签署流程ID，批量催办合同，最多100个。需要符合以下条件的合同才可被催办：
 
@@ -596,9 +626,36 @@ class EssClient(AbstractClient):
 
 
     def CreateFlowSignReview(self, request):
-        """提交签署流程审批结果的适用场景包括：
-        1. 在使用模板（CreateFlow）或文件（CreateFlowByFiles）创建签署流程时，若指定了参数NeedSignReview为true，且发起方企业作为签署方参与了流程签署，则可以调用此接口提交企业内部签署审批结果。自动签署也需要进行审核通过才会进行签署。
-        2. 若签署流程状态正常，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
+        """提交企业流程审批结果
+        **当前存在两种审核操作：**
+        <ul>
+        <li>签署审核
+        <ul>
+        <li>在通过接口<ul>
+        <li>CreateFlowByFiles</li>
+        <li>CreateFlow</li>
+        <li>CreateFlowGroupByTemplates</li>
+        <li>CreateFlowGroupByFiles</li>
+        <li>CreatePrepareFlow</li>
+        </ul>
+        发起签署流程时，通过指定NeedSignReview为true，则可以调用此接口，并指定operate=SignReview，以提交企业内部签署审批结果</li>
+        <li>在通过接口
+        <ul>
+        <li>CreateFlowByFiles</li>
+        <li>CreateFlow</li>
+        <li>CreateFlowGroupByTemplates</li>
+        <li>CreateFlowGroupByFiles</li>
+        </ul>
+        发起签署流程时，通过指定签署人ApproverNeedSignReview为true，则可以调用此接口，并指定operate=SignReview，并指定RecipientId，以提交企业内部签署审批结果</li>
+        </ul>
+        </li>
+        <li>发起审核
+         <ul>
+        <li>通过接口CreatePrepareFlow指定发起后需要审核，那么可以调用此接口，并指定operate=CreateReview，以提交企业内部审批结果。可以多次提交审批结果，但一旦审批通过，后续提交的结果将无效
+        </li>
+        </ul>
+        </li>
+        </ul>
 
         :param request: Request instance for CreateFlowSignReview.
         :type request: :class:`tencentcloud.ess.v20201111.models.CreateFlowSignReviewRequest`