tencentcloud-sdk-python 3.0.974__py2.py3-none-any.whl → 3.0.976__py2.py3-none-any.whl

tencentcloud/ess/v20201111/models.py

@@ -843,19 +843,19 @@ class BindEmployeeUserIdWithClientOpenIdResponse(AbstractModel):
 
 
 class CallbackInfo(AbstractModel):
-    """应用回调信息
+    """企业应用回调信息
 
     """
 
     def __init__(self):
         r"""
-        :param _CallbackUrl: 回调url
+        :param _CallbackUrl: 回调url,。请确保回调地址能够接收并处理 HTTP POST 请求，并返回状态码 200 以表示处理正常。
         :type CallbackUrl: str
         :param _Token: 回调加密key，已废弃
         :type Token: str
-        :param _CallbackKey: 回调加密key
+        :param _CallbackKey: 回调加密key，用于回调消息加解密。
         :type CallbackKey: str
-        :param _CallbackToken: 回调验签token
+        :param _CallbackToken: 回调验签token，用于回调通知校验。
         :type CallbackToken: str
         """
         self._CallbackUrl = None
@@ -1003,13 +1003,16 @@ class CancelFlowRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 调用方用户信息，userId 必填
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _FlowId: 签署流程id
+        :param _FlowId: 合同流程ID, 为32位字符串。
+建议开发者保存此流程ID方便后续其他操作。
         :type FlowId: str
-        :param _CancelMessage: 撤销原因，最长200个字符；
+        :param _CancelMessage: 撤销此合同(流程)的原因，最长200个字。
         :type CancelMessage: str
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._Operator = None
@@ -1101,11 +1104,13 @@ class CancelMultiFlowSignQRCodeRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 调用方用户信息，userId 必填
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _QrCodeId: 二维码id
+        :param _QrCodeId: 二维码ID，为32位字符串。
         :type QrCodeId: str
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._Operator = None
@@ -1187,17 +1192,25 @@ class CancelUserAutoSignEnableUrlRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 操作人信息，UseId必填	
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _SceneKey: 自动签场景: E_PRESCRIPTION_AUTO_SIGN 电子处方
+        :param _SceneKey: 企业开通用户自动签场景，例如电子处方。
+<ul>
+<li>E_PRESCRIPTION_AUTO_SIGN : 电子处方</li>
+</ul>
         :type SceneKey: str
         :param _UserInfo: 指定撤销链接的用户指定撤销链接的用户信息，包含姓名、证件类型、证件号码。
 
         :type UserInfo: :class:`tencentcloud.ess.v20201111.models.UserThreeFactor`
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._Operator = None
         self._SceneKey = None
         self._UserInfo = None
+        self._Agent = None
 
     @property
     def Operator(self):
@@ -1223,6 +1236,14 @@ class CancelUserAutoSignEnableUrlRequest(AbstractModel):
     def UserInfo(self, UserInfo):
         self._UserInfo = UserInfo
 
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
 
     def _deserialize(self, params):
         if params.get("Operator") is not None:
@@ -1232,6 +1253,9 @@ class CancelUserAutoSignEnableUrlRequest(AbstractModel):
         if params.get("UserInfo") is not None:
             self._UserInfo = UserThreeFactor()
             self._UserInfo._deserialize(params.get("UserInfo"))
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -4196,19 +4220,25 @@ class CreateFlowSignUrlRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FlowId: 流程编号
+        :param _FlowId: 合同流程ID，为32位字符串。
+建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         :type FlowId: str
-        :param _FlowApproverInfos: 流程签署人列表，其中结构体的ApproverName，ApproverMobile和ApproverType必传，其他可不传，ApproverType目前只支持个人类型的签署人。
+        :param _FlowApproverInfos: 流程签署人列表，其中结构体的ApproverName，ApproverMobile和ApproverType必传，其他可不传，
 
-签署人只能有手写签名和时间类型的签署控件，其他类型的填写控件和签署控件暂时都未支持。
+注:
+`1. ApproverType目前只支持个人类型的签署人。`
+`2. 签署人只能有手写签名和时间类型的签署控件，其他类型的填写控件和签署控件暂时都未支持。`
         :type FlowApproverInfos: list of FlowCreateApprover
-        :param _Operator: 用户信息，此结构体UserId必填
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         :param _Organization: 机构信息，暂未开放
         :type Organization: :class:`tencentcloud.ess.v20201111.models.OrganizationInfo`
-        :param _JumpUrl: 签署完之后的H5页面的跳转链接，此链接支持http://和https://，最大长度1000个字符。
+        :param _JumpUrl: 签署完之后的H5页面的跳转链接，此链接及支持http://和https://，最大长度1000个字符。(建议https协议)
         :type JumpUrl: str
         """
         self._FlowId = None
@@ -4874,33 +4904,39 @@ class CreateMultiFlowSignQRCodeRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 用户信息，其中UserId为必填参数
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _TemplateId: 模板ID
+        :param _TemplateId: 合同模板ID，为32位字符串。
+可登录腾讯电子签控制台，在 "模板"->"模板中心"->"列表展示设置"选中模板 ID 中查看某个模板的TemplateId(在页面中展示为模板ID)。
         :type TemplateId: str
-        :param _FlowName: 签署流程名称，最大长度不超过200字符
+        :param _FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
+该名称还将用于合同签署完成后的下载文件名。
         :type FlowName: str
-        :param _MaxFlowNum: 最大可发起签署流程份数，默认5份 
-<br/>发起流程数量超过此上限后二维码自动失效
+        :param _MaxFlowNum: 通过此二维码可发起的流程最大限额，如未明确指定，默认为5份。
+一旦发起流程数超越该限制，该二维码将自动失效。
         :type MaxFlowNum: int
-        :param _FlowEffectiveDay: 签署流程有效天数 
-<br/>默认7天 
-<br/>最高设置不超过30天
-        :type FlowEffectiveDay: int
-        :param _QrEffectiveDay: 二维码有效天数 默认7天 最高设置不超过90天
+        :param _QrEffectiveDay: 二维码的有效期限，默认为7天，最高设定不得超过90天。
+一旦超过二维码的有效期限，该二维码将自动失效。
         :type QrEffectiveDay: int
-        :param _Restrictions: 指定的签署人信息
-<br/>指定后，则只允许指定的签署人扫码签署
+        :param _FlowEffectiveDay: 合同流程的签署有效期限，若未设定签署截止日期，则默认为自合同流程创建起的7天内截止。
+若在签署截止日期前未完成签署，合同状态将变更为已过期，从而导致合同无效。
+最长设定期限不得超过30天。
+        :type FlowEffectiveDay: int
+        :param _Restrictions: 指定签署人信息。
+在指定签署人后，仅允许特定签署人通过扫描二维码进行签署。
         :type Restrictions: list of ApproverRestriction
-        :param _UserData: 用户自定义字段
-<br/>回调的时候会进行透传，长度需要小于20480
+        :param _UserData: 调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。
+在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。
+回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
         :type UserData: str
         :param _CallbackUrl: 已废弃，回调配置统一使用企业应用管理-应用集成-企业版应用中的配置 
 <br/> 通过一码多扫二维码发起的合同，回调消息可参考文档 https://qian.tencent.com/developers/company/callback_types_contracts_sign
 <br/> 用户通过签署二维码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档 https://qian.tencent.com/developers/company/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83
 
         :type CallbackUrl: str
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         :param _ApproverRestrictions: 限制二维码用户条件（已弃用）
         :type ApproverRestrictions: :class:`tencentcloud.ess.v20201111.models.ApproverRestriction`
@@ -4909,8 +4945,8 @@ class CreateMultiFlowSignQRCodeRequest(AbstractModel):
         self._TemplateId = None
         self._FlowName = None
         self._MaxFlowNum = None
-        self._FlowEffectiveDay = None
         self._QrEffectiveDay = None
+        self._FlowEffectiveDay = None
         self._Restrictions = None
         self._UserData = None
         self._CallbackUrl = None
@@ -4949,14 +4985,6 @@ class CreateMultiFlowSignQRCodeRequest(AbstractModel):
     def MaxFlowNum(self, MaxFlowNum):
         self._MaxFlowNum = MaxFlowNum
 
-    @property
-    def FlowEffectiveDay(self):
-        return self._FlowEffectiveDay
-
-    @FlowEffectiveDay.setter
-    def FlowEffectiveDay(self, FlowEffectiveDay):
-        self._FlowEffectiveDay = FlowEffectiveDay
-
     @property
     def QrEffectiveDay(self):
         return self._QrEffectiveDay
@@ -4965,6 +4993,14 @@ class CreateMultiFlowSignQRCodeRequest(AbstractModel):
     def QrEffectiveDay(self, QrEffectiveDay):
         self._QrEffectiveDay = QrEffectiveDay
 
+    @property
+    def FlowEffectiveDay(self):
+        return self._FlowEffectiveDay
+
+    @FlowEffectiveDay.setter
+    def FlowEffectiveDay(self, FlowEffectiveDay):
+        self._FlowEffectiveDay = FlowEffectiveDay
+
     @property
     def Restrictions(self):
         return self._Restrictions
@@ -5021,8 +5057,8 @@ class CreateMultiFlowSignQRCodeRequest(AbstractModel):
         self._TemplateId = params.get("TemplateId")
         self._FlowName = params.get("FlowName")
         self._MaxFlowNum = params.get("MaxFlowNum")
-        self._FlowEffectiveDay = params.get("FlowEffectiveDay")
         self._QrEffectiveDay = params.get("QrEffectiveDay")
+        self._FlowEffectiveDay = params.get("FlowEffectiveDay")
         if params.get("Restrictions") is not None:
             self._Restrictions = []
             for item in params.get("Restrictions"):
@@ -5054,9 +5090,9 @@ class CreateMultiFlowSignQRCodeResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _QrCode: 签署二维码对象
+        :param _QrCode: 签署二维码的基本信息，用于创建二维码，用户可扫描该二维码进行签署操作。
         :type QrCode: :class:`tencentcloud.ess.v20201111.models.SignQrCode`
-        :param _SignUrls: 签署链接对象
+        :param _SignUrls: 流程签署二维码的签署信息，适用于客户系统整合二维码功能。通过链接，用户可直接访问电子签名小程序并签署合同。
         :type SignUrls: :class:`tencentcloud.ess.v20201111.models.SignUrl`
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -5981,27 +6017,37 @@ class CreateReleaseFlowRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 调用方用户信息，userId 必填
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _NeedRelievedFlowId: 待解除的签署流程编号（即原签署流程的编号）
+        :param _NeedRelievedFlowId: 待解除的签署流程编号（即原签署流程的编号）。
         :type NeedRelievedFlowId: str
-        :param _ReliveInfo: 解除协议内容
+        :param _ReliveInfo: 解除协议内容。
         :type ReliveInfo: :class:`tencentcloud.ess.v20201111.models.RelieveInfo`
-        :param _ReleasedApprovers: 非必须，解除协议的本企业签署人列表，
-默认使用原流程的签署人列表,当解除协议的签署人与原流程的签署人不能相同时（例如原流程签署人离职了），需要指定本企业其他已实名员工来替换原流程中的原签署人，注意需要指明原签署人的编号(ReceiptId,通过DescribeFlowInfo接口获取)来代表需要替换哪一个签署人
-解除协议的签署人数量不能多于原流程的签署人数量
+        :param _Agent: 关于渠道应用的相关信息，包括子客企业及应用编、号等详细内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+        :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
+        :param _ReleasedApprovers: 解除协议的签署人列表(如不指定该参数，默认使用原流程的签署人列表)。 <br/>
+如需更换原合同中的签署人，可通过指定该签署人的RecipientId编号更换此签署人。(可通过接口<a href="https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo/">DescribeFlowInfo</a>查询签署人的RecipientId编号)<br/>
+解除协议的签署人数量不能多于原流程的签署人数量。<br/>
+
+`注意：只能更换同企业的签署人。`<br/>
+`注意：不支持更换个人类型的签署人。`<br/>
         :type ReleasedApprovers: list of ReleasedApprover
-        :param _Deadline: 签署流程的签署截止时间。 值为unix时间戳,精确到秒,不传默认为当前时间七天后
+        :param _Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的7天时截止。
+如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
         :type Deadline: int
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
-        :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
+        :param _UserData: 调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。
+在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。
+回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
+        :type UserData: str
         """
         self._Operator = None
         self._NeedRelievedFlowId = None
         self._ReliveInfo = None
+        self._Agent = None
         self._ReleasedApprovers = None
         self._Deadline = None
-        self._Agent = None
+        self._UserData = None
 
     @property
     def Operator(self):
@@ -6027,6 +6073,14 @@ class CreateReleaseFlowRequest(AbstractModel):
     def ReliveInfo(self, ReliveInfo):
         self._ReliveInfo = ReliveInfo
 
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
     @property
     def ReleasedApprovers(self):
         return self._ReleasedApprovers
@@ -6044,12 +6098,12 @@ class CreateReleaseFlowRequest(AbstractModel):
         self._Deadline = Deadline
 
     @property
-    def Agent(self):
-        return self._Agent
+    def UserData(self):
+        return self._UserData
 
-    @Agent.setter
-    def Agent(self, Agent):
-        self._Agent = Agent
+    @UserData.setter
+    def UserData(self, UserData):
+        self._UserData = UserData
 
 
     def _deserialize(self, params):
@@ -6060,6 +6114,9 @@ class CreateReleaseFlowRequest(AbstractModel):
         if params.get("ReliveInfo") is not None:
             self._ReliveInfo = RelieveInfo()
             self._ReliveInfo._deserialize(params.get("ReliveInfo"))
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
         if params.get("ReleasedApprovers") is not None:
             self._ReleasedApprovers = []
             for item in params.get("ReleasedApprovers"):
@@ -6067,9 +6124,7 @@ class CreateReleaseFlowRequest(AbstractModel):
                 obj._deserialize(item)
                 self._ReleasedApprovers.append(obj)
         self._Deadline = params.get("Deadline")
-        if params.get("Agent") is not None:
-            self._Agent = Agent()
-            self._Agent._deserialize(params.get("Agent"))
+        self._UserData = params.get("UserData")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -6088,6 +6143,7 @@ class CreateReleaseFlowResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _FlowId: 解除协议流程编号
+`注意：这里的流程编号对应的合同是本次发起的解除协议。`
 
         :type FlowId: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -6125,45 +6181,49 @@ class CreateSchemeUrlRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 调用方用户信息，userId 必填
+        :param _Operator: 执行本接口操作的员工信息, userId 必填。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _OrganizationName: 企业名称
+        :param _OrganizationName: 合同流程签署方的组织机构名称。
+如果名称中包含英文括号()，请使用中文括号（）代替。
         :type OrganizationName: str
-        :param _Name: 姓名,最大长度50个字符
+        :param _Name: 合同流程里边签署方经办人的姓名。
+
         :type Name: str
-        :param _Mobile: 手机号，大陆手机号11位
+        :param _Mobile: 合同流程里边签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
         :type Mobile: str
         :param _EndPoint: 要跳转的链接类型
 
-- HTTP：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型  (默认)，此时返回长链
-- HTTP_SHORT_URL：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型，此时返回短链
-- APP： 第三方APP或小程序跳转电子签小程序的path,  APP或者小程序跳转适合此类型
-
+<ul><li> **HTTP**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型  ，此时返回长链 (默认类型)</li>
+<li>**HTTP_SHORT_URL**：跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型，此时返回短链</li>
+<li>**APP**： 第三方APP或小程序跳转电子签小程序的path,  APP或者小程序跳转适合此类型</li></ul>
         :type EndPoint: str
-        :param _FlowId: 签署流程编号 (PathType=1时必传)
+        :param _FlowId: 合同流程ID 
+注: `如果准备跳转到合同流程签署的详情页面(即PathType=1时)必传,   跳转其他页面可不传`
         :type FlowId: str
-        :param _FlowGroupId: 合同组ID 
+        :param _FlowGroupId: 合同流程组的组ID, 在合同流程组场景下，生成合同流程组的签署链接时需要赋值
         :type FlowGroupId: str
         :param _PathType: 要跳转到的页面类型 
 
-- 0: 不传, 主页 (默认)
-- 1: 小程序合同详情 
-- 2: 小程序合同列表页 
-
+<ul><li> **0** : 腾讯电子签小程序个人首页 (默认)</li>
+<li> **1** : 腾讯电子签小程序流程合同的详情页 (即合同签署页面)</li>
+<li> **2** : 腾讯电子签小程序合同列表页</li></ul>
         :type PathType: int
-        :param _AutoJumpBack: 是否自动回跳
-true：是，
-false：否。
-该参数只针对"APP" 类型的签署链接有效
+        :param _AutoJumpBack: 签署完成后是否自动回跳
+<ul><li>**false**：否, 签署完成不会自动跳转回来(默认)</li><li>**true**：是, 签署完成会自动跳转回来</li></ul>
+注:  ` 该参数只针对"APP" 类型的签署链接有效`
         :type AutoJumpBack: bool
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
-        :param _Hides: 生成的签署链接在签署过程隐藏的按钮列表, 可以设置隐藏的按钮列表如下
+        :param _Hides: 生成的签署链接在签署页面隐藏的按钮列表，可设置如下：
+
+<ul><li> **0** :合同签署页面更多操作按钮</li>
+<li> **1** :合同签署页面更多操作的拒绝签署按钮</li>
+<li> **2** :合同签署页面更多操作的转他人处理按钮</li>
+<li> **3** :签署成功页的查看详情按钮</li></ul>
 
-- 0:合同签署页面更多操作按钮
-- 1:合同签署页面更多操作的拒绝签署按钮
-- 2:合同签署页面更多操作的转他人处理按钮
-- 3:签署成功页的查看详情按钮
+注:  `字段为数组, 可以传值隐藏多个按钮`
         :type Hides: list of int
         """
         self._Operator = None
@@ -6300,7 +6360,11 @@ class CreateSchemeUrlResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _SchemeUrl: 小程序链接地址，有效期90天。如果EndPoint是App，得到的链接Path如’weixin://dl/business/?t= *TICKET*‘，用于客户APP、小程序直接拉起电子签小程序；其他EndPoint得到的https链接如'https://essurl.cn/xxx'，点击链接会打开一个H5页面，然后拉起电子签小程序。
+        :param _SchemeUrl: 腾讯电子签小程序的签署链接。
+
+<ul><li>如果EndPoint是**APP**，得到的链接类似于`pages/guide?from=default&where=mini&id=yDwJSUUirqauh***7jNSxwdirTSGuH&to=CONTRACT_DETAIL&name=&phone=&shortKey=yDw***k1xFc5`, 用法可以参加接口描述中的"跳转到小程序的实现"</li>
+<li>如果EndPoint是**HTTP**，得到的链接类似于 `https://res.ess.tencent.cn/cdn/h5-activity/jump-mp.html?where=mini&from=SFY&id=yDwfEUUw**4rV6Avz&to=MVP_CONTRACT_COVER&name=%E9%83%**5%86%9B`，点击后会跳转到腾讯电子签小程序进行签署</li>
+<li>如果EndPoint是**HTTP_SHORT_URL**，得到的链接类似于 `https://essurl.cn/2n**42Nd`，点击后会跳转到腾讯电子签小程序进行签署</li></ul>
         :type SchemeUrl: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -7680,21 +7744,25 @@ class DescribeExtendedServiceAuthInfosRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 操作人信息
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作
-        :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
-        :param _ExtendServiceType: 扩展服务类型，默认为空，查询目前支持的所有扩展服务信息，单个指定则查询单个扩展服务开通信息，取值：
-OPEN_SERVER_SIGN：开通企业静默签署
-OVERSEA_SIGN：企业与港澳台居民签署合同
-MOBILE_CHECK_APPROVER：使用手机号验证签署方身份
-PAGING_SEAL：骑缝章
-BATCH_SIGN：批量签署
+        :param _ExtendServiceType: 要查询的扩展服务类型。
+默认为空，即查询当前支持的所有扩展服务信息。
+若需查询单个扩展服务的开通情况，请传递相应的值，如下所示：
+<ul><li>OPEN_SERVER_SIGN：企业静默签署</li>
+<li>OVERSEA_SIGN：企业与港澳台居民签署合同</li>
+<li>MOBILE_CHECK_APPROVER：使用手机号验证签署方身份</li>
+<li>PAGING_SEAL：骑缝章</li>
+<li>BATCH_SIGN：批量签署</li></ul>
         :type ExtendServiceType: str
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._Operator = None
-        self._Agent = None
         self._ExtendServiceType = None
+        self._Agent = None
 
     @property
     def Operator(self):
@@ -7704,14 +7772,6 @@ BATCH_SIGN：批量签署
     def Operator(self, Operator):
         self._Operator = Operator
 
-    @property
-    def Agent(self):
-        return self._Agent
-
-    @Agent.setter
-    def Agent(self, Agent):
-        self._Agent = Agent
-
     @property
     def ExtendServiceType(self):
         return self._ExtendServiceType
@@ -7720,15 +7780,23 @@ BATCH_SIGN：批量签署
     def ExtendServiceType(self, ExtendServiceType):
         self._ExtendServiceType = ExtendServiceType
 
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
 
     def _deserialize(self, params):
         if params.get("Operator") is not None:
             self._Operator = UserInfo()
             self._Operator._deserialize(params.get("Operator"))
+        self._ExtendServiceType = params.get("ExtendServiceType")
         if params.get("Agent") is not None:
             self._Agent = Agent()
             self._Agent._deserialize(params.get("Agent"))
-        self._ExtendServiceType = params.get("ExtendServiceType")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -7746,7 +7814,7 @@ class DescribeExtendedServiceAuthInfosResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _AuthInfoList: 授权服务信息列表
+        :param _AuthInfoList: 服务开通和授权的信息列表，根据查询类型返回所有支持的扩展服务开通和授权状况，或者返回特定扩展服务的开通和授权状况。
         :type AuthInfoList: list of ExtendAuthInfo
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -8221,12 +8289,13 @@ class DescribeFlowEvidenceReportRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 调用方用户信息，userId 必填
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _ReportId: 出证报告编号
+        :param _ReportId: 签署报告编号
         :type ReportId: str
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
-
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._Operator = None
@@ -8286,11 +8355,12 @@ class DescribeFlowEvidenceReportResponse(AbstractModel):
         :param _ReportUrl: 出证报告PDF的下载 URL
 注意：此字段可能返回 null，表示取不到有效值。
         :type ReportUrl: str
-        :param _Status: 出证任务执行的状态, 分布表示下面的含义
-
-EvidenceStatusExecuting  出证任务在执行中
-EvidenceStatusSuccess  出证任务执行成功
-EvidenceStatusFailed  出证任务执行失败
+        :param _Status: 签署报告出证任务的状态
+<ul>
+<li>EvidenceStatusExecuting : 出证任务在执行中</li>
+<li>EvidenceStatusSuccess : 出证任务执行成功</li>
+<li>EvidenceStatusFailed : 出证任务执行失败</li>
+</ul>
         :type Status: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -10063,31 +10133,32 @@ class EmbedUrlOption(AbstractModel):
 
 
 class ExtendAuthInfo(AbstractModel):
-    """授权服务信息
+    """扩展服务开通和授权的详细信息
 
     """
 
     def __init__(self):
         r"""
-        :param _Type: 授权服务类型
-OPEN_SERVER_SIGN：开通企业静默签署
-OVERSEA_SIGN：企业与港澳台居民签署合同
-MOBILE_CHECK_APPROVER：使用手机号验证签署方身份
-PAGING_SEAL：骑缝章
-BATCH_SIGN：批量签署
+        :param _Type: 扩展服务的类型，可能是以下值：
+<ul><li>OPEN_SERVER_SIGN：企业静默签署</li>
+<li>OVERSEA_SIGN：企业与港澳台居民签署合同</li>
+<li>MOBILE_CHECK_APPROVER：使用手机号验证签署方身份</li>
+<li>PAGING_SEAL：骑缝章</li>
+<li>BATCH_SIGN：批量签署</li></ul>
         :type Type: str
-        :param _Name: 授权服务名称
+        :param _Name: 扩展服务的名称
         :type Name: str
-        :param _Status: 授权服务状态，ENABLE：开通
+        :param _Status: 扩展服务的开通状态：
+ENABLE：开通
 DISABLE：未开通
         :type Status: str
-        :param _OperatorUserId: 授权人用户id
+        :param _OperatorUserId: 操作扩展服务的操作人UserId，员工在腾讯电子签平台的唯一身份标识，为32位字符串。
 注意：此字段可能返回 null，表示取不到有效值。
         :type OperatorUserId: str
-        :param _OperateOn: 授权时间戳，单位秒
+        :param _OperateOn: 扩展服务的操作时间，格式为Unix标准时间戳（秒）。
 注意：此字段可能返回 null，表示取不到有效值。
         :type OperateOn: int
-        :param _HasAuthUserList: 被授权用户列表
+        :param _HasAuthUserList: 该扩展服务若可以授权，此参数对应授权人员的列表
 注意：此字段可能返回 null，表示取不到有效值。
         :type HasAuthUserList: list of HasAuthUser
         """
@@ -10824,6 +10895,9 @@ class FlowApproverDetail(AbstractModel):
         :param _OrganizationName: 签署方企业名称
 注意：此字段可能返回 null，表示取不到有效值。
         :type OrganizationName: str
+        :param _SignId: 签署参与人在本流程中的编号ID（每个流程不同），可用此ID来定位签署参与人在本流程的签署节点，也可用于后续创建签署链接等操作。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type SignId: str
         """
         self._ApproveMessage = None
         self._ApproveName = None
@@ -10838,6 +10912,7 @@ class FlowApproverDetail(AbstractModel):
         self._CustomApproverTag = None
         self._OrganizationId = None
         self._OrganizationName = None
+        self._SignId = None
 
     @property
     def ApproveMessage(self):
@@ -10943,6 +11018,14 @@ class FlowApproverDetail(AbstractModel):
     def OrganizationName(self, OrganizationName):
         self._OrganizationName = OrganizationName
 
+    @property
+    def SignId(self):
+        return self._SignId
+
+    @SignId.setter
+    def SignId(self, SignId):
+        self._SignId = SignId
+
 
     def _deserialize(self, params):
         self._ApproveMessage = params.get("ApproveMessage")
@@ -10958,6 +11041,7 @@ class FlowApproverDetail(AbstractModel):
         self._CustomApproverTag = params.get("CustomApproverTag")
         self._OrganizationId = params.get("OrganizationId")
         self._OrganizationName = params.get("OrganizationName")
+        self._SignId = params.get("SignId")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -10975,10 +11059,14 @@ class FlowApproverUrlInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _SignUrl: 签署链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
+        :param _SignUrl: 签署链接(短链形式呈现)。请注意保密，不要将其外泄给无关用户。
+注: `注意该链接有效期为30分钟`
 注意：此字段可能返回 null，表示取不到有效值。
         :type SignUrl: str
-        :param _ApproverType: 签署人类型 1-个人
+        :param _ApproverType: 签署参与人类型 
+<ul><li> **1** :个人参与方</li></ul>
+
+注: `现在仅支持个人参与方`
 注意：此字段可能返回 null，表示取不到有效值。
         :type ApproverType: int
         :param _ApproverName: 签署人姓名
@@ -10987,7 +11075,8 @@ class FlowApproverUrlInfo(AbstractModel):
         :param _ApproverMobile: 签署人手机号
 注意：此字段可能返回 null，表示取不到有效值。
         :type ApproverMobile: str
-        :param _LongUrl: 签署长链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
+        :param _LongUrl: 签署链接(长链形式呈现)。请注意保密，不要将其外泄给无关用户。
+注: `注意该链接有效期为30分钟`
 注意：此字段可能返回 null，表示取不到有效值。
         :type LongUrl: str
         """
@@ -12585,18 +12674,18 @@ class GroupOrganization(AbstractModel):
 
 
 class HasAuthUser(AbstractModel):
-    """被授权用户信息
+    """被授权的用户信息
 
     """
 
     def __init__(self):
         r"""
-        :param _UserId: 用户id
+        :param _UserId: 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
 注意：此字段可能返回 null，表示取不到有效值。
         :type UserId: str
-        :param _BelongTo: 用户归属
-MainOrg：主企业
-CurrentOrg：当前企业
+        :param _BelongTo: 当前员工的归属情况，可能值是：
+MainOrg：在集团企业的场景下，返回此值代表是归属主企业
+CurrentOrg：在普通企业场景下返回此值；或者在集团企业的场景下，返回此值代表归属子企业
 注意：此字段可能返回 null，表示取不到有效值。
         :type BelongTo: str
         """
@@ -12890,13 +12979,17 @@ class ModifyApplicationCallbackInfoRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 调用方用户信息，userId 必填
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _OperateType: 操作类型：1-新增，2-删除
+        :param _OperateType: 操作类型：
+1-新增
+2-删除
         :type OperateType: int
-        :param _CallbackInfo: 回调信息
+        :param _CallbackInfo: 企业应用回调信息
         :type CallbackInfo: :class:`tencentcloud.ess.v20201111.models.CallbackInfo`
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
         """
         self._Operator = None
@@ -14641,17 +14734,18 @@ CONTRACT：合同专用章
 
 
 class SignQrCode(AbstractModel):
-    """一码多扫签署二维码对象
+    """签署二维码的基本信息，用于创建二维码，用户可扫描该二维码进行签署操作。
 
     """
 
     def __init__(self):
         r"""
-        :param _QrCodeId: 二维码id
+        :param _QrCodeId: 二维码ID，为32位字符串。
         :type QrCodeId: str
-        :param _QrCodeUrl: 二维码url
+        :param _QrCodeUrl: 二维码URL，可通过转换二维码的工具或代码组件将此URL转化为二维码，以便用户扫描进行流程签署。
         :type QrCodeUrl: str
-        :param _ExpiredTime: 二维码过期时间戳，单位秒
+        :param _ExpiredTime: 二维码的有截止时间，格式为Unix标准时间戳（秒）。
+一旦超过二维码的有效期限，该二维码将自动失效。
         :type ExpiredTime: int
         """
         self._QrCodeId = None
@@ -14698,17 +14792,20 @@ class SignQrCode(AbstractModel):
 
 
 class SignUrl(AbstractModel):
-    """一码多扫签署二维码签署信息
+    """流程签署二维码的签署信息，适用于客户系统整合二维码功能。
+    通过链接，用户可直接访问电子签名小程序并签署合同。
 
     """
 
     def __init__(self):
         r"""
-        :param _AppSignUrl: 小程序签署链接
+        :param _AppSignUrl: 跳转至电子签名小程序签署的链接地址。
+适用于客户端APP及小程序直接唤起电子签名小程序。
         :type AppSignUrl: str
-        :param _EffectiveTime: 签署链接有效时间
+        :param _EffectiveTime: 签署链接有效时间，格式类似"2022-08-05 15:55:01"
         :type EffectiveTime: str
-        :param _HttpSignUrl: 移动端签署链接
+        :param _HttpSignUrl: 跳转至电子签名小程序签署的链接地址，格式类似于https://essurl.cn/xxx。
+打开此链接将会展示H5中间页面，随后唤起电子签名小程序以进行合同签署。
         :type HttpSignUrl: str
         """
         self._AppSignUrl = None
@@ -15020,19 +15117,20 @@ class StartFlowRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Operator: 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId代发合同。
+        :param _Operator: 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         :type Operator: :class:`tencentcloud.ess.v20201111.models.UserInfo`
-        :param _FlowId: 签署流程编号，由CreateFlow接口返回
+        :param _FlowId: 合同流程ID，为32位字符串。
+此处需要传入[创建签署流程接口](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)得到的FlowId。
         :type FlowId: str
         :param _ClientToken: 客户端Token，保持接口幂等性,最大长度64个字符
         :type ClientToken: str
-        :param _Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        :param _Agent: 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         :type Agent: :class:`tencentcloud.ess.v20201111.models.Agent`
-        :param _CcNotifyType: 给关注人发送短信通知的类型，
-
-0-合同发起时通知 
-
-1-签署完成后通知
+        :param _CcNotifyType: 若在创建签署流程时指定了关注人CcInfos，此参数可设定向关注人发送短信通知的类型：
+0 - 合同发起时通知（默认）
+1 - 签署完成后通知
         :type CcNotifyType: int
         """
         self._Operator = None
@@ -15059,10 +15157,14 @@ class StartFlowRequest(AbstractModel):
 
     @property
     def ClientToken(self):
+        warnings.warn("parameter `ClientToken` is deprecated", DeprecationWarning) 
+
         return self._ClientToken
 
     @ClientToken.setter
     def ClientToken(self, ClientToken):
+        warnings.warn("parameter `ClientToken` is deprecated", DeprecationWarning) 
+
         self._ClientToken = ClientToken
 
     @property
@@ -15109,13 +15211,10 @@ class StartFlowResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Status: 发起成功之后返回状态，
-
-START-发起成功， 
-
-REVIEW-提交审核成功，
-
-EXECUTING-已提交发起任务
+        :param _Status: 发起成功后返回的状态，根据合同流程的不同，返回不同状态：
+START - 发起成功
+REVIEW - 提交审核成功
+EXECUTING - 已提交发起任务
         :type Status: str
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -16244,14 +16343,18 @@ class UserThreeFactor(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Name: 姓名
+        :param _Name: 签署方经办人的姓名。
+经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         :type Name: str
-        :param _IdCardType: 证件类型: 
-ID_CARD 身份证
-HONGKONG_AND_MACAO 港澳居民来往内地通行证
-HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
+        :param _IdCardType: 证件类型，支持以下类型
+<ul><li>ID_CARD : 居民身份证 (默认值)</li>
+<li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
         :type IdCardType: str
-        :param _IdCardNumber: 证件号，如果有 X 请大写
+        :param _IdCardNumber: 证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         :type IdCardNumber: str
         """
         self._Name = None