tencentcloud-sdk-python-essbasic 3.0.1183__tar.gz → 3.0.1207__tar.gz

{tencentcloud-sdk-python-essbasic-3.0.1183 → tencentcloud-sdk-python-essbasic-3.0.1207}/PKG-INFO

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

{tencentcloud-sdk-python-essbasic-3.0.1183 → tencentcloud-sdk-python-essbasic-3.0.1207}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1183'
+__version__ = '3.0.1207'

{tencentcloud-sdk-python-essbasic-3.0.1183 → tencentcloud-sdk-python-essbasic-3.0.1207}/tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -215,7 +215,9 @@ class EssbasicClient(AbstractClient):
         注：
         - 使用此接口生成链接，需要提前开通 `使用手机号验证签署方身份` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
         - 参与人点击链接后需短信验证码才能查看合同内容。
-        - 企业用户批量签署，需要传OrganizationName（参与方所在企业名称）参数生成签署链接，<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。暂时仅支持给<font color="red">自建应用集成企业</font>生成员工批签链接，不支持子客企业。
+        - 个人用户批量签署，需要传Name，Mobile，IdCardNumber(IdCardType) 参数。
+        - saas企业员工用户批量签署，在传递了姓名等基本信息参数的情况下，还需要传OrganizationName（参与方所在企业名称）参数生成签署链接，<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。
+        - 子客企业员工用户批量签署，需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证，且OpenId对应员工此子客下已经实名</font>。Name，Mobile, IdCard等信息此时可以不传，系统会查询此OpenId实名信息自动补充。
         - 生成批量签署链接时，合同目标参与方状态需为<font color="red">待签署</font>状态。
         - 个人批量签署进行的合同的签名区， 全部变成<font color="red">手写签名</font>（不管合同里边设置的签名限制）来进行。
 
@@ -313,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`
@@ -738,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`
@@ -1467,6 +1476,9 @@ class EssbasicClient(AbstractClient):
     def ChannelVerifyPdf(self, request):
         """对合同流程文件进行数字签名验证，判断数字签名是否有效，合同文件内容是否被篡改。
 
+        **补充**： 可以到控制台[合同验签](https://qian.tencent.com/verifySign)体验验签功能，界面如下
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/81c333ccb07f0c5fbaf840d9cee61333.png)
+
         :param request: Request instance for ChannelVerifyPdf.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelVerifyPdfRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelVerifyPdfResponse`
@@ -1488,16 +1500,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如下:**
 
@@ -1650,7 +1666,7 @@ class EssbasicClient(AbstractClient):
         <tr>
         <td>企业已激活</td>
         <td>员工未认证</td>
-        <td>进入员认证并加入企业流程</td>
+        <td>进入员工认证并加入企业流程</td>
         </tr>
         <tr>
         <td>企业已激活</td>
@@ -1691,6 +1707,41 @@ class EssbasicClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateEmployeeQualificationSealQrCode(self, request):
+        """该接口用于获取个人授权执业章给企业的二维码，需要个人用户通过微信扫码。
+
+        扫描后将跳转到腾讯电子签小程序，进入到授权执业章的流程。
+
+        个人用户授权成功后，企业印章管理员需对印章进行审核，审核通过后，即可使用个人授权的执业章进行盖章操作。
+
+        **注意**
+        1. 该二维码**有效期为7天**，过期后将失效，可重新创建。
+
+
+        整体流程入下图
+
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/21b6b56dbc796c9d6f402d6ce6febb07.png)
+
+        :param request: Request instance for CreateEmployeeQualificationSealQrCode.
+        :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateEmployeeQualificationSealQrCodeRequest`
+        :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateEmployeeQualificationSealQrCodeResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateEmployeeQualificationSealQrCode", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateEmployeeQualificationSealQrCodeResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateFlowBlockchainEvidenceUrl(self, request):
         """获取区块链存证证书查看链接/二维码接口
 
@@ -1967,11 +2018,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`
@@ -2132,10 +2184,9 @@ class EssbasicClient(AbstractClient):
         1. **企业自动签**
         2. **企业与港澳台居民签署合同**
         3. **使用手机号验证签署方身份**
-        4. **骑缝章**
-        5. **拓宽签署方年龄限制**
-        6. **下载企业合同/文件**
-        7. **隐藏合同经办人姓名**
+        4. **拓宽签署方年龄限制**
+        5. **下载企业合同/文件**
+        6. **隐藏合同经办人姓名**
 
         对应能力开通页面在子客控制台-企业中心-拓展服务，如下图所示:
 
@@ -2378,17 +2429,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.1183 → tencentcloud-sdk-python-essbasic-3.0.1207}/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:
@@ -2065,12 +2065,12 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
         :param _Name: 签署方经办人的姓名。
 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
 
-注：`请确保和合同中填入的一致`，`除动态签署人场景外，此参数必填`
+注：`请确保和合同中填入的一致`，`除动态签署人或子客员工经办人场景外，此参数必填`
         :type Name: str
         :param _Mobile: 手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
 请确认手机号所有方为此业务通知方。
 
-注：`请确保和合同中填入的一致,  若无法保持一致，请确保在发起和生成批量签署链接时传入相同的参与方证件信息`，`除动态签署人场景外，此参数必填`
+注：`请确保和合同中填入的一致,  若无法保持一致，请确保在发起和生成批量签署链接时传入相同的参与方证件信息`，`除动态签署人或子客员工经办人场景外，此参数必填`
         :type Mobile: str
         :param _Operator: 执行本接口操作的员工信息。
 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
@@ -2098,14 +2098,14 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
         :param _FlowIds: 批量签署的合同流程ID数组。
 注: `在调用此接口时，请确保合同流程均为本企业发起，且合同数量不超过100个。`
         :type FlowIds: list of str
-        :param _OrganizationName: 目标签署人的企业名称，签署人如果是企业员工身份，需要传此参数。
+        :param _OrganizationName: SaaS平台企业员工签署方的企业名称。目标签署人如果为saas应用企业员工身份，此参数必填。
 
 注：
 <ul>
 <li>请确认该名称与企业营业执照中注册的名称一致。</li>
 <li>如果名称中包含英文括号()，请使用中文括号（）代替。</li>
 <li>请确保此企业已完成腾讯电子签企业认证。</li>
-<li>暂时仅支持给`自建应用集成企业` 生成员工批签链接，不支持子客企业。</li>
+<li>**若为子客企业员工，请使用OpenId，OrganizationOpenId参数，此参数留空即可**</li>
 </ul>
         :type OrganizationName: str
         :param _JumpToDetail: 是否直接跳转至合同内容页面进行签署
@@ -2116,6 +2116,16 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
         :type JumpToDetail: bool
         :param _FlowBatchUrlInfo: 批量签署合同相关信息，指定合同和签署方的信息，用于补充动态签署人。	
         :type FlowBatchUrlInfo: :class:`tencentcloud.essbasic.v20210526.models.FlowBatchUrlInfo`
+        :param _OpenId: 第三方平台子客企业员工的标识OpenId，批签合同经办人为子客员工的情况下为必填。
+
+注：
+<ul>
+<li>传入的OpenId对应员工在此子客企业下必须已经实名</li>
+<li>传递了此参数可以无需传递Name，Mobile，IdCardNumber，IdCardType参数。系统会根据员工OpenId自动拉取实名信息。</li>
+</ul>
+        :type OpenId: str
+        :param _OrganizationOpenId: 第三方平台子客企业的企业的标识, 即OrganizationOpenId，批签合同经办人为子客企业员工是为必填。
+        :type OrganizationOpenId: str
         """
         self._Agent = None
         self._Name = None
@@ -2128,6 +2138,8 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
         self._OrganizationName = None
         self._JumpToDetail = None
         self._FlowBatchUrlInfo = None
+        self._OpenId = None
+        self._OrganizationOpenId = None
 
     @property
     def Agent(self):
@@ -2217,6 +2229,22 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
     def FlowBatchUrlInfo(self, FlowBatchUrlInfo):
         self._FlowBatchUrlInfo = FlowBatchUrlInfo
 
+    @property
+    def OpenId(self):
+        return self._OpenId
+
+    @OpenId.setter
+    def OpenId(self, OpenId):
+        self._OpenId = OpenId
+
+    @property
+    def OrganizationOpenId(self):
+        return self._OrganizationOpenId
+
+    @OrganizationOpenId.setter
+    def OrganizationOpenId(self, OrganizationOpenId):
+        self._OrganizationOpenId = OrganizationOpenId
+
 
     def _deserialize(self, params):
         if params.get("Agent") is not None:
@@ -2236,6 +2264,8 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
         if params.get("FlowBatchUrlInfo") is not None:
             self._FlowBatchUrlInfo = FlowBatchUrlInfo()
             self._FlowBatchUrlInfo._deserialize(params.get("FlowBatchUrlInfo"))
+        self._OpenId = params.get("OpenId")
+        self._OrganizationOpenId = params.get("OrganizationOpenId")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -6986,15 +7016,7 @@ class ChannelDescribeOrganizationSealsRequest(AbstractModel):
 
 注:  `没有输入返回所有记录，最大返回100条。`
         :type SealId: str
-        :param _SealTypes: 电子印章类型 , 可选类型如下: 
-<ul><li>**OFFICIAL**: 公章</li>
-<li>**CONTRACT**: 合同专用章;</li>
-<li>**FINANCE**: 财务专用章;</li>
-<li>**PERSONNEL**: 人事专用章</li>
-<li>**INVOICE**: 发票专用章</li>
-</ul>
-
-注:  `为空时查询所有类型的印章。`
+        :param _SealTypes: 电子印章类型 , 可选类型如下: <ul><li>**OFFICIAL**: 公章</li><li>**CONTRACT**: 合同专用章;</li><li>**FINANCE**: 财务专用章;</li><li>**PERSONNEL**: 人事专用章</li><li>**INVOICE**: 发票专用章</li><li>**EMPLOYEE_QUALIFICATION_SEAL**: 员工执业章</li></ul>注:  `为空时查询所有类型的印章。`
         :type SealTypes: list of str
         :param _SealStatuses: 
 需查询的印章状态列表。
@@ -8803,13 +8825,17 @@ class CommonFlowApprover(AbstractModel):
         :param _ApproverSignTypes: 签署人签署合同时的认证方式
 <ul><li> **1** :人脸认证</li>
 <li> **2** :签署密码</li>
-<li> **3** :运营商三要素</li></ul>
+<li> **3** :运营商三要素</li>
+<li> **5** :设备指纹识别</li>
+<li> **6** :设备面容识别</li></ul>
 
-默认为1(人脸认证 ),2(签署密码)
+默认为1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)
 
 注: 
 1. 用<font color='red'>模板创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color='red'>在创建合同重新指定无效</font>
 2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/partner/mobile_support)得到具体的支持说明
+3. 校验方式不允许只包含<font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>，至少需要再增加一种其他校验方式。
+4. <font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>只支持小程序使用，其他端暂不支持。
         :type ApproverSignTypes: list of int
         """
         self._NotChannelOrganization = None
@@ -9609,8 +9635,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>
@@ -9619,7 +9644,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
         """
@@ -9680,14 +9705,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
@@ -10023,7 +10049,9 @@ class CreateConsoleLoginUrlRequest(AbstractModel):
 `3. 同渠道应用(Agent.AppId)下，企业唯一标识ProxyOrganizationOpenId需要保持唯一，员工唯一标识OpenId也要保持唯一 (而不是企业下唯一)。 `
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _ProxyOrganizationName: 第三方平台子客的企业名称，请确认该企业名称与企业营业执照中注册的名称完全一致。
-<font color="red">在测试环境联调的过程中，企业名称请使用以下名称 
+<font color="red">
+在测试环境联调的过程中，企业名称请统一加上“测试”二字，如：典子谦示例企业测试，否则将无法审核通过。
+企业名称请使用以下名称, 以下名称可以不用走收录。
 **子客测试专用企业1 - 子客测试专用企业9**</font>
 
 注:
@@ -10340,6 +10368,92 @@ class CreateConsoleLoginUrlResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class CreateEmployeeQualificationSealQrCodeRequest(AbstractModel):
+    """CreateEmployeeQualificationSealQrCode请求参数结构体
+
+    """
+
+    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 _HintText: 提示信息，扫码后此信息会展示给扫描用户，用来提示用户授权操作的目的，会在授权界面下面的位置展示。
+
+![image](https://qcloudimg.tencent-cloud.cn/raw/8436ffd78c20605e6b133ff4bc4d2ac7.png)
+        :type HintText: str
+        """
+        self._Agent = None
+        self._HintText = None
+
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
+    @property
+    def HintText(self):
+        return self._HintText
+
+    @HintText.setter
+    def HintText(self, HintText):
+        self._HintText = HintText
+
+
+    def _deserialize(self, params):
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
+        self._HintText = params.get("HintText")
+        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 CreateEmployeeQualificationSealQrCodeResponse(AbstractModel):
+    """CreateEmployeeQualificationSealQrCode返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _QrcodeBase64: 二维码图片的Base64  注:  `此二维码的有效时间为7天，过期后需要重新生成新的二维码图片`
+        :type QrcodeBase64: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._QrcodeBase64 = None
+        self._RequestId = None
+
+    @property
+    def QrcodeBase64(self):
+        return self._QrcodeBase64
+
+    @QrcodeBase64.setter
+    def QrcodeBase64(self, QrcodeBase64):
+        self._QrcodeBase64 = QrcodeBase64
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._QrcodeBase64 = params.get("QrcodeBase64")
+        self._RequestId = params.get("RequestId")
+
+
 class CreateFlowBlockchainEvidenceUrlRequest(AbstractModel):
     """CreateFlowBlockchainEvidenceUrl请求参数结构体
 
@@ -10351,9 +10465,13 @@ class CreateFlowBlockchainEvidenceUrlRequest(AbstractModel):
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _FlowId: 合同流程ID，为32位字符串。建议开发者妥善保存此流程ID，以便于顺利进行后续操作。可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         :type FlowId: str
+        :param _ExpiredOn: 链接/二维码的有效截止时间，格式为unix时间戳。最长不超过 2099年12月31日（4102415999）。
+默认值为有效期为当前时间后7天。
+        :type ExpiredOn: int
         """
         self._Agent = None
         self._FlowId = None
+        self._ExpiredOn = None
 
     @property
     def Agent(self):
@@ -10371,12 +10489,21 @@ class CreateFlowBlockchainEvidenceUrlRequest(AbstractModel):
     def FlowId(self, FlowId):
         self._FlowId = FlowId
 
+    @property
+    def ExpiredOn(self):
+        return self._ExpiredOn
+
+    @ExpiredOn.setter
+    def ExpiredOn(self, ExpiredOn):
+        self._ExpiredOn = ExpiredOn
+
 
     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")
+        self._ExpiredOn = params.get("ExpiredOn")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -11095,12 +11222,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):
@@ -11142,6 +11272,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:
@@ -11151,6 +11289,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:]
@@ -11258,14 +11397,7 @@ class CreateSealByImageRequest(AbstractModel):
 <li><strong>SealGenerateSourceSystem</strong>: 系统生成印章, 无需上传SealImage图片</li>
 </ul>
         :type GenerateSource: str
-        :param _SealType: 电子印章类型 , 可选类型如下: 
-<ul><li>**OFFICIAL**: (默认)公章</li>
-<li>**CONTRACT**: 合同专用章;</li>
-<li>**FINANCE**: 财务专用章;</li>
-<li>**PERSONNEL**: 人事专用章</li>
-<li>**INVOICE**: 发票专用章</li>
-</ul>
-注: `同企业下只能有一个公章, 重复创建会报错`
+        :param _SealType: 电子印章类型 , 可选类型如下: <ul><li>**OFFICIAL**: (默认)公章</li><li>**CONTRACT**: 合同专用章;</li><li>**FINANCE**: 财务专用章;</li><li>**PERSONNEL**: 人事专用章</li><li>**INVOICE**: 发票专用章</li><li>**OTHER**: 其他</li></ul>注: 同企业下只能有<font color="red">一个</font>公章, 重复创建会报错
         :type SealType: str
         :param _SealHorizontalText: 企业印章横向文字，最多可填15个汉字  (若超过印章最大宽度，优先压缩字间距，其次缩小字号)
 横向文字的位置如下图中的"印章横向文字在这里"
@@ -11887,7 +12019,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
@@ -11932,7 +12064,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
@@ -13073,7 +13205,7 @@ class DescribeTemplatesRequest(AbstractModel):
 <ul><li>**0**：（默认）模板列表及详情</li>
 <li>**1**：仅模板列表, 不会返回模板中的签署控件, 填写控件, 参与方角色列表等信息</li></ul>
         :type ContentType: int
-        :param _TemplateIds: 合同模板ID数组，每一个合同模板ID为32位字符串,  最多支持200个模板的批量查询。
+        :param _TemplateIds: 合同模板ID数组，每一个合同模板ID为32位字符串,  最多支持100个模板的批量查询。
 
 注意: 
 1.` 此参数TemplateIds与TemplateId互为独立，若两者均传入，以TemplateId为准。`
@@ -13086,7 +13218,7 @@ class DescribeTemplatesRequest(AbstractModel):
         :type TemplateIds: list of str
         :param _Limit: 指定每页返回的数据条数，和Offset参数配合使用。
 
-注：`1.默认值为20，单页做大值为200。`
+注：`1.默认值为20，单页做大值为100。`
         :type Limit: int
         :param _Offset: 查询结果分页返回，指定从第几页返回数据，和Limit参数配合使用。
 
@@ -13669,7 +13801,6 @@ class ExtentServiceAuthInfo(AbstractModel):
 <li>AUTO_SIGN             企业自动签（自动签署）</li>
 <li>  OVERSEA_SIGN          企业与港澳台居民签署合同</li>
 <li>  MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
-<li> PAGING_SEAL           骑缝章</li>
 <li> DOWNLOAD_FLOW         授权渠道下载合同 </li>
 <li>AGE_LIMIT_EXPANSION 拓宽签署方年龄限制</li>
 <li>HIDE_OPERATOR_DISPLAY 隐藏合同经办人姓名</li>
@@ -14444,13 +14575,17 @@ class FlowApproverInfo(AbstractModel):
         :param _ApproverSignTypes: 签署人签署合同时的认证方式
 <ul><li> **1** :人脸认证</li>
 <li> **2** :签署密码</li>
-<li> **3** :运营商三要素</li></ul>
+<li> **3** :运营商三要素（如果是港澳台客户，建议不要选择这个）</li>
+<li>**5**：设备指纹识别，需要对比手机机主预留的指纹信息，校验一致才能成功进行合同签署。（iOS系统暂不支持该校验方式）</li>
+<li>**6**：设备面容识别，需要对比手机机主预留的人脸信息，校验一致才能成功进行合同签署。（Android系统暂不支持该校验方式）</li></ul>
 
-默认为1(人脸认证 ),2(签署密码),3(运营商三要素)
+默认为1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)
 
 注: 
 1. 用<font color='red'>模板创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color='red'>在创建合同重新指定无效</font>
 2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/partner/mobile_support)得到具体的支持说明
+3. 校验方式不允许只包含<font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>，至少需要再增加一种其他校验方式。
+4. <font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>只支持小程序使用，其他端暂不支持。
         :type ApproverSignTypes: list of int
         :param _SignId: 签署ID
 - 发起流程时系统自动补充
@@ -18339,7 +18474,9 @@ false-否
 <ul><li> 1 :人脸认证</li>
 <li> 2 :签署密码</li>
 <li> 3 :运营商三要素认证</li>
-<li> 4 :UKey认证</li></ul>
+<li> 4 :UKey认证</li>
+<li> 5 :设备指纹识别</li>
+<li> 6 :设备面容识别</li></ul>
         :type ApproverSignTypes: list of int
         """
         self._RecipientId = None
@@ -19494,8 +19631,10 @@ class Staff(AbstractModel):
         :param _UserId: 员工在电子签平台的用户ID
         :type UserId: str
         :param _DisplayName: 显示的员工名
+注意：2024-07-08 及之后创建的应用号，该字段返回的是打码信息
         :type DisplayName: str
         :param _Mobile: 员工手机号
+注意：2024-07-08 及之后创建的应用号，该字段返回的是打码信息
         :type Mobile: str
         :param _Email: 员工邮箱
 注意：此字段可能返回 null，表示取不到有效值。

{tencentcloud-sdk-python-essbasic-3.0.1183 → tencentcloud-sdk-python-essbasic-3.0.1207}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

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

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

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

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