tencentcloud-sdk-python 3.0.973__py2.py3-none-any.whl → 3.0.975__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
@@ -4874,33 +4874,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 +4915,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 +4955,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 +4963,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 +5027,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 +5060,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
@@ -6125,45 +6131,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 +6310,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 +7694,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 +7722,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 +7730,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 +7764,7 @@ class DescribeExtendedServiceAuthInfosResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _AuthInfoList: 授权服务信息列表
+        :param _AuthInfoList: 服务开通和授权的信息列表，根据查询类型返回所有支持的扩展服务开通和授权状况，或者返回特定扩展服务的开通和授权状况。
         :type AuthInfoList: list of ExtendAuthInfo
         :param _RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -10063,31 +10081,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 +10843,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 +10860,7 @@ class FlowApproverDetail(AbstractModel):
         self._CustomApproverTag = None
         self._OrganizationId = None
         self._OrganizationName = None
+        self._SignId = None
 
     @property
     def ApproveMessage(self):
@@ -10943,6 +10966,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 +10989,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:]
@@ -12585,18 +12617,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 +12922,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 +14677,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 +14735,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 +15060,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 +15100,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 +15154,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

tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -991,6 +991,13 @@ class EssbasicClient(AbstractClient):
         其中小程序的原始Id，请联系<对接技术人员>获取，或者查看小程序信息自助获取。
         使用CreateSignUrls，设置EndPoint为APP，得到path。
 
+        其中小程序的原始Id如下，或者查看小程序信息自助获取。
+
+        | 小程序 | AppID | 原始ID |
+        | ------------ | ------------ | ------------ |
+        | 腾讯电子签（正式版） | wxa023b292fd19d41d | gh_da88f6188665 |
+        | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
+
         :param request: Request instance for CreateSignUrls.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateSignUrlsRequest`
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateSignUrlsResponse`

tencentcloud/essbasic/v20210526/models.py

@@ -7162,24 +7162,31 @@ class CreateSignUrlsRequest(AbstractModel):
         r"""
         :param _Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
-        :param _FlowIds: 签署流程编号数组，最多支持100个。(备注：该参数和合同组编号必须二选一)
+        :param _FlowIds: 流程(合同)的编号列表，最多支持100个。(备注：该参数和合同组编号必须二选一)
         :type FlowIds: list of str
         :param _FlowGroupId: 合同组编号(备注：该参数和合同(流程)编号数组必须二选一)
         :type FlowGroupId: str
-        :param _Endpoint: 签署链接类型：“WEIXINAPP”-短链直接跳小程序；“CHANNEL”-跳转H5页面；“APP”-第三方APP或小程序跳转电子签小程序；"LONGURL2WEIXINAPP"-长链接跳转小程序；默认“WEIXINAPP”类型，即跳转至小程序；
+        :param _Endpoint: 签署链接类型,可以设置的参数如下
+
+- WEIXINAPP:短链直接跳小程序 (默认类型)
+- CHANNEL:跳转H5页面
+- APP:第三方APP或小程序跳转电子签小程序
+- LONGURL2WEIXINAPP:长链接跳转小程序
         :type Endpoint: str
-        :param _GenerateType: 签署链接生成类型，默认是 "ALL"；
-"ALL"：全部签署方签署链接，此时不会给自动签署的签署方创建签署链接；
-"CHANNEL"：第三方平台子客企业企业；
-"NOT_CHANNEL"：非第三方平台子客企业企业；
-"PERSON"：个人；
-"FOLLOWER"：关注方，目前是合同抄送方；
+        :param _GenerateType: 签署链接生成类型，可以选择的类型如下
+
+- ALL：全部签署方签署链接，此时不会给自动签署的签署方创建签署链接(默认类型)
+- CHANNEL：第三方平台子客企业企业
+- NOT_CHANNEL：非第三方平台子客企业企业
+- PERSON：个人
+- FOLLOWER：关注方，目前是合同抄送方
         :type GenerateType: str
         :param _OrganizationName: 非第三方平台子客企业参与方的企业名称，GenerateType为"NOT_CHANNEL"时必填
         :type OrganizationName: str
-        :param _Name: 参与人姓名，GenerateType为"PERSON"时必填
+        :param _Name: 参与人姓名
+GenerateType为"PERSON"(即个人签署方)时必填
         :type Name: str
-        :param _Mobile: 参与人手机号；
+        :param _Mobile: 参与人手机号
 GenerateType为"PERSON"或"FOLLOWER"时必填
         :type Mobile: str
         :param _OrganizationOpenId: 第三方平台子客企业的企业OpenId，GenerateType为"CHANNEL"时必填
@@ -7194,10 +7201,10 @@ GenerateType为"PERSON"或"FOLLOWER"时必填
         :type Operator: :class:`tencentcloud.essbasic.v20210526.models.UserInfo`
         :param _Hides: 生成的签署链接在签署过程隐藏的按钮列表, 可以设置隐藏的按钮列表如下
 
-0:合同签署页面更多操作按钮
-1:合同签署页面更多操作的拒绝签署按钮
-2:合同签署页面更多操作的转他人处理按钮
-3:签署成功页的查看详情按钮
+- 0:合同签署页面更多操作按钮
+- 1:合同签署页面更多操作的拒绝签署按钮
+- 2:合同签署页面更多操作的转他人处理按钮
+- 3:签署成功页的查看详情按钮
         :type Hides: list of int
         """
         self._Agent = None
@@ -11932,7 +11939,7 @@ class SignUrlInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _SignUrl: 签署链接，过期时间为30天
+        :param _SignUrl: 签署链接，过期时间为90天
 注意：此字段可能返回 null，表示取不到有效值。
         :type SignUrl: str
         :param _Deadline: 合同过期时间戳，单位秒