tencentcloud-sdk-ess 3.0.623 → 3.0.624

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: aba895f8cbb6089156fb4361585e4b33c8e6a38f
-  data.tar.gz: 19efb080f4975578c1a0be73cfcfec3169cc5a52
+  metadata.gz: ec4f0ebc12c5d36c7a173d5985f87849f9247318
+  data.tar.gz: 4df263779adca30edde79d9c94f94097ad151353
 SHA512:
-  metadata.gz: a3f44616ad22e01bbb0e57651a5669a7a6a3cbf0d4d7cc98f891936e58a1c821ef7ad3d657d0a95c217fcd1b84875d875518398680a6ad370c17105af8fc4a3a
-  data.tar.gz: b116fbfebdd782e85c23e5f8d2a310bbf3904e31841abff6e7b26d7a21194997484f51fb6bd06585234351f29a2b9282367520ddad8fe3b2890ba67dc48ec7a8
+  metadata.gz: d25169e815d3f3e2218e6d3fa202941877207dec64ede76d4452569232d7628cc4a1ce39d9e4084a80349d341f707514f239cbd2932c4116c0d9e154d1ffaaec
+  data.tar.gz: 58e7f34630351eb9640ece81719baa4d1dd0f22693c4c3833a1c58d7436a1b23d10e34ff17fb8fc1d4fa8d4ba2183c3674c4cb0a771d75e4cd58a613fe48d346

data/lib/VERSION

@@ -1 +1 @@
-3.0.623
+3.0.624

data/lib/v20201111/client.rb

@@ -979,9 +979,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查询流程摘要
+        # 查询流程基础信息
         # 适用场景：可用于主动查询某个合同流程的签署状态信息。可以配合回调通知使用。
-        # 日调用量限制：10W
+        # 每个企业限制日调用量限制：10W,  当当日超过此限制后再调用接口返回错误
 
         # @param request: Request instance for DescribeFlowBriefs.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeFlowBriefsRequest`
@@ -1083,6 +1083,7 @@ module TencentCloud
         # 当模板较多或模板中的控件较多时，可以通过查询模板接口更方便的获取模板列表，以及每个模板内的控件信息。
 
         # > **适用场景**
+        # >
         # >  该接口常用来配合“模板发起合同-创建电子文档”接口作为前置的接口使用。
         # >  一个模板通常会包含以下结构信息
         # >- 模板基本信息
@@ -1332,8 +1333,8 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过发起转换任务接口（CreateConvertTaskApi）返回的任务Id查询转换任务状态，通过本接口确认转换任务是否完成。<br/>
-        # 大文件转换所需的时间可能会比较长。
+        # 查询转换任务的状态。转换任务Id通过发起转换任务接口（CreateConvertTaskApi）获取。
+        # 注意：大文件转换所需的时间可能会比较长。
 
         # @param request: Request instance for GetTaskResultApi.
         # @type request: :class:`Tencentcloud::ess::V20201111::GetTaskResultApiRequest`

data/lib/v20201111/models.rb

@@ -249,15 +249,32 @@ module TencentCloud
       class AutoSignConfig < TencentCloud::Common::AbstractModel
         # @param UserInfo: 自动签开通个人用户的三要素
         # @type UserInfo: :class:`Tencentcloud::Ess.v20201111.models.UserThreeFactor`
-        # @param CallbackUrl: 接受自动签开启的回调地址。需要保证post返回200
+        # @param CallbackUrl: 接受回调URL地址。支持http://或者https://协议
+
+        # Post数据到此地址后后返回httpcode200表示接受回调成功, 返回其他httpcode表示接受回调失败
         # @type CallbackUrl: String
-        # @param CertInfoCallback: 是否回调证书信息，默认false-不需要
+        # @param CertInfoCallback: 是否回调证书信息
+        # false-不需要 (默认值)
+        # true-需要
         # @type CertInfoCallback: Boolean
-        # @param UserDefineSeal: 是否支持用户自定义签名印章，默认false-不需要
+        # @param UserDefineSeal: 是否支持用户自定义签名印章
+        # false-不需要(默认)
+        # true-需要
         # @type UserDefineSeal: Boolean
-        # @param SealImgCallback: 是否需要回调的时候返回印章(签名) 图片的 base64，默认false-不需要
+        # @param SealImgCallback: 是否需要回调的时候返回印章(签名) 图片的 base64
+
+        # false-不需要(默认)
+        # true-需要(
         # @type SealImgCallback: Boolean
-        # @param VerifyChannels: 开通时候的验证方式，取值：WEIXINAPP（微信人脸识别），INSIGHT（慧眼人脸认别），TELECOM（运营商三要素验证）。如果是小程序开通链接，支持传 WEIXINAPP / TELECOM。如果是 H5 开通链接，支持传 INSIGHT / TELECOM。默认值 WEIXINAPP / INSIGHT。
+        # @param VerifyChannels: 开通时候的验证方式, 分布为
+
+        # WEIXINAPP : 微信人脸识别
+        # INSIGHT : 慧眼人脸认别
+        # TELECOM : 运营商三要素验证
+
+        # 如果是小程序开通链接，支持传 WEIXINAPP / TELECOM。
+
+        # 如果是 H5 开通链接，支持传 INSIGHT / TELECOM。默认值 WEIXINAPP / INSIGHT。
         # @type VerifyChannels: Array
 
         attr_accessor :UserInfo, :CallbackUrl, :CertInfoCallback, :UserDefineSeal, :SealImgCallback, :VerifyChannels
@@ -823,7 +840,8 @@ module TencentCloud
       class CreateBatchCancelFlowUrlRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 调用方用户信息，userId 必填
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowIds: 需要执行撤回的签署流程id数组，最多100个
+        # @param FlowIds: 需要执行撤回的流程(合同)的编号列表，最多100个.
+        # 列表中的流程(合同)编号不要重复.
         # @type FlowIds: Array
         # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
@@ -854,8 +872,11 @@ module TencentCloud
         # @param BatchCancelFlowUrl: 批量撤回签署流程链接
         # @type BatchCancelFlowUrl: String
         # @param FailMessages: 签署流程撤回失败信息
+        # 数组里边的错误原因与传进来的FlowIds一一对应,如果是空字符串则标识没有出错
         # @type FailMessages: Array
         # @param UrlExpireOn: 签署连接过期时间字符串：年月日-时分秒
+
+        # 例如:2023-07-28 17:25:59
         # @type UrlExpireOn: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -1801,7 +1822,7 @@ module TencentCloud
         # 默认：SignReview；SignReview:签署审核
 
         # 该字段不传或者为空，则默认为SignReview签署审核，走签署审核流程
-        # 若发起个人审核，则指定该字段为：SignReview（注意，给个人审核时，需联系客户经理开白使用）
+        # 若发起个人审核，则指定该字段为：SignReview
         # @type OperateType: String
 
         attr_accessor :Operator, :FlowId, :ReviewType, :ReviewMessage, :Agent, :RecipientId, :OperateType
@@ -2571,7 +2592,10 @@ module TencentCloud
         # @type FlowGroupId: String
         # @param PathType: 跳转页面 1: 小程序合同详情 2: 小程序合同列表页 0: 不传, 默认主页
         # @type PathType: Integer
-        # @param AutoJumpBack: 是否自动回跳 true：是， false：否。该参数只针对"APP" 类型的签署链接有效
+        # @param AutoJumpBack: 是否自动回跳
+        # true：是，
+        # false：否。
+        # 该参数只针对"APP" 类型的签署链接有效
         # @type AutoJumpBack: Boolean
         # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
@@ -2857,11 +2881,16 @@ module TencentCloud
         # @type SceneKey: String
         # @param AutoSignConfig: 自动签开通，签署相关配置
         # @type AutoSignConfig: :class:`Tencentcloud::Ess.v20201111.models.AutoSignConfig`
-        # @param UrlType: 链接类型，空-默认小程序端链接，H5SIGN-h5端链接
+        # @param UrlType: 链接类型，
+        # 空-默认小程序端链接
+        # H5SIGN-h5端链接
         # @type UrlType: String
-        # @param NotifyType: 通知类型，默认不填为不通知开通方，填写 SMS 为短信通知。
+        # @param NotifyType: 通知类型
+
+        # 默认不设置为不通知开通方，
+        # SMS 为短信通知 , 此种方式需要NotifyAddress填写手机号。
         # @type NotifyType: String
-        # @param NotifyAddress: 若上方填写为 SMS，则此处为手机号
+        # @param NotifyAddress: 如果通知类型NotifyType选择为SMS，则此处为手机号, 其他通知类型不需要设置此项
         # @type NotifyAddress: String
         # @param ExpiredTime: 链接的过期时间，格式为Unix时间戳，不能早于当前时间，且最大为30天。如果不传，默认有效期为7天。
         # @type ExpiredTime: Integer
@@ -2912,7 +2941,7 @@ module TencentCloud
         # @type AppOriginalId: String
         # @param Path: 跳转路径
         # @type Path: String
-        # @param QrCode: base64格式跳转二维码
+        # @param QrCode: base64格式跳转二维码,可以通过微信扫描后跳转到业务界面
         # @type QrCode: String
         # @param UrlType: 链接类型，空-默认小程序端链接，H5SIGN-h5端链接
         # @type UrlType: String
@@ -3579,12 +3608,14 @@ module TencentCloud
 
       # DescribeFlowEvidenceReport返回参数结构体
       class DescribeFlowEvidenceReportResponse < TencentCloud::Common::AbstractModel
-        # @param ReportUrl: 报告 URL
+        # @param ReportUrl: 出证报告PDF的下载 URL
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ReportUrl: String
-        # @param Status: 执行中：EvidenceStatusExecuting
-        # 成功：EvidenceStatusSuccess
-        # 失败：EvidenceStatusFailed
+        # @param Status: 出证任务执行的状态, 分布表示下面的含义
+
+        # EvidenceStatusExecuting  出证任务在执行中
+        # EvidenceStatusSuccess  出证任务执行成功
+        # EvidenceStatusFailed  出征任务执行失败
         # @type Status: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -3609,10 +3640,13 @@ module TencentCloud
         # @param Operator: 调用方用户信息，userId 必填
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param FlowIds: 需要查询的流程ID列表，限制最大100个
+
+        # 如果查询合同组的信息,不要传此参数
         # @type FlowIds: Array
         # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param FlowGroupId: 合同组ID
+        # @param FlowGroupId: 合同组ID, 如果传此参数会忽略FlowIds入参
+        #  所以如传此参数不要传FlowIds参数
         # @type FlowGroupId: String
 
         attr_accessor :Operator, :FlowIds, :Agent, :FlowGroupId
@@ -4295,7 +4329,7 @@ module TencentCloud
         # @param SceneKey: 自动签场景:
         # E_PRESCRIPTION_AUTO_SIGN 电子处方
         # @type SceneKey: String
-        # @param UserInfo: 查询开启状态的用户信息
+        # @param UserInfo: 要查询开启状态的用户信息
         # @type UserInfo: :class:`Tencentcloud::Ess.v20201111.models.UserThreeFactor`
         # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
@@ -4328,11 +4362,14 @@ module TencentCloud
 
       # DescribeUserAutoSignStatus返回参数结构体
       class DescribeUserAutoSignStatusResponse < TencentCloud::Common::AbstractModel
-        # @param IsOpen: 是否已开通自动签
+        # @param IsOpen: 查询用户是否已开通自动签
         # @type IsOpen: Boolean
         # @param LicenseFrom: 自动签许可生效时间。当且仅当已开通自动签时有值。
+
+        # 值为unix时间戳,单位为秒。
         # @type LicenseFrom: Integer
         # @param LicenseTo: 自动签许可到期时间。当且仅当已开通自动签时有值。
+        # 值为unix时间戳,单位为秒。
         # @type LicenseTo: Integer
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -4866,7 +4903,9 @@ module TencentCloud
         # @param CreatedOn: 流程创建的时间戳，单位秒
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type CreatedOn: Integer
-        # @param FlowMessage: 拒签或者取消的原因描述
+        # @param FlowMessage: 当合同被拒签或者取消后(当FlowStatus=3或者FlowStatus=6的时候)
+        # 此字段展示拒签或者取消的原因描述
+
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowMessage: String
         # @param Creator:  合同发起人userId
@@ -5381,7 +5420,7 @@ module TencentCloud
 
       # GetTaskResultApi请求参数结构体
       class GetTaskResultApiRequest < TencentCloud::Common::AbstractModel
-        # @param TaskId: 任务Id，通过CreateConvertTaskApi得到
+        # @param TaskId: 任务Id，通过接口CreateConvertTaskApi或CreateMergeFileTask得到的返回任务id
         # @type TaskId: String
         # @param Operator: 操作人信息,UserId必填
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
@@ -5441,7 +5480,7 @@ module TencentCloud
         # ProcessFailed  - 转换失败
         # ProcessTimeout - 转换文件超时
         # @type TaskMessage: String
-        # @param ResourceId: 资源Id，也是FileId，用于文件发起使用
+        # @param ResourceId: 资源Id，也是FileId，用于文件发起时使用
         # @type ResourceId: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -6094,7 +6133,7 @@ module TencentCloud
         # - SIGN_SEAL-默认为印章控件类型
         # - SIGN_SIGNATURE-手写签名控件类型
         # @type ApproverSignComponentType: String
-        # @param ApproverSignRole: 签署方自定义控件别名，最大长度20个字符
+        # @param ApproverSignRole: 参与方在合同中的角色是按照创建合同的时候来排序的; 解除协议会将第一个参与人叫甲方, 第二个叫乙方,第三个叫丙方, 依次类推.  如果想改动参与人的角色名字, 可以设置此签署方自定义控件别名字段，最大20个字符
         # @type ApproverSignRole: String
 
         attr_accessor :Name, :Mobile, :RelievedApproverReceiptId, :ApproverType, :ApproverSignComponentType, :ApproverSignRole

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.623
+  version: 3.0.624
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-28 00:00:00.000000000 Z
+date: 2023-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common