tencentcloud-sdk-python-essbasic 3.0.996__tar.gz → 3.0.1004__tar.gz

{tencentcloud-sdk-python-essbasic-3.0.996 → tencentcloud-sdk-python-essbasic-3.0.1004}/PKG-INFO

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

{tencentcloud-sdk-python-essbasic-3.0.996 → tencentcloud-sdk-python-essbasic-3.0.1004}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.996'
+__version__ = '3.0.1004'

{tencentcloud-sdk-python-essbasic-3.0.996 → tencentcloud-sdk-python-essbasic-3.0.1004}/tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -291,7 +291,64 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelCreateFlowByFiles(self, request):
-        """接口（ChannelCreateFlowByFiles）用于通过文件创建签署流程。此接口静默签能力不可直接使用，请联系客户经理申请使用
+        """接口（ChannelCreateFlowByFiles）用PDF文件创建签署流程。
+
+        适用场景：适用非制式的合同文件签署，开发者有每个签署流程的PDF，可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
+
+        **注**:
+        <ul>
+        <li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
+        <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号（FileIds）进行使用。整体的逻辑如下图</li>
+        </ul>
+
+        ![image](https://dyn.ess.tencent.cn/guide/capi/ChannelCreateFlowByFiles.png)
+
+        **可以作为发起方和签署方的角色列表**
+        <table>
+        <thead>
+        <tr>
+        <th>场景编号</th>
+        <th>可作为发起方类型</th>
+        <th>可作为签署方的类型</th>
+        </tr>
+        </thead>
+
+        <tbody>
+        <tr>
+        <td>场景一</td>
+        <td>第三方子企业A员工</td>
+        <td>第三方子企业A员工</td>
+        </tr>
+
+        <tr>
+        <td>场景二</td>
+        <td>第三方子企业A员工</td>
+        <td>第三方子企业B(不指定经办人)</td>
+        </tr>
+
+        <tr>
+        <td>场景三</td>
+        <td>第三方子企业A员工</td>
+        <td>第三方子企业B员工</td>
+        </tr>
+
+        <tr>
+        <td>场景四</td>
+        <td>第三方子企业A员工</td>
+        <td>个人/自然人</td>
+        </tr>
+
+        <tr>
+        <td>场景五</td>
+        <td>第三方子企业A员工</td>
+        <td>SaaS平台企业员工</td>
+        </tr>
+        </tbody>
+        </table>
+
+        **注**:
+        `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+        `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
         :param request: Request instance for ChannelCreateFlowByFiles.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowByFilesRequest`
@@ -892,7 +949,8 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelDescribeRoles(self, request):
-        """分页查询企业角色列表，法人的角色是系统保留角色，不会返回，按照角色创建时间升序排列
+        """分页查询企业角色列表，法人的角色是系统保留角色，不会返回，按照角色创建时间升序排列。
+        相关系统默认角色说明可参考文档：https://cloud.tencent.com/document/product/1323/61355
 
         :param request: Request instance for ChannelDescribeRoles.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelDescribeRolesRequest`
@@ -1035,7 +1093,7 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelVerifyPdf(self, request):
-        """对流程的合同文件进行数字签名验证，判断文件是否被篡改。
+        """对合同流程文件进行数字签名验证，判断数字签名是否有效，合同文件内容是否被篡改。
 
         :param request: Request instance for ChannelVerifyPdf.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelVerifyPdfRequest`
@@ -1058,8 +1116,15 @@ class EssbasicClient(AbstractClient):
 
 
     def CreateChannelFlowEvidenceReport(self, request):
-        """创建出证报告，返回报告 ID。需要配合出证套餐才能调用。
-        出证需要一定时间，建议调用创建出证24小时之后再通过DescribeChannelFlowEvidenceReport进行查询。
+        """提交申请出证报告任务并返回报告ID。
+
+        注意：
+        <ul><li>使用此功能`需搭配出证套餐` ，使用前请联系对接的客户经理沟通。</li>
+        <li>操作人必须是`发起方或者签署方企业的(非走授权书认证)法人或者超管`。</li>
+        <li>合同流程必须所有参与方`已经签署完成`。</li>
+        <li>出证过程需一定时间，建议在`提交出证任务后的24小时之后`，通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。</li></ul>
+
+        <svg id="SvgjsSvg1006" width="262" height="229" xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svgjs="http://svgjs.com/svgjs"><defs id="SvgjsDefs1007"><pattern patternUnits="userSpaceOnUse" id="pattern_mark_0" width="300" height="300"><text x="150" y="100" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><pattern patternUnits="userSpaceOnUse" id="pattern_mark_1" width="300" height="300"><text x="150" y="200" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><marker id="SvgjsMarker1021" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1022" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker></defs><rect id="svgbackgroundid" width="262" height="229" fill="transparent"></rect><rect id="SvgjsRect1009" width="262" height="229" fill="url(#pattern_mark_0)"></rect><rect id="SvgjsRect1010" width="262" height="229" fill="url(#pattern_mark_1)"></rect><g id="SvgjsG1011" transform="translate(31.75,25)"><path id="SvgjsPath1012" d="M 0 0L 198 0L 198 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1013"><text id="SvgjsText1014" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="178px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1015" dy="16" x="99"><tspan id="SvgjsTspan1016" style="text-decoration:;fill: rgb(28, 30, 33);">CreateFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1017" dy="16" x="99"><tspan id="SvgjsTspan1018" style="text-decoration:;fill: rgb(51, 51, 51);">提交申请出证报告任务</tspan></tspan></text></g></g><g id="SvgjsG1019"><path id="SvgjsPath1020" d="M130.75 84.5L130.75 114.5L130.75 114.5L130.75 143.2" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1021)"></path></g><g id="SvgjsG1023" transform="translate(25,145)"><path id="SvgjsPath1024" d="M 0 0L 211.5 0L 211.5 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1025"><text id="SvgjsText1026" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="192px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1027" dy="16" x="106"><tspan id="SvgjsTspan1028" style="text-decoration:;fill: rgb(28, 30, 33);">DescribeFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1029" dy="16" x="106"><tspan id="SvgjsTspan1030" style="text-decoration:;fill: rgb(51, 51, 51);">获取出证报告任务执行结果</tspan></tspan></text></g></g></svg>
 
         :param request: Request instance for CreateChannelFlowEvidenceReport.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateChannelFlowEvidenceReportRequest`
@@ -1082,7 +1147,40 @@ class EssbasicClient(AbstractClient):
 
 
     def CreateChannelOrganizationInfoChangeUrl(self, request):
-        """此接口（CreateChannelOrganizationInfoChangeUrl）用于创建子客企业信息变更链接，支持创建企业超管变更链接或企业基础信息变更链接，通过入参ChangeType指定。
+        """此接口（CreateChannelOrganizationInfoChangeUrl）用于创建子客企业信息变更链接（需要在移动端打开，会跳转到微信小程序），支持创建企业超管变更链接或企业基础信息变更链接，通过入参 ChangeType 指定。
+
+
+        <h3 id="1-企业超管变更">1. 企业超管变更</h3>
+
+        <p>换成企业的其他员工来当超管</p>
+
+        <h3 id="2-企业基础信息变更">2. 企业基础信息变更</h3>
+
+        <h4 id="可以变动">可以变动</h4>
+
+        <ul>
+        <li>企业名称<br>
+        </li>
+        <li>法定代表人姓名(新法人有邀请链接)<br>
+        </li>
+        <li>企业地址和所在地</li>
+        </ul>
+
+        <h4 id="不可变动">不可变动</h4>
+
+        <ul>
+        <li>统一社会信用代码<br>
+        </li>
+        <li>企业主体类型</li>
+        </ul>
+
+        <p>如果企业名称变动会引起下面的变动</p>
+
+        <ul>
+        <li>合同:   老合同不做任何处理,   新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
+        <li>印章:   会删除所有的印章所有的机构公章和合同专用章,  然后用新企业名称生成新的机构公章 和合同专用章,  而法人章, 财务专用章和人事专用章不会处理</li>
+        <li>证书:   企业证书会重新请求CA机构用新企业名称生成新的证书</li>
+        </ul>
 
         :param request: Request instance for CreateChannelOrganizationInfoChangeUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateChannelOrganizationInfoChangeUrlRequest`
@@ -1141,6 +1239,57 @@ class EssbasicClient(AbstractClient):
         如若在模板中配置了动态表格, 上传的附件必须为A4大小
         合同发起人必须在电子签已经进行实名。
 
+        **整体的逻辑如下**
+
+        ![image](https://dyn.ess.tencent.cn/guide/capi/CreateFlowsByTemplates.png)
+
+        **可以作为发起方和签署方的角色列表**
+        <table>
+        <thead>
+        <tr>
+        <th>场景编号</th>
+        <th>可作为发起方类型</th>
+        <th>可作为签署方的类型</th>
+        </tr>
+        </thead>
+
+        <tbody>
+        <tr>
+        <td>场景一</td>
+        <td>第三方子企业A员工</td>
+        <td>第三方子企业A员工</td>
+        </tr>
+
+        <tr>
+        <td>场景二</td>
+        <td>第三方子企业A员工</td>
+        <td>第三方子企业B(不指定经办人)</td>
+        </tr>
+
+        <tr>
+        <td>场景三</td>
+        <td>第三方子企业A员工</td>
+        <td>第三方子企业B员工</td>
+        </tr>
+
+        <tr>
+        <td>场景四</td>
+        <td>第三方子企业A员工</td>
+        <td>个人/自然人</td>
+        </tr>
+
+        <tr>
+        <td>场景五</td>
+        <td>第三方子企业A员工</td>
+        <td>SaaS平台企业员工</td>
+        </tr>
+        </tbody>
+        </table>
+
+        **注**:
+        `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+        `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
+
         :param request: Request instance for CreateFlowsByTemplates.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowsByTemplatesRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowsByTemplatesResponse`
@@ -1260,7 +1409,14 @@ class EssbasicClient(AbstractClient):
 
 
     def DescribeExtendedServiceAuthInfo(self, request):
-        """查询企业扩展服务授权信息，企业经办人需要是企业超管或者法人
+        """查询企业扩展服务的开通和授权情况，当前支持查询以下内容：
+        1. 企业自动签
+        2. 企业与港澳台居民签署合同
+        3. 使用手机号验证签署方身份
+        4. 骑缝章
+        5. 拓宽签署方年龄限制
+
+        注: 此接口 参数Agent. ProxyOperator.OpenId 需要传递超管或者法人的OpenId
 
         :param request: Request instance for DescribeExtendedServiceAuthInfo.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeExtendedServiceAuthInfoRequest`

{tencentcloud-sdk-python-essbasic-3.0.996 → tencentcloud-sdk-python-essbasic-3.0.1004}/tencentcloud/essbasic/v20210526/models.py

@@ -166,9 +166,13 @@ class ApproverItem(AbstractModel):
     def __init__(self):
         r"""
         :param _SignId: 签署方唯一编号
+
+在<a href="https://qian.tencent.com/developers/company/dynamic_signer" target="_blank">动态补充签署人</a>场景下，可以用此编号确定参与方
 注意：此字段可能返回 null，表示取不到有效值。
         :type SignId: str
         :param _RecipientId: 签署方角色编号
+
+在<a href="https://qian.tencent.com/developers/company/dynamic_signer" target="_blank">动态补充签署人</a>场景下，可以用此编号确定参与方
 注意：此字段可能返回 null，表示取不到有效值。
         :type RecipientId: str
         :param _ApproverRoleName: 签署方角色名称
@@ -232,9 +236,19 @@ class ApproverOption(AbstractModel):
 <ul><li> **1** : ( 动态签署人（可发起合同后再补充签署人信息）</li>
 </ul>
         :type FillType: int
+        :param _FlowReadLimit: 签署人阅读合同限制参数
+ <br/>取值：
+<ul>
+<li> LimitReadTimeAndBottom，阅读合同必须限制阅读时长并且必须阅读到底</li>
+<li> LimitReadTime，阅读合同仅限制阅读时长</li>
+<li> LimitBottom，阅读合同仅限制必须阅读到底</li>
+<li> NoReadTimeAndBottom，阅读合同不限制阅读时长且不限制阅读到底（白名单功能，请联系客户经理开白使用）</li>
+</ul>
+        :type FlowReadLimit: str
         """
         self._HideOneKeySign = None
         self._FillType = None
+        self._FlowReadLimit = None
 
     @property
     def HideOneKeySign(self):
@@ -252,10 +266,19 @@ class ApproverOption(AbstractModel):
     def FillType(self, FillType):
         self._FillType = FillType
 
+    @property
+    def FlowReadLimit(self):
+        return self._FlowReadLimit
+
+    @FlowReadLimit.setter
+    def FlowReadLimit(self, FlowReadLimit):
+        self._FlowReadLimit = FlowReadLimit
+
 
     def _deserialize(self, params):
         self._HideOneKeySign = params.get("HideOneKeySign")
         self._FillType = params.get("FillType")
+        self._FlowReadLimit = params.get("FlowReadLimit")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -1985,8 +2008,7 @@ class ChannelCreateFlowApproversRequest(AbstractModel):
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
         :param _FillApproverType: 签署人信息补充方式
 
-<ul><li>**0**: 补充或签人，支持补充多个企业经办签署人（默认）注: `不可补充个人签署人`</li>
-<li>**1**: 补充动态签署人，可补充企业和个人签署人。注: `每个签署方节点签署人是唯一的，一个节点只支持传入一个签署人信息`</li></ul>
+<ul><li>**1**: 补充动态签署人，可补充企业和个人签署人。注: `每个签署方节点签署人是唯一的，一个节点只支持传入一个签署人信息`</li></ul>
         :type FillApproverType: int
         """
         self._Agent = None
@@ -2112,56 +2134,99 @@ class ChannelCreateFlowByFilesRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 均必填。
+        :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+</ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _FlowName: 签署流程名称，长度不超过200个字符
+        :param _FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         :type FlowName: str
-        :param _FlowDescription: 签署流程的描述，长度不超过1000个字符
+        :param _FlowDescription: 合同流程描述信息(可自定义此描述)，最大长度1000个字符。
         :type FlowDescription: str
-        :param _FlowApprovers: 签署流程签约方列表，最多不超过50个参与方
+        :param _FlowApprovers: 合同流程的参与方列表, 最多可支持50个参与方，可在列表中指定企业B端签署方和个人C端签署方的联系和认证方式等信息，具体定义可以参考开发者中心的<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo" target="_blank">FlowApproverInfo结构体</a>。
+
+如果合同流程是有序签署，Approvers列表中参与人的顺序就是默认的签署顺序, 请确保列表中参与人的顺序符合实际签署顺序。
         :type FlowApprovers: list of FlowApproverInfo
-        :param _FileIds: 签署文件资源Id列表，目前仅支持单个文件
+        :param _FileIds: 本合同流程需包含的PDF文件资源编号列表，通过<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">UploadFiles</a>接口获取PDF文件资源编号。
+
+注: `目前，此接口仅支持单个文件发起。`
         :type FileIds: list of str
-        :param _Components: 签署文件中的发起方的填写控件，需要在发起的时候进行填充
+        :param _Components: 模板或者合同中的填写控件列表，列表中可支持下列多种填写控件，控件的详细定义参考开发者中心的Component结构体
+<ul><li>单行文本控件</li>
+<li>多行文本控件</li>
+<li>勾选框控件</li>
+<li>数字控件</li>
+<li>图片控件</li>
+<li>数据表格等填写控件</li></ul>
         :type Components: list of Component
-        :param _Deadline: 签署流程的签署截止时间。
-值为unix时间戳,精确到秒,不传默认为当前时间一年后
-不能早于当前时间
+        :param _Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的365天时截止。
+如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
         :type Deadline: int
-        :param _CallbackUrl: 签署流程回调地址，长度不超过255个字符
-如果不传递回调地址， 则默认是配置应用号时候使用的回调地址
+        :param _CallbackUrl: 执行结果的回调URL，长度不超过255个字符，该URL仅支持HTTP或HTTPS协议，建议采用HTTPS协议以保证数据传输的安全性。
+腾讯电子签服务器将通过POST方式，application/json格式通知执行结果，请确保外网可以正常访问该URL。
+回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/partner/callback_data_types" target="_blank">回调通知</a>模块。
+
+注:
+`如果不传递回调地址， 则默认是配置应用号时候使用的回调地址`
         :type CallbackUrl: str
-        :param _Unordered: 合同签署顺序类型
-true - 无序签,
-false - 顺序签，
-默认为false，即有序签署。
-有序签署时以传入FlowApprovers数组的顺序作为签署顺序
+        :param _Unordered: 合同流程的签署顺序类型：
+<ul><li> **false**：(默认)有序签署, 本合同多个参与人需要依次签署 </li>
+<li> **true**：无序签署, 本合同多个参与人没有先后签署限制</li></ul>
+**注**: `有序签署时以传入FlowApprovers数组的顺序作为签署顺序`
         :type Unordered: bool
-        :param _FlowType: 签署流程的类型，长度不超过255个字符
+        :param _FlowType: 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为255个字符，仅限中文、字母、数字和下划线组成。
         :type FlowType: str
-        :param _CustomShowMap: 合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
+        :param _CustomShowMap: 您可以自定义腾讯电子签小程序合同列表页展示的合同内容模板，模板中支持以下变量：
+<ul><li>{合同名称}   </li>
+<li>{发起方企业} </li>
+<li>{发起方姓名} </li>
+<li>{签署方N企业}</li>
+<li>{签署方N姓名}</li></ul>
+其中，N表示签署方的编号，从1开始，不能超过签署人的数量。
+
+例如，如果是腾讯公司张三发给李四名称为“租房合同”的合同，您可以将此字段设置为：`合同名称:{合同名称};发起方: {发起方企业}({发起方姓名});签署方:{签署方1姓名}`，则小程序中列表页展示此合同为以下样子
+
+合同名称：租房合同 
+发起方：腾讯公司(张三) 
+签署方：李四
+
+
         :type CustomShowMap: str
-        :param _CustomerData: 业务信息，最大长度1000个字符。
+        :param _CustomerData: 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为 1000长度。
+
+在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/partner/callback_types_contracts_sign" target="_blank">回调通知</a>模块。
         :type CustomerData: str
-        :param _NeedSignReview: 发起方企业的签署人进行签署操作是否需要企业内部审批。 若设置为true,审核结果需通过接口 ChannelCreateFlowSignReview 通知电子签，审核通过后，发起方企业签署人方可进行签署操作，否则会阻塞其签署操作。  注：企业可以通过此功能与企业内部的审批流程进行关联，支持手动、静默签署合同。
+        :param _NeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+<ul><li> **false**：（默认）不需要审批，直接签署。</li>
+<li> **true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
+企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
+<ul><li> 如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
+<li> 如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
+注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
         :type NeedSignReview: bool
         :param _ApproverVerifyType: 签署人校验方式
 VerifyCheck: 人脸识别（默认）
 MobileCheck：手机号验证，用户手机号和参与方手机号（ApproverMobile）相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）
 参数说明：可选人脸识别或手机号验证两种方式，若选择后者，未实名个人签署方在签署合同时，无需经过实名认证和意愿确认两次人脸识别，该能力仅适用于个人签署方。
         :type ApproverVerifyType: str
-        :param _SignBeanTag: 标识是否允许发起后添加控件。
-0为不允许
-1为允许。
-如果为1，创建的时候不能有签署控件，只能创建后添加。注意发起后添加控件功能不支持添加骑缝章和签批控件
+        :param _SignBeanTag: 签署方签署控件（印章/签名等）的生成方式：
+<ul><li> **0**：在合同流程发起时，由发起人指定签署方的签署控件的位置和数量。</li>
+<li> **1**：签署方在签署时自行添加签署控件，可以拖动位置和控制数量。</li></ul>
+**注**: `发起后添加控件功能不支持添加签批控件`
         :type SignBeanTag: int
-        :param _CcInfos: 被抄送人信息列表
+        :param _CcInfos: 合同流程的抄送人列表，最多可支持50个抄送人，抄送人可查看合同内容及签署进度，但无需参与合同签署。
         :type CcInfos: list of CcInfo
-        :param _CcNotifyType: 给关注人发送短信通知的类型，
-0-合同发起时通知 
-1-签署完成后通知
+        :param _CcNotifyType: 可以设置以下时间节点来给抄送人发送短信通知来查看合同内容：
+<ul><li> **0**：合同发起时通知（默认值）</li>
+<li> **1**：签署完成后通知</li></ul>
         :type CcNotifyType: int
-        :param _AutoSignScene: 个人自动签场景。发起自动签署时，需设置对应自动签署场景，目前仅支持场景：处方单-E_PRESCRIPTION_AUTO_SIGN
+        :param _AutoSignScene: 个人自动签名的使用场景包括以下, 个人自动签署(即ApproverType设置成个人自动签署时)业务此值必传：
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN**：处方单（医疗自动签）  </li></ul>
+注: `个人自动签名场景是白名单功能，使用前请与对接的客户经理联系沟通。`
         :type AutoSignScene: str
         :param _Operator: 操作者的信息，不用传
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
@@ -2399,7 +2464,8 @@ class ChannelCreateFlowByFilesResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FlowId: 合同签署流程ID
+        :param _FlowId: 合同流程ID，为32位字符串。
+建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
 注意：此字段可能返回 null，表示取不到有效值。
         :type FlowId: str
         :param _Approvers: 签署方信息，如角色ID、角色名称等
@@ -6695,9 +6761,11 @@ class ChannelVerifyPdfRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FlowId: 流程ID
+        :param _FlowId: 合同流程ID，为32位字符串。
+可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         :type FlowId: str
-        :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _Operator: 暂未开放
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
@@ -6760,15 +6828,32 @@ class ChannelVerifyPdfResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _VerifyResult: 验签结果，1-文件未被篡改，全部签名在腾讯电子签完成； 2-文件未被篡改，部分签名在腾讯电子签完成；3-文件被篡改；4-异常：文件内没有签名域；5-异常：文件签名格式错误
+        :param _VerifyResult: 验签结果代码，代码的含义如下：
+
+<ul><li>**1**：文件未被篡改，全部签名在腾讯电子签完成。</li>
+<li>**2**：文件未被篡改，部分签名在腾讯电子签完成。</li>
+<li>**3**：文件被篡改。</li>
+<li>**4**：异常：文件内没有签名域。</li>
+<li>**5**：异常：文件签名格式错误。</li></ul>
         :type VerifyResult: int
-        :param _PdfVerifyResults: 验签结果详情,内部状态1-验签成功，在电子签签署；2-验签成功，在其他平台签署；3-验签失败；4-pdf文件没有签名域；5-文件签名格式错误
+        :param _PdfVerifyResults: 验签结果详情，每个签名域对应的验签结果。状态值如下
+<ul><li> **1** :验签成功，在电子签签署</li>
+<li> **2** :验签成功，在其他平台签署</li>
+<li> **3** :验签失败</li>
+<li> **4** :pdf文件没有签名域</li>
+<li> **5** :文件签名格式错误</li></ul>
         :type PdfVerifyResults: list of PdfVerifyResult
+        :param _VerifySerialNo: 验签序列号, 为11为数组组成的字符串
+        :type VerifySerialNo: str
+        :param _PdfResourceMd5: 合同文件MD5哈希值
+        :type PdfResourceMd5: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
         self._VerifyResult = None
         self._PdfVerifyResults = None
+        self._VerifySerialNo = None
+        self._PdfResourceMd5 = None
         self._RequestId = None
 
     @property
@@ -6787,6 +6872,22 @@ class ChannelVerifyPdfResponse(AbstractModel):
     def PdfVerifyResults(self, PdfVerifyResults):
         self._PdfVerifyResults = PdfVerifyResults
 
+    @property
+    def VerifySerialNo(self):
+        return self._VerifySerialNo
+
+    @VerifySerialNo.setter
+    def VerifySerialNo(self, VerifySerialNo):
+        self._VerifySerialNo = VerifySerialNo
+
+    @property
+    def PdfResourceMd5(self):
+        return self._PdfResourceMd5
+
+    @PdfResourceMd5.setter
+    def PdfResourceMd5(self, PdfResourceMd5):
+        self._PdfResourceMd5 = PdfResourceMd5
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -6804,6 +6905,8 @@ class ChannelVerifyPdfResponse(AbstractModel):
                 obj = PdfVerifyResult()
                 obj._deserialize(item)
                 self._PdfVerifyResults.append(obj)
+        self._VerifySerialNo = params.get("VerifySerialNo")
+        self._PdfResourceMd5 = params.get("PdfResourceMd5")
         self._RequestId = params.get("RequestId")
 
 
@@ -7151,11 +7254,12 @@ KEYWORD - 关键字
 为JSON格式。
 不同类型的控件会有部分非通用参数
 
-TEXT/MULTI_LINE_TEXT控件可以指定
+ComponentType为TEXT、MULTI_LINE_TEXT时，支持以下参数：
 1 Font：目前只支持黑体、宋体
 2 FontSize： 范围12-72
 3 FontAlign： Left/Right/Center，左对齐/居中/右对齐
-例如：{"FontSize":12}
+4 FontColor：字符串类型，格式为RGB颜色数字
+参数样例：{\"FontColor\":\"255,0,0\",\"FontSize\":12}
 
 ComponentType为FILL_IMAGE时，支持以下参数：
 NotMakeImageCenter：bool。是否设置图片居中。false：居中（默认）。 true: 不居中
@@ -7182,7 +7286,7 @@ ComponentType为SIGN_DATE时，支持以下参数：
 
 ComponentType为SIGN_SEAL类型时，支持以下参数：
 1.PageRanges：PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）
-参数样例： "ComponentExtra":"{"PageRange":[{"BeginPage":1,"EndPage":-1}]}"
+参数样例： "ComponentExtra":"{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"
         :type ComponentExtra: str
         :param _ComponentValue: 控件填充vaule，ComponentType和传入值类型对应关系：
 TEXT - 文本内容
@@ -7656,9 +7760,17 @@ class CreateChannelFlowEvidenceReportRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填
+        :param _Agent: 员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+</ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _FlowId: 签署流程编号
+        :param _FlowId: 合同流程ID，为32位字符串。
+建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
         :type FlowId: str
         :param _Operator: 暂未开放
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
@@ -7721,15 +7833,14 @@ class CreateChannelFlowEvidenceReportResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ReportId: 出证报告 ID，可用户DescribeChannelFlowEvidenceReport接口查询出证PDF的下载地址
-
+        :param _ReportId: 出证报告 ID，可用于<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>查询出证任务结果和出证PDF的下载URL
 注意：此字段可能返回 null，表示取不到有效值。
         :type ReportId: str
-        :param _Status: 出征任务的执行状态,状态列表如下
+        :param _Status: 出证任务执行的状态, 状态含义如下：
 
-- EvidenceStatusExecuting : 出征任务正在执行中
-- EvidenceStatusSuccess : 出征任务执行成功
-- EvidenceStatusFailed : 出征任务执行失败
+<ul><li>**EvidenceStatusExecuting**：  出证任务在执行中</li>
+<li>**EvidenceStatusSuccess**：  出证任务执行成功</li>
+<li>**EvidenceStatusFailed** ： 出征任务执行失败</li></ul>
         :type Status: str
         :param _ReportUrl: 废除，字段无效
 注意：此字段可能返回 null，表示取不到有效值。
@@ -7789,10 +7900,18 @@ class CreateChannelOrganizationInfoChangeUrlRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Agent: 关于渠道应用的相关信息，包括子客企业及应用编、号等详细内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+        :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+</ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _ChangeType: 企业信息变更类型，可选类型如下：
-<ul><li>**1**：企业超管变更</li><li>**2**：企业基础信息变更</li></ul>
+<ul><li>**1**：企业超管变更, 可以将超管换成同企业的其他员工</li>
+<li>**2**：企业基础信息变更, 可以改企业名称 , 所在地址 , 法人名字等信息</li></ul>
         :type ChangeType: int
         """
         self._Agent = None
@@ -7837,7 +7956,7 @@ class CreateChannelOrganizationInfoChangeUrlResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Url: 创建的企业信息变更链接。
+        :param _Url: 创建的企业信息变更链接。需要在移动端打开，会跳转到微信腾讯电子签小程序进行更换。
         :type Url: str
         :param _ExpiredTime: 链接过期时间。链接7天有效。
         :type ExpiredTime: int
@@ -8249,15 +8368,31 @@ class CreateFlowsByTemplatesRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 均必填。
+        :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+</ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _FlowInfos: 要创建的合同信息列表，最多支持一次创建20个合同
         :type FlowInfos: list of FlowInfo
-        :param _NeedPreview: 是否为预览模式；默认为false，即非预览模式，此时发起合同并返回FlowIds；若为预览模式，不会发起合同，会返回PreviewUrls；
-预览链接有效期300秒；
-同时，如果预览的文件中指定了动态表格控件，需要进行异步合成；此时此接口返回的是合成前的文档预览链接，而合成完成后的文档预览链接会通过：回调通知的方式、或使用返回的TaskInfo中的TaskId通过ChannelGetTaskResultApi接口查询；
+        :param _NeedPreview: 是否为预览模式，取值如下：
+<ul><li> **false**：非预览模式（默认），会产生合同流程并返回合同流程编号FlowId。</li>
+<li> **true**：预览模式，不产生合同流程，不返回合同流程编号FlowId，而是返回预览链接PreviewUrl，有效期为300秒，用于查看真实发起后合同的样子。</li></ul>
+
+注:
+
+`如果预览的文件中指定了动态表格控件，此时此接口返回的是合成前的文档预览链接，合成完成后的文档预览链接需要通过回调通知的方式或使用返回的TaskInfo中的TaskId通过ChannelGetTaskResultApi接口查询得到`
+
         :type NeedPreview: bool
-        :param _PreviewType: 预览链接类型 默认:0-文件流, 1- H5链接 注意:此参数在NeedPreview 为true 时有效,
+        :param _PreviewType: 预览模式下产生的预览链接类型 
+<ul><li> **0** :(默认) 文件流 ,点开后后下载预览的合同PDF文件 </li>
+<li> **1** :H5链接 ,点开后在浏览器中展示合同的样子</li></ul>
+注: `此参数在NeedPreview 为true时有效`
+
         :type PreviewType: int
         :param _Operator: 操作者的信息，不用传
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
@@ -8345,14 +8480,17 @@ class CreateFlowsByTemplatesResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FlowIds: 多个合同ID
+        :param _FlowIds: 生成的合同流程ID数组，合同流程ID为32位字符串。
+建议开发者妥善保存此流程ID数组，以便于顺利进行后续操作。
         :type FlowIds: list of str
         :param _CustomerData: 第三方应用平台的业务信息, 与创建合同的FlowInfos数组中的CustomerData一一对应
         :type CustomerData: list of str
         :param _ErrorMessages: 创建消息，对应多个合同ID，
 成功为“”,创建失败则对应失败消息
         :type ErrorMessages: list of str
-        :param _PreviewUrls: 预览模式下返回的预览文件url数组
+        :param _PreviewUrls: 合同预览链接URL数组。
+
+注：如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL
         :type PreviewUrls: list of str
         :param _TaskInfos: 复杂文档合成任务（如，包含动态表格的预览任务）的任务信息数组；
 如果文档需要异步合成，此字段会返回该异步任务的任务信息，后续可以通过ChannelGetTaskResultApi接口查询任务详情；
@@ -9106,10 +9244,14 @@ class DescribeExtendedServiceAuthInfoRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填
-
-注: 此接口 参数Agent. ProxyOperator.OpenId 需要传递超管或者法人的OpenId
+        :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
 
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+</ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         """
         self._Agent = None
@@ -9144,7 +9286,7 @@ class DescribeExtendedServiceAuthInfoResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _AuthInfo: 企业扩展服务授权信息
+        :param _AuthInfo: 服务开通和授权的信息列表，根据查询类型返回所有支持的扩展服务开通和授权状况，或者返回特定扩展服务的开通和授权状况。
 注意：此字段可能返回 null，表示取不到有效值。
         :type AuthInfo: list of ExtentServiceAuthInfo
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -9939,29 +10081,30 @@ class DownloadFlowInfo(AbstractModel):
 
 
 class ExtentServiceAuthInfo(AbstractModel):
-    """企业扩展服务授权信息
+    """扩展服务开通和授权的详细信息
 
     """
 
     def __init__(self):
         r"""
         :param _Type: 扩展服务类型
-  AUTO_SIGN             企业静默签（自动签署）
-  OVERSEA_SIGN          企业与港澳台居民*签署合同
-  MOBILE_CHECK_APPROVER 使用手机号验证签署方身份
-  PAGING_SEAL           骑缝章
-  DOWNLOAD_FLOW         授权平台企业下载合同 
+<ul>
+  <li>AUTO_SIGN             企业自动签（自动签署）</li>
+<li>  OVERSEA_SIGN          企业与港澳台居民*签署合同</li>
+<li>  MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
+ <li> PAGING_SEAL           骑缝章</li>
+ <li> DOWNLOAD_FLOW         授权渠道下载合同 </li>
+<li>AGE_LIMIT_EXPANSION 拓宽签署方年龄限制</li>
+</ul>
         :type Type: str
         :param _Name: 扩展服务名称 
         :type Name: str
-        :param _Status: 服务状态 
-ENABLE 开启 
-DISABLE 关闭
+        :param _Status: 扩展服务的开通状态： ENABLE：开通 DISABLE：未开通	
         :type Status: str
-        :param _OperatorOpenId: 最近操作人第三方应用平台的用户openid
+        :param _OperatorOpenId: 操作扩展服务的操作人第三方应用平台的用户openid
 注意：此字段可能返回 null，表示取不到有效值。
         :type OperatorOpenId: str
-        :param _OperateOn: 最近操作时间戳，单位秒
+        :param _OperateOn: 扩展服务的操作时间，格式为Unix标准时间戳（秒）。	
 注意：此字段可能返回 null，表示取不到有效值。
         :type OperateOn: int
         """
@@ -10549,60 +10692,120 @@ class FlowApproverDetail(AbstractModel):
 class FlowApproverInfo(AbstractModel):
     """创建签署流程签署人入参。
 
-    其中签署方FlowApproverInfo需要传递的参数
-    非单C、单B、B2C合同，ApproverType、RecipientId（模板发起合同时）必传，建议都传。
+    **各种场景传参说明**:
 
-    其他身份标识
+    <table>
+    <thead>
+    <tr>
+    <th>场景编号</th>
+    <th>可作为发起方类型</th>
+    <th>可作为签署方的类型</th>
+    <th>签署方传参说明</th>
+    </tr>
+    </thead>
 
-    <ul><li>1-个人：Name、Mobile必传</li>
-    <li>2-第三方平台子客企业指定经办人：OpenId必传，OrgName必传、OrgOpenId必传；</li>
-    <li>3-第三方平台子客企业不指定经办人：OrgName必传、OrgOpenId必传；</li>
-    <li>4-非第三方平台子客企业：Name、Mobile必传，OrgName必传，且NotChannelOrganization=True。</li></ul>
+    <tbody>
+    <tr>
+    <td>场景一</td>
+    <td>第三方子企业A员工</td>
+    <td>第三方子企业A员工</td>
+    <td>OpenId、OrgName、OrgOpenId必传 ,ApproverType设置为ORGANIZATION</td>
+    </tr>
 
-    RecipientId参数：
-    从DescribeTemplates接口中，可以得到模板下的签署方Recipient列表，根据模板自定义的Rolename在此结构体中确定其RecipientId。
+    <tr>
+    <td>场景二</td>
+    <td>第三方子企业A员工</td>
+    <td>第三方子企业B(不指定经办人)</td>
+    <td>OrgName、OrgOpenId必传 ,ApproverType设置为ORGANIZATION</td>
+    </tr>
+
+    <tr>
+    <td>场景三</td>
+    <td>第三方子企业A员工</td>
+    <td>第三方子企业B员工</td>
+    <td>OpenId、OrgName、OrgOpenId必传, ApproverType设置为ORGANIZATION</td>
+    </tr>
+
+    <tr>
+    <td>场景四</td>
+    <td>第三方子企业A员工</td>
+    <td>个人/自然人</td>
+    <td>Name、Mobile必传, ApproverType设置为PERSON</td>
+    </tr>
+
+    <tr>
+    <td>场景五</td>
+    <td>第三方子企业A员工</td>
+    <td>SaaS平台企业员工</td>
+    <td>Name、Mobile、OrgName必传，且NotChannelOrganization=True。 ApproverType设置为ORGANIZATION</td>
+    </tr>
+    </tbody>
+    </table>
+
+    **注1**: `使用模板发起合同时，RecipientId（模板发起合同时）必传`
+
+    RecipientId参数获取：
+    从<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFlowTemplates" target="_blank">DescribeFlowTemplates接口</a>接口中，可以得到模板下的签署方Recipient列表，根据模板自定义的Rolename在此结构体中确定其RecipientId。
+
+    **注2**:  `如果发起的是动态签署方（即ApproverOption.FillType指定为1），可以不指定具体签署人信息`,  动态签署方可以参考<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">此文档</a>
 
     """
 
     def __init__(self):
         r"""
-        :param _Name: 签署人姓名，最大长度50个字符
+        :param _Name: 签署方经办人的姓名。
+经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         :type Name: str
-        :param _IdCardType: 签署人的证件类型
-1.ID_CARD 居民身份证
-2.HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证
-3.HONGKONG_AND_MACAO 港澳居民来往内地通行证
-4.OTHER_CARD_TYPE 其他（需要使用该类型请先联系运营经理）
+        :param _IdCardType: 签署方经办人的证件类型，支持以下类型
+<ul><li>ID_CARD : 居民身份证  (默认值)</li>
+<li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
+<li>OTHER_CARD_TYPE : 其他证件</li></ul>
+
+注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
         :type IdCardType: str
-        :param _IdCardNumber: 签署人证件号（长度不超过18位）
+        :param _IdCardNumber: 签署方经办人的证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type IdCardNumber: str
-        :param _Mobile: 签署人手机号，脱敏显示。大陆手机号为11位，暂不支持海外手机号。
+        :param _Mobile: 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)， 不支持海外手机号。
+请确认手机号所有方为此合同签署方。
         :type Mobile: str
-        :param _OrganizationName: 企业签署方工商营业执照上的企业名称，签署方为非发起方企业场景下必传，最大长度64个字符；
+        :param _OrganizationName: 组织机构名称。
+请确认该名称与企业营业执照中注册的名称一致。
+如果名称中包含英文括号()，请使用中文括号（）代替。
         :type OrganizationName: str
-        :param _NotChannelOrganization: 指定签署人非第三方平台子客企业下员工，在ApproverType为ORGANIZATION时指定。
-默认为false，即签署人位于同一个第三方平台应用号下；默认为false，即签署人位于同一个第三方应用号下；
+        :param _NotChannelOrganization: 指定签署人非第三方平台子客企业下员工还是SaaS平台企业，在ApproverType为ORGANIZATION时指定。
+<ul>
+<li>false: 默认值，第三方平台子客企业下员工</li>
+<li>true: SaaS平台企业下的员工</li>
+</ul>
+
         :type NotChannelOrganization: bool
-        :param _OpenId: 用户侧第三方id，最大长度64个字符
+        :param _OpenId: 第三方平台子客企业员工的唯一标识，长度不能超过64，只能由字母和数字组成
+
 当签署方为同一第三方平台下的员工时，该字段若不指定，则发起【待领取】的流程
         :type OpenId: str
-        :param _OrganizationOpenId: 企业签署方在同一第三方平台应用下的其他合作企业OpenId，签署方为非发起方企业场景下必传，最大长度64个字符；
+        :param _OrganizationOpenId: 同应用下第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样，签署方为非发起方企业场景下必传，最大长度64个字符
         :type OrganizationOpenId: str
-        :param _ApproverType: 签署人类型
-PERSON-个人/自然人；
-PERSON_AUTO_SIGN-个人自动签署，适用于个人自动签场景
-注: 个人自动签场景为白名单功能, 使用前请联系对接的客户经理沟通。
-ORGANIZATION-企业（企业签署方或模板发起时的企业静默签）；
-ENTERPRISESERVER-企业自动签（他方企业自动签署或文件发起时的本方企业自动签）
-
-若要实现他方企业（同一应用下）自动签，需要满足3个条件：
-条件1：ApproverType 设置为ENTERPRISESERVER
-条件2：子客之间完成授权
-条件3：联系对接的客户经理沟通
+        :param _ApproverType: 在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:
+<ul><li> **PERSON** :个人/自然人</li>
+<li> **PERSON_AUTO_SIGN** :个人/自然人自动签署，适用于个人自动签场景</li>
+<li> **ORGANIZATION** :企业/企业员工（企业签署方或模板发起时的企业静默签）</li>
+<li> **ENTERPRISESERVER** :企业/企业员自动签（他方企业自动签署或文件发起时的本方企业自动签）</li></ul>
+
+注:  
+`1. 个人自动签场景(PERSON_AUTO_SIGN)为白名单功能, 使用前请联系对接的客户经理沟通。`
+`2. 若要实现他方企业（同一应用下）自动签，需要满足3个条件：`
+<ul><li>条件1：ApproverType 设置为ENTERPRISESERVER</li>
+<li>条件2：子客之间完成授权</li>
+<li>条件3：联系对接的客户经理沟通如何使用</li></ul>
         :type ApproverType: str
         :param _RecipientId: 签署流程签署人在模板中对应的签署人Id；在非单方签署、以及非B2C签署的场景下必传，用于指定当前签署方在签署流程中的位置；
         :type RecipientId: str
-        :param _Deadline: 签署截止时间戳，默认一年
+        :param _Deadline: 本签署人在此合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的365天时截止。
+如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
         :type Deadline: int
         :param _CallbackUrl: 签署完回调url，最大长度1000个字符
         :type CallbackUrl: str
@@ -10614,11 +10817,19 @@ ENTERPRISESERVER-企业自动签（他方企业自动签署或文件发起时的
 	ESIGN -- 个人印章类型
 	SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
         :type ComponentLimitType: list of str
-        :param _PreReadTime: 合同的强制预览时间：3~300s，未指定则按合同页数计算
+        :param _PreReadTime: 签署方在签署合同之前，需要强制阅读合同的时长，可指定为3秒至300秒之间的任意值。
+
+若未指定阅读时间，则会按照合同页数大小计算阅读时间，计算规则如下：
+<ul>
+<li>合同页数少于等于2页，阅读时间为3秒；</li>
+<li>合同页数为3到5页，阅读时间为5秒；</li>
+<li>合同页数大于等于6页，阅读时间为10秒。</li>
+</ul>
         :type PreReadTime: int
         :param _JumpUrl: 签署完前端跳转的url，此字段的用法场景请联系客户经理确认
         :type JumpUrl: str
-        :param _ApproverOption: 签署人个性化能力值
+        :param _ApproverOption: 可以控制签署方在签署合同时能否进行某些操作，例如拒签、转交他人等。
+详细操作可以参考开发者中心的ApproverOption结构体。
         :type ApproverOption: :class:`tencentcloud.essbasic.v20210526.models.ApproverOption`
         :param _ApproverNeedSignReview: 当前签署方进行签署操作是否需要企业内部审批，true 则为需要
         :type ApproverNeedSignReview: bool
@@ -10633,14 +10844,17 @@ ENTERPRISESERVER-企业自动签（他方企业自动签署或文件发起时的
 - 发起流程时系统自动补充
 - 创建签署链接时，可以通过查询详情接口获得签署人的SignId，然后可传入此值为该签署人创建签署链接，无需再传姓名、手机号、证件号等其他信息
         :type SignId: str
-        :param _NotifyType: SMS: 短信(需确保“电子签短信通知签署方”功能是开启状态才能生效); NONE: 不发信息
-默认为SMS(签署方为子客时该字段不生效)
+        :param _NotifyType: 通知签署方经办人的方式, 有以下途径:
+<ul><li> **SMS** :(默认)短信</li>
+<li> **NONE** : 不通知</li></ul>
+
+注: `签署方为第三方子客企业时会被置为NONE,   不会发短信通知`
         :type NotifyType: str
         :param _AddSignComponentsLimits: [通过文件创建签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles)时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID）或签名方式。
 
 注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
         :type AddSignComponentsLimits: list of ComponentLimit
-        :param _ApproverRoleName: 自定义签署方角色名称
+        :param _ApproverRoleName: 自定义签署人角色名，如收款人、开具人、见证人等
         :type ApproverRoleName: str
         """
         self._Name = None
@@ -11817,7 +12031,181 @@ class FlowResourceUrlInfo(AbstractModel):
 
 
 class FormField(AbstractModel):
-    """此结构 (FormField) 用于描述内容控件填充结构。
+    """电子文档的控件填充信息。按照控件类型进行相应的填充。
+
+    当控件的 ComponentType='TEXT'时，FormField.ComponentValue填入文本内容
+    ```
+    FormField输入示例：
+    {
+        "ComponentId": "componentId1",
+        "ComponentValue": "文本内容"
+    }
+    ```
+    当控件的 ComponentType='MULTI_LINE_TEXT'时，FormField.ComponentValue填入文本内容，支持自动换行。
+    ```
+    FormField输入示例：
+    {
+        "ComponentId": "componentId1",
+        "ComponentValue": "多行文本内容"
+    }
+    ```
+    当控件的 ComponentType='CHECK_BOX'时，FormField.ComponentValue填入true或false文本
+    ```
+    FormField输入示例：
+    {
+        "ComponentId": "componentId1",
+        "ComponentValue": "true"
+    }
+    ```
+    当控件的 ComponentType='FILL_IMAGE'时，FormField.ComponentValue填入图片的资源ID
+    ```
+    FormField输入示例：
+    {
+        "ComponentId": "componentId1",
+        "ComponentValue": "yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+    }
+    ```
+    当控件的 ComponentType='ATTACHMENT'时，FormField.ComponentValue填入附件图片的资源ID列表，以逗号分隔，单个附件控件最多支持6个资源ID；
+    ```
+    FormField输入示例：
+    {
+        "ComponentId": "componentId1",
+        "ComponentValue": "yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx1,yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx2,yDwhsxxxxxxxxxxxxxxxxxxxxxxxxxx3"
+    }
+    ```
+    当控件的 ComponentType='SELECTOR'时，FormField.ComponentValue填入选择的选项内容；
+    ```
+    FormField输入示例：
+    {
+        "ComponentId": "componentId1",
+        "ComponentValue": "选择的内容"
+    }
+    ```
+    当控件的 ComponentType='DATE'时，FormField.ComponentValue填入日期内容；
+    ```
+    FormField输入示例：
+    {
+        "ComponentId": "componentId1",
+        "ComponentValue": "2023年01月01日"
+    }
+    ```
+    当控件的 ComponentType='DISTRICT'时，FormField.ComponentValue填入省市区内容；
+    ```
+    FormField输入示例：
+    {
+        "ComponentId": "componentId1",
+        "ComponentValue": "广东省深圳市福田区"
+    }
+    ```
+    【数据表格传参说明】
+    当控件的 ComponentType='DYNAMIC_TABLE'时，FormField.ComponentValue需要传递json格式的字符串参数，用于确定表头&填充数据表格（支持内容的单元格合并）
+    输入示例1：
+
+    ```
+    {
+        "headers":[
+            {
+                "content":"head1"
+            },
+            {
+                "content":"head2"
+            },
+            {
+                "content":"head3"
+            }
+        ],
+        "rowCount":3,
+        "body":{
+            "cells":[
+                {
+                    "rowStart":1,
+                    "rowEnd":1,
+                    "columnStart":1,
+                    "columnEnd":1,
+                    "content":"123"
+                },
+                {
+                    "rowStart":2,
+                    "rowEnd":3,
+                    "columnStart":1,
+                    "columnEnd":2,
+                    "content":"456"
+                },
+                {
+                    "rowStart":3,
+                    "rowEnd":3,
+                    "columnStart":3,
+                    "columnEnd":3,
+                    "content":"789"
+                }
+            ]
+        }
+    }
+
+    ```
+
+    输入示例2（表格表头宽度比例配置）：
+
+    ```
+    {
+        "headers":[
+            {
+                "content":"head1",
+                "widthPercent": 30
+            },
+            {
+                "content":"head2",
+                "widthPercent": 30
+            },
+            {
+                "content":"head3",
+                "widthPercent": 40
+            }
+        ],
+        "rowCount":3,
+        "body":{
+            "cells":[
+                {
+                    "rowStart":1,
+                    "rowEnd":1,
+                    "columnStart":1,
+                    "columnEnd":1,
+                    "content":"123"
+                },
+                {
+                    "rowStart":2,
+                    "rowEnd":3,
+                    "columnStart":1,
+                    "columnEnd":2,
+                    "content":"456"
+                },
+                {
+                    "rowStart":3,
+                    "rowEnd":3,
+                    "columnStart":3,
+                    "columnEnd":3,
+                    "content":"789"
+                }
+            ]
+        }
+    }
+
+    ```
+    表格参数说明
+
+    | 名称                | 类型    | 描述                                              |
+    | ------------------- | ------- | ------------------------------------------------- |
+    | headers             | Array   | 表头：不超过10列，不支持单元格合并，字数不超过100 |
+    | rowCount            | Integer | 表格内容最大行数                                  |
+    | cells.N.rowStart    | Integer | 单元格坐标：行起始index                           |
+    | cells.N.rowEnd      | Integer | 单元格坐标：行结束index                           |
+    | cells.N.columnStart | Integer | 单元格坐标：列起始index                           |
+    | cells.N.columnEnd   | Integer | 单元格坐标：列结束index                           |
+    | cells.N.content     | String  | 单元格内容，字数不超过100                         |
+
+    表格参数headers说明
+    widthPercent Integer 表头单元格列占总表头的比例，例如1：30表示 此列占表头的30%，不填写时列宽度平均拆分；例如2：总2列，某一列填写40，剩余列可以为空，按照60计算。；例如3：总3列，某一列填写30，剩余2列可以为空，分别为(100-30)/2=35
+    content String 表头单元格内容，字数不超过100
 
     """
 
@@ -12019,11 +12407,14 @@ class ModifyExtendedServiceRequest(AbstractModel):
 注: 此接口 参数Agent. ProxyOperator.OpenId 需要传递超管或者法人的OpenId
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _ServiceType:   扩展服务类型
-  AUTO_SIGN             企业静默签（自动签署）
-  OVERSEA_SIGN          企业与港澳台居民*签署合同
-  MOBILE_CHECK_APPROVER 使用手机号验证签署方身份
-  PAGING_SEAL           骑缝章
-  DOWNLOAD_FLOW         授权渠道下载合同 
+<ul>
+  <li>AUTO_SIGN             企业自动签（自动签署）</li>
+<li>  OVERSEA_SIGN          企业与港澳台居民*签署合同</li>
+<li>  MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
+ <li> PAGING_SEAL           骑缝章</li>
+ <li> DOWNLOAD_FLOW         授权渠道下载合同 </li>
+<li>AGE_LIMIT_EXPANSION 拓宽签署方年龄限制</li>
+</ul>
         :type ServiceType: str
         :param _Operate: 操作类型 
 OPEN:开通 

{tencentcloud-sdk-python-essbasic-3.0.996 → tencentcloud-sdk-python-essbasic-3.0.1004}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

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

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

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

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