tencentcloud-sdk-nodejs-essbasic 4.0.715 → 4.0.717

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

@@ -172,9 +172,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     DescribeUsage(req: DescribeUsageRequest, cb?: (error: string, rep: DescribeUsageResponse) => void): Promise<DescribeUsageResponse>;
     /**
-       * 撤销签署流程接口，可以撤回：未全部签署完成；不可以撤回（终态）：已全部签署完成、已拒签、已过期、已撤回。
-  注意:
-  能撤回合同的只能是合同的发起人或者发起企业的超管、法人
+       * 撤销签署流程接口
+  
+  适用场景：如果某个合同流程当前至少还有一方没有签署，则可通过该接口取消该合同流程。常用于合同发错、内容填错，需要及时撤销的场景。
+  <ul><li> `可撤回合同状态` ：未全部签署完成</li>
+  <li> `不撤回合同状态` ：已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。</li></ul>
+  注:
+  <ul><li>能撤回合同的只能是 `合同的发起人或者发起方企业的超管、法人`  </li>
+  <li>签署完毕的合同需要双方走解除流程将合同作废，可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>。</li></ul>
        */
     ChannelCancelFlow(req: ChannelCancelFlowRequest, cb?: (error: string, rep: ChannelCancelFlowResponse) => void): Promise<ChannelCancelFlowResponse>;
     /**
@@ -256,8 +261,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     CreateFlowsByTemplates(req: CreateFlowsByTemplatesRequest, cb?: (error: string, rep: CreateFlowsByTemplatesResponse) => void): Promise<CreateFlowsByTemplatesResponse>;
     /**
-     * 企业方可以通过此接口关闭个人的自动签功能
-     */
+       * 通过此接口可以关闭个人用户自动签功能。
+  无需对应的用户刷脸等方式同意即可关闭。
+  
+  注意:
+  
+  <ul><li>处方单等特殊场景专用，此接口为白名单功能，使用前请联系对接的客户经理沟通。</li>
+  <li>如果此用户在开通时候绑定过个人自动签账号许可,  关闭此用户的自动签不会归还个人自动签账号许可的额度。</li></ul>
+       */
     ChannelDisableUserAutoSign(req: ChannelDisableUserAutoSignRequest, cb?: (error: string, rep: ChannelDisableUserAutoSignResponse) => void): Promise<ChannelDisableUserAutoSignResponse>;
     /**
        * 查询子客企业电子印章，需要操作者具有管理印章权限
@@ -283,49 +294,60 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     DescribeTemplates(req: DescribeTemplatesRequest, cb?: (error: string, rep: DescribeTemplatesResponse) => void): Promise<DescribeTemplatesResponse>;
     /**
-       * 创建跳转小程序查看或签署的链接。
+       * 创建跳转小程序查看或签署的链接
   
-  跳转小程序的几种方式：主要是设置不同的EndPoint
-  1. 通过链接Url直接跳转到小程序，不需要返回
-  设置EndPoint为WEIXINAPP，得到链接打开即可。（与短信提醒用户签署形式一样）。
-  
-  2. 通过链接Url打开H5引导页-->点击跳转到小程序-->签署完退出小程序-->回到H5引导页-->跳转到指定JumpUrl
-  设置EndPoint为CHANNEL，指定JumpUrl，得到链接打开即可。
-  
-  3. 客户App直接跳转到小程序-->小程序签署完成-->返回App
-  跳转到小程序的实现，参考官方文档
-  https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html
-  其中小程序的原始Id，请联系<对接技术人员>获取，或者查看小程序信息自助获取。
-  使用CreateSignUrls，设置EndPoint为APP，得到path。
-  
-  4. 客户小程序直接跳到电子签小程序-->签署完成退出电子签小程序-->回到客户小程序
-  跳转到小程序的实现，参考官方文档（分为全屏、半屏两种方式）
-  全屏方式：
-  （https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html ）
-  半屏方式：
-  （https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html ）
-  其中小程序的原始Id，请联系<对接技术人员>获取，或者查看小程序信息自助获取。
-  使用CreateSignUrls，设置EndPoint为APP，得到path。
-  
-  其中小程序的原始Id如下，或者查看小程序信息自助获取。
+  **腾讯电子签小程序的的AppID 和 原始Id如下:**
   
   | 小程序 | AppID | 原始ID |
   | ------------ | ------------ | ------------ |
   | 腾讯电子签（正式版） | wxa023b292fd19d41d | gh_da88f6188665 |
   | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
+  
+  **主要使用场景可以更加EndPoint分类如下**
+  
+  |EndPoint| 场景| 说明和示例|
+  |  ----  | ----  | --- |
+  |  WEIXINAPP  | 短链跳转腾讯电子签签署场景  |  点击链接打开电子签小程序（与腾讯电子签官方短信提醒用户签署形式一样）<br> 示例: https://essurl.cn/x9nvWU8fTg|
+  |  LONGURL2WEIXINAPP  | 长链跳转腾讯电子签签署场景  |  点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
+  |  CHANNEL  | 带有H5引导页的跳转腾讯电子签小程序签署场景 |  点击链接打开一个H5引导页面, 页面中有个"前往小程序"的按钮, 点击后会跳转到腾讯电子签小程序签署场景;  签署完成会回到H5引导页面, 然后跳转到指定创建链接指定的JumpUrl<br>示例: https://res.ess.tencent.cn/cdn/h5-activity-beta/jump-mp.html?use=channel-guide&type=warning&token=uIFKIU8fTd |
+  |APP| 贵方APP跳转腾讯电子签小程序签署场景|  贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方App的场景<br>跳转到腾讯电子签小程序的实现可以参考微信的官方文档:<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html" target="_blank">开放能力/打开 App</a> <br> 示例: pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
+  |APP| 贵方小程序跳转腾讯电子签小程序签署场景|  贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方小程序的场景<br>跳转到腾讯电子签小程序的实现可以参考微信官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" target="_blank">全屏方式</a>和<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html " target="_blank">半屏方式</a><br>此时返回的SignUrl就是官方文档中的path<br> 示例:pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3  |
        */
     CreateSignUrls(req: CreateSignUrlsRequest, cb?: (error: string, rep: CreateSignUrlsResponse) => void): Promise<CreateSignUrlsResponse>;
     /**
-       * 此接口（CreateConsoleLoginUrl）用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客控制台的唯一入口。
-  链接访问后，会根据企业的和员工的状态（企业根据ProxyOrganizationOpenId参数，员工根据OpenId参数判断），进入不同的流程，主要情况分类如下：
-  1. 若子客企业未激活，会进入企业激活流程，首次参与激活流程的经办人会成为超管。
-  2. 若子客企业已激活，员工未激活，则会进入经办人激活流程。
-  3. 若子客企业、经办人均已完成认证，则会直接进入子客Web控制台。
+       * 此接口（CreateConsoleLoginUrl）用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。
   
+  Web链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态，进入不同的流程，主要情况分类如下：
+  <table>
+  <thead>
+  <tr>
+  <th>子客企业状态</th>
+  <th>子客企业员工状态</th>
+  <th>点击链接进入的流程</th>
+  </tr>
+  </thead>
+  <tbody>
+  <tr>
+  <td>企业未激活</td>
+  <td>员工未认证</td>
+  <td>进入企业激活流程，首次完成企业激活流程的员工会成为超管</td>
+  </tr>
+  <tr>
+  <td>企业已激活</td>
+  <td>员工未认证</td>
+  <td>进入员认证并加入企业流程</td>
+  </tr>
+  <tr>
+  <td>企业已激活</td>
+  <td>员工已认证</td>
+  <td>进入子客企业Web控制台</td>
+  </tr>
+  </tbody>
+  </table>
   如果是企业激活流程，需要注意如下情况：
   
-  1. 若在激活过程中，更换用户OpenID重新生成链接，之前的认证会被清理。因此不要在认证过程中多人同时操作，导致认证过程互相影响。
-  2. 若您认证中发现信息有误需要重新认证，可以通过更换OpenID重新生成链接的方式，来清理掉已有的流程。
+  1. 若在激活过程中，**更换用户OpenID重新生成链接，之前的认证会被清理**。因此不要在企业认证过程生成多个链接给多人同时操作，会导致认证过程互相影响。
+  2. 若您认证中发现信息有误需要重新认证，**可通过更换用户OpenID重新生成链接的方式，来清理掉已有的流程**。
        */
     CreateConsoleLoginUrl(req: CreateConsoleLoginUrlRequest, cb?: (error: string, rep: CreateConsoleLoginUrlResponse) => void): Promise<CreateConsoleLoginUrlResponse>;
     /**
@@ -405,8 +427,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     ChannelCreateUserAutoSignSealUrl(req: ChannelCreateUserAutoSignSealUrlRequest, cb?: (error: string, rep: ChannelCreateUserAutoSignSealUrlResponse) => void): Promise<ChannelCreateUserAutoSignSealUrlResponse>;
     /**
-     * 企业方可以通过此接口查询个人用户自动签开启状态
-     */
+       * 通过此接口获取个人用户自动签的开通状态。
+  
+  注意: `处方单等特殊场景专用，此接口为白名单功能，使用前请联系对接的客户经理沟通。`
+       */
     ChannelDescribeUserAutoSignStatus(req: ChannelDescribeUserAutoSignStatusRequest, cb?: (error: string, rep: ChannelDescribeUserAutoSignStatusResponse) => void): Promise<ChannelDescribeUserAutoSignStatusResponse>;
     /**
      * 对合同流程文件进行数字签名验证，判断数字签名是否有效，合同文件内容是否被篡改。
@@ -436,18 +460,22 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
      */
     ChannelDescribeEmployees(req: ChannelDescribeEmployeesRequest, cb?: (error: string, rep: ChannelDescribeEmployeesResponse) => void): Promise<ChannelDescribeEmployeesResponse>;
     /**
-       * 指定需要批量撤销的签署流程Id，批量撤销合同
-  客户指定需要撤销的签署流程Id，最多100个，超过100不处理；
-  
-  可以撤回：未全部签署完成
-   不可以撤回：已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
-  
-  **满足撤销条件的合同会发起异步撤销流程，不满足撤销条件的合同返回失败原因。**
-  
-  **合同撤销成功后，会通过合同状态为 CANCEL 的回调消息通知调用方 [具体可参考回调消息](https://qian.tencent.com/developers/scenes/partner/callback_data_types#-%E5%90%88%E5%90%8C%E7%8A%B6%E6%80%81%E9%80%9A%E7%9F%A5---flowstatuschange)**
-  
-  **注意:
-  能撤回合同的只能是合同的发起人或者发起企业的超管、法人**
+       * 用于批量撤销合同流程<br/>
+  适用场景：
+  如果某些合同流程当前至少还有一方没有签署，则可通过该接口取消该合同流程。常用于合同发错、内容填错，需要及时撤销的场景。<br/>
+  通过签署流程编号批量撤销合同，单次最多支持撤销100份合同。只有合同的发起人或者发起方企业的超管/法人才能进行合同撤销。需要注意的是，若合同处于以下已终止状态，则不可撤销：<br/>
+  - 已全部签署完成
+  - 已拒签
+  - 已过期
+  - 已撤回
+  - 拒绝填写
+  - 已解除
+  
+  <br/>
+  满足撤销条件的合同会发起异步撤销流程，而不满足撤销条件的合同将返回失败原因。合同撤销成功后，会通过合同状态为 CANCEL 的回调消息通知调用方。具体的回调消息内容可参考 <a href="https://qian.tencent.com/developers/partner/callback_types_contracts_sign" target="_blank">合同状态变更回调消息</a>。
+  <br/><br/>
+  注:
+  `如果合同流程中的参与方均已签署完毕，则无法通过该接口撤销合同，`签署完毕的合同需要双方走解除流程将合同作废，可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程</a>接口。
        */
     ChannelBatchCancelFlows(req: ChannelBatchCancelFlowsRequest, cb?: (error: string, rep: ChannelBatchCancelFlowsResponse) => void): Promise<ChannelBatchCancelFlowsResponse>;
     /**
@@ -457,9 +485,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     PrepareFlows(req: PrepareFlowsRequest, cb?: (error: string, rep: PrepareFlowsResponse) => void): Promise<PrepareFlowsResponse>;
     /**
-       * 此接口（GetDownloadFlowUrl）用于创建电子签批量下载地址，让合作企业进入控制台直接下载，支持客户合同（流程）按照自定义文件夹形式 分类下载。
-  当前接口限制最多合同（流程）50个.
-  返回的链接只能使用一次
+       * 此接口（GetDownloadFlowUrl）用户获取合同控制台下载页面链接,  点击链接后会跳转至本企业合同管理控制台(会筛选出传入的合同列表), 点击**下载**按钮后就会下载传入的合同列表, 下载页面如下图
+  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_GetDownloadFlowUrl.png)
+  
+  注:
+  <ul>
+  <li>仅支持下载 **本企业** 下合同，链接会 **登录企业控制台** </li>
+  <li> **链接仅可使用一次**，不可重复使用</li>
+  </ul>
        */
     GetDownloadFlowUrl(req: GetDownloadFlowUrlRequest, cb?: (error: string, rep: GetDownloadFlowUrlResponse) => void): Promise<GetDownloadFlowUrlResponse>;
     /**
@@ -477,8 +510,18 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     ChannelDescribeRoles(req: ChannelDescribeRolesRequest, cb?: (error: string, rep: ChannelDescribeRolesResponse) => void): Promise<ChannelDescribeRolesResponse>;
     /**
-       * 根据签署流程信息批量获取资源下载链接，可以下载签署中、签署完的合同，需合作企业先进行授权。
-  此接口直接返回下载的资源的url，与接口GetDownloadFlowUrl跳转到控制台的下载方式不同。
+       * 获取合同流程PDF的下载链接，可以下载签署中、签署完的此子企业创建的合同
+  
+  **注意**:
+  有两种开通权限的途径
+  
+  **第一种**:   需第三方应用的子企业登录控制台进行授权,  授权在**企业中心**的**授权管理**区域,  界面如下图
+  授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
+  
+  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeResourceUrlsByFlows2.png)
+  
+  **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
+  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeResourceUrlsByFlows_appilications2.png)
        */
     DescribeResourceUrlsByFlows(req: DescribeResourceUrlsByFlowsRequest, cb?: (error: string, rep: DescribeResourceUrlsByFlowsResponse) => void): Promise<DescribeResourceUrlsByFlowsResponse>;
     /**
@@ -490,17 +533,23 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
      */
     ChannelCancelUserAutoSignEnableUrl(req: ChannelCancelUserAutoSignEnableUrlRequest, cb?: (error: string, rep: ChannelCancelUserAutoSignEnableUrlResponse) => void): Promise<ChannelCancelUserAutoSignEnableUrlResponse>;
     /**
-       * 此接口（UploadFiles）用于文件上传。
-  其中上传的文件，图片类型(png/jpg/jpeg)大小限制为5M，其他大小限制为60M。
-  调用时需要设置Domain, 正式环境为 file.ess.tencent.cn。
-  代码示例：
+       * 此接口（UploadFiles）文件上传。<br/>
+  
+  适用场景：用于合同，印章的文件上传。文件上传以后，
+  如果是PDF格式文件可配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>接口进行合同流程的发起
+  如果是其他类型可以配合<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务</a>接口转换成PDF文件
+  
+  注:
+  1. `图片类型(png/jpg/jpeg)限制大小为5M以下, PDF/word/excel等其他格式限制大小为60M以下`
+  2. `联调开发环境调用时需要设置Domain接口请求域名为 file.test.ess.tencent.cn，正式环境需要设置为file.ess.tencent.cn，代码示例`
+  ```
   HttpProfile httpProfile = new HttpProfile();
   httpProfile.setEndpoint("file.test.ess.tencent.cn");
+  ```
        */
     UploadFiles(req: UploadFilesRequest, cb?: (error: string, rep: UploadFilesResponse) => void): Promise<UploadFilesResponse>;
     /**
-       * 创建个人签署H5签署链接，请联系客户经理申请使用<br/>
-  该接口用于发起合同后，生成C端签署人的签署链接<br/>
+       * 该接口用于发起合同后，生成C端签署人的签署链接<br/>
   注意：该接口目前签署人类型仅支持个人签署方（PERSON）<br/>
   注意：该接口可生成签署链接的C端签署人必须仅有手写签名和时间类型的签署控件<br/>
   注意：该接口返回的签署链接是用于APP集成的场景，支持APP打开或浏览器直接打开，不支持微信小程序嵌入。微信小程序请使用小程序跳转或半屏弹窗的方式<br/>

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

@@ -215,9 +215,14 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("DescribeUsage", req, cb);
     }
     /**
-       * 撤销签署流程接口，可以撤回：未全部签署完成；不可以撤回（终态）：已全部签署完成、已拒签、已过期、已撤回。
-  注意:
-  能撤回合同的只能是合同的发起人或者发起企业的超管、法人
+       * 撤销签署流程接口
+  
+  适用场景：如果某个合同流程当前至少还有一方没有签署，则可通过该接口取消该合同流程。常用于合同发错、内容填错，需要及时撤销的场景。
+  <ul><li> `可撤回合同状态` ：未全部签署完成</li>
+  <li> `不撤回合同状态` ：已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。</li></ul>
+  注:
+  <ul><li>能撤回合同的只能是 `合同的发起人或者发起方企业的超管、法人`  </li>
+  <li>签署完毕的合同需要双方走解除流程将合同作废，可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程接口</a>。</li></ul>
        */
     async ChannelCancelFlow(req, cb) {
         return this.request("ChannelCancelFlow", req, cb);
@@ -309,8 +314,14 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("CreateFlowsByTemplates", req, cb);
     }
     /**
-     * 企业方可以通过此接口关闭个人的自动签功能
-     */
+       * 通过此接口可以关闭个人用户自动签功能。
+  无需对应的用户刷脸等方式同意即可关闭。
+  
+  注意:
+  
+  <ul><li>处方单等特殊场景专用，此接口为白名单功能，使用前请联系对接的客户经理沟通。</li>
+  <li>如果此用户在开通时候绑定过个人自动签账号许可,  关闭此用户的自动签不会归还个人自动签账号许可的额度。</li></ul>
+       */
     async ChannelDisableUserAutoSign(req, cb) {
         return this.request("ChannelDisableUserAutoSign", req, cb);
     }
@@ -344,51 +355,62 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("DescribeTemplates", req, cb);
     }
     /**
-       * 创建跳转小程序查看或签署的链接。
-  
-  跳转小程序的几种方式：主要是设置不同的EndPoint
-  1. 通过链接Url直接跳转到小程序，不需要返回
-  设置EndPoint为WEIXINAPP，得到链接打开即可。（与短信提醒用户签署形式一样）。
-  
-  2. 通过链接Url打开H5引导页-->点击跳转到小程序-->签署完退出小程序-->回到H5引导页-->跳转到指定JumpUrl
-  设置EndPoint为CHANNEL，指定JumpUrl，得到链接打开即可。
-  
-  3. 客户App直接跳转到小程序-->小程序签署完成-->返回App
-  跳转到小程序的实现，参考官方文档
-  https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html
-  其中小程序的原始Id，请联系<对接技术人员>获取，或者查看小程序信息自助获取。
-  使用CreateSignUrls，设置EndPoint为APP，得到path。
-  
-  4. 客户小程序直接跳到电子签小程序-->签署完成退出电子签小程序-->回到客户小程序
-  跳转到小程序的实现，参考官方文档（分为全屏、半屏两种方式）
-  全屏方式：
-  （https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html ）
-  半屏方式：
-  （https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html ）
-  其中小程序的原始Id，请联系<对接技术人员>获取，或者查看小程序信息自助获取。
-  使用CreateSignUrls，设置EndPoint为APP，得到path。
+       * 创建跳转小程序查看或签署的链接
   
-  其中小程序的原始Id如下，或者查看小程序信息自助获取。
+  **腾讯电子签小程序的的AppID 和 原始Id如下:**
   
   | 小程序 | AppID | 原始ID |
   | ------------ | ------------ | ------------ |
   | 腾讯电子签（正式版） | wxa023b292fd19d41d | gh_da88f6188665 |
   | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
+  
+  **主要使用场景可以更加EndPoint分类如下**
+  
+  |EndPoint| 场景| 说明和示例|
+  |  ----  | ----  | --- |
+  |  WEIXINAPP  | 短链跳转腾讯电子签签署场景  |  点击链接打开电子签小程序（与腾讯电子签官方短信提醒用户签署形式一样）<br> 示例: https://essurl.cn/x9nvWU8fTg|
+  |  LONGURL2WEIXINAPP  | 长链跳转腾讯电子签签署场景  |  点击链接打开电子签小程序, 是WEIXINAPP生成短链代表的那个长链|
+  |  CHANNEL  | 带有H5引导页的跳转腾讯电子签小程序签署场景 |  点击链接打开一个H5引导页面, 页面中有个"前往小程序"的按钮, 点击后会跳转到腾讯电子签小程序签署场景;  签署完成会回到H5引导页面, 然后跳转到指定创建链接指定的JumpUrl<br>示例: https://res.ess.tencent.cn/cdn/h5-activity-beta/jump-mp.html?use=channel-guide&type=warning&token=uIFKIU8fTd |
+  |APP| 贵方APP跳转腾讯电子签小程序签署场景|  贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方App的场景<br>跳转到腾讯电子签小程序的实现可以参考微信的官方文档:<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html" target="_blank">开放能力/打开 App</a> <br> 示例: pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3 |
+  |APP| 贵方小程序跳转腾讯电子签小程序签署场景|  贵方App直接跳转到小程序后, 在腾讯电子签小程序签署完成后返回贵方小程序的场景<br>跳转到腾讯电子签小程序的实现可以参考微信官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html" target="_blank">全屏方式</a>和<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html " target="_blank">半屏方式</a><br>此时返回的SignUrl就是官方文档中的path<br> 示例:pages/guide?from=default&where=mini& to=CONTRACT_DETAIL& id=yDwiBUUc*duRvquCSX8wd& shortKey=yDwivUA**W1yRsTre3  |
        */
     async CreateSignUrls(req, cb) {
         return this.request("CreateSignUrls", req, cb);
     }
     /**
-       * 此接口（CreateConsoleLoginUrl）用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客控制台的唯一入口。
-  链接访问后，会根据企业的和员工的状态（企业根据ProxyOrganizationOpenId参数，员工根据OpenId参数判断），进入不同的流程，主要情况分类如下：
-  1. 若子客企业未激活，会进入企业激活流程，首次参与激活流程的经办人会成为超管。
-  2. 若子客企业已激活，员工未激活，则会进入经办人激活流程。
-  3. 若子客企业、经办人均已完成认证，则会直接进入子客Web控制台。
+       * 此接口（CreateConsoleLoginUrl）用于创建第三方平台子客企业控制台Web/移动登录链接。支持web控制台、电子签小程序和H5链接。登录链接是进入子客web企业控制台的唯一入口。
   
+  Web链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表示**)和员工(**Agent中OpenId表示**)的状态，进入不同的流程，主要情况分类如下：
+  <table>
+  <thead>
+  <tr>
+  <th>子客企业状态</th>
+  <th>子客企业员工状态</th>
+  <th>点击链接进入的流程</th>
+  </tr>
+  </thead>
+  <tbody>
+  <tr>
+  <td>企业未激活</td>
+  <td>员工未认证</td>
+  <td>进入企业激活流程，首次完成企业激活流程的员工会成为超管</td>
+  </tr>
+  <tr>
+  <td>企业已激活</td>
+  <td>员工未认证</td>
+  <td>进入员认证并加入企业流程</td>
+  </tr>
+  <tr>
+  <td>企业已激活</td>
+  <td>员工已认证</td>
+  <td>进入子客企业Web控制台</td>
+  </tr>
+  </tbody>
+  </table>
   如果是企业激活流程，需要注意如下情况：
   
-  1. 若在激活过程中，更换用户OpenID重新生成链接，之前的认证会被清理。因此不要在认证过程中多人同时操作，导致认证过程互相影响。
-  2. 若您认证中发现信息有误需要重新认证，可以通过更换OpenID重新生成链接的方式，来清理掉已有的流程。
+  1. 若在激活过程中，**更换用户OpenID重新生成链接，之前的认证会被清理**。因此不要在企业认证过程生成多个链接给多人同时操作，会导致认证过程互相影响。
+  2. 若您认证中发现信息有误需要重新认证，**可通过更换用户OpenID重新生成链接的方式，来清理掉已有的流程**。
        */
     async CreateConsoleLoginUrl(req, cb) {
         return this.request("CreateConsoleLoginUrl", req, cb);
@@ -490,8 +512,10 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("ChannelCreateUserAutoSignSealUrl", req, cb);
     }
     /**
-     * 企业方可以通过此接口查询个人用户自动签开启状态
-     */
+       * 通过此接口获取个人用户自动签的开通状态。
+  
+  注意: `处方单等特殊场景专用，此接口为白名单功能，使用前请联系对接的客户经理沟通。`
+       */
     async ChannelDescribeUserAutoSignStatus(req, cb) {
         return this.request("ChannelDescribeUserAutoSignStatus", req, cb);
     }
@@ -533,18 +557,22 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("ChannelDescribeEmployees", req, cb);
     }
     /**
-       * 指定需要批量撤销的签署流程Id，批量撤销合同
-  客户指定需要撤销的签署流程Id，最多100个，超过100不处理；
+       * 用于批量撤销合同流程<br/>
+  适用场景：
+  如果某些合同流程当前至少还有一方没有签署，则可通过该接口取消该合同流程。常用于合同发错、内容填错，需要及时撤销的场景。<br/>
+  通过签署流程编号批量撤销合同，单次最多支持撤销100份合同。只有合同的发起人或者发起方企业的超管/法人才能进行合同撤销。需要注意的是，若合同处于以下已终止状态，则不可撤销：<br/>
+  - 已全部签署完成
+  - 已拒签
+  - 已过期
+  - 已撤回
+  - 拒绝填写
+  - 已解除
   
-  可以撤回：未全部签署完成
-   不可以撤回：已全部签署完成、已拒签、已过期、已撤回、拒绝填写、已解除等合同状态。
-  
-  **满足撤销条件的合同会发起异步撤销流程，不满足撤销条件的合同返回失败原因。**
-  
-  **合同撤销成功后，会通过合同状态为 CANCEL 的回调消息通知调用方 [具体可参考回调消息](https://qian.tencent.com/developers/scenes/partner/callback_data_types#-%E5%90%88%E5%90%8C%E7%8A%B6%E6%80%81%E9%80%9A%E7%9F%A5---flowstatuschange)**
-  
-  **注意:
-  能撤回合同的只能是合同的发起人或者发起企业的超管、法人**
+  <br/>
+  满足撤销条件的合同会发起异步撤销流程，而不满足撤销条件的合同将返回失败原因。合同撤销成功后，会通过合同状态为 CANCEL 的回调消息通知调用方。具体的回调消息内容可参考 <a href="https://qian.tencent.com/developers/partner/callback_types_contracts_sign" target="_blank">合同状态变更回调消息</a>。
+  <br/><br/>
+  注:
+  `如果合同流程中的参与方均已签署完毕，则无法通过该接口撤销合同，`签署完毕的合同需要双方走解除流程将合同作废，可以参考<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateReleaseFlow" target="_blank">发起解除合同流程</a>接口。
        */
     async ChannelBatchCancelFlows(req, cb) {
         return this.request("ChannelBatchCancelFlows", req, cb);
@@ -558,9 +586,14 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("PrepareFlows", req, cb);
     }
     /**
-       * 此接口（GetDownloadFlowUrl）用于创建电子签批量下载地址，让合作企业进入控制台直接下载，支持客户合同（流程）按照自定义文件夹形式 分类下载。
-  当前接口限制最多合同（流程）50个.
-  返回的链接只能使用一次
+       * 此接口（GetDownloadFlowUrl）用户获取合同控制台下载页面链接,  点击链接后会跳转至本企业合同管理控制台(会筛选出传入的合同列表), 点击**下载**按钮后就会下载传入的合同列表, 下载页面如下图
+  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_GetDownloadFlowUrl.png)
+  
+  注:
+  <ul>
+  <li>仅支持下载 **本企业** 下合同，链接会 **登录企业控制台** </li>
+  <li> **链接仅可使用一次**，不可重复使用</li>
+  </ul>
        */
     async GetDownloadFlowUrl(req, cb) {
         return this.request("GetDownloadFlowUrl", req, cb);
@@ -584,8 +617,18 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("ChannelDescribeRoles", req, cb);
     }
     /**
-       * 根据签署流程信息批量获取资源下载链接，可以下载签署中、签署完的合同，需合作企业先进行授权。
-  此接口直接返回下载的资源的url，与接口GetDownloadFlowUrl跳转到控制台的下载方式不同。
+       * 获取合同流程PDF的下载链接，可以下载签署中、签署完的此子企业创建的合同
+  
+  **注意**:
+  有两种开通权限的途径
+  
+  **第一种**:   需第三方应用的子企业登录控制台进行授权,  授权在**企业中心**的**授权管理**区域,  界面如下图
+  授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
+  
+  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeResourceUrlsByFlows2.png)
+  
+  **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
+  ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeResourceUrlsByFlows_appilications2.png)
        */
     async DescribeResourceUrlsByFlows(req, cb) {
         return this.request("DescribeResourceUrlsByFlows", req, cb);
@@ -603,19 +646,25 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("ChannelCancelUserAutoSignEnableUrl", req, cb);
     }
     /**
-       * 此接口（UploadFiles）用于文件上传。
-  其中上传的文件，图片类型(png/jpg/jpeg)大小限制为5M，其他大小限制为60M。
-  调用时需要设置Domain, 正式环境为 file.ess.tencent.cn。
-  代码示例：
+       * 此接口（UploadFiles）文件上传。<br/>
+  
+  适用场景：用于合同，印章的文件上传。文件上传以后，
+  如果是PDF格式文件可配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowByFiles" target="_blank">用PDF文件创建签署流程</a>接口进行合同流程的发起
+  如果是其他类型可以配合<a href="https://qian.tencent.com/developers/partnerApis/files/ChannelCreateConvertTaskApi" target="_blank">创建文件转换任务</a>接口转换成PDF文件
+  
+  注:
+  1. `图片类型(png/jpg/jpeg)限制大小为5M以下, PDF/word/excel等其他格式限制大小为60M以下`
+  2. `联调开发环境调用时需要设置Domain接口请求域名为 file.test.ess.tencent.cn，正式环境需要设置为file.ess.tencent.cn，代码示例`
+  ```
   HttpProfile httpProfile = new HttpProfile();
   httpProfile.setEndpoint("file.test.ess.tencent.cn");
+  ```
        */
     async UploadFiles(req, cb) {
         return this.request("UploadFiles", req, cb);
     }
     /**
-       * 创建个人签署H5签署链接，请联系客户经理申请使用<br/>
-  该接口用于发起合同后，生成C端签署人的签署链接<br/>
+       * 该接口用于发起合同后，生成C端签署人的签署链接<br/>
   注意：该接口目前签署人类型仅支持个人签署方（PERSON）<br/>
   注意：该接口可生成签署链接的C端签署人必须仅有手写签名和时间类型的签署控件<br/>
   注意：该接口返回的签署链接是用于APP集成的场景，支持APP打开或浏览器直接打开，不支持微信小程序嵌入。微信小程序请使用小程序跳转或半屏弹窗的方式<br/>