tencentcloud-sdk-python-essbasic 3.0.1055__py2.py3-none-any.whl → 3.0.1059__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1055'
+__version__ = '3.0.1059'

tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -205,6 +205,7 @@ class EssbasicClient(AbstractClient):
         请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。
 
         注：
+        - 使用此接口生成链接，需要提前开通 `使用手机号验证签署方身份` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
         - 参与人点击链接后需短信验证码才能查看合同内容。
         - 企业用户批量签署，需要传OrganizationName（参与方所在企业名称）参数生成签署链接，`请确保此企业已完成腾讯电子签企业认证`。若为子客企业，请确保员工已经加入企业。
         - 个人批量签署，签名区`仅支持手写签名`。
@@ -248,7 +249,9 @@ class EssbasicClient(AbstractClient):
         可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
         ![image](https://qcloudimg.tencent-cloud.cn/raw/a34d0cc56ec871613e94dfc6252bc072.png)
 
-        注: `支持批量领取,  如果有一个合同流程无法领取会导致接口报错,  使得所有合同都领取失败`
+        注:
+        1. 支持批量领取,  如果有一个合同流程无法领取会导致接口报错,  使得所有合同都领取失败
+        2. 只有企业的<font color="red">超管或者法人</font>才能进行合同的领取
 
         :param request: Request instance for ChannelCreateBoundFlows.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateBoundFlowsRequest`
@@ -416,8 +419,13 @@ class EssbasicClient(AbstractClient):
 
         **注**:
         `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+
         `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
+        `3. 合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度）`
+
+        `4. 静默（自动）签署不支持合同签署方存在填写功能`
+
         :param request: Request instance for ChannelCreateFlowByFiles.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowByFilesRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowByFilesResponse`
@@ -502,6 +510,10 @@ class EssbasicClient(AbstractClient):
 
         `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
+        `3. 合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
+
+        `4. 静默（自动）签署不支持合同签署方存在填写功能`
+
         :param request: Request instance for ChannelCreateFlowGroupByFiles.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowGroupByFilesRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowGroupByFilesResponse`
@@ -583,6 +595,10 @@ class EssbasicClient(AbstractClient):
 
         `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
+        `3. 合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
+
+        `4. 静默（自动）签署不支持合同签署方存在填写功能`
+
         :param request: Request instance for ChannelCreateFlowGroupByTemplates.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowGroupByTemplatesRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowGroupByTemplatesResponse`
@@ -1634,8 +1650,13 @@ class EssbasicClient(AbstractClient):
 
         **注**:
         `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+
         `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
+        `3. 合同发起后就会扣减合同的额度, 如果未签署完成时撤销合同会返还此额度（过期，拒签，签署完成，解除完成等状态不会返还额度）`
+
+        `4. 静默（自动）签署不支持合同签署方存在填写功能`
+
         :param request: Request instance for CreateFlowsByTemplates.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowsByTemplatesRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowsByTemplatesResponse`

tencentcloud/essbasic/v20210526/models.py

@@ -1985,7 +1985,10 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
         :type JumpUrl: str
         :param _SignatureTypes: 指定批量签署合同的签名类型，可传递以下值：
 <ul><li>**0**：手写签名(默认)</li>
-<li>**1**：OCR楷体</li></ul>
+<li>**1**：OCR楷体</li>
+<li>**2**：姓名印章</li>
+<li>**3**：图片印章</li>
+<li>**4**：系统签名</li></ul>
 注：
 <ul><li>默认情况下，签名类型为手写签名</li>
 <li>您可以传递多种值，表示可用多种签名类型。</li></ul>
@@ -1998,7 +2001,7 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
 <ul><li>默认情况下，认证校验方式为人脸和密码认证</li>
 <li>您可以传递多种值，表示可用多种认证校验方式。</li></ul>
         :type ApproverSignTypes: list of int
-        :param _SignTypeSelector: 生成H5签署链接时，你可以指定签署方签署合同的认证校验方式的选择模式，可传递一下值：
+        :param _SignTypeSelector: 生成H5签署链接时，您可以指定签署方签署合同的认证校验方式的选择模式，可传递一下值：
 <ul><li>**0**：签署方自行选择，签署方可以从预先指定的认证方式中自由选择；</li>
 <li>**1**：自动按顺序首位推荐，签署方无需选择，系统会优先推荐使用第一种认证方式。</li></ul>
 注：
@@ -3071,7 +3074,7 @@ MobileCheck：手机号验证，用户手机号和参与方手机号（ApproverM
 <li> **1**：签署完成后通知</li></ul>
         :type CcNotifyType: int
         :param _AutoSignScene: 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传：
-<ul><li> **E_PRESCRIPTION_AUTO_SIGN**：处方单（医疗自动签）  </li></ul>
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN**：电子处方单（医疗自动签）  </li><li> **OTHER** :  通用场景</li></ul>
 注: `个人自动签名场景是白名单功能，使用前请与对接的客户经理联系沟通。`
         :type AutoSignScene: str
         :param _Operator: 操作者的信息，不用传
@@ -4548,12 +4551,6 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ResourceId: 资源id，与ResourceType相对应，取值范围：
-<ul>
-<li>文件Id（通过UploadFiles获取文件资源Id）</li>
-<li>模板Id</li>
-</ul>
-        :type ResourceId: str
         :param _ResourceType: 资源类型，取值有：
 <ul><li> **1**：模板</li>
 <li> **2**：文件（默认值）</li></ul>
@@ -4570,6 +4567,12 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
 </ul>
 第三方平台子客企业和员工必须已经经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
+        :param _ResourceId: 资源id，与ResourceType相对应，取值范围：
+<ul>
+<li>文件Id（通过UploadFiles获取文件资源Id）</li>
+<li>模板Id</li>
+</ul>
+        :type ResourceId: str
         :param _FlowOption: 合同流程配置信息，用于配置发起合同时定制化如是否允许修改，某些按钮的隐藏等逻辑
         :type FlowOption: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowOption`
         :param _FlowApproverList: 合同签署人信息
@@ -4584,10 +4587,10 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
         :param _Operator: 操作人（用户）信息，不用传
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
         """
-        self._ResourceId = None
         self._ResourceType = None
         self._FlowInfo = None
         self._Agent = None
+        self._ResourceId = None
         self._FlowOption = None
         self._FlowApproverList = None
         self._FlowId = None
@@ -4595,14 +4598,6 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
         self._Organization = None
         self._Operator = None
 
-    @property
-    def ResourceId(self):
-        return self._ResourceId
-
-    @ResourceId.setter
-    def ResourceId(self, ResourceId):
-        self._ResourceId = ResourceId
-
     @property
     def ResourceType(self):
         return self._ResourceType
@@ -4627,6 +4622,14 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
     def Agent(self, Agent):
         self._Agent = Agent
 
+    @property
+    def ResourceId(self):
+        return self._ResourceId
+
+    @ResourceId.setter
+    def ResourceId(self, ResourceId):
+        self._ResourceId = ResourceId
+
     @property
     def FlowOption(self):
         return self._FlowOption
@@ -4689,7 +4692,6 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
 
 
     def _deserialize(self, params):
-        self._ResourceId = params.get("ResourceId")
         self._ResourceType = params.get("ResourceType")
         if params.get("FlowInfo") is not None:
             self._FlowInfo = BaseFlowInfo()
@@ -4697,6 +4699,7 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
         if params.get("Agent") is not None:
             self._Agent = Agent()
             self._Agent._deserialize(params.get("Agent"))
+        self._ResourceId = params.get("ResourceId")
         if params.get("FlowOption") is not None:
             self._FlowOption = CreateFlowOption()
             self._FlowOption._deserialize(params.get("FlowOption"))
@@ -6898,6 +6901,14 @@ class ChannelDescribeOrganizationSealsRequest(AbstractModel):
     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 _Limit: 返回最大数量，最大为100
         :type Limit: int
@@ -6913,11 +6924,12 @@ class ChannelDescribeOrganizationSealsRequest(AbstractModel):
 
 注:  `没有输入返回所有记录，最大返回100条。`
         :type SealId: str
-        :param _SealTypes: 印章类型列表，目前支持传入以下类型：
-<ul><li>OFFICIAL-企业公章</li>
-<li>CONTRACT-合同专用章</li>
-<li>ORGANIZATION_SEAL-企业印章(图片上传创建)</li>
-<li>LEGAL_PERSON_SEAL-法定代表人章</li>
+        :param _SealTypes: 电子印章类型 , 可选类型如下: 
+<ul><li>**OFFICIAL**: (默认)公章</li>
+<li>**CONTRACT**: 合同专用章;</li>
+<li>**FINANCE**: 财务专用章;</li>
+<li>**PERSONNEL**: 人事专用章</li>
+<li>**INVOICE**: 发票专用章</li>
 </ul>
 
 注:  `为空时查询所有类型的印章。`
@@ -7622,7 +7634,7 @@ class ChannelGetTaskResultApiResponse(AbstractModel):
 <li> **ProcessFailed** : 转换失败</li>
 <li> **ProcessTimeout** : 转换文件超时</li></ul>
         :type TaskMessage: str
-        :param _ResourceId: 资源Id，也是FileId，用于文件发起时使用
+        :param _ResourceId: 资源Id（即FileId），用于[用PDF文件创建签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles)
         :type ResourceId: str
         :param _PreviewUrl: 预览文件Url，有效期30分钟 
 当前字段返回为空，发起的时候，将ResourceId 放入发起即可
@@ -8398,6 +8410,8 @@ class CommonFlowApprover(AbstractModel):
 **3** :企业/企业员工自动签（他方企业自动签署或文件发起时的本方企业自动签）
 
 注：类型为3（企业/企业员工自动签）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。
+使用自动签时，请确保企业已经开通自动签功能，开通方式：控制台 -> 企业设置 -> 扩展服务 -> 企业自动签。
+使用文件发起自动签时使用前请联系对接的客户经理沟通。
 
         :type ApproverType: int
         :param _OrganizationId: 电子签平台给企业生成的企业id
@@ -9645,9 +9659,9 @@ class CreateConsoleLoginUrlRequest(AbstractModel):
 <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
 <li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
 </ul>注:
-`1. 企业激活时,  此时的Agent.ProxyOrganizationOpenId将会是企业激活后企业的唯一标识, 建议开发者保存企业ProxyOrganizationOpenId，后续各项接口调用皆需要此参数。 `
-`2. 员工认证时,  此时的Agent.ProxyOrganizationOpenId将会是员工认证加入企业后的唯一标识, 建议开发者保存此员工的penId, 后续各项接口调用皆需要此参数。 `
-`3. 同渠道应用(Agent.AppId)下,企业唯一标识ProxyOrganizationOpenId需要保持唯一, 员工唯一标识OpenId也要保持唯一 (而不是企业下唯一)`
+`1. 企业激活时， 此时的Agent.ProxyOrganizationOpenId将会是企业激活后企业的唯一标识，建议开发者保存企业ProxyOrganizationOpenId，后续各项接口调用皆需要此参数。 `
+`2. 员工认证时， 此时的Agent.ProxyOperator.OpenId将会是员工认证加入企业后的唯一标识，建议开发者保存此员工的OpenId，后续各项接口调用皆需要此参数。 `
+`3. 同渠道应用(Agent.AppId)下，企业唯一标识ProxyOrganizationOpenId需要保持唯一，员工唯一标识OpenId也要保持唯一 (而不是企业下唯一)。 `
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _ProxyOrganizationName: 第三方平台子客企业名称，请确认该名称与企业营业执照中注册的名称一致。
 
@@ -13519,7 +13533,7 @@ class FlowApproverInfo(AbstractModel):
 
 注: `如果是用模板发起, 优先使用此处上传的, 如果不传则用模板的配置的`
         :type ApproverRoleName: str
-        :param _SignTypeSelector: 生成H5签署链接时，你可以指定签署方签署合同的认证校验方式的选择模式，可传递一下值：
+        :param _SignTypeSelector: 生成H5签署链接时，您可以指定签署方签署合同的认证校验方式的选择模式，可传递一下值：
 <ul><li>**0**：签署方自行选择，签署方可以从预先指定的认证方式中自由选择；</li>
 <li>**1**：自动按顺序首位推荐，签署方无需选择，系统会优先推荐使用第一种认证方式。</li></ul>
 注：
@@ -14410,7 +14424,7 @@ class FlowInfo(AbstractModel):
 <li> **1** : 签署完成后通知对方来查看合同</li></ul>
         :type CcNotifyType: int
         :param _AutoSignScene: 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传：
-<ul><li> **E_PRESCRIPTION_AUTO_SIGN**：处方单（医疗自动签）  </li></ul>
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN**：电子处方单（医疗自动签）  </li><li> **OTHER** :  通用场景</li></ul>
 注: `个人自动签名场景是白名单功能，使用前请与对接的客户经理联系沟通。`
         :type AutoSignScene: str
         """
@@ -16826,7 +16840,7 @@ class RegistrationOrganizationInfo(AbstractModel):
         :type Address: str
         :param _AdminName: 组织机构超管姓名。
 在注册流程中，必须是超管本人进行操作。
-如果法人做为超管管理组织机构,超管姓名就是法人姓名
+如果法人作为超管管理组织机构,超管姓名就是法人姓名
         :type AdminName: str
         :param _AdminMobile: 组织机构超管姓名。
 在注册流程中，这个手机号必须跟操作人在电子签注册的个人手机号一致。

{tencentcloud_sdk_python_essbasic-3.0.1055.dist-info → tencentcloud_sdk_python_essbasic-3.0.1059.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-essbasic
-Version: 3.0.1055
+Version: 3.0.1059
 Summary: Tencent Cloud Essbasic SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common (==3.0.1055)
+Requires-Dist: tencentcloud-sdk-python-common (==3.0.1059)
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_essbasic-3.0.1055.dist-info → tencentcloud_sdk_python_essbasic-3.0.1059.dist-info}/RECORD

@@ -1,4 +1,4 @@
-tencentcloud/__init__.py,sha256=H6DteF0hEoluQjE94xlaYhb7KXDlYi3o-62dLhLU_Rs,631
+tencentcloud/__init__.py,sha256=58JONKsdAjv2uwRvL8XT7nqPcG1FmbJ_9zLA_kANUEE,631
 tencentcloud/essbasic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tencentcloud/essbasic/v20201222/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tencentcloud/essbasic/v20201222/errorcodes.py,sha256=cZPs0vLmArRFQoZqxM4alb0WeBF9f0V0IHmt65dUdxs,5392
@@ -6,9 +6,9 @@ tencentcloud/essbasic/v20201222/essbasic_client.py,sha256=kua9joup-BLKbyITYpVovM
 tencentcloud/essbasic/v20201222/models.py,sha256=Q2E6jmVT1emRziwRN-qj8XpdzpxvqqHTKOEQz8JaM_s,270905
 tencentcloud/essbasic/v20210526/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tencentcloud/essbasic/v20210526/errorcodes.py,sha256=L7u1uH1UVbsjd_f2RTdpmzKFDQJN-lfFZUyKhBDluxQ,18083
-tencentcloud/essbasic/v20210526/essbasic_client.py,sha256=CcMsy-gnrFS05wpQqn0A-P91J6TNztCAVmPMg-ioZs0,118083
-tencentcloud/essbasic/v20210526/models.py,sha256=zKREnlvICebs27Vf9xv2pTWaCXZxNN4UAfxa3tXWSBg,655707
-tencentcloud_sdk_python_essbasic-3.0.1055.dist-info/METADATA,sha256=DOEU3KmhPwrqioYnz6ZefTwslEt_T68DoSss8oWuE4s,1517
-tencentcloud_sdk_python_essbasic-3.0.1055.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
-tencentcloud_sdk_python_essbasic-3.0.1055.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
-tencentcloud_sdk_python_essbasic-3.0.1055.dist-info/RECORD,,
+tencentcloud/essbasic/v20210526/essbasic_client.py,sha256=WL4c5Fnws5aK8twf3xEac0Pu_pJX1SBZgJLmJPJk8uc,119570
+tencentcloud/essbasic/v20210526/models.py,sha256=gCPiCQyY1X02QTNiys2RcyskN7dZFfbvZHYXdRHWbpE,656530
+tencentcloud_sdk_python_essbasic-3.0.1059.dist-info/METADATA,sha256=BdD14yxp8Opa6CFcEM-rbaYA_nL07KIIvkAChlL2JT8,1517
+tencentcloud_sdk_python_essbasic-3.0.1059.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
+tencentcloud_sdk_python_essbasic-3.0.1059.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
+tencentcloud_sdk_python_essbasic-3.0.1059.dist-info/RECORD,,