tencentcloud-sdk-nodejs 4.0.674 → 4.0.676

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

@@ -304,13 +304,22 @@ export interface CreateFlowApproversResponse {
 }
 
 /**
- * DescribeIntegrationMainOrganizationUser请求参数结构体
+ * DescribeFileUrls返回参数结构体
  */
-export interface DescribeIntegrationMainOrganizationUserRequest {
+export interface DescribeFileUrlsResponse {
   /**
-   * 操作人信息，userId必填
+   * 文件URL信息；
+链接不是永久链接，有效期5分钟后链接失效。
    */
-  Operator: UserInfo
+  FileUrls?: Array<FileUrl>
+  /**
+   * URL数量
+   */
+  TotalCount?: number
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
 }
 
 /**
@@ -342,154 +351,34 @@ export interface CreateMultiFlowSignQRCodeResponse {
 }
 
 /**
- * 创建流程的签署方信息
+ * 签署链接信息
  */
-export interface FlowCreateApprover {
+export interface FlowApproverUrlInfo {
   /**
-   * 参与者类型：
-0：企业
-1：个人
-3：企业自动签署
-注：类型为3（企业自动签署）时，会自动完成该签署方的签署。
-自动签署仅进行盖章操作，不能是手写签名。
-本方企业自动签署的签署人会默认是当前的发起人
-他方企业自动签署的签署人是自动签模板的他方企业授权人
-7: 个人自动签署，适用于个人自动签场景。
-注: 个人自动签场景为白名单功能, 使用前请联系对接的客户经理沟通。
+   * 签署链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  ApproverType: number
+  SignUrl?: string
   /**
-   * 签署人企业名称
-<br/>当approverType=1 或 approverType=3时，必须指定
-
-
+   * 签署人类型 1-个人
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  OrganizationName?: string
+  ApproverType?: number
   /**
-   * 签署方经办人姓名
-<br/>在未指定签署人电子签UserId情况下，为必填参数
+   * 签署人姓名
+注意：此字段可能返回 null，表示取不到有效值。
    */
   ApproverName?: string
   /**
-   * 签署方经办人手机号码
-<br/>在未指定签署人电子签UserId情况下，为必填参数
-
+   * 签署人手机号
+注意：此字段可能返回 null，表示取不到有效值。
    */
   ApproverMobile?: string
   /**
-   * 签署人的证件类型
-ID_CARD 身份证
-HONGKONG_AND_MACAO 港澳居民来往内地通行证
-HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
-OTHER_CARD_TYPE 其他（需要使用该类型请先联系运营经理）
-   */
-  ApproverIdCardType?: string
-  /**
-   * 签署人证件号（长度不超过18位）
-   */
-  ApproverIdCardNumber?: string
-  /**
-   * 签署方经办人在模板中的参与方ID
-<br/>模板发起合同时，该参数为必填项
-<br/>文件发起合同是，该参数无序传值
-
-   */
-  RecipientId?: string
-  /**
-   * 签署意愿确认渠道,WEIXINAPP:人脸识别
-   */
-  VerifyChannel?: Array<string>
-  /**
-   * 是否发送短信
-<br/>sms--短信通知
-<br/>none--不通知
-<br/>默认为sms
-<br/>发起方=签署方时不发送短信
-   */
-  NotifyType?: string
-  /**
-   * 合同强制需要阅读全文，无需传此参数
-   */
-  IsFullText?: boolean
-  /**
-   * 合同的强制预览时间：3~300s，未指定则按合同页数计算
-   */
-  PreReadTime?: number
-  /**
-   * 签署人userId，仅支持本企业的员工userid， 可在控制台组织管理处获得
-
-若传此字段 则以userid的信息为主，会覆盖传递过来的签署人基本信息， 包括姓名，手机号，证件类型等信息
-   */
-  UserId?: string
-  /**
-   * 当前只支持true，默认为true
-   */
-  Required?: boolean
-  /**
-   * 签署人用户来源，此参数仅针对企微用户开放
-
-企微侧用户请传入：WEWORKAPP
-   */
-  ApproverSource?: string
-  /**
-   * 企业签署方或签标识，客户自定义，64位长度
-<br>用于发起含有或签签署人的合同。或签参与人必须有此字段。
-<br/>合同内不同或签参与人CustomApproverTag需要保证唯一。
-<br/>如果或签签署人为本方企微参与人，ApproverSource参数需要指定WEWORKAPP
-   */
-  CustomApproverTag?: string
-  /**
-   * 快速注册相关信息，目前暂未开放！
-   */
-  RegisterInfo?: RegisterInfo
-  /**
-   * 签署人个性化能力值
-   */
-  ApproverOption?: ApproverOption
-  /**
-   * 签署完前端跳转的url，暂未使用
-   * @deprecated
-   */
-  JumpUrl?: string
-  /**
-   * 签署ID
-- 发起流程时系统自动补充
-- 创建签署链接时，可以通过查询详情接口获得签署人的SignId，然后可传入此值为该签署人创建签署链接，无需再传姓名、手机号、证件号等其他信息
-   */
-  SignId?: string
-  /**
-   * 当前签署方进行签署操作是否需要企业内部审批
-<br>true 则为需要
-<br/>false,无序企业内部审批（默认）
-<br/>为个人签署方时则由发起方企业审核。
-   */
-  ApproverNeedSignReview?: boolean
-  /**
-   * 签署人签署控件， 此参数仅针对文件发起（CreateFlowByFiles）生效
-<br/>文件发起时，可通过该参数为签署人指定签署控件类型以及位置
-   */
-  SignComponents?: Array<Component>
-  /**
-   * 签署人填写控件 此参数仅针对文件发起（CreateFlowByFiles）生效
-<br/>文件发起时，可通过该参数为签署人指定填写控件类型以及位置
-   */
-  Components?: Array<Component>
-  /**
-   * 签署方控件类型为 SIGN_SIGNATURE时，可以指定签署方签名方式
-	HANDWRITE – 手写签名
-	OCR_ESIGN -- AI智能识别手写签名
-	ESIGN -- 个人印章类型
-	SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
-   */
-  ComponentLimitType?: Array<string>
-  /**
-   * 合同查看方式<br/>默认1 -实名查看 <br/>2-短信验证码查看(企业签署方暂不支持该方式)
-   */
-  ApproverVerifyTypes?: Array<number | bigint>
-  /**
-   * 合同签署方式(默认1,2) <br/>1-人脸认证 <br/>2-签署密码 <br/>3-运营商三要素
+   * 签署长链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  ApproverSignTypes?: Array<number | bigint>
+  LongUrl?: string
 }
 
 /**
@@ -717,7 +606,8 @@ export interface DescribeIntegrationRolesRequest {
    * 查询的关键字段:
 Key:"RoleType",Values:["1"]查询系统角色，Values:["2"]查询自定义角色
 Key:"RoleStatus",Values:["1"]查询启用角色，Values:["2"]查询禁用角色
-Key:"IsGroupRole"，Values:["0"],查询非集团角色，Values:["1"]表示查询集团角色
+Key:"IsGroupRole"，Values:["0"]:查询非集团角色，Values:["1"]表示查询集团角色
+Key:"IsReturnPermissionGroup"，Values:["0"]:表示接口不返回角色对应的权限树字段，Values:["1"]表示接口返回角色对应的权限树字段
    */
   Filters?: Array<Filter>
   /**
@@ -806,34 +696,42 @@ export interface StaffRole {
 }
 
 /**
- * 签署链接信息
+ * CreateIntegrationRole请求参数结构体
  */
-export interface FlowApproverUrlInfo {
+export interface CreateIntegrationRoleRequest {
   /**
-   * 签署链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
-注意：此字段可能返回 null，表示取不到有效值。
+   * 角色名称，最大长度为20个字符，仅限中文、字母、数字和下划线组成。
    */
-  SignUrl?: string
+  Name: string
   /**
-   * 签署人类型 1-个人
-注意：此字段可能返回 null，表示取不到有效值。
+   * 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+支持填入集团子公司经办人 userId 代发合同。
+
+注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
    */
-  ApproverType?: number
+  Operator: UserInfo
   /**
-   * 签署人姓名
-注意：此字段可能返回 null，表示取不到有效值。
+   * 角色描述，最大长度为50个字符
    */
-  ApproverName?: string
+  Description?: string
   /**
-   * 签署人手机号
-注意：此字段可能返回 null，表示取不到有效值。
+   * 角色类型，0:saas角色，1:集团角色
+默认0，saas角色
    */
-  ApproverMobile?: string
+  IsGroupRole?: number
   /**
-   * 签署长链接。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
-注意：此字段可能返回 null，表示取不到有效值。
+   * 权限树
    */
-  LongUrl?: string
+  PermissionGroups?: Array<PermissionGroup>
+  /**
+   * 集团角色的话，需要传递集团子企业列表，如果是全选，则传1
+   */
+  SubOrganizationIds?: string
+  /**
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+   */
+  Agent?: Agent
 }
 
 /**
@@ -867,8 +765,7 @@ export interface CreateConvertTaskApiRequest {
    */
   Operator?: UserInfo
   /**
-   * 应用号信息
-   * @deprecated
+   * 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
   /**
@@ -1316,6 +1213,20 @@ export interface DescribeIntegrationEmployeesRequest {
   Offset?: number
 }
 
+/**
+ * UnbindEmployeeUserIdWithClientOpenId返回参数结构体
+ */
+export interface UnbindEmployeeUserIdWithClientOpenIdResponse {
+  /**
+   * 解绑是否成功，1表示成功，0表示失败
+   */
+  Status?: number
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * CreateIntegrationUserRoles返回参数结构体
  */
@@ -1566,17 +1477,13 @@ export interface DescribeThirdPartyAuthCodeRequest {
 }
 
 /**
- * UnbindEmployeeUserIdWithClientOpenId返回参数结构体
+ * DescribeIntegrationMainOrganizationUser请求参数结构体
  */
-export interface UnbindEmployeeUserIdWithClientOpenIdResponse {
-  /**
-   * 解绑是否成功，1表示成功，0表示失败
-   */
-  Status?: number
+export interface DescribeIntegrationMainOrganizationUserRequest {
   /**
-   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   * 操作人信息，userId必填
    */
-  RequestId?: string
+  Operator: UserInfo
 }
 
 /**
@@ -1654,6 +1561,67 @@ export interface DescribeIntegrationDepartmentsRequest {
   DeptOpenId?: string
 }
 
+/**
+ * 权限树节点权限
+ */
+export interface Permission {
+  /**
+   * 权限名称
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Name?: string
+  /**
+   * 权限key
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Key?: string
+  /**
+   * 权限类型 1前端，2后端
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Type?: number
+  /**
+   * 是否隐藏
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Hide?: number
+  /**
+   * 数据权限标签 1:表示根节点，2:表示叶子结点
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  DataLabel?: number
+  /**
+   * 数据权限独有，1:关联其他模块鉴权，2:表示关联自己模块鉴权
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  DataType?: number
+  /**
+   * 数据权限独有，表示数据范围，1：全公司，2:部门及下级部门，3:自己
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  DataRange?: number
+  /**
+   * 关联权限, 表示这个功能权限要受哪个数据权限管控
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  DataTo?: string
+  /**
+   * 父级权限key
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ParentKey?: string
+  /**
+   * 是否选中
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  IsChecked?: boolean
+  /**
+   * 子权限集合
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Children?: Array<Permission>
+}
+
 /**
  * CreateIntegrationDepartment返回参数结构体
  */
@@ -1891,6 +1859,26 @@ export interface CreatePersonAuthCertificateImageResponse {
    * 个人用户证明证书的下载链接
    */
   AuthCertUrl?: string
+  /**
+   * 证书图片上的证书编号，20位数字
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ImageCertId?: string
+  /**
+   * 图片证明对应的CA证书序列号
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  SerialNumber?: string
+  /**
+   * CA证书颁发时间戳
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ValidFrom?: number
+  /**
+   * CA证书有效截止时间戳
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ValidTo?: number
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -2323,6 +2311,25 @@ export interface CreateFlowSignUrlResponse {
   RequestId?: string
 }
 
+/**
+ * 发起流程快速注册相关信息
+ */
+export interface RegisterInfo {
+  /**
+   * 法人姓名
+   */
+  LegalName: string
+  /**
+   * 社会统一信用代码
+   * @deprecated
+   */
+  Uscc?: string
+  /**
+   * 社会统一信用代码
+   */
+  UnifiedSocialCreditCode?: string
+}
+
 /**
  * DescribeFileUrls请求参数结构体
  */
@@ -2375,8 +2382,8 @@ export interface DescribeFileUrlsRequest {
    */
   Scene?: string
   /**
-   * 应用相关信息
-   * @deprecated
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }
@@ -2554,101 +2561,270 @@ FormFiled输入示例：
 | cells.N.columnEnd   | Integer | 单元格坐标：列结束index                           |
 | cells.N.content     | String  | 单元格内容，字数不超过100                         |
 
-表格参数headers说明
-widthPercent Integer 表头单元格列占总表头的比例，例如1：30表示 此列占表头的30%，不填写时列宽度平均拆分；例如2：总2列，某一列填写40，剩余列可以为空，按照60计算。；例如3：总3列，某一列填写30，剩余2列可以为空，分别为(100-30)/2=35
-content String 表头单元格内容，字数不超过100
- */
-export interface FormField {
+表格参数headers说明
+widthPercent Integer 表头单元格列占总表头的比例，例如1：30表示 此列占表头的30%，不填写时列宽度平均拆分；例如2：总2列，某一列填写40，剩余列可以为空，按照60计算。；例如3：总3列，某一列填写30，剩余2列可以为空，分别为(100-30)/2=35
+content String 表头单元格内容，字数不超过100
+ */
+export interface FormField {
+  /**
+   * 控件填充vaule，ComponentType和传入值类型对应关系：
+TEXT - 文本内容
+MULTI_LINE_TEXT - 文本内容
+CHECK_BOX - true/false
+FILL_IMAGE、ATTACHMENT - 附件的FileId，需要通过UploadFiles接口上传获取
+SELECTOR - 选项值
+DYNAMIC_TABLE - 传入json格式的表格内容，具体见数据结构FlowInfo：https://cloud.tencent.com/document/api/1420/61525#FlowInfo
+   */
+  ComponentValue: string
+  /**
+   * 控件id，和ComponentName选择一项传入即可
+   */
+  ComponentId?: string
+  /**
+   * 控件名字，最大长度不超过30字符，和ComponentId选择一项传入即可
+   */
+  ComponentName?: string
+}
+
+/**
+ * CreateChannelSubOrganizationModifyQrCode请求参数结构体
+ */
+export interface CreateChannelSubOrganizationModifyQrCodeRequest {
+  /**
+   * 操作人信息，userId必填
+   */
+  Operator: UserInfo
+  /**
+   * 应用编号
+   */
+  ApplicationId: string
+}
+
+/**
+ * 用户信息
+ */
+export interface UserInfo {
+  /**
+   * 用户在平台的编号
+   */
+  UserId?: string
+  /**
+   * 用户的来源渠道，一般不用传，特定场景根据接口说明传值
+   * @deprecated
+   */
+  Channel?: string
+  /**
+   * 用户在渠道的编号，一般不用传，特定场景根据接口说明传值
+   * @deprecated
+   */
+  OpenId?: string
+  /**
+   * 用户真实IP，内部字段，暂未开放
+   * @deprecated
+   */
+  ClientIp?: string
+  /**
+   * 用户代理IP，内部字段，暂未开放
+   * @deprecated
+   */
+  ProxyIp?: string
+}
+
+/**
+ * CreateFlowApprovers请求参数结构体
+ */
+export interface CreateFlowApproversRequest {
+  /**
+   * 调用方用户信息，userId 必填
+   */
+  Operator: UserInfo
+  /**
+   * 签署流程编号
+   */
+  FlowId: string
+  /**
+   * 补充签署人信息
+   */
+  Approvers: Array<FillApproverInfo>
+  /**
+   * 企微消息中的发起人
+   */
+  Initiator?: string
+  /**
+   * 代理相关应用信息，如集团主企业代子企业操作
+
+
+   */
+  Agent?: Agent
+}
+
+/**
+ * ModifyIntegrationRole返回参数结构体
+ */
+export interface ModifyIntegrationRoleResponse {
+  /**
+   * 角色id
+   */
+  RoleId?: string
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
+/**
+ * 创建流程的签署方信息
+ */
+export interface FlowCreateApprover {
+  /**
+   * 参与者类型：
+0：企业
+1：个人
+3：企业自动签署
+注：类型为3（企业自动签署）时，会自动完成该签署方的签署。
+自动签署仅进行盖章操作，不能是手写签名。
+本方企业自动签署的签署人会默认是当前的发起人
+他方企业自动签署的签署人是自动签模板的他方企业授权人
+7: 个人自动签署，适用于个人自动签场景。
+注: 个人自动签场景为白名单功能, 使用前请联系对接的客户经理沟通。
+   */
+  ApproverType: number
+  /**
+   * 签署人企业名称
+当approverType=0 或 approverType=3时，必须指定
+
+
+   */
+  OrganizationName?: string
   /**
-   * 控件填充vaule，ComponentType和传入值类型对应关系：
-TEXT - 文本内容
-MULTI_LINE_TEXT - 文本内容
-CHECK_BOX - true/false
-FILL_IMAGE、ATTACHMENT - 附件的FileId，需要通过UploadFiles接口上传获取
-SELECTOR - 选项值
-DYNAMIC_TABLE - 传入json格式的表格内容，具体见数据结构FlowInfo：https://cloud.tencent.com/document/api/1420/61525#FlowInfo
+   * 签署方经办人姓名
+<br/>在未指定签署人电子签UserId情况下，为必填参数
    */
-  ComponentValue: string
+  ApproverName?: string
   /**
-   * 控件id，和ComponentName选择一项传入即可
+   * 签署方经办人手机号码
+<br/>在未指定签署人电子签UserId情况下，为必填参数
+
    */
-  ComponentId?: string
+  ApproverMobile?: string
   /**
-   * 控件名字，最大长度不超过30字符，和ComponentId选择一项传入即可
+   * 签署人的证件类型
+ID_CARD 身份证
+HONGKONG_AND_MACAO 港澳居民来往内地通行证
+HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
+OTHER_CARD_TYPE 其他（需要使用该类型请先联系运营经理）
    */
-  ComponentName?: string
-}
+  ApproverIdCardType?: string
+  /**
+   * 签署人证件号（长度不超过18位）
+   */
+  ApproverIdCardNumber?: string
+  /**
+   * 签署方经办人在模板中的参与方ID
+<br/>模板发起合同时，该参数为必填项
+<br/>文件发起合同是，该参数无序传值
 
-/**
- * CreateChannelSubOrganizationModifyQrCode请求参数结构体
- */
-export interface CreateChannelSubOrganizationModifyQrCodeRequest {
+   */
+  RecipientId?: string
   /**
-   * 操作人信息，userId必填
+   * 签署意愿确认渠道,WEIXINAPP:人脸识别
    */
-  Operator: UserInfo
+  VerifyChannel?: Array<string>
   /**
-   * 应用编号
+   * 是否发送短信
+<br/>sms--短信通知
+<br/>none--不通知
+<br/>默认为sms
+<br/>发起方=签署方时不发送短信
    */
-  ApplicationId: string
-}
-
-/**
- * 用户信息
- */
-export interface UserInfo {
+  NotifyType?: string
   /**
-   * 用户在平台的编号
+   * 合同强制需要阅读全文，无需传此参数
+   */
+  IsFullText?: boolean
+  /**
+   * 合同的强制预览时间：3~300s，未指定则按合同页数计算
+   */
+  PreReadTime?: number
+  /**
+   * 签署人userId，仅支持本企业的员工userid， 可在控制台组织管理处获得
+
+若传此字段 则以userid的信息为主，会覆盖传递过来的签署人基本信息， 包括姓名，手机号，证件类型等信息
    */
   UserId?: string
   /**
-   * 用户的来源渠道，一般不用传，特定场景根据接口说明传值
-   * @deprecated
+   * 当前只支持true，默认为true
    */
-  Channel?: string
+  Required?: boolean
   /**
-   * 用户在渠道的编号，一般不用传，特定场景根据接口说明传值
-   * @deprecated
+   * 签署人用户来源，此参数仅针对企微用户开放
+
+企微侧用户请传入：WEWORKAPP
    */
-  OpenId?: string
+  ApproverSource?: string
   /**
-   * 用户真实IP，内部字段，暂未开放
-   * @deprecated
+   * 企业签署方或签标识，客户自定义，64位长度
+<br>用于发起含有或签签署人的合同。或签参与人必须有此字段。
+<br/>合同内不同或签参与人CustomApproverTag需要保证唯一。
+<br/>如果或签签署人为本方企微参与人，ApproverSource参数需要指定WEWORKAPP
    */
-  ClientIp?: string
+  CustomApproverTag?: string
   /**
-   * 用户代理IP，内部字段，暂未开放
+   * 快速注册相关信息，目前暂未开放！
+   */
+  RegisterInfo?: RegisterInfo
+  /**
+   * 签署人个性化能力值
+   */
+  ApproverOption?: ApproverOption
+  /**
+   * 签署完前端跳转的url，暂未使用
    * @deprecated
    */
-  ProxyIp?: string
-}
-
-/**
- * CreateFlowApprovers请求参数结构体
- */
-export interface CreateFlowApproversRequest {
+  JumpUrl?: string
   /**
-   * 调用方用户信息，userId 必填
+   * 签署ID
+- 发起流程时系统自动补充
+- 创建签署链接时，可以通过查询详情接口获得签署人的SignId，然后可传入此值为该签署人创建签署链接，无需再传姓名、手机号、证件号等其他信息
    */
-  Operator: UserInfo
+  SignId?: string
   /**
-   * 签署流程编号
+   * 当前签署方进行签署操作是否需要企业内部审批
+<br>true 则为需要
+<br/>false,无序企业内部审批（默认）
+<br/>为个人签署方时则由发起方企业审核。
    */
-  FlowId: string
+  ApproverNeedSignReview?: boolean
   /**
-   * 补充签署人信息
+   * 签署人签署控件， 此参数仅针对文件发起（CreateFlowByFiles）生效
+<br/>文件发起时，可通过该参数为签署人指定签署控件类型以及位置
    */
-  Approvers: Array<FillApproverInfo>
+  SignComponents?: Array<Component>
   /**
-   * 企微消息中的发起人
+   * 签署人填写控件 此参数仅针对文件发起（CreateFlowByFiles）生效
+<br/>文件发起时，可通过该参数为签署人指定填写控件类型以及位置
    */
-  Initiator?: string
+  Components?: Array<Component>
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作
+   * 签署方控件类型为 SIGN_SIGNATURE时，可以指定签署方签名方式
+	HANDWRITE – 手写签名
+	OCR_ESIGN -- AI智能识别手写签名
+	ESIGN -- 个人印章类型
+	SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
+   */
+  ComponentLimitType?: Array<string>
+  /**
+   * 合同查看方式<br/>默认1 -实名查看 <br/>2-短信验证码查看(企业签署方暂不支持该方式)
 
+> 注意:此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主.
+   */
+  ApproverVerifyTypes?: Array<number | bigint>
+  /**
+   * 合同签署方式(默认1,2) <br/>1-人脸认证 <br/>2-签署密码 <br/>3-运营商三要素
 
+> 注意:此参数仅针对文件发起设置生效,模板发起合同签署流程, 请以模板配置为主.
    */
-  Agent?: Agent
+  ApproverSignTypes?: Array<number | bigint>
 }
 
 /**
@@ -2784,18 +2960,13 @@ export interface CreateFlowEvidenceReportResponse {
 }
 
 /**
- * DescribeFileUrls返回参数结构体
+ * CreateIntegrationRole返回参数结构体
  */
-export interface DescribeFileUrlsResponse {
-  /**
-   * 文件URL信息；
-链接不是永久链接，有效期5分钟后链接失效。
-   */
-  FileUrls?: Array<FileUrl>
+export interface CreateIntegrationRoleResponse {
   /**
-   * URL数量
+   * 角色id
    */
-  TotalCount?: number
+  RoleId?: string
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -3173,8 +3344,7 @@ export interface GetTaskResultApiRequest {
    */
   Operator?: UserInfo
   /**
-   * 应用号信息
-   * @deprecated
+   * 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
   /**
@@ -3208,22 +3378,41 @@ MobileCheck：手机号验证
 }
 
 /**
- * 发起流程快速注册相关信息
+ * ModifyIntegrationRole请求参数结构体
  */
-export interface RegisterInfo {
+export interface ModifyIntegrationRoleRequest {
   /**
-   * 法人姓名
+   * 角色Id，可通过接口 DescribeIntegrationRoles 查询获取
    */
-  LegalName: string
+  RoleId: string
   /**
-   * 社会统一信用代码
-   * @deprecated
+   * 角色名称，最大长度为20个字符，仅限中文、字母、数字和下划线组成。
    */
-  Uscc?: string
+  Name: string
   /**
-   * 社会统一信用代码
+   * 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+支持填入集团子公司经办人 userId 代发合同。
+
+注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
    */
-  UnifiedSocialCreditCode?: string
+  Operator: UserInfo
+  /**
+   * 角色描述，最大长度为50个字符
+   */
+  Description?: string
+  /**
+   * 权限树
+   */
+  PermissionGroups?: Array<PermissionGroup>
+  /**
+   * 集团角色的话，需要传递集团子企业列表，如果是全选，则传1
+   */
+  SubOrganizationIds?: Array<string>
+  /**
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+   */
+  Agent?: Agent
 }
 
 /**
@@ -3579,6 +3768,10 @@ HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
    * 身份证件号码
    */
   IdCardNumber: string
+  /**
+   * 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+   */
+  Agent?: Agent
 }
 
 /**
@@ -3750,7 +3943,7 @@ export interface FailedCreateRoleData {
 }
 
 /**
- * 参与者信息
+ * 参与者信息。
  */
 export interface ApproverInfo {
   /**
@@ -3769,10 +3962,8 @@ export interface ApproverInfo {
    */
   ApproverName: string
   /**
-   * 本企业的签署方经办人的员工UserId
-可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
-
-注: `若传该字段，则签署方经办人的其他信息（如签署方经办人的姓名、证件号码、手机号码等）将被忽略。`
+   * 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。
+请确认手机号所有方为此合同签署方。
    */
   ApproverMobile: string
   /**
@@ -4234,6 +4425,11 @@ export interface IntegrateRole {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   SubOrgIdList?: Array<string>
+  /**
+   * 权限树
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  PermissionGroups?: Array<PermissionGroup>
 }
 
 /**
@@ -4444,7 +4640,7 @@ export interface CreatePrepareFlowRequest {
    */
   Operator: UserInfo
   /**
-   * 资源Id，通过多文件上传（UploadFiles）接口获得
+   * 资源id，与ResourceType对应
    */
   ResourceId: string
   /**
@@ -4465,25 +4661,32 @@ false:顺序签
   Deadline?: number
   /**
    * 用户自定义合同类型Id
-该id为电子签企业内的合同类型id
+
+该id为电子签企业内的合同类型id， 可以在自定义合同类型处获取
    */
   UserFlowTypeId?: string
+  /**
+   * 合同类型名称
+该字段用于客户自定义合同类型
+建议使用时指定合同类型，便于之后合同分类以及查看
+如果合同类型与自定义的合同类型描述一致，会自动归类到自定义的合同类型处，如果不一致，则会创建一个新的自定义合同类型
+   */
+  FlowType?: string
   /**
    * 签署流程参与者信息，最大限制50方
    */
   Approvers?: Array<FlowCreateApprover>
   /**
    * 打开智能添加填写区
-(默认开启，打开:"OPEN"
+默认开启，打开:"OPEN"
  关闭："CLOSE"
    */
   IntelligentStatus?: string
   /**
    * 资源类型，
-1：文件，
-2：模板
-不传默认为1：文件
-目前仅支持文件
+1：模板
+2：文件，
+不传默认为2：文件
    */
   ResourceType?: number
   /**
@@ -4519,12 +4722,6 @@ false:不开启发起方发起合同审核
    * 合同id,用于通过已web页面发起的合同id快速生成一个web发起合同链接
    */
   FlowId?: string
-  /**
-   * 合同类型名称
-该字段用于客户自定义合同类型
-建议使用时指定合同类型，便于之后合同分类以及查看
-   */
-  FlowType?: string
   /**
    * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
    */
@@ -4638,6 +4835,46 @@ LEGAL_PERSON_SEAL：法定代表人章
    * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
    */
   Agent?: Agent
+  /**
+   * 查询的印章状态列表。
+取值为空，只查询启用状态的印章；
+取值ALL，查询所有状态的印章；
+取值CHECKING，查询待审核的印章；
+取值SUCCESS，查询启用状态的印章；
+取值FAIL，查询印章审核拒绝的印章；
+取值DISABLE，查询已停用的印章；
+取值STOPPED，查询已终止的印章；
+取值VOID，查询已作废的印章；
+取值INVALID，查询以失效的印章；
+
+   */
+  SealStatuses?: Array<string>
+}
+
+/**
+ * 权限树中的权限组
+ */
+export interface PermissionGroup {
+  /**
+   * 权限组名称
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  GroupName?: string
+  /**
+   * 权限组key
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  GroupKey?: string
+  /**
+   * 是否隐藏分组，0否1是
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Hide?: number
+  /**
+   * 权限集合
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Permissions?: Array<Permission>
 }
 
 /**
@@ -5123,7 +5360,7 @@ export interface VerifyPdfResponse {
    */
   VerifyResult?: number
   /**
-   * 验签结果详情,内部状态1-验签成功，在电子签签署；2-验签成功，在其他平台签署；3-验签失败；4-pdf文件没有签名域；5-文件签名格式错误
+   * 验签结果详情，每个签名域对应的验签结果。状态值：1-验签成功，在电子签签署；2-验签成功，在其他平台签署；3-验签失败；4-pdf文件没有签名域；5-文件签名格式错误
    */
   PdfVerifyResults?: Array<PdfVerifyResult>
   /**
@@ -5417,13 +5654,15 @@ export interface CreateMultiFlowSignQRCodeRequest {
    */
   UserData?: string
   /**
-   * 回调地址,最大长度1000字符串
-<br/>回调时机：用户通过签署二维码发起签署流程时，企业额度不足导致失败
+   * 已废弃，回调配置统一使用企业应用管理-应用集成-企业版应用中的配置 
+<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
+
+   * @deprecated
    */
   CallbackUrl?: string
   /**
-   * 应用信息
-   * @deprecated
+   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
    */
   Agent?: Agent
   /**
@@ -5580,62 +5819,60 @@ export interface FileUrl {
 }
 
 /**
- * 流程信息摘要
+ * 合同流程的基础信息
  */
 export interface FlowBrief {
   /**
-   * 流程的编号ID
+   * 合同流程ID，为32位字符串。
    */
   FlowId?: string
   /**
-   * 流程的名称
+   * 合同流程的名称。
    */
   FlowName?: string
   /**
-   * 流程的描述信息
+   * 合同流程描述信息。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   FlowDescription?: string
   /**
-   * 流程的类型
+   * 合同流程的类别分类（如销售合同/入职合同等）。
    */
   FlowType?: string
   /**
-   * 流程状态
-- 0 还没有发起
-- 1 待签署
-- 2 部分签署
-- 3 已拒签
-- 4 已签署
-- 5 已过期
-- 6 已撤销
-- 7 还没有预发起
-- 8 等待填写
-- 9 部分填写
-- 10 拒填
-- 21 已解除
+   * 合同流程当前的签署状态, 会存在下列的状态值
+<ul><li> **0** : 未开启流程(合同中不存在填写环节)</li>
+<li> **1** : 待签署</li>
+<li> **2** : 部分签署</li>
+<li> **3** : 已拒签</li>
+<li> **4** : 已签署</li>
+<li> **5** : 已过期</li>
+<li> **6** : 已撤销</li>
+<li> **7** : 未开启流程(合同中存在填写环节)</li>
+<li> **8** : 等待填写</li>
+<li> **9** : 部分填写</li>
+<li> **10** : 已拒填</li>
+<li> **21** : 已解除</li></ul>
 注意：此字段可能返回 null，表示取不到有效值。
    */
   FlowStatus?: number
   /**
-   * 流程创建的时间戳，单位秒
+   * 合同流程创建时间，格式为Unix标准时间戳（秒）。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   CreatedOn?: number
   /**
-   * 当合同被拒签或者取消后(当FlowStatus=3或者FlowStatus=6的时候)
-此字段展示拒签或者取消的原因描述
-
+   * 当合同流程状态为已拒签（即 FlowStatus=3）或已撤销（即 FlowStatus=6）时，此字段 FlowMessage 为拒签或撤销原因。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   FlowMessage?: string
   /**
-   *  合同发起人userId
+   *  合同流程发起方的员工编号, 即员工在腾讯电子签平台的唯一身份标识。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Creator?: string
   /**
-   * 合同过期时间，时间戳，单位秒
+   * 合同流程的签署截止时间，格式为Unix标准时间戳（秒）。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Deadline?: number