tencentcloud-sdk-nodejs 4.0.766 → 4.0.767

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

@@ -27,6 +27,7 @@ import {
   UpdateIntegrationEmployeesResponse,
   Department,
   CreatePreparedPersonalEsignRequest,
+  DeleteStaffsResult,
   DescribeIntegrationDepartmentsResponse,
   DeleteExtendedServiceAuthInfosResponse,
   CreateFlowApproversResponse,
@@ -56,6 +57,8 @@ import {
   DeleteIntegrationRoleUsersResponse,
   CreateConvertTaskApiRequest,
   DeleteIntegrationEmployeesResponse,
+  NeedReviewApproverInfo,
+  CreateFlowGroupSignReviewResponse,
   CreateBatchSignUrlResponse,
   CreateFlowRemindsResponse,
   DescribeOrganizationGroupOrganizationsRequest,
@@ -200,7 +203,7 @@ import {
   CreateUserAutoSignEnableUrlResponse,
   SignUrl,
   VerifyPdfResponse,
-  DeleteStaffsResult,
+  CreateFlowGroupSignReviewRequest,
   DescribeBillUsageDetailRequest,
   Admin,
   Caller,
@@ -389,23 +392,20 @@ export class Client extends AbstractClient {
   }
 
   /**
-     * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
-
-适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
-
-适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。此处注意权限树内容可能会更新，需尽量拉取最新的权限树内容，并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
+     * 提交合同组签署流程审批结果的适用场景包括：
 
-适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
+1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时，若指定了以下参数 为true，则可以调用此接口提交企业内部签署审批结果。即使是自动签署也需要进行审核通过才会进行签署。
+  - [FlowGroupInfo.NeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#flowgroupinfo)
+  - [ApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/companyApis/dataTypes/#approverinfo)
 
-适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
 
-注意事项：SaaS角色和集团角色对应的权限树是不一样的。
+2. 同一合同组，同一签署人可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
      */
-  async CreateIntegrationRole(
-    req: CreateIntegrationRoleRequest,
-    cb?: (error: string, rep: CreateIntegrationRoleResponse) => void
-  ): Promise<CreateIntegrationRoleResponse> {
-    return this.request("CreateIntegrationRole", req, cb)
+  async CreateFlowGroupSignReview(
+    req: CreateFlowGroupSignReviewRequest,
+    cb?: (error: string, rep: CreateFlowGroupSignReviewResponse) => void
+  ): Promise<CreateFlowGroupSignReviewResponse> {
+    return this.request("CreateFlowGroupSignReview", req, cb)
   }
 
   /**
@@ -526,9 +526,36 @@ export class Client extends AbstractClient {
   }
 
   /**
-     * 提交签署流程审批结果的适用场景包括：
-1. 在使用模板（CreateFlow）或文件（CreateFlowByFiles）创建签署流程时，若指定了参数NeedSignReview为true，且发起方企业作为签署方参与了流程签署，则可以调用此接口提交企业内部签署审批结果。自动签署也需要进行审核通过才会进行签署。
-2. 若签署流程状态正常，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
+     * 提交企业流程审批结果 
+**当前存在两种审核操作：**
+<ul>
+<li>签署审核
+<ul>
+<li>在通过接口<ul>
+<li>CreateFlowByFiles</li>
+<li>CreateFlow</li>
+<li>CreateFlowGroupByTemplates</li>
+<li>CreateFlowGroupByFiles</li>
+<li>CreatePrepareFlow</li>
+</ul> 
+发起签署流程时，通过指定NeedSignReview为true，则可以调用此接口，并指定operate=SignReview，以提交企业内部签署审批结果</li>
+<li>在通过接口
+<ul>
+<li>CreateFlowByFiles</li>
+<li>CreateFlow</li>
+<li>CreateFlowGroupByTemplates</li>
+<li>CreateFlowGroupByFiles</li>
+</ul>
+发起签署流程时，通过指定签署人ApproverNeedSignReview为true，则可以调用此接口，并指定operate=SignReview，并指定RecipientId，以提交企业内部签署审批结果</li>
+</ul>
+</li>
+<li>发起审核
+ <ul>
+<li>通过接口CreatePrepareFlow指定发起后需要审核，那么可以调用此接口，并指定operate=CreateReview，以提交企业内部审批结果。可以多次提交审批结果，但一旦审批通过，后续提交的结果将无效
+</li>
+</ul>
+</li>
+</ul>
      */
   async CreateFlowSignReview(
     req: CreateFlowSignReviewRequest,
@@ -997,6 +1024,26 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");
     return this.request("DescribeFlowBriefs", req, cb)
   }
 
+  /**
+     * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
+
+适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
+
+适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。此处注意权限树内容可能会更新，需尽量拉取最新的权限树内容，并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
+
+适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
+
+适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
+
+注意事项：SaaS角色和集团角色对应的权限树是不一样的。
+     */
+  async CreateIntegrationRole(
+    req: CreateIntegrationRoleRequest,
+    cb?: (error: string, rep: CreateIntegrationRoleResponse) => void
+  ): Promise<CreateIntegrationRoleResponse> {
+    return this.request("CreateIntegrationRole", req, cb)
+  }
+
   /**
    * 此接口用于赋予员工指定的角色权限，如需解绑请使用 DeleteIntegrationRoleUsers 接口。
    */

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

@@ -382,6 +382,22 @@ BLUE 蓝色。
   SceneKey?: string
 }
 
+/**
+ * 删除员工结果
+ */
+export interface DeleteStaffsResult {
+  /**
+   * 删除员工的成功数据
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  SuccessEmployeeData: Array<SuccessDeleteStaffData>
+  /**
+   * 删除员工的失败数据
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  FailedEmployeeData: Array<FailedDeleteStaffData>
+}
+
 /**
  * DescribeIntegrationDepartments返回参数结构体
  */
@@ -1098,6 +1114,61 @@ export interface DeleteIntegrationEmployeesResponse {
   RequestId?: string
 }
 
+/**
+ * 需要进行签署审核的签署人信息
+ */
+export interface NeedReviewApproverInfo {
+  /**
+   * 签署方经办人的类型，支持以下类型
+<ul><li> ORGANIZATION 企业（含企业自动签）</li>
+<li>PERSON 个人（含个人自动签）</li></ul>
+   */
+  ApproverType: string
+  /**
+   * 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
+   */
+  ApproverName: string
+  /**
+   * 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。
+   */
+  ApproverMobile?: string
+  /**
+   * 签署方经办人的证件类型，支持以下类型
+<ul><li>ID_CARD 居民身份证  (默认值)</li>
+<li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
+<li>OTHER_CARD_TYPE 其他证件</li></ul>
+
+注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
+   */
+  ApproverIdCardType?: string
+  /**
+   * 签署方经办人的证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
+   */
+  ApproverIdCardNumber?: string
+  /**
+   * 组织机构名称。
+请确认该名称与企业营业执照中注册的名称一致。
+如果名称中包含英文括号()，请使用中文括号（）代替。
+如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
+
+   */
+  OrganizationName?: string
+}
+
+/**
+ * CreateFlowGroupSignReview返回参数结构体
+ */
+export interface CreateFlowGroupSignReviewResponse {
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * CreateBatchSignUrl返回参数结构体
  */
@@ -2807,31 +2878,24 @@ export interface CreateFlowSignReviewRequest {
   Operator: UserInfo
   /**
    * 合同流程ID，为32位字符串。
-建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
-可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
+<ul><li>建议开发者妥善保存此流程ID，以便于顺利进行后续操作。</li>
+<li>可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。</li></ul>
    */
   FlowId: string
   /**
-   * 企业审核结果
-<ul><li>PASS: 通过</li> 
-<li>REJECT: 拒绝</li></ul>
+   * 企业内部审核结果
+<ul><li>PASS: 审核通过</li>
+<li>REJECT: 审核拒绝</li>
+<li>SIGN_REJECT:拒签(流程结束)</li></ul>
    */
   ReviewType: string
-  /**
-   * 审核结果原因，
-字符串长度不超过200
-当ReviewType 是拒绝（REJECT） 时此字段必填。
-
-   */
-  ReviewMessage?: string
   /**
    * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
    */
   Agent?: Agent
   /**
-   * 审核签署节点人标识，
-用来标识审核的签署方。
-如果签署审核节点是个人， 此参数必填。
+   * 审核节点的签署人标志，用于指定当前审核的签署方
+<ul><li>**如果签署审核节点是个人， 此参数必填**。</li></ul>
    */
   RecipientId?: string
   /**
@@ -2843,6 +2907,15 @@ export interface CreateFlowSignReviewRequest {
 如果审核节点是个人，则操作类型只能为SignReview。
    */
   OperateType?: string
+  /**
+   * 审核结果原因
+<ul><li>字符串长度不超过200</li>
+<li>当ReviewType 是拒绝（REJECT） 时此字段必填。</li>
+<li>当ReviewType 是拒绝（SIGN_REJECT） 时此字段必填。</li></ul>
+
+
+   */
+  ReviewMessage?: string
 }
 
 /**
@@ -3287,7 +3360,8 @@ FormField输入示例：
 }
 ```
 
-当控件的 ComponentType='ATTACHMENT'时，FormField.ComponentValue填入附件图片的资源ID列表，以逗号分隔，单个附件控件最多支持6个资源ID；
+当控件的 ComponentType='ATTACHMENT'时，FormField.ComponentValue支持填入附件图片或者文件的资源ID列表，以逗号分隔，单个附件控件最多支持6个资源ID；
+支持的文件类型包括doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt、pdf
 
 ```
 FormField输入示例：
@@ -6642,19 +6716,48 @@ export interface VerifyPdfResponse {
 }
 
 /**
- * 删除员工结果
+ * CreateFlowGroupSignReview请求参数结构体
  */
-export interface DeleteStaffsResult {
+export interface CreateFlowGroupSignReviewRequest {
   /**
-   * 删除员工的成功数据
-注意：此字段可能返回 null，表示取不到有效值。
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
-  SuccessEmployeeData: Array<SuccessDeleteStaffData>
+  Operator: UserInfo
   /**
-   * 删除员工的失败数据
-注意：此字段可能返回 null，表示取不到有效值。
+   * 合同(流程)组的合同组Id，为32位字符串，通过接口[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByFiles) 或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowGroupByTemplates)创建合同组签署流程时返回。
    */
-  FailedEmployeeData: Array<FailedDeleteStaffData>
+  FlowGroupId: string
+  /**
+   * 提交的审核结果，审核结果有下面三种情况
+<ul><li><b>PASS</b>: 审核通过，合同流程可以继续执行签署等操作</li>
+<li><b>REJECT</b>: 审核拒绝，合同流程不会变动</li>
+<li><b>SIGN_REJECT</b>:拒签，合同流程直接结束，合同状态变为**合同拒签**</li></ul>
+   */
+  ReviewType: string
+  /**
+   * 需要进行签署审核的签署人的个人信息或企业信息，签署方的匹配方式按照以下规则:
+
+个人：二选一（选择其中任意信息组合即可）
+<ul><li>姓名+证件类型+证件号</li>
+<li>姓名+手机号</li></ul>
+
+企业：二选一  （选择其中任意信息组合即可）
+<ul><li>企业名+姓名+证件类型+证件号</li>
+<li>企业名+姓名+手机号</li></ul>
+   */
+  ApproverInfo: NeedReviewApproverInfo
+  /**
+   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   */
+  Agent?: Agent
+  /**
+   * 审核不通过的原因，该字段的字符串长度不超过200个字符。
+
+注：`当审核类型（ReviewType）为审核拒绝（REJECT）或拒签（SIGN_REJECT）时，审核结果原因字段必须填写`
+
+   */
+  ReviewMessage?: string
 }
 
 /**

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

@@ -62,6 +62,8 @@ import {
   DownloadFlowInfo,
   FlowApproverUrlInfo,
   ChannelCreateWebThemeConfigRequest,
+  NeedReviewApproverInfo,
+  CreateFlowGroupSignReviewResponse,
   ChannelCreateConvertTaskApiRequest,
   ChannelCreateFlowByFilesRequest,
   UploadFilesResponse,
@@ -194,6 +196,7 @@ import {
   ChannelUpdateSealStatusRequest,
   ChannelCreateFlowGroupByTemplatesRequest,
   SignUrl,
+  CreateFlowGroupSignReviewRequest,
   ChannelBillUsageDetail,
   DescribeBillUsageDetailRequest,
   RelieveInfo,
@@ -245,11 +248,22 @@ export class Client extends AbstractClient {
   }
 
   /**
-     * 提交企业流程审批结果
-目前存在两种审核操作，签署审核，发起审核
-签署审核：通过接口（CreateFlowsByTemplates或ChannelCreateFlowByFiles或ChannelCreatePrepareFlow）发起签署流程后，若指定了参数 NeedSignReview 为true,则可以调用此接口，指定operate=SignReview，提交企业内部签署审批结果；若签署流程状态正常，且本企业存在签署方未签署，同一签署流程可以多次提交签署审批结果，签署时的最后一个“审批结果”有效
-
-发起审核：通过接口ChannelCreatePrepareFlow指定发起后需要审核，则可以通过调用此接口，指定operate=CreateReview，提交企业内部审批结果，可多次提交，当通过后，后续提交结果无效
+     * 提交企业流程审批结果 
+**当前存在两种审核操作：**
+<ul>
+<li>签署审核
+<ul>
+<li>在通过接口<ul><li>CreateFlowsByTemplates</li><li>ChannelCreateFlowByFiles</li><li>ChannelCreateFlowGroupByTemplates</li><li>ChannelCreateFlowGroupByFiles</li><li>ChannelCreatePrepareFlow</li></ul> 发起签署流程时，通过指定NeedSignReview为true，则可以调用此接口，并指定operate=SignReview，以提交企业内部签署审批结果</li>
+<li>在通过接口<ul><li>CreateFlowsByTemplates</li><li>ChannelCreateFlowByFiles</li><li>ChannelCreateFlowGroupByTemplates</li><li>ChannelCreateFlowGroupByFiles</li></ul>发起签署流程时，通过指定签署人ApproverNeedSignReview为true，则可以调用此接口，并指定operate=SignReview，并指定RecipientId，以提交企业内部签署审批结果</li>
+</ul>
+</li>
+<li>发起审核
+ <ul>
+<li>通过接口ChannelCreatePrepareFlow指定发起后需要审核，那么可以调用此接口，并指定operate=CreateReview，以提交企业内部审批结果。可以多次提交审批结果，但一旦审批通过，后续提交的结果将无效
+</li>
+</ul>
+</li>
+</ul>
      */
   async ChannelCreateFlowSignReview(
     req: ChannelCreateFlowSignReviewRequest,
@@ -1217,6 +1231,21 @@ Web链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表
     return this.request("DescribeResourceUrlsByFlows", req, cb)
   }
 
+  /**
+     * 1. 在使用[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles)或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时，若指定了参数以下参数为true,则可以调用此接口提交企业内部签署审批结果,即使是自动签署也需要进行审核通过才会进行签署。
+  - [FlowInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowinfo)
+  - [FlowFileInfo.NeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowfileinfo)
+  - [FlowApproverInfo.ApproverNeedSignReview](https://qian.tencent.com/developers/partnerApis/dataTypes/#flowapproverinfo) 
+
+2. 同一合同组，同一签署人可以多次提交签署审批结果，签署时的最后一个“审批结果”有效。
+     */
+  async CreateFlowGroupSignReview(
+    req: CreateFlowGroupSignReviewRequest,
+    cb?: (error: string, rep: CreateFlowGroupSignReviewResponse) => void
+  ): Promise<CreateFlowGroupSignReviewResponse> {
+    return this.request("CreateFlowGroupSignReview", req, cb)
+  }
+
   /**
      * 使用此接口，用来绑定企业实名员工的角色，
 支持以电子签userId、客户系统openId两种方式进行绑定。

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

@@ -564,31 +564,37 @@ export interface ChannelCreateFlowSignReviewRequest {
    */
   Agent: Agent
   /**
-   * 签署流程编号
+   * 合同流程ID，为32位字符串。
+<ul><li>建议开发者妥善保存此流程ID，以便于顺利进行后续操作。</li>
+<li>可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。</li></ul>
    */
   FlowId: string
   /**
    * 企业内部审核结果
-PASS: 通过
-REJECT: 拒绝
-SIGN_REJECT:拒签(流程结束)
+<ul><li>PASS: 审核通过</li>
+<li>REJECT: 审核拒绝</li>
+<li>SIGN_REJECT:拒签(流程结束)</li></ul>
    */
   ReviewType: string
   /**
-   * 审核原因 
-当ReviewType 是REJECT 时此字段必填,字符串长度不超过200
+   * 审核结果原因
+<ul><li>字符串长度不超过200</li>
+<li>当ReviewType 是拒绝（REJECT） 时此字段必填。</li>
+<li>当ReviewType 是拒绝（SIGN_REJECT） 时此字段必填。</li></ul>
    */
   ReviewMessage?: string
   /**
-   * 签署节点审核时需要指定，给个人审核时必填。
+   * 审核节点的签署人标志，用于指定当前审核的签署方
+<ul><li>**如果签署审核节点是个人， 此参数必填**。</li></ul>
    */
   RecipientId?: string
   /**
-   * 操作类型，默认：SignReview；SignReview:签署审核，CreateReview：发起审核
-注：接口通过该字段区分操作类型
-该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程
-若想使用发起审核，请指定该字段为：CreateReview
-若发起个人审核，则指定该字段为：SignReview
+   * 流程审核操作类型，取值如下：
+<ul><li>**SignReview**：（默认）签署审核</li>
+<li>**CreateReview**：发起审核</li>
+<li>注意：`该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程`</li></ul>
+
+
    */
   OperateType?: string
 }
@@ -1789,6 +1795,61 @@ export interface ChannelCreateWebThemeConfigRequest {
   WebThemeConfig: WebThemeConfig
 }
 
+/**
+ * 需要进行签署审核的签署人信息
+ */
+export interface NeedReviewApproverInfo {
+  /**
+   * 签署方经办人的类型，支持以下类型
+<ul><li> ORGANIZATION 企业（含企业自动签）</li>
+<li>PERSON 个人（含个人自动签）</li></ul>
+   */
+  ApproverType: string
+  /**
+   * 签署方经办人的姓名。 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
+   */
+  ApproverName: string
+  /**
+   * 签署方经办人手机号码， 支持国内手机号11位数字(无需加+86前缀或其他字符)。 请确认手机号所有方为此合同签署方。
+   */
+  ApproverMobile?: string
+  /**
+   * 签署方经办人的证件类型，支持以下类型
+<ul><li>ID_CARD 居民身份证  (默认值)</li>
+<li>HONGKONG_AND_MACAO 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)</li>
+<li>OTHER_CARD_TYPE 其他证件</li></ul>
+
+注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
+   */
+  ApproverIdCardType?: string
+  /**
+   * 签署方经办人的证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
+   */
+  ApproverIdCardNumber?: string
+  /**
+   * 组织机构名称。
+请确认该名称与企业营业执照中注册的名称一致。
+如果名称中包含英文括号()，请使用中文括号（）代替。
+如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
+
+   */
+  OrganizationName?: string
+}
+
+/**
+ * CreateFlowGroupSignReview返回参数结构体
+ */
+export interface CreateFlowGroupSignReviewResponse {
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * ChannelCreateConvertTaskApi请求参数结构体
  */
@@ -2474,7 +2535,7 @@ export interface TemplateInfo {
    */
   IsPromoter?: boolean
   /**
-   * 模板的创建者信息，电子签系统用户ID
+   * 模板的创建者名字
    */
   Creator?: string
   /**
@@ -3436,7 +3497,7 @@ export interface CommonFlowApprover {
    */
   NotifyType?: string
   /**
-   * 签署人配置
+   * 签署人配置，用于控制签署人相关属性
    */
   ApproverOption?: CommonApproverOption
   /**
@@ -4848,7 +4909,14 @@ export interface FlowApproverInfo {
    */
   ApproverOption?: ApproverOption
   /**
-   * 当前签署方进行签署操作是否需要企业内部审批，true 则为需要
+   * 发起方企业的签署人进行签署操作前，是否需要企业内部走审批流程，取值如下：
+<ul><li>**false**：（默认）不需要审批，直接签署。</li>
+<li>**true**：需要走审批流程。当到对应参与人签署时，会阻塞其签署操作，等待企业内部审批完成。</li></ul>
+企业可以通过ChannelCreateFlowSignReview审批接口通知腾讯电子签平台企业内部审批结果
+<ul><li>如果企业通知腾讯电子签平台审核通过，签署方可继续签署动作。</li>
+<li>如果企业通知腾讯电子签平台审核未通过，平台将继续阻塞签署方的签署动作，直到企业通知平台审核通过。</li></ul>
+
+注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
    */
   ApproverNeedSignReview?: boolean
   /**
@@ -6540,6 +6608,54 @@ export interface SignUrl {
   HttpSignUrl?: string
 }
 
+/**
+ * CreateFlowGroupSignReview请求参数结构体
+ */
+export interface CreateFlowGroupSignReviewRequest {
+  /**
+   * 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+</ul>
+第三方平台子客企业和员工必须已经经过实名认证
+   */
+  Agent: Agent
+  /**
+   *   合同(流程)组的合同组Id，为32位字符串，通过接口[通过多文件创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles) 或[通过多模板创建合同组签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates)创建合同组签署流程时返回。
+   */
+  FlowGroupId: string
+  /**
+   * 提交的审核结果，审核结果有下面三种情况
+<ul><li><b>PASS</b>: 审核通过，合同流程可以继续执行签署等操作</li>
+<li><b>REJECT</b>: 审核拒绝，合同流程不会变动</li>
+<li><b>SIGN_REJECT</b>:拒签，合同流程直接结束，合同状态变为**合同拒签**</li></ul>
+   */
+  ReviewType: string
+  /**
+   * 需要进行签署审核的签署人的个人信息或企业信息，签署方的匹配方式按照以下规则:
+
+个人：二选一（选择其中任意信息组合即可）
+<ul><li>姓名+证件类型+证件号</li>
+<li>姓名+手机号</li></ul>
+
+企业：二选一  （选择其中任意信息组合即可）
+<ul><li>企业名+姓名+证件类型+证件号</li>
+<li>企业名+姓名+手机号</li></ul>
+   */
+  ApproverInfo: NeedReviewApproverInfo
+  /**
+   * 审核不通过的原因，该字段的字符串长度不超过200个字符。
+
+注：`当审核类型（ReviewType）为审核拒绝（REJECT）或拒签（SIGN_REJECT）时，审核结果原因字段必须填写`
+
+   */
+  ReviewMessage?: string
+}
+
 /**
  * 用户计费使用情况详情
  */

package/src/services/faceid/v20180301/faceid_models.ts

@@ -188,7 +188,7 @@ export interface IntentionQuestionResult {
 -301: "意愿核验不通过"   
 -800: "前端不兼容错误"    
 -801: "用户未授权摄像头和麦克风权限"   
--802: "获取视频流失败"   
+-802: "核验流程异常中断，请勿切屏或进行其他操作"   
 -803: "用户主动关闭链接/异常断开链接"   
 -998: "系统数据异常"   
 -999: "系统未知错误，请联系人工核实"   
@@ -204,34 +204,34 @@ export interface IntentionQuestionResult {
    * 视频base64（其中包含全程问题和回答音频，mp4格式）
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Video: string
+  Video?: string
   /**
    * 屏幕截图base64列表
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  ScreenShot: Array<string>
+  ScreenShot?: Array<string>
   /**
    * 和答案匹配结果列表
 0：成功，-1：不匹配
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  ResultCode: Array<string>
+  ResultCode?: Array<string>
   /**
    * 回答问题语音识别结果列表
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  AsrResult: Array<string>
+  AsrResult?: Array<string>
   /**
    * 答案录音音频
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Audios: Array<string>
+  Audios?: Array<string>
   /**
    * 意愿核身最终结果：
 0：认证通过，-1：认证未通过，-2：浏览器内核不兼容，无法进行意愿校验。建议使用“FinalResultDetailCode”参数获取详细的错误码信息。
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  FinalResultCode: string
+  FinalResultCode?: string
 }
 
 /**
@@ -2525,7 +2525,7 @@ export interface IntentionActionResult {
 -301: "意愿核验不通过"   
 -800: "前端不兼容错误"    
 -801: "用户未授权摄像头和麦克风权限"   
--802: "获取视频流失败"   
+-802: "核验流程异常中断，请勿切屏或进行其他操作"   
 -803: "用户主动关闭链接/异常断开链接"   
 -998: "系统数据异常"   
 -999: "系统未知错误，请联系人工核实"