tencentcloud-sdk-python-essbasic 3.0.1032__tar.gz → 3.0.1040__tar.gz

{tencentcloud-sdk-python-essbasic-3.0.1032 → tencentcloud-sdk-python-essbasic-3.0.1040}/PKG-INFO

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

{tencentcloud-sdk-python-essbasic-3.0.1032 → tencentcloud-sdk-python-essbasic-3.0.1040}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1032'
+__version__ = '3.0.1040'

{tencentcloud-sdk-python-essbasic-3.0.1032 → tencentcloud-sdk-python-essbasic-3.0.1040}/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`
@@ -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`
@@ -965,7 +973,8 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelCreateUserRoles(self, request):
-        """通过此接口，绑定员工角色，支持以电子签userId、客户系统userId两种方式调用。
+        """使用此接口，用来绑定企业实名员工的角色，
+        支持以电子签userId、客户系统openId两种方式进行绑定。
 
         :param request: Request instance for ChannelCreateUserRoles.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateUserRolesRequest`
@@ -1450,6 +1459,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`

{tencentcloud-sdk-python-essbasic-3.0.1032 → tencentcloud-sdk-python-essbasic-3.0.1040}/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
@@ -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`
@@ -2511,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
@@ -2614,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
@@ -2669,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):
@@ -2706,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
@@ -2722,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:
@@ -2734,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:]
@@ -4367,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
@@ -4535,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
@@ -5276,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: 执行本接口操作的员工信息。
 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
@@ -5291,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
@@ -5514,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`
@@ -7054,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`
@@ -7212,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`
@@ -8014,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
@@ -8039,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
@@ -8059,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
@@ -8140,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
@@ -8215,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")
@@ -8969,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: 企业信息变更类型，可选类型如下：
@@ -9350,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
@@ -9369,6 +9472,7 @@ class CreateFlowOption(AbstractModel):
         self._HideShowDeadline = None
         self._CanSkipAddApprover = None
         self._CustomCreateFlowDescription = None
+        self._ForbidEditFillComponent = None
 
     @property
     def CanEditFlow(self):
@@ -9418,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")
@@ -9426,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:]
@@ -9464,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时有效`
 
@@ -9933,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
@@ -9966,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
@@ -10038,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
@@ -10110,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")
@@ -11598,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
@@ -12186,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 则为需要
@@ -12206,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
 - 发起流程时系统自动补充
@@ -13162,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
@@ -13199,8 +13345,6 @@ class FlowInfo(AbstractModel):
 
         :type CustomShowMap: str
         :param _CcInfos: 合同流程的抄送人列表，最多可支持50个抄送人，抄送人可查看合同内容及签署进度，但无需参与合同签署。
-
-注:`此功能为白名单功能，使用前请联系对接的客户经理沟通。`
         :type CcInfos: list of CcInfo
         :param _NeedSignReview: 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
 <ul><li> **false**：（默认）不需要审批，直接签署。</li>

{tencentcloud-sdk-python-essbasic-3.0.1032 → tencentcloud-sdk-python-essbasic-3.0.1040}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

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

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

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

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