tencentcloud-sdk-nodejs 4.1.304 → 4.1.305

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

@@ -45,16 +45,16 @@ class Client extends abstract_client_1.AbstractClient {
     }
     /**
      * 此接口用于启动流程。它是模板发起合同的最后一步。
-在[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)和[创建电子文档](https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument)之后，用于开始整个合同流程,  推进流程进入到签署环节。
-
-![image](https://qcloudimg.tencent-cloud.cn/raw/1f38ebd7c5afed8763ad961741d81438.png)
 
-注：
-1.<font color="red">合同发起后就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）
+## 1.1 接口调用流程
+在[创建签署流程](https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow)和[创建电子文档](https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument)之后，用于开始整个合同流程,  推进流程进入到签署环节。
 
-2.<font color="red">静默（自动）签署不支持非本企业合同签署方存在填写</font>功能
+![image](https://qcloudimg.tencent-cloud.cn/raw/dbd2eba8200d812d76b7e9e34d739e75.svg)
 
-3.<font color="red">在发起签署流程之前，建议等待 [PDF合成完成的回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83)</font>，尤其是当模板中存在动态表格等复杂填写控件时，因为合成过程可能会耗费秒级别的时间。
+### 1.2 注意事项
+-  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考[合同撤销返还额度说明](https://qian.tencent.com/developers/company/contract_cancel_quota)。
+-  只要存在填写控件，填充时会触发 PDF 合成工作，文档合成完成后会收到[合同文档合成完成回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83)。**一定要等待该回调（或等待数秒）后再调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 接口发起签署**，以确保文档已合成完毕。，尤其是当模板中存在动态表格等复杂填写控件时，因为合成过程可能会耗费秒级别的时间。
+- 调用 [CreateDocument](https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument) 成功后，请<font color="red">在 5 分钟内调用本接口（StartFlow）启动合同</font> ，不要长时间暂存仅调用了 CreateDocument 而未发起的合同；否则会导致该合同长时间后无法再启动，且合同额度不再返还。
      */
     async StartFlow(req, cb) {
         return this.request("StartFlow", req, cb);
@@ -220,48 +220,42 @@ class Client extends abstract_client_1.AbstractClient {
         return this.request("CreateFlowSignReview", req, cb);
     }
     /**
-     * 创建签署流程电子文档<br />
-
-###  调用流程
-该接口需要给对应的流程指定一个模板id，并且填充该模板中需要补充的信息。需要配置<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow" target="_blank">创建签署流程</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。具体逻辑可以参考下图:
+     * 本接口用于基于**模板**创建合同的电子文档，并填充模板中由发起方补充的信息（归属发起方填写控件）。
 
-![image](https://qcloudimg.tencent-cloud.cn/raw/1f38ebd7c5afed8763ad961741d81438.png)
+### 1.1 调用流程
 
+本接口需指定一个模板 ID，并填充该模板中需补充的信息。它需要与<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateFlow" target="_blank">创建签署流程</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口配合使用，完整调用顺序如下：
+![image](https://qcloudimg.tencent-cloud.cn/raw/dbd2eba8200d812d76b7e9e34d739e75.svg)
 
-### 填充模板中定义的填写控件
-模板中配置的<font color="red">发起人填充控件</font>可以通过本接口的**FormFields数组**字段填充。
+### 1.2 发起方填写控件
 
-**<font color="red">填充填写控件需要进行Pdf合成工作，文档合成完成后会收到[合同文档合成完成回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83),建议在收到此回调后再调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 接口。</font>**
+模板中配置的<font color="red">发起人填充控件</font>，可通过本接口的 **FormFields 数组**字段填充。
 
 ![image](https://qcloudimg.tencent-cloud.cn/raw/37457e0e450fc221effddfcb8b1bad55.png)
 
-填充的传参示例如下
-
-```
-    request.FormFields = [{
-            "ComponentName": "项目的名字",
-            "ComponentValue": "休闲山庄"
-        }, {
-            "ComponentName": "项目的地址",
-            "ComponentValue": "凤凰山北侧",
-        }, {
-            "ComponentName": "范围",
-            "ComponentValue": "凤凰山至107国道",
-        }, {
-            "ComponentName": "面积",
-            "ComponentValue": "100亩",
-        }, {
-            "ComponentName": "基本情况",
-            "ComponentValue": "完好",
-        }, , {
-            "ComponentName": "用途",
-            "ComponentValue": "经营农家乐",
-        }
-    ]
+填充的传参示例如下（以 ComponentName 匹配模板中的控件名）：
+
+```json
+[
+    { "ComponentName": "项目的名字", "ComponentValue": "休闲山庄" },
+    { "ComponentName": "项目的地址", "ComponentValue": "凤凰山北侧" },
+    { "ComponentName": "范围", "ComponentValue": "凤凰山至107国道" },
+    { "ComponentName": "面积", "ComponentValue": "100亩" },
+    { "ComponentName": "基本情况", "ComponentValue": "完好" },
+    { "ComponentName": "用途", "ComponentValue": "经营农家乐" }
+]
 ```
-合成后合同样子示例
+
+合成后的合同样例：
 
 ![image](https://qcloudimg.tencent-cloud.cn/raw/140a2fb771ac66a185d0a000d37485f6.png)
+
+### 1.3 注意事项
+
+-  本接口<font color="red">只能填充分配给发起方的填写控件</font>，不能填充分配给签署方的签署控件。
+- <font color="red">若使用预览方式（`NeedPreview=true`），预览确认无误后，需用同样的参数再次调用本接口</font>（`NeedPreview=false`），并使用新调用返回的 `FlowId` 去调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 发起签署。预览模式返回的 `FlowId` 为临时 ID，不能用于发起。
+- 只要存在发起方的填写控件，填充时会触发 PDF 合成工作，文档合成完成后会收到[合同文档合成完成回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign#%E4%B9%9D-%E5%90%88%E5%90%8C%E6%96%87%E6%A1%A3%E5%90%88%E6%88%90%E5%AE%8C%E6%88%90%E5%9B%9E%E8%B0%83)。<font color="red">一定要等待该回调（或等待数秒）后再调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 接口发起签署</font>，以确保文档已合成完毕。
+- 调用本接口（CreateDocument）成功后，请**在 5 分钟内调用 [StartFlow](https://qian.tencent.com/developers/companyApis/startFlows/StartFlow) 启动合同**，不要长时间暂存仅调用了 CreateDocument 而未发起的合同；否则会导致该合同长时间后无法再启动，且合同额度不再返还。
      */
     async CreateDocument(req, cb) {
         return this.request("CreateDocument", req, cb);
@@ -799,40 +793,26 @@ class Client extends abstract_client_1.AbstractClient {
     }
     /**
      * 通过模板创建签署流程<br/>
-适用场景：在标准制式的合同场景中，可通过提前预制好模板文件，每次调用模板文件的id，补充合同内容信息及签署信息生成电子合同。
-<table>
-    <thead>
-        <tr>
-            <th>签署人类别</th>
-            <th>需要提前准备的信息</th>
-        </tr>
-    </thead>
-    <tbody>
-        <tr>
-            <td>自己企业的员工签署（未认证加入或已认证加入）</td>
-            <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号（证件号非必传）</td>
-        </tr>
-        <tr>
-            <td>自己企业的员工签署（已认证加入）</td>
-            <td>签署企业的名字、员工在电子签平台的ID（UserId）</td>
-        </tr>
-        <tr>
-            <td>其他企业的员工签署</td>
-            <td>签署企业的名字、员工的真实名字、员工的触达手机号、员工的证件号（证件号非必传）</td>
-        </tr>
-        <tr>
-            <td>个人（自然人）签署</td>
-            <td>个人的真实名字、个人的触达手机号、个人的身份证（证件号非必传）</td>
-        </tr>
-    </tbody>
-</table>
+适用场景：在标准制式的合同场景中，可通过提前预制好模板文件，每次使用这个配置好的模板，补充合同内容信息及签署信息生成电子合同。
+## 1.1 传参方式指引
 
+| 签署方类型 | ApproverType | 需要提前准备的信息 | 对应 Approvers 关键字段 |
+|------|------|------|------|
+| 本企业员工（未认证加入） | 0 | 签署企业名、员工真实姓名、员工触达手机号、证件号（非必传） | OrganizationName + ApproverName + ApproverMobile |
+| 本企业员工（已认证加入） | 0 | 签署企业名、员工在电子签平台的 ID（UserId） | OrganizationName + UserId |
+| 他方企业员工 | 0 | 签署企业名、员工真实姓名、员工触达手机号、证件号（非必传） | OrganizationName + ApproverName + ApproverMobile |
+| 个人（自然人） | 1 | 个人真实姓名、个人触达手机号、身份证号（非必传） | ApproverName + ApproverMobile |
 
-注：配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">创建电子文档</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用。整体的逻辑如下图
+## 1.2 接口调用流程
+此接口需<font color="red">配合<a href="https://qian.tencent.com/developers/companyApis/startFlows/CreateDocument" target="_blank">创建电子文档</a>和<a href="https://qian.tencent.com/developers/companyApis/startFlows/StartFlow" target="_blank">发起签署流程</a>接口使用</font> 。整体的逻辑如下图
 
-![image](https://qcloudimg.tencent-cloud.cn/raw/1f38ebd7c5afed8763ad961741d81438.png)
+![image](https://qcloudimg.tencent-cloud.cn/raw/dbd2eba8200d812d76b7e9e34d739e75.svg)
 
-注：**静默（自动）签署不支持合同签署方存在填写**功能
+## 1.3 注意事项
+-  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考[合同撤销返还额度说明](https://qian.tencent.com/developers/company/contract_cancel_quota)。
+- 支持的证件类型可以参考[支持的证件类型](https://qian.tencent.com/developers/company/id_card_support)。
+- 合同发起方需要【组织管理】->【角色管理】中拥有<font color="red">接口发起合同</font>的权限
+![image](https://qcloudimg.tencent-cloud.cn/raw/c8553d1823ca1323e82c11f01c86e8cd.png)
 <br>
 
 <font color="red">相关视频指引</font> <br>
@@ -1029,7 +1009,7 @@ class Client extends abstract_client_1.AbstractClient {
 该接口需要依赖[上传文件](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口生成pdf资源编号（FileIds）进行使用。（如果非pdf文件需要调用[创建文件转换任务](https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFileConvertTask)接口转换成pdf资源）<br/>
 
 ## 整体流程图
-![image](https://qcloudimg.tencent-cloud.cn/raw/9577ac334c083ecfe0014a187d64b485.svg)
+![image](https://qcloudimg.tencent-cloud.cn/raw/9bf547fe0bc738f9a97b4b619dea0633.svg)
 
 注：
 -  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考[合同撤销返还额度说明](https://qian.tencent.com/developers/company/contract_cancel_quota)。

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

@@ -328,34 +328,33 @@ export declare class Client extends AbstractClient {
      */
     ChannelCreatePreparedPersonalEsign(req: ChannelCreatePreparedPersonalEsignRequest, cb?: (error: string, rep: ChannelCreatePreparedPersonalEsignResponse) => void): Promise<ChannelCreatePreparedPersonalEsignResponse>;
     /**
-     * 接口（ChannelCreateFlowByFiles）用PDF文件创建签署流程。
+     * 本接口（ChannelCreateFlowByFiles）用于通过**已上传的 PDF 资源编号**创建待签署的合同流程。
 
-适用场景：适用非制式的合同文件签署，开发者有每个签署流程的PDF，可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
+**适用场景**：适用于非制式的合同文件签署。当开发者已拥有每个签署流程完整的 PDF 文件时，可通过本接口传入完整的 PDF 文件及流程信息，生成待签署的合同流程。
 
-**注**:
-<ul>
-<li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
-<li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号（FileIds）进行使用。整体的逻辑如下图</li>
-</ul>
+### 1.1 调用依赖
 
-![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
-
-**可以作为发起方和签署方的角色列表**
-<table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
+本接口需依赖[文件上传接口](https://qian.tencent.com/developers/partnerApis/files/UploadFiles)生成 PDF 资源编号（FileId）后使用，整体逻辑如下图：
 
+![image](https://qcloudimg.tencent-cloud.cn/raw/985b4bf10a40d65fe7b016bb2f82c3df.svg)
 
-**注**:
-`1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+### 1.2  发起方和签署方
+<table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
 
-`2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
-`3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）`
+ <font color="red">发起方（第三方子企业 A 的企业与员工）必须完成实名</font>；作为**签署方**的第三方子企业 A 员工 / 个人自然人 / SaaS 平台企业员工 / 第三方子企业 B 员工等，其企业和个人可以未实名。
 
-`4. 静默（自动）签署不支持合同签署方存在填写功能`
+### 1.3 注意事项
+-  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考[合同撤销返还额度说明](https://qian.tencent.com/developers/partner/contract_cancel_quota)。
+- <font color="red">支持的证件类型</font>可以参考[支持的证件类型](https://qian.tencent.com/developers/partner/id_card_support)。
+- <font color="red">不同类型的签署方传参不同</font>，各类型签署方的信息传递方式详见 [【签署方入参指引】](https://qian.tencent.com/developers/partner/flow_approver)。
+- 如果合同正式发起前如需<font color="red">预览</font>效果，可参考 [【使用文件发起的预览】](https://qian.tencent.com/developers/partner/preview_guide#%E4%B8%80%E4%BD%BF%E7%94%A8%E6%96%87%E4%BB%B6%E5%8F%91%E8%B5%B7%E7%9A%84%E9%A2%84%E8%A7%88)
+- 关于填写方与签署方的<font color="red">填写、签署先后顺序</font>设置，详见 [【填写与签署顺序说明】](https://qian.tencent.com/developers/partner/fill_sign_order)。
+- 关于<font color="red">本企业自动签署与其他企业自动签署</font>的配置与使用，详见 [【自动签署】](https://qian.tencent.com/developers/partner/autosign_guide)。
 
-<font color="red">相关视频指引</font> <br>
-1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
-1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
+### 1.4 视频教程
+1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a>
+2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a>
      */
     ChannelCreateFlowByFiles(req: ChannelCreateFlowByFilesRequest, cb?: (error: string, rep: ChannelCreateFlowByFilesResponse) => void): Promise<ChannelCreateFlowByFilesResponse>;
     /**

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

@@ -392,34 +392,33 @@ class Client extends abstract_client_1.AbstractClient {
         return this.request("ChannelCreatePreparedPersonalEsign", req, cb);
     }
     /**
-     * 接口（ChannelCreateFlowByFiles）用PDF文件创建签署流程。
+     * 本接口（ChannelCreateFlowByFiles）用于通过**已上传的 PDF 资源编号**创建待签署的合同流程。
 
-适用场景：适用非制式的合同文件签署，开发者有每个签署流程的PDF，可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
+**适用场景**：适用于非制式的合同文件签署。当开发者已拥有每个签署流程完整的 PDF 文件时，可通过本接口传入完整的 PDF 文件及流程信息，生成待签署的合同流程。
 
-**注**:
-<ul>
-<li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
-<li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号（FileIds）进行使用。整体的逻辑如下图</li>
-</ul>
+### 1.1 调用依赖
 
-![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
-
-**可以作为发起方和签署方的角色列表**
-<table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
+本接口需依赖[文件上传接口](https://qian.tencent.com/developers/partnerApis/files/UploadFiles)生成 PDF 资源编号（FileId）后使用，整体逻辑如下图：
 
+![image](https://qcloudimg.tencent-cloud.cn/raw/985b4bf10a40d65fe7b016bb2f82c3df.svg)
 
-**注**:
-`1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+### 1.2  发起方和签署方
+<table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
 
-`2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
-`3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）`
+ <font color="red">发起方（第三方子企业 A 的企业与员工）必须完成实名</font>；作为**签署方**的第三方子企业 A 员工 / 个人自然人 / SaaS 平台企业员工 / 第三方子企业 B 员工等，其企业和个人可以未实名。
 
-`4. 静默（自动）签署不支持合同签署方存在填写功能`
+### 1.3 注意事项
+-  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考[合同撤销返还额度说明](https://qian.tencent.com/developers/partner/contract_cancel_quota)。
+- <font color="red">支持的证件类型</font>可以参考[支持的证件类型](https://qian.tencent.com/developers/partner/id_card_support)。
+- <font color="red">不同类型的签署方传参不同</font>，各类型签署方的信息传递方式详见 [【签署方入参指引】](https://qian.tencent.com/developers/partner/flow_approver)。
+- 如果合同正式发起前如需<font color="red">预览</font>效果，可参考 [【使用文件发起的预览】](https://qian.tencent.com/developers/partner/preview_guide#%E4%B8%80%E4%BD%BF%E7%94%A8%E6%96%87%E4%BB%B6%E5%8F%91%E8%B5%B7%E7%9A%84%E9%A2%84%E8%A7%88)
+- 关于填写方与签署方的<font color="red">填写、签署先后顺序</font>设置，详见 [【填写与签署顺序说明】](https://qian.tencent.com/developers/partner/fill_sign_order)。
+- 关于<font color="red">本企业自动签署与其他企业自动签署</font>的配置与使用，详见 [【自动签署】](https://qian.tencent.com/developers/partner/autosign_guide)。
 
-<font color="red">相关视频指引</font> <br>
-1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
-1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
+### 1.4 视频教程
+1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a>
+2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a>
      */
     async ChannelCreateFlowByFiles(req, cb) {
         return this.request("ChannelCreateFlowByFiles", req, cb);

package/tencentcloud/services/mps/v20190612/mps_models.d.ts

@@ -16671,7 +16671,7 @@ export interface AiReviewProhibitedAsrTaskInput {
  */
 export interface DescribeMediaMetaDataResponse {
     /**
-     * 媒体元信息。
+     * <p>媒体元信息。</p>
      */
     MetaData?: MediaMetaData;
     /**
@@ -26683,9 +26683,13 @@ export interface LowLightEnhanceConfig {
  */
 export interface DescribeMediaMetaDataRequest {
     /**
-     * 需要获取元信息的文件输入信息。
+     * <p>需要获取元信息的文件输入信息。</p>
      */
     InputInfo: MediaInputInfo;
+    /**
+     * <p>指定为slow时，增加接口超时时间</p><p>枚举值：</p><ul><li>slow： 增加接口超时时间</li></ul>
+     */
+    Mode?: string;
 }
 /**
  * DescribeImageTasks请求参数结构体

package/tencentcloud/services/ocr/v20181119/ocr_models.d.ts

@@ -2070,6 +2070,10 @@ export interface VatElectronicItemInfo {
      * <p>通行日期止</p>
      */
     DateEnd?: string;
+    /**
+     * <p>车架号</p>
+     */
+    VinNo?: string;
 }
 /**
  * 单词坐标信息
@@ -7042,105 +7046,109 @@ export interface ArithmeticOCRRequest {
  */
 export interface NonTaxIncomeBill {
     /**
-     * 发票名称
+     * <p>发票名称</p>
      */
     Title?: string;
     /**
-     * 发票号码
+     * <p>发票号码</p>
      */
     Number?: string;
     /**
-     * 发票代码
+     * <p>发票代码</p>
      */
     Code?: string;
     /**
-     * 校验码
+     * <p>校验码</p>
      */
     CheckCode?: string;
     /**
-     * 开票日期
+     * <p>开票日期</p>
      */
     Date?: string;
     /**
-     * 价税合计（小写）
+     * <p>价税合计（小写）</p>
      */
     Total?: string;
     /**
-     * 价税合计（大写）
+     * <p>价税合计（大写）</p>
      */
     TotalCn?: string;
     /**
-     * 交款人名称
+     * <p>交款人名称</p>
      */
     Buyer?: string;
     /**
-     * 交款人纳税人识别号
+     * <p>交款人纳税人识别号</p>
      */
     BuyerTaxID?: string;
     /**
-     * 收款人名称
+     * <p>收款人名称</p>
      */
     Seller?: string;
     /**
-     * 收款单位名称
+     * <p>收款单位名称</p>
      */
     SellerCompany?: string;
     /**
-     * 备注
+     * <p>备注</p>
      */
     Remark?: string;
     /**
-     * 币种
+     * <p>币种</p>
      */
     CurrencyCode?: string;
     /**
-     * 复核人
+     * <p>复核人</p>
      */
     Reviewer?: string;
     /**
-     * 是否存在二维码（1：有，0：无）
+     * <p>是否存在二维码（1：有，0：无）</p>
      */
     QRCodeMark?: number;
     /**
-     * 其他信息
+     * <p>其他信息</p>
      */
     OtherInfo?: string;
     /**
-     * 缴款码
+     * <p>缴款码</p>
      */
     PaymentCode?: string;
     /**
-     * 执收单位编码
+     * <p>执收单位编码</p>
      */
     ReceiveUnitCode?: string;
     /**
-     * 执收单位名称
+     * <p>执收单位名称</p>
      */
     Receiver?: string;
     /**
-     * 经办人
+     * <p>经办人</p>
      */
     Operator?: string;
     /**
-     * 付款人账号
+     * <p>付款人账号</p>
      */
     PayerAccount?: string;
     /**
-     * 付款人开户银行
+     * <p>付款人开户银行</p>
      */
     PayerBank?: string;
     /**
-     * 收款人账号
+     * <p>收款人账号</p>
      */
     ReceiverAccount?: string;
     /**
-     * 收款人开户银行
+     * <p>收款人开户银行</p>
      */
     ReceiverBank?: string;
     /**
-     * 条目
+     * <p>条目</p>
      */
     NonTaxItems?: Array<NonTaxItem>;
+    /**
+     * <p>票据名称</p>
+     */
+    BillName?: string;
 }
 /**
  * VerifyOfdVatInvoiceOCR请求参数结构体

package/tencentcloud/services/postgres/v20170312/postgres_models.d.ts

@@ -2540,6 +2540,10 @@ export interface ModifyDBInstanceParametersRequest {
  * CreateAuditLogFile返回参数结构体
  */
 export interface CreateAuditLogFileResponse {
+    /**
+     * <p>文件名称</p>
+     */
+    FileName?: string;
     /**
      * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
      */

package/tencentcloud/services/sms/v20210111/sms_models.d.ts

@@ -526,7 +526,7 @@ export interface SendSmsResponse {
  */
 export interface SendStatusStatisticsResponse {
     /**
-     * 发送数据统计响应包体。
+     * <p>发送数据统计响应包体。</p>
      */
     SendStatusStatistics?: SendStatusStatistics;
     /**
@@ -917,26 +917,23 @@ export interface PhoneNumberInfo {
  */
 export interface SendStatusStatisticsRequest {
     /**
-     * 起始时间，格式为yyyymmddhh，精确到小时，例如2024050113，表示2024年5月1号13时。
+     * <p>起始时间，格式为yyyymmddhh，精确到小时，例如2024050113，表示2024年5月1号13时。注：统计范围包含当前小时。</p><p>参数格式：yyyymmddhh</p>
      */
     BeginTime: string;
     /**
-     * 结束时间，格式为yyyymmddhh，精确到小时，例如2024050118，表示2024年5月1号18时。
-  注：EndTime 必须大于等于 BeginTime。
+     * <p>结束时间，格式为yyyymmddhh，精确到小时，例如2024050118，表示2024年5月1号18时。注：EndTime 必须大于等于 BeginTime，统计范围包含当前小时。</p><p>参数格式：yyyymmddhh</p>
      */
     EndTime: string;
     /**
-     * 短信 SdkAppId 在 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage)  添加应用后生成的实际 SdkAppId，示例如1400006666。
+     * <p>短信 SdkAppId 在 <a href="https://console.cloud.tencent.com/smsv2/app-manage">短信控制台</a>  添加应用后生成的实际 SdkAppId，示例如1400006666。</p>
      */
     SmsSdkAppId: string;
     /**
-     * 最大上限。
-  注：目前固定设置为0。
+     * <p>最大上限。<br>注：目前固定设置为0。</p>
      */
     Limit: number;
     /**
-     * 偏移量。
-  注：目前固定设置为0。
+     * <p>偏移量。<br>注：目前固定设置为0。</p>
      */
     Offset: number;
 }

package/tencentcloud/services/tcb/v20180608/tcb_models.d.ts

@@ -2466,6 +2466,11 @@ export interface ExecutePGSqlResponse {
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Columns?: Array<string>;
+    /**
+     * <p>字段类型名</p>
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    ColumnTypes?: Array<string>;
     /**
      * <p>数据行。每一行数据都是一个JSON串，将JSON进行反序列化将得到了每列的值。值可能是 null 或者 字符串，如果是 null 说明该列的值为 &lt;null&gt;，如果是字符串则为该列的值的字符串表示形式。</p>
   注意：此字段可能返回 null，表示取不到有效值。

package/tencentcloud/services/thpc/v20220401/thpc_models.d.ts

@@ -820,6 +820,10 @@ export interface DescribeClusterActivitiesRequest {
      * <p>返回数量，默认为20，最大值为100。关于<code>Limit</code>的更进一步介绍请参考 API <a href="https://cloud.tencent.com/document/api/213/15688">简介</a>中的相关小节。</p>
      */
     Limit?: number;
+    /**
+     * <li><strong>queue-name</strong></li> <p style="padding-left: 30px;">按照【<strong>队列名称</strong>】进行过滤。队列名称形如：compute。</p><p style="padding-left: 30px;">类型：String</p><p style="padding-left: 30px;">必选：否</p><p style="padding-left: 30px;">每次请求的<code>Filters</code>的上限为10，<code>Filter.Values</code>的上限为5。</p>
+     */
+    Filters?: Array<Filter>;
 }
 /**
  * DeleteQueue请求参数结构体