tencentcloud-sdk-nodejs 4.0.684 → 4.0.686

package/src/services/clb/v20180317/clb_models.ts

@@ -225,7 +225,7 @@ OPEN：公网属性， INTERNAL：内网属性。
    */
   InternetAccessible?: InternetAccessible
   /**
-   * 仅适用于公网负载均衡。CMCC | CTCC | CUCC，分别对应 移动 | 电信 | 联通，如果不指定本参数，则默认使用BGP。可通过 [DescribeResources](https://cloud.tencent.com/document/api/214/70213)  接口查询一个地域所支持的Isp。如果指定运营商，则网络计费模式只能使用按带宽包计费(BANDWIDTH_PACKAGE)。
+   * 仅适用于公网负载均衡。目前仅广州、上海、南京、济南、杭州、福州、北京、石家庄、武汉、长沙、成都、重庆地域支持静态单线 IP 线路类型，如需体验，请联系商务经理申请。申请通过后，即可选择中国移动（CMCC）、中国联通（CUCC）或中国电信（CTCC）的运营商类型，网络计费模式只能使用按带宽包计费(BANDWIDTH_PACKAGE)。 如果不指定本参数，则默认使用BGP。可通过 [DescribeResources](https://cloud.tencent.com/document/api/214/70213)  接口查询一个地域所支持的Isp。
    */
   VipIsp?: string
   /**

package/src/services/csip/v20221121/csip_models.ts

@@ -670,6 +670,11 @@ export interface DomainAssetVO {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   VerifyStatus?: number
+  /**
+   * bot访问数据
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  BotAccessCount?: number
 }
 
 /**

package/src/services/dnspod/v20210323/dnspod_models.ts

@@ -2833,7 +2833,7 @@ export interface ModifyRecordBatchDetail {
  */
 export interface DescribeUserDetailResponse {
   /**
-   * 帐户信息
+   * 账户信息
    */
   UserInfo?: UserInfo
   /**

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

@@ -75,6 +75,7 @@ import {
   BindEmployeeUserIdWithClientOpenIdRequest,
   DescribeIntegrationDepartmentsRequest,
   Permission,
+  ComponentLimit,
   CreateIntegrationDepartmentResponse,
   DescribeFlowTemplatesRequest,
   DeleteSealPoliciesResponse,
@@ -553,14 +554,16 @@ export class Client extends AbstractClient {
   }
 
   /**
-     * 发起解除协议，主要应用场景为：基于一份已经签署的合同(签署流程)，进行解除操作。
-
-`注意：原合同必须签署完成后，才能发起解除协议。` <br/>
-`注意：只有原合同企业类型的参与人才能发起解除协议，个人不能发起解除协议。`<br/>
-`注意：原合同个人类型参与人必须是解除协议的参与人，不能更换其他第三方个人参与解除协议。`<br/>
-`注意：如果原合同企业参与人无法参与解除协议，可以指定同企业具有同等权限的企业员工代为处理。`<br/>
-`注意：发起解除协议同发起其他企业合同一样，也会参与合同扣费，扣费标准同其他类型合同。`<br/>
-`注意：在解除协议发起之后，原合同的状态将转变为解除中。一旦解除协议签署完毕，原合同及解除协议均会转变为已解除状态。`<br/>
+     * 发起解除协议的主要应用场景为：基于一份已经签署的合同（签署流程），进行解除操作。
+解除协议的模板是官方提供 ，经过提供法务审核，暂不支持自定义。
+
+注意：
+<ul><li><code>原合同必须签署完</code>成后才能发起解除协议。</li>
+<li>只有原合同企业类型的参与人才能发起解除协议，<code>个人参与方不能发起解除协议</code>。</li>
+<li>原合同个人类型参与人必须是解除协议的参与人，<code>不能更换其他第三方个人</code>参与解除协议。</li>
+<li>如果原合同企业参与人无法参与解除协议，可以指定同企业具有同等权限的<code>企业员工代为处理</code>。</li>
+<li>发起解除协议同发起其他企业合同一样，也会参与合同<code>扣费</code>，扣费标准同其他类型合同。</li>
+<li>在解除协议发起之后，原合同的状态将转变为解除中。一旦解除协议签署完毕，原合同及解除协议均变为已解除状态。</li></ul>
      */
   async CreateReleaseFlow(
     req: CreateReleaseFlowRequest,
@@ -728,10 +731,12 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
   /**
      * 该接口用于发起合同后，生成个人用户的签署链接, 暂时不支持企业端签署 <br/>
 
-注：
-`1. 该接口目前仅支持签署人类型是个人签署方的场景（PERSON）` 
-`2. 该接口可生成签署链接的C端签署人必须仅有手写签名和时间类型的签署控件，不支持填写控件 `
-`3. 该接口返回的签署链接是用于APP集成的场景，支持APP打开或浏览器直接打开，不支持微信小程序嵌入`。跳转到小程序的实现，参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
+`注意：`<br/>
+`1. 该接口目前仅支持签署人类型是个人签署方的场景（PERSON）。` <br/>
+`2. 该接口可生成签署链接的C端签署人必须仅有手写签名和时间类型的签署控件，不支持填写控件 。` <br/>
+`3. 该签署链接有效期为30分钟，过期后将失效，如需签署可重新创建签署链接 。` <br/>
+`4. 该接口返回的签署链接是用于APP集成的场景，支持APP打开或浏览器直接打开，不支持微信小程序嵌入`。<br/>
+跳转到小程序的实现，参考微信官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
      */
   async CreateFlowSignUrl(
     req: CreateFlowSignUrlRequest,
@@ -741,8 +746,14 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
   }
 
   /**
-   * 本接口（CreatePersonAuthCertificateImage）用于创建个人用户证书证明图片
-   */
+     * 获取个人用户认证证书图片下载URL
+
+个人用户认证证书图片样式如下图
+
+![image](https://dyn.ess.tencent.cn/guide/capi/CreatePersonAuthCertificateImage.png)
+
+注:  `只能获取个人用户证明图片, 企业员工的暂不支持`
+     */
   async CreatePersonAuthCertificateImage(
     req: CreatePersonAuthCertificateImageRequest,
     cb?: (error: string, rep: CreatePersonAuthCertificateImageResponse) => void
@@ -757,7 +768,7 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
 适用场景2：已经上传了一个jpg图片文件，希望将该图片文件转换成pdf文件后发起合同<br />
 转换文件是一个耗时操作，若想查看转换任务是否完成，可以通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/GetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
 注: 
-1. `支持的文件类型有doc\docx\xls\xlsx\jpg\jpeg\png\bmp\txt`
+1. `支持的文件类型有doc、docx、xls、xlsx、jpg、jpeg、png、bmp、txt`
 2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
      */
   async CreateConvertTaskApi(
@@ -770,7 +781,8 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
   /**
      * 查询流程基础信息
 适用场景：可用于主动查询某个合同流程的签署状态信息。可以配合回调通知使用。
-每个企业限制日调用量限制：100W，当日超过此限制后再调用接口返回错误
+
+注: `每个企业限制日调用量限制：100W，当日超过此限制后再调用接口返回错误`
      */
   async DescribeFlowBriefs(
     req: DescribeFlowBriefsRequest,
@@ -868,8 +880,15 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
   }
 
   /**
-   * 通过AuthCode查询用户是否实名
-   */
+     * 通过AuthCode查询个人用户是否实名
+
+
+注意: 
+<ul>
+<li>此接口为合作引流场景使用，使用`有白名单限制`，使用前请联系对接的客户经理沟通。</li>
+<li>`AuthCode 只能使用一次`，查询一次再次查询会返回错误</li>
+</ul>
+     */
   async DescribeThirdPartyAuthCode(
     req: DescribeThirdPartyAuthCodeRequest,
     cb?: (error: string, rep: DescribeThirdPartyAuthCodeResponse) => void

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

@@ -406,7 +406,10 @@ export interface ReviewerInfo {
  */
 export interface DescribeThirdPartyAuthCodeResponse {
   /**
-   * 用户是否实名，VERIFIED 为实名，UNVERIFIED 未实名
+   * AuthCode 中对应个人用户是否实名
+<ul>
+<li> **VERIFIED** : 此个人已实名</li>
+<li> **UNVERIFIED**: 此个人未实名</li></ul>
    */
   VerifyStatus?: string
   /**
@@ -587,7 +590,10 @@ export interface ReleasedApprover {
    */
   ApproverSignComponentType?: string
   /**
-   * 参与方在合同中的角色是按照创建合同的时候来排序的; 解除协议默认会将第一个参与人叫甲方, 第二个叫乙方,第三个叫丙方，以此类推。如果您需要改动参与人的角色名字, 可以设置此签署方自定义控件别名字段，最大20个字。
+   * 参与方在合同中的角色是按照创建合同的时候来排序的，解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`,  第三个叫`丙方`，以此类推。
+
+如果需改动此参与人的角色名字，可用此字段指定，由汉字,英文字符,数字组成，最大20个字。
+
    */
   ApproverSignRole?: string
 }
@@ -1235,7 +1241,9 @@ export interface DescribeIntegrationEmployeesRequest {
    */
   Agent?: Agent
   /**
-   * 查询过滤实名用户，Key为Status，Values为["IsVerified"]
+   * 查询过滤实名用户，Key为Status，Values为["IsVerified"]，查询过滤未实名用户，Key为Status，Values为["NotVerified"]
+查询某个部门的用户，Key为DepartmentId，Values为["DepartmentId"]
+根据用户Id查询员工时，Key为UserId，Values为["UserId"]
 根据第三方系统openId过滤查询员工时,Key为StaffOpenId,Values为["OpenId","OpenId",...]
    */
   Filters?: Array<Filter>
@@ -1511,7 +1519,7 @@ export interface AutoSignConfig {
 <li>**TELECOM** : 运营商三要素验证</li></ul>
 注：
 <ul><li>如果是小程序开通链接，支持传 WEIXINAPP / TELECOM。为空默认 WEIXINAPP</li>
-<li>如果是 H5 开通链接，支持传 INSIGHT / TELECOM。为空默认 INSIGHT </li>
+<li>如果是 H5 开通链接，支持传 INSIGHT / TELECOM。为空默认 INSIGHT </li></ul>
    */
   VerifyChannels?: Array<string>
   /**
@@ -1529,15 +1537,17 @@ export interface AutoSignConfig {
  */
 export interface DescribeThirdPartyAuthCodeRequest {
   /**
-   * 电子签小程序跳转客户小程序时携带的授权查看码
+   * 腾讯电子签小程序跳转客户企业小程序时携带的授权查看码，AuthCode由腾讯电子签小程序生成。
    */
   AuthCode: string
   /**
-   * 操作人信息
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator?: UserInfo
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }
@@ -1689,6 +1699,35 @@ export interface Permission {
   Children?: Array<Permission>
 }
 
+/**
+ * 签署控件的类型和范围限制条件，用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。
+ */
+export interface ComponentLimit {
+  /**
+   * 控件类型，支持以下类型
+<ul><li>SIGN_SEAL : 印章控件</li>
+<li>SIGN_PAGING_SEAL : 骑缝章控件</li>
+<li>SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件</li>
+<li>SIGN_SIGNATURE : 用户签名控件</li></ul>
+   */
+  ComponentType: string
+  /**
+   * 签署控件类型的值(可选)，用与限制签署时印章或者签名的选择范围
+
+1.当ComponentType 是 SIGN_SEAL 或者 SIGN_PAGING_SEAL 时可传入企业印章Id（支持多个）
+
+2.当ComponentType 是 SIGN_SIGNATURE 时可传入以下类型（支持多个）
+
+<ul><li>HANDWRITE : 手写签名</li>
+<li>OCR_ESIGN : OCR印章（智慧手写签名）</li>
+<li>ESIGN : 个人印章</li>
+<li>SYSTEM_ESIGN : 系统印章</li></ul>
+
+3.当ComponentType 是 SIGN_LEGAL_PERSON_SEAL 时无需传递此参数。
+   */
+  ComponentValue?: Array<string>
+}
+
 /**
  * CreateIntegrationDepartment返回参数结构体
  */
@@ -1926,26 +1965,33 @@ export interface OccupiedSeal {
  */
 export interface CreatePersonAuthCertificateImageResponse {
   /**
-   * 个人用户证明证书的下载链接
+   * 个人用户认证证书图片下载URL，`有效期为5分钟`，超过有效期后将无法再下载。
    */
   AuthCertUrl?: string
   /**
-   * 证书图片上的证书编号，20位数字
+   * 个人用户认证证书的编号, 为20位数字组成的字符串,  由腾讯电子签下发此编号 。
+该编号会合成到个人用户证书证明图片。
+
+注: `个人用户认证证书的编号和证明图片绑定, 获取新的证明图片编号会变动`
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ImageCertId?: string
   /**
-   * 图片证明对应的CA证书序列号
+   * CA供应商下发给用户的证书编号，在证书到期后自动续期后此证书编号会发生变动，且不会合成到个人用户证书证明图片中。
+
+注意：`腾讯电子签接入多家CA供应商以提供容灾能力，不同CA下发的证书编号区别较大，但基本都是由数字和字母组成，长度在200以下。`
 注意：此字段可能返回 null，表示取不到有效值。
    */
   SerialNumber?: string
   /**
-   * CA证书颁发时间戳
+   * CA证书颁发时间，格式为Unix标准时间戳（秒）   
+该时间格式化后会合成到个人用户证书证明图片
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ValidFrom?: number
   /**
-   * CA证书有效截止时间戳
+   * CA证书有效截止时间，格式为Unix标准时间戳（秒）
+该时间格式化后会合成到个人用户证书证明图片
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ValidTo?: number
@@ -3816,7 +3862,7 @@ export interface CreateReleaseFlowRequest {
    */
   NeedRelievedFlowId: string
   /**
-   * 解除协议内容。
+   * 解除协议内容, 包括解除理由等信息。
    */
   ReliveInfo: RelieveInfo
   /**
@@ -3824,12 +3870,12 @@ export interface CreateReleaseFlowRequest {
    */
   Agent?: Agent
   /**
-   * 解除协议的签署人列表(如不指定该参数，默认使用原流程的签署人列表)。 <br/>
-如需更换原合同中的签署人，可通过指定该签署人的RecipientId编号更换此签署人。(可通过接口<a href="https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo/">DescribeFlowInfo</a>查询签署人的RecipientId编号)<br/>
-解除协议的签署人数量不能多于原流程的签署人数量。<br/>
+   * 替换解除协议的签署人， 如不指定替换签署人,  则使用原流程的签署人。 <br/>
+如需更换原合同中的企业端签署人，可通过指定该签署人的RecipientId编号更换此企业端签署人。(可通过接口<a href="https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo/">DescribeFlowInfo</a>查询签署人的RecipientId编号)<br/>
 
-`注意：只能更换同企业的签署人。`<br/>
-`注意：不支持更换个人类型的签署人。`<br/>
+注意：
+`只能更换自己企业的签署人,  不支持更换个人类型或者其他企业的签署人。`
+`可以不指定替换签署人, 使用原流程的签署人 `
    */
   ReleasedApprovers?: Array<ReleasedApprover>
   /**
@@ -3910,7 +3956,8 @@ export interface SuccessUpdateStaffData {
  */
 export interface CreatePersonAuthCertificateImageRequest {
   /**
-   * 操作人信息
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
@@ -3918,20 +3965,24 @@ export interface CreatePersonAuthCertificateImageRequest {
    */
   UserName: string
   /**
-   * 身份证件类型取值：
-ID_CARD 身居民身份证
-PASSPORT 护照
-HONGKONG_AND_MACAO 港澳居民来往内地通行证
-FOREIGN_ID_CARD 外国人永久居留身份证
-HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证(格式同居民身份证)
+   * 证件类型，支持以下类型
+<ul><li> ID_CARD  : 居民身份证 (默认值)</li>
+<li> PASSPORT  : 护照</li>
+<li> FOREIGN_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
   /**
-   * 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }
@@ -4242,6 +4293,12 @@ export interface ApproverInfo {
 注：`此功能可用于与企业内部的审批流程进行关联，支持手动、静默签署合同`
    */
   ApproverNeedSignReview?: boolean
+  /**
+   * [用PDF文件创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlowByFiles)时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID）或签名方式。
+
+注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
+   */
+  AddSignComponentsLimits?: Array<ComponentLimit>
 }
 
 /**
@@ -4343,7 +4400,7 @@ export interface CreateUserAutoSignEnableUrlRequest {
   /**
    * 生成的链接类型：
 <ul><li> 不传(即为空值) 则会生成小程序端开通链接(默认)</li>
-<li> **H5SIGN** : 生成H5端开通链接</li><ul>
+<li> **H5SIGN** : 生成H5端开通链接</li></ul>
    */
   UrlType?: string
   /**
@@ -5487,15 +5544,20 @@ export interface UpdateIntegrationEmployeesRequest {
  */
 export interface DescribeFlowBriefsRequest {
   /**
-   * 调用方用户信息，userId 必填
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator: UserInfo
   /**
-   * 需要查询的流程ID列表，限制最大100个
+   * 查询的合同流程ID列表最多支持100个流程ID。 
+如果某个合同流程ID不存在，系统会跳过此ID的查询，继续查询剩余存在的合同流程。
+
+可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
    */
   FlowIds: Array<string>
   /**
-   * 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+   * 代理企业和员工的信息。
+在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
    */
   Agent?: Agent
 }
@@ -5590,7 +5652,8 @@ export interface DeleteStaffsResult {
  */
 export interface DescribeFlowBriefsResponse {
   /**
-   * 流程列表
+   * 合同流程基础信息列表，包含流程的名称、状态、创建日期等基本信息。 
+注：`与入参 FlowIds 的顺序可能存在不一致的情况。`
    */
   FlowBriefs?: Array<FlowBrief>
   /**
@@ -5744,27 +5807,24 @@ DISABLE：未开通
  */
 export interface RelieveInfo {
   /**
-   * 解除理由，最大支持200个字
+   * 解除理由，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
    */
   Reason: string
   /**
-   * 解除后仍然有效的条款，保留条款，最大支持200个字
+   * 解除后仍然有效的条款，保留条款，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
 
    */
   RemainInForceItem?: string
   /**
-   * 原合同事项处理-费用结算，最大支持200个字
-
+   * 原合同事项处理-费用结算，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
    */
   OriginalExpenseSettlement?: string
   /**
-   * 原合同事项处理-其他事项，最大支持200个字
-
+   * 原合同事项处理-其他事项，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
    */
   OriginalOtherSettlement?: string
   /**
-   * 其他约定，最大支持200个字
-
+   * 其他约定，长度不能超过200，只能由中文、字母、数字、中文标点和英文标点组成(不支持表情)。
    */
   OtherDeals?: string
 }

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

@@ -76,6 +76,7 @@ import {
   ChannelVerifyPdfRequest,
   CreateChannelFlowEvidenceReportRequest,
   ChannelCancelUserAutoSignEnableUrlRequest,
+  ComponentLimit,
   ChannelVerifyPdfResponse,
   CreateConsoleLoginUrlRequest,
   OrganizationInfo,

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

@@ -326,6 +326,16 @@ UpperRight-右下角。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Placeholder?: string
+  /**
+   * 是否锁定控件值不允许编辑（嵌入式发起使用） <br/>默认false：不锁定控件值，允许在页面编辑控件值	
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  LockComponentValue?: boolean
+  /**
+   * 是否禁止移动和删除控件 <br/>默认false，不禁止移动和删除控件	
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ForbidMoveAndDelete?: boolean
 }
 
 /**
@@ -1874,6 +1884,35 @@ export interface ChannelCancelUserAutoSignEnableUrlRequest {
   UserInfo: UserThreeFactor
 }
 
+/**
+ * 签署控件的类型和范围限制条件，用于控制文件发起后签署人拖拽签署区时可使用的控件类型和具体的印章或签名方式。
+ */
+export interface ComponentLimit {
+  /**
+   * 控件类型，支持以下类型
+<ul><li>SIGN_SEAL : 印章控件</li>
+<li>SIGN_PAGING_SEAL : 骑缝章控件</li>
+<li>SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件</li>
+<li>SIGN_SIGNATURE : 用户签名控件</li></ul>
+   */
+  ComponentType: string
+  /**
+   * 签署控件类型的值(可选)，用与限制签署时印章或者签名的选择范围
+
+1.当ComponentType 是 SIGN_SEAL 或者 SIGN_PAGING_SEAL 时可传入企业印章Id（支持多个）
+
+2.当ComponentType 是 SIGN_SIGNATURE 时可传入以下类型（支持多个）
+
+<ul><li>HANDWRITE : 手写签名</li>
+<li>OCR_ESIGN : OCR印章（智慧手写签名）</li>
+<li>ESIGN : 个人印章</li>
+<li>SYSTEM_ESIGN : 系统印章</li></ul>
+
+3.当ComponentType 是 SIGN_LEGAL_PERSON_SEAL 时无需传递此参数。
+   */
+  ComponentValue?: Array<string>
+}
+
 /**
  * ChannelVerifyPdf返回参数结构体
  */
@@ -2139,7 +2178,6 @@ export interface CommonFlowApprover {
   IsFullText?: boolean
   /**
    * 通知类型：SMS（短信） NONE（不做通知）, 不传 默认SMS
-   * @deprecated
    */
   NotifyType?: string
   /**
@@ -2150,6 +2188,14 @@ export interface CommonFlowApprover {
    * 签署控件：文件发起使用
    */
   SignComponents?: Array<Component>
+  /**
+   * 签署人查看合同时认证方式, 1-实名查看 2-短信验证码查看(企业签署方不支持该方式) 如果不传默认为1 查看合同的认证方式 Flow层级的优先于approver层级的 （当手写签名方式为OCR_ESIGN时，合同认证方式2无效，因为这种签名方式依赖实名认证）
+   */
+  ApproverVerifyTypes?: Array<number | bigint>
+  /**
+   * 签署人签署合同时的认证方式 1-人脸认证 2-签署密码 3-运营商三要素(默认为1,2)
+   */
+  ApproverSignTypes?: Array<number | bigint>
 }
 
 /**
@@ -3115,6 +3161,12 @@ ENTERPRISESERVER-企业静默签（文件发起时的企业静默签字）。
 默认为SMS(签署方为子客时该字段不生效)
    */
   NotifyType?: string
+  /**
+   * [通过文件创建签署流程](https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles)时,如果设置了外层参数SignBeanTag=1(允许签署过程中添加签署控件),则可通过此参数明确规定合同所使用的签署控件类型（骑缝章、普通章法人章等）和具体的印章（印章ID）或签名方式。
+
+注：`限制印章控件或骑缝章控件情况下,仅本企业签署方可以指定具体印章（通过传递ComponentValue,支持多个），他方企业或个人只支持限制控件类型。`
+   */
+  AddSignComponentsLimits?: Array<ComponentLimit>
 }
 
 /**

package/src/services/iai/v20180301/iai_client.ts

@@ -440,8 +440,6 @@ export class Client extends AbstractClient {
 
 >     
 - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
-
-
      */
   async DetectFace(
     req: DetectFaceRequest,

package/src/services/iai/v20180301/iai_models.ts

@@ -232,31 +232,31 @@ export interface CreateFaceResponse {
   /**
    * 加入成功的人脸数量
    */
-  SucFaceNum: number
+  SucFaceNum?: number
   /**
    * 加入成功的人脸ID列表
    */
-  SucFaceIds: Array<string>
+  SucFaceIds?: Array<string>
   /**
    * 每张人脸图片添加结果，-1101 代表未检测到人脸，-1102 代表图片解码失败， 
 -1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。 
 其他非 0 值代表算法服务异常。 
 RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
    */
-  RetCode: Array<number | bigint>
+  RetCode?: Array<number | bigint>
   /**
    * 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。 
 例， Urls 中 有 3 个 url，第二个 url 失败，则 SucIndexes 值为 [0,2] 。
    */
-  SucIndexes: Array<number | bigint>
+  SucIndexes?: Array<number | bigint>
   /**
    * 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
    */
-  SucFaceRects: Array<FaceRect>
+  SucFaceRects?: Array<FaceRect>
   /**
    * 人脸识别所用的算法模型版本。
    */
-  FaceModelVersion: string
+  FaceModelVersion?: string
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -626,15 +626,15 @@ export interface SearchFacesResponse {
   /**
    * 识别结果。
    */
-  Results: Array<Result>
+  Results?: Array<Result>
   /**
    * 搜索的人员库中包含的人脸数。
    */
-  FaceNum: number
+  FaceNum?: number
   /**
    * 人脸识别所用的算法模型版本。
    */
-  FaceModelVersion: string
+  FaceModelVersion?: string
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -2276,27 +2276,23 @@ export interface DetectFaceResponse {
   /**
    * 请求的图片宽度。
    */
-  ImageWidth: number
+  ImageWidth?: number
   /**
    * 请求的图片高度。
    */
-  ImageHeight: number
+  ImageHeight?: number
   /**
    * 人脸信息列表。包含人脸坐标信息、属性信息（若需要）、质量分信息（若需要）。
    */
-  FaceInfos: Array<FaceInfo>
+  FaceInfos?: Array<FaceInfo>
   /**
    * 人脸识别服务所用的算法模型版本。
-
 目前入参支持 “2.0”和“3.0“ 两个输入。
-
 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
-
 2020年11月26日后开通服务的账号仅支持输入“3.0”。
-
 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
    */
-  FaceModelVersion: string
+  FaceModelVersion?: string
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */

package/src/services/iai/v20200303/iai_models.ts

@@ -2058,13 +2058,9 @@ Url、Image必须提供一个，如果都提供，只使用 Url。
   NeedQualityDetection?: number
   /**
    * 人脸识别服务所用的算法模型版本。
-
 目前入参支持 “2.0”和“3.0“ 两个输入。
-
 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
-
 2020年11月26日后开通服务的账号仅支持输入“3.0”。
-
 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
    */
   FaceModelVersion?: string
@@ -2234,7 +2230,7 @@ export interface GetGroupInfoResponse {
    */
   FaceModelVersion?: string
   /**
-   * Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
+   * Group的创建时间和日期。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
    */
   CreationTimestamp?: number
   /**