tencentcloud-sdk-python-essbasic 3.0.1151__tar.gz → 3.0.1158__tar.gz

{tencentcloud-sdk-python-essbasic-3.0.1151 → tencentcloud-sdk-python-essbasic-3.0.1158}/PKG-INFO

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

{tencentcloud-sdk-python-essbasic-3.0.1151 → tencentcloud-sdk-python-essbasic-3.0.1158}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1151'
+__version__ = '3.0.1158'

{tencentcloud-sdk-python-essbasic-3.0.1151 → tencentcloud-sdk-python-essbasic-3.0.1158}/tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -215,8 +215,9 @@ class EssbasicClient(AbstractClient):
         注：
         - 使用此接口生成链接，需要提前开通 `使用手机号验证签署方身份` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
         - 参与人点击链接后需短信验证码才能查看合同内容。
-        - 企业用户批量签署，需要传OrganizationName（参与方所在企业名称）参数生成签署链接，`请确保此企业已完成腾讯电子签企业认证`。暂时仅支持给`自建应用集成企业` 生成员工批签链接，不支持子客企业。
-        - 个人批量签署，签名区`仅支持手写签名`。
+        - 企业用户批量签署，需要传OrganizationName（参与方所在企业名称）参数生成签署链接，<font color="red">请确保此企业已完成腾讯电子签企业认证</font>。暂时仅支持给<font color="red">自建应用集成企业</font>生成员工批签链接，不支持子客企业。
+        - 生成批量签署链接时，合同目标参与方状态需为<font color="red">待签署</font>状态。
+        - 个人批量签署进行的合同的签名区， 全部变成<font color="red">手写签名</font>（不管合同里边设置的签名限制）来进行。
 
         :param request: Request instance for ChannelCreateBatchSignUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateBatchSignUrlRequest`
@@ -2001,8 +2002,9 @@ class EssbasicClient(AbstractClient):
 
 
     def DescribeChannelSealPolicyWorkflowUrl(self, request):
-        """制定渠道分支客户的印刷申请审批微型应用程序链接，链接模式（通过H5触发微型应用程序或通过APP跳转进行查看）。
-        此刻，代理参数中的OpenId 必须为审批者的openId，生成的链接必须由该用户启动，其他用户则无审批权限。
+        """生成用印申请审批链接，审批人可以通过此链接进入小程序进行审批。
+         p.s.
+        Agent参数中的OpenId 必须为审批者的openId，且链接必须由审批人打开。
 
         :param request: Request instance for DescribeChannelSealPolicyWorkflowUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeChannelSealPolicyWorkflowUrlRequest`

{tencentcloud-sdk-python-essbasic-3.0.1151 → tencentcloud-sdk-python-essbasic-3.0.1158}/tencentcloud/essbasic/v20210526/models.py

@@ -2065,18 +2065,18 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
         :param _Name: 签署方经办人的姓名。
 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
 
-注：`请确保和合同中填入的一致`
+注：`请确保和合同中填入的一致`，`除动态签署人场景外，此参数必填`
         :type Name: str
         :param _Mobile: 手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
 请确认手机号所有方为此业务通知方。
 
-注：`请确保和合同中填入的一致,  若无法保持一致，请确保在发起和生成批量签署链接时传入相同的参与方证件信息`
+注：`请确保和合同中填入的一致,  若无法保持一致，请确保在发起和生成批量签署链接时传入相同的参与方证件信息`，`除动态签署人场景外，此参数必填`
         :type Mobile: str
         :param _Operator: 执行本接口操作的员工信息。
 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
         :param _IdCardType: 证件类型，支持以下类型
-<ul><li>**ID_CARD** : 居民身份证 (默认值)</li>
+<ul><li>**ID_CARD** : 中国大陆居民身份证 (默认值)</li>
 <li>**HONGKONG_AND_MACAO** : 港澳居民来往内地通行证</li>
 <li>**HONGKONG_MACAO_AND_TAIWAN** : 港澳台居民居住证(格式同居民身份证)</li></ul>
 
@@ -4743,11 +4743,14 @@ class ChannelCreatePrepareFlowResponse(AbstractModel):
         :type PrepareFlowUrl: str
         :param _PreviewFlowUrl: 合同发起后预览链接， 注意此时合同并未发起，仅只是展示效果， 有效期为5分钟
         :type PreviewFlowUrl: str
+        :param _FlowId: 发起的合同临时Id， 只有当点击进入链接，成功发起合同后， 此Id才有效
+        :type FlowId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
         self._PrepareFlowUrl = None
         self._PreviewFlowUrl = None
+        self._FlowId = None
         self._RequestId = None
 
     @property
@@ -4766,6 +4769,14 @@ class ChannelCreatePrepareFlowResponse(AbstractModel):
     def PreviewFlowUrl(self, PreviewFlowUrl):
         self._PreviewFlowUrl = PreviewFlowUrl
 
+    @property
+    def FlowId(self):
+        return self._FlowId
+
+    @FlowId.setter
+    def FlowId(self, FlowId):
+        self._FlowId = FlowId
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -4778,6 +4789,7 @@ class ChannelCreatePrepareFlowResponse(AbstractModel):
     def _deserialize(self, params):
         self._PrepareFlowUrl = params.get("PrepareFlowUrl")
         self._PreviewFlowUrl = params.get("PreviewFlowUrl")
+        self._FlowId = params.get("FlowId")
         self._RequestId = params.get("RequestId")
 
 
@@ -4808,7 +4820,7 @@ class ChannelCreatePreparedPersonalEsignRequest(AbstractModel):
 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
         :param _IdCardType: 证件类型，支持以下类型
-<ul><li>ID_CARD : 居民身份证 (默认值)</li>
+<ul><li>ID_CARD : 中国大陆居民身份证 (默认值)</li>
 <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
 <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
 <li>OTHER_CARD_TYPE : 其他</li></ul>
@@ -9062,6 +9074,7 @@ class Component(AbstractModel):
 
         :type ComponentHeight: float
         :param _ComponentPage: **在绝对定位方式方式下**，指定控件所在PDF文件上的页码
+**在使用文件发起的情况下**，绝对定位方式的填写控件和签署控件支持使用负数来指定控件在PDF文件上的页码，使用负数时，页码从最后一页开始。例如：ComponentPage设置为-1，即代表在PDF文件的最后一页，以此类推。
 
 注：
 1. 页码编号是从<font color="red">1</font>开始编号的。
@@ -9126,12 +9139,12 @@ class Component(AbstractModel):
         :type ComponentExtra: str
         :param _ComponentValue: 控件填充vaule，ComponentType和传入值类型对应关系：
 <ul><li> <b>TEXT</b> : 文本内容</li>
-<li> <b>MULTI_LINE_TEXT</b> : 文本内容</li>
+<li> <b>MULTI_LINE_TEXT</b> : 文本内容， 可以用  \n 来控制换行位置</li>
 <li> <b>CHECK_BOX</b> : true/false</li>
 <li> <b>FILL_IMAGE、ATTACHMENT</b> : 附件的FileId，需要通过UploadFiles接口上传获取</li>
 <li> <b>SELECTOR</b> : 选项值</li>
 <li> <b>DYNAMIC_TABLE</b>  - 传入json格式的表格内容，详见说明：[数据表格](https://qian.tencent.com/developers/company/dynamic_table)</li>
-<li> <b>DATE</b> : 默认是格式化为xxxx年xx月xx日</li>
+<li> <b>DATE</b> : 格式化：xxxx年xx月xx日（例如：2024年05月28日）</li>
 <li> <b>SIGN_SEAL</b> : 印章ID，于控制台查询获取，[点击查看在控制上的位置](https://qcloudimg.tencent-cloud.cn/raw/cd403a5b949fce197fd9e88bb6db1517.png)</li>
 <li> <b>SIGN_PAGING_SEAL</b> : 可以指定印章ID，于控制台查询获取，[点击查看在控制上的位置](https://qcloudimg.tencent-cloud.cn/raw/cd403a5b949fce197fd9e88bb6db1517.png)</li></ul>
 
@@ -10212,7 +10225,7 @@ class CreateConsoleLoginUrlResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _ConsoleUrl: 跳转链接, 链接的有效期根据企业,员工状态和终端等有区别, 可以参考下表
-<table> <thead> <tr> <th>子客企业状态</th> <th>子客企业员工状态</th> <th>Endpoint</th> <th>链接有效期限</th> </tr> </thead>  <tbody> <tr> <td>企业未激活</td> <td>员工未认证</td> <td>PC/PC_SHORT_URL</td> <td>5分钟</td>  </tr>  <tr> <td>企业未激活</td> <td>员工未认证</td> <td>CHANNEL/APP/H5/SHORT_H5</td> <td>30天</td>  </tr>  <tr> <td>企业已激活</td> <td>员工未认证</td> <td>PC/PC_SHORT_URL</td> <td>5分钟</td>  </tr> <tr> <td>企业已激活</td> <td>员工未认证</td> <td>PC/CHANNEL/APP/H5/SHORT_H5</td> <td>30天</td>  </tr>  <tr> <td>企业已激活</td> <td>员工已认证</td> <td>PC</td> <td>5分钟</td>  </tr>  <tr> <td>企业已激活</td> <td>员工已认证</td> <td>CHANNEL/APP/H5/SHORT_H5</td> <td>30天</td>  </tr> </tbody> </table>
+<table> <thead> <tr> <th>子客企业状态</th> <th>子客企业员工状态</th> <th>Endpoint</th> <th>链接有效期限</th> </tr> </thead>  <tbody> <tr> <td>企业未激活</td> <td>员工未认证</td> <td>PC/PC_SHORT_URL</td> <td>5分钟</td>  </tr>  <tr> <td>企业未激活</td> <td>员工未认证</td> <td>CHANNEL/APP/H5/SHORT_H5</td> <td>30天</td>  </tr>  <tr> <td>企业已激活</td> <td>员工未认证</td> <td>PC/PC_SHORT_URL</td> <td>5分钟</td>  </tr> <tr> <td>企业已激活</td> <td>员工未认证</td> <td>CHANNEL/APP/H5/SHORT_H5</td> <td>30天</td>  </tr>  <tr> <td>企业已激活</td> <td>员工已认证</td> <td>PC</td> <td>5分钟</td>  </tr>  <tr> <td>企业已激活</td> <td>员工已认证</td> <td>CHANNEL/APP/H5/SHORT_H5</td> <td>30天</td>  </tr> </tbody> </table>
 
 注： 
 1. <font color="red">链接仅单次有效</font>，每次登录需要需要重新创建新的链接
@@ -12124,7 +12137,7 @@ class DescribeChannelSealPolicyWorkflowUrlRequest(AbstractModel):
 第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId
 第三方平台子客企业和员工必须已经经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _WorkflowInstanceId: 用印审批单的ID，可通过用印申请回调获取。
+        :param _WorkflowInstanceId: 用印审批单的ID，可通过用印[申请回调](https://qian.tencent.com/developers/partner/callback_types_seals#%E4%B8%89-%E7%94%A8%E5%8D%B0%E7%94%B3%E8%AF%B7%E5%AE%A1%E6%89%B9%E7%8A%B6%E6%80%81%E9%80%9A%E7%9F%A5)获取。
         :type WorkflowInstanceId: str
         :param _Endpoint: 生成链接的类型：
 生成链接的类型
@@ -13462,7 +13475,7 @@ class FillApproverInfo(AbstractModel):
         :param _NotChannelOrganization: 签署企业非渠道子客，默认为false，即表示同一渠道下的企业；如果为true，则目前表示接收方企业为SaaS企业, 为渠道子客时，OrganizationOpenId 必传
         :type NotChannelOrganization: bool
         :param _ApproverIdCardType: 签署方经办人的证件类型，支持以下类型
-<ul><li>ID_CARD 居民身份证</li>
+<ul><li>ID_CARD 中国大陆居民身份证</li>
 <li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
 <li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
 <li>OTHER_CARD_TYPE 其他证件</li></ul>
@@ -13979,7 +13992,7 @@ class FlowApproverInfo(AbstractModel):
 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         :type Name: str
         :param _IdCardType: 签署方经办人的证件类型，支持以下类型
-<ul><li>ID_CARD : 居民身份证  (默认值)</li>
+<ul><li>ID_CARD : 中国大陆居民身份证  (默认值)</li>
 <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
 <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
 <li>OTHER_CARD_TYPE : 其他证件</li></ul>
@@ -15742,17 +15755,20 @@ class FormField(AbstractModel):
     def __init__(self):
         r"""
         :param _ComponentValue: 控件填充值，ComponentType和传入值格式对应关系如下：
-<ul>
-<li>TEXT - 普通文本控件，需输入文本字符串；</li>
-<li>MULTI_LINE_TEXT - 多行文本控件，需输入文本字符串；</li>
-<li>CHECK_BOX - 勾选框控件，若选中需填写ComponentValue，填写 true或者 false 字符串；</li>
-<li>FILL_IMAGE - 图片控件，需填写ComponentValue为图片的资源 ID；</li>
-<li>DYNAMIC_TABLE - 动态表格控件；</li>
-<li>ATTACHMENT - 附件控件，需填写ComponentValue为附件图片的资源 ID列表，以逗号分割；</li>
-<li>DATE - 日期控件；格式为 <b>xxxx年xx月xx日</b> 字符串；</li>
-<li>DISTRICT - 省市区行政区控件，需填写ComponentValue为省市区行政区字符串内容；</li>
+<ul><li> <b>TEXT</b> : 文本内容</li>
+<li> <b>MULTI_LINE_TEXT</b> : 文本内容， 可以用  \n 来控制换行位置</li>
+<li> <b>CHECK_BOX</b> : true/false</li>
+<li> <b>FILL_IMAGE、ATTACHMENT</b> : 附件的FileId，需要通过UploadFiles接口上传获取</li>
+<li> <b>SELECTOR</b> : 选项值</li>
+<li> <b>DYNAMIC_TABLE</b>  - 传入json格式的表格内容，详见说明：[数据表格](https://qian.tencent.com/developers/partner/dynamic_table)</li>
+<li> <b>DATE</b> : 格式化：xxxx年xx月xx日（例如：2024年05月28日）</li>
+<li> <b>DISTRICT </b> : 省市区行政区控件，需填写ComponentValue为省市区行政区字符串内容</li>
 </ul>
 
+
+<b>控件值约束说明</b>：
+<table> <thead> <tr> <th>特殊控件</th> <th>填写约束</th> </tr> </thead> <tbody> <tr> <td>企业全称控件</td> <td>企业名称中文字符中文括号</td> </tr> <tr> <td>统一社会信用代码控件</td> <td>企业注册的统一社会信用代码</td> </tr> <tr> <td>法人名称控件</td> <td>最大50个字符，2到25个汉字或者1到50个字母</td> </tr> <tr> <td>签署意见控件</td> <td>签署意见最大长度为50字符</td> </tr> <tr> <td>签署人手机号控件</td> <td>国内手机号 13,14,15,16,17,18,19号段长度11位</td> </tr> <tr> <td>签署人身份证控件</td> <td>合法的身份证号码检查</td> </tr> <tr> <td>控件名称</td> <td>控件名称最大长度为20字符，不支持表情</td> </tr> <tr> <td>单行文本控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>多行文本控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>勾选框控件</td> <td>选择填字符串true，不选填字符串false</td> </tr> <tr> <td>选择器控件</td> <td>同单行文本控件约束，填写选择值中的字符串</td> </tr> <tr> <td>数字控件</td> <td>请输入有效的数字(可带小数点)</td> </tr> <tr> <td>日期控件</td> <td>格式：yyyy年mm月dd日</td> </tr> <tr> <td>附件控件</td> <td>JPG或PNG图片，上传数量限制，1到6个，最大6个附件，填写上传的资源ID</td> </tr> <tr> <td>图片控件</td> <td>JPG或PNG图片，填写上传的图片资源ID</td> </tr> <tr> <td>邮箱控件</td> <td>有效的邮箱地址, w3c标准</td> </tr> <tr> <td>地址控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>省市区控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>性别控件</td> <td>选择值中的字符串</td> </tr> <tr> <td>学历控件</td> <td>选择值中的字符串</td> </tr> </tbody> </table>
+
         :type ComponentValue: str
         :param _ComponentId: 表单域或控件的ID，跟ComponentName二选一，不能全为空；
 CreateFlowsByTemplates 接口不使用此字段。
@@ -16611,7 +16627,7 @@ class NeedReviewApproverInfo(AbstractModel):
         :param _ApproverMobile: 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。
         :type ApproverMobile: str
         :param _ApproverIdCardType: 签署方经办人的证件类型，支持以下类型
-<ul><li>ID_CARD 居民身份证  (默认值)</li>
+<ul><li>ID_CARD 中国大陆居民身份证  (默认值)</li>
 <li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
 <li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
 <li>OTHER_CARD_TYPE 其他证件</li></ul>
@@ -17847,7 +17863,7 @@ class ProxyOrganizationOperator(AbstractModel):
 员工的姓名将用于身份认证和电子签名，请确保填写的姓名为真实姓名，而非昵称等代名。
         :type Name: str
         :param _IdCardType: 签署方经办人的证件类型，支持以下类型
-<ul><li>ID_CARD : 居民身份证  (默认值)</li>
+<ul><li>ID_CARD : 中国大陆居民身份证  (默认值)</li>
 <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
 <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
 
@@ -18237,7 +18253,12 @@ class RegistrationOrganizationInfo(AbstractModel):
         :type AdminIdCardNumber: str
         :param _BusinessLicense: 营业执照正面照(PNG或JPG) base64格式, 大小不超过5M
         :type BusinessLicense: str
-        :param _PowerOfAttorneys: 授权书(PNG或JPG或PDF) base64格式, 大小不超过8M
+        :param _PowerOfAttorneys: 授权书(PNG或JPG或PDF) base64格式, 大小不超过8M 。
+p.s. 如果上传授权书 ，需遵循以下条件
+1. 超管的信息（超管姓名，超管身份证，超管手机号）必须为必填参数。
+2. 超管的个人身份必须在电子签已经实名。
+2. 认证方式AuthorizationTypes必须只能是上传授权书方式 
+
         :type PowerOfAttorneys: list of str
         """
         self._OrganizationName = None
@@ -19551,7 +19572,7 @@ class SyncProxyOrganizationRequest(AbstractModel):
         :param _Operator: 暂未开放
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
         :param _ProxyLegalIdCardType: 第三方平台子客企业法定代表人的证件类型，支持以下类型
-<ul><li>ID_CARD : 居民身份证 (默认值)</li></ul>
+<ul><li>ID_CARD : 中国大陆居民身份证 (默认值)</li></ul>
 注: `现在仅支持ID_CARD居民身份证类型`
         :type ProxyLegalIdCardType: str
         :param _ProxyLegalIdCardNumber: 第三方平台子客企业法定代表人的证件号码, 应符合以下规则
@@ -20425,7 +20446,7 @@ class UserThreeFactor(AbstractModel):
 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         :type Name: str
         :param _IdCardType: 证件类型，支持以下类型
-<ul><li>ID_CARD : 居民身份证 (默认值)</li>
+<ul><li>ID_CARD : 中国大陆居民身份证 (默认值)</li>
 <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
 <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
         :type IdCardType: str

{tencentcloud-sdk-python-essbasic-3.0.1151 → tencentcloud-sdk-python-essbasic-3.0.1158}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

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

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

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

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