tencentcloud-sdk-python-essbasic 3.0.1267__tar.gz → 3.0.1277__tar.gz

{tencentcloud-sdk-python-essbasic-3.0.1267 → tencentcloud-sdk-python-essbasic-3.0.1277}/PKG-INFO

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

{tencentcloud-sdk-python-essbasic-3.0.1267 → tencentcloud-sdk-python-essbasic-3.0.1277}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1267'
+__version__ = '3.0.1277'

{tencentcloud-sdk-python-essbasic-3.0.1267 → tencentcloud-sdk-python-essbasic-3.0.1277}/tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -181,11 +181,10 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelCreateBatchQuickSignUrl(self, request):
-        """该接口用于发起合同后，生成个人用户的批量待办链接, 暂时不支持企业端签署。
+        """该接口用于发起合同后，生成个人/企业用户的批量待办链接。
         **注意：**
-        1. 该接口目前仅支持签署人类型是**个人签署方的批量签署场景**(ApproverType=1)。
-        2. 该接口可生成C端签署人的批量签署/查看链接，**签署控件仅支持手写签名(控件类型为SIGN_SIGNATURE)和时间类型的签署控件** 。
-        3. 该签署链接**有效期为30分钟**，过期后将失效，如需签署可重新创建批量签署链接 。
+        1. 该接口可生成签署人的批量、合同组签署/查看链接 。
+        2. 该签署链接**有效期为30分钟**，过期后将失效，如需签署可重新创建批量签署链接 。
         4. 该接口返回的签署链接适用于APP集成的场景，支持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>。
         6. 因h5涉及人脸身份认证能力基于慧眼人脸核身，对Android和iOS系统均有一定要求， 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
@@ -1241,7 +1240,7 @@ class EssbasicClient(AbstractClient):
         无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件，均包含在查询结果中。
 
         ![image](https://qcloudimg.tencent-cloud.cn/raw/08f6ea50d3ae88b51c280c2b17c2a126.png)
-        ### 2.  那些控件会出现在结果里边？
+        ### 2.  哪些控件会出现在结果里边？
         **A.不返回的控件类型：**
         - 动态表格
         - 附件控件
@@ -2125,7 +2124,7 @@ class EssbasicClient(AbstractClient):
         注:
         <ul>
         <li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
-        <li>处方单等特殊场景专用，此接口为白名单功能，使用前请联系对接的客户经理沟通。  </li>
+        <li>专为电子处方单（医疗自动签）特定场景使用。在使用前，请务必与您的客户经理联系以确认已经开通电子处方单功能 </li>
         </ul>
 
         :param request: Request instance for CreatePersonAuthCertificateImage.

{tencentcloud-sdk-python-essbasic-3.0.1267 → tencentcloud-sdk-python-essbasic-3.0.1277}/tencentcloud/essbasic/v20210526/models.py

@@ -2360,10 +2360,14 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
     def __init__(self):
         r"""
         :param _FlowApproverInfo: 批量签署的流程签署人，其中姓名(ApproverName)、参与人类型(ApproverType)必传，手机号(ApproverMobile)和证件信息(ApproverIdCardType、ApproverIdCardNumber)可任选一种或全部传入。
+<ul>
+<li>若为个人参与方：ApproverType:"PERSON"</li>
+<li>若为企业参与方：ApproverType:"ORGANIZATION"。同时若签署方为saas企业员工， OrganizationName 参数需传入参与方企业名称。若签署方为渠道子客企业员工，还需要传 OpenId、OrganizationOpenId。</li>
+</ul>
+
 注:
-`1. ApproverType目前只支持个人类型的签署人。`
-`2. 签署人只能有手写签名和时间类型的签署控件，其他类型的填写控件和签署控件暂时都未支持。`
-`3. 当需要通过短信验证码签署时，手机号ApproverMobile需要与发起合同时填写的用户手机号一致。`
+`1. 暂不支持签署人拖动签署控件功能，以及签批控件。`
+`2. 当需要通过短信验证码签署时，手机号ApproverMobile需要与发起合同时填写的用户手机号一致。`
         :type FlowApproverInfo: :class:`tencentcloud.essbasic.v20210526.models.FlowApproverInfo`
         :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
@@ -2384,7 +2388,9 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
 注：
 <ul><li>默认情况下，签名类型为手写签名</li>
 <li>您可以传递多种值，表示可用多种签名类型。</li>
-<li>该参数会覆盖您合同中的签名类型，若您在发起合同时限定了签名类型(赋值签名类型给ComponentTypeLimit)，请将这些签名类型赋予此参数</li></ul>
+<li>该参数会覆盖您合同中的签名类型，若您在发起合同时限定了签名类型(赋值签名类型给ComponentTypeLimit)，请将这些签名类型赋予此参数</li>
+<li>若签署方为企业员工，此参数无效，签名方式将以合同中为准。</li>
+</ul>
         :type SignatureTypes: list of int
         :param _ApproverSignTypes: 指定批量签署合同的认证校验方式，可传递以下值：
 <ul><li>**1**：人脸认证(默认)，需进行人脸识别成功后才能签署合同</li>
@@ -2401,10 +2407,14 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
 `不指定该值时，默认为签署方自行选择。`
         :type SignTypeSelector: int
         :param _FlowBatchUrlInfo: 批量签署合同相关信息，指定合同和签署方的信息，用于补充动态签署人。	
+
+注: `若签署方为企业员工，暂不支持通过H5端进行动态签署人的补充`
         :type FlowBatchUrlInfo: :class:`tencentcloud.essbasic.v20210526.models.FlowBatchUrlInfo`
         :param _Intention: <b>只有在生成H5签署链接的情形下</b>（ 如调用<a href="https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateFlowSignUrl" target="_blank">获取H5签署链接</a>、<a href="https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateBatchQuickSignUrl" target="_blank">获取H5批量签署链接</a>等接口），该配置才会生效。  您可以指定H5签署视频核身的意图配置，选择问答模式或点头模式的语音文本。  注意： 1. 视频认证为<b>白名单功能，使用前请联系对接的客户经理沟通</b>。 2. 使用视频认证时，<b>生成H5签署链接的时候必须将签署认证方式指定为人脸</b>（即ApproverSignTypes设置成人脸签署）。 3. 签署完成后，可以通过<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelDescribeSignFaceVideo" target="_blank">查询签署认证人脸视频</a>获取到当时的视频。
         :type Intention: :class:`tencentcloud.essbasic.v20210526.models.Intention`
         :param _CacheApproverInfo: 缓存签署人信息。在H5签署链接动态领取场景，首次填写后，选择缓存签署人信息，在下次签署人点击领取链接时，会自动将个人信息（姓名、身份证号、手机号）填入，否则需要每次手动填写。
+
+注: `若参与方为企业员工时，暂不支持对参与方信息进行缓存`
         :type CacheApproverInfo: bool
         """
         self._FlowApproverInfo = None
@@ -2422,10 +2432,14 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
     @property
     def FlowApproverInfo(self):
         """批量签署的流程签署人，其中姓名(ApproverName)、参与人类型(ApproverType)必传，手机号(ApproverMobile)和证件信息(ApproverIdCardType、ApproverIdCardNumber)可任选一种或全部传入。
+<ul>
+<li>若为个人参与方：ApproverType:"PERSON"</li>
+<li>若为企业参与方：ApproverType:"ORGANIZATION"。同时若签署方为saas企业员工， OrganizationName 参数需传入参与方企业名称。若签署方为渠道子客企业员工，还需要传 OpenId、OrganizationOpenId。</li>
+</ul>
+
 注:
-`1. ApproverType目前只支持个人类型的签署人。`
-`2. 签署人只能有手写签名和时间类型的签署控件，其他类型的填写控件和签署控件暂时都未支持。`
-`3. 当需要通过短信验证码签署时，手机号ApproverMobile需要与发起合同时填写的用户手机号一致。`
+`1. 暂不支持签署人拖动签署控件功能，以及签批控件。`
+`2. 当需要通过短信验证码签署时，手机号ApproverMobile需要与发起合同时填写的用户手机号一致。`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.FlowApproverInfo`
         """
         return self._FlowApproverInfo
@@ -2491,7 +2505,9 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
 注：
 <ul><li>默认情况下，签名类型为手写签名</li>
 <li>您可以传递多种值，表示可用多种签名类型。</li>
-<li>该参数会覆盖您合同中的签名类型，若您在发起合同时限定了签名类型(赋值签名类型给ComponentTypeLimit)，请将这些签名类型赋予此参数</li></ul>
+<li>该参数会覆盖您合同中的签名类型，若您在发起合同时限定了签名类型(赋值签名类型给ComponentTypeLimit)，请将这些签名类型赋予此参数</li>
+<li>若签署方为企业员工，此参数无效，签名方式将以合同中为准。</li>
+</ul>
         :rtype: list of int
         """
         return self._SignatureTypes
@@ -2535,6 +2551,8 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
     @property
     def FlowBatchUrlInfo(self):
         """批量签署合同相关信息，指定合同和签署方的信息，用于补充动态签署人。	
+
+注: `若签署方为企业员工，暂不支持通过H5端进行动态签署人的补充`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.FlowBatchUrlInfo`
         """
         return self._FlowBatchUrlInfo
@@ -2557,6 +2575,8 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
     @property
     def CacheApproverInfo(self):
         """缓存签署人信息。在H5签署链接动态领取场景，首次填写后，选择缓存签署人信息，在下次签署人点击领取链接时，会自动将个人信息（姓名、身份证号、手机号）填入，否则需要每次手动填写。
+
+注: `若参与方为企业员工时，暂不支持对参与方信息进行缓存`
         :rtype: bool
         """
         return self._CacheApproverInfo
@@ -2722,6 +2742,14 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
         :type OpenId: str
         :param _OrganizationOpenId: 第三方平台子客企业的企业的标识, 即OrganizationOpenId，批签合同经办人为子客企业员工是为必填。
         :type OrganizationOpenId: str
+        :param _AutoJumpBack: 签署完成后是否自动回跳
+<ul><li>false：否, 签署完成不会自动跳转回来(默认)</li><li>true：是, 签署完成会自动跳转回来</li></ul>
+
+注: 
+1. 该参数<font color="red">只针对APP类型（电子签小程序跳转贵方小程序）场景</font> 的签署链接有效
+2. <font color="red">手机应用APP 或 微信小程序需要监控界面的返回走后序逻辑</font>, 微信小程序的文档可以参考[这个](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onShow-Object-object)
+3. <font color="red">电子签小程序跳转贵方APP，不支持自动跳转，必需用户手动点击完成按钮（微信的限制）</font> 
+        :type AutoJumpBack: bool
         """
         self._Agent = None
         self._Name = None
@@ -2736,6 +2764,7 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
         self._FlowBatchUrlInfo = None
         self._OpenId = None
         self._OrganizationOpenId = None
+        self._AutoJumpBack = None
 
     @property
     def Agent(self):
@@ -2928,6 +2957,23 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
     def OrganizationOpenId(self, OrganizationOpenId):
         self._OrganizationOpenId = OrganizationOpenId
 
+    @property
+    def AutoJumpBack(self):
+        """签署完成后是否自动回跳
+<ul><li>false：否, 签署完成不会自动跳转回来(默认)</li><li>true：是, 签署完成会自动跳转回来</li></ul>
+
+注: 
+1. 该参数<font color="red">只针对APP类型（电子签小程序跳转贵方小程序）场景</font> 的签署链接有效
+2. <font color="red">手机应用APP 或 微信小程序需要监控界面的返回走后序逻辑</font>, 微信小程序的文档可以参考[这个](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onShow-Object-object)
+3. <font color="red">电子签小程序跳转贵方APP，不支持自动跳转，必需用户手动点击完成按钮（微信的限制）</font> 
+        :rtype: bool
+        """
+        return self._AutoJumpBack
+
+    @AutoJumpBack.setter
+    def AutoJumpBack(self, AutoJumpBack):
+        self._AutoJumpBack = AutoJumpBack
+
 
     def _deserialize(self, params):
         if params.get("Agent") is not None:
@@ -2949,6 +2995,7 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
             self._FlowBatchUrlInfo._deserialize(params.get("FlowBatchUrlInfo"))
         self._OpenId = params.get("OpenId")
         self._OrganizationOpenId = params.get("OrganizationOpenId")
+        self._AutoJumpBack = params.get("AutoJumpBack")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -11731,12 +11778,20 @@ class Component(AbstractModel):
 <li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
 <li> <b>SIGN_PAGING_SEAL</b> : 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight</li>
 <li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
+<li> <b>SIGN_VIRTUAL_COMBINATION</b> : 签批控件。内部最多组合4个特定控件（SIGN_SIGNATURE，SIGN_DATA,SIGN_MULTI_LINE_TEXT,SIGN_SELECTOR），本身不填充任何文字内容</li>
+<li> <b>SIGN_MULTI_LINE_TEXT</b> : 多行文本，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作批注附言</li>
+<li> <b>SIGN_SELECTOR</b> : 选择器，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作审批意见的选择</li>
 <li> <b>SIGN_LEGAL_PERSON_SEAL</b> : 企业法定代表人控件。</li></ul>
 
+
 * 个人方
 <ul><li> <b>SIGN_DATE</b> : 签署日期控件；</li>
 <li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
-<li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li></ul>
+<li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
+<li> <b>SIGN_VIRTUAL_COMBINATION</b> : 签批控件。内部包含最多4个特定控件（SIGN_SIGNATURE，SIGN_DATA,SIGN_MULTI_LINE_TEXT,SIGN_SELECTOR），本身不填充任何文字内容</li>
+<li> <b>SIGN_MULTI_LINE_TEXT</b> : 多行文本，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作批注附言</li>
+<li> <b>SIGN_SELECTOR</b> : 选择器，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作审批意见的选择</li>
+</ul>
  
 注：` 表单域的控件不能作为印章和签名控件`
         :type ComponentType: str
@@ -11841,6 +11896,107 @@ class Component(AbstractModel):
 <ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
 场景说明：如果使用关键字进行定位，但是指定的PDF文件中又没有设置的关键字时，发起合同会进行关键字是否存在的校验，如果关键字不存在，会进行报错返回。如果不希望进行报错，可以设置"IgnoreKeywordError"来忽略错误。请注意，如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有，还是会触发报错逻辑。
 <b>参数样例</b>：` "{"IgnoreKeywordError":1}"`
+
+
+<font color="red">ComponentType为SIGN_VIRTUAL_COMBINATION时</font>，支持以下参数：
+<ul>
+<li><b>Children:</b> 绝对定位模式下，用来指定此签批控件的组合子控件 </li>
+<b>参数样例</b>：<br>`{"Children":["ComponentId_29","ComponentId_27","ComponentId_28","ComponentId_30"]}`
+<li><b>ChildrenComponents:</b> 关键字定位模式下，用来指定此签批控件的组合子控件 </li>
+ChildrenComponent结构体定义:
+<table border="1">
+    <thead>
+        <tr>
+            <th>字段名称</th>
+            <th>类型</th>
+            <th>描述</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>ComponentType</td>
+            <td>string</td>
+            <td>子控件类型-可选值:SIGN_SIGNATURE,SIGN_DATE,SIGN_SELECTOR,SIGN_MULTI_LINE_TEXT</td>
+        </tr>
+        <tr>
+            <td>ComponentName</td>
+            <td>string</td>
+            <td>子控件名称</td>
+        </tr>
+        <tr>
+            <td>Placeholder</td>
+            <td>string</td>
+            <td>子控件提示语</td>
+        </tr>
+        <tr>
+            <td>ComponentOffsetX</td>
+            <td>float</td>
+            <td>控件偏移位置X（相对于父控件（签批控件的ComponentX））</td>
+        </tr>
+        <tr>
+            <td>ComponentOffsetY</td>
+            <td>float</td>
+            <td>控件偏移位置Y 相对于父控件（签批控件的ComponentY））</td>
+        </tr>
+        <tr>
+            <td>ComponentWidth</td>
+            <td>float</td>
+            <td>控件宽</td>
+        </tr>
+        <tr>
+            <td>ComponentHeight</td>
+            <td>float</td>
+            <td>控件高</td>
+        </tr>
+        <tr>
+            <td>ComponentExtra</td>
+            <td>string</td>
+            <td>控件的附属信息，根据ComponentType设置</td>
+        </tr>
+    </tbody>
+</table>
+<b>参数样例</b>：
+```json
+{
+    "ChildrenComponents": [
+        {
+            "ComponentType": "SIGN_SIGNATURE",
+            "ComponentName": "个人签名",
+            "Placeholder": "请签名",
+            "ComponentOffsetX": 10,
+            "ComponentOffsetY": 30,
+            "ComponentWidth": 119,
+            "ComponentHeight": 43,
+            "ComponentExtra": "{\"ComponentTypeLimit\":[\"SYSTEM_ESIGN\"]}"
+        },
+        {
+            "ComponentType": "SIGN_SELECTOR",
+            "ComponentName": "是否同意此协议",
+            "Placeholder": "",
+            "ComponentOffsetX": 50,
+            "ComponentOffsetY": 130,
+            "ComponentWidth": 120,
+            "ComponentHeight": 43,
+            "ComponentExtra": "{\"Values\":[\"同意\",\"不同意\",\"再想想\"],\"FontSize\":12,\"FontAlign\":\"Left\",\"Font\":\"黑体\",\"MultiSelect\":false}"
+        },
+        {
+            "ComponentType": "SIGN_MULTI_LINE_TEXT",
+            "ComponentName": "批注附言",
+            "Placeholder": "",
+            "ComponentOffsetX": 150,
+            "ComponentOffsetY": 300,
+            "ComponentWidth": 200,
+            "ComponentHeight": 86,
+            "ComponentExtra": ""
+        }
+    ]
+}
+```
+</ul>
+
+
+
+
         :type ComponentExtra: str
         :param _ComponentValue: 控件填充vaule，ComponentType和传入值类型对应关系：
 <ul><li> <b>TEXT</b> : 文本内容</li>
@@ -11982,12 +12138,20 @@ class Component(AbstractModel):
 <li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
 <li> <b>SIGN_PAGING_SEAL</b> : 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight</li>
 <li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
+<li> <b>SIGN_VIRTUAL_COMBINATION</b> : 签批控件。内部最多组合4个特定控件（SIGN_SIGNATURE，SIGN_DATA,SIGN_MULTI_LINE_TEXT,SIGN_SELECTOR），本身不填充任何文字内容</li>
+<li> <b>SIGN_MULTI_LINE_TEXT</b> : 多行文本，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作批注附言</li>
+<li> <b>SIGN_SELECTOR</b> : 选择器，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作审批意见的选择</li>
 <li> <b>SIGN_LEGAL_PERSON_SEAL</b> : 企业法定代表人控件。</li></ul>
 
+
 * 个人方
 <ul><li> <b>SIGN_DATE</b> : 签署日期控件；</li>
 <li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
-<li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li></ul>
+<li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
+<li> <b>SIGN_VIRTUAL_COMBINATION</b> : 签批控件。内部包含最多4个特定控件（SIGN_SIGNATURE，SIGN_DATA,SIGN_MULTI_LINE_TEXT,SIGN_SELECTOR），本身不填充任何文字内容</li>
+<li> <b>SIGN_MULTI_LINE_TEXT</b> : 多行文本，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作批注附言</li>
+<li> <b>SIGN_SELECTOR</b> : 选择器，<font color="red">仅可用在签批控件内部作为组合控件，单独无法使用</font>，常用作审批意见的选择</li>
+</ul>
  
 注：` 表单域的控件不能作为印章和签名控件`
         :rtype: str
@@ -12191,6 +12355,107 @@ class Component(AbstractModel):
 <ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
 场景说明：如果使用关键字进行定位，但是指定的PDF文件中又没有设置的关键字时，发起合同会进行关键字是否存在的校验，如果关键字不存在，会进行报错返回。如果不希望进行报错，可以设置"IgnoreKeywordError"来忽略错误。请注意，如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有，还是会触发报错逻辑。
 <b>参数样例</b>：` "{"IgnoreKeywordError":1}"`
+
+
+<font color="red">ComponentType为SIGN_VIRTUAL_COMBINATION时</font>，支持以下参数：
+<ul>
+<li><b>Children:</b> 绝对定位模式下，用来指定此签批控件的组合子控件 </li>
+<b>参数样例</b>：<br>`{"Children":["ComponentId_29","ComponentId_27","ComponentId_28","ComponentId_30"]}`
+<li><b>ChildrenComponents:</b> 关键字定位模式下，用来指定此签批控件的组合子控件 </li>
+ChildrenComponent结构体定义:
+<table border="1">
+    <thead>
+        <tr>
+            <th>字段名称</th>
+            <th>类型</th>
+            <th>描述</th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>ComponentType</td>
+            <td>string</td>
+            <td>子控件类型-可选值:SIGN_SIGNATURE,SIGN_DATE,SIGN_SELECTOR,SIGN_MULTI_LINE_TEXT</td>
+        </tr>
+        <tr>
+            <td>ComponentName</td>
+            <td>string</td>
+            <td>子控件名称</td>
+        </tr>
+        <tr>
+            <td>Placeholder</td>
+            <td>string</td>
+            <td>子控件提示语</td>
+        </tr>
+        <tr>
+            <td>ComponentOffsetX</td>
+            <td>float</td>
+            <td>控件偏移位置X（相对于父控件（签批控件的ComponentX））</td>
+        </tr>
+        <tr>
+            <td>ComponentOffsetY</td>
+            <td>float</td>
+            <td>控件偏移位置Y 相对于父控件（签批控件的ComponentY））</td>
+        </tr>
+        <tr>
+            <td>ComponentWidth</td>
+            <td>float</td>
+            <td>控件宽</td>
+        </tr>
+        <tr>
+            <td>ComponentHeight</td>
+            <td>float</td>
+            <td>控件高</td>
+        </tr>
+        <tr>
+            <td>ComponentExtra</td>
+            <td>string</td>
+            <td>控件的附属信息，根据ComponentType设置</td>
+        </tr>
+    </tbody>
+</table>
+<b>参数样例</b>：
+```json
+{
+    "ChildrenComponents": [
+        {
+            "ComponentType": "SIGN_SIGNATURE",
+            "ComponentName": "个人签名",
+            "Placeholder": "请签名",
+            "ComponentOffsetX": 10,
+            "ComponentOffsetY": 30,
+            "ComponentWidth": 119,
+            "ComponentHeight": 43,
+            "ComponentExtra": "{\"ComponentTypeLimit\":[\"SYSTEM_ESIGN\"]}"
+        },
+        {
+            "ComponentType": "SIGN_SELECTOR",
+            "ComponentName": "是否同意此协议",
+            "Placeholder": "",
+            "ComponentOffsetX": 50,
+            "ComponentOffsetY": 130,
+            "ComponentWidth": 120,
+            "ComponentHeight": 43,
+            "ComponentExtra": "{\"Values\":[\"同意\",\"不同意\",\"再想想\"],\"FontSize\":12,\"FontAlign\":\"Left\",\"Font\":\"黑体\",\"MultiSelect\":false}"
+        },
+        {
+            "ComponentType": "SIGN_MULTI_LINE_TEXT",
+            "ComponentName": "批注附言",
+            "Placeholder": "",
+            "ComponentOffsetX": 150,
+            "ComponentOffsetY": 300,
+            "ComponentWidth": 200,
+            "ComponentHeight": 86,
+            "ComponentExtra": ""
+        }
+    ]
+}
+```
+</ul>
+
+
+
+
         :rtype: str
         """
         return self._ComponentExtra
@@ -12535,15 +12800,28 @@ class CreateBatchInitOrganizationUrlRequest(AbstractModel):
         :param _Agent: 应用相关信息。 此接口Agent.AppId 必填。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _OperateTypes: 初始化操作类型
-<ul><li>CREATE_SEAL : 创建印章</li>
-<li>OPEN_AUTO_SIGN :开通企业自动签署</li></ul>
+<ul>
+<li>CREATE_SEAL : 创建印章</li>
+<li>OPEN_AUTO_SIGN :开通企业自动签署</li>
+<li>PARTNER_AUTO_SIGN_AUTH :合作方企业或应用平台方授权自动签</li>
+</ul>
         :type OperateTypes: list of str
         :param _ProxyOrganizationOpenIds: 批量操作的企业列表在第三方平台的企业Id列表，即ProxyOrganizationOpenId列表,最大支持50个
         :type ProxyOrganizationOpenIds: list of str
+        :param _IsAuthorizePlatformApplication: 当操作类型包含 PARTNER_AUTO_SIGN_AUTH 且是给应用平台方授权自动签时传true。
+![image](https://qcloudimg.tencent-cloud.cn/raw/f9aba7c999a6d79ada20b4384520e120.png)
+        :type IsAuthorizePlatformApplication: bool
+        :param _AuthorizedProxyOrganizationOpenId: 被授权的合作方企业在第三方平台子客企业标识，即ProxyOrganizationOpenId，当操作类型包含 PARTNER_AUTO_SIGN_AUTH 且要进行合作方企业授权自动签时必传。
+
+
+
+        :type AuthorizedProxyOrganizationOpenId: str
         """
         self._Agent = None
         self._OperateTypes = None
         self._ProxyOrganizationOpenIds = None
+        self._IsAuthorizePlatformApplication = None
+        self._AuthorizedProxyOrganizationOpenId = None
 
     @property
     def Agent(self):
@@ -12559,8 +12837,11 @@ class CreateBatchInitOrganizationUrlRequest(AbstractModel):
     @property
     def OperateTypes(self):
         """初始化操作类型
-<ul><li>CREATE_SEAL : 创建印章</li>
-<li>OPEN_AUTO_SIGN :开通企业自动签署</li></ul>
+<ul>
+<li>CREATE_SEAL : 创建印章</li>
+<li>OPEN_AUTO_SIGN :开通企业自动签署</li>
+<li>PARTNER_AUTO_SIGN_AUTH :合作方企业或应用平台方授权自动签</li>
+</ul>
         :rtype: list of str
         """
         return self._OperateTypes
@@ -12580,6 +12861,32 @@ class CreateBatchInitOrganizationUrlRequest(AbstractModel):
     def ProxyOrganizationOpenIds(self, ProxyOrganizationOpenIds):
         self._ProxyOrganizationOpenIds = ProxyOrganizationOpenIds
 
+    @property
+    def IsAuthorizePlatformApplication(self):
+        """当操作类型包含 PARTNER_AUTO_SIGN_AUTH 且是给应用平台方授权自动签时传true。
+![image](https://qcloudimg.tencent-cloud.cn/raw/f9aba7c999a6d79ada20b4384520e120.png)
+        :rtype: bool
+        """
+        return self._IsAuthorizePlatformApplication
+
+    @IsAuthorizePlatformApplication.setter
+    def IsAuthorizePlatformApplication(self, IsAuthorizePlatformApplication):
+        self._IsAuthorizePlatformApplication = IsAuthorizePlatformApplication
+
+    @property
+    def AuthorizedProxyOrganizationOpenId(self):
+        """被授权的合作方企业在第三方平台子客企业标识，即ProxyOrganizationOpenId，当操作类型包含 PARTNER_AUTO_SIGN_AUTH 且要进行合作方企业授权自动签时必传。
+
+
+
+        :rtype: str
+        """
+        return self._AuthorizedProxyOrganizationOpenId
+
+    @AuthorizedProxyOrganizationOpenId.setter
+    def AuthorizedProxyOrganizationOpenId(self, AuthorizedProxyOrganizationOpenId):
+        self._AuthorizedProxyOrganizationOpenId = AuthorizedProxyOrganizationOpenId
+
 
     def _deserialize(self, params):
         if params.get("Agent") is not None:
@@ -12587,6 +12894,8 @@ class CreateBatchInitOrganizationUrlRequest(AbstractModel):
             self._Agent._deserialize(params.get("Agent"))
         self._OperateTypes = params.get("OperateTypes")
         self._ProxyOrganizationOpenIds = params.get("ProxyOrganizationOpenIds")
+        self._IsAuthorizePlatformApplication = params.get("IsAuthorizePlatformApplication")
+        self._AuthorizedProxyOrganizationOpenId = params.get("AuthorizedProxyOrganizationOpenId")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -15804,7 +16113,7 @@ class CreateSignUrlsRequest(AbstractModel):
         :type FlowGroupId: str
         :param _Endpoint: 签署链接类型,可以设置的参数如下
 <ul><li> **WEIXINAPP** :(默认)跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型 ，此时返回短链</li>
-<li> **CHANNEL** :带有H5引导页的跳转电子签小程序的链接</li>
+<li> **CHANNEL** :带有H5引导页的跳转电子签小程序的链接(<b>GenerateType非ALL时候不能设置成CHANNEL</b>)</li>
 <li> **APP** :第三方App或小程序跳转电子签小程序的path, App或者小程序跳转适合此类型</li>
 <li> **LONGURL2WEIXINAPP** :跳转电子签小程序的链接, H5跳转适合此类型，此时返回长链</li></ul>
 
@@ -15944,7 +16253,7 @@ class CreateSignUrlsRequest(AbstractModel):
     def Endpoint(self):
         """签署链接类型,可以设置的参数如下
 <ul><li> **WEIXINAPP** :(默认)跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型 ，此时返回短链</li>
-<li> **CHANNEL** :带有H5引导页的跳转电子签小程序的链接</li>
+<li> **CHANNEL** :带有H5引导页的跳转电子签小程序的链接(<b>GenerateType非ALL时候不能设置成CHANNEL</b>)</li>
 <li> **APP** :第三方App或小程序跳转电子签小程序的path, App或者小程序跳转适合此类型</li>
 <li> **LONGURL2WEIXINAPP** :跳转电子签小程序的链接, H5跳转适合此类型，此时返回长链</li></ul>
 
@@ -18049,7 +18358,7 @@ class DescribeTemplatesRequest(AbstractModel):
 
 设置为true之后， 返回参数PdfUrl，为模板PDF文件链接，有效期5分钟, 可以用于将PDF文件下载到本地
 
-注: `此功能为白名单功能，使用前请联系对接的客户经理沟通。`
+注: `此功能需要开通功能白名单【第三方应用集成企业获取模版PDF下载链接】，使用前请联系对接的客户经理沟通。`
         :type WithPdfUrl: bool
         :param _Operator: 操作者的信息
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
@@ -18224,7 +18533,7 @@ class DescribeTemplatesRequest(AbstractModel):
 
 设置为true之后， 返回参数PdfUrl，为模板PDF文件链接，有效期5分钟, 可以用于将PDF文件下载到本地
 
-注: `此功能为白名单功能，使用前请联系对接的客户经理沟通。`
+注: `此功能需要开通功能白名单【第三方应用集成企业获取模版PDF下载链接】，使用前请联系对接的客户经理沟通。`
         :rtype: bool
         """
         return self._WithPdfUrl
@@ -19438,6 +19747,9 @@ class FlowApproverDetail(AbstractModel):
         :param _ApproverRoleName: 自定义签署人的角色名, 如: 收款人、开具人、见证人等
 注意：此字段可能返回 null，表示取不到有效值。
         :type ApproverRoleName: str
+        :param _SignId: 签署参与人在本流程中的编号ID（每个流程不同），可用此ID来定位签署参与人在本流程的签署节点。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type SignId: str
         """
         self._ReceiptId = None
         self._ProxyOrganizationOpenId = None
@@ -19451,6 +19763,7 @@ class FlowApproverDetail(AbstractModel):
         self._ApproveTime = None
         self._ApproveType = None
         self._ApproverRoleName = None
+        self._SignId = None
 
     @property
     def ReceiptId(self):
@@ -19605,6 +19918,18 @@ class FlowApproverDetail(AbstractModel):
     def ApproverRoleName(self, ApproverRoleName):
         self._ApproverRoleName = ApproverRoleName
 
+    @property
+    def SignId(self):
+        """签署参与人在本流程中的编号ID（每个流程不同），可用此ID来定位签署参与人在本流程的签署节点。
+注意：此字段可能返回 null，表示取不到有效值。
+        :rtype: str
+        """
+        return self._SignId
+
+    @SignId.setter
+    def SignId(self, SignId):
+        self._SignId = SignId
+
 
     def _deserialize(self, params):
         self._ReceiptId = params.get("ReceiptId")
@@ -19619,6 +19944,7 @@ class FlowApproverDetail(AbstractModel):
         self._ApproveTime = params.get("ApproveTime")
         self._ApproveType = params.get("ApproveType")
         self._ApproverRoleName = params.get("ApproverRoleName")
+        self._SignId = params.get("SignId")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -19736,14 +20062,16 @@ class FlowApproverInfo(AbstractModel):
         :param _ApproverOption: 可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人、是否为动态补充签署人等。
 详细操作可以参考开发者中心的ApproverOption结构体。
         :type ApproverOption: :class:`tencentcloud.essbasic.v20210526.models.ApproverOption`
-        :param _ApproverNeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+        :param _ApproverNeedSignReview: 此签署人（员工或者个人）签署前，是否需要发起方企业进行审批，取值如下：
 <ul><li>**false**：（默认）不需要审批，直接签署。</li>
-<li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
+<li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待发起方企业内部审批完成。</li></ul>
 企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
 <ul><li>如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
 <li>如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
 
-注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
+注：`此功能可用于与发起方企业内部的审批流程进行关联，支持手动、静默签署合同`
+
+![image](https://qcloudimg.tencent-cloud.cn/raw/b14d5188ed0229d1401e74a9a49cab6d.png)
         :type ApproverNeedSignReview: bool
         :param _ApproverVerifyTypes: 指定个人签署方查看合同的校验方式,可以传值如下:
 <ul><li>  **1**   : （默认）人脸识别,人脸识别后才能合同内容</li>
@@ -19814,6 +20142,9 @@ class FlowApproverInfo(AbstractModel):
 2. 使用视频认证时，<b>生成H5签署链接的时候必须将签署认证方式指定为人脸</b>（即ApproverSignTypes设置成人脸签署）。
 3. 签署完成后，可以通过<a href="https://qian.tencent.com/developers/partnerApis/flows/ChannelDescribeSignFaceVideo" target="_blank">查询签署认证人脸视频</a>获取到当时的视频。
         :type Intention: :class:`tencentcloud.essbasic.v20210526.models.Intention`
+        :param _SignEndpoints: 进入签署流程的限制，目前支持以下选项：
+<ul><li> <b>空值（默认）</b> :无限制，可在任何场景进入签署流程。</li><li> <b>link</b> :选择此选项后，将无法通过控制台或电子签小程序列表进入填写或签署操作，仅可预览合同。填写或签署流程只能通过短信或发起方提供的专用链接进行。</li></ul>
+        :type SignEndpoints: list of str
         """
         self._Name = None
         self._IdCardType = None
@@ -19842,6 +20173,7 @@ class FlowApproverInfo(AbstractModel):
         self._SignTypeSelector = None
         self._Components = None
         self._Intention = None
+        self._SignEndpoints = None
 
     @property
     def Name(self):
@@ -20090,14 +20422,16 @@ class FlowApproverInfo(AbstractModel):
 
     @property
     def ApproverNeedSignReview(self):
-        """发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+        """此签署人（员工或者个人）签署前，是否需要发起方企业进行审批，取值如下：
 <ul><li>**false**：（默认）不需要审批，直接签署。</li>
-<li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
+<li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待发起方企业内部审批完成。</li></ul>
 企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
 <ul><li>如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
 <li>如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
 
-注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
+注：`此功能可用于与发起方企业内部的审批流程进行关联，支持手动、静默签署合同`
+
+![image](https://qcloudimg.tencent-cloud.cn/raw/b14d5188ed0229d1401e74a9a49cab6d.png)
         :rtype: bool
         """
         return self._ApproverNeedSignReview
@@ -20256,6 +20590,18 @@ class FlowApproverInfo(AbstractModel):
     def Intention(self, Intention):
         self._Intention = Intention
 
+    @property
+    def SignEndpoints(self):
+        """进入签署流程的限制，目前支持以下选项：
+<ul><li> <b>空值（默认）</b> :无限制，可在任何场景进入签署流程。</li><li> <b>link</b> :选择此选项后，将无法通过控制台或电子签小程序列表进入填写或签署操作，仅可预览合同。填写或签署流程只能通过短信或发起方提供的专用链接进行。</li></ul>
+        :rtype: list of str
+        """
+        return self._SignEndpoints
+
+    @SignEndpoints.setter
+    def SignEndpoints(self, SignEndpoints):
+        self._SignEndpoints = SignEndpoints
+
 
     def _deserialize(self, params):
         self._Name = params.get("Name")
@@ -20304,6 +20650,7 @@ class FlowApproverInfo(AbstractModel):
         if params.get("Intention") is not None:
             self._Intention = Intention()
             self._Intention._deserialize(params.get("Intention"))
+        self._SignEndpoints = params.get("SignEndpoints")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

{tencentcloud-sdk-python-essbasic-3.0.1267 → tencentcloud-sdk-python-essbasic-3.0.1277}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.2
 Name: tencentcloud-sdk-python-essbasic
-Version: 3.0.1267
+Version: 3.0.1277
 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.1277/tencentcloud_sdk_python_essbasic.egg-info/requires.txt

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

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

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