tencentcloud-sdk-nodejs-essbasic 4.0.721 → 4.0.723

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

@@ -374,6 +374,8 @@ export interface ChannelDeleteSealPoliciesRequest {
 export interface ChannelBatchCancelFlowsResponse {
   /**
    * 签署流程批量撤销失败原因，错误信息与流程Id一一对应，成功为"", 失败则对应失败原因
+
+注:  `如果全部撤销成功, 此数组为空数组`
    */
   FailMessages?: Array<string>
   /**
@@ -504,17 +506,26 @@ export interface AuthFailMessage {
  */
 export interface DescribeFlowDetailInfoRequest {
   /**
-   * 应用相关信息。 此接口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
   /**
-   * 合同(流程)编号数组，最多支持100个。
-<br/>备注：该参数和合同组编号必须二选一, 如果填写FlowGroupId则忽略此FlowIds的入参
+   * 需要查询的流程ID列表，最多可传入100个ID。
+如果要查询合同组的信息，则不需要传入此参数，只需传入 FlowGroupId 参数即可。
    */
   FlowIds?: Array<string>
   /**
-   * 合同组编号
-<br/>备注：该参数和合同(流程)编号数组必须二选一
+   * 需要查询的流程组ID，如果传入此参数，则会忽略 FlowIds 参数。
+
+合同组由<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByTemplates" target="_blank">通过多模板创建合同组签署流程</a>和<a href="https://qian.tencent.com/developers/partnerApis/startFlows/ChannelCreateFlowGroupByFiles" target="_blank">通过多文件创建合同组签署流程</a>等接口创建。
    */
   FlowGroupId?: string
   /**
@@ -868,7 +879,7 @@ export interface ChannelCreateRoleRequest {
    */
   Description?: string
   /**
-   * 权限树，权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出
+   * 权限树，权限树内容 PermissionGroups 可参考接口 ChannelDescribeRoles 的输出
    */
   PermissionGroups?: Array<PermissionGroup>
 }
@@ -936,68 +947,78 @@ export interface BaseFlowInfo {
 }
 
 /**
- * 解除协议的签署人，如不指定，默认使用待解除流程（即原流程）中的签署人。
-注意：不支持更换C端（个人身份类型）签署人，如果原流程中含有C端签署人，默认使用原流程中的该签署人。
-注意：目前不支持替换C端（个人身份类型）签署人，但是可以指定C端签署人的签署方自定义控件别名，具体见参数ApproverSignRole描述。 
-注意：当指定C端签署人的签署方自定义控件别名不空时，除参数ApproverNumber外，可以只参数ApproverSignRole。
+ * 解除协议的签署人，如不指定，默认使用待解除流程(原流程)中的签署人。</br>
+`注意`:
+ - 不支持更换C端(个人身份类型)签署人，如果原流程中含有C端签署人，默认使用原流程中的该签署人。
+ - 目前不支持替换C端(个人身份类型)签署人，但是可以指定C端签署人的签署方自定义控件别名，具体见参数ApproverSignRole描述。 
+ - 当指定C端签署人的签署方自定义控件别名不空时，除参数ApproverNumber外，可以只传参数ApproverSignRole。
 
-如果需要指定B端（机构身份类型）签署人，其中ReleasedApprover需要传递的参数如下：
-ApproverNumber, OrganizationName, ApproverType必传。
-对于其他身份标识
-- 子客企业指定经办人：OpenId必传，OrganizationOpenId必传；
-- 非子客企业：Name、Mobile必传。
+如果需要指定B端(企业身份类型)签署人，其中ReleasedApprover需要传递的参数如下：
+`ApproverNumber`, `OrganizationName`, `ApproverType`必传。</br>
+对于其他身份标识：
+- **子客企业指定经办人**：OpenId必传，OrganizationOpenId必传；
+- **非子客企业经办人**：Name、Mobile必传。
  */
 export interface ReleasedApprover {
   /**
-   * 企业签署方工商营业执照上的企业名称，签署方为非发起方企业场景下必传，最大长度64个字符
-   */
-  OrganizationName: string
-  /**
-   * 签署人在原流程中的签署人列表中的顺序序号（从0开始，按顺序依次递增），如果不清楚原流程中的签署人列表，可以通过DescribeFlows接口查看
+   * 签署人在原合同签署人列表中的顺序序号(从0开始，按顺序依次递增)。</br>
+可以通过<a href="https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo" target="_blank">DescribeFlowDetailInfo</a>接口查看原流程中的签署人列表。
    */
   ApproverNumber: number
   /**
-   * 签署人类型，目前仅支持
-ORGANIZATION-企业
-ENTERPRISESERVER-企业静默签
+   * 指定签署人类型，目前支持
+<ul><li> **ORGANIZATION**：企业（默认值）</li>
+<li> **ENTERPRISESERVER**：企业静默签</li></ul>
    */
   ApproverType: string
   /**
-   * 签署人姓名，最大长度50个字符
+   * 签署人姓名，最大长度50个字。
    */
   Name?: string
   /**
-   * 签署人身份证件类型
-1.ID_CARD 居民身份证
-2.HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证
-3.HONGKONG_AND_MACAO 港澳居民来往内地通行证
+   * 签署方经办人的证件类型，支持以下类型
+<ul><li>ID_CARD : 居民身份证  (默认值)</li>
+<li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
    */
   IdCardType?: string
   /**
-   * 签署人证件号
+   * 证件号码，应符合以下规则
+<ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+<li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+<li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
    */
   IdCardNumber?: string
   /**
-   * 签署人手机号，脱敏显示。大陆手机号为11位，暂不支持海外手机号
+   * 签署人手机号。
    */
   Mobile?: string
   /**
-   * 企业签署方在同一第三方应用下的其他合作企业OpenId，签署方为非发起方企业场景下必传，最大长度64个字符
+   * 组织机构名称。
+请确认该名称与企业营业执照中注册的名称一致。
+如果名称中包含英文括号()，请使用中文括号（）代替。
+如果签署方是企业签署方(approverType = 0 或者 approverType = 3)， 则企业名称必填。
+   */
+  OrganizationName?: string
+  /**
+   * 第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样, 可以参考<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#agent" target="_blank">Agent结构体</a>。</br>
+当为子客企业指定经办人时，此OrganizationOpenId必传。
    */
   OrganizationOpenId?: string
   /**
-   * 用户侧第三方id，最大长度64个字符
-当签署方为同一第三方应用下的员工时，该字必传
+   * 第三方平台子客企业员工的唯一标识，长度不能超过64，只能由字母和数字组成。</br>
+当签署方为同一第三方平台下的员工时，此OpenId必传。
    */
   OpenId?: string
   /**
-   * 签署控件类型，支持自定义企业签署方的签署控件为“印章”或“签名”
-- SIGN_SEAL-默认为印章控件类型
-- SIGN_SIGNATURE-手写签名控件类型
+   * 签署控件类型，支持自定义企业签署方的签署控件类型
+<ul><li> **SIGN_SEAL**：默认为印章控件类型(默认值)</li>
+<li> **SIGN_SIGNATURE**：手写签名控件类型</li></ul>
    */
   ApproverSignComponentType?: string
   /**
-   * 签署方自定义控件别名，最大长度20个字符
+   * 参与方在合同中的角色是按照创建合同的时候来排序的，解除协议默认会将第一个参与人叫`甲方`,第二个叫`乙方`,  第三个叫`丙方`，以此类推。</br>
+如果需改动此参与人的角色名字，可用此字段指定，由汉字,英文字符,数字组成，最大20个字。
    */
   ApproverSignRole?: string
 }
@@ -1227,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
@@ -1707,25 +1735,26 @@ export interface ChannelCreateFlowByFilesResponse {
  */
 export interface DescribeFlowDetailInfoResponse {
   /**
-   * 第三方平台应用号Id
+   * 合同归属的第三方平台应用号ID
    */
   ApplicationId?: string
   /**
-   * 第三方平台子客企业OpenId
+   * 合同归属的第三方平台子客企业OpenId
    */
   ProxyOrganizationOpenId?: string
   /**
-   * 合同(签署流程)的具体详细描述信息
+   * 合同流程的详细信息。
+如果查询的是合同组信息，则返回的是组内所有子合同流程的详细信息。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   FlowInfo?: Array<FlowDetailInfo>
   /**
-   * 合同组编号
+   * 合同组ID，只有在查询合同组信息时才会返回。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   FlowGroupId?: string
   /**
-   * 合同组名称
+   * 合同组名称，只有在查询合同组信息时才会返回。
 注意：此字段可能返回 null，表示取不到有效值。
    */
   FlowGroupName?: string
@@ -2120,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
   /**
@@ -2140,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
   /**
@@ -2338,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>
   /**
@@ -2711,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
 }
 
 /**
@@ -3662,15 +3710,25 @@ export interface ChannelDeleteRoleUsersResponse {
  */
 export interface SyncProxyOrganizationOperatorsRequest {
   /**
-   * 应用相关信息。 此接口Agent.AppId 和 Agent.ProxyOrganizationOpenId必填。
+   * 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+此接口下面信息必填。
+<ul>
+<li>渠道应用标识:  Agent.AppId</li>
+<li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+</ul>
+第三方平台子客企业必须已经经过实名认证
    */
   Agent: Agent
   /**
-   * 操作类型，新增:"CREATE"，修改:"UPDATE"，离职:"RESIGN"
+   * 操作类型，对应的操作
+<ul><li> **CREATE** :新增员工</li>
+<li> **UPDATE** :修改员工</li>
+<li> **RESIGN** :离职员工</li></ul>
    */
   OperatorType: string
   /**
-   * 经办人信息列表，最大长度200
+   * 员工信息列表，最多支持200个
    */
   ProxyOrganizationOperators: Array<ProxyOrganizationOperator>
   /**
@@ -4256,56 +4314,58 @@ export interface ChannelCreatePreparedPersonalEsignRequest {
  */
 export interface FlowDetailInfo {
   /**
-   * 合同(流程)的Id
+   * 合同流程ID，为32位字符串。
    */
-  FlowId: string
+  FlowId?: string
   /**
-   * 合同(流程)的名字
+   * 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
    */
-  FlowName: string
+  FlowName?: string
   /**
-   * 合同(流程)的类型
+   * 合同流程的类别分类（如销售合同/入职合同等）。
    */
-  FlowType: string
+  FlowType?: string
   /**
-   * 合同(流程)的状态, 状态如下
-
-INIT 合同创建
-PART 合同签署中
-REJECT 合同拒签
-ALL 合同签署完成
-DEADLINE 合同流签(合同过期)
-CANCEL 合同撤回
-RELIEVED 解除协议（已解除）
+   * 合同流程当前的签署状态, 会存在下列的状态值
+<ul><li> **INIT** :合同创建</li>
+<li> **PART** :合同签署中(至少有一个签署方已经签署)</li>
+<li> **REJECT** :合同拒签</li>
+<li> **ALL** :合同签署完成</li>
+<li> **DEADLINE** :合同流签(合同过期)</li>
+<li> **CANCEL** :合同撤回</li>
+<li> **RELIEVED** :解除协议（已解除）</li></ul>
  
    */
-  FlowStatus: string
+  FlowStatus?: string
   /**
-   * 合同(流程)的信息
+   * 当合同流程状态为已拒签（即 FlowStatus=REJECT）或已撤销（即 FlowStatus=CANCEL ）时，此字段 FlowMessage 为拒签或撤销原因。
    */
-  FlowMessage: string
+  FlowMessage?: string
   /**
-   * 合同(流程)的创建时间戳，单位秒
+   * 合同流程的创建时间戳，格式为Unix标准时间戳（秒）。
    */
-  CreateOn: number
+  CreateOn?: number
   /**
-   * 合同(流程)的签署截止时间戳，单位秒
+   * 签署流程的签署截止时间, 值为unix时间戳, 精确到秒。
    */
-  DeadLine: number
+  DeadLine?: number
   /**
-   * 用户自定义数据
+   * 调用方自定义的个性化字段(可自定义此字段的值)，并以base64方式编码，支持的最大数据大小为 1000长度。
+在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。
    */
-  CustomData: string
+  CustomData?: string
   /**
-   * 合同(流程)的签署人数组
+   * 合同流程的签署方数组
    */
-  FlowApproverInfos: Array<FlowApproverDetail>
+  FlowApproverInfos?: Array<FlowApproverDetail>
   /**
-   * 合同(流程)关注方信息列表
+   * 合同流程的关注方信息数组
    */
   CcInfos?: Array<FlowApproverDetail>
   /**
-   * 是否需要发起前审批，当NeedCreateReview为true，表明当前流程是需要发起前审核的合同，可能无法进行查看，签署操作，需要等审核完成后，才可以继续后续流程
+   * 是否需要发起前审批
+<ul><li>当NeedCreateReview为true，表明当前流程是需要发起前审核的合同，可能无法进行查看，签署操作，需要等审核完成后，才可以继续后续流程</li>
+<li>当NeedCreateReview为false，不需要发起前审核的合同</li></ul>
    */
   NeedCreateReview?: boolean
 }
@@ -4354,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
   /**
@@ -4387,14 +4455,15 @@ export interface ChannelCreateRoleResponse {
  */
 export interface SyncProxyOrganizationOperatorsResponse {
   /**
-   * Status 同步状态,全部同步失败接口会直接报错
-1-成功 
-2-部分成功
+   *  同步的状态,  全部同步失败接口是接口会直接报错
+
+<ul><li> **1** :全部成功</li>
+<li> **2** :部分成功</li></ul>
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Status?: number
   /**
-   * 同步失败经办人及其失败原因
+   * 同步失败员工ID及其失败原因
 注意：此字段可能返回 null，表示取不到有效值。
    */
   FailedList?: Array<SyncFailReason>
@@ -4996,22 +5065,24 @@ export interface ApproverOption {
 }
 
 /**
- * 合作企业经办人列表信息
+ * 同步的员工的信息
  */
 export interface ProxyOrganizationOperator {
   /**
-   * 对应Agent-ProxyOperator-OpenId。第三方应用平台自定义，对子客企业员的唯一标识。一个OpenId在一个子客企业内唯一对应一个真实员工，不可在其他子客企业内重复使用。（例如，可以使用经办人企业名+员工身份证的hash值，需要第三方应用平台保存），最大64位字符串
+   * 员工的唯一标识(即OpenId),  定义Agent中的OpenId一样, 可以参考<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#agent" target="_blank">Agent结构体</a>
    */
   Id: string
   /**
-   * 经办人姓名，最大长度50个字符
+   * 员工的姓名，最大长度50个字符
+员工的姓名将用于身份认证和电子签名，请确保填写的姓名为真实姓名，而非昵称等代名。
    */
   Name?: string
   /**
-   * 经办人身份证件类型
-1.ID_CARD 居民身份证
-2.HONGKONG_MACAO_AND_TAIWAN 港澳台居民居住证
-3.HONGKONG_AND_MACAO 港澳居民来往内地通行证
+   * 签署方经办人的证件类型，支持以下类型
+<ul><li>ID_CARD : 居民身份证  (默认值)</li>
+<li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+<li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
+
    */
   IdCardType?: string
   /**
@@ -5019,14 +5090,12 @@ export interface ProxyOrganizationOperator {
    */
   IdCardNumber?: string
   /**
-   * 经办人手机号，大陆手机号输入11位，暂不支持海外手机号。
+   * 员工的手机号，支持国内手机号11位数字(无需加+86前缀或其他字符)，不支持海外手机号。
    */
   Mobile?: string
   /**
-   * 默认角色，值为以下三个对应的英文：
-业务管理员：admin
-经办人：channel-normal-operator
-业务员：channel-sales-man
+   * 预先分配员工的角色, 可以分配的角色如下:
+<table> <thead> <tr> <th>可以分配的角色</th> <th>角色名称</th> <th>角色描述</th> </tr> </thead> <tbody> <tr> <td>admin</td> <td>业务管理员（IT 系统负责人，e.g. CTO）</td> <td>有企业合同模块、印章模块、模板模块等全量功能及数据权限。</td> </tr> <tr> <td>channel-normal-operator</td> <td>经办人（企业法务负责人）</td> <td>有发起合同、签署合同（含填写、拒签）、撤销合同、持有印章等权限能力，可查看企业所有合同数据。</td> </tr> <tr> <td>channel-sales-man</td> <td>业务员（一般为销售员、采购员）</td> <td>有发起合同、签署合同（含填写、拒签）、撤销合同、持有印章等权限能力，可查看自己相关所有合同数据。</td> </tr> </tbody> </table>
    */
   DefaultRole?: string
 }
@@ -5405,7 +5474,7 @@ export interface ChannelModifyRoleRequest {
    */
   Description?: string
   /**
-   * 权限树，权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出
+   * 权限树，权限树内容 PermissionGroups 可参考接口 ChannelDescribeRoles的输出
    */
   PermissionGroups?: Array<PermissionGroup>
 }
@@ -5989,19 +6058,18 @@ export interface CreateChannelFlowEvidenceReportResponse {
 }
 
 /**
- * 同步经办人失败原因
+ * 同步员工失败原因
  */
 export interface SyncFailReason {
   /**
-   * 对应Agent-ProxyOperator-OpenId。第三方应用平台自定义，对子客企业员的唯一标识。一个OpenId在一个子客企业内唯一对应一个真实员工，不可在其他子客企业内重复使用。（例如，可以使用经办人企业名+员工身份证的hash值，需要第三方应用平台保存），最大64位字符串
+   * 企业员工标识(即OpenId)
    */
-  Id: string
+  Id?: string
   /**
-   * 失败原因
-例如：Id不符合规范、证件号码不合法等
+   * 新增员工或者员工离职失败原因, 可能存证ID不符合规范、证件号码不合法等原因
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  Message: string
+  Message?: string
 }
 
 /**
@@ -6093,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
   /**
@@ -6233,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>
   /**
@@ -6255,7 +6336,7 @@ export interface ChannelCreateFlowSignUrlRequest {
    */
   Organization?: OrganizationInfo
   /**
-   * 签署完之后的H5页面的跳转链接，此链接支持http://和https://，最大长度1000个字符。
+   * 签署完之后的H5页面的跳转链接，此链接及支持http://和https://，最大长度1000个字符。(建议https协议)
    */
   JumpUrl?: string
 }