tencentcloud-sdk-nodejs 4.0.722 → 4.0.723

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

@@ -247,7 +247,7 @@ OPEN：公网属性， INTERNAL：内网属性。
   ExclusiveCluster?: ExclusiveCluster
   /**
    * 性能容量型规格。
-<ul><li>若需要创建性能容量型实例，则此参数必填，取值范围：<ul><li> SLA：超强型1规格。当您开通了超大型规格的性能容量型时，SLA对应超强型4规格 </li><li> clb.c2.medium：标准型规格 </li><li> clb.c3.small：高阶型1规格 </li><li> clb.c3.medium：高阶型2规格 </li><li> clb.c4.small：超强型1规格 </li><li> clb.c4.medium：超强型2规格 </li><li> clb.c4.large：超强型3规格 </li><li> clb.c4.xlarge：超强型4规格 </li>如需超大型规格（超强型2及以上），请提交[工单申请](https://console.cloud.tencent.com/workorder/category)。</ul></li><li>若需要创建共享型实例，则无需填写此参数。</li></ul>如需了解规格详情，请参见[实例规格对比](https://cloud.tencent.com/document/product/214/84689)。
+<ul><li>若需要创建性能容量型实例，则此参数必填，取值范围：<ul><li> SLA：超强型4规格 </li><li> clb.c2.medium：标准型规格 </li><li> clb.c3.small：高阶型1规格 </li><li> clb.c3.medium：高阶型2规格 </li><li> clb.c4.small：超强型1规格 </li><li> clb.c4.medium：超强型2规格 </li><li> clb.c4.large：超强型3规格 </li><li> clb.c4.xlarge：超强型4规格 </li></ul></li><li>若需要创建共享型实例，则无需填写此参数。</li></ul>如需了解规格详情，请参见[实例规格对比](https://cloud.tencent.com/document/product/214/84689)。
    */
   SlaType?: string
   /**
@@ -1735,14 +1735,14 @@ export interface SlaUpdateParam {
   LoadBalancerId: string
   /**
    * 性能容量型规格，取值范围：
-<li> SLA：超强型1规格。当您开通了超大型规格的性能容量型时，SLA对应超强型4规格 </li>
+<li> SLA：超强型4规格 </li>
 <li> clb.c2.medium：标准型规格 </li>
 <li> clb.c3.small：高阶型1规格 </li>
 <li> clb.c3.medium：高阶型2规格 </li>
 <li> clb.c4.small：超强型1规格 </li>
 <li> clb.c4.medium：超强型2规格 </li>
 <li> clb.c4.large：超强型3规格 </li>
-<li> clb.c4.xlarge：超强型4规格 </li>如需超大型规格（超强型2及以上），请提交[工单申请](https://console.cloud.tencent.com/workorder/category)。如需了解规格详情，请参见[实例规格对比](https://cloud.tencent.com/document/product/214/84689)
+<li> clb.c4.xlarge：超强型4规格 </li>如需了解规格详情，请参见[实例规格对比](https://cloud.tencent.com/document/product/214/84689)
    */
   SlaType: string
 }
@@ -5174,9 +5174,7 @@ BANDWIDTH_PACKAGE 按带宽包计费;
   /**
    * 最大出带宽，单位Mbps，仅对公网属性的共享型、性能容量型和独占型 CLB 实例、以及内网属性的性能容量型 CLB 实例生效。
 - 对于公网属性的共享型和独占型 CLB 实例，最大出带宽的范围为1Mbps-2048Mbps。
-- 对于公网属性和内网属性的性能容量型 CLB实例
-  - 默认为普通规格的性能容量型实例，SLA对应超强型1规格，最大出带宽的范围为1Mbps-10240Mbps。
-  - 当您开通了超大型规格的性能容量型时，最大出带宽的范围为1Mbps-61440Mbps。超大型规格的性能容量型正在内测中，请提交 [工单申请](https://console.cloud.tencent.com/workorder/category)。
+- 对于公网属性和内网属性的性能容量型 CLB实例，最大出带宽的范围为1Mbps-61440Mbps。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   InternetMaxBandwidthOut?: number

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

@@ -308,6 +308,8 @@ export class Client extends AbstractClient {
 >- 签署控件 SignComponents
 >- 生成模板的文件基础信息 FileInfos
 
+![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
+
 当模板较多或模板中的控件较多时，可以通过查询模板接口更方便的获取模板列表，以及每个模板内的控件信息。
 
 适用场景：
@@ -795,9 +797,10 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");
   }
 
   /**
-     * 创建企业扩展服务授权，当前仅支持授权 “企业自动签” 给企业员工。
+     * 创建企业扩展服务授权，当前仅支持授权 “企业自动签” 和 “批量签署” 给企业员工。
+该接口作用和电子签控制台 企业设置-扩展服务-企业自动签署和批量签署授权 两个模块功能相同，可通过该接口授权给企业员工。
 
-注：支持集团代子企业操作，请联系运营开通此功能。
+注：“企业自动签授权”支持集团代子企业操作，请联系运营开通此功能。
      */
   async CreateExtendedServiceAuthInfos(
     req: CreateExtendedServiceAuthInfosRequest,
@@ -1163,7 +1166,8 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");
   }
 
   /**
-     * 删除企业扩展服务授权，当前仅支持 “企业自动签” 取消授权。
+     * 删除企业扩展服务授权，当前仅支持 “企业自动签” 和“批量签署”  的取消授权。
+该接口作用和电子签控制台 企业设置-扩展服务-企业自动签署和批量签署授权 两个模块功能相同，可通过该接口取消企业员工授权。
 
 注：支持集团代子企业操作，请联系运营开通此功能。
      */

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

@@ -361,12 +361,10 @@ export interface CreateExtendedServiceAuthInfosRequest {
    */
   UserIds: Array<string>
   /**
-   * 要查询的扩展服务类型。
-默认为空，即查询当前支持的所有扩展服务信息。
-若需查询单个扩展服务的开通情况，请传递相应的值，如下所示：
+   * 取值
 <ul><li>OPEN_SERVER_SIGN：企业自动签</li>
+<li>BATCH_SIGN：批量签署</li>
 </ul>
-
    */
   ExtendServiceType?: string
   /**
@@ -405,36 +403,38 @@ export interface CreateMultiFlowSignQRCodeResponse {
 }
 
 /**
- * 签署链接信息
+ * 签署链接信息。
  */
 export interface FlowApproverUrlInfo {
   /**
-   * 签署链接(短链形式呈现)。请注意保密，不要将其外泄给无关用户。
-注: `注意该链接有效期为30分钟`
+   * 签署短链接。</br>
+注意:
+- 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
+- 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   SignUrl?: string
   /**
-   * 签署参与人类型 
-<ul><li> **1** :个人参与方</li></ul>
-
-注: `现在仅支持个人参与方`
+   * 签署人类型。
+- **1**: 个人
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ApproverType?: number
   /**
-   * 签署人姓名
+   * 签署人姓名。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ApproverName?: string
   /**
-   * 签署人手机号
+   * 签署人手机号。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ApproverMobile?: string
   /**
-   * 签署链接(长链形式呈现)。请注意保密，不要将其外泄给无关用户。
-注: `注意该链接有效期为30分钟`
+   * 签署长链接。</br>
+注意:
+- 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
+- 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   LongUrl?: string
@@ -2385,47 +2385,57 @@ export interface PdfVerifyResult {
    */
   VerifyResult?: number
   /**
-   * 签署平台，如果文件是在腾讯电子签平台签署，则返回腾讯电子签，如果文件不在腾讯电子签平台签署，则返回其他平台。
+   * 签署平台
+如果文件是在腾讯电子签平台签署，则为**腾讯电子签**，
+如果文件不在腾讯电子签平台签署，则为**其他平台**。
    */
   SignPlatform?: string
   /**
-   * 签署人名称
+   * 申请证书的主体的名字
+
+如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下
+**企业**:  ESS@企业名称@编码
+**个人**: ESS@个人姓名@证件号@808854
+
+如果在其他平台签署的, 主体的名字参考其他平台的说明
    */
   SignerName?: string
   /**
-   * 签署时间戳，单位秒
+   * 签署时间的Unix时间戳，单位毫秒
    */
   SignTime?: number
   /**
-   * 签名算法
+   * 证书签名算法,  如SHA1withRSA等算法
    */
   SignAlgorithm?: string
   /**
-   * 签名证书序列号
+   * CA供应商下发给用户的证书编号
+
+注意：`腾讯电子签接入多家CA供应商以提供容灾能力，不同CA下发的证书编号区别较大，但基本都是由数字和字母组成，长度在200以下`。
    */
   CertSn?: string
   /**
-   * 证书起始时间戳，单位毫秒
+   * 证书起始时间的Unix时间戳，单位毫秒
    */
   CertNotBefore?: number
   /**
-   * 证书过期时间戳，单位毫秒
+   * 证书过期时间的时间戳，单位毫秒
    */
   CertNotAfter?: number
   /**
-   * 签名域横坐标，单位pt
+   * 签名域横坐标，单位px
    */
   ComponentPosX?: number
   /**
-   * 签名域纵坐标，单位pt
+   * 签名域纵坐标，单位px
    */
   ComponentPosY?: number
   /**
-   * 签名域宽度，单位pt
+   * 签名域宽度，单位px
    */
   ComponentWidth?: number
   /**
-   * 签名域高度，单位pt
+   * 签名域高度，单位px
    */
   ComponentHeight?: number
   /**
@@ -6627,12 +6637,10 @@ export interface DeleteExtendedServiceAuthInfosRequest {
    */
   UserIds: Array<string>
   /**
-   * 要查询的扩展服务类型。
-默认为空，即查询当前支持的所有扩展服务信息。
-若需查询单个扩展服务的开通情况，请传递相应的值，如下所示：
+   * 取值如下所示：
 <ul><li>OPEN_SERVER_SIGN：企业自动签</li>
+<li>BATCH_SIGN：批量签署</li>
 </ul>
-
    */
   ExtendServiceType?: string
   /**

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

@@ -630,6 +630,8 @@ https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchAp
 - 发起方和签署方的填写控件 Components
 - 签署方的签署控件 SignComponents
 
+![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
+
 **适用场景**
  该接口常用来配合<a href="https://qian.tencent.com/developers/partnerApis/startFlows/CreateFlowsByTemplates" target="_blank">用模板创建签署流程</a>和<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates" target="_blank">通过多模板创建合同组签署流程</a>接口，作为创建合同的前置接口使用。 
 通过此接口查询到模板信息后，再通过调用创建合同的接口，指定模板ID，指定模板中需要的填写控件内容等，完成合同文档的的创建。
@@ -794,12 +796,13 @@ Web链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表
      * 提交申请出证报告任务并返回报告ID。
 
 注意：
-<ul><li>使用此功能`需搭配出证套餐` ，使用前请联系对接的客户经理沟通。</li>
-<li>操作人必须是`发起方或者签署方企业的(非走授权书认证)法人或者超管`。</li>
-<li>合同流程必须所有参与方`已经签署完成`。</li>
-<li>出证过程需一定时间，建议在`提交出证任务后的24小时之后`，通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。</li></ul>
+- 使用此功能**需搭配出证套餐**  ，使用前请联系对接的客户经理沟通。
+- 操作人必须是**发起方或者签署方企业的(非走授权书认证)法人或者超管**。
+- 合同流程必须**所有参与方已经签署完成**。
+- 出证过程需一定时间，建议在**提交出证任务后的24小时之后**，通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
+
 
-<svg id="SvgjsSvg1006" width="262" height="229" xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svgjs="http://svgjs.com/svgjs"><defs id="SvgjsDefs1007"><pattern patternUnits="userSpaceOnUse" id="pattern_mark_0" width="300" height="300"><text x="150" y="100" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><pattern patternUnits="userSpaceOnUse" id="pattern_mark_1" width="300" height="300"><text x="150" y="200" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><marker id="SvgjsMarker1021" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1022" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker></defs><rect id="svgbackgroundid" width="262" height="229" fill="transparent"></rect><rect id="SvgjsRect1009" width="262" height="229" fill="url(#pattern_mark_0)"></rect><rect id="SvgjsRect1010" width="262" height="229" fill="url(#pattern_mark_1)"></rect><g id="SvgjsG1011" transform="translate(31.75,25)"><path id="SvgjsPath1012" d="M 0 0L 198 0L 198 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1013"><text id="SvgjsText1014" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="178px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1015" dy="16" x="99"><tspan id="SvgjsTspan1016" style="text-decoration:;fill: rgb(28, 30, 33);">CreateFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1017" dy="16" x="99"><tspan id="SvgjsTspan1018" style="text-decoration:;fill: rgb(51, 51, 51);">提交申请出证报告任务</tspan></tspan></text></g></g><g id="SvgjsG1019"><path id="SvgjsPath1020" d="M130.75 84.5L130.75 114.5L130.75 114.5L130.75 143.2" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1021)"></path></g><g id="SvgjsG1023" transform="translate(25,145)"><path id="SvgjsPath1024" d="M 0 0L 211.5 0L 211.5 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1025"><text id="SvgjsText1026" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="192px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1027" dy="16" x="106"><tspan id="SvgjsTspan1028" style="text-decoration:;fill: rgb(28, 30, 33);">DescribeFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1029" dy="16" x="106"><tspan id="SvgjsTspan1030" style="text-decoration:;fill: rgb(51, 51, 51);">获取出证报告任务执行结果</tspan></tspan></text></g></g></svg>
+![image](https://dyn.ess.tencent.cn/guide/capi/channel_CreateChannelFlowEvidenceReport.png)
      */
   async CreateChannelFlowEvidenceReport(
     req: CreateChannelFlowEvidenceReportRequest,
@@ -895,10 +898,14 @@ Web链接访问后，会根据子客企业(**Agent中ProxyOrganizationOpenId表
   }
 
   /**
-     * 该接口用于发起合同后，生成C端签署人的签署链接<br/>
-注意：该接口目前签署人类型仅支持个人签署方（PERSON）<br/>
-注意：该接口可生成签署链接的C端签署人必须仅有手写签名和时间类型的签署控件<br/>
-注意：该接口返回的签署链接是用于APP集成的场景，支持APP打开或浏览器直接打开，不支持微信小程序嵌入。微信小程序请使用小程序跳转或半屏弹窗的方式<br/>
+     * 该接口用于发起合同后，生成个人用户的签署链接, 暂时不支持企业端签署。 <br/>
+
+`注意：`<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 ChannelCreateFlowSignUrl(
     req: ChannelCreateFlowSignUrlRequest,
@@ -1236,8 +1243,15 @@ httpProfile.setEndpoint("file.test.ess.tencent.cn");
   }
 
   /**
-   * 查询出证报告，返回报告 URL。
-   */
+     * 获取出证报告任务执行结果，返回报告 URL。
+
+注意：
+
+- 使用此功能`需搭配出证套餐` ，使用前请联系对接的客户经理沟通。
+- 需调用创建并返回出证报告接口<a href="https://qian.tencent.com/developers/partnerApis/certificate/CreateChannelFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>获取报告编号后调用当前接口获取报告链接。
+
+![image](https://dyn.ess.tencent.cn/guide/capi/channel_CreateChannelFlowEvidenceReport.png)
+     */
   async DescribeChannelFlowEvidenceReport(
     req: DescribeChannelFlowEvidenceReportRequest,
     cb?: (error: string, rep: DescribeChannelFlowEvidenceReportResponse) => void

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

@@ -374,6 +374,8 @@ export interface ChannelDeleteSealPoliciesRequest {
 export interface ChannelBatchCancelFlowsResponse {
   /**
    * 签署流程批量撤销失败原因，错误信息与流程Id一一对应，成功为"", 失败则对应失败原因
+
+注:  `如果全部撤销成功, 此数组为空数组`
    */
   FailMessages?: Array<string>
   /**
@@ -877,7 +879,7 @@ export interface ChannelCreateRoleRequest {
    */
   Description?: string
   /**
-   * 权限树，权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出
+   * 权限树，权限树内容 PermissionGroups 可参考接口 ChannelDescribeRoles 的输出
    */
   PermissionGroups?: Array<PermissionGroup>
 }
@@ -977,7 +979,7 @@ export interface ReleasedApprover {
    * 签署方经办人的证件类型，支持以下类型
 <ul><li>ID_CARD : 居民身份证  (默认值)</li>
 <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
-<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
    */
   IdCardType?: string
   /**
@@ -1246,27 +1248,34 @@ export interface DownloadFlowInfo {
 }
 
 /**
- * 签署人签署链接信息
+ * 签署人签署链接信息。
  */
 export interface FlowApproverUrlInfo {
   /**
-   * 签署短链接，不支持小程序嵌入，只支持移动端浏览器打开。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
+   * 签署短链接。</br>
+注意:
+- 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
+- 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
    */
-  SignUrl: string
+  SignUrl?: string
   /**
-   * 签署人类型 PERSON-个人
+   * 签署人类型。
+- **PERSON**: 个人
    */
-  ApproverType: string
+  ApproverType?: string
   /**
-   * 签署人姓名
+   * 签署人姓名。
    */
-  Name: string
+  Name?: string
   /**
-   * 签署人手机号
+   * 签署人手机号。
    */
-  Mobile: string
+  Mobile?: string
   /**
-   * 签署长链接，支持小程序嵌入。注意该链接有效期为30分钟，同时需要注意保密，不要外泄给无关用户。
+   * 签署长链接。</br>
+注意:
+- 该链接有效期为**30分钟**，同时需要注意保密，不要外泄给无关用户。
+- 该链接不支持小程序嵌入，仅支持**移动端浏览器**打开。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   LongUrl?: string
@@ -2140,12 +2149,18 @@ export interface StaffRole {
 export interface ChannelVerifyPdfRequest {
   /**
    * 合同流程ID，为32位字符串。
-可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
    */
   FlowId: string
   /**
-   * 代理企业和员工的信息。
-在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+   * 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+</ul>
+第三方平台子客企业和员工必须已经经过实名认证
    */
   Agent?: Agent
   /**
@@ -2160,14 +2175,15 @@ export interface ChannelVerifyPdfRequest {
  */
 export interface CreateChannelFlowEvidenceReportRequest {
   /**
-   * 员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+   * 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
 
 此接口下面信息必填。
 <ul>
-<li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
-<li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
-<li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
 </ul>
+第三方平台子客企业和员工必须已经经过实名认证
    */
   Agent: Agent
   /**
@@ -2358,17 +2374,12 @@ export interface ChannelVerifyPdfResponse {
 <ul><li>**1**：文件未被篡改，全部签名在腾讯电子签完成。</li>
 <li>**2**：文件未被篡改，部分签名在腾讯电子签完成。</li>
 <li>**3**：文件被篡改。</li>
-<li>**4**：异常：文件内没有签名域。</li>
+<li>**4**：异常：文件内没有签名域。(如果合同还没有签署也会返回此代码)</li>
 <li>**5**：异常：文件签名格式错误。</li></ul>
    */
   VerifyResult?: number
   /**
-   * 验签结果详情，每个签名域对应的验签结果。状态值如下
-<ul><li> **1** :验签成功，在电子签签署</li>
-<li> **2** :验签成功，在其他平台签署</li>
-<li> **3** :验签失败</li>
-<li> **4** :pdf文件没有签名域</li>
-<li> **5** :文件签名格式错误</li></ul>
+   * 验签结果详情，所有签署区(包括签名区, 印章区, 日期签署区,骑缝章等)的签署验签结果
    */
   PdfVerifyResults?: Array<PdfVerifyResult>
   /**
@@ -2731,65 +2742,82 @@ export interface ChannelCreateUserAutoSignSealUrlRequest {
 }
 
 /**
- * 合同文件验签单个结果结构体
+ * 合同验签每个签署区的信息
  */
 export interface PdfVerifyResult {
   /**
-   * 验签结果。0-签名域未签名；1-验签成功； 3-验签失败；4-未找到签名域：文件内没有签名域；5-签名值格式不正确。
+   * 验签结果详情，每个签名域对应的验签结果。状态值如下
+<ul><li> **1** :验签成功，在电子签签署</li>
+<li> **2** :验签成功，在其他平台签署</li>
+<li> **3** :验签失败</li>
+<li> **4** :pdf文件没有签名域</li>
+<li> **5** :文件签名格式错误</li></ul>
    */
-  VerifyResult: number
+  VerifyResult?: number
   /**
-   * 签署平台，如果文件是在腾讯电子签平台签署，则返回腾讯电子签，如果文件不在腾讯电子签平台签署，则返回其他平台。
+   * 签署平台
+如果文件是在腾讯电子签平台签署，则为**腾讯电子签**，
+如果文件不在腾讯电子签平台签署，则为**其他平台**。
    */
-  SignPlatform: string
+  SignPlatform?: string
   /**
-   * 签署人名称
+   * 申请证书的主体的名字
+
+如果是在腾讯电子签平台签署, 则对应的主体的名字个数如下
+**企业**:  ESS@企业名称@编码
+**个人**: ESS@个人姓名@证件号@808854
+
+如果在其他平台签署的, 主体的名字参考其他平台的说明
    */
-  SignerName: string
+  SignerName?: string
   /**
-   * 签署时间戳，单位秒
+   * 签署时间的Unix时间戳，单位毫秒
    */
-  SignTime: number
+  SignTime?: number
   /**
-   * 签名算法
+   * 证书签名算法,  如SHA1withRSA等算法
    */
-  SignAlgorithm: string
+  SignAlgorithm?: string
   /**
-   * 签名证书序列号
+   * CA供应商下发给用户的证书编号
+
+注意：`腾讯电子签接入多家CA供应商以提供容灾能力，不同CA下发的证书编号区别较大，但基本都是由数字和字母组成，长度在200以下`。
    */
-  CertSn: string
+  CertSn?: string
   /**
-   * 证书起始时间戳，单位秒
+   * 证书起始时间的Unix时间戳，单位毫秒
    */
-  CertNotBefore: number
+  CertNotBefore?: number
   /**
-   * 证书过期时间戳，单位秒
+   * 证书过期时间的时间戳，单位毫秒
    */
-  CertNotAfter: number
+  CertNotAfter?: number
   /**
-   * 签名类型
+   * 签名类型, 保留字段, 现在全部为0
+
+
    */
-  SignType: number
+  SignType?: number
   /**
    * 签名域横坐标，单位px
    */
-  ComponentPosX: number
+  ComponentPosX?: number
   /**
    * 签名域纵坐标，单位px
    */
-  ComponentPosY: number
+  ComponentPosY?: number
   /**
    * 签名域宽度，单位px
    */
-  ComponentWidth: number
+  ComponentWidth?: number
   /**
    * 签名域高度，单位px
    */
-  ComponentHeight: number
+  ComponentHeight?: number
   /**
    * 签名域所在页码，1～N
    */
-  ComponentPage: number
+  ComponentPage?: number
 }
 
 /**
@@ -4386,11 +4414,19 @@ export interface CreateFlowsByTemplatesResponse {
  */
 export interface DescribeChannelFlowEvidenceReportRequest {
   /**
-   * 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填
+   * 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+</ul>
+第三方平台子客企业和员工必须已经经过实名认证
    */
   Agent: Agent
   /**
-   * 出证报告编号
+   * 签署报告编号, 由<a href="https://qian.tencent.com/developers/partnerApis/certificate/CreateChannelFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>产生
    */
   ReportId: string
   /**
@@ -5045,7 +5081,7 @@ export interface ProxyOrganizationOperator {
    * 签署方经办人的证件类型，支持以下类型
 <ul><li>ID_CARD : 居民身份证  (默认值)</li>
 <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
-<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
 
    */
   IdCardType?: string
@@ -5438,7 +5474,7 @@ export interface ChannelModifyRoleRequest {
    */
   Description?: string
   /**
-   * 权限树，权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出
+   * 权限树，权限树内容 PermissionGroups 可参考接口 ChannelDescribeRoles的输出
    */
   PermissionGroups?: Array<PermissionGroup>
 }
@@ -6125,16 +6161,16 @@ export interface ChannelCreateReleaseFlowResponse {
  */
 export interface DescribeChannelFlowEvidenceReportResponse {
   /**
-   * 出证报告下载 URL
+   * 出证报告PDF的下载 URL，有效期为5分钟，超过有效期后将无法再下载。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ReportUrl?: string
   /**
-   * 出征任务的执行状态,状态列表如下
+   * 出证任务执行的状态, 状态含义如下：
 
-- EvidenceStatusExecuting : 出征任务正在执行中
-- EvidenceStatusSuccess : 出征任务执行成功
-- EvidenceStatusFailed : 出征任务执行失败
+<ul><li>**EvidenceStatusExecuting**：  出证任务在执行中</li>
+<li>**EvidenceStatusSuccess**：  出证任务执行成功</li>
+<li>**EvidenceStatusFailed** ： 出征任务执行失败</li></ul>
    */
   Status?: string
   /**
@@ -6265,15 +6301,28 @@ export interface ChannelUpdateSealStatusResponse {
  */
 export interface ChannelCreateFlowSignUrlRequest {
   /**
-   * 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填
+   * 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+<li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+</ul>
+第三方平台子客企业和员工必须已经经过实名认证
    */
   Agent: Agent
   /**
-   * 流程编号
+   * 合同流程ID，为32位字符串。
+建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
    */
   FlowId: string
   /**
-   * 流程签署人，其中Name和Mobile必传，其他可不传，ApproverType目前只支持PERSON类型的签署人，如果不传默认为该值。还需注意签署人只能有手写签名和时间类型的签署控件，其他类型的填写控件和签署控件暂时都未支持。
+   * 流程签署人列表，其中结构体的Name，Mobile和ApproverType必传，其他可不传。
+注:
+`1. ApproverType目前只支持个人(PERSON)类型的签署人。`
+`2. 签署人只能有手写签名和时间类型的签署控件，其他类型的填写控件和签署控件暂时都未支持。`
    */
   FlowApproverInfos: Array<FlowApproverInfo>
   /**
@@ -6287,7 +6336,7 @@ export interface ChannelCreateFlowSignUrlRequest {
    */
   Organization?: OrganizationInfo
   /**
-   * 签署完之后的H5页面的跳转链接，此链接支持http://和https://，最大长度1000个字符。
+   * 签署完之后的H5页面的跳转链接，此链接及支持http://和https://，最大长度1000个字符。(建议https协议)
    */
   JumpUrl?: string
 }