tencentcloud-sdk-nodejs-essbasic 4.1.197 → 4.1.199

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tencentcloud-sdk-nodejs-essbasic",
3
- "version": "4.1.197",
3
+ "version": "4.1.199",
4
4
  "description": "腾讯云 API NODEJS SDK",
5
5
  "main": "./tencentcloud/index.js",
6
6
  "module": "./es/index.js",
@@ -5069,149 +5069,86 @@ export interface DescribeUsageResponse {
5069
5069
  */
5070
5070
  export interface CreateSignUrlsRequest {
5071
5071
  /**
5072
- * 关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
5073
-
5074
- 此接口下面信息必填。
5075
- <ul>
5076
- <li>渠道应用标识: Agent.AppId</li>
5077
- <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
5078
- <li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li>
5079
- </ul>
5080
- 第三方平台子客企业和员工必须已经过实名认证
5072
+ * <p>关于渠道应用的相关信息,包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容,您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。</p><p>此接口下面信息必填。</p><ul><li>渠道应用标识: Agent.AppId</li><li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li><li>第三方平台子客企业中的员工标识: Agent.ProxyOperator.OpenId</li></ul>第三方平台子客企业和员工必须已经过实名认证
5081
5073
  */
5082
5074
  Agent: Agent;
5083
5075
  /**
5084
- * 合同流程ID数组,最多支持100个。
5085
-
5086
- 注:
5087
- 1. 必须选择提供此参数或合同组编号中的一个。
5088
- 2. 当生成类型(GenerateType)设为“ALL”时,不可提供多个流程ID。
5076
+ * <p>合同流程ID数组,最多支持100个。</p><p>注: </p><ol><li>必须选择提供此参数或合同组编号中的一个。</li><li>当生成类型(GenerateType)设为“ALL”时,不可提供多个流程ID。</li></ol>
5089
5077
  */
5090
5078
  FlowIds?: Array<string>;
5091
5079
  /**
5092
- * 合同组编号
5093
- 注:`该参数和合同流程ID数组必须二选一`
5080
+ * <p>合同组编号<br>注:<code>该参数和合同流程ID数组必须二选一</code></p>
5094
5081
  */
5095
5082
  FlowGroupId?: string;
5096
5083
  /**
5097
- * 签署链接类型,可以设置的参数如下
5098
- <ul><li> **WEIXINAPP** :(默认)跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型 ,此时返回短链</li>
5099
- <li> **CHANNEL** :带有H5引导页的跳转电子签小程序的链接(<b>GenerateType非ALL时候不能设置成CHANNEL</b>)</li>
5100
- <li> **APP** :第三方App或小程序跳转电子签小程序的path, App或者小程序跳转适合此类型</li>
5101
- <li> **LONGURL2WEIXINAPP** :跳转电子签小程序的链接, H5跳转适合此类型,此时返回长链</li></ul>
5102
-
5103
- **注:**动态签署人场景,如果签署链接类型设置为`APP`,则仅支持跳转到封面页。
5104
-
5105
- 详细使用场景可以参考接口描述说明中的 **主要使用场景EndPoint分类**
5106
-
5084
+ * <p>签署链接类型,可以设置的参数如下</p><ul><li> **WEIXINAPP** :(默认)跳转电子签小程序的http_url, 短信通知或者H5跳转适合此类型 ,此时返回短链</li><li> **CHANNEL** :带有H5引导页的跳转电子签小程序的链接(<b>GenerateType非ALL时候不能设置成CHANNEL</b>)</li><li> **APP** :第三方App或小程序跳转电子签小程序的path, App或者小程序跳转适合此类型</li><li> **LONGURL2WEIXINAPP** :跳转电子签小程序的链接, H5跳转适合此类型,此时返回长链</li></ul><p><strong>注:</strong>动态签署人场景,如果签署链接类型设置为<code>APP</code>,则仅支持跳转到封面页。</p><p>详细使用场景可以参考接口描述说明中的 <strong>主要使用场景EndPoint分类</strong></p>
5107
5085
  */
5108
5086
  Endpoint?: string;
5109
5087
  /**
5110
- * 签署链接生成类型,可以选择的类型如下
5111
-
5112
- <ul><li><strong>ALL</strong>:(默认)为所有签署方生成签署链接,但不包括自动签署(静默签署)的签署方。注意:<strong>此中类型不支持多个合同ID(FlowIds)</strong>。</li>
5113
- <li><strong>CHANNEL</strong>:适用于第三方子企业的员工签署方。</li>
5114
- <li><strong>NOT_CHANNEL</strong>:适用于SaaS平台企业的员工签署方。</li>
5115
- <li><strong>PERSON</strong>:适用于个人或自然人签署方。</li>
5116
- <li><strong>FOLLOWER</strong>:适用于关注方,目前指合同的抄送方。</li>
5117
- <li><strong>RECIPIENT</strong>:根据RecipientId生成对应的签署链接,适用于动态添加签署人的情况。</li></ul>
5088
+ * <p>签署链接生成类型,可以选择的类型如下</p><ul><li><strong>ALL</strong>:(默认)为所有签署方生成签署链接,但不包括自动签署(静默签署)的签署方。注意:<strong>此中类型不支持多个合同ID(FlowIds)</strong>。</li><li><strong>CHANNEL</strong>:适用于第三方子企业的员工签署方。</li><li><strong>NOT_CHANNEL</strong>:适用于SaaS平台企业的员工签署方。</li><li><strong>PERSON</strong>:适用于个人或自然人签署方。</li><li><strong>FOLLOWER</strong>:适用于关注方,目前指合同的抄送方。</li><li><strong>RECIPIENT</strong>:根据RecipientId生成对应的签署链接,适用于动态添加签署人的情况。</li></ul>
5118
5089
  */
5119
5090
  GenerateType?: string;
5120
5091
  /**
5121
- * SaaS平台企业员工签署方的企业名称如果名称中包含英文括号(),请使用中文括号()代替。 注: `1.GenerateType为"NOT_CHANNEL"时必填` `2.获取B端动态签署人领取链接时,可指定此字段来预先设定签署人的企业,预设后只能以该企业身份去领取合同并完成签署`
5092
+ * <p>SaaS平台企业员工签署方的企业名称如果名称中包含英文括号(),请使用中文括号()代替。 注: <code>1.GenerateType为&quot;NOT_CHANNEL&quot;时必填</code> <code>2.获取B端动态签署人领取链接时,可指定此字段来预先设定签署人的企业,预设后只能以该企业身份去领取合同并完成签署</code></p>
5122
5093
  */
5123
5094
  OrganizationName?: string;
5124
5095
  /**
5125
- * 合同流程里边参与方的姓名。
5126
- 注:
5127
- 1. `GenerateType为"PERSON"(即个人签署方)时必填`。
5128
- 2. `在动态签署人补充链接场景中,可以通过传入这个值,对补充的个人参与方信息进行限制。仅匹配传入姓名的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。`
5096
+ * <p>合同流程里边参与方的姓名。<br>注: </p><ol><li><code>GenerateType为&quot;PERSON&quot;(即个人签署方)时必填</code>。</li><li><code>在动态签署人补充链接场景中,可以通过传入这个值,对补充的个人参与方信息进行限制。仅匹配传入姓名的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。</code></li></ol>
5129
5097
  */
5130
5098
  Name?: string;
5131
5099
  /**
5132
- * 合同流程里边签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)
5133
- 注:
5134
- 1. `GenerateType为"PERSON"或"FOLLOWER"时必填。`
5135
- 2. `在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入手机号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。`
5100
+ * <p>合同流程里边签署方经办人手机号码, 支持国内手机号11位数字(无需加+86前缀或其他字符)。<br>注: </p><ol><li><code>GenerateType为&quot;PERSON&quot;或&quot;FOLLOWER&quot;时必填。</code></li><li><code>在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入手机号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。</code></li></ol>
5136
5101
  */
5137
5102
  Mobile?: string;
5138
5103
  /**
5139
- * 证件类型,支持以下类型
5140
- <ul><li>ID_CARD : 中国大陆居民身份证</li>
5141
- <li>HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证</li>
5142
- <li>HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)</li></ul>
5143
-
5144
- `注:在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件类型的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方,且需要和证件号参数一同传递,不能单独进行限制。`
5104
+ * <p>证件类型,支持以下类型</p><ul><li>ID_CARD : 中国大陆居民身份证</li><li>HONGKONG_AND_MACAO : 中国港澳居民来往内地通行证</li><li>HONGKONG_MACAO_AND_TAIWAN : 中国港澳台居民居住证(格式同中国大陆居民身份证)</li></ul><p><code>注:在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件类型的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方,且需要和证件号参数一同传递,不能单独进行限制。</code></p>
5145
5105
  */
5146
5106
  IdCardType?: string;
5147
5107
  /**
5148
- * 证件号码,应符合以下规则
5149
- <ul><li>居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。</li>
5150
- <li>港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。</li>
5151
- <li>港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。</li></ul>
5152
-
5153
- `注:在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。`
5108
+ * <p>证件号码,应符合以下规则</p><ul><li>居民身份证号码应为18位字符串,由数字和大写字母X组成(如存在X,请大写)。</li><li>港澳居民来往内地通行证号码共11位。第1位为字母,“H”字头签发给中国香港居民,“M”字头签发给中国澳门居民;第2位至第11位为数字。</li><li>港澳台居民居住证号码编码规则与中国大陆身份证相同,应为18位字符串。</li></ul><p><code>注:在动态签署人补充链接场景中,可以通过传入此值,对补充的个人参与方信息进行限制。仅匹配传入证件号的参与方才能补充合同。此参数预设信息功能暂时仅支持个人动态参与方。</code></p>
5154
5109
  */
5155
5110
  IdCardNumber?: string;
5156
5111
  /**
5157
- * 第三方平台子客企业的企业的标识, 即OrganizationOpenId。 注: `1.GenerateType为"CHANNEL"时必填` `2.获取B端动态签署人领取链接时,可指定此字段来预先设定签署人的平台子客企业,预设后只能以该平台子客企业身份去领取合同并完成签署`
5112
+ * <p>第三方平台子客企业的企业的标识, 即OrganizationOpenId。 注: <code>1.GenerateType为&quot;CHANNEL&quot;时必填</code> <code>2.获取B端动态签署人领取链接时,可指定此字段来预先设定签署人的平台子客企业,预设后只能以该平台子客企业身份去领取合同并完成签署</code></p>
5158
5113
  */
5159
5114
  OrganizationOpenId?: string;
5160
5115
  /**
5161
- * 第三方平台子客企业员工的标识OpenId,GenerateType为"CHANNEL"时可用,指定到具体参与人, 仅展示已经实名的经办人信息
5162
-
5163
- 注:
5164
- 如果传进来的<font color="red">OpenId已经实名并且加入企业, 则忽略Name,IdCardType,IdCardNumber,Mobile这四个入参</font>(会用此OpenId实名的身份证和登录的手机号覆盖)
5116
+ * <p>第三方平台子客企业员工的标识OpenId,GenerateType为&quot;CHANNEL&quot;时可用,指定到具体参与人, 仅展示已经实名的经办人信息</p><p>注:<br>如果传进来的<font color="red">OpenId已经实名并且加入企业, 则忽略Name,IdCardType,IdCardNumber,Mobile这四个入参</font>(会用此OpenId实名的身份证和登录的手机号覆盖)</p>
5165
5117
  */
5166
5118
  OpenId?: string;
5167
5119
  /**
5168
- * 签署完成后是否自动回跳
5169
- <ul><li>false:否, 签署完成不会自动跳转回来(默认)</li><li>true:是, 签署完成会自动跳转回来</li></ul>
5170
-
5171
- 注:
5172
- 1. 该参数<font color="red">只针对APP类型(电子签小程序跳转贵方小程序)场景</font> 的签署链接有效
5173
- 2. <font color="red">手机应用APP 或 微信小程序需要监控界面的返回走后序逻辑</font>, 微信小程序的文档可以参考[这个](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onShow-Object-object)
5174
- 3. <font color="red">电子签小程序跳转贵方APP,不支持自动跳转,必需用户手动点击完成按钮(微信的限制)</font>
5120
+ * <p>签署完成后是否自动回跳</p><ul><li>false:否, 签署完成不会自动跳转回来(默认)</li><li>true:是, 签署完成会自动跳转回来</li></ul><p>注: </p><ol><li>该参数<font color="red">只针对APP类型(电子签小程序跳转贵方小程序)场景</font> 的签署链接有效</li><li><font color="red">手机应用APP 或 微信小程序需要监控界面的返回走后序逻辑</font>, 微信小程序的文档可以参考<a href="https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onShow-Object-object">这个</a></li><li><font color="red">电子签小程序跳转贵方APP,不支持自动跳转,必需用户手动点击完成按钮(微信的限制)</font></li></ol>
5175
5121
  */
5176
5122
  AutoJumpBack?: boolean;
5177
5123
  /**
5178
- * 签署完之后的H5页面的跳转链接,针对Endpoint为CHANNEL时有效,最大长度1000个字符。
5124
+ * <p>签署完之后的H5页面的跳转链接,针对Endpoint为CHANNEL时有效,最大长度1000个字符。</p>
5179
5125
  */
5180
5126
  JumpUrl?: string;
5181
5127
  /**
5182
- * 暂未开放
5128
+ * <p>暂未开放</p>
5183
5129
  * @deprecated
5184
5130
  */
5185
5131
  Operator?: UserInfo;
5186
5132
  /**
5187
- * 生成的签署链接在签署页面隐藏的按钮列表,可设置如下:
5188
-
5189
- <ul><li> **0** :合同签署页面更多操作按钮</li>
5190
- <li> **1** :合同签署页面更多操作的拒绝签署按钮</li>
5191
- <li> **2** :合同签署页面更多操作的转他人处理按钮</li>
5192
- <li> **3** :签署成功页的查看详情按钮</li>
5193
- <li> **4** :合同签署页面更多操作的查看合同基本信息按钮</li>
5194
- <li> **5** :合同签署页面更多操作的撤销按钮</li></ul>
5195
-
5196
- 注: `字段为数组, 可以传值隐藏多个按钮`
5133
+ * <p>生成的签署链接在签署页面隐藏的按钮列表,可设置如下:</p><ul><li> **0** :合同签署页面更多操作按钮</li><li> **1** :合同签署页面更多操作的拒绝签署按钮</li><li> **2** :合同签署页面更多操作的转他人处理按钮</li><li> **3** :签署成功页的查看详情按钮</li><li> **4** :合同签署页面更多操作的查看合同基本信息按钮</li><li> **5** :合同签署页面更多操作的撤销按钮</li></ul><p>注: <code>字段为数组, 可以传值隐藏多个按钮</code></p>
5197
5134
  */
5198
5135
  Hides?: Array<number | bigint>;
5199
5136
  /**
5200
- * 参与方角色ID,用于生成动态签署人链接完成领取。
5201
-
5202
- 注:`使用此参数需要与flow_ids数量一致并且一一对应, 表示在对应同序号的流程中的参与角色ID`,
5137
+ * <p>参与方角色ID,用于生成动态签署人链接完成领取。</p><p>注:<code>使用此参数需要与flow_ids数量一致并且一一对应, 表示在对应同序号的流程中的参与角色ID</code>,</p>
5203
5138
  */
5204
5139
  RecipientIds?: Array<string>;
5205
5140
  /**
5206
- * 合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。
5141
+ * <p>合同组相关信息,指定合同组子合同和签署方的信息,用于补充动态签署人。</p>
5207
5142
  */
5208
5143
  FlowGroupUrlInfo?: FlowGroupUrlInfo;
5209
5144
  /**
5210
- * <font color="red">仅公众号 H5 跳转电子签小程序时</font>,如需签署完成的“返回应用”功能,在获取签署链接接口的 UrlUseEnv 参数需设置为 **WeChatOfficialAccounts**,小程序签署成功的结果页面中才会出现“返回应用”按钮。在用户点击“返回应用”按钮之后,会返回到公众号 H5。
5211
-
5212
- 参考 [公众号 H5 跳转电子签小程序](https://qian.tencent.com/developers/company/openwxminiprogram/#23-%E5%85%AC%E4%BC%97%E5%8F%B7-h5-%E4%B8%AD%E8%B7%B3%E8%BD%AC)。
5145
+ * <p><font color="red">仅公众号 H5 跳转电子签小程序时</font>,如需签署完成的“返回应用”功能,在获取签署链接接口的 UrlUseEnv 参数需设置为 <strong>WeChatOfficialAccounts</strong>,小程序签署成功的结果页面中才会出现“返回应用”按钮。在用户点击“返回应用”按钮之后,会返回到公众号 H5。 </p><p>参考 <a href="https://qian.tencent.com/developers/company/openwxminiprogram/#23-%E5%85%AC%E4%BC%97%E5%8F%B7-h5-%E4%B8%AD%E8%B7%B3%E8%BD%AC">公众号 H5 跳转电子签小程序</a>。</p>
5213
5146
  */
5214
5147
  UrlUseEnv?: string;
5148
+ /**
5149
+ * <p>是否允许此链接中签署方批量确认已读文件。 <ul><li>false (默认): 不允许批量确认已读文件。</li> <li>true : 允许批量确认已读文件。</li></ul> 注:<code>1. 此功能为白名单功能,使用前请联系对应客户经理进行开通。2. 使用此功能时,FlowIds参数必传。3. 对于企业签署方,如果对印章/签名控件有限制要求,需要保证所有印章/签名签署控件限制要求(印章id或印章/签名类型限制)一致,否则无法使用此功能。</code></p><p>默认值:false</p>
5150
+ */
5151
+ CanSkipReadFlow?: boolean;
5215
5152
  }
5216
5153
  /**
5217
5154
  * 企业认证信息参数, 需要保证这些参数跟营业执照中的信息一致。
@@ -7013,11 +6950,11 @@ export interface ChannelOrganizationInfo {
7013
6950
  */
7014
6951
  export interface CreateSignUrlsResponse {
7015
6952
  /**
7016
- * 生成的签署参与者的签署链接信息数组。
6953
+ * <p>生成的签署参与者的签署链接信息数组。</p>
7017
6954
  */
7018
6955
  SignUrlInfos?: Array<SignUrlInfo>;
7019
6956
  /**
7020
- * 生成失败时的错误信息,成功返回”“,顺序和出参SignUrlInfos保持一致
6957
+ * <p>生成失败时的错误信息,成功返回”“,顺序和出参SignUrlInfos保持一致</p>
7021
6958
  */
7022
6959
  ErrorMessages?: Array<string>;
7023
6960
  /**