tencentcloud-sdk-nodejs-essbasic 4.1.268 → 4.1.269

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs-essbasic",
-  "version": "4.1.268",
+  "version": "4.1.269",
   "description": "腾讯云 API NODEJS SDK",
   "main": "./tencentcloud/index.js",
   "module": "./es/index.js",

package/tencentcloud/services/essbasic/v20210526/essbasic_client.d.ts

@@ -153,41 +153,47 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     ChannelCreateBoundFlows(req: ChannelCreateBoundFlowsRequest, cb?: (error: string, rep: ChannelCreateBoundFlowsResponse) => void): Promise<ChannelCreateBoundFlowsResponse>;
     /**
-       * 本接口用于企业在已完成工商变更登记后，在电子签侧同步更新企业基础信息，并上传最新的营业执照或相关证照图片作为变更凭证。
-  ⚠️ 重要说明
-  本接口不做营业执照 OCR 识别：系统不会对上传的营业执照图片进行内容识别。调用方需自行把工商变更后的最新信息，通过 organization_name / legal_name / address 等字段显式传入；营业执照图片仅作为变更凭证上传与留存。
-  只传"变了"的字段即可：各信息字段均为"变更后的新值"，未变更的字段留空不传，系统会自动沿用电子签侧当前值（含统一社会信用代码）。四项信息（企业名称、法人姓名、地址、新法人手机号）至少需传入其一。
-  受理请求后，接口会依次完成以下处理：
-  操作人身份校验：调用方（operator.user_id）必须是该企业的法定代表人或超级管理员，否则返回无权限错误。
-  营业执照校验：校验 biz_license_resource_id 对应的图片资源归属（须属于当前企业/应用），仅作凭证存储，不做 OCR。
-  工商信息比对：将传入的新值（已传的字段）与电子签侧现有数据比对，确认确实存在变更内容；若与现状完全一致，则返回「企业信息未变更」。
-  未完结合同检查：仅当企业名称发生变更时，才检查该企业在 SaaS 与渠道子客下是否存在尚未完成的签署合同（白名单企业豁免）；若存在未完结合同则拦截并提示先处理合同。
-  工商三要素核验与变更执行：对企业名称、法人、统一社会信用代码进行工商三要素核验（每日最多 10 次）。核验通过则直接执行信息变更；核验不通过则转入收录审核流程，待审核通过后生效。
-  
-  收录申请触发的场景
-  本接口在工商信息变更时，会用**「新企业名称 + 统一社会信用代码(USCC) + 新法定代表人姓名」三要素与工商登记信息做校验，以此决定是直接执行变更还是提交收录申请（人工审核）**。
-  统一社会信用代码不可变更：系统自动取企业当前在库的 USCC 参与校验，不接受入参修改。
-  企业名称 / 法定代表人姓名取您本次传入的新值（未传则沿用当前值）。
-  
-  <p>
-    当工商三要素校验未通过时，接口不会直接修改企业信息，而是<strong>提交收录申请进入人工审核</strong>。具体触发场景如下：
-  </p>
-  <table>
-    <tr>
-      <th>触发场景</th>
-      <th>说明</th>
-    </tr>
-    <tr>
-      <td>三要素与工商登记不一致</td>
-      <td>传入的<strong>新企业名称</strong>或<strong>新法人姓名</strong>，与当前统一社会信用代码（USCC）在工商登记中的记录不匹配</td>
-    </tr>
-    <tr>
-      <td>工商库企业状态异常</td>
-      <td>依据当前 USCC 在工商库中查到的企业状态非正常（如查无此企业、已注销、已吊销等）</td>
-    </tr>
-  </table>
+       * 本接口用于企业完成工商变更登记后，**在电子签侧同步更新企业基础信息**，并上传最新的营业执照作为变更凭证。
+  
+  >  **调用权限**：仅限企业**超级管理员**或**法人**有权调用（即 `Agent.ProxyOperator.OpenId` 必须传入超管或法人的 OpenId）。
+  
+  
+  * **不会OCR**：系统**不会**自动识别营业执照图片。变更后的新信息（企业名称、法人、地址、类型）必须通过对应字段（`OrganizationName` / `LegalName` 等）显式传入。
+  * **增量更新（只传变了的）**：仅传入**已变更**的字段新值，未变更的字段留空，系统会自动沿用电子签侧的当前值。若无任何字段变更，请勿调用此接口。
+  * **未完结合同限制**：若**企业名称**发生变更，系统会拦截检查是否存在全平台（同名的saas自建企业和子客企业）未完结的签署合同（针对白名单企业豁免，可联系对接的客户经理沟通）。若存在，须先撤销或完成签署，否则无法变更。
+  * **每日频控**：同一个操作人（`ProxyOperator.OpenId`）每日核验上限为 **10 次**。
+  
+  ---
+  
+  ##  变更审核流程
+  
+  接口在处理变更时，会先进行工商三要素（企业名称、法人姓名、统一社会信用代码）核验，流程分为以下两条路径：
+  <img src="https://qcloudimg.tencent-cloud.cn/raw/123767975de1754bd30b24617661ea65.png" width="380" >
+  
+  ### 触发人工审核（收录流程）的具体场景：
+  
+  1. **三要素不一致**：传入的“新企业名称”或“新法人姓名”，与该统一社会信用代码（USCC）在官方工商登记中的记录不匹配。
+  2. **工商状态异常**：该 USCC 在工商库中的状态为异常（如查无此企业、已注销、已吊销等）。
+  
+  ---
+  
+  ##  变更成功后的影响
+  
+  企业信息变更成功后，系统会自动执行以下关联操作：
+  
+  | 变更维度 | 级联影响 |
+  | --- | --- |
+  | **法人变更** | 1. **作废**当前企业下的原法人印章。2. 原法人账号**降级**为普通员工。3. 向新法人手机号发送激活/通知短信。 |
+  | **企业名称变更** | 1. **作废**该企业当前的 CA 证书并**颁发新证书**。2. **生成**新的企业公章。 |
+  | **地址变更** | 仅同步修改企业登记地址。 |
+  | **企业类型变更** | 仅同步修改企业类型。 |
+  
+  ---
+  
+  ##  相关回调事件
   
-  反向说明：三要素校验全部通过时，接口会直接执行企业信息变更，无需收录审批。
+  * **变更直接成功/确认成功后**：触发 [企业基础信息修改通知回调](https://www.google.com/search?q=https://qian.tencent.com/developers/partner/callback_types_staffs/%23%25E5%258D%2581%25E5%259B%259B-%25E4%25BC%2581%25E4%25B8%259A%25E5%259F%25BA%25E7%25A1%2580%25E4%25BF%25A1%25E6%2581%25AF%25E4%25BF%25AE%25E6%2594%25B9%25E9%2580%259A%25E7%259F%25A5)
+  * **人工收录审核产生结果后**：触发 [企业收录申请审核结果回调](https://www.google.com/search?q=https://qian.tencent.com/developers/partner/callback_types_staffs/%23%25E5%258D%2581%25E5%2585%25AD-%25E4%25BC%2581%25E4%25B8%259A%25E6%2594%25B6%25E5%25BD%2595%25E7%2594%25B3%25E8%25AF%25B7%25E5%25AE%25A1%25E6%25A0%25B8%25E7%25BB%2593%25E6%259E%259C%25E5%259B%259E%25E8%25B0%2583)
        */
     ModifyOrganizationBusinessInfo(req: ModifyOrganizationBusinessInfoRequest, cb?: (error: string, rep: ModifyOrganizationBusinessInfoResponse) => void): Promise<ModifyOrganizationBusinessInfoResponse>;
     /**

package/tencentcloud/services/essbasic/v20210526/essbasic_client.js

@@ -199,41 +199,47 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("ChannelCreateBoundFlows", req, cb);
     }
     /**
-       * 本接口用于企业在已完成工商变更登记后，在电子签侧同步更新企业基础信息，并上传最新的营业执照或相关证照图片作为变更凭证。
-  ⚠️ 重要说明
-  本接口不做营业执照 OCR 识别：系统不会对上传的营业执照图片进行内容识别。调用方需自行把工商变更后的最新信息，通过 organization_name / legal_name / address 等字段显式传入；营业执照图片仅作为变更凭证上传与留存。
-  只传"变了"的字段即可：各信息字段均为"变更后的新值"，未变更的字段留空不传，系统会自动沿用电子签侧当前值（含统一社会信用代码）。四项信息（企业名称、法人姓名、地址、新法人手机号）至少需传入其一。
-  受理请求后，接口会依次完成以下处理：
-  操作人身份校验：调用方（operator.user_id）必须是该企业的法定代表人或超级管理员，否则返回无权限错误。
-  营业执照校验：校验 biz_license_resource_id 对应的图片资源归属（须属于当前企业/应用），仅作凭证存储，不做 OCR。
-  工商信息比对：将传入的新值（已传的字段）与电子签侧现有数据比对，确认确实存在变更内容；若与现状完全一致，则返回「企业信息未变更」。
-  未完结合同检查：仅当企业名称发生变更时，才检查该企业在 SaaS 与渠道子客下是否存在尚未完成的签署合同（白名单企业豁免）；若存在未完结合同则拦截并提示先处理合同。
-  工商三要素核验与变更执行：对企业名称、法人、统一社会信用代码进行工商三要素核验（每日最多 10 次）。核验通过则直接执行信息变更；核验不通过则转入收录审核流程，待审核通过后生效。
-  
-  收录申请触发的场景
-  本接口在工商信息变更时，会用**「新企业名称 + 统一社会信用代码(USCC) + 新法定代表人姓名」三要素与工商登记信息做校验，以此决定是直接执行变更还是提交收录申请（人工审核）**。
-  统一社会信用代码不可变更：系统自动取企业当前在库的 USCC 参与校验，不接受入参修改。
-  企业名称 / 法定代表人姓名取您本次传入的新值（未传则沿用当前值）。
-  
-  <p>
-    当工商三要素校验未通过时，接口不会直接修改企业信息，而是<strong>提交收录申请进入人工审核</strong>。具体触发场景如下：
-  </p>
-  <table>
-    <tr>
-      <th>触发场景</th>
-      <th>说明</th>
-    </tr>
-    <tr>
-      <td>三要素与工商登记不一致</td>
-      <td>传入的<strong>新企业名称</strong>或<strong>新法人姓名</strong>，与当前统一社会信用代码（USCC）在工商登记中的记录不匹配</td>
-    </tr>
-    <tr>
-      <td>工商库企业状态异常</td>
-      <td>依据当前 USCC 在工商库中查到的企业状态非正常（如查无此企业、已注销、已吊销等）</td>
-    </tr>
-  </table>
+       * 本接口用于企业完成工商变更登记后，**在电子签侧同步更新企业基础信息**，并上传最新的营业执照作为变更凭证。
+  
+  >  **调用权限**：仅限企业**超级管理员**或**法人**有权调用（即 `Agent.ProxyOperator.OpenId` 必须传入超管或法人的 OpenId）。
+  
+  
+  * **不会OCR**：系统**不会**自动识别营业执照图片。变更后的新信息（企业名称、法人、地址、类型）必须通过对应字段（`OrganizationName` / `LegalName` 等）显式传入。
+  * **增量更新（只传变了的）**：仅传入**已变更**的字段新值，未变更的字段留空，系统会自动沿用电子签侧的当前值。若无任何字段变更，请勿调用此接口。
+  * **未完结合同限制**：若**企业名称**发生变更，系统会拦截检查是否存在全平台（同名的saas自建企业和子客企业）未完结的签署合同（针对白名单企业豁免，可联系对接的客户经理沟通）。若存在，须先撤销或完成签署，否则无法变更。
+  * **每日频控**：同一个操作人（`ProxyOperator.OpenId`）每日核验上限为 **10 次**。
+  
+  ---
+  
+  ##  变更审核流程
+  
+  接口在处理变更时，会先进行工商三要素（企业名称、法人姓名、统一社会信用代码）核验，流程分为以下两条路径：
+  <img src="https://qcloudimg.tencent-cloud.cn/raw/123767975de1754bd30b24617661ea65.png" width="380" >
+  
+  ### 触发人工审核（收录流程）的具体场景：
+  
+  1. **三要素不一致**：传入的“新企业名称”或“新法人姓名”，与该统一社会信用代码（USCC）在官方工商登记中的记录不匹配。
+  2. **工商状态异常**：该 USCC 在工商库中的状态为异常（如查无此企业、已注销、已吊销等）。
+  
+  ---
+  
+  ##  变更成功后的影响
+  
+  企业信息变更成功后，系统会自动执行以下关联操作：
+  
+  | 变更维度 | 级联影响 |
+  | --- | --- |
+  | **法人变更** | 1. **作废**当前企业下的原法人印章。2. 原法人账号**降级**为普通员工。3. 向新法人手机号发送激活/通知短信。 |
+  | **企业名称变更** | 1. **作废**该企业当前的 CA 证书并**颁发新证书**。2. **生成**新的企业公章。 |
+  | **地址变更** | 仅同步修改企业登记地址。 |
+  | **企业类型变更** | 仅同步修改企业类型。 |
+  
+  ---
+  
+  ##  相关回调事件
   
-  反向说明：三要素校验全部通过时，接口会直接执行企业信息变更，无需收录审批。
+  * **变更直接成功/确认成功后**：触发 [企业基础信息修改通知回调](https://www.google.com/search?q=https://qian.tencent.com/developers/partner/callback_types_staffs/%23%25E5%258D%2581%25E5%259B%259B-%25E4%25BC%2581%25E4%25B8%259A%25E5%259F%25BA%25E7%25A1%2580%25E4%25BF%25A1%25E6%2581%25AF%25E4%25BF%25AE%25E6%2594%25B9%25E9%2580%259A%25E7%259F%25A5)
+  * **人工收录审核产生结果后**：触发 [企业收录申请审核结果回调](https://www.google.com/search?q=https://qian.tencent.com/developers/partner/callback_types_staffs/%23%25E5%258D%2581%25E5%2585%25AD-%25E4%25BC%2581%25E4%25B8%259A%25E6%2594%25B6%25E5%25BD%2595%25E7%2594%25B3%25E8%25AF%25B7%25E5%25AE%25A1%25E6%25A0%25B8%25E7%25BB%2593%25E6%259E%259C%25E5%259B%259E%25E8%25B0%2583)
        */
     async ModifyOrganizationBusinessInfo(req, cb) {
         return this.request("ModifyOrganizationBusinessInfo", req, cb);

package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts

@@ -2374,11 +2374,11 @@ export interface ModifyOrganizationBusinessInfoResponse {
      */
     UnfinishedCount?: number;
     /**
-     * <p>SaaS 企业下未完结合同的 flowId 列表。</p>
+     * <p>SaaS 企业下未完结合同的 flowId 列表。注:<code>SaaS企业下的合同ID可能无法查询，可通知子客企业去处理相应的合同</code></p>
      */
     FlowIds?: Array<string>;
     /**
-     * <p>渠道子客企业下未完结合同的 flowId 列表。</p>
+     * <p>渠道子客企业下未完结合同的 flowId 列表。注：<code>子客企业在其他渠道下的合同ID可能无法查询，可通知子客企业去处理其他渠道下相应的合同</code></p>
      */
     ChannelFlowIds?: Array<string>;
     /**
@@ -6824,6 +6824,10 @@ export interface ModifyOrganizationBusinessInfoRequest {
      * <p>变更后的最新工商登记法人姓名。<br>仅当法人发生变更时传入，未变更则不传（系统自动沿用当前法人姓名）。</p>
      */
     LegalName?: string;
+    /**
+     * <p>新法人的手机号。<br>仅当法人发生变更时传入，用于向新法人发送短信通知。<br>需为合法的手机号或固定电话格式。</p>
+     */
+    NewLegalMobile?: string;
 }
 /**
  * CreateSignUrls返回参数结构体