tencentcloud-sdk-nodejs 4.0.638 → 4.0.640

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

@@ -688,6 +688,20 @@ export interface CreateConvertTaskApiRequest {
   Organization?: OrganizationInfo
 }
 
+/**
+ * DeleteIntegrationEmployees返回参数结构体
+ */
+export interface DeleteIntegrationEmployeesResponse {
+  /**
+   * 员工删除数据
+   */
+  DeleteEmployeeResult?: DeleteStaffsResult
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * CreateFlowReminds返回参数结构体
  */
@@ -773,7 +787,7 @@ export interface FlowApproverDetail {
   /**
    * 签署方姓名
    */
-  ApproveName: string
+  ApproveName?: string
   /**
    * 签署方的签署状态
 0：还没有发起
@@ -790,104 +804,79 @@ export interface FlowApproverDetail {
 15：已解除
 19：转他人处理
    */
-  ApproveStatus: number
+  ApproveStatus?: number
   /**
    * 模板配置中的参与方ID,与控件绑定
    */
-  ReceiptId: string
+  ReceiptId?: string
   /**
    * 客户自定义的用户ID
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  CustomUserId: string
+  CustomUserId?: string
   /**
    * 签署人手机号
    */
-  Mobile: string
+  Mobile?: string
   /**
    * 签署顺序，如果是有序签署，签署顺序从小到大
    */
-  SignOrder: number
+  SignOrder?: number
   /**
    * 签署人签署时间，时间戳，单位秒
    */
-  ApproveTime: number
+  ApproveTime?: number
   /**
    * 签署方类型，ORGANIZATION-企业员工，PERSON-个人，ENTERPRISESERVER-企业静默签
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  ApproveType: string
+  ApproveType?: string
   /**
    * 签署方侧用户来源，如WEWORKAPP-企业微信等
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  ApproverSource: string
+  ApproverSource?: string
   /**
    * 客户自定义签署方标识
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  CustomApproverTag: string
+  CustomApproverTag?: string
   /**
    * 签署方企业Id
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  OrganizationId: string
+  OrganizationId?: string
   /**
    * 签署方企业名称
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  OrganizationName: string
+  OrganizationName?: string
 }
 
 /**
- * DescribeFlowTemplates请求参数结构体
+ * CreateFlowGroupByFiles请求参数结构体
  */
-export interface DescribeFlowTemplatesRequest {
+export interface CreateFlowGroupByFilesRequest {
   /**
-   * 调用方用户信息，userId 必填
+   * 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId 代发合同
    */
   Operator: UserInfo
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 合同（流程）组名称,最大长度200个字符
    */
-  Agent?: Agent
-  /**
-   * 查询内容：0-模板列表及详情（默认），1-仅模板列表
-   */
-  ContentType?: number
+  FlowGroupName: string
   /**
-   * 搜索条件，具体参考Filter结构体。本接口取值：template-id：按照【 **模板唯一标识** 】进行过滤
+   * 合同（流程）组的子合同信息，支持2-50个子合同
    */
-  Filters?: Array<Filter>
+  FlowGroupInfos: Array<FlowGroupInfo>
   /**
-   * 查询偏移位置，默认0
-   */
-  Offset?: number
-  /**
-   * 查询个数，默认20，最大200
-   */
-  Limit?: number
-  /**
-   * ApplicationId不为空，查询指定应用下的模板列表
-ApplicationId为空，查询所有应用下的模板列表
-   */
-  ApplicationId?: string
-  /**
-   * 默认为false，查询SaaS模板库列表；
-为true，查询第三方应用集成平台企业模板库管理列表
-   * @deprecated
-   */
-  IsChannel?: boolean
-  /**
-   * 暂未开放
-   * @deprecated
+   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
    */
-  Organization?: OrganizationInfo
+  Agent?: Agent
   /**
-   * 暂未开放
-   * @deprecated
+   * 合同（流程）组的配置项信息。包括是否通知本企业签署方，是否通知其他签署方
    */
-  GenerateSource?: number
+  FlowGroupOptions?: FlowGroupOptions
 }
 
 /**
@@ -950,29 +939,23 @@ export interface CallbackInfo {
 }
 
 /**
- * 参与方填写控件信息
+ * CreateFlowGroupByTemplates返回参数结构体
  */
-export interface RecipientComponentInfo {
-  /**
-   * 参与方Id
-注意：此字段可能返回 null，表示取不到有效值。
-   */
-  RecipientId?: string
+export interface CreateFlowGroupByTemplatesResponse {
   /**
-   * 参与方填写状态
+   * 合同(流程)组的合同组Id
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  RecipientFillStatus?: string
+  FlowGroupId?: string
   /**
-   * 是否发起方
+   * 合同(流程)组中子合同列表.
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  IsPromoter?: boolean
+  FlowIds?: Array<string>
   /**
-   * 填写控件内容
-注意：此字段可能返回 null，表示取不到有效值。
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
-  Components?: Array<FilledComponent>
+  RequestId?: string
 }
 
 /**
@@ -1253,6 +1236,10 @@ APP：第三方APP或小程序跳转电子签小程序的path。
    * 签署流程编号 (PathType=1时必传)
    */
   FlowId?: string
+  /**
+   * 合同组ID
+   */
+  FlowGroupId?: string
   /**
    * 跳转页面 1: 小程序合同详情 2: 小程序合同列表页 0: 不传, 默认主页
    */
@@ -1400,6 +1387,57 @@ export interface CreateIntegrationDepartmentResponse {
   RequestId?: string
 }
 
+/**
+ * DescribeFlowTemplates请求参数结构体
+ */
+export interface DescribeFlowTemplatesRequest {
+  /**
+   * 调用方用户信息，userId 必填
+   */
+  Operator: UserInfo
+  /**
+   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   */
+  Agent?: Agent
+  /**
+   * 查询内容：0-模板列表及详情（默认），1-仅模板列表
+   */
+  ContentType?: number
+  /**
+   * 搜索条件，具体参考Filter结构体。本接口取值：template-id：按照【 **模板唯一标识** 】进行过滤
+   */
+  Filters?: Array<Filter>
+  /**
+   * 查询偏移位置，默认0
+   */
+  Offset?: number
+  /**
+   * 查询个数，默认20，最大200
+   */
+  Limit?: number
+  /**
+   * ApplicationId不为空，查询指定应用下的模板列表
+ApplicationId为空，查询所有应用下的模板列表
+   */
+  ApplicationId?: string
+  /**
+   * 默认为false，查询SaaS模板库列表；
+为true，查询第三方应用集成平台企业模板库管理列表
+   * @deprecated
+   */
+  IsChannel?: boolean
+  /**
+   * 暂未开放
+   * @deprecated
+   */
+  Organization?: OrganizationInfo
+  /**
+   * 暂未开放
+   * @deprecated
+   */
+  GenerateSource?: number
+}
+
 /**
  * DeleteSealPolicies返回参数结构体
  */
@@ -1799,9 +1837,13 @@ REJECT: 拒绝
    */
   RecipientId?: string
   /**
-   * 操作类型：
-操作类型，默认：SignReview；SignReview:签署审核
-注：接口通过该字段区分操作类型
+   * 操作类型：（接口通过该字段区分操作类型）
+
+SignReview:签署审核
+CreateReview:发起审核
+
+默认：SignReview；SignReview:签署审核
+
 该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程
 若发起个人审核，则指定该字段为：SignReview（注意，给个人审核时，需联系客户经理开白使用）
    */
@@ -1874,6 +1916,64 @@ export interface CreateUserAutoSignEnableUrlResponse {
   RequestId?: string
 }
 
+/**
+ * 此结构体(FlowGroupInfo)描述的是合同组(流程组)的单个合同(流程)信息
+ */
+export interface FlowGroupInfo {
+  /**
+   * 合同（流程）的名称
+   */
+  FlowName: string
+  /**
+   * 合同（流程）的签署方信息
+   */
+  Approvers: Array<ApproverInfo>
+  /**
+   * 发起合同（流程）的资源Id,此资源必须是PDF文件,来自UploadFiles,使用文件发起合同(流程)组时必传
+   */
+  FileIds?: Array<string>
+  /**
+   * 发起合同（流程）的模板Id,用模板发起合同（流程）组时必填
+   */
+  TemplateId?: string
+  /**
+   * 合同（流程）的类型
+   */
+  FlowType?: string
+  /**
+   * 合同（流程）的描述
+   */
+  FlowDescription?: string
+  /**
+   * 合同（流程）的截止时间戳，单位秒。默认是一年
+   */
+  Deadline?: number
+  /**
+   * 合同（流程）的回调地址
+   */
+  CallbackUrl?: string
+  /**
+   * 第三方平台传递过来的信息, 限制1024字符 格式必须是base64的
+   */
+  UserData?: string
+  /**
+   * 合同（流程）的签署是否是无序签, true - 无序。 false - 有序, 默认
+   */
+  Unordered?: boolean
+  /**
+   * 合同（流程）发起方的填写控件，用户
+   */
+  Components?: Array<Component>
+  /**
+   * 本企业（发起方）是否需要签署审批，若需要审批则只允许查看不允许签署，需要您调用接口CreateFlowSignReview提交审批结果。
+   */
+  NeedSignReview?: boolean
+  /**
+   * 本企业（发起方）自动签署，需要您在发起合同时给印章控件指定自动签的印章。
+   */
+  AutoSignScene?: string
+}
+
 /**
  * CreateFlowSignUrl返回参数结构体
  */
@@ -2224,6 +2324,32 @@ export interface Staff {
   WeworkOpenId?: string
 }
 
+/**
+ * 参与方填写控件信息
+ */
+export interface RecipientComponentInfo {
+  /**
+   * 参与方Id
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  RecipientId?: string
+  /**
+   * 参与方填写状态
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  RecipientFillStatus?: string
+  /**
+   * 是否发起方
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  IsPromoter?: boolean
+  /**
+   * 填写控件内容
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Components?: Array<FilledComponent>
+}
+
 /**
  * CreateFlowEvidenceReport返回参数结构体
  */
@@ -2447,16 +2573,16 @@ export interface FlowDetailInfo {
   /**
    * 合同(流程)的ID
    */
-  FlowId: string
+  FlowId?: string
   /**
    * 合同(流程)的名字
    */
-  FlowName: string
+  FlowName?: string
   /**
    * 合同(流程)的类型
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  FlowType: string
+  FlowType?: string
   /**
    * 流程状态
 - 0 还没有发起
@@ -2472,25 +2598,25 @@ export interface FlowDetailInfo {
 - 10 拒填
 - 21 已解除
    */
-  FlowStatus: number
+  FlowStatus?: number
   /**
    * 合同(流程)的信息
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  FlowMessage: string
+  FlowMessage?: string
   /**
    * 流程的描述
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  FlowDescription: string
+  FlowDescription?: string
   /**
    * 合同(流程)的创建时间戳，单位秒
    */
-  CreatedOn: number
+  CreatedOn?: number
   /**
    * 合同(流程)的签署方数组
    */
-  FlowApproverInfos: Array<FlowApproverDetail>
+  FlowApproverInfos?: Array<FlowApproverDetail>
   /**
    * 合同(流程)的关注方信息列表
    */
@@ -2602,6 +2728,29 @@ export interface GetTaskResultApiRequest {
   Organization?: OrganizationInfo
 }
 
+/**
+ * 此结构体(FlowGroupOptions)描述的是合同组的个性化配置，支持控制是否发送短信、未实名个人签署方查看合同组时是否需要实名认证（仅在合同组文件发起配置时生效）
+ */
+export interface FlowGroupOptions {
+  /**
+   * 发起合同（流程）组的合同（流程）签署人校验方式
+VerifyCheck: 人脸识别（默认）
+MobileCheck：手机号验证
+参数说明：此参数仅在合同组文件发起有效，可选人脸识别或手机号验证两种方式，若选择后者，未实名个人签署方在签署合同时，无需经过实名认证和意愿确认两次人脸识别，该能力仅适用于个人签署方。
+   */
+  ApproverVerifyType?: string
+  /**
+   * 发起合同（流程）组本方企业经办人通知方式
+签署通知类型：sms--短信，none--不通知
+   */
+  SelfOrganizationApproverNotifyType?: string
+  /**
+   * 发起合同（流程）组他方经办人通知方式
+签署通知类型：sms--短信，none--不通知
+   */
+  OtherApproverNotifyType?: string
+}
+
 /**
  * 发起流程快速注册相关信息
  */
@@ -2616,6 +2765,26 @@ export interface RegisterInfo {
   Uscc: string
 }
 
+/**
+ * CreateFlowGroupByFiles返回参数结构体
+ */
+export interface CreateFlowGroupByFilesResponse {
+  /**
+   * 合同(流程)组的合同组Id
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  FlowGroupId?: string
+  /**
+   * 合同(流程)组中子合同列表.
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  FlowIds?: Array<string>
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * CreateIntegrationEmployees返回参数结构体
  */
@@ -2941,14 +3110,14 @@ export interface ApproverInfo {
    * 签署人的手机号，11位数字
    */
   ApproverMobile: string
-  /**
-   * 签署人的签署控件列表
-   */
-  SignComponents: Array<Component>
   /**
    * 如果签署方是企业签署方，则为企业名
    */
   OrganizationName?: string
+  /**
+   * 签署人的签署控件列表
+   */
+  SignComponents?: Array<Component>
   /**
    * 签署人的身份证号
    */
@@ -4085,17 +4254,29 @@ export interface DescribeFlowBriefsRequest {
 }
 
 /**
- * DeleteIntegrationEmployees返回参数结构体
+ * CreateFlowGroupByTemplates请求参数结构体
  */
-export interface DeleteIntegrationEmployeesResponse {
+export interface CreateFlowGroupByTemplatesRequest {
   /**
-   * 员工删除数据
+   * 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId 代发合同
    */
-  DeleteEmployeeResult?: DeleteStaffsResult
+  Operator: UserInfo
   /**
-   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   * 合同组名称,最大长度200个字符
    */
-  RequestId?: string
+  FlowGroupName: string
+  /**
+   * 合同组的子合同信息，支持2-50个子合同
+   */
+  FlowGroupInfos: Array<FlowGroupInfo>
+  /**
+   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   */
+  Agent?: Agent
+  /**
+   * 合同组的配置信息。包括是否通知本企业签署方，是否通知其他签署方
+   */
+  FlowGroupOptions?: FlowGroupOptions
 }
 
 /**
@@ -4415,18 +4596,22 @@ export interface CreateMultiFlowSignQRCodeRequest {
  * DescribeFlowInfo请求参数结构体
  */
 export interface DescribeFlowInfoRequest {
-  /**
-   * 需要查询的流程ID列表，限制最大100个
-   */
-  FlowIds: Array<string>
   /**
    * 调用方用户信息，userId 必填
    */
   Operator?: UserInfo
+  /**
+   * 需要查询的流程ID列表，限制最大100个
+   */
+  FlowIds?: Array<string>
   /**
    * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
    */
   Agent?: Agent
+  /**
+   * 合同组ID
+   */
+  FlowGroupId?: string
 }
 
 /**
@@ -4437,6 +4622,14 @@ export interface DescribeFlowInfoResponse {
    * 签署流程信息
    */
   FlowDetailInfos?: Array<FlowDetailInfo>
+  /**
+   * 合同组ID
+   */
+  FlowGroupId?: string
+  /**
+   * 合同组名称
+   */
+  FlowGroupName?: string
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */

package/src/services/essbasic/v20210526/essbasic_client.ts

@@ -25,6 +25,7 @@ import {
   ChannelBatchCancelFlowsResponse,
   Department,
   CommonApproverOption,
+  ChannelCreateFlowGroupByTemplatesResponse,
   ChannelCreateFlowSignReviewRequest,
   AuthFailMessage,
   DescribeFlowDetailInfoRequest,
@@ -130,6 +131,7 @@ import {
   ChannelCreateEmbedWebUrlResponse,
   ChannelBatchCancelFlowsRequest,
   ChannelUpdateSealStatusRequest,
+  ChannelCreateFlowGroupByTemplatesRequest,
   SignUrl,
   ChannelCancelFlowRequest,
   DescribeTemplatesRequest,
@@ -545,7 +547,7 @@ https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchAp
   }
 
   /**
-   * 查询用户角色
+   * 查询角色列表，支持根据类型和状态过滤角色列表
    */
   async ChannelDescribeRoles(
     req: ChannelDescribeRolesRequest,
@@ -613,6 +615,16 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");
     return this.request("SyncProxyOrganization", req, cb)
   }
 
+  /**
+   * 接口（ChannelCreateFlowGroupByTemplates）用于通过多模板创建合同组签署流程。
+   */
+  async ChannelCreateFlowGroupByTemplates(
+    req: ChannelCreateFlowGroupByTemplatesRequest,
+    cb?: (error: string, rep: ChannelCreateFlowGroupByTemplatesResponse) => void
+  ): Promise<ChannelCreateFlowGroupByTemplatesResponse> {
+    return this.request("ChannelCreateFlowGroupByTemplates", req, cb)
+  }
+
   /**
      * 此接口（SyncProxyOrganizationOperators）用于同步 第三方平台子客企业经办人列表，主要是同步经办人的离职状态。子客Web控制台的组织架构管理，是依赖于第三方应用平台的，无法针对员工做新增/更新/离职等操作。 
 若经办人信息有误，或者需要修改，也可以先将之前的经办人做离职操作，然后重新使用控制台链接CreateConsoleLoginUrl让经办人重新实名。

package/src/services/essbasic/v20210526/essbasic_models.ts

@@ -122,6 +122,29 @@ export interface CommonApproverOption {
   CanEditApprover?: boolean
 }
 
+/**
+ * ChannelCreateFlowGroupByTemplates返回参数结构体
+ */
+export interface ChannelCreateFlowGroupByTemplatesResponse {
+  /**
+   * 合同组ID
+   */
+  FlowGroupId?: string
+  /**
+   * 子合同ID列表
+   */
+  FlowIds?: Array<string>
+  /**
+   * 复杂文档合成任务（如，包含动态表格的预览任务）的任务信息数组；
+如果文档需要异步合成，此字段会返回该异步任务的任务信息，后续可以通过ChannelGetTaskResultApi接口查询任务详情；
+   */
+  TaskInfos?: Array<TaskInfo>
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * ChannelCreateFlowSignReview请求参数结构体
  */
@@ -371,6 +394,10 @@ export interface FlowFileInfo {
    * 合同签署顺序类型(无序签,顺序签)，默认为false，即有序签署
    */
   Unordered?: boolean
+  /**
+   * 签署文件中的发起方的填写控件，需要在发起的时候进行填充
+   */
+  Components?: Array<Component>
   /**
    * 合同显示的页卡模板，说明：只支持{合同名称}, {发起方企业}, {发起方姓名}, {签署方N企业}, {签署方N姓名}，且N不能超过签署人的数量，N从1开始
    */
@@ -969,7 +996,7 @@ export interface DescribeResourceUrlsByFlowsResponse {
  */
 export interface ChannelCreateFlowGroupByFilesRequest {
   /**
-   * 每个子合同的发起所需的信息，数量限制2-100
+   * 每个子合同的发起所需的信息，数量限制2-50
    */
   FlowFileInfos: Array<FlowFileInfo>
   /**
@@ -2448,6 +2475,11 @@ HANDWRITE -手写签名
 - 创建签署链接时，可以通过查询详情接口获得签署人的SignId，然后可传入此值为该签署人创建签署链接，无需再传姓名、手机号、证件号等其他信息
    */
   SignId?: string
+  /**
+   * SMS: 短信; NONE: 不发信息
+默认为SMS(该字段对子客无效)
+   */
+  NotifyType?: string
 }
 
 /**
@@ -3528,6 +3560,24 @@ export interface ChannelUpdateSealStatusRequest {
   Operator?: UserInfo
 }
 
+/**
+ * ChannelCreateFlowGroupByTemplates请求参数结构体
+ */
+export interface ChannelCreateFlowGroupByTemplatesRequest {
+  /**
+   * 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 均必填。
+   */
+  Agent: Agent
+  /**
+   * 每个子合同的发起所需的信息，数量限制2-50（合同组暂不支持抄送功能）
+   */
+  FlowInfos: Array<FlowInfo>
+  /**
+   * 合同组名称，长度不超过200个字符
+   */
+  FlowGroupName: string
+}
+
 /**
  * 一码多扫签署二维码签署信息
  */