tencentcloud-sdk-python-essbasic 3.0.1193__tar.gz → 3.0.1201__tar.gz

{tencentcloud-sdk-python-essbasic-3.0.1193 → tencentcloud-sdk-python-essbasic-3.0.1201}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-essbasic
-Version: 3.0.1193
+Version: 3.0.1201
 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.1193 → tencentcloud-sdk-python-essbasic-3.0.1201}/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.1193"],
+    install_requires=["tencentcloud-sdk-python-common==3.0.1201"],
     version=tencentcloud.__version__,
     description='Tencent Cloud Essbasic SDK for Python',
     long_description=open('README.rst').read(),

{tencentcloud-sdk-python-essbasic-3.0.1193 → tencentcloud-sdk-python-essbasic-3.0.1201}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1193'
+__version__ = '3.0.1201'

{tencentcloud-sdk-python-essbasic-3.0.1193 → tencentcloud-sdk-python-essbasic-3.0.1201}/tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -217,7 +217,7 @@ class EssbasicClient(AbstractClient):
         - 参与人点击链接后需短信验证码才能查看合同内容。
         - 个人用户批量签署，需要传Name，Mobile，IdCardNumber(IdCardType) 参数。
         - saas企业员工用户批量签署，在传递了姓名等基本信息参数的情况下，还需要传OrganizationName（参与方所在企业名称）参数生成签署链接，<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。
-        - 子客企业员工用户批签签署，需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证，且OpenId对应员工此子客下已经实名</font>。Name，Mobile, IdCard等信息此时可以不传，系统会查询此OpenId实名信息自动补充。
+        - 子客企业员工用户批量签署，需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证，且OpenId对应员工此子客下已经实名</font>。Name，Mobile, IdCard等信息此时可以不传，系统会查询此OpenId实名信息自动补充。
         - 生成批量签署链接时，合同目标参与方状态需为<font color="red">待签署</font>状态。
         - 个人批量签署进行的合同的签名区， 全部变成<font color="red">手写签名</font>（不管合同里边设置的签名限制）来进行。
 
@@ -315,14 +315,18 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelCreateEmbedWebUrl(self, request):
-        """本接口（ChannelCreateEmbedWebUrl）用于创建常规模块嵌入web的链接
+        """本接口（ChannelCreateEmbedWebUrl）用于创建可嵌入web页面的URL（此web页面可以通过iframe方式嵌入到贵方系统的网页中），支持以下类型的Web链接创建：
+        1. 创建印章
+        2. 创建模板
+        3. 修改模板
+        4. 预览模板
+        5. 预览合同流程
 
-        本接口下面功能的签署页面链接的生成
-        - 创建印章
-        - 创建模板
-        - 修改模板
-        - 预览模板
-        - 预览合同流程
+        预览模板的嵌入页面长相如下：
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/57bdda4a884e3f5b2de12d5a282a3651.png)
+
+        预览合同流程的嵌入页面长相如下：
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/dc7af994e2f6da56bdad5975e927de34.png)
 
         :param request: Request instance for ChannelCreateEmbedWebUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateEmbedWebUrlRequest`
@@ -740,6 +744,9 @@ class EssbasicClient(AbstractClient):
         - 仅支持传入待签署或者待领取的合同，待填写暂不支持。
         - 员工批量签署，支持多种签名方式，包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
 
+        签署的嵌入页面长相如下：
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/a4754bc835a3f837ddec1e28b02ed9c0.png)
+
         :param request: Request instance for ChannelCreateOrganizationBatchSignUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateOrganizationBatchSignUrlRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateOrganizationBatchSignUrlResponse`
@@ -1490,16 +1497,20 @@ class EssbasicClient(AbstractClient):
 
 
     def CreateBatchOrganizationRegistrationTasks(self, request):
-        """本接口（CreateBatchOrganizationRegistrationTasks）用于批量创建企业认证链接
-        该接口为异步提交任务接口,需要跟查询企业批量认证链接(DescribeBatchOrganizationRegistrationUrls) 配合使用.
+        """该接口用于批量创建企业认证链接， 可以支持PC浏览器，H5和小程序三种途径。
+        此接口为异步提交任务接口，需要与[查询子企业批量认证链接](https://qcloudimg.tencent-cloud.cn/raw/1d3737991b2a3be78002bd78a47d6917.png)配合使用，整体流程如下图。
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
+
+
+
+        **注意**
+
+        1. 单次最多创建10个子企业。
+        2. 一天内，同一家企业最多创建8000个子企业。
+        3. 同一批创建的子客户不能重复，包括企业名称、企业统一信用代码和子客户经办人openId。
+        4. 跳转到小程序的实现，请参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式）。如何配置跳转电子签小程序，可参考：<a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
 
-        批量创建链接有以下限制：
-        1. 单次最多创建10个子客。
-        2. 一天同一家企业最多创建8000个子客。
-        3. 同一批创建的子客不能重复 其中包括 企业名称，企业统一信用代码，子客经办人openId。
-        4. 跳转到小程序的实现，参考微信官方文档（分为全屏、半屏两种方式），如何配置也可以请参考: 跳转电子签小程序配置
 
-        注： 1. 如果生成的链接是APP链接，跳转到小程序的实现，参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
 
         **腾讯电子签小程序的AppID 和 原始Id如下:**
 
@@ -1995,11 +2006,12 @@ class EssbasicClient(AbstractClient):
 
 
     def DescribeBatchOrganizationRegistrationUrls(self, request):
-        """此接口用于获取企业批量认证异步任务的状态及结果。
+        """此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID，然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
 
-        前提条件：已调用 CreateBatchOrganizationRegistrationTasks创建企业批量认证链接任务接口，并得到了任务Id。
 
-        异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定，正常情况下 3~5 秒即可完成，但也可能需要更长的时间
+        注：
+        `异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定，正常情况下 3~5 秒即可完成，但也可能需要更长的时间`
 
         :param request: Request instance for DescribeBatchOrganizationRegistrationUrls.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeBatchOrganizationRegistrationUrlsRequest`
@@ -2405,17 +2417,20 @@ class EssbasicClient(AbstractClient):
 
 
     def ModifyFlowDeadline(self, request):
-        """在已发起的签署流程中，支持对签署截止日期进行延期操作，主要涉及以下两个维度：
-        1. 合同（流程）维度：只需要传递签署流程ID。这将对签署流程和发起时未单独设定签署截止时间的签署人进行延期操作。
-        2. 签署人维度：需要传递流程ID和签署人ID。此操作将对签署人进行延期操作，尤其对于有序的合同（流程），签署截止时间不能超过后一位合同（流程）签署人的流程截止时间。
-
-        此接口有如下限制条件：
-        1. 执行操作的员工需为发起方企业的超级管理员、法定代表人或签署流程的发起人。
-        2. 在延长整个签署流程时，签署流程应至少还有一方未签署（即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态）。
-        3. 在延长整个签署流程时，新的签署截止日期应晚于合同已设定的签署截止日期和当前日期。
-        4. 在延长签署方的截止时间时，签署方不能处于流程完结或已终止状态（即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态）。
-        5. 在延长签署方的截止时间时，签署方的新签署截止日期应晚于当前日期和签署方已设定的截止日期。若为有序合同，还应早于或等于下一签署人的截止日期，且早于签署流程整体的截止日期。
-        6. 不支持操作合同组合同。
+        """在已启动的签署流程中，可对签署截止日期进行延期操作，主要分为以下两个层面：
+        1. <b> 合同（流程）层面</b>：仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
+        2. <b> 签署人层面</b>  ：需提供流程ID和签署人ID。此操作针对特定签署人进行延期，特别是对于有序合同（流程），签署截止时间不得超过后续签署人的流程截止时间。
+
+        此接口存在以下限制：
+        1. 执行操作的员工须为<font  color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
+        2. 延长整个签署流程时，<font  color="red">应至少有一方尚未签署</font>（即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态）。
+        3. 延长整个签署流程时，新的签署截止日期应晚于已设定的签署截止日期和当前日期。
+        4. 延长签署方截止时间时，<font  color="red">签署方不能处于流程完结或已终止状态</font>（即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态）。
+        5. 延长签署方截止时间时，新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同，还需早于或等于下一签署人的截止日期，且早于签署流程整体的截止日期。
+        6. <font  color="red">不支持操作合同组合同</font>。
+
+        合同（流程）层面截止时间子企业控制台展示的位置：
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/f0f88c0eb49a926da9a86e5a6e9efa8b.png)
 
         :param request: Request instance for ModifyFlowDeadline.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ModifyFlowDeadlineRequest`

{tencentcloud-sdk-python-essbasic-3.0.1193 → tencentcloud-sdk-python-essbasic-3.0.1201}/tencentcloud/essbasic/v20210526/models.py

@@ -730,12 +730,12 @@ class BaseFlowInfo(AbstractModel):
         r"""
         :param _FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         :type FlowName: str
+        :param _Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
+        :type Deadline: int
         :param _FlowType: 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为200个字符，仅限中文、字母、数字和下划线组成。
         :type FlowType: str
         :param _FlowDescription: 合同流程描述信息(可自定义此描述)，最大长度1000个字符。
         :type FlowDescription: str
-        :param _Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
-        :type Deadline: int
         :param _Unordered: 合同流程的签署顺序类型：
 **false**：(默认)有序签署, 本合同多个参与人需要依次签署
 **true**：无序签署, 本合同多个参与人没有先后签署限制
@@ -769,9 +769,9 @@ class BaseFlowInfo(AbstractModel):
         :type Components: list of Component
         """
         self._FlowName = None
+        self._Deadline = None
         self._FlowType = None
         self._FlowDescription = None
-        self._Deadline = None
         self._Unordered = None
         self._IntelligentStatus = None
         self._FormFields = None
@@ -789,6 +789,14 @@ class BaseFlowInfo(AbstractModel):
     def FlowName(self, FlowName):
         self._FlowName = FlowName
 
+    @property
+    def Deadline(self):
+        return self._Deadline
+
+    @Deadline.setter
+    def Deadline(self, Deadline):
+        self._Deadline = Deadline
+
     @property
     def FlowType(self):
         return self._FlowType
@@ -805,14 +813,6 @@ class BaseFlowInfo(AbstractModel):
     def FlowDescription(self, FlowDescription):
         self._FlowDescription = FlowDescription
 
-    @property
-    def Deadline(self):
-        return self._Deadline
-
-    @Deadline.setter
-    def Deadline(self, Deadline):
-        self._Deadline = Deadline
-
     @property
     def Unordered(self):
         return self._Unordered
@@ -880,9 +880,9 @@ class BaseFlowInfo(AbstractModel):
 
     def _deserialize(self, params):
         self._FlowName = params.get("FlowName")
+        self._Deadline = params.get("Deadline")
         self._FlowType = params.get("FlowType")
         self._FlowDescription = params.get("FlowDescription")
-        self._Deadline = params.get("Deadline")
         self._Unordered = params.get("Unordered")
         self._IntelligentStatus = params.get("IntelligentStatus")
         if params.get("FormFields") is not None:
@@ -9631,8 +9631,7 @@ class CreateBatchOrganizationRegistrationTasksRequest(AbstractModel):
 </ul>
 第三方平台子客企业和员工必须已经经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _RegistrationOrganizations: 当前应用下子客的组织机构注册信息。
-一次最多支持10条认证流
+        :param _RegistrationOrganizations: 当前应用下子企业的组织机构注册信息。最多支持查询10子企业。
         :type RegistrationOrganizations: list of RegistrationOrganizationInfo
         :param _Endpoint: 生成链接的类型：
 <ul><li>**PC**：(默认)web控制台链接, 需要在PC浏览器中打开</li>
@@ -9641,7 +9640,7 @@ class CreateBatchOrganizationRegistrationTasksRequest(AbstractModel):
 <li>**APP**：第三方APP或小程序跳转电子签小程序链接, 一般用于贵方小程序或者APP跳转过来,  打开后进入腾讯电子签小程序</li>
 <li>**H5**：第三方H5跳转到电子签H5长链接, 一般用于贵方H5跳转过来,  打开后进入腾讯电子签H5页面</li>
 <li>**SHORT_H5**：第三方H5跳转到电子签H5短链接, 一般用于贵方H5跳转过来,  打开后进入腾讯电子签H5页面</li></ul>
-示例值：PC
+
 
         :type Endpoint: str
         """
@@ -9702,14 +9701,15 @@ class CreateBatchOrganizationRegistrationTasksResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _TaskId: 生成注册链接的任务Id，
-根据这个id， 调用DescribeBatchOrganizationRegistrationUrls 获取生成的链接，进入认证流程
-若存在其中任意一条链接错误，则返回具体的错误描述, 不会返回TaskId
+        :param _TaskId: 生成注册链接的任务ID，后序根据这个任务ID， 调用<a href="https://qian.tencent.com/developers/partnerApis/accounts/DescribeBatchOrganizationRegistrationUrls" target="_blank">查询子企业批量认证链接</a>获取生成的链接，发给对应的客户使用。
+
+注：`如果有错误，则不会返回任务ID`
         :type TaskId: str
-        :param _ErrorMessages: 批量生成企业认证链接的详细错误信息，
-顺序与输入参数保持一致。
-若企业认证均成功生成，则不返回错误信息；
-若存在任何错误，则返回具体的错误描述。
+        :param _ErrorMessages: 批量生成企业认证链接的详细错误信息，顺序与输入参数子企业列表顺序一致。
+<ul>
+<li>如果所有企业认证链接都成功生成，将不返回错误信息</li>
+<li>如果存在任何错误，将返回具体的错误描述。（没有错误的企业返回空字符串）</li>
+</ul>
         :type ErrorMessages: list of str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -11216,12 +11216,15 @@ class CreatePartnerAutoSignAuthUrlRequest(AbstractModel):
 - FINANCE : 财务专用章
 - PERSONNEL : 人事专用章
         :type SealTypes: list of str
+        :param _AuthToMe: 他方授权给我方：- false：我方授权他方，AuthorizedOrganizationName代表【被授权方】企业名称- true：他方授权我方，AuthorizedOrganizationName代表【授权方】企业名称
+        :type AuthToMe: bool
         """
         self._Agent = None
         self._AuthorizedOrganizationId = None
         self._AuthorizedOrganizationName = None
         self._PlatformAppAuthorization = None
         self._SealTypes = None
+        self._AuthToMe = None
 
     @property
     def Agent(self):
@@ -11263,6 +11266,14 @@ class CreatePartnerAutoSignAuthUrlRequest(AbstractModel):
     def SealTypes(self, SealTypes):
         self._SealTypes = SealTypes
 
+    @property
+    def AuthToMe(self):
+        return self._AuthToMe
+
+    @AuthToMe.setter
+    def AuthToMe(self, AuthToMe):
+        self._AuthToMe = AuthToMe
+
 
     def _deserialize(self, params):
         if params.get("Agent") is not None:
@@ -11272,6 +11283,7 @@ class CreatePartnerAutoSignAuthUrlRequest(AbstractModel):
         self._AuthorizedOrganizationName = params.get("AuthorizedOrganizationName")
         self._PlatformAppAuthorization = params.get("PlatformAppAuthorization")
         self._SealTypes = params.get("SealTypes")
+        self._AuthToMe = params.get("AuthToMe")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -12001,7 +12013,7 @@ class DescribeBatchOrganizationRegistrationUrlsRequest(AbstractModel):
 </ul>
 第三方平台子客企业和员工必须已经经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _TaskId: 通过接口CreateBatchOrganizationRegistrationTasks创建企业批量认证链接任得到的任务Id
+        :param _TaskId: 通过接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>调用得到的任务ID。
         :type TaskId: str
         """
         self._Agent = None
@@ -12046,7 +12058,7 @@ class DescribeBatchOrganizationRegistrationUrlsResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _OrganizationAuthUrls: 企业批量注册链接信息
+        :param _OrganizationAuthUrls: 子企业注册认证的链接列表
         :type OrganizationAuthUrls: list of OrganizationAuthUrl
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -14557,7 +14569,7 @@ class FlowApproverInfo(AbstractModel):
         :param _ApproverSignTypes: 签署人签署合同时的认证方式
 <ul><li> **1** :人脸认证</li>
 <li> **2** :签署密码</li>
-<li> **3** :运营商三要素</li></ul>
+<li> **3** :运营商三要素（如果是港澳台客户，建议不要选择这个）</li></ul>
 
 默认为1(人脸认证 ),2(签署密码),3(运营商三要素)
 

{tencentcloud-sdk-python-essbasic-3.0.1193 → tencentcloud-sdk-python-essbasic-3.0.1201}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-essbasic
-Version: 3.0.1193
+Version: 3.0.1201
 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.1201/tencentcloud_sdk_python_essbasic.egg-info/requires.txt

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

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

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