tencentcloud-sdk-nodejs-ess 4.0.689 → 4.0.691

package/tencentcloud/services/ess/v20201111/ess_models.d.ts

@@ -143,15 +143,15 @@ export interface UpdateIntegrationEmployeesResponse {
     RequestId?: string;
 }
 /**
- * 集成版员工部门信息
+ * 集成版员工部门信息。
  */
 export interface Department {
     /**
-     * 部门id
+     * 部门ID。
      */
     DepartmentId?: string;
     /**
-     * 部门名称
+     * 部门名称。
      */
     DepartmentName?: string;
 }
@@ -239,7 +239,7 @@ export interface CreatePreparedPersonalEsignRequest {
  */
 export interface DescribeIntegrationDepartmentsResponse {
     /**
-     * 部门列表
+     * 部门信息列表。部门信息根据部门排序号OrderNo降序排列，根据部门创建时间升序排列。
      */
     Departments?: Array<IntegrationDepartment>;
     /**
@@ -404,7 +404,8 @@ export interface CancelUserAutoSignEnableUrlResponse {
  */
 export interface BindEmployeeUserIdWithClientOpenIdResponse {
     /**
-     * 绑定是否成功，1表示成功，0表示失败
+     * 绑定是否成功。
+  <ul><li>**0**：失败</li><li>**1**：成功</li></ul>
      */
     Status?: number;
     /**
@@ -417,17 +418,19 @@ export interface BindEmployeeUserIdWithClientOpenIdResponse {
  */
 export interface CreateIntegrationEmployeesRequest {
     /**
-     * 操作人信息，userId必填
+     * 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
      */
     Operator: UserInfo;
     /**
-     * 待创建员工的信息，不超过20个。
-  所有类型的企业支持的入参：Mobile和DisplayName必填,OpenId、Email和Department.DepartmentId选填，其他字段暂不支持。
-  企微类型的企业特有支持的入参：WeworkOpenId，传入此字段无需在传入其他信息
+     * 待创建员工的信息，最多不超过20个。
+  其中入参Mobile和DisplayName必填，OpenId、Email和Department.DepartmentId选填，其他字段暂不支持设置。
+  在创建企微企业员工场景下，只需传入WeworkOpenId，无需再传其他信息。
      */
     Employees: Array<Staff>;
     /**
-     * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+     * 代理企业和员工的信息。
+  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
      */
     Agent?: Agent;
 }
@@ -635,16 +638,16 @@ export interface SealInfo {
     SealName?: string;
 }
 /**
- * 集成版企业角色信息
+ * 集成版企业角色信息。
  */
 export interface StaffRole {
     /**
-     * 角色id
+     * 角色ID。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     RoleId?: string;
     /**
-     * 角色名称
+     * 角色名称。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     RoleName?: string;
@@ -747,7 +750,9 @@ export interface CreateConvertTaskApiRequest {
  */
 export interface DeleteIntegrationEmployeesResponse {
     /**
-     * 员工删除数据
+     * 员工删除结果。包含成功数据与失败数据。
+  <ul><li>**成功数据**：展示员工姓名、手机号与电子签平台UserId</li>
+  <li>**失败数据**：展示员工电子签平台UserId、第三方平台OpenId和失败原因</li></ul>
      */
     DeleteEmployeeResult?: DeleteStaffsResult;
     /**
@@ -755,6 +760,31 @@ export interface DeleteIntegrationEmployeesResponse {
      */
     RequestId?: string;
 }
+/**
+ * CreateBatchSignUrl返回参数结构体
+ */
+export interface CreateBatchSignUrlResponse {
+    /**
+     * 批量签署链接，以短链形式返回，短链的有效期参考回参中的 ExpiredTime。
+  
+  注: `非小程序和APP集成使用`
+     */
+    SignUrl?: string;
+    /**
+     * 链接过期时间以 Unix 时间戳格式表示，默认生成链接时间起，往后7天有效期。过期后短链将失效，无法打开。
+     */
+    ExpiredTime?: number;
+    /**
+     * 从客户小程序或者客户APP跳转至腾讯电子签小程序进行批量签署的跳转路径
+  
+  注: `小程序和APP集成使用`
+     */
+    MiniAppPath?: string;
+    /**
+     * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * CreateFlowReminds返回参数结构体
  */
@@ -773,15 +803,16 @@ export interface CreateFlowRemindsResponse {
  */
 export interface DescribeOrganizationGroupOrganizationsRequest {
     /**
-     * 操作人信息，userId必填
+     * 执行本接口操作的员工信息,userId必填。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
      */
     Operator: UserInfo;
     /**
-     * 指定每页多少条数据，单页最大1000
+     * 指定分页每页返回的数据条数，单页最大1000
      */
     Limit: number;
     /**
-     * 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0
+     * 指定分页返回第几页的数据，如果不传默认返回第一页，页码从 0 开始，即首页为 0
      */
     Offset: number;
     /**
@@ -789,15 +820,23 @@ export interface DescribeOrganizationGroupOrganizationsRequest {
      */
     Name?: string;
     /**
-     * 成员企业加入集团的当前状态:1-待授权;2-已授权待激活;3-拒绝授权;4-已解除;5-已加入
+     * 成员企业加入集团的当前状态
+  <ul><li> **1**：待授权</li>
+  <li> **2**：已授权待激活</li>
+  <li> **3**：拒绝授权</li>
+  <li> **4**：已解除</li>
+  <li> **5**：已加入</li>
+  </ul>
      */
     Status?: number;
     /**
      * 是否导出当前成员企业数据
+  <ul><li> **false**：不导出（默认值）</li>
+  <li> **true**：导出</li></ul>
      */
     Export?: boolean;
     /**
-     * 成员企业机构 ID，在PC控制台 集团管理可获取
+     * 成员企业机构 ID，32 位字符串，在PC控制台 集团管理可获取
      */
     Id?: string;
 }
@@ -1163,26 +1202,33 @@ export interface CreateDocumentResponse {
  */
 export interface DescribeIntegrationEmployeesRequest {
     /**
-     * 操作人信息，userId必填
+     * 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
      */
     Operator: UserInfo;
     /**
-     * 指定每页多少条数据，单页最大20
+     * 指定分页每页返回的数据条数，单页最大支持 20。
      */
     Limit: number;
     /**
-     * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+     * 代理企业和员工的信息。
+  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
      */
     Agent?: Agent;
     /**
-     * 查询过滤实名用户，Key为Status，Values为["IsVerified"]，查询过滤未实名用户，Key为Status，Values为["NotVerified"]
-  查询某个部门的用户，Key为DepartmentId，Values为["DepartmentId"]
-  根据用户Id查询员工时，Key为UserId，Values为["UserId"]
-  根据第三方系统openId过滤查询员工时,Key为StaffOpenId,Values为["OpenId","OpenId",...]
+     * 查询的关键字段，支持Key-Values查询。可选键值如下：
+  <ul>
+    <li>Key:**"Status"**，根据实名状态查询员工，Values可选：
+      <ul><li>**["IsVerified"]**：查询已实名的员工</li><li>**["NotVerified"]**：查询未实名的员工</li></ul></li>
+    <li>Key:**"DepartmentId"**，根据部门ID查询部门下的员工，Values为指定的部门ID：**["DepartmentId"]**</li>
+    <li>Key:**"UserId"**，根据用户ID查询员工，Values为指定的用户ID：**["UserId"]**</li>
+    <li>Key:**"UserWeWorkOpenId"**，根据用户企微账号ID查询员工，Values为指定用户的企微账号ID：**["UserWeWorkOpenId"]**</li>
+    <li>Key:**"StaffOpenId"**，根据第三方系统用户OpenId查询员工，Values为第三方系统用户OpenId列表：**["OpenId1","OpenId2",...]**</li>
+  </ul>
      */
     Filters?: Array<Filter>;
     /**
-     * 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大20000
+     * 指定分页返回第几页的数据，如果不传默认返回第一页。页码从 0 开始，即首页为 0，最大20000。
      */
     Offset?: number;
 }
@@ -1469,7 +1515,9 @@ export interface DescribeThirdPartyAuthCodeRequest {
  */
 export interface UnbindEmployeeUserIdWithClientOpenIdResponse {
     /**
-     * 解绑是否成功，1表示成功，0表示失败
+     * 解绑是否成功。
+  <ul><li> **0**：失败 </li>
+  <li> **1**：成功 </li></ul>
      */
     Status?: number;
     /**
@@ -1506,19 +1554,22 @@ export interface CreateWebThemeConfigResponse {
  */
 export interface BindEmployeeUserIdWithClientOpenIdRequest {
     /**
-     * 用户信息，OpenId与UserId二选一必填一个，OpenId是第三方客户ID，userId是用户实名后的电子签生成的ID,当传入客户系统openId，传入的openId需与电子签员工userId绑定，且参数Channel必填，Channel值为INTEGRATE；当传入参数UserId，Channel无需指定。（参数参考示例）
+     * 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
      */
     Operator: UserInfo;
     /**
-     * 电子签系统员工UserId
+     * 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+  可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)；或者通过<a href="https://qian.tencent.com/developers/companyApis/staffs/DescribeIntegrationEmployees" target="_blank">DescribeIntegrationEmployees</a>接口获取。
      */
     UserId: string;
     /**
-     * 客户系统OpenId
+     * 员工在贵司业务系统中的唯一身份标识，用于与腾讯电子签账号进行映射，确保在同一企业内不会出现重复。 该标识最大长度为64位字符串，仅支持包含26个英文字母和数字0-9的字符。
      */
     OpenId: string;
     /**
-     * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+     * 代理企业和员工的信息。
+  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
      */
     Agent?: Agent;
 }
@@ -1532,7 +1583,9 @@ export interface DescribeIntegrationDepartmentsRequest {
      */
     Operator: UserInfo;
     /**
-     * 查询类型 0-查询单个部门节点 1-单个部门节点及一级子节点部门列表
+     * 查询类型，支持以下类型：
+  <ul><li>**0**：查询单个部门节点列表，不包含子节点部门信息</li>
+  <li>**1**：查询单个部门节点级一级子节点部门信息列表</li></ul>
      */
     QueryType: number;
     /**
@@ -1541,11 +1594,13 @@ export interface DescribeIntegrationDepartmentsRequest {
      */
     Agent?: Agent;
     /**
-     * 部门ID,与DeptOpenId二选一,优先DeptId,都为空时获取根节点数据
+     * 查询的部门ID。
+  注：`如果同时指定了DeptId与DeptOpenId参数，系统将优先使用DeptId参数进行查询。当二者都未指定时，系统将返回根节点部门数据。`
      */
     DeptId?: string;
     /**
-     * 客户系统部门ID,与DeptId二选一,优先DeptId,都为空时获取根节点数据
+     * 查询的客户系统部门ID。
+  注：`如果同时指定了DeptId与DeptOpenId参数，系统将优先使用DeptId参数进行查询。当二者都未指定时，系统将返回根节点部门数据。`
      */
     DeptOpenId?: string;
 }
@@ -1642,7 +1697,7 @@ export interface ComponentLimit {
  */
 export interface CreateIntegrationDepartmentResponse {
     /**
-     * 电子签部门ID
+     * 电子签部门ID。建议开发者保存此部门ID，方便后续查询或修改部门信息。
      */
     DeptId?: string;
     /**
@@ -2087,21 +2142,21 @@ export interface DisableUserAutoSignRequest {
  */
 export interface DescribeIntegrationEmployeesResponse {
     /**
-     * 员工数据列表
+     * 员工信息列表。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Employees?: Array<Staff>;
     /**
-     * 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大20000
+     * 指定分页返回第几页的数据。页码从 0 开始，即首页为 0，最大20000。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Offset?: number;
     /**
-     * 指定每页多少条数据，单页最大20
+     * 指定分页每页返回的数据条数，单页最大支持 20。
      */
     Limit?: number;
     /**
-     * 符合条件的员工数量
+     * 符合条件的员工数量。
      */
     TotalCount?: number;
     /**
@@ -2144,22 +2199,27 @@ export interface CreateConvertTaskApiResponse {
  */
 export interface CreateFlowSignReviewRequest {
     /**
-     * 调用方用户信息，userId 必填
+     * 执行本接口操作的员工信息。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
      */
     Operator: UserInfo;
     /**
-     * 签署流程编号
+     * 合同流程ID，为32位字符串。
+  建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+  可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
      */
     FlowId: string;
     /**
-     * 企业内部审核结果
-  PASS: 通过
-  REJECT: 拒绝
+     * 企业审核结果
+  <ul><li>PASS: 通过</li>
+  <li>REJECT: 拒绝</li></ul>
      */
     ReviewType: string;
     /**
-     * 审核原因
-  当ReviewType 是REJECT 时此字段必填,字符串长度不超过200
+     * 审核结果原因，
+  字符串长度不超过200
+  当ReviewType 是拒绝（REJECT） 时此字段必填。
+  
      */
     ReviewMessage?: string;
     /**
@@ -2167,19 +2227,18 @@ export interface CreateFlowSignReviewRequest {
      */
     Agent?: Agent;
     /**
-     * 审核签署节点使用 非必填 如果填写则审核该签署节点。给个人审核时必填。
+     * 审核签署节点人标识，
+  用来标识审核的签署方。
+  如果签署审核节点是个人， 此参数必填。
      */
     RecipientId?: string;
     /**
-     * 操作类型：（接口通过该字段区分操作类型）
-  
-  SignReview:签署审核
-  CreateReview:发起审核
+     * 操作类型：（接口通过该字段区分不同的操作类型）
   
-  默认：SignReview；SignReview:签署审核
+  <ul><li>SignReview: 签署审核（默认）</li>
+  <li>CreateReview: 创建审核</li></ul>
   
-  该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程
-  若发起个人审核，则指定该字段为：SignReview
+  如果审核节点是个人，则操作类型只能为SignReview。
      */
     OperateType?: string;
 }
@@ -2188,19 +2247,23 @@ export interface CreateFlowSignReviewRequest {
  */
 export interface UnbindEmployeeUserIdWithClientOpenIdRequest {
     /**
-     * 用户信息，OpenId与UserId二选一必填一个，OpenId是第三方客户ID，userId是用户实名后的电子签生成的ID,当传入客户系统openId，传入的openId需与电子签员工userId绑定，且参数Channel必填，Channel值为INTEGRATE；当传入参数UserId，Channel无需指定(参数用法参考示例)
+     * 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
      */
     Operator: UserInfo;
     /**
-     * 电子签系统员工UserId
+     * 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+  可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
      */
     UserId: string;
     /**
-     * 客户系统OpenId
+     * 员工在贵司业务系统中的唯一身份标识，用于与腾讯电子签账号进行映射，确保在同一企业内不会出现重复。
+  该标识最大长度为64位字符串，仅支持包含26个英文字母和数字0-9的字符。
      */
     OpenId: string;
     /**
-     * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+     * 代理企业和员工的信息。
+  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
      */
     Agent?: Agent;
 }
@@ -2903,78 +2966,80 @@ export interface FlowCreateApprover {
     ApproverSignTypes?: Array<number | bigint>;
 }
 /**
- * 企业员工信息
+ * 企业员工信息。
  */
 export interface Staff {
     /**
-     * 用户在电子签平台的id
-  注：创建和更新场景无需填写
+     * 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+  注：`创建和更新场景无需填写。`
      */
     UserId?: string;
     /**
-     * 显示的用户名/昵称
+     * 显示的用户名/昵称。
      */
     DisplayName?: string;
     /**
-     * 用户手机号
+     * 用户手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
      */
     Mobile?: string;
     /**
-     * 用户邮箱
+     * 用户邮箱。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Email?: string;
     /**
-     * 用户在第三方平台id，如需在此接口提醒员工实名，该参数不传
+     * 用户在第三方平台ID。
+  注：`如需在此接口提醒员工实名，该参数不传。`
   注意：此字段可能返回 null，表示取不到有效值。
      */
     OpenId?: string;
     /**
-     * 员工角色
-  注：创建和更新场景无需填写
+     * 员工角色信息。
+  注：`创建和更新场景无需填写。`
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Roles?: Array<StaffRole>;
     /**
-     * 员工部门
+     * 员工部门信息。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Department?: Department;
     /**
-     * 员工是否实名
-  注：创建和更新场景无需填写
+     * 员工是否实名。
+  注：`创建和更新场景无需填写。`
      */
     Verified?: boolean;
     /**
-     * 员工创建时间戳，单位秒
-  注：创建和更新场景无需填写
+     * 员工创建时间戳，单位秒。
+  注：`创建和更新场景无需填写。`
      */
     CreatedOn?: number;
     /**
-     * 员工实名时间戳，单位秒
-  注：创建和更新场景无需填写
+     * 员工实名时间戳，单位秒。
+  注：`创建和更新场景无需填写。`
   注意：此字段可能返回 null，表示取不到有效值。
      */
     VerifiedOn?: number;
     /**
-     * 员工是否离职：0-未离职，1-离职
-  注：创建和更新场景无需填写
+     * 员工是否离职：
+  <ul><li>**0**：未离职</li><li>**1**：离职</li></ul>
+  注：`创建和更新场景无需填写。`
   注意：此字段可能返回 null，表示取不到有效值。
      */
     QuiteJob?: number;
     /**
-     * 员工离职交接人用户id
-  注：创建和更新场景无需填写
+     * 员工离职交接人用户ID。
+  注：`创建和更新场景无需填写。`
      */
     ReceiveUserId?: string;
     /**
-     * 员工离职交接人用户OpenId
-  注：创建和更新场景无需填写
+     * 员工离职交接人用户OpenId。
+  注：`创建和更新场景无需填写。`
      */
     ReceiveOpenId?: string;
     /**
-     * 企业微信用户账号ID
-  注：仅企微类型的企业创建员工接口支持该字段
+     * 企业微信用户账号ID。
+  注：`仅企微类型的企业创建员工接口支持该字段。`
   注意：此字段可能返回 null，表示取不到有效值。
      */
     WeworkOpenId?: string;
@@ -3075,28 +3140,29 @@ export interface CreateIntegrationDepartmentRequest {
      */
     Operator: UserInfo;
     /**
-     * 部门名称，不超过50个字符
+     * 部门名称，最大长度为50个字符。
      */
     DeptName: string;
     /**
-     * 代理企业和员工的信息。
-  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+     * 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
      */
     Agent?: Agent;
     /**
-     * 电子签父部门ID，与ParentDeptOpenId二选一,优先ParentDeptId,都为空时自动填充至根节点下
+     * 电子签父部门ID。
+  注：`如果同时指定了ParentDeptId与ParentDeptOpenId参数，系统将优先使用ParentDeptId。当二者都未指定时，创建的新部门将自动填充至根节点部门下。`
      */
     ParentDeptId?: string;
     /**
-     * 第三方平台中父部门ID,与ParentDeptId二选一,优先ParentDeptId,都为空时自动填充至根节点下
+     * 第三方平台中父部门ID。
+  注：`如果同时指定了ParentDeptId与ParentDeptOpenId参数，系统将优先使用ParentDeptId。当二者都未指定时，创建的新部门将自动填充至根节点部门下。`
      */
     ParentDeptOpenId?: string;
     /**
-     * 客户系统部门ID，不超过64个字符
+     * 客户系统部门ID，最大长度为64个字符。
      */
     DeptOpenId?: string;
     /**
-     * 排序号,1~30000范围内
+     * 排序号，支持设置的数值范围为1~30000。同一父部门下，排序号越大，部门顺序越靠前。
      */
     OrderNo?: number;
 }
@@ -3115,17 +3181,24 @@ export interface GroupOrganization {
      */
     Alias?: string;
     /**
-     * 成员企业id
+     * 成员企业id，为 32 位字符串，可在电子签PC 控制台，企业设置->企业电子签账号 获取
   注意：此字段可能返回 null，表示取不到有效值。
      */
     OrganizationId?: string;
     /**
-     * 更新时间，时间戳，单位秒
+     * 记录更新时间， unix时间戳，单位秒
   注意：此字段可能返回 null，表示取不到有效值。
      */
     UpdateTime?: number;
     /**
-     * 成员企业加入集团的当前状态:1-待授权;2-已授权待激活;3-拒绝授权;4-已解除;5-已加入
+     * 成员企业加入集团的当前状态
+  <ul><li> **1**：待授权</li>
+  <li> **2**：已授权待激活</li>
+  <li> **3**：拒绝授权</li>
+  <li> **4**：已解除</li>
+  <li> **5**：已加入</li>
+  </ul>
+  
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Status?: number;
@@ -3145,22 +3218,24 @@ export interface GroupOrganization {
      */
     AdminInfo?: Admin;
     /**
-     * 企业许可证
+     * 企业许可证Id，此字段暂时不需要关注
   注意：此字段可能返回 null，表示取不到有效值。
      */
     License?: string;
     /**
-     * 企业许可证过期时间，时间戳，单位秒
+     * 企业许可证过期时间，unix时间戳，单位秒
   注意：此字段可能返回 null，表示取不到有效值。
      */
     LicenseExpireTime?: number;
     /**
-     * 成员企业加入集团时间，时间戳，单位秒
+     * 成员企业加入集团时间，unix时间戳，单位秒
   注意：此字段可能返回 null，表示取不到有效值。
      */
     JoinTime?: number;
     /**
-     * 是否使用自建审批流引擎（即不是企微审批流引擎），true-是，false-否
+     * 是否使用自建审批流引擎（即不是企微审批流引擎）
+  <ul><li> **true**：是</li>
+  <li> **false**：否</li></ul>
   注意：此字段可能返回 null，表示取不到有效值。
      */
     FlowEngineEnable?: boolean;
@@ -3325,15 +3400,19 @@ export interface CreateEmbedWebUrlRequest {
  */
 export interface DeleteIntegrationEmployeesRequest {
     /**
-     * 操作人信息，userId必填
+     * 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
      */
     Operator: UserInfo;
     /**
-     * 待移除员工的信息，userId和openId二选一，必填一个，如果需要指定交接人的话，ReceiveUserId或者ReceiveOpenId字段二选一
+     * 待移除员工的信息。应符合以下规则：
+  <ul><li>UserId和OpenId不可同时为空。</li>
+  <li>若需要进行离职交接，交接人信息ReceiveUserId和ReceiveOpenId不可同时为空。否则视为不进行离职交接。</li></ul>
      */
     Employees: Array<Staff>;
     /**
-     * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId需填充子企业Id
+     * 代理企业和员工的信息。
+  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
      */
     Agent?: Agent;
 }
@@ -3346,7 +3425,7 @@ export interface FailedUpdateStaffData {
      */
     DisplayName?: string;
     /**
-     * 用户传入的手机号
+     * 用户传入的手机号，明文展示
      */
     Mobile?: string;
     /**
@@ -3354,7 +3433,8 @@ export interface FailedUpdateStaffData {
      */
     Reason?: string;
     /**
-     * 用户Id
+     * 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+  可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
      */
     UserId?: string;
     /**
@@ -3469,7 +3549,7 @@ export interface CreateFlowGroupByFilesResponse {
  */
 export interface CreateIntegrationEmployeesResponse {
     /**
-     * 创建员工的结果
+     * 创建员工的结果。包含创建成功的数据与创建失败数据。
      */
     CreateEmployeeResult?: CreateStaffResult;
     /**
@@ -3819,11 +3899,12 @@ export interface SuccessUpdateStaffData {
      */
     DisplayName?: string;
     /**
-     * 传入的手机号
+     * 传入的手机号，没有打码
      */
     Mobile?: string;
     /**
-     * 用户Id
+     * 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+  可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
      */
     UserId?: string;
 }
@@ -4188,7 +4269,7 @@ export interface ModifyIntegrationDepartmentRequest {
      */
     Operator: UserInfo;
     /**
-     * 电子签部门ID,通过DescribeIntegrationDepartments接口可以获取
+     * 电子签部门ID，通过<a href="https://qian.tencent.com/developers/companyApis/organizations/DescribeIntegrationDepartments" target="_blank">DescribeIntegrationDepartments</a>接口获得。
      */
     DeptId: string;
     /**
@@ -4197,19 +4278,19 @@ export interface ModifyIntegrationDepartmentRequest {
      */
     Agent?: Agent;
     /**
-     * 电子签父部门ID，通过DescribeIntegrationDepartments接口可以获取
+     * 电子签父部门ID，通过<a href="https://qian.tencent.com/developers/companyApis/organizations/DescribeIntegrationDepartments" target="_blank">DescribeIntegrationDepartments</a>接口获得。
      */
     ParentDeptId?: string;
     /**
-     * 部门名称，不超过50个字符
+     * 部门名称，最大长度为50个字符。
      */
     DeptName?: string;
     /**
-     * 客户系统部门ID，不超过64个字符
+     * 客户系统部门ID，最大长度为64个字符。
      */
     DeptOpenId?: string;
     /**
-     * 排序号,1~30000范围内
+     * 排序号，支持设置的数值范围为1~30000。同一父部门下，排序号越大，部门顺序越靠前。
      */
     OrderNo?: number;
 }
@@ -4598,7 +4679,7 @@ export interface DeleteIntegrationDepartmentRequest {
      */
     Operator: UserInfo;
     /**
-     * 电子签中的部门id,通过DescribeIntegrationDepartments接口可获得
+     * 电子签中的部门ID，通过<a href="https://qian.tencent.com/developers/companyApis/organizations/DescribeIntegrationDepartments" target="_blank">DescribeIntegrationDepartments</a>接口可获得。
      */
     DeptId: string;
     /**
@@ -4607,7 +4688,8 @@ export interface DeleteIntegrationDepartmentRequest {
      */
     Agent?: Agent;
     /**
-     * 交接部门ID。待删除部门中的合同、印章和模板数据，交接至该部门ID下，未填写交接至公司根部门。
+     * 交接部门ID。
+  待删除部门中的合同、印章和模板数据，将会被交接至该部门ID下；若未填写则交接至公司根部门。
      */
     ReceiveDeptId?: string;
 }
@@ -5236,12 +5318,12 @@ export interface Component {
  */
 export interface IntegrationDepartment {
     /**
-     * 部门ID
+     * 部门ID。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     DeptId?: string;
     /**
-     * 部门名
+     * 部门名。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     DeptName?: string;
@@ -5256,7 +5338,7 @@ export interface IntegrationDepartment {
      */
     DeptOpenId?: string;
     /**
-     * 序列号
+     * 序列号。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     OrderNo?: number;
@@ -5312,6 +5394,86 @@ export interface DescribeIntegrationRolesResponse {
      */
     RequestId?: string;
 }
+/**
+ * CreateBatchSignUrl请求参数结构体
+ */
+export interface CreateBatchSignUrlRequest {
+    /**
+     * 执行本接口操作的员工信息。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+     */
+    Operator: UserInfo;
+    /**
+     * 签署方经办人的姓名。
+  经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
+  
+  注：`请确保和合同中填入的一致`
+     */
+    Name: string;
+    /**
+     * 手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
+  请确认手机号所有方为此业务通知方。
+  
+  注：`请确保和合同中填入的一致,  若无法保持一致，请确保在发起和生成批量签署链接时传入相同的参与方证件信息`
+     */
+    Mobile: string;
+    /**
+     * 代理企业和员工的信息。
+  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+     */
+    Agent?: Agent;
+    /**
+     * 证件类型，支持以下类型
+  <ul><li>ID_CARD : 居民身份证 (默认值)</li>
+  <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+  <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
+  
+  注：`请确保和合同中填入的一致`
+     */
+    IdCardType?: string;
+    /**
+     * 证件号码，应符合以下规则
+  <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+  <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+  <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
+  
+  注：`请确保和合同中填入的一致`
+     */
+    IdCardNumber?: string;
+    /**
+     * 通知用户方式：
+  <ul>
+  <li>**NONE** : 不通知（默认）</li>
+  <li>**SMS** : 短信通知（发送短信通知到Mobile参数所传的手机号）</li>
+  </ul>
+     */
+    NotifyType?: string;
+    /**
+     * 本次需要批量签署的合同流程ID列表。
+  可以不传,  如不传则是发给对方的所有待签署合同流程。
+  
+     */
+    FlowIds?: Array<string>;
+    /**
+     * 目标签署人的企业名称，签署人如果是企业员工身份，需要传此参数。
+  
+  注：
+  <ul>
+  <li>请确认该名称与企业营业执照中注册的名称一致。</li>
+  <li>如果名称中包含英文括号()，请使用中文括号（）代替。</li>
+  <li>请确保此企业已完成腾讯电子签企业认证。</li>
+  </ul>
+     */
+    OrganizationName?: string;
+    /**
+     * 是否直接跳转至合同内容页面进行签署
+  <ul>
+  <li>**false**: 会跳转至批量合同流程的列表,  点击需要批量签署合同后进入合同内容页面进行签署(默认)</li>
+  <li>**true**: 跳过合同流程列表, 直接进入合同内容页面进行签署</li>
+  </ul>
+     */
+    JumpToDetail?: boolean;
+}
 /**
  * CreateFlowReminds请求参数结构体
  */
@@ -5336,7 +5498,8 @@ export interface CreateFlowRemindsRequest {
  */
 export interface UpdateIntegrationEmployeesRequest {
     /**
-     * 当前用户信息，UserId必填
+     * 执行本接口操作的员工信息,UserId必填。
+  注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
      */
     Operator: UserInfo;
     /**
@@ -5346,7 +5509,8 @@ export interface UpdateIntegrationEmployeesRequest {
      */
     Employees: Array<Staff>;
     /**
-     * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId需填充子企业Id
+     * 代理企业和员工的信息。
+  在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
      */
     Agent?: Agent;
 }
@@ -5484,7 +5648,9 @@ export interface Admin {
      */
     Name?: string;
     /**
-     * 超管手机号
+     * 超管手机号，打码显示
+  示例值：138****1569
+  
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Mobile?: string;
@@ -5952,12 +6118,12 @@ export interface FlowBrief {
  */
 export interface DescribeOrganizationGroupOrganizationsResponse {
     /**
-     * 查询到的符合条件的成员企业总数量
+     * 符合查询条件的资源实例总数量。
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Total?: number;
     /**
-     * 已授权待激活的企业数量
+     * 已授权待激活的子企业总数量
   注意：此字段可能返回 null，表示取不到有效值。
      */
     JoinedTotal?: number;
@@ -5978,7 +6144,7 @@ export interface DescribeOrganizationGroupOrganizationsResponse {
      */
     List?: Array<GroupOrganization>;
     /**
-     * 已加入的企业数量
+     * 已加入的子企业总数量
   注意：此字段可能返回 null，表示取不到有效值。
      */
     ActivatedTotal?: number;