tencentcloud-sdk-python-essbasic 3.0.1155__tar.gz → 3.0.1209__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/PKG-INFO +1 -1
  2. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/setup.py +1 -1
  3. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/__init__.py +1 -1
  4. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/v20210526/essbasic_client.py +182 -50
  5. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/v20210526/models.py +589 -98
  6. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO +1 -1
  7. tencentcloud-sdk-python-essbasic-3.0.1209/tencentcloud_sdk_python_essbasic.egg-info/requires.txt +1 -0
  8. tencentcloud-sdk-python-essbasic-3.0.1155/tencentcloud_sdk_python_essbasic.egg-info/requires.txt +0 -1
  9. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/README.rst +0 -0
  10. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/setup.cfg +0 -0
  11. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/__init__.py +0 -0
  12. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/v20201222/__init__.py +0 -0
  13. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/v20201222/errorcodes.py +0 -0
  14. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/v20201222/essbasic_client.py +0 -0
  15. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/v20201222/models.py +0 -0
  16. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/v20210526/__init__.py +0 -0
  17. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud/essbasic/v20210526/errorcodes.py +0 -0
  18. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud_sdk_python_essbasic.egg-info/SOURCES.txt +0 -0
  19. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud_sdk_python_essbasic.egg-info/dependency_links.txt +0 -0
  20. {tencentcloud-sdk-python-essbasic-3.0.1155 → tencentcloud-sdk-python-essbasic-3.0.1209}/tencentcloud_sdk_python_essbasic.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 1.1
2
2
  Name: tencentcloud-sdk-python-essbasic
3
- Version: 3.0.1155
3
+ Version: 3.0.1209
4
4
  Summary: Tencent Cloud Essbasic SDK for Python
5
5
  Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
6
6
  Author: Tencent Cloud
@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
8
8
 
9
9
  setup(
10
10
  name='tencentcloud-sdk-python-essbasic',
11
- install_requires=["tencentcloud-sdk-python-common==3.0.1155"],
11
+ install_requires=["tencentcloud-sdk-python-common==3.0.1209"],
12
12
  version=tencentcloud.__version__,
13
13
  description='Tencent Cloud Essbasic SDK for Python',
14
14
  long_description=open('README.rst').read(),
@@ -14,4 +14,4 @@
14
14
  # limitations under the License.
15
15
 
16
16
 
17
- __version__ = '3.0.1155'
17
+ __version__ = '3.0.1209'
@@ -215,8 +215,11 @@ class EssbasicClient(AbstractClient):
215
215
  注:
216
216
  - 使用此接口生成链接,需要提前开通 `使用手机号验证签署方身份` 功能,在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
217
217
  - 参与人点击链接后需短信验证码才能查看合同内容。
218
- - 企业用户批量签署,需要传OrganizationName(参与方所在企业名称)参数生成签署链接,`请确保此企业已完成腾讯电子签企业认证`。暂时仅支持给`自建应用集成企业` 生成员工批签链接,不支持子客企业。
219
- - 个人批量签署,签名区`仅支持手写签名`。
218
+ - 个人用户批量签署,需要传Name,Mobile,IdCardNumber(IdCardType) 参数。
219
+ - saas企业员工用户批量签署,在传递了姓名等基本信息参数的情况下,还需要传OrganizationName(参与方所在企业名称)参数生成签署链接,<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。
220
+ - 子客企业员工用户批量签署,需要传递员工OpenId和子客企业的OrganizationOpenId。<font color="red">请确保此OrganizationOpenId对应子客已经认证,且OpenId对应员工此子客下已经实名</font>。Name,Mobile, IdCard等信息此时可以不传,系统会查询此OpenId实名信息自动补充。
221
+ - 生成批量签署链接时,合同目标参与方状态需为<font color="red">待签署</font>状态。
222
+ - 个人批量签署进行的合同的签名区, 全部变成<font color="red">手写签名</font>(不管合同里边设置的签名限制)来进行。
220
223
 
221
224
  :param request: Request instance for ChannelCreateBatchSignUrl.
222
225
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateBatchSignUrlRequest`
@@ -312,14 +315,18 @@ class EssbasicClient(AbstractClient):
312
315
 
313
316
 
314
317
  def ChannelCreateEmbedWebUrl(self, request):
315
- """本接口(ChannelCreateEmbedWebUrl)用于创建常规模块嵌入web的链接
318
+ """本接口(ChannelCreateEmbedWebUrl)用于创建可嵌入web页面的URL(此web页面可以通过iframe方式嵌入到贵方系统的网页中),支持以下类型的Web链接创建:
319
+ 1. 创建印章
320
+ 2. 创建模板
321
+ 3. 修改模板
322
+ 4. 预览模板
323
+ 5. 预览合同流程
316
324
 
317
- 本接口下面功能的签署页面链接的生成
318
- - 创建印章
319
- - 创建模板
320
- - 修改模板
321
- - 预览模板
322
- - 预览合同流程
325
+ 预览模板的嵌入页面长相如下:
326
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/57bdda4a884e3f5b2de12d5a282a3651.png)
327
+
328
+ 预览合同流程的嵌入页面长相如下:
329
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/dc7af994e2f6da56bdad5975e927de34.png)
323
330
 
324
331
  :param request: Request instance for ChannelCreateEmbedWebUrl.
325
332
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateEmbedWebUrlRequest`
@@ -395,6 +402,10 @@ class EssbasicClient(AbstractClient):
395
402
 
396
403
  `4. 静默(自动)签署不支持合同签署方存在填写功能`
397
404
 
405
+ <font color="red">相关视频指引</font> <br>
406
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
407
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
408
+
398
409
  :param request: Request instance for ChannelCreateFlowByFiles.
399
410
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowByFilesRequest`
400
411
  :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowByFilesResponse`
@@ -662,11 +673,10 @@ class EssbasicClient(AbstractClient):
662
673
  """该接口用于发起合同后,生成用户的签署链接 <br/>
663
674
 
664
675
  **注意**
665
- 1. 该接口可生成签署链接的签署人必须仅有手写签名、时间类型和印章类型的签署控件,**不支持填写控件**
666
- 2. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接
667
- 3. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
668
- 跳转到小程序的实现,参考微信官方文档(分为<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>。
669
- 4. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
676
+ 1. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接
677
+ 2. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。配置方式请参考:<a href="https://qian.tencent.com/developers/company/openqianh5/">跳转电子签H5</a>。
678
+ 如需跳转到小程序的实现,参考微信官方文档(分为<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>。
679
+ 3. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
670
680
 
671
681
  :param request: Request instance for ChannelCreateFlowSignUrl.
672
682
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowSignUrlRequest`
@@ -734,6 +744,9 @@ class EssbasicClient(AbstractClient):
734
744
  - 仅支持传入待签署或者待领取的合同,待填写暂不支持。
735
745
  - 员工批量签署,支持多种签名方式,包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
736
746
 
747
+ 签署的嵌入页面长相如下:
748
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/a4754bc835a3f837ddec1e28b02ed9c0.png)
749
+
737
750
  :param request: Request instance for ChannelCreateOrganizationBatchSignUrl.
738
751
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateOrganizationBatchSignUrlRequest`
739
752
  :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateOrganizationBatchSignUrlResponse`
@@ -1214,11 +1227,10 @@ class EssbasicClient(AbstractClient):
1214
1227
 
1215
1228
 
1216
1229
  def ChannelDescribeOrganizationSeals(self, request):
1217
- """此接口(ChannelDescribeOrganizationSeals)查询子客企业电子印章。<br />
1218
- 注:
1219
- 1. `查询子客企业电子印章,需要操作者具有管理印章权限`
1220
- 2. `客户指定需要获取的印章数量和偏移量,数量最多100,超过100按100处理`
1221
- 3. `此接口只能查询启用的印章`
1230
+ """此接口查询子企业电子印章。<br />
1231
+
1232
+ 注:
1233
+ 1. 此操作要求操作者具备<b>印章查询权限</b>(若调用者尚无此权限,请联系超级管理员前往Web控制台【组织管理】->【角色管理】添加相应权限)。
1222
1234
 
1223
1235
  :param request: Request instance for ChannelDescribeOrganizationSeals.
1224
1236
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelDescribeOrganizationSealsRequest`
@@ -1464,6 +1476,9 @@ class EssbasicClient(AbstractClient):
1464
1476
  def ChannelVerifyPdf(self, request):
1465
1477
  """对合同流程文件进行数字签名验证,判断数字签名是否有效,合同文件内容是否被篡改。
1466
1478
 
1479
+ **补充**: 可以到控制台[合同验签](https://qian.tencent.com/verifySign)体验验签功能,界面如下
1480
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/81c333ccb07f0c5fbaf840d9cee61333.png)
1481
+
1467
1482
  :param request: Request instance for ChannelVerifyPdf.
1468
1483
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelVerifyPdfRequest`
1469
1484
  :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelVerifyPdfResponse`
@@ -1485,16 +1500,20 @@ class EssbasicClient(AbstractClient):
1485
1500
 
1486
1501
 
1487
1502
  def CreateBatchOrganizationRegistrationTasks(self, request):
1488
- """本接口(CreateBatchOrganizationRegistrationTasks)用于批量创建企业认证链接
1489
- 该接口为异步提交任务接口,需要跟查询企业批量认证链接(DescribeBatchOrganizationRegistrationUrls) 配合使用.
1503
+ """该接口用于批量创建企业认证链接, 可以支持PC浏览器,H5和小程序三种途径。
1504
+ 此接口为异步提交任务接口,需要与[查询子企业批量认证链接](https://qcloudimg.tencent-cloud.cn/raw/1d3737991b2a3be78002bd78a47d6917.png)配合使用,整体流程如下图。
1505
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
1506
+
1507
+
1508
+
1509
+ **注意**
1510
+
1511
+ 1. 单次最多创建10个子企业。
1512
+ 2. 一天内,同一家企业最多创建8000个子企业。
1513
+ 3. 同一批创建的子客户不能重复,包括企业名称、企业统一信用代码和子客户经办人openId。
1514
+ 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>。
1490
1515
 
1491
- 批量创建链接有以下限制:
1492
- 1. 单次最多创建10个子客。
1493
- 2. 一天同一家企业最多创建8000个子客。
1494
- 3. 同一批创建的子客不能重复 其中包括 企业名称,企业统一信用代码,子客经办人openId。
1495
- 4. 跳转到小程序的实现,参考微信官方文档(分为全屏、半屏两种方式),如何配置也可以请参考: 跳转电子签小程序配置
1496
1516
 
1497
- 注: 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>
1498
1517
 
1499
1518
  **腾讯电子签小程序的AppID 和 原始Id如下:**
1500
1519
 
@@ -1636,7 +1655,6 @@ class EssbasicClient(AbstractClient):
1636
1655
  <th>子客企业状态</th>
1637
1656
  <th>子客企业员工状态</th>
1638
1657
  <th>点击链接进入的流程</th>
1639
- <th>视频样例</th>
1640
1658
  </tr>
1641
1659
  </thead>
1642
1660
  <tbody>
@@ -1644,19 +1662,16 @@ class EssbasicClient(AbstractClient):
1644
1662
  <td>企业未激活</td>
1645
1663
  <td>员工未认证</td>
1646
1664
  <td>进入企业激活流程,首次完成企业激活流程的员工会成为超管</td>
1647
- <td><a href="https://dyn.ess.tencent.cn/guide/apivideo/CreateConsoleLoginUrl_noverify.mp4" target="_blank">打开</a></td>
1648
1665
  </tr>
1649
1666
  <tr>
1650
1667
  <td>企业已激活</td>
1651
1668
  <td>员工未认证</td>
1652
- <td>进入员认证并加入企业流程</td>
1653
- <td>-</td>
1669
+ <td>进入员工认证并加入企业流程</td>
1654
1670
  </tr>
1655
1671
  <tr>
1656
1672
  <td>企业已激活</td>
1657
1673
  <td>员工已认证</td>
1658
1674
  <td>进入子客企业Web控制台</td>
1659
- <td>-</td>
1660
1675
  </tr>
1661
1676
  </tbody>
1662
1677
  </table>
@@ -1668,6 +1683,10 @@ class EssbasicClient(AbstractClient):
1668
1683
  系统的渠道企业, 应用, 子客企业, 子客员工的组织形式
1669
1684
  ![image](https://qcloudimg.tencent-cloud.cn/raw/bee4b7375fe7a097f3573b18a1c1e30b.png)
1670
1685
 
1686
+
1687
+ <font color="red">相关视频指引</font> <br>
1688
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-createconsoleloginin.mp4" target="_blank">【生成子客登录链接】代码编写 & 子企业认证示例</a><br>
1689
+
1671
1690
  :param request: Request instance for CreateConsoleLoginUrl.
1672
1691
  :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateConsoleLoginUrlRequest`
1673
1692
  :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateConsoleLoginUrlResponse`
@@ -1688,6 +1707,74 @@ class EssbasicClient(AbstractClient):
1688
1707
  raise TencentCloudSDKException(type(e).__name__, str(e))
1689
1708
 
1690
1709
 
1710
+ def CreateEmployeeQualificationSealQrCode(self, request):
1711
+ """该接口用于获取个人授权执业章给企业的二维码,需要个人用户通过微信扫码。
1712
+
1713
+ 扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
1714
+
1715
+ 个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
1716
+
1717
+ **注意**
1718
+ 1. 该二维码**有效期为7天**,过期后将失效,可重新创建。
1719
+
1720
+
1721
+ 整体流程入下图
1722
+
1723
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/21b6b56dbc796c9d6f402d6ce6febb07.png)
1724
+
1725
+ :param request: Request instance for CreateEmployeeQualificationSealQrCode.
1726
+ :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateEmployeeQualificationSealQrCodeRequest`
1727
+ :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateEmployeeQualificationSealQrCodeResponse`
1728
+
1729
+ """
1730
+ try:
1731
+ params = request._serialize()
1732
+ headers = request.headers
1733
+ body = self.call("CreateEmployeeQualificationSealQrCode", params, headers=headers)
1734
+ response = json.loads(body)
1735
+ model = models.CreateEmployeeQualificationSealQrCodeResponse()
1736
+ model._deserialize(response["Response"])
1737
+ return model
1738
+ except Exception as e:
1739
+ if isinstance(e, TencentCloudSDKException):
1740
+ raise
1741
+ else:
1742
+ raise TencentCloudSDKException(type(e).__name__, str(e))
1743
+
1744
+
1745
+ def CreateFlowBlockchainEvidenceUrl(self, request):
1746
+ """获取区块链存证证书查看链接/二维码接口
1747
+
1748
+ 适用场景:企业员工可以通过此接口生成合同区块链存证证书的查看链接/二维码,以供他人扫码打开腾讯电子签小程序查看。
1749
+
1750
+ [点击查看区块链存证证书样式](https://qcloudimg.tencent-cloud.cn/raw/47d5e9c2ffa90ad4e27b3cd14095aa08.jpg)
1751
+
1752
+ 注:
1753
+ <ul><li>1. 二维码下载链接过期时间为5分钟,请尽快下载保存。二维码/短链的过期时间为<font color="red">7天</font>,超过有效期则不可用。</li>
1754
+ <li>2. 合同状态需为<font color="red">签署完成</font> 、<font color="red">已解除</font>才能生成证书查看二维码/短链。</li>
1755
+ <li>3. 调用接口时,需确保接口调用身份拥有此合同的访问数据权限或为合同参与方。</li>
1756
+ <li>4. 通过扫码或者点击链接,用户无需登录或者鉴权即可查看对应合同的区块链存证证书,请妥善保管好二维码或链接。</li></ul>
1757
+
1758
+ :param request: Request instance for CreateFlowBlockchainEvidenceUrl.
1759
+ :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowBlockchainEvidenceUrlRequest`
1760
+ :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowBlockchainEvidenceUrlResponse`
1761
+
1762
+ """
1763
+ try:
1764
+ params = request._serialize()
1765
+ headers = request.headers
1766
+ body = self.call("CreateFlowBlockchainEvidenceUrl", params, headers=headers)
1767
+ response = json.loads(body)
1768
+ model = models.CreateFlowBlockchainEvidenceUrlResponse()
1769
+ model._deserialize(response["Response"])
1770
+ return model
1771
+ except Exception as e:
1772
+ if isinstance(e, TencentCloudSDKException):
1773
+ raise
1774
+ else:
1775
+ raise TencentCloudSDKException(type(e).__name__, str(e))
1776
+
1777
+
1691
1778
  def CreateFlowGroupSignReview(self, request):
1692
1779
  """1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时,若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
1693
1780
  - [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
@@ -1777,6 +1864,11 @@ class EssbasicClient(AbstractClient):
1777
1864
 
1778
1865
  5. <font color="red">在下一步创建签署链接前,建议等待DocumentFill </font> <a href="https://qian.tencent.com/developers/partner/callback_types_file_resources">PDF合成完成的回调</a>或者睡眠几秒,尤其是当模板中存在动态表格等复杂填写控件时,因为合成过程可能会耗费秒级别的时间。
1779
1866
 
1867
+
1868
+ <font color="red">相关视频指引</font> <br>
1869
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
1870
+ 2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateFlowsByTemplates.mp4" target="_blank">【用模板创建签署流程】编写示例视频教程</a><br>
1871
+
1780
1872
  :param request: Request instance for CreateFlowsByTemplates.
1781
1873
  :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowsByTemplatesRequest`
1782
1874
  :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowsByTemplatesResponse`
@@ -1797,6 +1889,37 @@ class EssbasicClient(AbstractClient):
1797
1889
  raise TencentCloudSDKException(type(e).__name__, str(e))
1798
1890
 
1799
1891
 
1892
+ def CreateLegalSealQrCode(self, request):
1893
+ """该接口用于获取创建法人章的二维码,需要通过微信扫描。扫描后将跳转到腾讯电子签署,进入到创建法人章的流程。
1894
+
1895
+ **注意**
1896
+ 1. 该二维码**有效期为7天**,过期后将失效,可重新创建 。
1897
+ 2. 每个公司**只能有1个法人章**,无法重复创建或者创建多个
1898
+
1899
+ 法人章的样式可以参考下图索引(也可以自己上传法人印章图片):
1900
+
1901
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/36a0a090750c45bb5cac5047ac461b2c.png)
1902
+
1903
+ :param request: Request instance for CreateLegalSealQrCode.
1904
+ :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateLegalSealQrCodeRequest`
1905
+ :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateLegalSealQrCodeResponse`
1906
+
1907
+ """
1908
+ try:
1909
+ params = request._serialize()
1910
+ headers = request.headers
1911
+ body = self.call("CreateLegalSealQrCode", params, headers=headers)
1912
+ response = json.loads(body)
1913
+ model = models.CreateLegalSealQrCodeResponse()
1914
+ model._deserialize(response["Response"])
1915
+ return model
1916
+ except Exception as e:
1917
+ if isinstance(e, TencentCloudSDKException):
1918
+ raise
1919
+ else:
1920
+ raise TencentCloudSDKException(type(e).__name__, str(e))
1921
+
1922
+
1800
1923
  def CreatePartnerAutoSignAuthUrl(self, request):
1801
1924
  """创建他方自动签授权链接,通过该链接可进入小程序进行合作方企业的自动签授权,若当前企业未开通企业自动签,通过该链接会先引导开通本企业自动签。
1802
1925
  该接口效果同控制台: 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权
@@ -1895,11 +2018,12 @@ class EssbasicClient(AbstractClient):
1895
2018
 
1896
2019
 
1897
2020
  def DescribeBatchOrganizationRegistrationUrls(self, request):
1898
- """此接口用于获取企业批量认证异步任务的状态及结果。
2021
+ """此接口用于获取企业批量认证异步任务的状态及结果。需要先调用接口<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateBatchOrganizationRegistrationTasks" target="_blank">提交子企业批量认证链接创建任务</a>获取到任务ID,然后再调用此接口获取到各个子企业的注册认证链接。整体流程如下图。
2022
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/654aa2a72ab7d42f06464ea33c50c3bb.png)
1899
2023
 
1900
- 前提条件:已调用 CreateBatchOrganizationRegistrationTasks创建企业批量认证链接任务接口,并得到了任务Id。
1901
2024
 
1902
- 异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间
2025
+ 注:
2026
+ `异步任务的处理完成时间视当前已提交的任务量、任务的复杂程度等因素决定,正常情况下 3~5 秒即可完成,但也可能需要更长的时间`
1903
2027
 
1904
2028
  :param request: Request instance for DescribeBatchOrganizationRegistrationUrls.
1905
2029
  :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeBatchOrganizationRegistrationUrlsRequest`
@@ -2060,10 +2184,9 @@ class EssbasicClient(AbstractClient):
2060
2184
  1. **企业自动签**
2061
2185
  2. **企业与港澳台居民签署合同**
2062
2186
  3. **使用手机号验证签署方身份**
2063
- 4. **骑缝章**
2064
- 5. **拓宽签署方年龄限制**
2065
- 6. **下载企业合同/文件**
2066
- 7. **隐藏合同经办人姓名**
2187
+ 4. **拓宽签署方年龄限制**
2188
+ 5. **下载企业合同/文件**
2189
+ 6. **隐藏合同经办人姓名**
2067
2190
 
2068
2191
  对应能力开通页面在子客控制台-企业中心-拓展服务,如下图所示:
2069
2192
 
@@ -2185,6 +2308,9 @@ class EssbasicClient(AbstractClient):
2185
2308
  >1. 查询条件TemplateId、TemplateName与ChannelTemplateId可同时存在,即可查询同时满足这些条件的模板。
2186
2309
  >2. TemplateId 和TemplateIds互为独立,若两个参数都传入,则以TemplateId为准
2187
2310
 
2311
+ <font color="red">相关视频指引</font> <br>
2312
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
2313
+
2188
2314
  :param request: Request instance for DescribeTemplates.
2189
2315
  :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeTemplatesRequest`
2190
2316
  :rtype: :class:`tencentcloud.essbasic.v20210526.models.DescribeTemplatesResponse`
@@ -2303,17 +2429,20 @@ class EssbasicClient(AbstractClient):
2303
2429
 
2304
2430
 
2305
2431
  def ModifyFlowDeadline(self, request):
2306
- """在已发起的签署流程中,支持对签署截止日期进行延期操作,主要涉及以下两个维度:
2307
- 1. 合同(流程)维度:只需要传递签署流程ID。这将对签署流程和发起时未单独设定签署截止时间的签署人进行延期操作。
2308
- 2. 签署人维度:需要传递流程ID和签署人ID。此操作将对签署人进行延期操作,尤其对于有序的合同(流程),签署截止时间不能超过后一位合同(流程)签署人的流程截止时间。
2309
-
2310
- 此接口有如下限制条件:
2311
- 1. 执行操作的员工需为发起方企业的超级管理员、法定代表人或签署流程的发起人。
2312
- 2. 在延长整个签署流程时,签署流程应至少还有一方未签署(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态)。
2313
- 3. 在延长整个签署流程时,新的签署截止日期应晚于合同已设定的签署截止日期和当前日期。
2314
- 4. 在延长签署方的截止时间时,签署方不能处于流程完结或已终止状态(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
2315
- 5. 在延长签署方的截止时间时,签署方的新签署截止日期应晚于当前日期和签署方已设定的截止日期。若为有序合同,还应早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
2316
- 6. 不支持操作合同组合同。
2432
+ """在已启动的签署流程中,可对签署截止日期进行延期操作,主要分为以下两个层面:
2433
+ 1. <b> 合同(流程)层面</b>:仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
2434
+ 2. <b> 签署人层面</b> :需提供流程ID和签署人ID。此操作针对特定签署人进行延期,特别是对于有序合同(流程),签署截止时间不得超过后续签署人的流程截止时间。
2435
+
2436
+ 此接口存在以下限制:
2437
+ 1. 执行操作的员工须为<font color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
2438
+ 2. 延长整个签署流程时,<font color="red">应至少有一方尚未签署</font>(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
2439
+ 3. 延长整个签署流程时,新的签署截止日期应晚于已设定的签署截止日期和当前日期。
2440
+ 4. 延长签署方截止时间时,<font color="red">签署方不能处于流程完结或已终止状态</font>(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
2441
+ 5. 延长签署方截止时间时,新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同,还需早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
2442
+ 6. <font color="red">不支持操作合同组合同</font>。
2443
+
2444
+ 合同(流程)层面截止时间子企业控制台展示的位置:
2445
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/f0f88c0eb49a926da9a86e5a6e9efa8b.png)
2317
2446
 
2318
2447
  :param request: Request instance for ModifyFlowDeadline.
2319
2448
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ModifyFlowDeadlineRequest`
@@ -2486,6 +2615,9 @@ class EssbasicClient(AbstractClient):
2486
2615
  httpProfile.setEndpoint("file.test.ess.tencent.cn");
2487
2616
  ```
2488
2617
 
2618
+ <font color="red">相关视频指引</font> <br>
2619
+ 1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
2620
+
2489
2621
  :param request: Request instance for UploadFiles.
2490
2622
  :type request: :class:`tencentcloud.essbasic.v20210526.models.UploadFilesRequest`
2491
2623
  :rtype: :class:`tencentcloud.essbasic.v20210526.models.UploadFilesResponse`