tencentcloud-sdk-python-ess 3.0.1192__tar.gz → 3.0.1204__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 (16) hide show
  1. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/PKG-INFO +1 -1
  2. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/setup.py +1 -1
  3. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud/__init__.py +1 -1
  4. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud/ess/v20201111/ess_client.py +112 -29
  5. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud/ess/v20201111/models.py +176 -23
  6. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud_sdk_python_ess.egg-info/PKG-INFO +1 -1
  7. tencentcloud-sdk-python-ess-3.0.1204/tencentcloud_sdk_python_ess.egg-info/requires.txt +1 -0
  8. tencentcloud-sdk-python-ess-3.0.1192/tencentcloud_sdk_python_ess.egg-info/requires.txt +0 -1
  9. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/README.rst +0 -0
  10. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/setup.cfg +0 -0
  11. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud/ess/__init__.py +0 -0
  12. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud/ess/v20201111/__init__.py +0 -0
  13. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud/ess/v20201111/errorcodes.py +0 -0
  14. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud_sdk_python_ess.egg-info/SOURCES.txt +0 -0
  15. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud_sdk_python_ess.egg-info/dependency_links.txt +0 -0
  16. {tencentcloud-sdk-python-ess-3.0.1192 → tencentcloud-sdk-python-ess-3.0.1204}/tencentcloud_sdk_python_ess.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 1.1
2
2
  Name: tencentcloud-sdk-python-ess
3
- Version: 3.0.1192
3
+ Version: 3.0.1204
4
4
  Summary: Tencent Cloud Ess 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-ess',
11
- install_requires=["tencentcloud-sdk-python-common==3.0.1192"],
11
+ install_requires=["tencentcloud-sdk-python-common==3.0.1204"],
12
12
  version=tencentcloud.__version__,
13
13
  description='Tencent Cloud Ess 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.1192'
17
+ __version__ = '3.0.1204'
@@ -376,14 +376,18 @@ class EssClient(AbstractClient):
376
376
 
377
377
 
378
378
  def CreateEmbedWebUrl(self, request):
379
- """本接口(CreateEmbedWebUrl)用于创建嵌入Web的链接,支持以下类型的Web链接创建:
379
+ """本接口(CreateEmbedWebUrl)用于创建可嵌入web页面的URL(此web页面可以通过iframe方式嵌入到贵方系统的网页中),支持以下类型的Web链接创建:
380
380
  1. 创建印章
381
381
  2. 创建模板
382
382
  3. 修改模板
383
383
  4. 预览模板
384
384
  5. 预览合同流程
385
385
 
386
- 用户可以通过这些链接快速将其集成到自己的系统中。
386
+ 预览模板的嵌入页面长相如下:
387
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/57bdda4a884e3f5b2de12d5a282a3651.png)
388
+
389
+ 预览合同流程的嵌入页面长相如下:
390
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/dc7af994e2f6da56bdad5975e927de34.png)
387
391
 
388
392
  :param request: Request instance for CreateEmbedWebUrl.
389
393
  :type request: :class:`tencentcloud.ess.v20201111.models.CreateEmbedWebUrlRequest`
@@ -406,11 +410,20 @@ class EssClient(AbstractClient):
406
410
 
407
411
 
408
412
  def CreateEmployeeQualificationSealQrCode(self, request):
409
- """该接口用于获取个人授权执业章给企业的二维码,需要个人用户通过微信扫码。扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
413
+ """该接口用于获取个人授权执业章给企业的微信二维码,需要个人用户通过微信扫码。
414
+
415
+ 扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
416
+
417
+ 个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
418
+
410
419
 
411
420
  **注意**
412
421
  1. 该二维码**有效期为7天**,过期后将失效,可重新创建。
413
422
 
423
+ 整体流程入下图
424
+
425
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/21b6b56dbc796c9d6f402d6ce6febb07.png)
426
+
414
427
  :param request: Request instance for CreateEmployeeQualificationSealQrCode.
415
428
  :type request: :class:`tencentcloud.ess.v20201111.models.CreateEmployeeQualificationSealQrCodeRequest`
416
429
  :rtype: :class:`tencentcloud.ess.v20201111.models.CreateEmployeeQualificationSealQrCodeResponse`
@@ -520,14 +533,35 @@ class EssClient(AbstractClient):
520
533
 
521
534
 
522
535
  def CreateFlowApprovers(self, request):
523
- """适用场景: 当通过模板或文件发起合同时,若未指定企业签署人信息,则可调用此接口补充或添加签署人。同一签署人可补充多个员工作为或签署人,最终实际签署人取决于谁先领取合同完成签署。
536
+ """**适用场景 :**
537
+
538
+ 当通过模板或文件发起合同时, 签署人不制定, 等合同发起后再指定 可以用下面2种方案
524
539
 
525
- 限制条件:
540
+ <b><font color="red">1. 或签合同</font>: 若未指定企业签署人信息(只指定企业的名字),合同变成或签合同(个人签署方不支持或签合同)</b>。需调用此接口补充或添加签署人。或签签署人在控制台上的展示样式如下(会带有<b>或签</b>标识):
541
+
542
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/b2715f0236faee807cfc0521f93cf01b.png)
543
+
544
+ <b><font color="red">2. 动态签署人合同</font>: 若未指定具体签署人的信息,则合同变成动态签署人合同</b>。需调用此接口补充或添加签署人。可以参考文档 [动态签署人合同](https://qian.tencent.com/developers/company/dynamic_signer/) 。动态签署人在控制台上的展示样式如下:
545
+
546
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/2729477978e020c3bbb4d2e767bb78eb.png)
547
+
548
+ 实际签署人需要通过[获取跳转至腾讯电子签小程序的签署链接](https://qian.tencent.com/developers/companyApis/startFlows/CreateSchemeUrl/)生成的链接进入小程序,领取合同并签署。同一签署环节可补充多个员工作为或签署人,最终实际签署人取决于谁先领取合同完成签署。
549
+
550
+
551
+ **限制条件**:
526
552
 
527
553
  1.本企业(发起方企业)企业微信签署人仅支持通过企业微信UserId或姓名+手机号进行补充。
554
+
528
555
  2.本企业(发起方企业)非企业微信签署人仅支持通过姓名+手机号进行补充。
556
+
529
557
  3.他方企业仅支持通过姓名+手机号进行补充。
530
- 4.个人签署人支持通过姓名+手机号进行补充,补充动态签署人时:若个人用户已完成实名,则可通过姓名+证件号码进行补充。
558
+
559
+ 4.个人签署人支持通过姓名+手机号进行补充(若<b>个人用户已完成实名</b>,动态签署人合同也可以可通过姓名+证件号码进行补充)
560
+
561
+
562
+ **整体流程如下图:**
563
+
564
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/29a0fba0ceebf9227849459947384862.png)
531
565
 
532
566
  :param request: Request instance for CreateFlowApprovers.
533
567
  :type request: :class:`tencentcloud.ess.v20201111.models.CreateFlowApproversRequest`
@@ -999,13 +1033,15 @@ class EssClient(AbstractClient):
999
1033
 
1000
1034
 
1001
1035
  def CreateIntegrationSubOrganizationActiveRecord(self, request):
1002
- """通过此接口,创建子企业激活记录,集团企业管理员可针对未激活的成员企业进行激活。
1003
- 激活子企业时请保证子企业 lisence 充足。
1036
+ """使用此接口,可创建子企业激活记录。<font color="red">集团企业管理员</font>可以针对尚未激活的成员企业进行激活操作。
1037
+
1038
+
1004
1039
  这个操作与页面端激活成员企业操作类似
1005
1040
  ![image](https://qcloudimg.tencent-cloud.cn/raw/c4e76fbac92e4ce451a03601c964793b.png)
1006
1041
 
1007
- p.s.
1008
- 此接口只能用于激活,不能用于续期。
1042
+ 注意:
1043
+ 1. 此接口只能用于激活,**不能用于续期**。
1044
+ 2. 在激活子企业时,**请确保子企业的许可证数量充足**。
1009
1045
 
1010
1046
  :param request: Request instance for CreateIntegrationSubOrganizationActiveRecord.
1011
1047
  :type request: :class:`tencentcloud.ess.v20201111.models.CreateIntegrationSubOrganizationActiveRecordRequest`
@@ -1148,11 +1184,17 @@ class EssClient(AbstractClient):
1148
1184
 
1149
1185
  def CreateOrganizationBatchSignUrl(self, request):
1150
1186
  """使用此接口,您可以创建企业批量签署链接,员工只需点击链接即可跳转至控制台进行批量签署。<br/>
1151
- 附注:
1152
- - 员工必须需作为批量签署合同的签署方,or或签合同的候选人之一。
1153
- - 对于本方企业:如有UserId,应以UserId为主要标识;如果没有UserId,则必须填写Name和Mobile信息。
1154
- - 若要生成他发企业签署链接:应传RecipientIds,且制定的合同必须是接口调用方发起的。
1155
- - 支持待签署、待填写状态的合同生成签署链接。
1187
+
1188
+ 注:
1189
+ <ul>
1190
+ <li>员工必须需作为批量签署合同的签署方,或者是或签合同的候选人之一。</li>
1191
+ <li><b>本方企业签署链接</b>:如有UserId,应以UserId为主要标识;如果没有UserId,则必须填写Name和Mobile信息。</li>
1192
+ <li><b>他方企业签署链接</b>:传RecipientIds,且必须是合同发起方调用此接口。打开链接后需要他方签署人登录电子签系统。(<b>如果签署人没有加入对方企业则会引导加入;如果对方企业还没有注册认证,会引导企业注册和认证</b>)</li>
1193
+ <li>只支持待签署、待填写状态的合同生成签署链接。</li>
1194
+ </ul>
1195
+
1196
+ 签署的嵌入页面长相如下:
1197
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/a4754bc835a3f837ddec1e28b02ed9c0.png)
1156
1198
 
1157
1199
  :param request: Request instance for CreateOrganizationBatchSignUrl.
1158
1200
  :type request: :class:`tencentcloud.ess.v20201111.models.CreateOrganizationBatchSignUrlRequest`
@@ -1254,6 +1296,37 @@ class EssClient(AbstractClient):
1254
1296
  raise TencentCloudSDKException(type(e).__name__, str(e))
1255
1297
 
1256
1298
 
1299
+ def CreatePartnerAutoSignAuthUrl(self, request):
1300
+ """创建他方自动签授权链接(他方授权/我方授权),通过该链接可进入小程序进行合作方企业的自动签授权,若授权企业未开通企业自动签,通过该链接会先引导开通本企业自动签。
1301
+ 该接口效果同控制台: 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权
1302
+
1303
+
1304
+
1305
+ 注:
1306
+ 1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Operator.UserId 需要传递超管或者法人的UserId)
1307
+ 2. 已经在授权中或者授权成功的企业,无法重复授权
1308
+ 3. 授权企业和被授权企业必须都是已认证企业
1309
+
1310
+ :param request: Request instance for CreatePartnerAutoSignAuthUrl.
1311
+ :type request: :class:`tencentcloud.ess.v20201111.models.CreatePartnerAutoSignAuthUrlRequest`
1312
+ :rtype: :class:`tencentcloud.ess.v20201111.models.CreatePartnerAutoSignAuthUrlResponse`
1313
+
1314
+ """
1315
+ try:
1316
+ params = request._serialize()
1317
+ headers = request.headers
1318
+ body = self.call("CreatePartnerAutoSignAuthUrl", params, headers=headers)
1319
+ response = json.loads(body)
1320
+ model = models.CreatePartnerAutoSignAuthUrlResponse()
1321
+ model._deserialize(response["Response"])
1322
+ return model
1323
+ except Exception as e:
1324
+ if isinstance(e, TencentCloudSDKException):
1325
+ raise
1326
+ else:
1327
+ raise TencentCloudSDKException(type(e).__name__, str(e))
1328
+
1329
+
1257
1330
  def CreatePersonAuthCertificateImage(self, request):
1258
1331
  """获取个人用户认证证书图片下载URL
1259
1332
 
@@ -1288,9 +1361,12 @@ class EssClient(AbstractClient):
1288
1361
 
1289
1362
 
1290
1363
  def CreatePrepareFlow(self, request):
1291
- """创建发起流程web页面
1292
- <br/>适用场景:通过该接口(CreatePrepareFlow)传入合同文件/模板编号及签署人信息,可获得发起流程的可嵌入页面,在页面完成签署控件等信息的编辑与确认后,快速发起流程。
1293
- <br/>注:该接口包含模板/文件发起流程的全部功能,调用接口后不会立即发起,需在可嵌入页面点击按钮进行发起流程。
1364
+ """创建发起流程Web页面,通过该接口可以获取发起流程的可嵌入web页面的URL(此web页面可以通过iframe方式嵌入到贵方系统的网页中)。在页面上完成签署控件等信息的编辑与确认后,可快速发起流程。
1365
+
1366
+ <br/>注意:调用接口后,<font color="red">流程不会立即发起,需在嵌入页面上点击【发起合同】按钮来发起流程</font>。
1367
+
1368
+ 嵌入页面长相如下:
1369
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/b2ae013fb4d747891dd3815bbe897208.png)
1294
1370
 
1295
1371
  :param request: Request instance for CreatePrepareFlow.
1296
1372
  :type request: :class:`tencentcloud.ess.v20201111.models.CreatePrepareFlowRequest`
@@ -2435,17 +2511,20 @@ class EssClient(AbstractClient):
2435
2511
 
2436
2512
 
2437
2513
  def ModifyFlowDeadline(self, request):
2438
- """在已发起的签署流程中,支持对签署截止日期进行延期操作,主要涉及以下两个维度:
2439
- 1. 合同(流程)维度:只需要传递签署流程ID。这将对签署流程和发起时未单独设定签署截止时间的签署人进行延期操作。
2440
- 2. 签署人维度:需要传递流程ID和签署人ID。此操作将对签署人进行延期操作,尤其对于有序的合同(流程),签署截止时间不能超过后一位合同(流程)签署人的流程截止时间。
2441
-
2442
- 此接口有如下限制条件:
2443
- 1. 执行操作的员工需为发起方企业的超级管理员、法定代表人或签署流程的发起人。
2444
- 2. 在延长整个签署流程时,签署流程应至少还有一方未签署(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态)。
2445
- 3. 在延长整个签署流程时,新的签署截止日期应晚于合同已设定的签署截止日期和当前日期。
2446
- 4. 在延长签署方的截止时间时,签署方不能处于流程完结或已终止状态(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
2447
- 5. 在延长签署方的截止时间时,签署方的新签署截止日期应晚于当前日期和签署方已设定的截止日期。若为有序合同,还应早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
2448
- 6. 不支持操作合同组合同。
2514
+ """在已启动的签署流程中,可对签署截止日期进行延期操作,主要分为以下两个层面:
2515
+ 1. <b> 合同(流程)层面</b>:仅需提供签署流程ID。此操作将对整个签署流程以及未单独设置签署截止时间的签署人进行延期。
2516
+ 2. <b> 签署人层面</b> :需提供流程ID和签署人ID。此操作针对特定签署人进行延期,特别是对于有序合同(流程),签署截止时间不得超过后续签署人的流程截止时间。
2517
+
2518
+ 此接口存在以下限制:
2519
+ 1. 执行操作的员工须为<font color="red">发起方企业的超级管理员、法定代表人或签署流程发起人</font>。
2520
+ 2. 延长整个签署流程时,<font color="red">应至少有一方尚未签署</font>(即签署流程不能处于已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
2521
+ 3. 延长整个签署流程时,新的签署截止日期应晚于已设定的签署截止日期和当前日期。
2522
+ 4. 延长签署方截止时间时,<font color="red">签署方不能处于流程完结或已终止状态</font>(即签署人不能处于已签署、已拒签、已过期、已撤回、拒绝填写、已解除等状态)。
2523
+ 5. 延长签署方截止时间时,新的签署截止日期应晚于当前日期和已设定的截止日期。若为有序合同,还需早于或等于下一签署人的截止日期,且早于签署流程整体的截止日期。
2524
+ 6. <font color="red">不支持操作合同组合同</font>。
2525
+
2526
+ 合同(流程)层面 截止时间控制台展示的位置:
2527
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/265b130136bf6e8f01f5880438467dfb.png)
2449
2528
 
2450
2529
  :param request: Request instance for ModifyFlowDeadline.
2451
2530
  :type request: :class:`tencentcloud.ess.v20201111.models.ModifyFlowDeadlineRequest`
@@ -2701,6 +2780,10 @@ class EssClient(AbstractClient):
2701
2780
  def VerifyPdf(self, request):
2702
2781
  """对合同流程文件进行数字签名验证,判断数字签名是否有效,合同文件内容是否被篡改。
2703
2782
 
2783
+
2784
+ **补充**: 可以到控制台[合同验签](https://qian.tencent.com/verifySign)体验验签功能,界面如下
2785
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/81c333ccb07f0c5fbaf840d9cee61333.png)
2786
+
2704
2787
  :param request: Request instance for VerifyPdf.
2705
2788
  :type request: :class:`tencentcloud.ess.v20201111.models.VerifyPdfRequest`
2706
2789
  :rtype: :class:`tencentcloud.ess.v20201111.models.VerifyPdfResponse`
@@ -300,7 +300,7 @@ class ApproverInfo(AbstractModel):
300
300
  :param _ApproverSignTypes: 您可以指定签署方签署合同的认证校验方式,可传递以下值:
301
301
  <ul><li>**1**:人脸认证,需进行人脸识别成功后才能签署合同;</li>
302
302
  <li>**2**:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;</li>
303
- <li>**3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。</li></ul>
303
+ <li>**3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。(如果是港澳台客户,建议不要选择这个)</li></ul>
304
304
 
305
305
  默认为1(人脸认证 ),2(签署密码),3(运营商三要素)
306
306
 
@@ -3716,7 +3716,7 @@ class CreateEmbedWebUrlRequest(AbstractModel):
3716
3716
  def __init__(self):
3717
3717
  r"""
3718
3718
  :param _Operator: 执行本接口操作的员工信息。
3719
- <br/>注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。
3719
+ <br/>注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
3720
3720
  :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
3721
3721
  :param _EmbedType: WEB嵌入资源类型,支持以下类型
3722
3722
  <ul><li>CREATE_SEAL: 生成创建印章的嵌入页面</li>
@@ -3742,17 +3742,7 @@ class CreateEmbedWebUrlRequest(AbstractModel):
3742
3742
  :type Reviewer: :class:`tencentcloud.ess.v20201111.models.ReviewerInfo`
3743
3743
  :param _Option: 个性化参数,用于控制页面展示内容
3744
3744
  :type Option: :class:`tencentcloud.ess.v20201111.models.EmbedUrlOption`
3745
- :param _UserData: 用户自定义参数
3746
- <ul>
3747
- <li>目前仅支持EmbedType=CREATE_TEMPLATE时传入</li>
3748
- <li>指定后,创建,编辑,删除模板时,回调都会携带该userData</li>
3749
- <li>支持的格式:json字符串的BASE64编码字符串</li>
3750
- <li>示例:<ul>
3751
- <li>json字符串:{"ComeFrom":"xxx"},BASE64编码:eyJDb21lRnJvbSI6Inh4eCJ9</li>
3752
- <li>eyJDb21lRnJvbSI6Inh4eCJ9,为符合要求的userData数据格式</li>
3753
- </ul>
3754
- </li>
3755
- </ul>
3745
+ :param _UserData: <ul> <li>目前仅支持EmbedType=CREATE_TEMPLATE时传入</li> <li>指定后,创建,编辑,删除模板时,回调都会携带该userData</li> <li>支持的格式:json字符串的BASE64编码字符串</li> <li>示例:<ul> <li>json字符串:{"ComeFrom":"xxx"},BASE64编码:eyJDb21lRnJvbSI6Inh4eCJ9</li> <li>eyJDb21lRnJvbSI6Inh4eCJ9,为符合要求的userData数据格式</li> </ul> </li> </ul>
3756
3746
  :type UserData: str
3757
3747
  """
3758
3748
  self._Operator = None
@@ -3895,7 +3885,9 @@ class CreateEmployeeQualificationSealQrCodeRequest(AbstractModel):
3895
3885
  :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
3896
3886
  :param _Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
3897
3887
  :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
3898
- :param _HintText: 提示信息,扫码后此信息会展示给扫描用户,用来提示用户授权操作的目的
3888
+ :param _HintText: 提示信息,扫码后此信息会展示给扫描用户,用来提示用户授权操作的目的,会在授权界面下面的位置展示。
3889
+
3890
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/8436ffd78c20605e6b133ff4bc4d2ac7.png)
3899
3891
  :type HintText: str
3900
3892
  """
3901
3893
  self._Operator = None
@@ -4095,11 +4087,9 @@ class CreateFlowApproversRequest(AbstractModel):
4095
4087
  :param _Operator: 执行本接口操作的员工信息。
4096
4088
  注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
4097
4089
  :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
4098
- :param _Approvers: 补充企业签署人信息。
4090
+ :param _Approvers: 补充签署环节签署候选人信息。
4099
4091
 
4100
- - 如果发起方指定的补充签署人是企业微信签署人(ApproverSource=WEWORKAPP),则需要提供企业微信UserId进行补充;
4101
-
4102
- - 如果不指定,则使用姓名和手机号进行补充。
4092
+ 注:` 如果发起方指定的补充签署人是企业微信签署人(ApproverSource=WEWORKAPP),则需要提供企业微信UserId进行补充; 如果不指定,则使用姓名和手机号进行补充。`
4103
4093
  :type Approvers: list of FillApproverInfo
4104
4094
  :param _FlowId: 合同流程ID,为32位字符串。
4105
4095
  建议开发者妥善保存此流程ID,以便于顺利进行后续操作。
@@ -4107,9 +4097,9 @@ class CreateFlowApproversRequest(AbstractModel):
4107
4097
  :type FlowId: str
4108
4098
  :param _FillApproverType: 签署人信息补充方式
4109
4099
 
4110
- <ul><li>**0**: 添加或签人候选人,或签支持一个节点传多个签署人,不传值默认或签。
4100
+ <ul><li>**0**: <font color="red">或签合同</font>添加签署候选人,或签支持一个节点传多个签署人,不传值默认或签。
4111
4101
  注: `或签只支持企业签署方`</li>
4112
- <li>**1**: 表示往未指定签署人的节点,添加一个明确的签署人,支持企业或个人签署方。</li></ul>
4102
+ <li>**1**: <font color="red">动态签署人合同</font>的添加签署候选人,支持企业或个人签署方。</li></ul>
4113
4103
  :type FillApproverType: int
4114
4104
  :param _Initiator: 在可定制的企业微信通知中,发起人可以根据具体需求进行自定义设置。
4115
4105
  :type Initiator: str
@@ -7874,8 +7864,11 @@ class CreateOrganizationBatchSignUrlRequest(AbstractModel):
7874
7864
  :param _UserId: 员工在腾讯电子签平台的独特身份标识,为32位字符串。
7875
7865
  您可登录腾讯电子签控制台,在 "更多能力"->"组织管理" 中查阅某位员工的UserId(在页面中显示为用户ID)。
7876
7866
  UserId必须是传入合同(FlowId)中的签署人。
7877
- - 1. 若UserId为空,Name和Mobile 必须提供。
7878
- - 2. 若UserId 与 Name,Mobile均存在,将优先采用UserId对应的员工。
7867
+
7868
+ <ul>
7869
+ <li>1. 若UserId为空,Name和Mobile 必须提供。</li>
7870
+ <li>2. 若UserId 与 Name,Mobile均存在,将优先采用UserId对应的员工。</li>
7871
+ </ul>
7879
7872
  :type UserId: str
7880
7873
  :param _Name: 员工姓名,必须与手机号码一起使用。
7881
7874
  如果UserId为空,则此字段不能为空。同时,姓名和手机号码必须与传入合同(FlowId)中的签署人信息一致。
@@ -8268,6 +8261,166 @@ class CreateOrganizationInfoChangeUrlResponse(AbstractModel):
8268
8261
  self._RequestId = params.get("RequestId")
8269
8262
 
8270
8263
 
8264
+ class CreatePartnerAutoSignAuthUrlRequest(AbstractModel):
8265
+ """CreatePartnerAutoSignAuthUrl请求参数结构体
8266
+
8267
+ """
8268
+
8269
+ def __init__(self):
8270
+ r"""
8271
+ :param _Agent: 代理企业和员工的信息。<br/>在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
8272
+ :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
8273
+ :param _Operator: 执行本接口操作的员工信息。<br/>注: `在调用此接口时,请确保指定的员工已获得所需的接口调用权限,并具备接口传入的相应资源的数据权限。`
8274
+ :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
8275
+ :param _AuthorizedOrganizationId: 被授企业id/授权方企业id,和AuthorizedOrganizationName二选一传入
8276
+ :type AuthorizedOrganizationId: str
8277
+ :param _AuthorizedOrganizationName: 被授企业名称/授权方企业名称,和AuthorizedOrganizationId二选一传入
8278
+ :type AuthorizedOrganizationName: str
8279
+ :param _SealTypes: 指定印章类型,指定后只能选择该类型的印章进行授权支持以下印章类型:- OFFICIAL : 企业公章- CONTRACT : 合同专用章- FINANCE : 财务专用章- PERSONNEL : 人事专用章
8280
+ :type SealTypes: list of str
8281
+ :param _AuthToMe: 他方授权给我方:
8282
+ - false:我方授权他方,AuthorizedOrganizationName代表【被授权方】企业名称
8283
+ - true:他方授权我方,AuthorizedOrganizationName代表【授权方】企业名称
8284
+ :type AuthToMe: bool
8285
+ """
8286
+ self._Agent = None
8287
+ self._Operator = None
8288
+ self._AuthorizedOrganizationId = None
8289
+ self._AuthorizedOrganizationName = None
8290
+ self._SealTypes = None
8291
+ self._AuthToMe = None
8292
+
8293
+ @property
8294
+ def Agent(self):
8295
+ return self._Agent
8296
+
8297
+ @Agent.setter
8298
+ def Agent(self, Agent):
8299
+ self._Agent = Agent
8300
+
8301
+ @property
8302
+ def Operator(self):
8303
+ return self._Operator
8304
+
8305
+ @Operator.setter
8306
+ def Operator(self, Operator):
8307
+ self._Operator = Operator
8308
+
8309
+ @property
8310
+ def AuthorizedOrganizationId(self):
8311
+ return self._AuthorizedOrganizationId
8312
+
8313
+ @AuthorizedOrganizationId.setter
8314
+ def AuthorizedOrganizationId(self, AuthorizedOrganizationId):
8315
+ self._AuthorizedOrganizationId = AuthorizedOrganizationId
8316
+
8317
+ @property
8318
+ def AuthorizedOrganizationName(self):
8319
+ return self._AuthorizedOrganizationName
8320
+
8321
+ @AuthorizedOrganizationName.setter
8322
+ def AuthorizedOrganizationName(self, AuthorizedOrganizationName):
8323
+ self._AuthorizedOrganizationName = AuthorizedOrganizationName
8324
+
8325
+ @property
8326
+ def SealTypes(self):
8327
+ return self._SealTypes
8328
+
8329
+ @SealTypes.setter
8330
+ def SealTypes(self, SealTypes):
8331
+ self._SealTypes = SealTypes
8332
+
8333
+ @property
8334
+ def AuthToMe(self):
8335
+ return self._AuthToMe
8336
+
8337
+ @AuthToMe.setter
8338
+ def AuthToMe(self, AuthToMe):
8339
+ self._AuthToMe = AuthToMe
8340
+
8341
+
8342
+ def _deserialize(self, params):
8343
+ if params.get("Agent") is not None:
8344
+ self._Agent = Agent()
8345
+ self._Agent._deserialize(params.get("Agent"))
8346
+ if params.get("Operator") is not None:
8347
+ self._Operator = UserInfo()
8348
+ self._Operator._deserialize(params.get("Operator"))
8349
+ self._AuthorizedOrganizationId = params.get("AuthorizedOrganizationId")
8350
+ self._AuthorizedOrganizationName = params.get("AuthorizedOrganizationName")
8351
+ self._SealTypes = params.get("SealTypes")
8352
+ self._AuthToMe = params.get("AuthToMe")
8353
+ memeber_set = set(params.keys())
8354
+ for name, value in vars(self).items():
8355
+ property_name = name[1:]
8356
+ if property_name in memeber_set:
8357
+ memeber_set.remove(property_name)
8358
+ if len(memeber_set) > 0:
8359
+ warnings.warn("%s fileds are useless." % ",".join(memeber_set))
8360
+
8361
+
8362
+
8363
+ class CreatePartnerAutoSignAuthUrlResponse(AbstractModel):
8364
+ """CreatePartnerAutoSignAuthUrl返回参数结构体
8365
+
8366
+ """
8367
+
8368
+ def __init__(self):
8369
+ r"""
8370
+ :param _Url: 授权链接,以短链形式返回,短链的有效期参考回参中的 ExpiredTime。
8371
+ :type Url: str
8372
+ :param _MiniAppPath: 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
8373
+ :type MiniAppPath: str
8374
+ :param _ExpireTime: 链接过期时间以 Unix 时间戳格式表示,从生成链接时间起,往后7天有效期。过期后短链将失效,无法打开。
8375
+ :type ExpireTime: int
8376
+ :param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
8377
+ :type RequestId: str
8378
+ """
8379
+ self._Url = None
8380
+ self._MiniAppPath = None
8381
+ self._ExpireTime = None
8382
+ self._RequestId = None
8383
+
8384
+ @property
8385
+ def Url(self):
8386
+ return self._Url
8387
+
8388
+ @Url.setter
8389
+ def Url(self, Url):
8390
+ self._Url = Url
8391
+
8392
+ @property
8393
+ def MiniAppPath(self):
8394
+ return self._MiniAppPath
8395
+
8396
+ @MiniAppPath.setter
8397
+ def MiniAppPath(self, MiniAppPath):
8398
+ self._MiniAppPath = MiniAppPath
8399
+
8400
+ @property
8401
+ def ExpireTime(self):
8402
+ return self._ExpireTime
8403
+
8404
+ @ExpireTime.setter
8405
+ def ExpireTime(self, ExpireTime):
8406
+ self._ExpireTime = ExpireTime
8407
+
8408
+ @property
8409
+ def RequestId(self):
8410
+ return self._RequestId
8411
+
8412
+ @RequestId.setter
8413
+ def RequestId(self, RequestId):
8414
+ self._RequestId = RequestId
8415
+
8416
+
8417
+ def _deserialize(self, params):
8418
+ self._Url = params.get("Url")
8419
+ self._MiniAppPath = params.get("MiniAppPath")
8420
+ self._ExpireTime = params.get("ExpireTime")
8421
+ self._RequestId = params.get("RequestId")
8422
+
8423
+
8271
8424
  class CreatePersonAuthCertificateImageRequest(AbstractModel):
8272
8425
  """CreatePersonAuthCertificateImage请求参数结构体
8273
8426
 
@@ -16837,7 +16990,7 @@ class FlowCreateApprover(AbstractModel):
16837
16990
  :param _ApproverSignTypes: 您可以指定签署方签署合同的认证校验方式,可传递以下值:
16838
16991
  <ul><li>**1**:人脸认证,需进行人脸识别成功后才能签署合同;</li>
16839
16992
  <li>**2**:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;</li>
16840
- <li>**3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。</li></ul>
16993
+ <li>**3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。(如果是港澳台客户,建议不要选择这个)</li></ul>
16841
16994
  注:
16842
16995
  <ul><li>默认情况下,认证校验方式为人脸认证和签署密码两种形式;</li>
16843
16996
  <li>您可以传递多种值,表示可用多种认证校验方式。</li></ul>
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 1.1
2
2
  Name: tencentcloud-sdk-python-ess
3
- Version: 3.0.1192
3
+ Version: 3.0.1204
4
4
  Summary: Tencent Cloud Ess SDK for Python
5
5
  Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
6
6
  Author: Tencent Cloud
@@ -0,0 +1 @@
1
+ tencentcloud-sdk-python-common==3.0.1204
@@ -1 +0,0 @@
1
- tencentcloud-sdk-python-common==3.0.1192