tencentcloud-sdk-nodejs 4.0.972 → 4.0.974

package/tencentcloud/services/ess/v20201111/ess_client.js

@@ -275,15 +275,19 @@ class Client extends abstract_client_1.AbstractClient {
         return this.request("CreateFlowGroupByTemplates", req, cb);
     }
     /**
-     * 创建他方自动签授权链接（他方授权/我方授权），通过该链接可进入小程序进行合作方企业的自动签授权，若授权企业未开通企业自动签，通过该链接会先引导开通本企业自动签。
-该接口效果同控制台： 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权
-
+     * 创建一个用于他方自动签授权的链接（可选择他方授权或我方授权）。通过这个链接，合作方企业可以直接进入小程序，进行自动签授权操作。
 
+如果授权企业尚未开通企业自动签功能，该链接还将引导他们首先开通本企业的自动签服务
 
 注:
 1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Operator.UserId 需要传递超管或者法人的UserId)
 2. 已经在授权中或者授权成功的企业，无法重复授权
 3. 授权企业和被授权企业必须都是已认证企业
+4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
+
+
+**该接口效果同控制台： 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
+![image](https://qcloudimg.tencent-cloud.cn/raw/489aa0bf74941469b5e740f428f17c3a.png)
      */
     async CreatePartnerAutoSignAuthUrl(req, cb) {
         return this.request("CreatePartnerAutoSignAuthUrl", req, cb);
@@ -926,38 +930,26 @@ class Client extends abstract_client_1.AbstractClient {
     /**
      * 此接口（CreateOrganizationInfoChangeUrl）用于创建企业信息变更链接，支持创建企业超管变更链接或企业基础信息变更链接，通过入参ChangeType指定。
 
+ 需要企业的<font color="red">现有的超级管理员、法人来点击</font>链接执行变动操作。
 
-<h3 id="1-企业超管变更">1. 企业超管变更</h3>
-
-<p>换成企业的其他员工来当超管</p>
-
-<h3 id="2-企业基础信息变更">2. 企业基础信息变更</h3>
-
-<h4 id="可以变动">可以变动</h4>
-
-<ul>
-<li>企业名称<br>
-</li>
-<li>法定代表人姓名(新法人有邀请链接)<br>
-</li>
-<li>企业地址和所在地</li>
-</ul>
+### 2. 企业基础信息
+#### A. 可变动的信息
+- **企业名称**
+- **法定代表人姓名**（新法人将收到邀请链接）
+- **企业地址和所在地**
+- **企业超级管理员变更** （此变更将企业超级管理员的职责转移给企业的其他员工）
 
-<h4 id="不可变动">不可变动</h4>
+#### B. 不可变动的信息
+- **统一社会信用代码**
+- **企业主体类型**
 
-<ul>
-<li>统一社会信用代码<br>
-</li>
-<li>企业主体类型</li>
-</ul>
+### 3.变更影响
 
-<p>如果企业名称变动会引起下面的变动</p>
+如果企业的名字变更将导致下面的影响：
 
-<ul>
-<li>合同:   老合同不做任何处理,   新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
-<li>印章:   会删除所有的印章所有的机构公章和合同专用章,  然后用新企业名称生成新的机构公章 和合同专用章,  而法人章, 财务专用章和人事专用章不会处理</li>
-<li>证书:   企业证书会重新请求CA机构用新企业名称生成新的证书</li>
-</ul>
+- **合同**：已存在的合同将保持不变。新发起的合同需使用新的企业名称作为签署方，否则无法签署。
+- **印章**：所有现有的机构公章和合同专用章将被删除，并将根据新的企业名称重新生成。法人章、财务专用章和人事专用章将不做处理。
+- **证书**：企业证书将重新由CA机构使用新的企业名称生成。
      */
     async CreateOrganizationInfoChangeUrl(req, cb) {
         return this.request("CreateOrganizationInfoChangeUrl", req, cb);

package/tencentcloud/services/ess/v20201111/ess_models.d.ts

@@ -7000,21 +7000,31 @@ export interface CreatePartnerAutoSignAuthUrlRequest {
      */
     Operator?: UserInfo;
     /**
-     * 被授企业id/授权方企业id，和AuthorizedOrganizationName二选一传入
+     * 被授企业id/授权方企业id（即OrganizationId），和AuthorizedOrganizationName二选一传入
      */
     AuthorizedOrganizationId?: string;
     /**
-     * 被授企业名称/授权方企业名称，和AuthorizedOrganizationId二选一传入
+     * 被授企业名称/授权方企业的名字，和AuthorizedOrganizationId二选一传入即可。请确认该名称与企业营业执照中注册的名称一致。
+  注: `如果名称中包含英文括号()，请使用中文括号（）代替。`
      */
     AuthorizedOrganizationName?: string;
     /**
-     * 指定印章类型，指定后只能选择该类型的印章进行授权支持以下印章类型：- OFFICIAL : 企业公章- CONTRACT : 合同专用章- FINANCE : 财务专用章- PERSONNEL : 人事专用章
+     * 在设置印章授权时，可以指定特定的印章类型，以确保在授权过程中只使用相应类型的印章。支持的印章类型包括：
+  
+  <ul>
+  <li><strong>OFFICIAL</strong>：企业公章，用于代表企业对外的正式文件和重要事务的认证。</li>
+  <li><strong>CONTRACT</strong>：合同专用章，专门用于签署各类合同。</li>
+  <li><strong>FINANCE</strong>：财务专用章，用于企业的财务相关文件，如发票、收据等财务凭证的认证。</li>
+  <li><strong>PERSONNEL</strong>：人事专用章，用于人事管理相关文件，如劳动合同、人事任命等。</li>
+  </ul>
      */
     SealTypes?: Array<string>;
     /**
-     * 他方授权给我方：
-  - false：我方授权他方，AuthorizedOrganizationName代表【被授权方】企业名称
-  - true：他方授权我方，AuthorizedOrganizationName代表【授权方】企业名称
+     * 在处理授权关系时，授权的方向
+  <ul>
+  <li><strong>false</strong>（默认值）：表示我方授权他方。在这种情况下，<code>AuthorizedOrganizationName</code> 代表的是【被授权方】的企业名称，即接收授权的企业。</li>
+  <li><strong>true</strong>：表示他方授权我方。在这种情况下，<code>AuthorizedOrganizationName</code> 代表的是【授权方】的企业名称，即提供授权的企业。</li>
+  </ul>
      */
     AuthToMe?: boolean;
 }
@@ -7886,7 +7896,8 @@ export interface Component {
   
   * 个人方
   <ul><li> <b>SIGN_DATE</b> : 签署日期控件；</li>
-  <li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li></ul>
+  <li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
+  <li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li></ul>
    
   注：` 表单域的控件不能作为印章和签名控件`
      */
@@ -8028,6 +8039,9 @@ export interface Component {
   <ul><li> <b>PageRanges</b> :PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）</li></ul>
   <b>参数样例</b>：` "{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"`
   
+  <font color="red">签署印章透明度功能设置，</font>当ComponentType为SIGN_SIGNATURE、SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL时，可以通过以下参数设置签署印章的透明度：
+  <ul><li> <b>Opacity</b>：印章透明度，支持范围：0-1，0.7表示70%的透明度，1表示无透明度</li></ul>
+  <b>参数样例</b>：`{"Opacity":0.7}`
   
   <font color="red">关键字模式下支持关键字找不到的情况下不进行报错的设置</font>
   <ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
@@ -9139,6 +9153,11 @@ export interface CreateMultiFlowSignQRCodeRequest {
      * 禁止个人用户重复签署，默认不禁止，即同一用户可多次扫码签署多份合同。若要求同一用户仅能扫码签署一份合同，请传入true。
      */
     ForbidPersonalMultipleSign?: boolean;
+    /**
+     * 合同流程名称是否应包含扫码签署人的信息，且遵循特定格式（flowname-姓名-手机号后四位）。
+  例如，通过参数FlowName设定的扫码发起合同名称为“员工入职合同”，当扫码人张三（手机号18800009527）扫码签署时，合同名称将自动生成为“员工入职合同-张三-9527”。
+     */
+    FlowNameAppendScannerInfo?: boolean;
 }
 /**
  * VerifyPdf请求参数结构体

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

@@ -193,7 +193,8 @@ export declare class Client extends AbstractClient {
     ChannelCreateConvertTaskApi(req: ChannelCreateConvertTaskApiRequest, cb?: (error: string, rep: ChannelCreateConvertTaskApiResponse) => void): Promise<ChannelCreateConvertTaskApiResponse>;
     /**
      * 此接口（DescribeUsage）用于获取此应用下子客企业的合同消耗数量。
-<font color="red">此接口即将下线， 请使用新接口[查询渠道计费消耗情况](https://qian.tencent.com/developers/partnerApis/fee/ChannelDescribeBillUsageDetail)</font>
+
+<font color="red">此接口即将下线， 请使用新接口</font>  [查询渠道计费消耗情况](https://qian.tencent.com/developers/partnerApis/fee/ChannelDescribeBillUsageDetail)
 
 注: 此接口**每日限频50次**，若要扩大限制次数,请提前与客服经理或邮件至e-contract@tencent.com进行联系。
      */
@@ -834,14 +835,19 @@ Web链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表
      */
     CreatePersonAuthCertificateImage(req: CreatePersonAuthCertificateImageRequest, cb?: (error: string, rep: CreatePersonAuthCertificateImageResponse) => void): Promise<CreatePersonAuthCertificateImageResponse>;
     /**
-     * 创建他方自动签授权链接，通过该链接可进入小程序进行合作方企业的自动签授权，若当前企业未开通企业自动签，通过该链接会先引导开通本企业自动签。
-该接口效果同控制台： 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权
+     * 创建一个用于他方自动签授权的链接（可选择他方授权或我方授权）。通过这个链接，合作方企业可以直接进入小程序，进行自动签授权操作。
 
+如果授权企业尚未开通企业自动签功能，该链接还将引导他们首先开通本企业的自动签服务
 
 
 注:
 1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
 2. 已经在授权中或者授权成功的企业，无法重复授权
+3. 授权企业和被授权企业必须都是已认证企业
+4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
+
+**该接口效果同控制台： 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
+![image](https://qcloudimg.tencent-cloud.cn/raw/091823fd4f02af7dda416fa10ca65f2d.png)
      */
     CreatePartnerAutoSignAuthUrl(req: CreatePartnerAutoSignAuthUrlRequest, cb?: (error: string, rep: CreatePartnerAutoSignAuthUrlResponse) => void): Promise<CreatePartnerAutoSignAuthUrlResponse>;
     /**
@@ -1253,12 +1259,32 @@ Agent参数中的OpenId 必须为审批者的openId，且链接必须由审批
      */
     DeleteOrganizationAuthorizations(req: DeleteOrganizationAuthorizationsRequest, cb?: (error: string, rep: DeleteOrganizationAuthorizationsResponse) => void): Promise<DeleteOrganizationAuthorizationsResponse>;
     /**
-     * 用于获取合同中填写控件填写状态和填写的内容。
+     * 您可以通过合同流程ID查询相关的<font color="red"><b>填写控件</b></font>信息及其内容。这包括控件的归属方、控件的填写状态（是否已填写）以及具体的填写内容。
+
+无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件，均包含在查询结果中。
+
+![image](https://qcloudimg.tencent-cloud.cn/raw/08f6ea50d3ae88b51c280c2b17c2a126.png)
+### 2.  那些控件会出现在结果里边？
+**A.不返回的控件类型：**
+- 动态表格
+- 附件控件
+- 水印控件
 
-**注意**: `附件控件不会出现在结果列表中`
+**B.返回的控件类型：**
+- 单行文本
+- 多行文本
+- 勾选框控件
+- 数字控件
+- 日期控件
+- 图片控件（图片下载地址）
+- 邮箱控件
+- 地址控件
+- 学历控件
+- 性别控件
+- 省市区控件
 
+### 3.怎么授权？
 
-**授权**:
 此接口需要授权,  有两种开通权限的途径
 
 **第一种**:   需第三方应用的子企业登录控制台进行授权,  授权在**企业中心**的**授权管理**区域,  界面如下图

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

@@ -241,7 +241,8 @@ class Client extends abstract_client_1.AbstractClient {
     }
     /**
      * 此接口（DescribeUsage）用于获取此应用下子客企业的合同消耗数量。
-<font color="red">此接口即将下线， 请使用新接口[查询渠道计费消耗情况](https://qian.tencent.com/developers/partnerApis/fee/ChannelDescribeBillUsageDetail)</font>
+
+<font color="red">此接口即将下线， 请使用新接口</font>  [查询渠道计费消耗情况](https://qian.tencent.com/developers/partnerApis/fee/ChannelDescribeBillUsageDetail)
 
 注: 此接口**每日限频50次**，若要扩大限制次数,请提前与客服经理或邮件至e-contract@tencent.com进行联系。
      */
@@ -968,14 +969,19 @@ Web链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表
         return this.request("CreatePersonAuthCertificateImage", req, cb);
     }
     /**
-     * 创建他方自动签授权链接，通过该链接可进入小程序进行合作方企业的自动签授权，若当前企业未开通企业自动签，通过该链接会先引导开通本企业自动签。
-该接口效果同控制台： 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权
+     * 创建一个用于他方自动签授权的链接（可选择他方授权或我方授权）。通过这个链接，合作方企业可以直接进入小程序，进行自动签授权操作。
 
+如果授权企业尚未开通企业自动签功能，该链接还将引导他们首先开通本企业的自动签服务
 
 
 注:
 1. <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Agent.ProxyOperator.OpenId 需要传递超管或者法人的OpenId)
 2. 已经在授权中或者授权成功的企业，无法重复授权
+3. 授权企业和被授权企业必须都是已认证企业
+4. <font color='red'>需要授权企业或被授权企业的超管或者法人打开链接</font>走开通逻辑。
+
+**该接口效果同控制台： 企业设置-> 扩展服务 -> 企业自动签署 -> 合作企业方授权**
+![image](https://qcloudimg.tencent-cloud.cn/raw/091823fd4f02af7dda416fa10ca65f2d.png)
      */
     async CreatePartnerAutoSignAuthUrl(req, cb) {
         return this.request("CreatePartnerAutoSignAuthUrl", req, cb);
@@ -1435,12 +1441,32 @@ Agent参数中的OpenId 必须为审批者的openId，且链接必须由审批
         return this.request("DeleteOrganizationAuthorizations", req, cb);
     }
     /**
-     * 用于获取合同中填写控件填写状态和填写的内容。
+     * 您可以通过合同流程ID查询相关的<font color="red"><b>填写控件</b></font>信息及其内容。这包括控件的归属方、控件的填写状态（是否已填写）以及具体的填写内容。
+
+无论是<font color="red"><b>发起方还是签署方</b></font>填写的控件，均包含在查询结果中。
+
+![image](https://qcloudimg.tencent-cloud.cn/raw/08f6ea50d3ae88b51c280c2b17c2a126.png)
+### 2.  那些控件会出现在结果里边？
+**A.不返回的控件类型：**
+- 动态表格
+- 附件控件
+- 水印控件
 
-**注意**: `附件控件不会出现在结果列表中`
+**B.返回的控件类型：**
+- 单行文本
+- 多行文本
+- 勾选框控件
+- 数字控件
+- 日期控件
+- 图片控件（图片下载地址）
+- 邮箱控件
+- 地址控件
+- 学历控件
+- 性别控件
+- 省市区控件
 
+### 3.怎么授权？
 
-**授权**:
 此接口需要授权,  有两种开通权限的途径
 
 **第一种**:   需第三方应用的子企业登录控制台进行授权,  授权在**企业中心**的**授权管理**区域,  界面如下图

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

@@ -214,6 +214,10 @@ export interface Component {
   <li> <b>RotateRelation</b>：旋转关联控件，用于指定关联旋转的控件。例如：让印章控件和签署日期控件按照印章控件为中心旋转（此时，设置印章控件的RotateRelation为日期控件的ComponentId，设置日期签署控件的RotateRelation为印章控件的ComponentId）。</li></ul>
   <b>参数样例</b>：`{"Rotate":-30,"RotateRelation":"Component_Id1"}`
   
+  <font color="red">签署印章透明度功能设置，</font>当ComponentType为SIGN_SIGNATURE、SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL时，可以通过以下参数设置签署印章的透明度：
+  <ul><li> <b>Opacity</b>：印章透明度，支持范围：0-1，0.7表示70%的透明度，1表示无透明度</li></ul>
+  <b>参数样例</b>：`{"Opacity":0.7}`
+  
   <font color="red">关键字模式下支持关键字找不到的情况下不进行报错的设置</font>
   <ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
   场景说明：如果使用关键字进行定位，但是指定的PDF文件中又没有设置的关键字时，发起合同会进行关键字是否存在的校验，如果关键字不存在，会进行报错返回。如果不希望进行报错，可以设置"IgnoreKeywordError"来忽略错误。请注意，如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有，还是会触发报错逻辑。
@@ -4936,6 +4940,10 @@ export interface ChannelCreateMultiFlowSignQRCodeRequest {
      * 禁止个人用户重复签署，默认不禁止，即同一用户可多次扫码签署多份合同。若要求同一用户仅能扫码签署一份合同，请传入true。
      */
     ForbidPersonalMultipleSign?: boolean;
+    /**
+     * 合同流程名称是否应包含扫码签署人的信息，且遵循特定格式（flowname-姓名-手机号后四位）。 例如，通过参数FlowName设定的扫码发起合同名称为“员工入职合同”，当扫码人张三（手机号18800009527）扫码签署时，合同名称将自动生成为“员工入职合同-张三-9527”。
+     */
+    FlowNameAppendScannerInfo?: boolean;
 }
 /**
  * 签署二维码的基本信息，用于创建二维码，用户可扫描该二维码进行签署操作。
@@ -6249,34 +6257,47 @@ export interface CreatePartnerAutoSignAuthUrlRequest {
      */
     Agent: Agent;
     /**
-     * 被授企业id，和AuthorizedOrganizationName二选一，不能同时为空
+     * 被授企业id/授权方企业id（即OrganizationId），如果是企业之间授权和AuthorizedOrganizationName二选一传入。
+  
   注：`被授权企业必须和当前企业在同一应用号下`
      */
     AuthorizedOrganizationId?: string;
     /**
-     * 被授权企业名，和AuthorizedOrganizationId二选一，不能同时为空
-  注：`被授权企业必须和当前企业在同一应用号下`
+     * 被授企业名称/授权方企业的名字，如果是企业之间授权和AuthorizedOrganizationId二选一传入即可。请确认该名称与企业营业执照中注册的名称一致。
+  
+  注:
+  1. 如果名称中包含英文括号()，请使用中文括号（）代替。
+  2. 被授权企业必须和当前企业在同一应用号下
      */
     AuthorizedOrganizationName?: string;
     /**
-     * 是否给平台应用授权:
-  - true: 是（无需设置AuthorizedOrganizationId和AuthorizedOrganizationName）
-  - false: 否（默认）
-   注：该参数需要开通“基于子客授权第三方应用可文件发起子客自动签署”，请联系运营经理开通
+     * 是否给平台应用授权
   
+  <ul>
+  <li><strong>true</strong>: 表示是，授权平台应用。在此情况下，无需设置<code>AuthorizedOrganizationId</code>和<code>AuthorizedOrganizationName</code>。</li>
+  <li><strong>false</strong>: （默认）表示否，不是授权平台应用。</li>
+  </ul>
+  
+   注：授权给平台应用需要开通【基于子客授权第三方应用可文件发起子客自动签署】白名单，请联系运营经理开通。
      */
     PlatformAppAuthorization?: boolean;
     /**
-     * 指定印章类型，指定后只能选择该类型的印章进行授权
-  支持以下印章类型：
-  - OFFICIAL : 企业公章
-  - CONTRACT : 合同专用章
-  - FINANCE : 财务专用章
-  - PERSONNEL : 人事专用章
+     * 在设置印章授权时，可以指定特定的印章类型，以确保在授权过程中只使用相应类型的印章。支持的印章类型包括：
+  
+  <ul>
+  <li><strong>OFFICIAL</strong>：企业公章，用于代表企业对外的正式文件和重要事务的认证。</li>
+  <li><strong>CONTRACT</strong>：合同专用章，专门用于签署各类合同。</li>
+  <li><strong>FINANCE</strong>：财务专用章，用于企业的财务相关文件，如发票、收据等财务凭证的认证。</li>
+  <li><strong>PERSONNEL</strong>：人事专用章，用于人事管理相关文件，如劳动合同、人事任命等。</li>
+  </ul>
      */
     SealTypes?: Array<string>;
     /**
-     * 他方授权给我方：- false：我方授权他方，AuthorizedOrganizationName代表【被授权方】企业名称- true：他方授权我方，AuthorizedOrganizationName代表【授权方】企业名称
+     * 在处理授权关系时，授权的方向
+  <ul>
+  <li><strong>false</strong>（默认值）：表示我方授权他方。在这种情况下，<code>AuthorizedOrganizationName</code> 代表的是【被授权方】的企业名称，即接收授权的企业。</li>
+  <li><strong>true</strong>：表示他方授权我方。在这种情况下，<code>AuthorizedOrganizationName</code> 代表的是【授权方】的企业名称，即提供授权的企业。</li>
+  </ul>
      */
     AuthToMe?: boolean;
 }