tencentcloud-sdk-nodejs-ess 4.0.681 → 4.0.683

package/src/services/ess/v20201111/ess_models.ts

@@ -131,16 +131,17 @@ export interface CancelFlowResponse {
  */
 export interface DescribeFlowEvidenceReportRequest {
   /**
-   * 调用方用户信息，userId 必填
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 出证报告编号
+   * 签署报告编号
    */
   ReportId: string
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
-
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }
@@ -337,11 +338,11 @@ export interface ModifyApplicationCallbackInfoResponse {
  */
 export interface CreateMultiFlowSignQRCodeResponse {
   /**
-   * 签署二维码对象
+   * 签署二维码的基本信息，用于创建二维码，用户可扫描该二维码进行签署操作。
    */
   QrCode?: SignQrCode
   /**
-   * 签署链接对象
+   * 流程签署二维码的签署信息，适用于客户系统整合二维码功能。通过链接，用户可直接访问电子签名小程序并签署合同。
    */
   SignUrls?: SignUrl
   /**
@@ -355,12 +356,16 @@ export interface CreateMultiFlowSignQRCodeResponse {
  */
 export interface FlowApproverUrlInfo {
   /**
-   * 签署链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
+   * 签署链接(短链形式呈现)。请注意保密，不要将其外泄给无关用户。
+注: `注意该链接有效期为30分钟`
 注意：此字段可能返回 null，表示取不到有效值。
    */
   SignUrl?: string
   /**
-   * 签署人类型 1-个人
+   * 签署参与人类型 
+<ul><li> **1** :个人参与方</li></ul>
+
+注: `现在仅支持个人参与方`
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ApproverType?: number
@@ -375,7 +380,8 @@ export interface FlowApproverUrlInfo {
    */
   ApproverMobile?: string
   /**
-   * 签署长链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
+   * 签署链接(长链形式呈现)。请注意保密，不要将其外泄给无关用户。
+注: `注意该链接有效期为30分钟`
 注意：此字段可能返回 null，表示取不到有效值。
    */
   LongUrl?: string
@@ -410,18 +416,18 @@ export interface DescribeThirdPartyAuthCodeResponse {
 }
 
 /**
- * 被授权用户信息
+ * 被授权的用户信息
  */
 export interface HasAuthUser {
   /**
-   * 用户id
+   * 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   UserId?: string
   /**
-   * 用户归属
-MainOrg：主企业
-CurrentOrg：当前企业
+   * 当前员工的归属情况，可能值是：
+MainOrg：在集团企业的场景下，返回此值代表是归属主企业
+CurrentOrg：在普通企业场景下返回此值；或者在集团企业的场景下，返回此值代表归属子企业
 注意：此字段可能返回 null，表示取不到有效值。
    */
   BelongTo?: string
@@ -642,13 +648,10 @@ export interface CreateFlowEvidenceReportRequest {
  */
 export interface StartFlowResponse {
   /**
-   * 发起成功之后返回状态，
-
-START-发起成功， 
-
-REVIEW-提交审核成功，
-
-EXECUTING-已提交发起任务
+   * 发起成功后返回的状态，根据合同流程的不同，返回不同状态：
+START - 发起成功
+REVIEW - 提交审核成功
+EXECUTING - 已提交发起任务
    */
   Status?: string
   /**
@@ -940,6 +943,11 @@ export interface FlowApproverDetail {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   OrganizationName?: string
+  /**
+   * 签署参与人在本流程中的编号ID（每个流程不同），可用此ID来定位签署参与人在本流程的签署节点，也可用于后续创建签署链接等操作。
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  SignId?: string
 }
 
 /**
@@ -993,11 +1001,12 @@ export interface DescribeFlowEvidenceReportResponse {
    */
   ReportUrl?: string
   /**
-   * 出证任务执行的状态, 分布表示下面的含义
-
-EvidenceStatusExecuting  出证任务在执行中
-EvidenceStatusSuccess  出证任务执行成功
-EvidenceStatusFailed  出证任务执行失败
+   * 签署报告出证任务的状态
+<ul>
+<li>EvidenceStatusExecuting : 出证任务在执行中</li>
+<li>EvidenceStatusSuccess : 出证任务执行成功</li>
+<li>EvidenceStatusFailed : 出证任务执行失败</li>
+</ul>
    */
   Status?: string
   /**
@@ -1007,11 +1016,11 @@ EvidenceStatusFailed  出证任务执行失败
 }
 
 /**
- * 应用回调信息
+ * 企业应用回调信息
  */
 export interface CallbackInfo {
   /**
-   * 回调url
+   * 回调url,。请确保回调地址能够接收并处理 HTTP POST 请求，并返回状态码 200 以表示处理正常。
    */
   CallbackUrl: string
   /**
@@ -1020,11 +1029,11 @@ export interface CallbackInfo {
    */
   Token?: string
   /**
-   * 回调加密key
+   * 回调加密key，用于回调消息加解密。
    */
   CallbackKey?: string
   /**
-   * 回调验签token
+   * 回调验签token，用于回调通知校验。
    */
   CallbackToken?: string
 }
@@ -1334,65 +1343,69 @@ false：有序签
  */
 export interface CreateSchemeUrlRequest {
   /**
-   * 调用方用户信息，userId 必填
+   * 执行本接口操作的员工信息, userId 必填。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 企业名称
+   * 合同流程签署方的组织机构名称。
+如果名称中包含英文括号()，请使用中文括号（）代替。
    */
   OrganizationName?: string
   /**
-   * 姓名,最大长度50个字符
+   * 合同流程里边签署方经办人的姓名。
+
    */
   Name?: string
   /**
-   * 手机号，大陆手机号11位
+   * 合同流程里边签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
    */
   Mobile?: string
   /**
    * 要跳转的链接类型
 
-- 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>
    */
   EndPoint?: string
   /**
-   * 签署流程编号 (PathType=1时必传)
+   * 合同流程ID 
+注: `如果准备跳转到合同流程签署的详情页面(即PathType=1时)必传,   跳转其他页面可不传`
    */
   FlowId?: string
   /**
-   * 合同组ID
+   * 合同流程组的组ID, 在合同流程组场景下，生成合同流程组的签署链接时需要赋值
    */
   FlowGroupId?: string
   /**
    * 要跳转到的页面类型 
 
-- 0: 不传, 主页 (默认)
-- 1: 小程序合同详情 
-- 2: 小程序合同列表页 
-
+<ul><li> **0** : 腾讯电子签小程序个人首页 (默认)</li>
+<li> **1** : 腾讯电子签小程序流程合同的详情页 (即合同签署页面)</li>
+<li> **2** : 腾讯电子签小程序合同列表页</li></ul>
    */
   PathType?: number
   /**
-   * 是否自动回跳
-true：是，
-false：否。
-该参数只针对"APP" 类型的签署链接有效
+   * 签署完成后是否自动回跳
+<ul><li>**false**：否, 签署完成不会自动跳转回来(默认)</li><li>**true**：是, 签署完成会自动跳转回来</li></ul>
+注:  ` 该参数只针对"APP" 类型的签署链接有效`
    */
   AutoJumpBack?: boolean
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
   /**
-   * 生成的签署链接在签署过程隐藏的按钮列表, 可以设置隐藏的按钮列表如下
+   * 生成的签署链接在签署页面隐藏的按钮列表，可设置如下：
 
-- 0:合同签署页面更多操作按钮
-- 1:合同签署页面更多操作的拒绝签署按钮
-- 2:合同签署页面更多操作的转他人处理按钮
-- 3:签署成功页的查看详情按钮
+<ul><li> **0** :合同签署页面更多操作按钮</li>
+<li> **1** :合同签署页面更多操作的拒绝签署按钮</li>
+<li> **2** :合同签署页面更多操作的转他人处理按钮</li>
+<li> **3** :签署成功页的查看详情按钮</li></ul>
+
+注:  `字段为数组, 可以传值隐藏多个按钮`
    */
   Hides?: Array<number | bigint>
 }
@@ -1495,6 +1508,7 @@ export interface DescribeIntegrationMainOrganizationUserRequest {
 export interface CreateReleaseFlowResponse {
   /**
    * 解除协议流程编号
+`注意：这里的流程编号对应的合同是本次发起的解除协议。`
 
    */
   FlowId?: string
@@ -1996,38 +2010,43 @@ export interface CreateBatchCancelFlowUrlResponse {
  */
 export interface UserThreeFactor {
   /**
-   * 姓名
+   * 签署方经办人的姓名。
+经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
    */
   Name: string
   /**
-   * 证件类型: 
-ID_CARD 身份证
-HONGKONG_AND_MACAO 港澳居民来往内地通行证
-HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
+   * 证件类型，支持以下类型
+<ul><li>ID_CARD : 居民身份证 (默认值)</li>
+<li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
    */
   IdCardType: string
   /**
-   * 证件号，如果有 X 请大写
+   * 证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
    */
   IdCardNumber: string
 }
 
 /**
- * 一码多扫签署二维码对象
+ * 签署二维码的基本信息，用于创建二维码，用户可扫描该二维码进行签署操作。
  */
 export interface SignQrCode {
   /**
-   * 二维码id
+   * 二维码ID，为32位字符串。
    */
-  QrCodeId: string
+  QrCodeId?: string
   /**
-   * 二维码url
+   * 二维码URL，可通过转换二维码的工具或代码组件将此URL转化为二维码，以便用户扫描进行流程签署。
    */
-  QrCodeUrl: string
+  QrCodeUrl?: string
   /**
-   * 二维码过期时间戳，单位秒
+   * 二维码的有截止时间，格式为Unix标准时间戳（秒）。
+一旦超过二维码的有效期限，该二维码将自动失效。
    */
-  ExpiredTime: number
+  ExpiredTime?: number
 }
 
 /**
@@ -2199,7 +2218,11 @@ export interface UnbindEmployeeUserIdWithClientOpenIdRequest {
  */
 export interface CreateSchemeUrlResponse {
   /**
-   * 小程序链接地址，有效期90天。如果EndPoint是App，得到的链接Path如’weixin://dl/business/?t= *TICKET*‘，用于客户APP、小程序直接拉起电子签小程序；其他EndPoint得到的https链接如'https://essurl.cn/xxx'，点击链接会打开一个H5页面，然后拉起电子签小程序。
+   * 腾讯电子签小程序的签署链接。
+
+<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>
    */
   SchemeUrl?: string
   /**
@@ -3632,21 +3655,27 @@ export interface CreateFlowByFilesRequest {
  */
 export interface CreateFlowSignUrlRequest {
   /**
-   * 流程编号
+   * 合同流程ID，为32位字符串。
+建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
    */
   FlowId: string
   /**
-   * 流程签署人列表，其中结构体的ApproverName，ApproverMobile和ApproverType必传，其他可不传，ApproverType目前只支持个人类型的签署人。
+   * 流程签署人列表，其中结构体的ApproverName，ApproverMobile和ApproverType必传，其他可不传，
 
-签署人只能有手写签名和时间类型的签署控件，其他类型的填写控件和签署控件暂时都未支持。
+注:
+`1. ApproverType目前只支持个人类型的签署人。`
+`2. 签署人只能有手写签名和时间类型的签署控件，其他类型的填写控件和签署控件暂时都未支持。`
    */
   FlowApproverInfos: Array<FlowCreateApprover>
   /**
-   * 用户信息，此结构体UserId必填
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator?: UserInfo
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
   /**
@@ -3655,7 +3684,7 @@ export interface CreateFlowSignUrlRequest {
    */
   Organization?: OrganizationInfo
   /**
-   * 签署完之后的H5页面的跳转链接，此链接支持http://和https://，最大长度1000个字符。
+   * 签署完之后的H5页面的跳转链接，此链接及支持http://和https://，最大长度1000个字符。(建议https协议)
    */
   JumpUrl?: string
 }
@@ -3665,31 +3694,42 @@ export interface CreateFlowSignUrlRequest {
  */
 export interface CreateReleaseFlowRequest {
   /**
-   * 调用方用户信息，userId 必填
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 待解除的签署流程编号（即原签署流程的编号）
+   * 待解除的签署流程编号（即原签署流程的编号）。
    */
   NeedRelievedFlowId: string
   /**
-   * 解除协议内容
+   * 解除协议内容。
    */
   ReliveInfo: RelieveInfo
   /**
-   * 非必须，解除协议的本企业签署人列表，
-默认使用原流程的签署人列表,当解除协议的签署人与原流程的签署人不能相同时（例如原流程签署人离职了），需要指定本企业其他已实名员工来替换原流程中的原签署人，注意需要指明原签署人的编号(ReceiptId,通过DescribeFlowInfo接口获取)来代表需要替换哪一个签署人
-解除协议的签署人数量不能多于原流程的签署人数量
+   * 关于渠道应用的相关信息，包括子客企业及应用编、号等详细内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+   */
+  Agent?: Agent
+  /**
+   * 解除协议的签署人列表(如不指定该参数，默认使用原流程的签署人列表)。 <br/>
+如需更换原合同中的签署人，可通过指定该签署人的RecipientId编号更换此签署人。(可通过接口<a href="https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo/">DescribeFlowInfo</a>查询签署人的RecipientId编号)<br/>
+解除协议的签署人数量不能多于原流程的签署人数量。<br/>
+
+`注意：只能更换同企业的签署人。`<br/>
+`注意：不支持更换个人类型的签署人。`<br/>
    */
   ReleasedApprovers?: Array<ReleasedApprover>
   /**
-   * 签署流程的签署截止时间。 值为unix时间戳,精确到秒,不传默认为当前时间七天后
+   * 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的7天时截止。
+如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
    */
   Deadline?: number
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。
+在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。
+回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
    */
-  Agent?: Agent
+  UserData?: string
 }
 
 /**
@@ -4267,11 +4307,15 @@ true - 可以，false - 不可以。
  */
 export interface CancelUserAutoSignEnableUrlRequest {
   /**
-   * 操作人信息，UseId必填
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 自动签场景: E_PRESCRIPTION_AUTO_SIGN 电子处方
+   * 企业开通用户自动签场景，例如电子处方。
+<ul>
+<li>E_PRESCRIPTION_AUTO_SIGN : 电子处方</li>
+</ul>
    */
   SceneKey: string
   /**
@@ -4279,6 +4323,11 @@ export interface CancelUserAutoSignEnableUrlRequest {
 
    */
   UserInfo: UserThreeFactor
+  /**
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+   */
+  Agent?: Agent
 }
 
 /**
@@ -4498,15 +4547,17 @@ ProcessTimeout - 转换文件超时
  */
 export interface CancelMultiFlowSignQRCodeRequest {
   /**
-   * 调用方用户信息，userId 必填
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
    */
   Operator: UserInfo
   /**
-   * 二维码id
+   * 二维码ID，为32位字符串。
    */
   QrCodeId: string
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }
@@ -4558,19 +4609,23 @@ export interface WebThemeConfig {
  */
 export interface ModifyApplicationCallbackInfoRequest {
   /**
-   * 调用方用户信息，userId 必填
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 操作类型：1-新增，2-删除
+   * 操作类型：
+1-新增
+2-删除
    */
   OperateType: number
   /**
-   * 回调信息
+   * 企业应用回调信息
    */
   CallbackInfo: CallbackInfo
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }
@@ -4601,27 +4656,29 @@ export interface IntegrationMainOrganizationUser {
  */
 export interface StartFlowRequest {
   /**
-   * 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId代发合同。
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 签署流程编号，由CreateFlow接口返回
+   * 合同流程ID，为32位字符串。
+此处需要传入[创建签署流程接口](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)得到的FlowId。
    */
   FlowId: string
   /**
    * 客户端Token，保持接口幂等性,最大长度64个字符
+   * @deprecated
    */
   ClientToken?: string
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
   /**
-   * 给关注人发送短信通知的类型，
-
-0-合同发起时通知 
-
-1-签署完成后通知
+   * 若在创建签署流程时指定了关注人CcInfos，此参数可设定向关注人发送短信通知的类型：
+0 - 合同发起时通知（默认）
+1 - 签署完成后通知
    */
   CcNotifyType?: number
 }
@@ -4891,19 +4948,22 @@ export interface PermissionGroup {
  */
 export interface CancelFlowRequest {
   /**
-   * 调用方用户信息，userId 必填
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 签署流程id
+   * 合同流程ID, 为32位字符串。
+建议开发者保存此流程ID方便后续其他操作。
    */
   FlowId: string
   /**
-   * 撤销原因，最长200个字符；
+   * 撤销此合同(流程)的原因，最长200个字。
    */
   CancelMessage: string
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }
@@ -5216,22 +5276,26 @@ export interface IntegrationDepartment {
  */
 export interface DescribeExtendedServiceAuthInfosRequest {
   /**
-   * 操作人信息
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作
+   * 要查询的扩展服务类型。
+默认为空，即查询当前支持的所有扩展服务信息。
+若需查询单个扩展服务的开通情况，请传递相应的值，如下所示：
+<ul><li>OPEN_SERVER_SIGN：企业静默签署</li>
+<li>OVERSEA_SIGN：企业与港澳台居民签署合同</li>
+<li>MOBILE_CHECK_APPROVER：使用手机号验证签署方身份</li>
+<li>PAGING_SEAL：骑缝章</li>
+<li>BATCH_SIGN：批量签署</li></ul>
    */
-  Agent?: Agent
+  ExtendServiceType?: string
   /**
-   * 扩展服务类型，默认为空，查询目前支持的所有扩展服务信息，单个指定则查询单个扩展服务开通信息，取值：
-OPEN_SERVER_SIGN：开通企业静默签署
-OVERSEA_SIGN：企业与港澳台居民签署合同
-MOBILE_CHECK_APPROVER：使用手机号验证签署方身份
-PAGING_SEAL：骑缝章
-BATCH_SIGN：批量签署
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
-  ExtendServiceType?: string
+  Agent?: Agent
 }
 
 /**
@@ -5345,21 +5409,24 @@ export interface CreateFlowGroupByTemplatesRequest {
 }
 
 /**
- * 一码多扫签署二维码签署信息
+ * 流程签署二维码的签署信息，适用于客户系统整合二维码功能。
+通过链接，用户可直接访问电子签名小程序并签署合同。
  */
 export interface SignUrl {
   /**
-   * 小程序签署链接
+   * 跳转至电子签名小程序签署的链接地址。
+适用于客户端APP及小程序直接唤起电子签名小程序。
    */
-  AppSignUrl: string
+  AppSignUrl?: string
   /**
-   * 签署链接有效时间
+   * 签署链接有效时间，格式类似"2022-08-05 15:55:01"
    */
-  EffectiveTime: string
+  EffectiveTime?: string
   /**
-   * 移动端签署链接
+   * 跳转至电子签名小程序签署的链接地址，格式类似于https://essurl.cn/xxx。
+打开此链接将会展示H5中间页面，随后唤起电子签名小程序以进行合同签署。
    */
-  HttpSignUrl: string
+  HttpSignUrl?: string
 }
 
 /**
@@ -5515,39 +5582,40 @@ true--是，处理置白
 }
 
 /**
- * 授权服务信息
+ * 扩展服务开通和授权的详细信息
  */
 export interface ExtendAuthInfo {
   /**
-   * 授权服务类型
-OPEN_SERVER_SIGN：开通企业静默签署
-OVERSEA_SIGN：企业与港澳台居民签署合同
-MOBILE_CHECK_APPROVER：使用手机号验证签署方身份
-PAGING_SEAL：骑缝章
-BATCH_SIGN：批量签署
+   * 扩展服务的类型，可能是以下值：
+<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?: string
   /**
-   * 授权服务名称
+   * 扩展服务的名称
    */
   Name?: string
   /**
-   * 授权服务状态，ENABLE：开通
+   * 扩展服务的开通状态：
+ENABLE：开通
 DISABLE：未开通
    */
   Status?: string
   /**
-   * 授权人用户id
+   * 操作扩展服务的操作人UserId，员工在腾讯电子签平台的唯一身份标识，为32位字符串。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   OperatorUserId?: string
   /**
-   * 授权时间戳，单位秒
+   * 扩展服务的操作时间，格式为Unix标准时间戳（秒）。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   OperateOn?: number
   /**
-   * 被授权用户列表
+   * 该扩展服务若可以授权，此参数对应授权人员的列表
 注意：此字段可能返回 null，表示取不到有效值。
    */
   HasAuthUserList?: Array<HasAuthUser>
@@ -5628,40 +5696,45 @@ export interface CreateBatchCancelFlowUrlRequest {
  */
 export interface CreateMultiFlowSignQRCodeRequest {
   /**
-   * 用户信息，其中UserId为必填参数
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 模板ID
+   * 合同模板ID，为32位字符串。
+可登录腾讯电子签控制台，在 "模板"->"模板中心"->"列表展示设置"选中模板 ID 中查看某个模板的TemplateId(在页面中展示为模板ID)。
    */
   TemplateId: string
   /**
-   * 签署流程名称，最大长度不超过200字符
+   * 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
+该名称还将用于合同签署完成后的下载文件名。
    */
   FlowName: string
   /**
-   * 最大可发起签署流程份数，默认5份 
-<br/>发起流程数量超过此上限后二维码自动失效
+   * 通过此二维码可发起的流程最大限额，如未明确指定，默认为5份。
+一旦发起流程数超越该限制，该二维码将自动失效。
    */
   MaxFlowNum?: number
   /**
-   * 签署流程有效天数 
-<br/>默认7天 
-<br/>最高设置不超过30天
+   * 二维码的有效期限，默认为7天，最高设定不得超过90天。
+一旦超过二维码的有效期限，该二维码将自动失效。
    */
-  FlowEffectiveDay?: number
+  QrEffectiveDay?: number
   /**
-   * 二维码有效天数 默认7天 最高设置不超过90天
+   * 合同流程的签署有效期限，若未设定签署截止日期，则默认为自合同流程创建起的7天内截止。
+若在签署截止日期前未完成签署，合同状态将变更为已过期，从而导致合同无效。
+最长设定期限不得超过30天。
    */
-  QrEffectiveDay?: number
+  FlowEffectiveDay?: number
   /**
-   * 指定的签署人信息
-<br/>指定后，则只允许指定的签署人扫码签署
+   * 指定签署人信息。
+在指定签署人后，仅允许特定签署人通过扫描二维码进行签署。
    */
   Restrictions?: Array<ApproverRestriction>
   /**
-   * 用户自定义字段
-<br/>回调的时候会进行透传，长度需要小于20480
+   * 调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 20480长度。
+在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。
+回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
    */
   UserData?: string
   /**
@@ -5673,7 +5746,8 @@ export interface CreateMultiFlowSignQRCodeRequest {
    */
   CallbackUrl?: string
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
   /**
@@ -5939,7 +6013,7 @@ export interface DescribeOrganizationGroupOrganizationsResponse {
  */
 export interface DescribeExtendedServiceAuthInfosResponse {
   /**
-   * 授权服务信息列表
+   * 服务开通和授权的信息列表，根据查询类型返回所有支持的扩展服务开通和授权状况，或者返回特定扩展服务的开通和授权状况。
    */
   AuthInfoList?: Array<ExtendAuthInfo>
   /**