tencentcloud-sdk-python-ess 3.0.1202__tar.gz → 3.0.1206__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.1202 → tencentcloud-sdk-python-ess-3.0.1206}/PKG-INFO +1 -1
  2. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/setup.py +1 -1
  3. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud/__init__.py +1 -1
  4. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud/ess/v20201111/ess_client.py +36 -9
  5. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud/ess/v20201111/models.py +21 -7
  6. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud_sdk_python_ess.egg-info/PKG-INFO +1 -1
  7. tencentcloud-sdk-python-ess-3.0.1206/tencentcloud_sdk_python_ess.egg-info/requires.txt +1 -0
  8. tencentcloud-sdk-python-ess-3.0.1202/tencentcloud_sdk_python_ess.egg-info/requires.txt +0 -1
  9. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/README.rst +0 -0
  10. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/setup.cfg +0 -0
  11. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud/ess/__init__.py +0 -0
  12. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud/ess/v20201111/__init__.py +0 -0
  13. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud/ess/v20201111/errorcodes.py +0 -0
  14. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud_sdk_python_ess.egg-info/SOURCES.txt +0 -0
  15. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/tencentcloud_sdk_python_ess.egg-info/dependency_links.txt +0 -0
  16. {tencentcloud-sdk-python-ess-3.0.1202 → tencentcloud-sdk-python-ess-3.0.1206}/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.1202
3
+ Version: 3.0.1206
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.1202"],
11
+ install_requires=["tencentcloud-sdk-python-common==3.0.1206"],
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.1202'
17
+ __version__ = '3.0.1206'
@@ -410,11 +410,20 @@ class EssClient(AbstractClient):
410
410
 
411
411
 
412
412
  def CreateEmployeeQualificationSealQrCode(self, request):
413
- """该接口用于获取个人授权执业章给企业的二维码,需要个人用户通过微信扫码。扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
413
+ """该接口用于获取个人授权执业章给企业的微信二维码,需要个人用户通过微信扫码。
414
+
415
+ 扫描后将跳转到腾讯电子签小程序,进入到授权执业章的流程。
416
+
417
+ 个人用户授权成功后,企业印章管理员需对印章进行审核,审核通过后,即可使用个人授权的执业章进行盖章操作。
418
+
414
419
 
415
420
  **注意**
416
421
  1. 该二维码**有效期为7天**,过期后将失效,可重新创建。
417
422
 
423
+ 整体流程入下图
424
+
425
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/21b6b56dbc796c9d6f402d6ce6febb07.png)
426
+
418
427
  :param request: Request instance for CreateEmployeeQualificationSealQrCode.
419
428
  :type request: :class:`tencentcloud.ess.v20201111.models.CreateEmployeeQualificationSealQrCodeRequest`
420
429
  :rtype: :class:`tencentcloud.ess.v20201111.models.CreateEmployeeQualificationSealQrCodeResponse`
@@ -529,8 +538,11 @@ class EssClient(AbstractClient):
529
538
  当通过模板或文件发起合同时, 签署人不制定, 等合同发起后再指定 可以用下面2种方案
530
539
 
531
540
  <b><font color="red">1. 或签合同</font>: 若未指定企业签署人信息(只指定企业的名字),合同变成或签合同(个人签署方不支持或签合同)</b>。需调用此接口补充或添加签署人。或签签署人在控制台上的展示样式如下(会带有<b>或签</b>标识):
541
+
532
542
  ![image](https://qcloudimg.tencent-cloud.cn/raw/b2715f0236faee807cfc0521f93cf01b.png)
533
- <b><font color="red">2. 动态签署人合同</font>: 若未指定具体签署人的信息,则合同变成动态签署人合同</b>。需调用此接口补充或添加签署人。可以参考文档 [动态签署人合同](https://qian.tencent.com/developers/company/dynamic_signer/) 。动态签署人在控制台上的展示样式如下:
543
+
544
+ <b><font color="red">2. 动态签署人合同</font>: 若未指定具体签署人的信息,则合同变成动态签署人合同</b>。需调用此接口补充或添加签署人。可以参考文档 [动态签署人合同](https://qian.tencent.com/developers/company/dynamic_signer/) 。动态签署人在控制台上的展示样式如下:
545
+
534
546
  ![image](https://qcloudimg.tencent-cloud.cn/raw/2729477978e020c3bbb4d2e767bb78eb.png)
535
547
 
536
548
  实际签署人需要通过[获取跳转至腾讯电子签小程序的签署链接](https://qian.tencent.com/developers/companyApis/startFlows/CreateSchemeUrl/)生成的链接进入小程序,领取合同并签署。同一签署环节可补充多个员工作为或签署人,最终实际签署人取决于谁先领取合同完成签署。
@@ -834,7 +846,7 @@ class EssClient(AbstractClient):
834
846
  <li>CreateFlowGroupByFiles</li>
835
847
  <li>CreatePrepareFlow</li>
836
848
  </ul>
837
- 发起签署流程时,通过指定NeedSignReview为true,则可以调用此接口,并指定operate=SignReview,以提交企业内部签署审批结果</li>
849
+ 发起签署流程时,通过指定NeedSignReview为true,则可以调用此接口,并指定operate=SignReview,以提交企业内部签署审批结果(<font color="red">审核对象:本企业合同参与方的签署动作</font>)</li>
838
850
  <li>在通过接口
839
851
  <ul>
840
852
  <li>CreateFlowByFiles</li>
@@ -842,14 +854,23 @@ class EssClient(AbstractClient):
842
854
  <li>CreateFlowGroupByTemplates</li>
843
855
  <li>CreateFlowGroupByFiles</li>
844
856
  </ul>
845
- 发起签署流程时,通过指定签署人ApproverNeedSignReview为true,则可以调用此接口,并指定operate=SignReview,并指定RecipientId,以提交企业内部签署审批结果</li>
857
+ 发起签署流程时,通过指定签署人ApproverNeedSignReview为true,则可以调用此接口,并指定operate=SignReview,并指定RecipientId,以提交企业内部签署审批结果(<font color="red">审核对象:本企业、合同企业、自然人合同参与方的签署动作</font>)</li>
846
858
  </ul>
847
859
  </li>
860
+
861
+ 对应签署人在签署页面会看到下面的提示:
862
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/3bf065bf5afa6de862e80da316be1c53.png)
863
+
848
864
  <li>发起审核
849
865
  <ul>
850
- <li>通过接口CreatePrepareFlow指定发起后需要审核,那么可以调用此接口,并指定operate=CreateReview,以提交企业内部审批结果。可以多次提交审批结果,但一旦审批通过,后续提交的结果将无效
866
+ <li>通过接口CreatePrepareFlow指定发起后需要审核,那么可以调用此接口,并指定operate=CreateReview,以提交企业内部审批结果。可以多次提交审批结果,但一旦审批通过,后续提交的结果将无效(<font color="red">审核对象:本企业合同发起方的发起动作</font>)
851
867
  </li>
852
868
  </ul>
869
+
870
+ 对应发起人在发起合同的最后环节会有<b>提交审批</b>的按钮:
871
+
872
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/cb4857b7b57302fdcbcf37dad31214a8.png)
873
+
853
874
  </li>
854
875
  </ul>
855
876
 
@@ -1021,13 +1042,15 @@ class EssClient(AbstractClient):
1021
1042
 
1022
1043
 
1023
1044
  def CreateIntegrationSubOrganizationActiveRecord(self, request):
1024
- """通过此接口,创建子企业激活记录,集团企业管理员可针对未激活的成员企业进行激活。
1025
- 激活子企业时请保证子企业 lisence 充足。
1045
+ """使用此接口,可创建子企业激活记录。<font color="red">集团企业管理员</font>可以针对尚未激活的成员企业进行激活操作。
1046
+
1047
+
1026
1048
  这个操作与页面端激活成员企业操作类似
1027
1049
  ![image](https://qcloudimg.tencent-cloud.cn/raw/c4e76fbac92e4ce451a03601c964793b.png)
1028
1050
 
1029
- p.s.
1030
- 此接口只能用于激活,不能用于续期。
1051
+ 注意:
1052
+ 1. 此接口只能用于激活,**不能用于续期**。
1053
+ 2. 在激活子企业时,**请确保子企业的许可证数量充足**。
1031
1054
 
1032
1055
  :param request: Request instance for CreateIntegrationSubOrganizationActiveRecord.
1033
1056
  :type request: :class:`tencentcloud.ess.v20201111.models.CreateIntegrationSubOrganizationActiveRecordRequest`
@@ -2766,6 +2789,10 @@ class EssClient(AbstractClient):
2766
2789
  def VerifyPdf(self, request):
2767
2790
  """对合同流程文件进行数字签名验证,判断数字签名是否有效,合同文件内容是否被篡改。
2768
2791
 
2792
+
2793
+ **补充**: 可以到控制台[合同验签](https://qian.tencent.com/verifySign)体验验签功能,界面如下
2794
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/81c333ccb07f0c5fbaf840d9cee61333.png)
2795
+
2769
2796
  :param request: Request instance for VerifyPdf.
2770
2797
  :type request: :class:`tencentcloud.ess.v20201111.models.VerifyPdfRequest`
2771
2798
  :rtype: :class:`tencentcloud.ess.v20201111.models.VerifyPdfResponse`
@@ -300,13 +300,18 @@ 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>
304
+ <li>**5**:设备指纹识别,需要对比手机机主预留的指纹信息,校验一致才能成功进行合同签署。(iOS系统暂不支持该校验方式)</li>
305
+ <li>**6**:设备面容识别,需要对比手机机主预留的人脸信息,校验一致才能成功进行合同签署。(Android系统暂不支持该校验方式)</li></ul>
304
306
 
305
- 默认为1(人脸认证 ),2(签署密码),3(运营商三要素)
307
+
308
+ 默认为1(人脸认证 ),2(签署密码),3(运营商三要素),5(设备指纹识别),6(设备面容识别)
306
309
 
307
310
  注:
308
311
  1. 用<font color='red'>模板创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color='red'>在创建合同重新指定无效</font>
309
- 3. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/company/mobile_support)得到具体的支持说明
312
+ 2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/company/mobile_support)得到具体的支持说明
313
+ 3. 校验方式不允许只包含<font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>,至少需要再增加一种其他校验方式。
314
+ 4. <font color='red'>设备指纹识别</font>和<font color='red'>设备面容识别</font>只支持小程序使用,其他端暂不支持。
310
315
  :type ApproverSignTypes: list of int
311
316
  :param _ApproverNeedSignReview: 发起方企业的签署人进行签署操作前,是否需要企业内部走审批流程,取值如下:
312
317
  <ul><li>**false**:(默认)不需要审批,直接签署。</li>
@@ -3885,7 +3890,9 @@ class CreateEmployeeQualificationSealQrCodeRequest(AbstractModel):
3885
3890
  :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
3886
3891
  :param _Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中,需设置此参数。在此情境下,ProxyOrganizationId(子企业的组织ID)为必填项。
3887
3892
  :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
3888
- :param _HintText: 提示信息,扫码后此信息会展示给扫描用户,用来提示用户授权操作的目的
3893
+ :param _HintText: 提示信息,扫码后此信息会展示给扫描用户,用来提示用户授权操作的目的,会在授权界面下面的位置展示。
3894
+
3895
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/8436ffd78c20605e6b133ff4bc4d2ac7.png)
3889
3896
  :type HintText: str
3890
3897
  """
3891
3898
  self._Operator = None
@@ -16988,10 +16995,15 @@ class FlowCreateApprover(AbstractModel):
16988
16995
  :param _ApproverSignTypes: 您可以指定签署方签署合同的认证校验方式,可传递以下值:
16989
16996
  <ul><li>**1**:人脸认证,需进行人脸识别成功后才能签署合同;</li>
16990
16997
  <li>**2**:签署密码,需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署;</li>
16991
- <li>**3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。(如果是港澳台客户,建议不要选择这个)</li></ul>
16998
+ <li>**3**:运营商三要素,需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。(如果是港澳台客户,建议不要选择这个)</li>
16999
+ <li>**5**:设备指纹识别,需要对比手机机主预留的指纹信息,校验一致才能成功进行合同签署。(iOS系统暂不支持该校验方式)</li>
17000
+ <li>**6**:设备面容识别,需要对比手机机主预留的人脸信息,校验一致才能成功进行合同签署。(Android系统暂不支持该校验方式)</li></ul>
17001
+
16992
17002
  注:
16993
17003
  <ul><li>默认情况下,认证校验方式为人脸认证和签署密码两种形式;</li>
16994
- <li>您可以传递多种值,表示可用多种认证校验方式。</li></ul>
17004
+ <li>您可以传递多种值,表示可用多种认证校验方式。</li>
17005
+ <li>校验方式不允许只包含设备指纹识别和设备面容识别,至少需要再增加一种其他校验方式。</li>
17006
+ <li>设备指纹识别和设备面容识别只支持小程序使用,其他端暂不支持。</li></ul>
16995
17007
 
16996
17008
  注:
16997
17009
  `此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主`
@@ -20888,7 +20900,9 @@ WECHAT-微信通知
20888
20900
  <ul><li> 1 :人脸认证</li>
20889
20901
  <li> 2 :签署密码</li>
20890
20902
  <li> 3 :运营商三要素认证</li>
20891
- <li> 4 :UKey认证</li></ul>
20903
+ <li> 4 :UKey认证</li>
20904
+ <li> 5 :设备指纹识别</li>
20905
+ <li> 6 :设备面容识别</li></ul>
20892
20906
  :type ApproverSignTypes: list of int
20893
20907
  """
20894
20908
  self._RecipientId = None
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 1.1
2
2
  Name: tencentcloud-sdk-python-ess
3
- Version: 3.0.1202
3
+ Version: 3.0.1206
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.1206
@@ -1 +0,0 @@
1
- tencentcloud-sdk-python-common==3.0.1202