tencentcloud-sdk-nodejs-essbasic 4.0.720 → 4.0.722

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

@@ -373,7 +373,7 @@ export interface ChannelDeleteSealPoliciesRequest {
  */
 export interface ChannelBatchCancelFlowsResponse {
   /**
-   * 签署流程批量撤销失败原因，错误信息与流程Id一一对应，成功为“”,失败则对应失败消息
+   * 签署流程批量撤销失败原因，错误信息与流程Id一一对应，成功为"", 失败则对应失败原因
    */
   FailMessages?: Array<string>
   /**
@@ -504,17 +504,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
   /**
@@ -936,68 +945,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>
    */
   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
 }
@@ -1707,25 +1726,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
@@ -1973,26 +1993,26 @@ export interface ChannelRole {
 }
 
 /**
- * 流程中参与方的信息结构
+ * 流程中签署方和填写方(如果有填写控件存证时)的信息
  */
 export interface Recipient {
   /**
-   * 签署人唯一标识，在通过模板发起合同的时候对应签署方ID
+   * 合同参与方的角色ID
    */
   RecipientId?: string
   /**
-   * 参与者类型，默认为空。
-ENTERPRISE-企业；
-INDIVIDUAL-个人；
-PROMOTER-发起方
+   * 参与者类型, 可以选择的类型如下:
+<ul><li> **ENTERPRISE** :此角色为企业参与方</li>
+<li> **INDIVIDUAL** :此角色为个人参与方</li>
+<li> **PROMOTER** :此角色是发起方</li></ul>
    */
   RecipientType?: string
   /**
-   * 描述信息
+   * 合同参与方的角色描述，长度不能超过100，只能由中文、字母、数字和下划线组成。
    */
   Description?: string
   /**
-   * 角色名称
+   * 合同参与方的角色名字，长度不能超过20，只能由中文、字母、数字和下划线组成。
    */
   RoleName?: string
   /**
@@ -2802,36 +2822,43 @@ export interface UserThreeFactor {
  */
 export interface ChannelCreateUserAutoSignEnableUrlRequest {
   /**
-   * 渠道应用相关信息
+   * 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
    */
   Agent: Agent
   /**
-   * 自动签场景:
-E_PRESCRIPTION_AUTO_SIGN 电子处方
+   * 自动签使用的场景值, 可以选择的场景值如下:
+<ul><li> **E_PRESCRIPTION_AUTO_SIGN** :  电子处方场景</li></ul>
+
+注: `现在仅支持电子处方场景`
    */
   SceneKey: string
   /**
-   * 操作人信息
+   * 执行本接口操作的员工信息。
+注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
    */
   Operator?: UserInfo
   /**
-   * 自动签开通，签署相关配置
+   * 自动签开通配置信息, 包括开通的人员的信息等
    */
   AutoSignConfig?: AutoSignConfig
   /**
-   * 链接类型，空-默认小程序端链接，H5SIGN-h5端链接
+   * 生成的链接类型：
+<ul><li> 不传(即为空值) 则会生成小程序端开通链接(默认)</li>
+<li> **H5SIGN** : 生成H5端开通链接</li></ul>
    */
   UrlType?: string
   /**
-   * 通知类型，默认不填为不通知开通方，填写 SMS 为短信通知。
+   * 是否通知开通方，通知类型:
+<ul><li>默认不设置为不通知开通方</li>
+<li>**SMS** :  短信通知 ,如果需要短信通知则NotifyAddress填写对方的手机号</li><ul>
    */
   NotifyType?: string
   /**
-   * 若上方填写为 SMS，则此处为手机号
+   * 如果通知类型NotifyType选择为SMS，则此处为手机号, 其他通知类型不需要设置此项
    */
   NotifyAddress?: string
   /**
-   * 链接的过期时间，格式为Unix时间戳，不能早于当前时间，且最大为30天。如果不传，默认有效期为7天。
+   * 链接的过期时间，格式为Unix时间戳，不能早于当前时间，且最大为当前时间往后30天。`如果不传，默认过期时间为当前时间往后7天。`
    */
   ExpiredTime?: number
 }
@@ -3655,15 +3682,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>
   /**
@@ -4107,27 +4144,37 @@ export interface FlowApproverInfo {
  */
 export interface ChannelCreateUserAutoSignEnableUrlResponse {
   /**
-   * 跳转短链
+   * 个人用户自动签的开通链接, 短链形式。过期时间受 `ExpiredTime` 参数控制。
    */
   Url?: string
   /**
-   * 小程序AppId
+   * 腾讯电子签小程序的 AppID，用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
+
+注: `如果获取的是H5链接, 则不会返回此值`
    */
   AppId?: string
   /**
-   * 小程序 原始 Id
+   * 腾讯电子签小程序的原始 Id,  ，用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
+
+注: `如果获取的是H5链接, 则不会返回此值`
    */
   AppOriginalId?: string
   /**
-   * 跳转路径
+   * 腾讯电子签小程序的跳转路径，用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
+
+注: `如果获取的是H5链接, 则不会返回此值`
    */
   Path?: string
   /**
-   * base64格式跳转二维码
+   * base64 格式的跳转二维码图片，可通过微信扫描后跳转到腾讯电子签小程序的开通界面。
+
+注: `如果获取的是H5链接, 则不会返回此二维码图片`
    */
   QrCode?: string
   /**
-   * 链接类型，空-默认小程序端链接，H5SIGN-h5端链接
+   * 返回的链接类型
+<ul><li> 空: 默认小程序端链接</li>
+<li> **H5SIGN** : h5端链接</li></ul>
    */
   UrlType?: string
   /**
@@ -4239,56 +4286,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
 }
@@ -4370,14 +4419,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>
@@ -4621,11 +4671,19 @@ export interface ChannelCreateBatchQuickSignUrlResponse {
  */
 export interface ChannelCreateBatchCancelFlowUrlRequest {
   /**
-   * 应用相关信息。 此接口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数组
+   * 要撤销的合同流程ID列表，最多100个，超过100不处理
    */
   FlowIds: Array<string>
   /**
@@ -4821,23 +4879,39 @@ export interface ChannelDescribeRolesResponse {
  */
 export interface ChannelCreateReleaseFlowRequest {
   /**
-   * 应用相关信息。 此接口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
   /**
-   * 待解除的流程编号（即原流程的编号）
+   * 待解除的签署流程编号(即原签署流程的编号)。
    */
   NeedRelievedFlowId: string
   /**
-   * 解除协议内容
+   * 解除协议内容, 包括解除理由等信息。
    */
   ReliveInfo: RelieveInfo
   /**
-   * 非必须，解除协议的本企业签署人列表，默认使用原流程的签署人列表；当解除协议的签署人与原流程的签署人不能相同时（例如原流程签署人离职了），需要指定本企业的其他签署人来替换原流程中的原签署人，注意需要指明ApproverNumber来代表需要替换哪一个签署人，已转发的签署人不包含在内，解除协议的签署人数量不能多于原流程的签署人数量
+   * 替换解除协议的签署人， 如不指定替换签署人,  则使用原流程的签署人。 <br/>
+如需更换原合同中的企业端签署人，可通过指定该签署人的RecipientId编号更换此企业端签署人。(可通过接口<a href="https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo/">DescribeFlowInfo</a>查询签署人的RecipientId编号)<br/>
+
+注意：
+<ul>
+<li>只能更换自己企业的签署人, 不支持更换个人类型或者其他企业的签署人</li>
+<li>可以不指定替换签署人, 使用原流程的签署人</li>
+</ul>
    */
   ReleasedApprovers?: Array<ReleasedApprover>
   /**
    * 签署完回调url，最大长度1000个字符
+   * @deprecated
    */
   CallbackUrl?: string
   /**
@@ -4851,9 +4925,18 @@ export interface ChannelCreateReleaseFlowRequest {
    */
   Operator?: UserInfo
   /**
-   * 签署流程的签署截止时间。 值为unix时间戳,精确到秒,不传默认为当前时间七天后
+   * 合同流程的签署截止时间，格式为Unix标准时间戳(秒)，如果未设置签署截止时间，则默认为合同流程创建后的7天时截止。
+如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
    */
   Deadline?: number
+  /**
+   * 调用方自定义的个性化字段，该字段的值可以是字符串JSON或其他字符串形式，客户可以根据自身需求自定义数据格式并在需要时进行解析。该字段的信息将以Base64编码的形式传输，支持的最大数据大小为20480长度。
+
+在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。
+
+回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/company/callback_types_v2" target="_blank">回调通知</a>模块。
+   */
+  UserData?: string
 }
 
 /**
@@ -4946,22 +5029,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>
+
    */
   IdCardType?: string
   /**
@@ -4969,14 +5054,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
 }
@@ -5268,31 +5351,40 @@ export interface ChannelCreateEmbedWebUrlResponse {
  */
 export interface ChannelBatchCancelFlowsRequest {
   /**
-   * 应用相关信息。 此接口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数组，最多100个，超过100不处理
+   * 要撤销的合同流程ID列表，最多100个，超过100不处理
    */
   FlowIds: Array<string>
   /**
-   * 撤销理由,不超过200个字符
+   * 撤回原因，长度不能超过200，只能由中文、字母、数字和下划线组成。
+
+备注:`如果不传递撤回原因，那么默认撤回原因是 "自动撤销（通过接口实现）"`
    */
   CancelMessage?: string
   /**
-   * 撤销理由自定义格式，支持以下格式
-<ul><li>0 : 默认值</li>
-<li>1 : 只保留身份信息</li>
-<li>2 : 保留身份信息+企业名称</li>
-<li>3 : 保留身份信息+企业名称+经办人名称</li></ul>
-例如,假设合同的发起方是典子谦示例企业的经办人张三，撤销理由是"合同内容错误，需要修正",合同撤销后，各签署方看到的撤销理由是会是
+   * 撤销理由自定义格式,  会展示在合同预览的界面中,  可以选择下面的组合方式：
+
+**0** : 默认格式,  合同封面页面会展示为: 发起方-企业名称-撤销的经办人名字以**CancelMessage**的理由撤销当前合同
+**1** :  合同封面页面会展示为:  发起方以**CancelMessage**的理由撤销当前合同
+**2** : 保留企业名称,  合同封面页面会展示为:  发起方-企业名称以**CancelMessage**的理由撤销当前合同
+**3** : 保留企业名称+经办人名字,  合同封面页面会展示为: 发起方-企业名称-撤销的经办人名字以**CancelMessage**的理由撤销当前合同
+
+注: `CancelMessage为撤销当前合同的理由`
+
+![image](https://dyn.ess.tencent.cn/guide/capi/channel_ChannelCancelFlow.png)
 
-0: 发起方-典子谦示例企业-张三以"合同内容错误，需要修正"的理由撤销当前合同
-1: 发起方以"合同内容错误，需要修正"的理由撤销当前合同
-2: 发起方-典子谦示例企业以"合同内容错误，需要修正"的理由撤销当前合同
-3: 发起方-典子谦示例企业-张三以"合同内容错误，需要修正"的理由撤销当前合同</br>
 
-备注:`如果不传递撤销理由，那么默认撤销理由是 "自动撤销（通过接口实现）"`
    */
   CancelMessageFormat?: number
   /**
@@ -5484,25 +5576,24 @@ export interface DescribeTemplatesRequest {
   Agent: Agent
   /**
    * 合同模板ID，为32位字符串。
-建议开发者保存此模板ID，后续用此模板发起合同流程需要此参数。
+
+可以通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录企业控制台, 在企业模板中得到合同模板ID。
    */
   TemplateId?: string
   /**
-   * 查询内容控制
+   * 查询模版的内容
 
-<ul><li>**0**：模板列表及详情（默认）</li>
-<li>**1**：仅模板列表</li></ul>
+<ul><li>**0**：（默认）模板列表及详情</li>
+<li>**1**：仅模板列表, 不会返回模板中的签署控件, 填写控件, 参与方角色列表等信息</li></ul>
    */
   ContentType?: number
   /**
-   * 合同模板ID数组，每一个合同模板ID为32位字符串。
-建议开发者保存此模板ID，后续用此模板发起合同流程需要此参数。
+   * 合同模板ID数组，每一个合同模板ID为32位字符串,  最多支持200个模板的批量查询。
 
-```注意: 
-1. 此参数TemplateIds与TemplateId互为独立，若两者均传入，以TemplateId为准。
-2. 请确保每个模板均正确且属于当前企业，若有任一模板不存在，则返回错误。
-3. 最多支持200个模板。
-4. 若传递此参数，分页参数(Limit,Offset)无效```
+注意: 
+1.` 此参数TemplateIds与TemplateId互为独立，若两者均传入，以TemplateId为准。`
+2. `请确保每个模板均正确且属于当前企业，若有任一模板不存在，则返回错误。`
+4. `若传递此参数，分页参数(Limit,Offset)无效`
 
    */
   TemplateIds?: Array<string>
@@ -5520,7 +5611,7 @@ export interface DescribeTemplatesRequest {
    */
   Offset?: number
   /**
-   * 模糊搜索的模板名称，注意是模板名的连续部分，最大长度200
+   * 模糊搜索的模板名称，注意是模板名的连续部分，长度不能超过200，可支持由中文、字母、数字和下划线组成字符串。
    */
   TemplateName?: string
   /**
@@ -5528,10 +5619,10 @@ export interface DescribeTemplatesRequest {
    */
   ChannelTemplateId?: string
   /**
-   * 是否返回所有控件信息。
+   * 返回控件的范围, 是只返回发起方自己的还是所有参与方的
 
-<ul><li>**false**：只返回发起方控件（默认）</li>
-<li>**true**：返回所有签署方控件</li></ul>
+<ul><li>**false**：（默认）只返回发起方控件</li>
+<li>**true**：返回所有参与方(包括发起方和签署方)控件</li></ul>
    */
   QueryAllComponents?: boolean
   /**
@@ -5540,9 +5631,9 @@ export interface DescribeTemplatesRequest {
 <ul><li>**false**：不获取（默认）</li>
 <li>**true**：获取</li></ul>
 
-设置为true之后， 返回参数PreviewUrl，为模板的H5预览链接,有效期5分钟。
-可以通过浏览器打开此链接预览模板，或者嵌入到iframe中预览模板。
-（此功能开放需要联系客户经理）
+设置为true之后， 返回参数PreviewUrl，为模板的H5预览链接,  有效期5分钟。可以通过浏览器打开此链接预览模板，或者嵌入到iframe中预览模板。
+
+注: `此功能为白名单功能，使用前请联系对接的客户经理沟通。`
    */
   WithPreviewUrl?: boolean
   /**
@@ -5551,8 +5642,9 @@ export interface DescribeTemplatesRequest {
 <ul><li>**false**：不获取（默认）</li>
 <li>**true**：获取</li></ul>
 
-设置为true之后， 返回参数PdfUrl，为模板PDF文件链接，有效期5分钟。
-（此功能开放需要联系客户经理）
+设置为true之后， 返回参数PdfUrl，为模板PDF文件链接，有效期5分钟, 可以用于将PDF文件下载到本地
+
+注: `此功能为白名单功能，使用前请联系对接的客户经理沟通。`
    */
   WithPdfUrl?: boolean
   /**
@@ -5823,15 +5915,17 @@ export interface UsageDetail {
  */
 export interface ChannelCreateBatchCancelFlowUrlResponse {
   /**
-   * 批量撤销url
+   * 批量撤销合同的URL链接, 需要在手机端打开, 有效期24小时
    */
   BatchCancelFlowUrl?: string
   /**
-   * 签署流程批量撤销失败原因
+   * 与入参的FlowIds数组一致,   成功生成到撤销链接中,则为"",   不能撤销合同则为失败原因
    */
   FailMessages?: Array<string>
   /**
-   * 签署撤销url过期时间-年月日-时分秒
+   * 签署撤销链接的过期时间(格式为:年-月-日 时:分:秒), 默认是生成链接的24小时后失效
+
+
    */
   UrlExpireOn?: string
   /**
@@ -5928,19 +6022,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
 }
 
 /**