tencentcloud-sdk-python-essbasic 3.0.1027__py2.py3-none-any.whl → 3.0.1039__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1027'
+__version__ = '3.0.1039'

tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -302,8 +302,13 @@ class EssbasicClient(AbstractClient):
 
     def ChannelCreateEmbedWebUrl(self, request):
         """本接口（ChannelCreateEmbedWebUrl）用于创建常规模块嵌入web的链接
-        本接口支持创建：创建印章，创建模板，修改模板，预览模板，预览合同流程的web链接
-        进入web连接后与当前控制台操作保持一致
+
+        本接口下面功能的签署页面链接的生成
+        - 创建印章
+        - 创建模板
+        - 修改模板
+        - 预览模板
+        - 预览合同流程
 
         :param request: Request instance for ChannelCreateEmbedWebUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateEmbedWebUrlRequest`
@@ -364,7 +369,7 @@ class EssbasicClient(AbstractClient):
         <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)
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
 
         **可以作为发起方和签署方的角色列表**
         <table>
@@ -778,11 +783,14 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelCreatePrepareFlow(self, request):
-        """创建预发起合同
-        通过此接口指定：合同，签署人，填写控件信息，生成预创建合同链接，点击后跳转到web页面完成合同创建并发起
-        可指定合同信息不可更改，签署人信息不可更改
-        合同发起后，填写及签署流程与现有操作流程一致
-        注意：目前仅支持模板发起
+        """通过此接口指定合同、签署人、填写控件等信息，生成嵌入式链接，此链接可以嵌入到其他网页或者直接打开，打开后进入发起页面。在此页面上，合同信息和签署人信息均不可更改。
+
+        注意：
+        1. **仅支持模板**发起
+        2. 只支持PC浏览器操作使用
+
+        嵌入的页面样式如下：
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/b2ae013fb4d747891dd3815bbe897208.png)
 
         :param request: Request instance for ChannelCreatePrepareFlow.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreatePrepareFlowRequest`
@@ -1392,7 +1400,7 @@ class EssbasicClient(AbstractClient):
         - 出证过程需一定时间，建议在**提交出证任务后的24小时之后**，通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
 
 
-        ![image](https://dyn.ess.tencent.cn/guide/capi/channel_CreateChannelFlowEvidenceReport.png)
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
 
         :param request: Request instance for CreateChannelFlowEvidenceReport.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateChannelFlowEvidenceReportRequest`
@@ -1450,6 +1458,11 @@ class EssbasicClient(AbstractClient):
         <li>证书:   企业证书会重新请求CA机构用新企业名称生成新的证书</li>
         </ul>
 
+
+        注意：
+        1. 生成的电子签小程序链接<font color='red'>只能由企业的法人或者超管</font>点击后进行操作， 其他员工打开后会提示“无权查看该内容”
+        2. 法人可以无需生成链接，直接在电子签小程序中更换本企业的超管
+
         :param request: Request instance for CreateChannelOrganizationInfoChangeUrl.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateChannelOrganizationInfoChangeUrlRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateChannelOrganizationInfoChangeUrlResponse`
@@ -1535,7 +1548,7 @@ class EssbasicClient(AbstractClient):
 
         **整体的逻辑如下**
 
-        ![image](https://dyn.ess.tencent.cn/guide/capi/CreateFlowsByTemplates.png)
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/e193519d4383fa74782a9e19147ef01a/CreateFlowsByTemplates.png)
 
         **可以作为发起方和签署方的角色列表**
         <table>
@@ -1704,7 +1717,7 @@ class EssbasicClient(AbstractClient):
         - 使用此功能`需搭配出证套餐` ，使用前请联系对接的客户经理沟通。
         - 需调用创建并返回出证报告接口<a href="https://qian.tencent.com/developers/partnerApis/certificate/CreateChannelFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>获取报告编号后调用当前接口获取报告链接。
 
-        ![image](https://dyn.ess.tencent.cn/guide/capi/channel_CreateChannelFlowEvidenceReport.png)
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
 
         :param request: Request instance for DescribeChannelFlowEvidenceReport.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeChannelFlowEvidenceReportRequest`
@@ -1823,23 +1836,23 @@ class EssbasicClient(AbstractClient):
 
         **适用场景**
          该接口常用来配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/CreateFlowsByTemplates" target="_blank">用模板创建签署流程</a>和<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates" target="_blank">通过多模板创建合同组签署流程</a>接口，作为创建合同的前置接口使用。
-        通过此接口查询到模板信息后，再通过调用创建合同的接口，指定模板ID，指定模板中需要的填写控件内容等，完成合同文档的的创建。
+        通过此接口查询到模板信息后，再通过调用创建合同的接口，指定模板ID，指定模板中需要的填写控件内容等，完成合同文档的创建。
 
-        **模版的来源**
+        **模板的来源**
         子客企业的模板有两种途径获取
         - 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
         - 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
 
         **一个模板通常会包含以下结构信息**
 
-        - 模板模版ID, 模板名字等基本信息
+        - 模板ID, 模板名字等基本信息
         - 发起方参与信息Promoter、签署参与方 Recipients，后者会在模板发起合同时用于指定参与方
         - 发起方和签署方的填写控件 Components
         - 签署方的签署控件 SignComponents
 
-        ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/ab81fa948a0a6fea14f48cac91d0e36a/channel_DescribeTemplates.png)
 
-        模版中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
+        模板中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
 
         ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
 
@@ -1974,23 +1987,24 @@ class EssbasicClient(AbstractClient):
 
 
     def OperateChannelTemplate(self, request):
-        """此接口（OperateChannelTemplate）用于针对第三方应用平台模板库中的模板对子客企业可见性的查询和设置。
-
-        > **使用场景**
-        >
-        >  1：查询 OperateType=SELECT
-        > - 查询第三方应用平台模板库的可见性以及授权的子客列表。
-        >
-        >  2：修改部分子客授权 OperateType=UPDATE
-        > - 对子客企业进行模板库中模板可见性的进行修改操作。
-        >- 当模板未发布时，可以修改可见性AuthTag（part/all），当模板发布后，不可做此修改
-        > - 若模板已发布且可见性AuthTag是part，可以通过ProxyOrganizationOpenIds增加子客的授权范围。如果是自动领取的模板，增加授权范围后会自动下发。
-        >
-        >  3：取消部分子客授权 OperateType=DELETE
-        > - 对子客企业进行模板库中模板可见性的进行删除操作。
-        > - 主要对于手动领取的模板，去除授权后子客在模板库中看不到，就无法再领取了。但是已经领取过成为自有模板的不会同步删除。
-        > - 对于自动领取的模板，由于已经下发，更改授权不会影响。
-        > - 如果要同步删除子客自有模板库中的模板，请使用OperateType=UPDATE+Available参数处理。
+        """此接口（OperateChannelTemplate）用于针对第三方应用平台模板库中的模板对子客企业发布授权的查询和设置。
+        平台模板库中的模板的位置在控制台 企业应用管理 中下面的应用模板库管理目录, 可以参照下图位置
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/7f2b6c94164b3e931efc9a037e0400f7.png)
+
+        # 支持的操作
+
+        ## 1. 查询模板的子客企业授权 (OperateType=SELECT)
+        - 查询模板的授权子企业列表
+
+        ## 2. 修改模板的子客企业授权 (OperateType=UPDATE)
+        - 当模板未发布时，可以修改模板的模板授权范围是**所有第三方应用合作企业**(AuthTag设置为all)或者**指定第三方应用合作企业**(AuthTag设置为part)，**当模板发布后，不可做此修改**
+        - 如果模板是部分授权,  可通过ProxyOrganizationOpenIds增加子客的授权范围。
+
+        ## 3. 取消模板的子客企业授权 (OperateType=DELETE)
+        - 对子客企业进行模板库中模板授权范围的进行删除操作。
+        - 主要对于手动领取的模板，去除授权后子客在模板库中看不到，就无法再领取了。但是**已经领取过成为自有模板的不会同步删除**。
+        - 对于自动领取的模板，由于已经下发，更改授权不会影响。
+        - 如果要同步删除子客自有模板库中的模板，请使用OperateType=UPDATE+Available参数处理。
 
         :param request: Request instance for OperateChannelTemplate.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.OperateChannelTemplateRequest`
@@ -2080,7 +2094,7 @@ class EssbasicClient(AbstractClient):
 
         - **员工离职的场景**: 将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了,   同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空,  再次加入公司会从零开始) ,  若员工信息有误可通过离职后在新增来解决,  离职员工状态为**离职**
 
-        ![image](https://dyn.ess.tencent.cn/guide/capi/channel_SyncProxyOrganizationOperators.png)
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/7a27a6bb0e4d39c2f6aa2a0b39946181/channel_SyncProxyOrganizationOperators.png)
 
         **注**:
         -  新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理

tencentcloud/essbasic/v20210526/models.py

@@ -242,7 +242,7 @@ class ApproverOption(AbstractModel):
         :type HideOneKeySign: bool
         :param _FillType: 签署人信息补充类型，默认无需补充。
 
-<ul><li> **1** : ( 动态签署人（可发起合同后再补充签署人信息）</li>
+<ul><li> **1** : ( 动态签署人（可发起合同后再补充签署人信息）注：`企业自动签不支持动态补充`</li>
 </ul>
         :type FillType: int
         :param _FlowReadLimit: 签署人阅读合同限制参数
@@ -501,7 +501,7 @@ class AutoSignConfig(AbstractModel):
         :param _LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。
 
 <ul><li>**0**: (默认) 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人`</li>
-</ul>
+<li>**1**: 不绑定自动签账号许可开通，后续使用合同份额进行合同发起</li></ul>
         :type LicenseType: int
         """
         self._UserInfo = None
@@ -596,35 +596,43 @@ class BaseFlowInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FlowName: 合同流程名称
+        :param _FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         :type FlowName: str
-        :param _FlowType: 合同流程类型
-<br/>客户自定义，用于合同分类展示
+        :param _FlowType: 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为200个字符，仅限中文、字母、数字和下划线组成。
         :type FlowType: str
-        :param _FlowDescription: 合同流程描述信息
+        :param _FlowDescription: 合同流程描述信息(可自定义此描述)，最大长度1000个字符。
         :type FlowDescription: str
-        :param _Deadline: 合同流程截止时间，unix时间戳，单位秒
+        :param _Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
         :type Deadline: int
-        :param _Unordered: 是否顺序签署(true:无序签,false:顺序签)
-<br/>默认false，有序签署合同
+        :param _Unordered: 合同流程的签署顺序类型：
+**false**：(默认)有序签署, 本合同多个参与人需要依次签署
+**true**：无序签署, 本合同多个参与人没有先后签署限制
         :type Unordered: bool
         :param _IntelligentStatus: 是否打开智能添加填写区(默认开启，打开:"OPEN" 关闭："CLOSE")
         :type IntelligentStatus: str
-        :param _FormFields: 填写控件内容
+        :param _FormFields: 填写控件内容， 填写的控制的ID-填写的内容对列表
         :type FormFields: list of FormField
-        :param _NeedSignReview: 本企业(发起方企业)是否需要签署审批
-<br/>true：开启发起方签署审批
-<br/>false：不开启发起方签署审批
-<br/>开启后，使用ChannelCreateFlowSignReview接口提交审批结果，才能继续完成签署
+        :param _NeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+<ul><li> **false**：（默认）不需要审批，直接签署。</li>
+<li> **true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
+企业可以通过CreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
+<ul><li> 如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
+<li> 如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
+注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
         :type NeedSignReview: bool
-        :param _UserData: 用户流程自定义数据参数
+        :param _UserData: 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为1000长度。
+
+在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的回调通知模块。
         :type UserData: str
-        :param _CcInfos: 抄送人信息
+        :param _CcInfos: 合同流程的抄送人列表，最多可支持50个抄送人，抄送人可查看合同内容及签署进度，但无需参与合同签署。
+
+注:`此功能为白名单功能，使用前请联系对接的客户经理沟通。`
         :type CcInfos: list of CcInfo
-        :param _NeedCreateReview: 是否需要开启发起方发起前审核
-<br/>true：开启发起方发起前审核
-<br/>false：不开启发起方发起前审核
-<br/>当指定NeedCreateReview=true，则提交审核后，需要使用接口：ChannelCreateFlowSignReview，来完成发起前审核，审核通过后，可以继续查看，签署合同
+        :param _NeedCreateReview: 发起方企业的签署人进行发起操作是否需要企业内部审批。使用此功能需要发起方企业有参与签署。
+
+若设置为true，发起审核结果需通过接口 [提交企业签署流程审批结果](https://qian.tencent.com/developers/partnerApis/operateFlows/ChannelCreateFlowSignReview)通知电子签，审核通过后，发起方企业签署人方可进行发起操作，否则会阻塞其发起操作。
+
+
         :type NeedCreateReview: bool
         :param _Components: 填写控件：文件发起使用
         :type Components: list of Component
@@ -1076,7 +1084,7 @@ class ChannelBatchCancelFlowsRequest(AbstractModel):
 
 注: `CancelMessage为撤销当前合同的理由`
 
-![image](https://dyn.ess.tencent.cn/guide/capi/channel_ChannelCancelFlow.png)
+![image](https://qcloudimg.tencent-cloud.cn/raw/f16cf37dbb3a09d6569877f093b92204/channel_ChannelCancelFlow.png)
 
 
         :type CancelMessageFormat: int
@@ -1618,7 +1626,8 @@ class ChannelCancelUserAutoSignEnableUrlRequest(AbstractModel):
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _Operator: 操作人信息
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
-        :param _SceneKey: 自动签场景: E_PRESCRIPTION_AUTO_SIGN 电子处方
+        :param _SceneKey: 自动签使用的场景值, 可以选择的场景值如下:
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN** :  电子处方场景</li><li> **OTHER** :  通用场景</li></ul>
         :type SceneKey: str
         :param _UserInfo: 指定撤销链接的用户信息，包含姓名、证件类型、证件号码。
         :type UserInfo: :class:`tencentcloud.essbasic.v20210526.models.UserThreeFactor`
@@ -1872,9 +1881,10 @@ class ChannelCreateBatchQuickSignUrlRequest(AbstractModel):
         :type SignatureTypes: list of int
         :param _ApproverSignTypes: 指定批量签署合同的认证校验方式，可传递以下值：
 <ul><li>**1**：人脸认证(默认)，需进行人脸识别成功后才能签署合同</li>
+<li>**2**：密码认证(默认)，需输入与用户在腾讯电子签设置的密码一致才能校验成功进行合同签署</li>
 <li>**3**：运营商三要素，需到运营商处比对手机号实名信息(名字、手机号、证件号)校验一致才能成功进行合同签署。</li></ul>
 注：
-<ul><li>默认情况下，认证校验方式为人脸认证</li>
+<ul><li>默认情况下，认证校验方式为人脸和密码认证</li>
 <li>您可以传递多种值，表示可用多种认证校验方式。</li></ul>
         :type ApproverSignTypes: list of int
         """
@@ -2510,25 +2520,37 @@ class ChannelCreateEmbedWebUrlRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Agent: 渠道应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
+        :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 _EmbedType: 要生成WEB嵌入界面的类型, 可以选择的值如下: 
 
-- CREATE_SEAL: 生成创建印章的嵌入页面
-- CREATE_TEMPLATE：生成创建模板的嵌入页面
-- MODIFY_TEMPLATE：生成修改模板的嵌入页面
-- PREVIEW_TEMPLATE：生成预览模板的嵌入页面
-- PREVIEW_FLOW：生成预览合同文档的嵌入页面
-- PREVIEW_FLOW_DETAIL：生成预览合同详情的嵌入页面
-- PREVIEW_SEAL_LIST：生成预览印章列表的嵌入页面
-- PREVIEW_SEAL_DETAIL：生成预览印章详情的嵌入页面
-- EXTEND_SERVICE：生成扩展服务的嵌入页面
+<ul>
+<li>CREATE_SEAL: 生成创建印章的嵌入页面</li>
+<li>CREATE_TEMPLATE：生成创建模板的嵌入页面</li>
+<li>MODIFY_TEMPLATE：生成修改模板的嵌入页面</li>
+<li>PREVIEW_TEMPLATE：生成预览模板的嵌入页面</li>
+<li>PREVIEW_FLOW：生成预览合同文档的嵌入页面</li>
+<li>PREVIEW_FLOW_DETAIL：生成预览合同详情的嵌入页面</li>
+<li>PREVIEW_SEAL_LIST：生成预览印章列表的嵌入页面</li>
+<li>PREVIEW_SEAL_DETAIL：生成预览印章详情的嵌入页面</li>
+<li>EXTEND_SERVICE：生成扩展服务的嵌入页面</li>
+</ul>
         :type EmbedType: str
         :param _BusinessId: WEB嵌入的业务资源ID
 
-- 当EmbedType取值MODIFY_TEMPLATE，PREVIEW_TEMPLATE时需要填写模板id作为BusinessId
-- 当EmbedType取值PREVIEW_FLOW，PREVIEW_FLOW_DETAIL时需要填写合同id作为BusinessId
-- 当EmbedType取值PREVIEW_SEAL_DETAIL需要填写印章id作为BusinessId
+<ul>
+<li>当EmbedType取值MODIFY_TEMPLATE，PREVIEW_TEMPLATE时需要填写模板id作为BusinessId</li>
+<li>当EmbedType取值PREVIEW_FLOW，PREVIEW_FLOW_DETAIL时需要填写合同id作为BusinessId</li>
+<li>当EmbedType取值PREVIEW_SEAL_DETAIL需要填写印章id作为BusinessId</li>
+</ul>
         :type BusinessId: str
         :param _HiddenComponents: 是否隐藏控件，只有预览模板时生效
         :type HiddenComponents: bool
@@ -2613,7 +2635,7 @@ class ChannelCreateEmbedWebUrlResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _WebUrl: 嵌入的web链接
+        :param _WebUrl: 嵌入的web链接，5分钟有效
         :type WebUrl: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -2668,18 +2690,18 @@ class ChannelCreateFlowApproversRequest(AbstractModel):
 
 - 如果不指定，则使用姓名和手机号进行补充。
         :type Approvers: list of FillApproverInfo
-        :param _Operator: 操作人信息
-        :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
         :param _FillApproverType: 签署人信息补充方式
 
-<ul><li>**1**: 补充动态签署人，可补充企业和个人签署人。注: `每个签署方节点签署人是唯一的，一个节点只支持传入一个签署人信息`</li></ul>
+<ul><li>**1**: 表示往未指定签署人的节点，添加一个明确的签署人，支持企业或个人签署方。</li></ul>
         :type FillApproverType: int
+        :param _Operator: 操作人信息
+        :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
         """
         self._Agent = None
         self._FlowId = None
         self._Approvers = None
-        self._Operator = None
         self._FillApproverType = None
+        self._Operator = None
 
     @property
     def Agent(self):
@@ -2705,14 +2727,6 @@ class ChannelCreateFlowApproversRequest(AbstractModel):
     def Approvers(self, Approvers):
         self._Approvers = Approvers
 
-    @property
-    def Operator(self):
-        return self._Operator
-
-    @Operator.setter
-    def Operator(self, Operator):
-        self._Operator = Operator
-
     @property
     def FillApproverType(self):
         return self._FillApproverType
@@ -2721,6 +2735,14 @@ class ChannelCreateFlowApproversRequest(AbstractModel):
     def FillApproverType(self, FillApproverType):
         self._FillApproverType = FillApproverType
 
+    @property
+    def Operator(self):
+        return self._Operator
+
+    @Operator.setter
+    def Operator(self, Operator):
+        self._Operator = Operator
+
 
     def _deserialize(self, params):
         if params.get("Agent") is not None:
@@ -2733,10 +2755,10 @@ class ChannelCreateFlowApproversRequest(AbstractModel):
                 obj = FillApproverInfo()
                 obj._deserialize(item)
                 self._Approvers.append(obj)
+        self._FillApproverType = params.get("FillApproverType")
         if params.get("Operator") is not None:
             self._Operator = UserInfo()
             self._Operator._deserialize(params.get("Operator"))
-        self._FillApproverType = params.get("FillApproverType")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -4366,19 +4388,27 @@ class ChannelCreatePrepareFlowRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _ResourceId: 资源id，与ResourceType对应
+        :param _ResourceId: 合同模板ID，为32位字符串。
         :type ResourceId: str
-        :param _ResourceType: 资源类型，与ResourceId对应1：模板   2: 文件
+        :param _ResourceType: 资源类型，此接口固定为**1**表示为用模板发起
         :type ResourceType: int
-        :param _FlowInfo: 合同流程基础信息
+        :param _FlowInfo: 要创建的合同信息
         :type FlowInfo: :class:`tencentcloud.essbasic.v20210526.models.BaseFlowInfo`
-        :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填
+        :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 _FlowOption: 合同流程配置信息，用于配置发起合同时定制化
+        :param _FlowOption: 合同流程配置信息，用于配置发起合同时定制化如是否允许修改，某些按钮的隐藏等逻辑
         :type FlowOption: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowOption`
         :param _FlowApproverList: 合同签署人信息
         :type FlowApproverList: list of CommonFlowApprover
-        :param _FlowId: 通过flowid快速获得之前成功通过页面发起的合同生成链接
+        :param _FlowId: 用过去已经通过此接口发起的合同的ID复制个新的合同创建链接
         :type FlowId: str
         :param _NeedPreview: 该参数不可用，请通过获取 web 可嵌入接口获取合同流程预览 URL
         :type NeedPreview: bool
@@ -4534,9 +4564,9 @@ class ChannelCreatePrepareFlowResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _PrepareFlowUrl: 预发起的合同链接， 可以直接点击进入进行合同发起
+        :param _PrepareFlowUrl: 发起的合同嵌入链接， 可以直接点击进入进行合同发起， 有效期为5分钟
         :type PrepareFlowUrl: str
-        :param _PreviewFlowUrl: 合同发起后预览链接， 注意此时合同并未发起，仅只是展示效果
+        :param _PreviewFlowUrl: 合同发起后预览链接， 注意此时合同并未发起，仅只是展示效果， 有效期为5分钟
         :type PreviewFlowUrl: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -5275,9 +5305,7 @@ class ChannelCreateUserAutoSignEnableUrlRequest(AbstractModel):
         :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _SceneKey: 自动签使用的场景值, 可以选择的场景值如下:
-<ul><li> **E_PRESCRIPTION_AUTO_SIGN** :  电子处方场景</li></ul>
-
-注: `现在仅支持电子处方场景`
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN** :  电子处方场景</li><li> **OTHER** :  通用场景</li></ul>
         :type SceneKey: str
         :param _Operator: 执行本接口操作的员工信息。
 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
@@ -5290,7 +5318,7 @@ class ChannelCreateUserAutoSignEnableUrlRequest(AbstractModel):
         :type UrlType: str
         :param _NotifyType: 是否通知开通方，通知类型:
 <ul><li>默认不设置为不通知开通方</li>
-<li>**SMS** :  短信通知 ,如果需要短信通知则NotifyAddress填写对方的手机号</li><ul>
+<li>**SMS** :  短信通知 ,如果需要短信通知则NotifyAddress填写对方的手机号</li></ul>
         :type NotifyType: str
         :param _NotifyAddress: 如果通知类型NotifyType选择为SMS，则此处为手机号, 其他通知类型不需要设置此项
         :type NotifyAddress: str
@@ -5513,9 +5541,7 @@ class ChannelCreateUserAutoSignSealUrlRequest(AbstractModel):
         :param _Agent: 渠道应用相关信息。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _SceneKey: 自动签使用的场景值, 可以选择的场景值如下:
-<ul><li> **E_PRESCRIPTION_AUTO_SIGN** :  电子处方场景</li></ul>
-
-注: `现在仅支持电子处方场景`
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN** :  电子处方场景</li><li> **OTHER** :  通用场景</li></ul>
         :type SceneKey: str
         :param _UserInfo: 自动签开通个人用户信息，包括名字，身份证等。
         :type UserInfo: :class:`tencentcloud.essbasic.v20210526.models.UserThreeFactor`
@@ -7053,9 +7079,7 @@ class ChannelDescribeUserAutoSignStatusRequest(AbstractModel):
         :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _SceneKey: 自动签使用的场景值, 可以选择的场景值如下:
-<ul><li> **E_PRESCRIPTION_AUTO_SIGN** : 电子处方场景</li></ul>
-
-注: `现在仅支持电子处方场景`
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN** :  电子处方场景</li><li> **OTHER** :  通用场景</li></ul>
         :type SceneKey: str
         :param _UserInfo: 要查询状态的用户信息, 包括名字,身份证等
         :type UserInfo: :class:`tencentcloud.essbasic.v20210526.models.UserThreeFactor`
@@ -7211,7 +7235,7 @@ class ChannelDisableUserAutoSignRequest(AbstractModel):
         :param _Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _SceneKey: 自动签使用的场景值, 可以选择的场景值如下:
-<ul><li> **E_PRESCRIPTION_AUTO_SIGN** 电子处方</li></ul>
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN** :  电子处方场景</li><li> **OTHER** :  通用场景</li></ul>
         :type SceneKey: str
         :param _UserInfo: 需要关闭自动签的个人的信息，如姓名，证件信息等。
         :type UserInfo: :class:`tencentcloud.essbasic.v20210526.models.UserThreeFactor`
@@ -7623,21 +7647,23 @@ class ChannelModifyRoleResponse(AbstractModel):
 
 
 class ChannelRole(AbstractModel):
-    """渠道角色信息
+    """角色信息
 
     """
 
     def __init__(self):
         r"""
-        :param _RoleId: 角色id
+        :param _RoleId: 角色ID,为32位字符串
 注意：此字段可能返回 null，表示取不到有效值。
         :type RoleId: str
-        :param _RoleName: 角色名
+        :param _RoleName: 角色的名称
 注意：此字段可能返回 null，表示取不到有效值。
         :type RoleName: str
-        :param _RoleStatus: 角色状态：1-启用；2-禁用
+        :param _RoleStatus: 此角色状态
+1: 已经启用
+2: 已经禁用
         :type RoleStatus: int
-        :param _PermissionGroups: 权限树
+        :param _PermissionGroups: 此角色对应的权限列表
 注意：此字段可能返回 null，表示取不到有效值。
         :type PermissionGroups: list of PermissionGroup
         """
@@ -8011,24 +8037,50 @@ class CommonFlowApprover(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _NotChannelOrganization: 指定当前签署人为第三方应用集成子客，默认false：当前签署人为第三方应用集成子客，true：当前签署人为saas企业用户
+        :param _NotChannelOrganization: 指定签署人非第三方平台子客企业下员工还是SaaS平台企业，在ApproverType为ORGANIZATION时指定。
+<ul>
+<li>false: 默认值，第三方平台子客企业下员工</li>
+<li>true: SaaS平台企业下的员工</li>
+</ul>
+
         :type NotChannelOrganization: bool
-        :param _ApproverType: 签署人类型,目前支持：0-企业签署人，1-个人签署人，3-企业静默签署人
+        :param _ApproverType: 在指定签署方时，可选择企业B端或个人C端等不同的参与者类型，可选类型如下:
+
+ **0** :企业/企业员工（企业签署方或模板发起时的企业静默签）
+ **1** :个人/自然人
+**3** :企业/企业员工自动签（他方企业自动签署或文件发起时的本方企业自动签）
+
+注：类型为3（企业/企业员工自动签）时，此接口会默认完成该签署方的签署。静默签署仅进行盖章操作，不能自动签名。
+
         :type ApproverType: int
-        :param _OrganizationId: 企业id
+        :param _OrganizationId: 电子签平台给企业生成的企业id
         :type OrganizationId: str
         :param _OrganizationOpenId: 企业OpenId，第三方应用集成非静默签子客企业签署人发起合同必传
         :type OrganizationOpenId: str
         :param _OrganizationName: 企业名称，第三方应用集成非静默签子客企业签署人必传，saas企业签署人必传
         :type OrganizationName: str
-        :param _UserId: 用户id
+        :param _UserId: 电子签平台给企业员工或者自热人生成的用户id
         :type UserId: str
-        :param _OpenId: 用户openId，第三方应用集成非静默签子客企业签署人必传
+        :param _OpenId: 第三方平台子客企业员工的唯一标识
         :type OpenId: str
-        :param _ApproverName: 签署人名称，saas企业签署人，个人签署人必传
+        :param _ApproverName: 签署方经办人的姓名。
+经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         :type ApproverName: str
         :param _ApproverMobile: 签署人手机号，saas企业签署人，个人签署人必传
         :type ApproverMobile: str
+        :param _ApproverIdCardType: 签署方经办人的证件类型，支持以下类型
+<ul><li>ID_CARD : 居民身份证  (默认值)</li>
+<li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
+<li>OTHER_CARD_TYPE : 其他证件</li></ul>
+
+注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
+        :type ApproverIdCardType: str
+        :param _ApproverIdCardNumber: 签署方经办人的证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
+        :type ApproverIdCardNumber: str
         :param _RecipientId: 签署人Id，使用模板发起是，对应模板配置中的签署人RecipientId
 注意：模板发起时该字段必填
         :type RecipientId: str
@@ -8036,15 +8088,34 @@ class CommonFlowApprover(AbstractModel):
         :type PreReadTime: int
         :param _IsFullText: 签署前置条件：阅读全文限制
         :type IsFullText: bool
-        :param _NotifyType: 通知类型：SMS（短信） NONE（不做通知）, 不传 默认SMS
+        :param _NotifyType: 通知签署方经办人的方式, 有以下途径:
+<ul><li> **SMS** :(默认)短信</li>
+<li> **NONE** : 不通知</li></ul>
+
+注: `签署方为第三方子客企业时会被置为NONE,   不会发短信通知`
         :type NotifyType: str
         :param _ApproverOption: 签署人配置
         :type ApproverOption: :class:`tencentcloud.essbasic.v20210526.models.CommonApproverOption`
-        :param _SignComponents: 签署控件：文件发起使用
+        :param _SignComponents: 使用PDF文件直接发起合同时，签署人指定的签署控件；<br/>使用模板发起合同时，指定本企业印章签署控件的印章ID: <br/>通过ComponentId或ComponenetName指定签署控件，ComponentValue为印章ID。
         :type SignComponents: list of Component
-        :param _ApproverVerifyTypes: 签署人查看合同时认证方式, 1-实名查看 2-短信验证码查看(企业签署方不支持该方式) 如果不传默认为1 查看合同的认证方式 Flow层级的优先于approver层级的 （当手写签名方式为OCR_ESIGN时，合同认证方式2无效，因为这种签名方式依赖实名认证）
+        :param _ApproverVerifyTypes: 指定个人签署方查看合同的校验方式,可以传值如下:
+<ul><li>  **1**   : （默认）人脸识别,人脸识别后才能合同内容</li>
+<li>  **2**  : 手机号验证, 用户手机号和参与方手机号(ApproverMobile)相同即可查看合同内容（当手写签名方式为OCR_ESIGN时，该校验方式无效，因为这种签名方式依赖实名认证）
+</li></ul>
+注: 
+<ul><li>如果合同流程设置ApproverVerifyType查看合同的校验方式,    则忽略此签署人的查看合同的校验方式</li>
+<li>此字段可传多个校验方式</li></ul>
         :type ApproverVerifyTypes: list of int
-        :param _ApproverSignTypes: 签署人签署合同时的认证方式 1-人脸认证 2-签署密码 3-运营商三要素(默认为1,2)	
+        :param _ApproverSignTypes: 签署人签署合同时的认证方式
+<ul><li> **1** :人脸认证</li>
+<li> **2** :签署密码</li>
+<li> **3** :运营商三要素</li></ul>
+
+默认为1(人脸认证 ),2(签署密码)
+
+注: 
+1. 用<font color='red'>模版创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color='red'>在创建合同重新指定无效</font>
+2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/partner/mobile_support)得到具体的支持说明
         :type ApproverSignTypes: list of int
         """
         self._NotChannelOrganization = None
@@ -8056,6 +8127,8 @@ class CommonFlowApprover(AbstractModel):
         self._OpenId = None
         self._ApproverName = None
         self._ApproverMobile = None
+        self._ApproverIdCardType = None
+        self._ApproverIdCardNumber = None
         self._RecipientId = None
         self._PreReadTime = None
         self._IsFullText = None
@@ -8137,6 +8210,22 @@ class CommonFlowApprover(AbstractModel):
     def ApproverMobile(self, ApproverMobile):
         self._ApproverMobile = ApproverMobile
 
+    @property
+    def ApproverIdCardType(self):
+        return self._ApproverIdCardType
+
+    @ApproverIdCardType.setter
+    def ApproverIdCardType(self, ApproverIdCardType):
+        self._ApproverIdCardType = ApproverIdCardType
+
+    @property
+    def ApproverIdCardNumber(self):
+        return self._ApproverIdCardNumber
+
+    @ApproverIdCardNumber.setter
+    def ApproverIdCardNumber(self, ApproverIdCardNumber):
+        self._ApproverIdCardNumber = ApproverIdCardNumber
+
     @property
     def RecipientId(self):
         return self._RecipientId
@@ -8212,6 +8301,8 @@ class CommonFlowApprover(AbstractModel):
         self._OpenId = params.get("OpenId")
         self._ApproverName = params.get("ApproverName")
         self._ApproverMobile = params.get("ApproverMobile")
+        self._ApproverIdCardType = params.get("ApproverIdCardType")
+        self._ApproverIdCardNumber = params.get("ApproverIdCardNumber")
         self._RecipientId = params.get("RecipientId")
         self._PreReadTime = params.get("PreReadTime")
         self._IsFullText = params.get("IsFullText")
@@ -8966,9 +9057,9 @@ class CreateChannelOrganizationInfoChangeUrlRequest(AbstractModel):
 
 此接口下面信息必填。
 <ul>
-<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+<li>渠道应用标识:  Agent.AppId</li>
 <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
-<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+<li>第三方平台子客企业中的员工标识: Agent.ProxyOrganizationOpenId</li>
 </ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _ChangeType: 企业信息变更类型，可选类型如下：
@@ -9347,18 +9438,33 @@ class CreateFlowOption(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _CanEditFlow: 是否允许修改合同信息，true-是，false-否
+        :param _CanEditFlow: 是否允许修改合同信息，
+**true**：可以
+**false**：（默认）不可以
         :type CanEditFlow: bool
-        :param _HideShowFlowName: 是否允许发起合同弹窗隐藏合同名称，true-允许，false-不允许
+        :param _HideShowFlowName: 是否允许发起合同弹窗隐藏合同名称
+**true**：允许
+**false**：（默认）不允许
         :type HideShowFlowName: bool
-        :param _HideShowFlowType: 是否允许发起合同弹窗隐藏合同类型，true-允许，false-不允许
+        :param _HideShowFlowType: 是否允许发起合同弹窗隐藏合同类型，
+**true**：允许
+**false**：（默认）不允许
         :type HideShowFlowType: bool
-        :param _HideShowDeadline: 是否允许发起合同弹窗隐藏合同到期时间，true-允许，false-不允许
+        :param _HideShowDeadline: 是否允许发起合同弹窗隐藏合同到期时间
+**true**：允许
+**false**：（默认）不允许
         :type HideShowDeadline: bool
-        :param _CanSkipAddApprover: 是否允许发起合同步骤跳过指定签署方步骤，true-允许，false-不允许
+        :param _CanSkipAddApprover: 是否允许发起合同步骤跳过指定签署方步骤
+**true**：允许
+**false**：（默认）不允许
         :type CanSkipAddApprover: bool
-        :param _CustomCreateFlowDescription: 定制化发起合同弹窗的描述信息，描述信息最长500
+        :param _CustomCreateFlowDescription: 定制化发起合同弹窗的描述信息，长度不能超过500，只能由中文、字母、数字和标点组成。
         :type CustomCreateFlowDescription: str
+        :param _ForbidEditFillComponent: 禁止编辑填写控件
+
+**true**：禁止编辑填写控件
+**false**：（默认）允许编辑填写控件
+        :type ForbidEditFillComponent: bool
         """
         self._CanEditFlow = None
         self._HideShowFlowName = None
@@ -9366,6 +9472,7 @@ class CreateFlowOption(AbstractModel):
         self._HideShowDeadline = None
         self._CanSkipAddApprover = None
         self._CustomCreateFlowDescription = None
+        self._ForbidEditFillComponent = None
 
     @property
     def CanEditFlow(self):
@@ -9415,6 +9522,14 @@ class CreateFlowOption(AbstractModel):
     def CustomCreateFlowDescription(self, CustomCreateFlowDescription):
         self._CustomCreateFlowDescription = CustomCreateFlowDescription
 
+    @property
+    def ForbidEditFillComponent(self):
+        return self._ForbidEditFillComponent
+
+    @ForbidEditFillComponent.setter
+    def ForbidEditFillComponent(self, ForbidEditFillComponent):
+        self._ForbidEditFillComponent = ForbidEditFillComponent
+
 
     def _deserialize(self, params):
         self._CanEditFlow = params.get("CanEditFlow")
@@ -9423,6 +9538,7 @@ class CreateFlowOption(AbstractModel):
         self._HideShowDeadline = params.get("HideShowDeadline")
         self._CanSkipAddApprover = params.get("CanSkipAddApprover")
         self._CustomCreateFlowDescription = params.get("CustomCreateFlowDescription")
+        self._ForbidEditFillComponent = params.get("ForbidEditFillComponent")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -9444,9 +9560,9 @@ class CreateFlowsByTemplatesRequest(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 _FlowInfos: 要创建的合同信息列表，最多支持一次创建20个合同
@@ -9461,7 +9577,7 @@ class CreateFlowsByTemplatesRequest(AbstractModel):
 
         :type NeedPreview: bool
         :param _PreviewType: 预览模式下产生的预览链接类型 
-<ul><li> **0** :(默认) 文件流 ,点开后后下载预览的合同PDF文件 </li>
+<ul><li> **0** :(默认) 文件流 ,点开后下载预览的合同PDF文件 </li>
 <li> **1** :H5链接 ,点开后在浏览器中展示合同的样子</li></ul>
 注: `此参数在NeedPreview 为true时有效`
 
@@ -9930,6 +10046,16 @@ class CreateSignUrlsRequest(AbstractModel):
         :param _Mobile: 合同流程里边签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
 注:  `GenerateType为"PERSON"或"FOLLOWER"时必填`
         :type Mobile: str
+        :param _IdCardType: 证件类型，支持以下类型
+<ul><li>ID_CARD : 居民身份证</li>
+<li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
+        :type IdCardType: str
+        :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 _OrganizationOpenId: 第三方平台子客企业的企业的标识, 即OrganizationOpenId
 注: `GenerateType为"CHANNEL"时必填`
         :type OrganizationOpenId: str
@@ -9963,6 +10089,8 @@ class CreateSignUrlsRequest(AbstractModel):
         self._OrganizationName = None
         self._Name = None
         self._Mobile = None
+        self._IdCardType = None
+        self._IdCardNumber = None
         self._OrganizationOpenId = None
         self._OpenId = None
         self._AutoJumpBack = None
@@ -10035,6 +10163,22 @@ class CreateSignUrlsRequest(AbstractModel):
     def Mobile(self, Mobile):
         self._Mobile = Mobile
 
+    @property
+    def IdCardType(self):
+        return self._IdCardType
+
+    @IdCardType.setter
+    def IdCardType(self, IdCardType):
+        self._IdCardType = IdCardType
+
+    @property
+    def IdCardNumber(self):
+        return self._IdCardNumber
+
+    @IdCardNumber.setter
+    def IdCardNumber(self, IdCardNumber):
+        self._IdCardNumber = IdCardNumber
+
     @property
     def OrganizationOpenId(self):
         return self._OrganizationOpenId
@@ -10107,6 +10251,8 @@ class CreateSignUrlsRequest(AbstractModel):
         self._OrganizationName = params.get("OrganizationName")
         self._Name = params.get("Name")
         self._Mobile = params.get("Mobile")
+        self._IdCardType = params.get("IdCardType")
+        self._IdCardNumber = params.get("IdCardNumber")
         self._OrganizationOpenId = params.get("OrganizationOpenId")
         self._OpenId = params.get("OpenId")
         self._AutoJumpBack = params.get("AutoJumpBack")
@@ -10934,7 +11080,7 @@ class DescribeTemplatesRequest(AbstractModel):
 
 可以通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录企业控制台, 在企业模板中得到合同模板ID。
         :type TemplateId: str
-        :param _ContentType: 查询模版的内容
+        :param _ContentType: 查询模板的内容
 
 <ul><li>**0**：（默认）模板列表及详情</li>
 <li>**1**：仅模板列表, 不会返回模板中的签署控件, 填写控件, 参与方角色列表等信息</li></ul>
@@ -11595,8 +11741,8 @@ class FillApproverInfo(AbstractModel):
         :type OrganizationName: str
         :param _OrganizationOpenId: 企业OpenId
         :type OrganizationOpenId: str
-        :param _NotChannelOrganization: 签署企业非渠道子客，默认为false，即表示同一渠道下的企业；如果为true，则目前表示接收方企业为SaaS企业, 为渠道子客时，organization_open_id+open_id 必传
-        :type NotChannelOrganization: str
+        :param _NotChannelOrganization: 签署企业非渠道子客，默认为false，即表示同一渠道下的企业；如果为true，则目前表示接收方企业为SaaS企业, 为渠道子客时，OrganizationOpenId 必传
+        :type NotChannelOrganization: bool
         """
         self._RecipientId = None
         self._OpenId = None
@@ -12148,7 +12294,7 @@ class FlowApproverInfo(AbstractModel):
 <ul><li> **PERSON** :个人/自然人</li>
 <li> **PERSON_AUTO_SIGN** :个人/自然人自动签署，适用于个人自动签场景</li>
 <li> **ORGANIZATION** :企业/企业员工（企业签署方或模板发起时的企业静默签）</li>
-<li> **ENTERPRISESERVER** :企业/企业员自动签（他方企业自动签署或文件发起时的本方企业自动签）</li></ul>
+<li> **ENTERPRISESERVER** :企业/企业员工自动签（他方企业自动签署或文件发起时的本方企业自动签）</li></ul>
 
 注:  
 `1. 个人自动签场景(PERSON_AUTO_SIGN)为白名单功能, 使用前请联系对接的客户经理沟通。`
@@ -12183,7 +12329,7 @@ class FlowApproverInfo(AbstractModel):
         :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 则为需要
@@ -12203,7 +12349,9 @@ class FlowApproverInfo(AbstractModel):
 
 默认为1(人脸认证 ),2(签署密码)
 
-注: `用模版创建合同场景, 签署人的认证方式需要在配置模板的时候指定, 在此创建合同指定无效`
+注: 
+1. 用<font color='red'>模版创建合同场景</font>, 签署人的认证方式需要在配置模板的时候指定, <font color='red'>在创建合同重新指定无效</font>
+2. 运营商三要素认证方式对手机号运营商及前缀有限制,可以参考[运营商支持列表类](https://qian.tencent.com/developers/partner/mobile_support)得到具体的支持说明
         :type ApproverSignTypes: list of int
         :param _SignId: 签署ID
 - 发起流程时系统自动补充
@@ -13159,6 +13307,7 @@ class FlowInfo(AbstractModel):
 示例值：1604912664
         :type Deadline: int
         :param _TemplateId: 用户配置的合同模板ID，会基于此模板创建合同文档，为32位字符串。
+如果使用模板发起接口，此参数为必填。
 
 可以通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录企业控制台, 在**企业模板**中得到合同模板ID。
         :type TemplateId: str
@@ -14123,32 +14272,35 @@ class OperateChannelTemplateRequest(AbstractModel):
 <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
 </ul>
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _OperateType: 操作类型，
+        :param _OperateType: 操作类型，可取值如下:
 <ul>
-<li>查询:"SELECT"</li>
-<li>删除:"DELETE"</li>
-<li>更新:"UPDATE"</li>
+<li>SELECT:  查询</li>
+<li>DELETE:  删除</li>
+<li>UPDATE: 更新</li>
 </ul>
         :type OperateType: str
-        :param _TemplateId: 合同模板ID，为32位字符串。此处为第三方应用平台模板库模板ID，非子客模板ID。
+        :param _TemplateId: 合同模板ID，为32位字符串。
+注: ` 此处为第三方应用平台模板库模板ID，非子客模板ID`
         :type TemplateId: str
-        :param _ProxyOrganizationOpenIds: 第三方平台子客企业的唯一标识，长度不能超过64，只能由字母和数字组成。开发者可自定义此字段的值，并需要保存此 ID 以便进行后续操作。
-
-一个第三方平台子客企业主体与子客企业 ProxyOrganizationOpenId 是一一对应的，不可更改，不可重复使用。例如，可以使用企业名称的哈希值，或者社会统一信用代码的哈希值，或者随机哈希值。
+        :param _ProxyOrganizationOpenIds: 第三方平台子客企业的唯一标识，支持批量(用,分割)，
         :type ProxyOrganizationOpenIds: str
-        :param _AuthTag: 模板可见性, 
-<ul>
-<li>全部可见-"all"</li>
-<li>部分可见-"part"</li>
-</ul>
+        :param _AuthTag: 模板可见范围, 可以设置的值如下:
+
+**all**: 所有本第三方应用合作企业可见
+**part**: 指定的本第三方应用合作企业
+
+对应控制台的位置
+![image](https://qcloudimg.tencent-cloud.cn/raw/68b97812c68d6af77a5991e3bff5c790.png)
+
         :type AuthTag: str
         :param _Available: 当OperateType=UPDATE时，可以通过设置此字段对模板启停用状态进行操作。
 <ul>
-<li>若此字段值为0，则不会修改模板Available</li>
-<li>1为启用模板</li>
-<li>2为停用模板</li>
+<li>0: 不修改模板可用状态</li>
+<li>1:  启用模板</li>
+<li>2: 停用模板</li>
 </ul>
 启用后模板可以正常领取。
+
 停用后，推送方式为【自动推送】的模板则无法被子客使用，推送方式为【手动领取】的模板则无法出现被模板库被子客领用。
 如果Available更新失败，会直接返回错误。
         :type Available: int
@@ -14253,30 +14405,26 @@ class OperateChannelTemplateResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _AppId: 腾讯电子签颁发给第三方应用平台的应用ID
+        :param _AppId: 第三方应用平台的应用ID
 注意：此字段可能返回 null，表示取不到有效值。
         :type AppId: str
-        :param _TemplateId: 合同模板ID，为32位字符串。此处为第三方应用平台模板库模板ID，非子客模板ID。
+        :param _TemplateId: 合同模板ID
 注意：此字段可能返回 null，表示取不到有效值。
         :type TemplateId: str
-        :param _OperateResult: 描述模板可见性更改的结果，和参数中Available无关。
+        :param _OperateResult: 描述模板可见性更改的结果。
 <ul>
-<li>全部成功-"all-success"</li>
-<li>部分成功-"part-success"</li>
-<li>全部失败-"fail"，失败的会在FailMessageList中展示</li>
+<li>all-success: 全部成功</li>
+<li>part-success: 部分成功,失败的会在FailMessageList中展示</li>
+<li>fail:全部失败, 失败的会在FailMessageList中展示</li>
 </ul>
 注意：此字段可能返回 null，表示取不到有效值。
         :type OperateResult: str
-        :param _AuthTag: 模板可见性, 
-<ul>
-<li>全部可见-"all"</li>
-<li>部分可见-"part"</li>
-</ul>
+        :param _AuthTag: 模板可见范围:
+**all**: 所有本第三方应用合作企业可见
+**part**: 指定的本第三方应用合作企业
 注意：此字段可能返回 null，表示取不到有效值。
         :type AuthTag: str
-        :param _ProxyOrganizationOpenIds: 第三方平台子客企业的唯一标识，长度不能超过64，只能由字母和数字组成。开发者可自定义此字段的值，并需要保存此 ID 以便进行后续操作。
-
-一个第三方平台子客企业主体与子客企业 ProxyOrganizationOpenId 是一一对应的，不可更改，不可重复使用。例如，可以使用企业名称的哈希值，或者社会统一信用代码的哈希值，或者随机哈希值。
+        :param _ProxyOrganizationOpenIds: 第三方平台子客企业标识列表
 注意：此字段可能返回 null，表示取不到有效值。
         :type ProxyOrganizationOpenIds: list of str
         :param _FailMessageList: 操作失败信息数组

{tencentcloud_sdk_python_essbasic-3.0.1027.dist-info → tencentcloud_sdk_python_essbasic-3.0.1039.dist-info}/METADATA

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

{tencentcloud_sdk_python_essbasic-3.0.1027.dist-info → tencentcloud_sdk_python_essbasic-3.0.1039.dist-info}/RECORD

@@ -1,4 +1,4 @@
-tencentcloud/__init__.py,sha256=7p9ZoFHBfT2R0O4mxlx5Pc9Rn1afl5a5q5uPLxnUGLk,631
+tencentcloud/__init__.py,sha256=eVJba6cUeYHtJNR-aLRWizFJ4_6zQTOzKJf9UeZva-M,631
 tencentcloud/essbasic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tencentcloud/essbasic/v20201222/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tencentcloud/essbasic/v20201222/errorcodes.py,sha256=cZPs0vLmArRFQoZqxM4alb0WeBF9f0V0IHmt65dUdxs,5392
@@ -6,9 +6,9 @@ tencentcloud/essbasic/v20201222/essbasic_client.py,sha256=kua9joup-BLKbyITYpVovM
 tencentcloud/essbasic/v20201222/models.py,sha256=Q2E6jmVT1emRziwRN-qj8XpdzpxvqqHTKOEQz8JaM_s,270905
 tencentcloud/essbasic/v20210526/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tencentcloud/essbasic/v20210526/errorcodes.py,sha256=L7u1uH1UVbsjd_f2RTdpmzKFDQJN-lfFZUyKhBDluxQ,18083
-tencentcloud/essbasic/v20210526/essbasic_client.py,sha256=5U4BbJai3WC962_eUnL5tGQFEkzGWOQPQUt1lUtb0rw,108082
-tencentcloud/essbasic/v20210526/models.py,sha256=F9nlHYjFzaV3oDsMXMcQcPJKBLHNdA05jy0ee_GC5Qo,594760
-tencentcloud_sdk_python_essbasic-3.0.1027.dist-info/METADATA,sha256=5GB74Qo_ohCaNiYXQJrxnYzg-oao7dgSQQEYOxhbmFs,1517
-tencentcloud_sdk_python_essbasic-3.0.1027.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
-tencentcloud_sdk_python_essbasic-3.0.1027.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
-tencentcloud_sdk_python_essbasic-3.0.1027.dist-info/RECORD,,
+tencentcloud/essbasic/v20210526/essbasic_client.py,sha256=X_2y3ppwYRy7XuCVDbS_i73iw86OXJ09vwXuGjIFKqs,108846
+tencentcloud/essbasic/v20210526/models.py,sha256=yTWHaNd684tiWUhYdkozXimaFlJdvbEk-B6M40g_7o8,603190
+tencentcloud_sdk_python_essbasic-3.0.1039.dist-info/METADATA,sha256=XSXL_H4rrU8ZkGSDtT6qgKFiVEA1K2lmZ7MkyLsXYCo,1517
+tencentcloud_sdk_python_essbasic-3.0.1039.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
+tencentcloud_sdk_python_essbasic-3.0.1039.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
+tencentcloud_sdk_python_essbasic-3.0.1039.dist-info/RECORD,,