tencentcloud-sdk-python-essbasic 3.0.1062__tar.gz → 3.0.1070__tar.gz

{tencentcloud-sdk-python-essbasic-3.0.1062 → tencentcloud-sdk-python-essbasic-3.0.1070}/PKG-INFO

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

{tencentcloud-sdk-python-essbasic-3.0.1062 → tencentcloud-sdk-python-essbasic-3.0.1070}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1062'
+__version__ = '3.0.1070'

{tencentcloud-sdk-python-essbasic-3.0.1062 → tencentcloud-sdk-python-essbasic-3.0.1070}/tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -91,9 +91,9 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelCancelMultiFlowSignQRCode(self, request):
-        """此接口（CancelMultiFlowSignQRCode）用于废除一码多扫流程签署二维码。
-        该接口所需的二维码ID，源自[创建一码多扫流程签署二维码](https://qian.tencent.com/developers/partnerApis/templates/ChannelCreateMultiFlowSignQRCode)生成的。
-        如果该二维码尚处于有效期内，可通过本接口将其设置为失效状态。
+        """此接口（CancelMultiFlowSignQRCode）用于废除取消一码多签签署码。
+        该接口所需的二维码ID，源自[创建一码多签签署码](https://qian.tencent.com/developers/partnerApis/templates/ChannelCreateMultiFlowSignQRCode)生成的。
+        如果该签署码尚处于有效期内，可通过本接口将其设置为失效状态。
 
         :param request: Request instance for ChannelCancelMultiFlowSignQRCode.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCancelMultiFlowSignQRCodeRequest`
@@ -207,7 +207,7 @@ class EssbasicClient(AbstractClient):
         注：
         - 使用此接口生成链接，需要提前开通 `使用手机号验证签署方身份` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。
         - 参与人点击链接后需短信验证码才能查看合同内容。
-        - 企业用户批量签署，需要传OrganizationName（参与方所在企业名称）参数生成签署链接，`请确保此企业已完成腾讯电子签企业认证`。若为子客企业，请确保员工已经加入企业。
+        - 企业用户批量签署，需要传OrganizationName（参与方所在企业名称）参数生成签署链接，`请确保此企业已完成腾讯电子签企业认证`。暂时仅支持给`自建应用集成企业` 生成员工批签链接，不支持子客企业。
         - 个人批量签署，签名区`仅支持手写签名`。
 
         :param request: Request instance for ChannelCreateBatchSignUrl.
@@ -721,7 +721,7 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelCreateMultiFlowSignQRCode(self, request):
-        """此接口（ChannelCreateMultiFlowSignQRCode）用于创建一码多扫流程签署二维码。
+        """此接口（ChannelCreateMultiFlowSignQRCode）用于创建一码多签签署码。
 
         **适用场景**:
         签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景，例如：劳务工招工、大批量员工入职等场景。
@@ -731,11 +731,11 @@ class EssbasicClient(AbstractClient):
             - 模板中配置的签署顺序是无序
             - B端企业的签署方式是静默签署
             - B端企业是非首位签署
-        2. 通过一码多扫二维码发起的合同，合同涉及到的回调消息可参考文档[合同发起及签署相关回调
+        2. 通过扫描一码多签签署码发起的合同，合同涉及到的回调消息可参考文档[合同发起及签署相关回调
         ]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
-        3. 用户通过签署二维码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
+        3. 用户通过扫描一码多签签署码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
 
-        二维码的样式如下图:
+        签署码的样式如下图:
         ![image](https://qcloudimg.tencent-cloud.cn/raw/27317cf5aacb094fb1dc6f94179a5148.png )
 
         :param request: Request instance for ChannelCreateMultiFlowSignQRCode.
@@ -815,6 +815,41 @@ class EssbasicClient(AbstractClient):
         注意：
         1. 只支持PC浏览器操作使用
 
+        **嵌入式签署人-各种场景传参说明**:
+
+        <table>
+        <thead>
+        <tr>
+        <th>场景编号</th>
+        <th>可作为签署方的类型</th>
+        <th>签署方传参说明</th>
+        </tr>
+        </thead>
+
+        <tbody>
+        <tr>
+        <td>场景一</td>
+        <td>第三方子企业A员工</td>
+        <td>OpenId、OrganizationName、OrganizationOpenId必传 ,ApproverType设置为ORGANIZATION</td>
+        </tr>
+        <tr>
+        <td>场景二</td>
+        <td>第三方子企业B员工</td>
+        <td>OpenId、OrganizationOpenId、OrganizationName必传, ApproverType设置为ORGANIZATION</td>
+        </tr>
+        <tr>
+        <td>场景三</td>
+        <td>SaaS平台企业员工</td>
+        <td>Name、Mobile、OrganizationName必传，NotChannelOrganization=True。 ApproverType设置为ORGANIZATION</td>
+        </tr>
+        <tr>
+        <td>场景四</td>
+        <td>个人/自然人</td>
+        <td>Name、Mobile必传, ApproverType设置为PERSON</td>
+        </tr>
+        </tbody>
+        </table>
+
         嵌入的页面样式如下：
         ![image](https://qcloudimg.tencent-cloud.cn/raw/b2ae013fb4d747891dd3815bbe897208.png)
 
@@ -1489,16 +1524,26 @@ class EssbasicClient(AbstractClient):
 
 
     def CreateChannelOrganizationInfoChangeUrl(self, request):
-        """此接口（CreateChannelOrganizationInfoChangeUrl）用于创建子客企业信息变更链接（需要在移动端打开，会跳转到微信小程序），支持创建企业超管变更链接或企业基础信息变更链接，通过入参 ChangeType 指定。
+        """此接口（CreateChannelOrganizationInfoChangeUrl）用于创建子客企业信息变更链接。
 
+        <h3 id="1">支持变更链接类型，通过入参 Endpoint 指定，默认为WEIXINAPP。</h3>
 
-        <h3 id="1-企业超管变更">1. 企业超管变更</h3>
+        <h4 id="WEIXINAPP">WEIXINAPP</h4>
+        <p>创建变更短链。需要在移动端打开，会跳转到微信腾讯电子签小程序进行更换。</p>
+
+        <h4 id="APP">APP</h4>
+        <p>创建变更小程序链接，可从第三方APP跳转到微信腾讯电子签小程序进行更换。</p>
+
+
+        <h3 id="2">支持创建企业超管变更链接或企业基础信息变更链接，通过入参 ChangeType 指定。</h3>
+
+        <h4 id="1-企业超管变更">1. 企业超管变更</h4>
 
         <p>换成企业的其他员工来当超管</p>
 
-        <h3 id="2-企业基础信息变更">2. 企业基础信息变更</h3>
+        <h4 id="2-企业基础信息变更">2. 企业基础信息变更</h4>
 
-        <h4 id="可以变动">可以变动</h4>
+        <h5 id="可以变动">可以变动</h5>
 
         <ul>
         <li>企业名称<br>
@@ -1508,7 +1553,7 @@ class EssbasicClient(AbstractClient):
         <li>企业地址和所在地</li>
         </ul>
 
-        <h4 id="不可变动">不可变动</h4>
+        <h5 id="不可变动">不可变动</h5>
 
         <ul>
         <li>统一社会信用代码<br>
@@ -1520,7 +1565,7 @@ class EssbasicClient(AbstractClient):
 
         <ul>
         <li>合同:   老合同不做任何处理,   新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
-        <li>印章:   会删除所有的印章所有的机构公章和合同专用章,  然后用新企业名称生成新的机构公章 和合同专用章,  而法人章, 财务专用章和人事专用章不会处理</li>
+        <li>印章:   会删除所有的印章所有的机构公章，合同专用章，财务专用章和人事专用章,  然后用新企业名称生成新的机构公章，合同专用章，财务专用章和人事专用章,  而法人章不会处理</li>
         <li>证书:   企业证书会重新请求CA机构用新企业名称生成新的证书</li>
         </ul>
 
@@ -1559,6 +1604,7 @@ class EssbasicClient(AbstractClient):
         <th>子客企业状态</th>
         <th>子客企业员工状态</th>
         <th>点击链接进入的流程</th>
+        <th>视频样例</th>
         </tr>
         </thead>
         <tbody>
@@ -1566,16 +1612,19 @@ class EssbasicClient(AbstractClient):
         <td>企业未激活</td>
         <td>员工未认证</td>
         <td>进入企业激活流程，首次完成企业激活流程的员工会成为超管</td>
+        <td><a href="https://dyn.ess.tencent.cn/guide/apivideo/CreateConsoleLoginUrl_noverify.mp4" target="_blank">打开</a></td>
         </tr>
         <tr>
         <td>企业已激活</td>
         <td>员工未认证</td>
         <td>进入员认证并加入企业流程</td>
+        <td>-</td>
         </tr>
         <tr>
         <td>企业已激活</td>
         <td>员工已认证</td>
         <td>进入子客企业Web控制台</td>
+        <td>-</td>
         </tr>
         </tbody>
         </table>
@@ -1790,8 +1839,8 @@ class EssbasicClient(AbstractClient):
         |  WEIXINAPP  | 短链跳转腾讯电子签小程序签署场景  |  点击链接打开电子签小程序（与腾讯电子签官方短信提醒用户签署形式一样）<br> 示例: https://essurl.cn/x9nvWU8fTg|
         |  LONGURL2WEIXINAPP  | 长链跳转腾讯电子签小程序签署场景  |  点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
         |  CHANNEL  | 带有H5引导页的跳转腾讯电子签小程序签署场景 |  点击链接打开一个H5引导页面, 页面中有个"前往小程序"的按钮, 点击后会跳转到腾讯电子签小程序签署场景;  签署完成会回到H5引导页面, 然后跳转到指定创建链接指定的JumpUrl<br>示例: https://res.ess.tencent.cn/cdn/h5-activity-beta/jump-mp.html?use=channel-guide&type=warning&token=uIFKIU8fTd |
-        |APP| 贵方App跳转腾讯电子签小程序签署场景|  贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方App的场景<br>跳转到腾讯电子签小程序的实现可以参考微信的官方文档:<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html" target="_blank">开放能力/打开 App</a> <br> 示例: pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
-        |APP| 贵方小程序跳转腾讯电子签小程序签署场景|  贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方小程序的场景<br>跳转到腾讯电子签小程序的实现可以参考微信官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" target="_blank">全屏方式</a>和<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html " target="_blank">半屏方式</a><br>此时返回的SignUrl就是官方文档中的path<br> 示例:pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3  |
+        |APP| <font color="red">贵方APP</font>跳转腾讯电子签小程序签署场景|  贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方App的场景<br>跳转到腾讯电子签小程序的实现可以参考微信的官方文档:<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html" target="_blank">开放能力/打开 App</a> <br> 示例: pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
+        |APP| <font color="red">贵方小程序</font>跳转腾讯电子签小程序签署场景|  贵方小程序直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方小程序的场景<br>跳转到腾讯电子签小程序的实现可以参考微信官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" target="_blank">全屏方式</a>和<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html " target="_blank">半屏方式</a><br>此时返回的SignUrl就是官方文档中的path<br> 示例:pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3  |
 
         :param request: Request instance for CreateSignUrls.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateSignUrlsRequest`
@@ -1976,14 +2025,20 @@ class EssbasicClient(AbstractClient):
 
     def DescribeExtendedServiceAuthInfo(self, request):
         """查询企业扩展服务的开通和授权情况，当前支持查询以下内容：
-        1. 企业自动签
-        2. 企业与港澳台居民签署合同
-        3. 使用手机号验证签署方身份
-        4. 骑缝章
-        5. 拓宽签署方年龄限制
-        6. 下载企业合同/文件
 
-        注: 此接口 参数Agent. ProxyOperator.OpenId 需要传递超管或者法人的OpenId
+        1. **企业自动签**
+        2. **企业与港澳台居民签署合同**
+        3. **使用手机号验证签署方身份**
+        4. **骑缝章**
+        5. **拓宽签署方年龄限制**
+        6. **下载企业合同/文件**
+        7. **隐藏合同经办人姓名**
+
+        对应能力开通页面在子客控制台-企业中心-拓展服务，如下图所示:
+
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/931a1e02955ab36e5cc69a489af10352.jpg)
+
+        注: <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
 
         :param request: Request instance for DescribeExtendedServiceAuthInfo.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeExtendedServiceAuthInfoRequest`
@@ -2173,28 +2228,21 @@ class EssbasicClient(AbstractClient):
 
 
     def ModifyExtendedService(self, request):
-        """修改（操作）企业扩展服务 ，企业经办人需要是企业超管或者法人。
+        """管理企业扩展服务 ，企业经办人需要是企业超管或者法人。
 
         跳转小程序的几种方式：主要是设置不同的EndPoint
         1. 通过链接Url直接跳转到小程序，不需要返回
         设置EndPoint为WEIXINAPP，得到链接打开即可。
 
         2. 客户App直接跳转到小程序-->腾讯电子签小程序操作完成-->返回App
-        跳转到小程序的实现，参考官方文档
-        https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html
-        其中小程序的原始Id，请联系<对接技术人员>获取，或者查看小程序信息自助获取。
+        跳转到小程序的实现，参考官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html">打开 App</a>
         设置EndPoint为APP，得到path。
 
-        4. 客户小程序直接跳到电子签小程序-->腾讯电子签小程序操作完成--->回到客户小程序
-        跳转到小程序的实现，参考官方文档（分为全屏、半屏两种方式）
-        全屏方式：
-        （https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html）
-        半屏方式：
-        （https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html）
-        其中小程序的原始Id，请联系<对接技术人员>获取，或者查看小程序信息自助获取。
+        3. 客户小程序直接跳到电子签小程序-->腾讯电子签小程序操作完成--->回到客户小程序
+        跳转到小程序的实现，参考官方文档（分为<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>
         设置EndPoint为APP，得到path。
 
-        其中小程序的原始Id如下，或者查看小程序信息自助获取。
+        4.其中小程序的原始Id如下，或者查看小程序信息自助获取。
 
         | 小程序 | AppID | 原始ID |
         | ------------ | ------------ | ------------ |

{tencentcloud-sdk-python-essbasic-3.0.1062 → tencentcloud-sdk-python-essbasic-3.0.1070}/tencentcloud/essbasic/v20210526/models.py

@@ -1642,7 +1642,7 @@ class ChannelCancelMultiFlowSignQRCodeRequest(AbstractModel):
 </ul>
 第三方平台子客企业和员工必须已经经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _QrCodeId: 需要取消签署的二维码ID，为32位字符串。由[创建一码多扫流程签署二维码](https://qian.tencent.com/developers/partnerApis/templates/ChannelCreateMultiFlowSignQRCode)返回
+        :param _QrCodeId: 需要取消的签署码ID，为32位字符串。由[创建一码多签签署码](https://qian.tencent.com/developers/partnerApis/templates/ChannelCreateMultiFlowSignQRCode)返回
         :type QrCodeId: str
         :param _Operator: 暂未开放
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
@@ -1837,9 +1837,9 @@ class ChannelCreateBatchCancelFlowUrlRequest(AbstractModel):
 <ul>
 <li>渠道应用标识:  Agent.AppId</li>
 <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
-<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
 </ul>
-第三方平台子客企业和员工必须已经经过实名认证
+第三方平台子客企业和员工必须已经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _FlowIds: 要撤销的合同流程ID列表，最多100个，超过100不处理
         :type FlowIds: list of str
@@ -1905,6 +1905,8 @@ class ChannelCreateBatchCancelFlowUrlResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _BatchCancelFlowUrl: 批量撤销合同的URL链接, 需要在手机端打开, 有效期24小时
+
+注：<font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
         :type BatchCancelFlowUrl: str
         :param _FailMessages: 与入参的FlowIds数组一致,   成功生成到撤销链接中,则为"",   不能撤销合同则为失败原因
         :type FailMessages: list of str
@@ -2152,7 +2154,15 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Agent: 关于渠道应用的相关信息，包括子客企业及应用编、号等详细内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+        :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 _Name: 签署方经办人的姓名。
 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
@@ -2198,7 +2208,7 @@ class ChannelCreateBatchSignUrlRequest(AbstractModel):
 <li>请确认该名称与企业营业执照中注册的名称一致。</li>
 <li>如果名称中包含英文括号()，请使用中文括号（）代替。</li>
 <li>请确保此企业已完成腾讯电子签企业认证。</li>
-<li>若为子客企业，请确保员工已经加入企业。</li>
+<li>暂时仅支持给`自建应用集成企业` 生成员工批签链接，不支持子客企业。</li>
 </ul>
         :type OrganizationName: str
         :param _JumpToDetail: 是否直接跳转至合同内容页面进行签署
@@ -2334,13 +2344,17 @@ class ChannelCreateBatchSignUrlResponse(AbstractModel):
         r"""
         :param _SignUrl: 批量签署链接，以短链形式返回，短链的有效期参考回参中的 ExpiredTime。
 
-注: `非小程序和APP集成使用`
+注: 
+1. 非小程序和APP集成使用
+2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
         :type SignUrl: str
         :param _ExpiredTime: 链接过期时间以 Unix 时间戳格式表示，从生成链接时间起，往后7天有效期。过期后短链将失效，无法打开。
         :type ExpiredTime: int
         :param _MiniAppPath: 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
 
-注: `小程序和APP集成使用`
+注: 
+1. 小程序和APP集成使用
+2. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
         :type MiniAppPath: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -2988,9 +3002,9 @@ class ChannelCreateFlowByFilesRequest(AbstractModel):
 
 此接口下面信息必填。
 <ul>
-<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
-<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
-<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
 </ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
@@ -4279,9 +4293,9 @@ class ChannelCreateMultiFlowSignQRCodeResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _QrCode: 签署二维码的基本信息，用于创建二维码，用户可扫描该二维码进行签署操作。	
+        :param _QrCode: 一码多签签署码的基本信息，用户可扫描该二维码进行签署操作。	
         :type QrCode: :class:`tencentcloud.essbasic.v20210526.models.SignQrCode`
-        :param _SignUrls: 流程签署二维码的签署信息，适用于客户系统整合二维码功能。通过链接，用户可直接访问电子签名小程序并签署合同。	
+        :param _SignUrls: 一码多签签署码链接信息，适用于客户系统整合二维码功能。通过链接，用户可直接访问电子签名小程序并签署合同。	
         :type SignUrls: :class:`tencentcloud.essbasic.v20210526.models.SignUrl`
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -8710,223 +8724,188 @@ class Component(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ComponentId: 控件编号
+        :param _ComponentId: 控件唯一ID。
 
-CreateFlowByTemplates发起合同时优先以ComponentId（不为空）填充；否则以ComponentName填充
+**在绝对定位方式方式下**，ComponentId为控件的ID，长度不能超过30，只能由中文、字母、数字和下划线组成，可以在后续的操作中使用该名称来引用控件。
+
+**在关键字定位方式下**，ComponentId不仅为控件的ID，也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
+
+例：
+
+- 如传入的关键字<font color="red">"^甲方签署^"</font >，则会在PDF文件中有且仅有"甲方签署"关键字的地方（<font color="red">前后不能有其他字符</font >）进行对应操作。
+- 如传入的关键字为<font color="red">"甲方签署</font >"，则PDF文件中每个出现关键字的位置（<font color="red">前后可以有其他字符</font >）都会执行相应操作。
+- 如传入的关键字为<font color="red">"^甲方签署</font >"，则PDF文件中每个出现关键字的位置（<font color="red">前面不能有其他字符</font >）都会执行相应操作。
+- 如传入的关键字为<font color="red">"甲方签署^</font >"，则PDF文件中每个出现关键字的位置（<font color="red">后面不能有其他字符</font >）都会执行相应操作。
 
-注：
-当GenerateMode=KEYWORD时，通过"^"来决定是否使用关键字整词匹配能力。
-例：当GenerateMode=KEYWORD时，如果传入关键字"^甲方签署^"，则会在PDF文件中有且仅有"甲方签署"关键字的地方进行对应操作。
-如传入的关键字为"甲方签署"，则PDF文件中每个出现关键字的位置都会执行相应操作。
 
-创建控件时，此值为空
-查询时返回完整结构
+注：`控件ID可以在一个PDF中不可重复`
+
         :type ComponentId: str
-        :param _ComponentType: 如果是Component控件类型，则可选的字段为：
-TEXT - 普通文本控件，输入文本字符串；
-MULTI_LINE_TEXT - 多行文本控件，输入文本字符串；
-CHECK_BOX - 勾选框控件，若选中填写ComponentValue 填写 true或者 false 字符串；
-FILL_IMAGE - 图片控件，ComponentValue 填写图片的资源 ID；
-DYNAMIC_TABLE - 动态表格控件；
-ATTACHMENT - 附件控件,ComponentValue 填写附件图片的资源 ID列表，以逗号分割；
-SELECTOR - 选择器控件，ComponentValue填写选择的字符串内容；
-DATE - 日期控件；默认是格式化为xxxx年xx月xx日字符串；
-DISTRICT - 省市区行政区控件，ComponentValue填写省市区行政区字符串内容；
-
-如果是SignComponent控件类型，则可选的字段为
-SIGN_SEAL - 签署印章控件；
-SIGN_DATE - 签署日期控件；
-SIGN_SIGNATURE - 用户签名控件；
-SIGN_PERSONAL_SEAL - 个人签署印章控件（使用文件发起暂不支持此类型）；
-SIGN_PAGING_SEAL - 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
-SIGN_OPINION - 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认;
-SIGN_LEGAL_PERSON_SEAL - 企业法定代表人控件。
-
-表单域的控件不能作为印章和签名控件
+        :param _ComponentType: **如果是Component填写控件类型，则可选的字段为**：
+
+<ul><li> <b>TEXT</b> : 普通文本控件，输入文本字符串；</li>
+<li> <b>MULTI_LINE_TEXT</b> : 多行文本控件，输入文本字符串；</li>
+<li> <b>CHECK_BOX</b> : 勾选框控件，若选中填写ComponentValue 填写 true或者 false 字符串；</li>
+<li> <b>FILL_IMAGE</b> : 图片控件，ComponentValue 填写图片的资源 ID；</li>
+<li> <b>DYNAMIC_TABLE</b> : 动态表格控件；</li>
+<li> <b>ATTACHMENT</b> : 附件控件,ComponentValue 填写附件图片的资源 ID列表，以逗号分隔；</li>
+<li> <b>SELECTOR</b> : 选择器控件，ComponentValue填写选择的字符串内容；</li>
+<li> <b>DATE</b> : 日期控件；默认是格式化为xxxx年xx月xx日字符串；</li>
+<li> <b>DISTRICT</b> : 省市区行政区控件，ComponentValue填写省市区行政区字符串内容；</li></ul>
+
+**如果是SignComponent签署控件类型，则可选的字段为**
+
+<ul><li> <b>SIGN_SEAL</b> : 签署印章控件；</li>
+<li> <b>SIGN_DATE</b> : 签署日期控件；</li>
+<li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
+<li> <b>SIGN_PERSONAL_SEAL</b> : 个人签署印章控件（使用文件发起暂不支持此类型）；</li>
+<li> <b>SIGN_PAGING_SEAL</b> : 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight</li>
+<li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
+<li> <b>SIGN_LEGAL_PERSON_SEAL</b> : 企业法定代表人控件。</li></ul>
+注：` 表单域的控件不能作为印章和签名控件`
         :type ComponentType: str
-        :param _ComponentName: 控件简称，不超过30个字符
+        :param _ComponentName: **在绝对定位方式方式下**，ComponentName为控件名，长度不能超过20，只能由中文、字母、数字和下划线组成，可以在后续的操作中使用该名称来引用控件。
+
+**在表单域定位方式下**，ComponentName不仅为控件名，也是表单域名称。
+
+注：`控件名可以在一个PDF中可以重复`
+
         :type ComponentName: str
-        :param _ComponentRequired: 控件是否为必填项，
-默认为false-非必填
+        :param _ComponentRequired: 如果是<b>填写控件</b>，ComponentRequired表示在填写页面此控件是否必填
+<ul><li>false（默认）：可以不填写</li>
+<li>true ：必须填写此填写控件</li></ul>
+如果是<b>签署控件</b>，签批控件中签署意见等可以不填写， 其他签署控件不受此字段影响
         :type ComponentRequired: bool
-        :param _ComponentRecipientId: 控件关联的参与方ID，对应Recipient结构体中的RecipientId	
+        :param _ComponentRecipientId: **在通过接口拉取控件信息场景下**，为出参参数，此控件归属的参与方的角色ID角色（即RecipientId），**发起合同时候不要填写此字段留空即可**
         :type ComponentRecipientId: str
-        :param _FileIndex: 控件所属文件的序号 (文档中文件的排列序号，从0开始)
+        :param _FileIndex: <font color="red">【暂未使用】</font>控件所属文件的序号（取值为：0-N）。 目前单文件的情况下，值一直为0
         :type FileIndex: int
         :param _GenerateMode: 控件生成的方式：
-NORMAL - 普通控件
-FIELD - 表单域
-KEYWORD - 关键字（设置关键字时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找）
+<ul><li> <b>NORMAL</b> : 绝对定位控件</li>
+<li> <b>FIELD</b> : 表单域</li>
+<li> <b>KEYWORD</b> : 关键字（设置关键字时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找）</li></ul>
         :type GenerateMode: str
-        :param _ComponentWidth: 参数控件宽度，默认100，单位px
-表单域和关键字转换控件不用填
+        :param _ComponentWidth: **在绝对定位方式和关键字定位方式下**，指定控件宽度，控件宽度是指控件在PDF文件中的宽度，单位为pt（点）。
+
         :type ComponentWidth: float
-        :param _ComponentHeight: 参数控件高度，默认100，单位px
-表单域和关键字转换控件不用填
+        :param _ComponentHeight: **在绝对定位方式和关键字定位方式下**，指定控件的高度， 控件高度是指控件在PDF文件中的高度，单位为pt（点）。
+
         :type ComponentHeight: float
-        :param _ComponentPage: 参数控件所在页码，从1开始
+        :param _ComponentPage: **在绝对定位方式方式下**，指定控件所在PDF文件上的页码
+
+注：
+1. 页码编号是从<font color="red">1</font>开始编号的。
+2.  <font color="red">页面编号不能超过PDF文件的页码总数</font>。如果指定的页码超过了PDF文件的页码总数，在填写和签署时会出现错误，导致无法正常进行操作。
         :type ComponentPage: int
-        :param _ComponentPosX: 参数控件X位置，单位px
+        :param _ComponentPosX: **在绝对定位方式和关键字定位方式下**，可以指定控件横向位置的位置，单位为pt（点）。
         :type ComponentPosX: float
-        :param _ComponentPosY: 参数控件Y位置，单位px
+        :param _ComponentPosY: **在绝对定位方式和关键字定位方式下**，可以指定控件纵向位置的位置，单位为pt（点）。
         :type ComponentPosY: float
-        :param _ComponentExtra: 扩展参数：
-为JSON格式。
-不同类型的控件会有部分非通用参数
-
-ComponentType为TEXT、MULTI_LINE_TEXT时，支持以下参数：
-1 Font：目前只支持黑体、宋体
-2 FontSize： 范围12-72
-3 FontAlign： Left/Right/Center，左对齐/居中/右对齐
-4 FontColor：字符串类型，格式为RGB颜色数字
-参数样例：{\"FontColor\":\"255,0,0\",\"FontSize\":12}
-
-ComponentType为FILL_IMAGE时，支持以下参数：
-NotMakeImageCenter：bool。是否设置图片居中。false：居中（默认）。 true: 不居中
-FillMethod: int. 填充方式。0-铺满（默认）；1-等比例缩放
-
-ComponentType为SIGN_SIGNATURE类型可以控制签署方式
-{“ComponentTypeLimit”: [“xxx”]}
-xxx可以为：
-HANDWRITE – 手写签名
-OCR_ESIGN -- AI智能识别手写签名
-ESIGN -- 个人印章类型
-SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
-如：{“ComponentTypeLimit”: [“SYSTEM_ESIGN”]}
-
-ComponentType为SIGN_DATE时，支持以下参数：
-1 Font：字符串类型目前只支持"黑体"、"宋体"，如果不填默认为"黑体"
-2 FontSize： 数字类型，范围6-72，默认值为12
-3 FontAlign： 字符串类型，可取Left/Right/Center，对应左对齐/居中/右对齐
-4 Format： 字符串类型，日期格式，必须是以下五种之一 “yyyy m d”，”yyyy年m月d日”，”yyyy/m/d”，”yyyy-m-d”，”yyyy.m.d”。
-5 Gaps:： 字符串类型，仅在Format为“yyyy m d”时起作用，格式为用逗号分开的两个整数，例如”2,2”，两个数字分别是日期格式的前后两个空隙中的空格个数
+        :param _ComponentExtra: **在所有的定位方式下**，控件的扩展参数，为<font color="red">JSON格式</font>，不同类型的控件会有部分非通用参数。
+
+<font color="red">ComponentType为TEXT、MULTI_LINE_TEXT时</font>，支持以下参数：
+<ul><li> <b>Font</b>：目前只支持黑体、宋体</li>
+<li> <b>FontSize</b>： 范围12 :72</li>
+<li> <b>FontAlign</b>： Left/Right/Center，左对齐/居中/右对齐</li>
+<li> <b>FontColor</b>：字符串类型，格式为RGB颜色数字</li></ul>
+<b>参数样例</b>：`{"FontColor":"255,0,0","FontSize":12}`
+
+<font color="red">ComponentType为FILL_IMAGE时</font>，支持以下参数：
+<ul><li> <b>NotMakeImageCenter</b>：bool。是否设置图片居中。false：居中（默认）。 true : 不居中</li>
+<li> <b>FillMethod</b> : int. 填充方式。0-铺满（默认）；1-等比例缩放</li></ul>
+
+<font color="red">ComponentType为SIGN_SIGNATURE类型时</font>，可以**ComponentTypeLimit**参数控制签署方式
+<ul><li> <b>HANDWRITE</b> : 手写签名</li>
+<li> <b>OCR_ESIGN</b> : AI智能识别手写签名</li>
+<li> <b>ESIGN</b> : 个人印章类型</li>
+<li> <b>SYSTEM_ESIGN</b> : 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）</li>
+<li> <b>IMG_ESIGN</b> : 图片印章(该类型支持用户在签署将上传的PNG格式的图片作为签名)</li></ul>
+<b>参考样例</b>：`{"ComponentTypeLimit": ["SYSTEM_ESIGN"]}`
+印章的对应关系参考下图
+![image](https://qcloudimg.tencent-cloud.cn/raw/ee0498856c060c065628a0c5ba780d6b.jpg)
+
+<font color="red">ComponentType为SIGN_DATE时</font>，支持以下参数：
+<ul><li> <b>Font</b> :字符串类型目前只支持"黑体"、"宋体"，如果不填默认为"黑体"</li>
+<li> <b>FontSize</b> : 数字类型，范围6-72，默认值为12</li>
+<li> <b>FontAlign</b> : 字符串类型，可取Left/Right/Center，对应左对齐/居中/右对齐</li>
+<li> <b>Format</b> : 字符串类型，日期格式，必须是以下五种之一 “yyyy m d”，”yyyy年m月d日”，”yyyy/m/d”，”yyyy-m-d”，”yyyy.m.d”。</li>
+<li> <b>Gaps</b> : 字符串类型，仅在Format为“yyyy m d”时起作用，格式为用逗号分开的两个整数，例如”2,2”，两个数字分别是日期格式的前后两个空隙中的空格个数</li></ul>
 如果extra参数为空，默认为”yyyy年m月d日”格式的居中日期
 特别地，如果extra中Format字段为空或无法被识别，则extra参数会被当作默认值处理（Font，FontSize，Gaps和FontAlign都不会起效）
-参数样例： "ComponentExtra": "{"Format":“yyyy m d”,"FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"
-
-ComponentType为SIGN_SEAL类型时，支持以下参数：
-1.PageRanges：PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）
-参数样例： "ComponentExtra":"{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"
-        :type ComponentExtra: str
-        :param _ComponentValue: 控件填充vaule，ComponentType和传入值类型对应关系：
-TEXT - 文本内容
-MULTI_LINE_TEXT - 文本内容
-CHECK_BOX - true/false
-FILL_IMAGE、ATTACHMENT - 附件的FileId，需要通过UploadFiles接口上传获取
-SELECTOR - 选项值
-DATE - 默认是格式化为xxxx年xx月xx日
-DYNAMIC_TABLE - 传入json格式的表格内容，具体见数据结构FlowInfo：https://cloud.tencent.com/document/api/1420/61525#FlowInfo
-SIGN_SEAL - 印章ID
-SIGN_PAGING_SEAL - 可以指定印章ID
-
-控件值约束说明：
-企业全称控件：
-  约束：企业名称中文字符中文括号
-  检查正则表达式：/^[\u3400-\u4dbf\u4e00-\u9fa5（）]+$/
-
-统一社会信用代码控件：
-  检查正则表达式：/^[A-Z0-9]{1,18}$/
-
-法人名称控件：
-  约束：最大50个字符，2到25个汉字或者1到50个字母
-  检查正则表达式：/^([\u3400-\u4dbf\u4e00-\u9fa5.·]{2,25}|[a-zA-Z·,\s-]{1,50})$/
-
-签署意见控件：
-  约束：签署意见最大长度为50字符
-
-签署人手机号控件：
-  约束：国内手机号 13,14,15,16,17,18,19号段长度11位
-
-签署人身份证控件：
-  约束：合法的身份证号码检查
-
-控件名称：
-  约束：控件名称最大长度为20字符
-
-单行文本控件：
-  约束：只允许输入中文，英文，数字，中英文标点符号
-
-多行文本控件：
-  约束：只允许输入中文，英文，数字，中英文标点符号
-
-勾选框控件：
-  约束：选择填字符串true，不选填字符串false
-
-选择器控件：
-  约束：同单行文本控件约束，填写选择值中的字符串
-
-数字控件：
-  约束：请输入有效的数字(可带小数点) 
-  检查正则表达式：/^(-|\+)?\d+(\.\d+)?$/
+<b>参数样例</b>： ` "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"`
 
-日期控件：
-  约束：格式：yyyy年mm月dd日
+<font color="red">ComponentType为SIGN_SEAL类型时</font>，支持以下参数：
+<ul><li> <b>PageRanges</b> :PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）</li></ul>
+<b>参数样例</b>：` "{"PageRange":[{"BeginPage":1,"EndPage":-1}]}"`
 
-附件控件：
-  约束：JPG或PNG图片，上传数量限制，1到6个，最大6个附件
 
-图片控件：
-  约束：JPG或PNG图片，填写上传的图片资源ID
-
-邮箱控件：
-  约束：请输入有效的邮箱地址, w3c标准
-  检查正则表达式：/^([A-Za-z0-9_\-.!#$%&])+@([A-Za-z0-9_\-.])+\.([A-Za-z]{2,4})$/
-  参考：https://emailregex.com/
-
-地址控件：
-  同单行文本控件约束
-
-省市区控件：
-  同单行文本控件约束
-
-性别控件：
-  同单行文本控件约束，填写选择值中的字符串
-
-学历控件：
-  同单行文本控件约束，填写选择值中的字符串
+<font color="red">关键字模式下支持关键字找不到的情况下不进行报错的设置</font>
+<ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
+场景说明：如果使用关键字进行定位，但是指定的PDF文件中又没有设置的关键字时，发起合同会进行关键字是否存在的校验，如果关键字不存在，会进行报错返回。如果不希望进行报错，可以设置"IgnoreKeywordError"来忽略错误。请注意，如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有，还是会触发报错逻辑。
+<b>参数样例</b>：` "{"IgnoreKeywordError":1}"`
+        :type ComponentExtra: str
+        :param _ComponentValue: 控件填充vaule，ComponentType和传入值类型对应关系：
+<ul><li> <b>TEXT</b> : 文本内容</li>
+<li> <b>MULTI_LINE_TEXT</b> : 文本内容</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>SIGN_SEAL</b> : 印章ID，于控制台查询获取</li>
+<li> <b>SIGN_PAGING_SEAL</b> : 可以指定印章ID，于控制台查询获取</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 _ComponentDateFontSize: 日期签署控件的字号，默认为 12
-
-签署区日期控件会转换成图片格式并带存证，需要通过字体决定图片大小
+        :param _ComponentDateFontSize: <font color="red">【暂未使用】</font>日期签署控件的字号，默认为 12
         :type ComponentDateFontSize: int
-        :param _DocumentId: 控件所属文档的Id, 模板相关接口为空值
+        :param _DocumentId: <font color="red">【暂未使用】</font>控件归属的文档的ID， **发起合同时候不要填写此字段留空即可**
         :type DocumentId: str
-        :param _ComponentDescription: 控件描述，不超过30个字符
+        :param _ComponentDescription: <font color="red">【暂未使用】</font>控件描述，用户自定义，不影响合同发起流程
         :type ComponentDescription: str
-        :param _OffsetX: 指定关键字时横坐标偏移量，单位pt
+        :param _OffsetX: **如果控件是关键字定位方式**，可以对关键字定位出来的区域进行横坐标方向的调整，单位为pt（点）。例如，如果关键字定位出来的区域偏左或偏右，可以通过调整横坐标方向的参数来使控件位置更加准确。
+注意： `向左调整设置为负数， 向右调整设置成正数`
         :type OffsetX: float
-        :param _OffsetY: 指定关键字时纵坐标偏移量，单位pt
+        :param _OffsetY: **如果控件是关键字定位方式**，可以对关键字定位出来的区域进行纵坐标方向的调整，单位为pt（点）。例如，如果关键字定位出来的区域偏上或偏下，可以通过调整纵坐标方向的参数来使控件位置更加准确。
+注意： `向上调整设置为负数， 向下调整设置成正数`
         :type OffsetY: float
-        :param _ChannelComponentId: 平台企业控件ID。
-如果不为空，属于平台企业预设控件；
+        :param _ChannelComponentId: <font color="red">【暂未使用】</font>第三方应用集成平台模板控件 ID 标识
         :type ChannelComponentId: str
-        :param _KeywordOrder: 指定关键字排序规则，
-Positive-正序，
-Reverse-倒序。
-传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的第一个关键字。
-传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的最后一个关键字。
+        :param _KeywordOrder: **如果控件是关键字定位方式**，指定关键字排序规则时，可以选择Positive或Reverse两种排序方式。
+<ul><li> <b>Positive</b> :表示正序，即根据关键字在PDF文件内的顺序进行排列</li>
+<li> <b>Reverse</b> :表示倒序，即根据关键字在PDF文件内的反序进行排列</li></ul>
+
+在指定KeywordIndexes时，如果使用Positive排序方式，0代表在PDF内查找内容时，查找到的第一个关键字；如果使用Reverse排序方式，0代表在PDF内查找内容时，查找到的最后一个关键字。
         :type KeywordOrder: str
-        :param _KeywordPage: 指定关键字页码。
-指定页码后，将只在指定的页码内查找关键字，非该页码的关键字将不会查询出来
+        :param _KeywordPage: **如果控件是关键字定位方式**，在KeywordPage中指定关键字页码时，将只会在该页码中查找关键字，非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
         :type KeywordPage: int
-        :param _RelativeLocation: 关键字位置模式，
-Middle-居中，
-Below-正下方，
-Right-正右方，
-LowerRight-右上角，
-UpperRight-右下角。
+        :param _RelativeLocation: **如果控件是关键字定位方式**，关键字生成的区域的对齐方式， 可以设置下面的值
+<ul><li> <b>Middle</b> :居中</li>
+<li> <b>Below</b> :正下方</li>
+<li> <b>Right</b> :正右方</li>
+<li> <b>LowerRight</b> :右上角</li>
+<li> <b>UpperRight</b> :右下角。</li></ul>
 示例：如果设置Middle的关键字盖章，则印章的中心会和关键字的中心重合，如果设置Below，则印章在关键字的正下方
         :type RelativeLocation: str
-        :param _KeywordIndexes: 关键字索引，如果一个关键字在PDF文件中存在多个，可以通过关键字索引指定使用第几个关键字作为最后的结果，可指定多个索引。
-示例[0,2]，说明使用PDF文件内第1个和第3个关键字位置。
+        :param _KeywordIndexes: **如果控件是关键字定位方式**，关键字索引是指在PDF文件中存在多个相同的关键字时，通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如，[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
+
+注意：关键字索引是从0开始计数的
         :type KeywordIndexes: list of int
-        :param _Placeholder: 填写提示的内容
+        :param _Placeholder: 填写控件在腾讯电子签小程序填写界面展示的提示信息，例如，在身份证号码填写控件中，提示信息可以设置成“请输入18位身份证号码”。
+注：`签署控件设置此字段无效`
 注意：此字段可能返回 null，表示取不到有效值。
         :type Placeholder: str
-        :param _LockComponentValue: 是否锁定控件值不允许编辑（嵌入式发起使用） <br/>默认false：不锁定控件值，允许在页面编辑控件值	
+        :param _LockComponentValue: **web嵌入发起合同场景下**， 是否锁定填写和签署控件值不允许嵌入页面进行编辑
+<ul><li>false（默认）：不锁定控件值，允许在页面编辑控件值</li>
+<li>true：锁定控件值，在页面编辑控件值</li></ul>
 注意：此字段可能返回 null，表示取不到有效值。
         :type LockComponentValue: bool
-        :param _ForbidMoveAndDelete: 是否禁止移动和删除控件 <br/>默认false，不禁止移动和删除控件	
+        :param _ForbidMoveAndDelete: **web嵌入发起合同场景下**，是否禁止移动和删除填写和签署控件
+<ul><li> <b>false（默认）</b> :不禁止移动和删除控件</li>
+<li> <b>true</b> : 可以移动和删除控件</li></ul>
 注意：此字段可能返回 null，表示取不到有效值。
         :type ForbidMoveAndDelete: bool
         """
@@ -9559,17 +9538,25 @@ class CreateChannelOrganizationInfoChangeUrlRequest(AbstractModel):
 此接口下面信息必填。
 <ul>
 <li>渠道应用标识:  Agent.AppId</li>
-<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
-<li>第三方平台子客企业中的员工标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
 </ul>
+第三方平台子客企业和员工必须已经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _ChangeType: 企业信息变更类型，可选类型如下：
 <ul><li>**1**：企业超管变更, 可以将超管换成同企业的其他员工</li>
 <li>**2**：企业基础信息变更, 可以改企业名称 , 所在地址 , 法人名字等信息</li></ul>
         :type ChangeType: int
+        :param _Endpoint: 变更链接类型：
+<ul>
+<li>**WEIXINAPP** : 创建变更短链。需要在移动端打开，会跳转到微信腾讯电子签小程序进行更换。（默认）</li>
+<li>**APP** : 创建变更小程序链接，可从第三方APP跳转到微信腾讯电子签小程序进行更换。</li>
+</ul>
+        :type Endpoint: str
         """
         self._Agent = None
         self._ChangeType = None
+        self._Endpoint = None
 
     @property
     def Agent(self):
@@ -9587,12 +9574,21 @@ class CreateChannelOrganizationInfoChangeUrlRequest(AbstractModel):
     def ChangeType(self, ChangeType):
         self._ChangeType = ChangeType
 
+    @property
+    def Endpoint(self):
+        return self._Endpoint
+
+    @Endpoint.setter
+    def Endpoint(self, Endpoint):
+        self._Endpoint = Endpoint
+
 
     def _deserialize(self, params):
         if params.get("Agent") is not None:
             self._Agent = Agent()
             self._Agent._deserialize(params.get("Agent"))
         self._ChangeType = params.get("ChangeType")
+        self._Endpoint = params.get("Endpoint")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -9707,10 +9703,10 @@ class CreateConsoleLoginUrlRequest(AbstractModel):
 注：该参数**仅在企业和员工激活完成，登录控制台场景才生效**。
         :type MenuStatus: str
         :param _Endpoint: 生成链接的类型：
-<ul><li>**PC**：(默认)web控制台链接, 需要在PC浏览器中打开</li>
+<ul><li>**PC**：(默认)<font color="red">web控制台</font>链接, 需要在PC浏览器中打开</li>
 <li>**CHANNEL**：H5跳转到电子签小程序链接, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序</li>
-<li>**SHORT_URL**：H5跳转到电子签小程序链接的短链形式, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序</li>
-<li>**APP**：第三方APP或小程序跳转电子签小程序链接, 一般用于贵方小程序或者APP跳转过来,  打开后进入腾讯电子签小程序</li></ul>
+<li>**SHORT_URL**：<font color="red">H5</font>跳转到电子签小程序链接的短链形式, 一般用于发送短信中带的链接, 打开后进入腾讯电子签小程序</li>
+<li>**APP**：<font color="red">APP或小程序</font>跳转电子签小程序链接, 一般用于贵方小程序或者APP跳转过来,  打开后进入腾讯电子签小程序</li></ul>
         :type Endpoint: str
         :param _AutoJumpBackEvent: 触发自动跳转事件，仅对EndPoint为App类型有效，可选值包括：
 <ul><li> **VERIFIED** :企业认证完成/员工认证完成后跳回原App/小程序</li></ul>
@@ -9868,9 +9864,11 @@ class CreateConsoleLoginUrlResponse(AbstractModel):
         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</td> <td>一年</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</td> <td>一年</td>  </tr>  <tr> <td>企业已激活</td> <td>员工已认证</td> <td>PC</td> <td>5分钟</td>  </tr>  <tr> <td>企业已激活</td> <td>员工已认证</td> <td>CHANNEL/APP</td> <td>一年</td>  </tr> </tbody> </table>
+
 注： 
-`1.链接仅单次有效，每次登录需要需要重新创建新的链接`
-`2.创建的链接应避免被转义，如：&被转义为\u0026；如使用Postman请求后，请选择响应类型为 JSON，否则链接将被转义`
+1. <font color="red">链接仅单次有效</font>，每次登录需要需要重新创建新的链接
+2. 创建的链接应避免被转义，如：&被转义为\u0026；如使用Postman请求后，请选择响应类型为 JSON，否则链接将被转义
+3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
 
         :type ConsoleUrl: str
         :param _IsActivated: 子客企业是否已开通腾讯电子签，
@@ -10804,7 +10802,7 @@ class CreateSignUrlsRequest(AbstractModel):
 <ul>
 <li>渠道应用标识:  Agent.AppId</li>
 <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
-<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
 </ul>
 第三方平台子客企业和员工必须已经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
@@ -11979,10 +11977,11 @@ class DescribeExtendedServiceAuthInfoRequest(AbstractModel):
 
 此接口下面信息必填。
 <ul>
-<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
-<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
-<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
 </ul>
+第三方平台子客企业和员工必须已经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         """
         self._Agent = None
@@ -12893,11 +12892,12 @@ class ExtentServiceAuthInfo(AbstractModel):
         :param _Type: 扩展服务类型
 <ul>
 <li>AUTO_SIGN             企业自动签（自动签署）</li>
-<li>  OVERSEA_SIGN          企业与港澳台居民*签署合同</li>
+<li>  OVERSEA_SIGN          企业与港澳台居民签署合同</li>
 <li>  MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
 <li> PAGING_SEAL           骑缝章</li>
 <li> DOWNLOAD_FLOW         授权渠道下载合同 </li>
 <li>AGE_LIMIT_EXPANSION 拓宽签署方年龄限制</li>
+<li>HIDE_OPERATOR_DISPLAY 隐藏合同经办人姓名</li>
 </ul>
         :type Type: str
         :param _Name: 扩展服务名称 
@@ -14029,10 +14029,12 @@ class FlowApproverUrlInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _SignUrl: 签署短链接。</br>
+        :param _SignUrl: 签署短链接。
+
 注意:
-- 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
-- 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
+1. 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
+2. 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
+3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
         :type SignUrl: str
         :param _ApproverType: 签署人类型。
 - **PERSON**: 个人
@@ -14041,10 +14043,12 @@ class FlowApproverUrlInfo(AbstractModel):
         :type Name: str
         :param _Mobile: 签署人手机号。
         :type Mobile: str
-        :param _LongUrl: 签署长链接。</br>
+        :param _LongUrl: 签署长链接。
+
 注意:
-- 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
-- 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
+1. 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
+2. 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
+3. <font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
 注意：此字段可能返回 null，表示取不到有效值。
         :type LongUrl: str
         """
@@ -15370,24 +15374,28 @@ class ModifyExtendedServiceRequest(AbstractModel):
 
 此接口下面信息必填。
 <ul>
-<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
-<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
-<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
 </ul>
+第三方平台子客企业和员工必须已经过实名认证
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _ServiceType:   扩展服务类型
 <ul>
 <li>AUTO_SIGN             企业自动签（自动签署）</li>
-<li>  OVERSEA_SIGN          企业与港澳台居民*签署合同</li>
+<li>  OVERSEA_SIGN          企业与港澳台居民签署合同</li>
 <li>  MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
 <li> PAGING_SEAL           骑缝章</li>
 <li> DOWNLOAD_FLOW         授权渠道下载合同 </li>
 <li>AGE_LIMIT_EXPANSION 拓宽签署方年龄限制</li>
+<li>HIDE_OPERATOR_DISPLAY 隐藏合同经办人姓名</li>
 </ul>
         :type ServiceType: str
-        :param _Operate: 操作类型 
-OPEN:开通 
-CLOSE:关闭
+        :param _Operate: 操作类型
+<ul>
+<li>OPEN : 开通</li>
+<li>CLOSE : 关闭</li>
+</ul>
         :type Operate: str
         :param _Endpoint: 链接跳转类型，支持以下类型
 <ul>
@@ -15461,8 +15469,8 @@ class ModifyExtendedServiceResponse(AbstractModel):
         :param _OperateUrl: 操作跳转链接，有效期24小时
 若操作时没有返回跳转链接，表示无需跳转操作，此时会直接开通/关闭服务。
 
-当操作类型是 OPEN 且 扩展服务类型是  AUTO_SIGN 或 DOWNLOAD_FLOW 或者 OVERSEA_SIGN 时返回操作链接，
-返回的链接需要平台方自行触达超管或法人，超管或法人点击链接完成服务开通操作。
+当操作类型是 OPEN 且 扩展服务类型是 AUTO_SIGN 或 DOWNLOAD_FLOW 或者 OVERSEA_SIGN 时返回操作链接，
+返回的链接需要平台方自行触达超管或法人，超管或法人点击链接完成服务开通操作
         :type OperateUrl: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -15770,7 +15778,7 @@ class OperateChannelTemplateRequest(AbstractModel):
 
 此接口下面信息必填。
 <ul>
-<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+<li>渠道应用标识: Agent.AppId</li>
 </ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _OperateType: 操作类型，可取值如下:
@@ -17722,6 +17730,8 @@ class SignUrlInfo(AbstractModel):
     def __init__(self):
         r"""
         :param _SignUrl: 签署链接，过期时间为90天
+
+注：<font color="red">生成的链路后面不能再增加参数</font>（会出现覆盖链接中已有参数导致错误）
 注意：此字段可能返回 null，表示取不到有效值。
         :type SignUrl: str
         :param _Deadline: 合同过期时间戳，单位秒
@@ -18578,7 +18588,7 @@ class TemplateInfo(AbstractModel):
         :type Components: list of Component
         :param _Recipients: 此模块需要签署的各个参与方的角色列表。RecipientId标识每个参与方角色对应的唯一标识符，用于确定此角色的信息。
         :type Recipients: list of Recipient
-        :param _SignComponents: 此模版中的签署控件列表
+        :param _SignComponents: 此模板中的签署控件列表
         :type SignComponents: list of Component
         :param _TemplateType: 模板类型：1-静默签；3-普通模板
         :type TemplateType: int

{tencentcloud-sdk-python-essbasic-3.0.1062 → tencentcloud-sdk-python-essbasic-3.0.1070}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

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

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

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

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