tencentcloud-sdk-essbasic 3.0.695 → 3.0.697

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 30a5ceb47a62b7f419bd84e3dee631d20f0f3529
-  data.tar.gz: 520be7505e717ec39c30b3750a2a733c2e7cb695
+  metadata.gz: c5a23c3af1bb12ec45ad9babd9e725bc5b61163c
+  data.tar.gz: c874b8cc910e51da6f99f12778ae8e9fcba6e28e
 SHA512:
-  metadata.gz: c98753e5e97c5fcb0470273ceac46d96e3588e273b071bc678acf7afd213fea41171769483d01166c96ba9af04f721840c833c9ce5deb123265b16d2c0eed3cc
-  data.tar.gz: 367ac848a05c75fa14507716fc86657df91a9b874c704ff354ad1c14cfea0c4f756642c23ffd02908f808198017225d246b169ea1f430fa74474ec8efb63822c
+  metadata.gz: 637167672a942fab778e29b0b85f0edf64c23f7d1545787873d3d9fafab30513109851afcfaea98f807f30d2006905e768bb5d72070b7a8b76ccba6aaf259ed4
+  data.tar.gz: b440e21225412c2f402f5e2865a3f36bbb93e2e9cc72be3c777221118a306259788e1cd740e84897ce7793f5623ddbf36aa1eb6588f3cf5c00d7477281075b9d

data/lib/VERSION

@@ -1 +1 @@
-3.0.695
+3.0.697

data/lib/v20210526/client.rb

@@ -238,7 +238,25 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 此接口（ChannelCreateBoundFlows）用于子客领取合同，经办人需要有相应的角色，合同不能重复领取。
+        # 此接口（ChannelCreateBoundFlows）用于子客企业领取未归属给员工的合同，将合同领取给当前员工，合同不能重复领取。
+
+
+        # **未归属合同发起方式**
+        #  指定对应企业的OrganizationOpenId和OrganizationName而不指定具体的参与人(OpenId/名字/手机号等),  则合同进入待领取状态, 示例代码如下
+        # ```
+        # 		FlowApprovers: []*essbasic.FlowApproverInfo{
+        # 			{
+        # 				ApproverType:       common.StringPtr("ORGANIZATION"),
+        # 				OrganizationOpenId: common.StringPtr("org_dianziqian"),
+        # 				OrganizationName:   common.StringPtr("典子谦示例企业"),
+        # 			}
+        # 		},
+        # ```
+
+        # 可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/a34d0cc56ec871613e94dfc6252bc072.png)
+
+        # 注: `支持批量领取,  如果有一个合同流程无法领取会导致接口报错,  使得所有合同都领取失败`
 
         # @param request: Request instance for ChannelCreateBoundFlows.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateBoundFlowsRequest`
@@ -596,12 +614,16 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 指定需要批量催办的签署流程ID，批量催办合同，最多100个。需要符合以下条件的合同才可被催办：
+        # 指定需要批量催办的签署流程ID，批量催办合同，最多100个。需要符合以下条件的合同才可被催办
+        # 1. 合同中当前状态为 **待签署** 的签署人是催办的对象
+        # 2. **每个合同只能催办一次**
+
+        # **催办的效果**: 对方会收到如下的短信通知
 
-        # 1. 合同中当前状态为“待签署”的签署人是催办的对象
-        # 2. 每个合同只能催办一次
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/3caf94b7f540fa5736270d38528d3a7b.png)
 
-        # 注意：该接口无法直接调用，请联系客户经理申请使用。
+
+        # **注**：`合同催办是白名单功能，请联系客户经理申请开白后使用`
 
         # @param request: Request instance for ChannelCreateFlowReminds.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowRemindsRequest`
@@ -685,21 +707,21 @@ module TencentCloud
         end
 
         # 此接口（ChannelCreateMultiFlowSignQRCode）用于创建一码多扫流程签署二维码。
-        # 适用场景：无需填写签署人信息，可通过模板id生成签署二维码，签署人可通过扫描二维码补充签署信息进行实名签署。
-        # 常用于提前不知道签署人的身份信息场景，例如：劳务工招工、大批量员工入职等场景。
-
-        # **本接口适用于发起方没有填写控件的 B2C或者单C模板**
 
-        # **若是B2C模板,还要满足以下任意一个条件**
+        # **适用场景**:
+        # 签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景，例如：劳务工招工、大批量员工入职等场景。
 
-        # - 模板中配置的签署顺序是无序
-        # - B端企业的签署方式是静默签署
-        # - B端企业是非首位签署
-
-        # 通过一码多扫二维码发起的合同，合同涉及到的回调消息可参考文档[合同发起及签署相关回调
+        # **注意**:
+        # 1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**,  若是B2C模板,还要满足以下任意一个条件
+        #     - 模板中配置的签署顺序是无序
+        #     - B端企业的签署方式是静默签署
+        #     - B端企业是非首位签署
+        # 2. 通过一码多扫二维码发起的合同，合同涉及到的回调消息可参考文档[合同发起及签署相关回调
         # ]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
+        # 3. 用户通过签署二维码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
 
-        # 用户通过签署二维码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/partner/callback_types_commons#%E7%AD%BE%E7%BD%B2%E4%BA%8C%E7%BB%B4%E7%A0%81%E7%9B%B8%E5%85%B3%E5%9B%9E%E8%B0%83)
+        # 二维码的样式如下图:
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/27317cf5aacb094fb1dc6f94179a5148.png )
 
         # @param request: Request instance for ChannelCreateMultiFlowSignQRCode.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateMultiFlowSignQRCodeRequest`
@@ -723,12 +745,12 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过此接口，创建小程序批量签署链接，可以创建企业批量签署链接，员工只需点击链接即可跳转至控制台进行批量签署。
+        # 通过此接口，可以创建企业批量签署链接，员工只需点击链接即可跳转至控制台进行批量签署。
 
         # 注：
         # - 员工必须在企业下完成实名认证，且需作为批量签署合同的签署方或者领取方。
         # - 仅支持传入待签署或者待领取的合同，待填写暂不支持。
-        # - 员工批量签署，支持多种签名方式，包括手写签名、临摹签名、系统签名、个人印章，暂不支持签批控件
+        # - 员工批量签署，支持多种签名方式，包括手写签名、临摹签名、系统签名、个人印章、签批控件等。
 
         # @param request: Request instance for ChannelCreateOrganizationBatchSignUrl.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateOrganizationBatchSignUrlRequest`
@@ -1093,6 +1115,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口（ChannelDescribeBillUsageDetail）查询该第三方平台子客企业的套餐消耗详情。
+
+        # @param request: Request instance for ChannelDescribeBillUsageDetail.
+        # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelDescribeBillUsageDetailRequest`
+        # @rtype: :class:`Tencentcloud::essbasic::V20210526::ChannelDescribeBillUsageDetailResponse`
+        def ChannelDescribeBillUsageDetail(request)
+          body = send_request('ChannelDescribeBillUsageDetail', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ChannelDescribeBillUsageDetailResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 获取企业员工信息, 可以获取员工的名字,OpenId,UserId和简述的角色等信息，支持设置过滤条件以筛选员工查询结果。
 
         # **注**:通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/SyncProxyOrganizationOperators" target="_blank">企业员工新增或离职</a>接口增加的新员工或者离职的员工也会在列表中。
@@ -1119,7 +1165,21 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查询流程填写控件内容，可以根据流程Id查询该流程相关联的填写控件信息和填写内容。 注意：使用此接口前，需要在【企业应用管理】-【应用集成】-【第三方应用管理】中开通【下载应用内全量合同文件及内容数据】功能。
+        # 用于获取合同中填写控件填写状态和填写的内容。
+
+        # **注意**: `附件控件不会出现在结果列表中`
+
+
+        # **授权**:
+        # 此接口需要授权,  有两种开通权限的途径
+
+        # **第一种**:   需第三方应用的子企业登录控制台进行授权,  授权在**企业中心**的**授权管理**区域,  界面如下图
+        # 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
+
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
+
+        # **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
 
         # @param request: Request instance for ChannelDescribeFlowComponents.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelDescribeFlowComponentsRequest`
@@ -1478,6 +1538,9 @@ module TencentCloud
         # 1. 若在激活过程中，**更换用户OpenID重新生成链接，之前的认证会被清理**。因此不要在企业认证过程生成多个链接给多人同时操作，会导致认证过程互相影响。
         # 2. 若您认证中发现信息有误需要重新认证，**可通过更换用户OpenID重新生成链接的方式，来清理掉已有的流程**。
 
+        # 系统的渠道企业, 应用, 子客企业, 子客员工的组织形式
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/bee4b7375fe7a097f3573b18a1c1e30b.png)
+
         # @param request: Request instance for CreateConsoleLoginUrl.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::CreateConsoleLoginUrlRequest`
         # @rtype: :class:`Tencentcloud::essbasic::V20210526::CreateConsoleLoginUrlResponse`
@@ -1646,6 +1709,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口（DescribeBillUsageDetail）查询该第三方平台子客企业的套餐消耗详情。
+
+        # @param request: Request instance for DescribeBillUsageDetail.
+        # @type request: :class:`Tencentcloud::essbasic::V20210526::DescribeBillUsageDetailRequest`
+        # @rtype: :class:`Tencentcloud::essbasic::V20210526::DescribeBillUsageDetailResponse`
+        def DescribeBillUsageDetail(request)
+          body = send_request('DescribeBillUsageDetail', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeBillUsageDetailResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 获取出证报告任务执行结果，返回报告 URL。
 
         # 注意：
@@ -1745,10 +1832,10 @@ module TencentCloud
         # **第一种**:   需第三方应用的子企业登录控制台进行授权,  授权在**企业中心**的**授权管理**区域,  界面如下图
         # 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
 
-        # ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeResourceUrlsByFlows2.png)
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
 
         # **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
-        # ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeResourceUrlsByFlows_appilications2.png)
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
 
         # @param request: Request instance for DescribeResourceUrlsByFlows.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::DescribeResourceUrlsByFlowsRequest`
@@ -1774,6 +1861,15 @@ module TencentCloud
 
         # 通过此接口（DescribeTemplates）查询该第三方平台子客企业在电子签拥有的有效模板，不包括第三方平台模板。
 
+        # **适用场景**
+        #  该接口常用来配合<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，指定模板中需要的填写控件内容等，完成合同文档的的创建。
+
+        # **模版的来源**
+        # 子客企业的模板有两种途径获取
+        # - 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
+        # - 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
+
         # **一个模板通常会包含以下结构信息**
 
         # - 模板模版ID, 模板名字等基本信息
@@ -1783,14 +1879,9 @@ module TencentCloud
 
         # ![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，指定模板中需要的填写控件内容等，完成合同文档的的创建。
+        # 模版中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
 
-        # **模版的来源**
-        # 子客企业的模板有两种途径获取
-        # - 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
-        # - 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
 
 
         # **注意**
@@ -1820,8 +1911,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 此接口（DescribeUsage）用于获取第三方平台所有合作企业流量消耗情况。
-        #  注: 此接口每日限频50次，若要扩大限制次数,请提前与客服经理或邮件至e-contract@tencent.com进行联系。
+        # 此接口（DescribeUsage）用于获取此应用下子客企业的合同消耗数量。
+
+        # 注: 此接口**每日限频50次**，若要扩大限制次数,请提前与客服经理或邮件至e-contract@tencent.com进行联系。
 
         # @param request: Request instance for DescribeUsage.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::DescribeUsageRequest`
@@ -1850,8 +1942,8 @@ module TencentCloud
 
         # 注:
         # <ul>
-        # <li>仅支持下载 **本企业** 下合同，链接会 **登录企业控制台** </li>
-        # <li> **链接仅可使用一次**，不可重复使用</li>
+        # <li>仅支持下载 <b>本企业</b> 下合同，链接会 <b>登录企业控制台</b> </li>
+        # <li> <b>链接仅可使用一次</b>，不可重复使用</li>
         # </ul>
 
         # @param request: Request instance for GetDownloadFlowUrl.

data/lib/v20210526/models.rb

@@ -17,15 +17,20 @@
 module TencentCloud
   module Essbasic
     module V20210526
-      # 应用相关信息
+      # 应用相关信息, 整体应用的层级图如下
+
+      # 注:
+      #   1. `不同的业务系统可以采用不同的应用，不同应用下的数据是隔离的,  应用A中的某个企业已经实名, 在应用B中此企业还需要重新认证`
       class Agent < TencentCloud::Common::AbstractModel
-        # @param AppId: 应用的唯一标识。不同的业务系统可以采用不同的AppId，不同AppId下的数据是隔离的。可以由控制台开发者中心-应用集成自主生成。
+        # @param AppId: 应用的唯一标识(由电子签平台自动生成)。不同的业务系统可以采用不同的AppId，不同AppId下的数据是隔离的。可以由控制台开发者中心-应用集成自主生成。位置如下:
+
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/fac77e0d3f28aaec56669f67e65c8db8.png)
         # @type AppId: String
         # @param ProxyOrganizationOpenId: 第三方应用平台自定义，对应第三方平台子客企业的唯一标识。一个第三方平台子客企业主体与子客企业ProxyOrganizationOpenId是一一对应的，不可更改，不可重复使用。（例如，可以使用企业名称的hash值，或者社会统一信用代码的hash值，或者随机hash值，需要第三方应用平台保存），最大64位字符串
         # @type ProxyOrganizationOpenId: String
         # @param ProxyOperator: 第三方平台子客企业中的员工/经办人，通过第三方应用平台进入电子签完成实名、且被赋予相关权限后，可以参与到企业资源的管理或签署流程中。
         # @type ProxyOperator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
-        # @param ProxyAppId: 非必需参数，在第三方平台子客企业开通电子签后，会生成唯一的子客应用Id（ProxyAppId）用于代理调用时的鉴权，在子客开通的回调中获取。
+        # @param ProxyAppId: **不用填写**，在第三方平台子客企业开通电子签后，会生成唯一的子客应用Id（ProxyAppId）用于代理调用时的鉴权，在子客开通的回调中获取。
         # @type ProxyAppId: String
         # @param ProxyOrganizationId: 内部参数，暂未开放使用
         # @type ProxyOrganizationId: String
@@ -365,6 +370,104 @@ module TencentCloud
         end
       end
 
+      # 用户计费使用情况详情
+      class BillUsageDetail < TencentCloud::Common::AbstractModel
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowId: String
+        # @param OperatorName: 合同经办人名称
+        # 如果有多个经办人用分号隔开。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type OperatorName: String
+        # @param CreateOrganizationName: 发起方组织机构名称
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CreateOrganizationName: String
+        # @param FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
+        # 该名称还将用于合同签署完成后的下载文件名。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type FlowName: String
+        # @param Status: 当前合同状态,如下是状态码对应的状态。
+        # 0-还没有发起
+        # 1-等待签署
+        # 2-部分签署
+        # 3-拒签
+        # 4-已签署
+        # 5-已过期
+        # 6-已撤销
+        # 7-还没有预发起
+        # 8-等待填写
+        # 9-部分填写
+        # 10-拒填
+        # 11-已解除
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Status: Integer
+        # @param QuotaType: 套餐类型
+        # 对应关系如下
+        # CloudEnterprise-企业版合同
+        # SingleSignature-单方签章
+        # CloudProve-签署报告
+        # CloudOnlineSign-腾讯会议在线签约
+        # ChannelWeCard-微工卡
+        # SignFlow-合同套餐
+        # SignFace-签署意愿（人脸识别）
+        # SignPassword-签署意愿（密码）
+        # SignSMS-签署意愿（短信）
+        # PersonalEssAuth-签署人实名（腾讯电子签认证）
+        # PersonalThirdAuth-签署人实名（信任第三方认证）
+        # OrgEssAuth-签署企业实名
+        # FlowNotify-短信通知
+        # AuthService-企业工商信息查询
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type QuotaType: String
+        # @param UseCount: 合同使用量
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type UseCount: Integer
+        # @param CostTime: 消耗的时间戳，格式为Unix标准时间戳（秒）。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CostTime: Integer
+        # @param QuotaName: 消耗的套餐名称
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type QuotaName: String
+        # @param CostType: 消耗类型
+        # 1.扣费 2.撤销返还
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type CostType: Integer
+        # @param Remark: 备注
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Remark: String
+
+        attr_accessor :FlowId, :OperatorName, :CreateOrganizationName, :FlowName, :Status, :QuotaType, :UseCount, :CostTime, :QuotaName, :CostType, :Remark
+
+        def initialize(flowid=nil, operatorname=nil, createorganizationname=nil, flowname=nil, status=nil, quotatype=nil, usecount=nil, costtime=nil, quotaname=nil, costtype=nil, remark=nil)
+          @FlowId = flowid
+          @OperatorName = operatorname
+          @CreateOrganizationName = createorganizationname
+          @FlowName = flowname
+          @Status = status
+          @QuotaType = quotatype
+          @UseCount = usecount
+          @CostTime = costtime
+          @QuotaName = quotaname
+          @CostType = costtype
+          @Remark = remark
+        end
+
+        def deserialize(params)
+          @FlowId = params['FlowId']
+          @OperatorName = params['OperatorName']
+          @CreateOrganizationName = params['CreateOrganizationName']
+          @FlowName = params['FlowName']
+          @Status = params['Status']
+          @QuotaType = params['QuotaType']
+          @UseCount = params['UseCount']
+          @CostTime = params['CostTime']
+          @QuotaName = params['QuotaName']
+          @CostType = params['CostType']
+          @Remark = params['Remark']
+        end
+      end
+
       # 抄送信息
       class CcInfo < TencentCloud::Common::AbstractModel
         # @param Mobile: 被抄送人手机号，大陆11位手机号
@@ -479,6 +582,94 @@ module TencentCloud
         end
       end
 
+      # 用户计费使用情况详情
+      class ChannelBillUsageDetail < TencentCloud::Common::AbstractModel
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # @type FlowId: String
+        # @param OperatorName: 合同经办人名称
+        # 如果有多个经办人用分号隔开。
+        # @type OperatorName: String
+        # @param CreateOrganizationName: 发起方组织机构名称
+        # @type CreateOrganizationName: String
+        # @param FlowName: 合同流程的名称。
+        # @type FlowName: String
+        # @param FlowStatus: 合同流程当前的签署状态, 会存在下列的状态值
+        # <ul>
+        # <li>**INIT**: 合同创建</li>
+        # <li>**PART**: 合同签署中(至少有一个签署方已经签署)</li>
+        # <li>**REJECT**: 合同拒签</li>
+        # <li>**ALL**: 合同签署完成</li>
+        # <li>**DEADLINE**: 合同流签(合同过期)</li>
+        # <li>**CANCEL**: 合同撤回</li>
+        # <li>**RELIEVED**: 解除协议（已解除）</li>
+        # <li>**WILLEXPIRE**: 合同即将过期</li>
+        # <li>**EXCEPTION**: 合同异常</li>
+        # </ul>
+        # @type FlowStatus: String
+        # @param QuotaType: 查询的套餐类型
+        # 对应关系如下:
+        # <ul>
+        # <li>**CloudEnterprise**: 企业版合同</li>
+        # <li>**SingleSignature**: 单方签章</li>
+        # <li>**CloudProve**: 签署报告</li>
+        # <li>**CloudOnlineSign**: 腾讯会议在线签约</li>
+        # <li>**ChannelWeCard**: 微工卡</li>
+        # <li>**SignFlow**: 合同套餐</li>
+        # <li>**SignFace**: 签署意愿（人脸识别）</li>
+        # <li>**SignPassword**: 签署意愿（密码）</li>
+        # <li>**SignSMS**: 签署意愿（短信）</li>
+        # <li>**PersonalEssAuth**: 签署人实名（腾讯电子签认证）</li>
+        # <li>**PersonalThirdAuth**: 签署人实名（信任第三方认证）</li>
+        # <li>**OrgEssAuth**: 签署企业实名</li>
+        # <li>**FlowNotify**: 短信通知</li>
+        # <li>**AuthService**: 企业工商信息查询</li>
+        # </ul>
+        # @type QuotaType: String
+        # @param UseCount: 合同使用量
+        # 注: `如果消耗类型是撤销返还，此值为负值代表返还的合同数量`
+        # @type UseCount: Integer
+        # @param CostTime: 消耗的时间戳，格式为Unix标准时间戳（秒）。
+        # @type CostTime: Integer
+        # @param QuotaName: 消耗的套餐名称
+        # @type QuotaName: String
+        # @param CostType: 消耗类型
+        # **1**.扣费
+        # **2**.撤销返还
+        # @type CostType: Integer
+        # @param Remark: 备注
+        # @type Remark: String
+
+        attr_accessor :FlowId, :OperatorName, :CreateOrganizationName, :FlowName, :FlowStatus, :QuotaType, :UseCount, :CostTime, :QuotaName, :CostType, :Remark
+
+        def initialize(flowid=nil, operatorname=nil, createorganizationname=nil, flowname=nil, flowstatus=nil, quotatype=nil, usecount=nil, costtime=nil, quotaname=nil, costtype=nil, remark=nil)
+          @FlowId = flowid
+          @OperatorName = operatorname
+          @CreateOrganizationName = createorganizationname
+          @FlowName = flowname
+          @FlowStatus = flowstatus
+          @QuotaType = quotatype
+          @UseCount = usecount
+          @CostTime = costtime
+          @QuotaName = quotaname
+          @CostType = costtype
+          @Remark = remark
+        end
+
+        def deserialize(params)
+          @FlowId = params['FlowId']
+          @OperatorName = params['OperatorName']
+          @CreateOrganizationName = params['CreateOrganizationName']
+          @FlowName = params['FlowName']
+          @FlowStatus = params['FlowStatus']
+          @QuotaType = params['QuotaType']
+          @UseCount = params['UseCount']
+          @CostTime = params['CostTime']
+          @QuotaName = params['QuotaName']
+          @CostType = params['CostType']
+          @Remark = params['Remark']
+        end
+      end
+
       # ChannelCancelFlow请求参数结构体
       class ChannelCancelFlowRequest < TencentCloud::Common::AbstractModel
         # @param FlowId: 要撤销的合同流程ID
@@ -559,12 +750,13 @@ module TencentCloud
 
         # 此接口下面信息必填。
         # <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>
+        # 第三方平台子客企业和员工必须已经经过实名认证
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param QrCodeId: 二维码ID，为32位字符串。
+        # @param QrCodeId: 需要取消签署的二维码ID，为32位字符串。由[创建一码多扫流程签署二维码](https://qian.tencent.com/developers/partnerApis/templates/ChannelCreateMultiFlowSignQRCode)返回
         # @type QrCodeId: String
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -937,10 +1129,17 @@ module TencentCloud
 
       # ChannelCreateBoundFlows请求参数结构体
       class ChannelCreateBoundFlowsRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用信息
-        # 此接口Agent.AppId、Agent.ProxyOrganizationOpenId 和 Agent. ProxyOperator.OpenId 必填
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.AppId</li>
+        # <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+        # <li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+        # </ul>
+        # 第三方平台子客企业和员工必须已经经过实名认证,  合同会领取给对应的Agent.ProxyOperator.OpenId指定的员工来处理
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param FlowIds: 领取的合同id列表
+        # @param FlowIds: 需要领取的合同流程的ID列表
         # @type FlowIds: Array
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -1627,12 +1826,13 @@ module TencentCloud
 
         # 此接口下面信息必填。
         # <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>
+        # 第三方平台子客企业和员工必须已经经过实名认证
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param FlowIds: 需执行催办的签署流程ID数组，最多包含100个。
+        # @param FlowIds: 需执行催办的合同流程ID数组，最多支持100个。
         # @type FlowIds: Array
 
         attr_accessor :Agent, :FlowIds
@@ -1844,13 +2044,13 @@ module TencentCloud
 
         # 此接口下面信息必填。
         # <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>
+        # 第三方平台子客企业和员工必须已经经过实名认证
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
         # @param TemplateId: 合同模板ID，为32位字符串。
-        # 建议开发者保存此模板ID，后续用此模板发起合同流程需要此参数。
         # @type TemplateId: String
         # @param FlowName: 合同流程的名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。 该名称还将用于合同签署完成后的下载文件名。
         # @type FlowName: String
@@ -2176,19 +2376,31 @@ module TencentCloud
 
       # ChannelCreatePreparedPersonalEsign请求参数结构体
       class ChannelCreatePreparedPersonalEsignRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 和 Agent.ProxyAppId 必填。
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
         # @param UserName: 个人用户姓名
         # @type UserName: String
-        # @param IdCardNumber: 身份证件号码
+        # @param IdCardNumber: 证件号码, 应符合以下规则
+        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+        # <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+        # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         # @type IdCardNumber: String
-        # @param SealName: 印章名称
+        # @param SealName: 电子印章名字，1-50个中文字符
+        # 注:`同一企业下电子印章名字不能相同`
         # @type SealName: String
-        # @param SealImage: 印章图片的base64，最大不超过 8M
+        # @param SealImage: 电子印章图片base64编码，大小不超过10M（原始图片不超过5M），只支持PNG或JPG图片格式。
+
         # @type SealImage: String
-        # @param Operator: 操作者信息
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
-        # @param IdCardType: 身份证件类型
+        # @param IdCardType: 证件类型，支持以下类型
+        # <ul><li>ID_CARD : 居民身份证 (默认值)</li>
+        # <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
+        # <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li>
+        # <li>OTHER_CARD_TYPE : 其他</li></ul>
+
+        # 注: `其他证件类型为白名单功能，使用前请联系对接的客户经理沟通。`
         # @type IdCardType: String
         # @param SealImageCompress: 是否开启印章图片压缩处理，默认不开启，如需开启请设置为 true。当印章超过 2M 时建议开启，开启后图片的 hash 将发生变化。
         # @type SealImageCompress: Boolean
@@ -2238,7 +2450,9 @@ module TencentCloud
 
       # ChannelCreatePreparedPersonalEsign返回参数结构体
       class ChannelCreatePreparedPersonalEsignResponse < TencentCloud::Common::AbstractModel
-        # @param SealId: 导入的印章 ID
+        # @param SealId: 电子印章ID，为32位字符串。
+        # 建议开发者保留此印章ID，后续指定签署区印章或者操作印章需此印章ID。
+        # 可登录腾讯电子签控制台，在 "印章"->"印章中心"选择查看的印章，在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
         # @type SealId: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -2272,13 +2486,13 @@ module TencentCloud
         # @type NeedRelievedFlowId: String
         # @param ReliveInfo: 解除协议内容, 包括解除理由等信息。
         # @type ReliveInfo: :class:`Tencentcloud::Essbasic.v20210526.models.RelieveInfo`
-        # @param ReleasedApprovers: 替换解除协议的签署人， 如不指定替换签署人,  则使用原流程的签署人。 <br/>
-        # 如需更换原合同中的企业端签署人，可通过指定该签署人的RecipientId编号更换此企业端签署人。(可通过接口<a href="https://qian.tencent.com/developers/companyApis/queryFlows/DescribeFlowInfo/">DescribeFlowInfo</a>查询签署人的RecipientId编号)<br/>
+        # @param ReleasedApprovers: 指定解除协议的签署人，如不指定，则默认使用原流程的签署人。 <br/>
+        # 如需更换原合同中的企业端签署人，可通过指定该签署人在原合同列表中的ApproverNumber编号来更换此企业端签署人。(可通过接口<a href="https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo/">DescribeFlowDetailInfo</a>查询签署人的ApproverNumber编号，默认从0开始，顺序递增)<br/>
 
         # 注意：
         # <ul>
-        # <li>只能更换自己企业的签署人, 不支持更换个人类型或者其他企业的签署人</li>
-        # <li>可以不指定替换签署人, 使用原流程的签署人</li>
+        # <li>只能更换自己企业的签署人，不支持更换个人类型或者其他企业的签署人</li>
+        # <li>可以不指定替换签署人，使用原流程的签署人</li>
         # </ul>
         # @type ReleasedApprovers: Array
         # @param CallbackUrl: 签署完回调url，最大长度1000个字符
@@ -2430,11 +2644,24 @@ module TencentCloud
 
       # ChannelCreateSealPolicy请求参数结构体
       class ChannelCreateSealPolicyRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+
+        # 渠道应用标识: Agent.AppId
+        # 第三方平台子客企业标识: Agent.ProxyOrganizationOpenId
+        # 第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId
+        # 第三方平台子客企业和员工必须已经经过实名认证。
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param SealId: 指定印章ID
+        # @param SealId: 电子印章ID，为32位字符串。
+        # 建议开发者保留此印章ID，后续指定签署区印章或者操作印章需此印章ID。
+        # 可登录腾讯电子签控制台，在 "印章"->"印章中心"选择查看的印章，在"印章详情" 中查看某个印章的SealId(在页面中展示为印章ID)。
         # @type SealId: String
-        # @param UserIds: 指定待授权的用户ID数组,电子签的用户ID
+        # @param UserIds: 员工在腾讯电子签平台的唯一身份标识，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "更多能力"->"组织管理" 中查看某位员工的UserId(在页面中展示为用户ID)。
+        # 员工在贵司业务系统中的唯一身份标识，用于与腾讯电子签账号进行映射，确保在同一企业内不会出现重复。
+        # 该标识最大长度为64位字符串，仅支持包含26个英文字母和数字0-9的字符。
+        # 指定待授权的用户ID数组,电子签的用户ID
         # 可以填写OpenId，系统会通过组织+渠道+OpenId查询得到UserId进行授权。
         # @type UserIds: Array
         # @param Operator: 操作人（用户）信息，不用传
@@ -2966,6 +3193,101 @@ module TencentCloud
         end
       end
 
+      # ChannelDescribeBillUsageDetail请求参数结构体
+      class ChannelDescribeBillUsageDetailRequest < TencentCloud::Common::AbstractModel
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.AppId</li>
+        # <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+        # <li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+        # </ul>
+        # 第三方平台子客企业和员工必须已经经过实名认证
+        # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
+        # @param StartTime: 查询开始时间字符串，格式为yyyymmdd,时间跨度不能大于31天
+        # @type StartTime: String
+        # @param EndTime: 查询结束时间字符串，格式为yyyymmdd,时间跨度不能大于31天
+        # @type EndTime: String
+        # @param QuotaType: 查询的套餐类型 （选填 ）不传则查询所有套餐；
+        # 目前支持:
+        # <ul>
+        # <li>**CloudEnterprise**: 企业版合同</li>
+        # <li>**SingleSignature**: 单方签章</li>
+        # <li>**CloudProve**: 签署报告</li>
+        # <li>**CloudOnlineSign**: 腾讯会议在线签约</li>
+        # <li>**ChannelWeCard**: 微工卡</li>
+        # <li>**SignFlow**: 合同套餐</li>
+        # <li>**SignFace**: 签署意愿（人脸识别）</li>
+        # <li>**SignPassword**: 签署意愿（密码）</li>
+        # <li>**SignSMS**: 签署意愿（短信）</li>
+        # <li>**PersonalEssAuth**: 签署人实名（腾讯电子签认证）</li>
+        # <li>**PersonalThirdAuth**: 签署人实名（信任第三方认证）</li>
+        # <li>**OrgEssAuth**: 签署企业实名</li>
+        # <li>**FlowNotify**: 短信通知</li>
+        # <li>**AuthService**: 企业工商信息查询</li>
+        # </ul>
+        # @type QuotaType: String
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页，页码从 0 开始，即首页为 0
+        # @type Offset: Integer
+        # @param Limit: 指定分页每页返回的数据条数，如果不传默认为 50，单页最大支持 50。
+        # @type Limit: Integer
+
+        attr_accessor :Agent, :StartTime, :EndTime, :QuotaType, :Offset, :Limit
+
+        def initialize(agent=nil, starttime=nil, endtime=nil, quotatype=nil, offset=nil, limit=nil)
+          @Agent = agent
+          @StartTime = starttime
+          @EndTime = endtime
+          @QuotaType = quotatype
+          @Offset = offset
+          @Limit = limit
+        end
+
+        def deserialize(params)
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @StartTime = params['StartTime']
+          @EndTime = params['EndTime']
+          @QuotaType = params['QuotaType']
+          @Offset = params['Offset']
+          @Limit = params['Limit']
+        end
+      end
+
+      # ChannelDescribeBillUsageDetail返回参数结构体
+      class ChannelDescribeBillUsageDetailResponse < TencentCloud::Common::AbstractModel
+        # @param Total: 返回查询记录总数
+        # @type Total: Integer
+        # @param Details: 消耗记录详情
+        # @type Details: Array
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Total, :Details, :RequestId
+
+        def initialize(total=nil, details=nil, requestid=nil)
+          @Total = total
+          @Details = details
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Total = params['Total']
+          unless params['Details'].nil?
+            @Details = []
+            params['Details'].each do |i|
+              channelbillusagedetail_tmp = ChannelBillUsageDetail.new
+              channelbillusagedetail_tmp.deserialize(i)
+              @Details << channelbillusagedetail_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # ChannelDescribeEmployees请求参数结构体
       class ChannelDescribeEmployeesRequest < TencentCloud::Common::AbstractModel
         # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
@@ -3072,9 +3394,17 @@ module TencentCloud
 
       # ChannelDescribeFlowComponents请求参数结构体
       class ChannelDescribeFlowComponentsRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用相关信息。此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.AppId</li>
+        # <li>第三方平台子客企业标识: Agent.ProxyOrganizationOpenId</li>
+        # <li>第三方平台子客企业中的员工标识: Agent. ProxyOperator.OpenId</li>
+        # </ul>
+        # 第三方平台子客企业和员工必须已经经过实名认证
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param FlowId: 电子签流程的Id
+        # @param FlowId: 需要获取填写控件填写内容的合同流程ID
         # @type FlowId: String
 
         attr_accessor :Agent, :FlowId
@@ -3095,8 +3425,7 @@ module TencentCloud
 
       # ChannelDescribeFlowComponents返回参数结构体
       class ChannelDescribeFlowComponentsResponse < TencentCloud::Common::AbstractModel
-        # @param RecipientComponentInfos: 流程关联的填写控件信息，控件会按照参与方进行分类。
-        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @param RecipientComponentInfos: 合同填写控件信息列表，填写控件会按照参与方角色进行分类。
         # @type RecipientComponentInfos: Array
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -4930,6 +5259,91 @@ module TencentCloud
         end
       end
 
+      # DescribeBillUsageDetail请求参数结构体
+      class DescribeBillUsageDetailRequest < TencentCloud::Common::AbstractModel
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+        # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
+        # @param StartTime: 查询开始时间字符串，格式为yyyymmdd,时间跨度不能大于31天
+        # @type StartTime: String
+        # @param EndTime: 查询结束时间字符串，格式为yyyymmdd,时间跨度不能大于31天
+        # @type EndTime: String
+        # @param QuotaType: 查询的套餐类型 （选填 ）不传则查询所有套餐；
+        # 对应关系如下
+        # CloudEnterprise-企业版合同
+        # SingleSignature-单方签章
+        # CloudProve-签署报告
+        # CloudOnlineSign-腾讯会议在线签约
+        # ChannelWeCard-微工卡
+        # SignFlow-合同套餐
+        # SignFace-签署意愿（人脸识别）
+        # SignPassword-签署意愿（密码）
+        # SignSMS-签署意愿（短信）
+        # PersonalEssAuth-签署人实名（腾讯电子签认证）
+        # PersonalThirdAuth-签署人实名（信任第三方认证）
+        # OrgEssAuth-签署企业实名
+        # FlowNotify-短信通知
+        # AuthService-企业工商信息查询
+        # @type QuotaType: String
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页，页码从 0 开始，即首页为 0
+        # @type Offset: Integer
+        # @param Limit: 指定分页每页返回的数据条数，如果不传默认为 50，单页最大支持 50。
+        # @type Limit: Integer
+
+        attr_accessor :Agent, :StartTime, :EndTime, :QuotaType, :Offset, :Limit
+
+        def initialize(agent=nil, starttime=nil, endtime=nil, quotatype=nil, offset=nil, limit=nil)
+          @Agent = agent
+          @StartTime = starttime
+          @EndTime = endtime
+          @QuotaType = quotatype
+          @Offset = offset
+          @Limit = limit
+        end
+
+        def deserialize(params)
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @StartTime = params['StartTime']
+          @EndTime = params['EndTime']
+          @QuotaType = params['QuotaType']
+          @Offset = params['Offset']
+          @Limit = params['Limit']
+        end
+      end
+
+      # DescribeBillUsageDetail返回参数结构体
+      class DescribeBillUsageDetailResponse < TencentCloud::Common::AbstractModel
+        # @param Total: 返回查询记录总数
+        # @type Total: Integer
+        # @param Details: 消耗记录详情
+        # @type Details: Array
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Total, :Details, :RequestId
+
+        def initialize(total=nil, details=nil, requestid=nil)
+          @Total = total
+          @Details = details
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Total = params['Total']
+          unless params['Details'].nil?
+            @Details = []
+            params['Details'].each do |i|
+              billusagedetail_tmp = BillUsageDetail.new
+              billusagedetail_tmp.deserialize(i)
+              @Details << billusagedetail_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeChannelFlowEvidenceReport请求参数结构体
       class DescribeChannelFlowEvidenceReportRequest < TencentCloud::Common::AbstractModel
         # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
@@ -5372,20 +5786,32 @@ module TencentCloud
 
       # DescribeUsage请求参数结构体
       class DescribeUsageRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用信息，此接口Agent.AppId必填
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.AppId</li>
+        # </ul>
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param StartDate: 开始时间，例如：2021-03-21
+        # @param StartDate: 查询日期范围的开始时间, 查询会包含此日期的数据 , 格式为yyyy-mm-dd (例如：2021-03-21)
+
+        # 注: `查询日期范围区间长度大于90天`。
         # @type StartDate: String
-        # @param EndDate: 结束时间，例如：2021-06-21；
-        # 开始时间到结束时间的区间长度小于等于90天。
+        # @param EndDate: 查询日期范围的结束时间, 查询会包含此日期的数据 , 格式为yyyy-mm-dd (例如：2021-04-21)
+
+        # 注: `查询日期范围区间长度大于90天`。
         # @type EndDate: String
         # @param NeedAggregate: 是否汇总数据，默认不汇总。
-        # 不汇总：返回在统计区间内第三方平台下所有企业的每日明细，即每个企业N条数据，N为统计天数；
-        # 汇总：返回在统计区间内第三方平台下所有企业的汇总后数据，即每个企业一条数据；
+        # <ul><li> **true** :  汇总数据,  即每个企业一条数据, 对日志范围内的数据相加</li>
+        # <li> **false** :  不会总数据,  返回企业每日明细,   按日期返回每个企业的数据(如果企业对应天数没有操作则无此企业此日期的数据)</li></ul>
         # @type NeedAggregate: Boolean
-        # @param Limit: 单次返回的最多条目数量。默认为1000，且不能超过1000。
+        # @param Limit: 指定每页返回的数据条数，和Offset参数配合使用。
+
+        # 注: `默认值为1000，单页做大值为1000`
         # @type Limit: Integer
-        # @param Offset: 偏移量，默认是0。
+        # @param Offset: 查询结果分页返回，指定从第几页返回数据，和Limit参数配合使用。
+
+        # 注：`offset从0开始，即第一页为0。`
         # @type Offset: Integer
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -5603,20 +6029,19 @@ module TencentCloud
 
       # 文档内的填充控件返回结构体，返回控件的基本信息和填写内容值
       class FilledComponent < TencentCloud::Common::AbstractModel
-        # @param ComponentId: 控件Id
-        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @param ComponentId: 填写控件ID
         # @type ComponentId: String
         # @param ComponentName: 控件名称
-        # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ComponentName: String
-        # @param ComponentFillStatus: 控件填写状态；0-未填写；1-已填写
-        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @param ComponentFillStatus: 此填写控件的填写状态
+        #  **0** : 此填写控件**未填写**
+        # **1** : 此填写控件**已填写**
         # @type ComponentFillStatus: String
         # @param ComponentValue: 控件填写内容
-        # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ComponentValue: String
         # @param ImageUrl: 图片填充控件下载链接，如果是图片填充控件时，这里返回图片的下载链接。
-        # 注意：此字段可能返回 null，表示取不到有效值。
+
+        # 注: `链接不是永久链接,  默认有效期5分钟后, 到期后链接失效`
         # @type ImageUrl: String
 
         attr_accessor :ComponentId, :ComponentName, :ComponentFillStatus, :ComponentValue, :ImageUrl
@@ -5660,49 +6085,49 @@ module TencentCloud
 
       # 签署人的流程信息明细
       class FlowApproverDetail < TencentCloud::Common::AbstractModel
-        # @param ReceiptId: 模板配置时候的签署人id,与控件绑定
+        # @param ReceiptId: 模板配置时候的签署人角色ID(用PDF文件发起也可以指定,如果不指定则自动生成此角色ID), 所有的填写控件和签署控件都归属不同的角色
         # @type ReceiptId: String
-        # @param ProxyOrganizationOpenId: 平台企业的第三方id
+        # @param ProxyOrganizationOpenId: 第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样, 可以参考<a href="https://qian.tencent.com/developers/partnerApis/dataTypes/#agent" target="_blank">Agent结构体</a>
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ProxyOrganizationOpenId: String
-        # @param ProxyOperatorOpenId: 平台企业操作人的第三方id
+        # @param ProxyOperatorOpenId: 第三方平台子客企业员工的唯一标识
         # @type ProxyOperatorOpenId: String
-        # @param ProxyOrganizationName: 平台企业名称
+        # @param ProxyOrganizationName: 第三方平台子客企业名称，与企业营业执照中注册的名称一致。
         # @type ProxyOrganizationName: String
         # @param Mobile: 签署人手机号
         # @type Mobile: String
-        # @param SignOrder: 签署人签署顺序
+        # @param SignOrder: 签署顺序，如果是有序签署，签署顺序从小到大
         # @type SignOrder: Integer
-        # @param ApproveName: 签署人姓名
+        # @param ApproveName: 签署方经办人的姓名。
+        # 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ApproveName: String
         # @param ApproveStatus: 当前签署人的状态, 状态如下
-        # <br/>PENDING 待签署
-        # <br/>FILLPENDING 待填写
-        # <br/>FILLACCEPT 填写完成
-        # <br/>FILLREJECT 拒绝填写
-        # <br/>WAITPICKUP 待领取
-        # <br/>ACCEPT 已签署
-        # <br/>REJECT 拒签
-        # <br/>DEADLINE 过期没人处理
-        # <br/>CANCEL 流程已撤回
-        # <br/>FORWARD 已经转他人处理
-        # <br/>STOP 流程已终止
-        # <br/>RELIEVED 解除协议（已解除）
-
+        # <ul><li> **PENDING** :待签署</li>
+        # <li> **FILLPENDING** :待填写</li>
+        # <li> **FILLACCEPT** :填写完成</li>
+        # <li> **FILLREJECT** :拒绝填写</li>
+        # <li> **WAITPICKUP** :待领取</li>
+        # <li> **ACCEPT** :已签署</li>
+        # <li> **REJECT** :拒签</li>
+        # <li> **DEADLINE** :过期没人处理</li>
+        # <li> **CANCEL** :流程已撤回</li>
+        # <li> **FORWARD** :已经转他人处理</li>
+        # <li> **STOP** :流程已终止</li>
+        # <li> **RELIEVED** :解除协议（已解除）</li></ul>
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ApproveStatus: String
-        # @param ApproveMessage: 签署人自定义信息
+        # @param ApproveMessage: 签署人拒签等情况的时候填写的原因
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ApproveMessage: String
         # @param ApproveTime: 签署人签署时间戳，单位秒
         # @type ApproveTime: Integer
         # @param ApproveType: 参与者类型
-        # <br/>ORGANIZATION：企业签署人
-        # <br/>PERSON：个人签署人
+        # <ul><li> **ORGANIZATION** :企业签署人</li>
+        # <li> **PERSON** :个人签署人</li></ul>
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ApproveType: String
-        # @param ApproverRoleName: 自定义签署人角色
+        # @param ApproverRoleName: 自定义签署人的角色名, 如: 收款人、开具人、见证人等
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ApproverRoleName: String
 
@@ -7469,16 +7894,20 @@ module TencentCloud
 
       # 参与方填写控件信息
       class RecipientComponentInfo < TencentCloud::Common::AbstractModel
-        # @param RecipientId: 参与方Id
-        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @param RecipientId: 参与方的角色ID
         # @type RecipientId: String
         # @param RecipientFillStatus: 参与方填写状态
-        # 注意：此字段可能返回 null，表示取不到有效值。
+
+        # <ul><li> **0** : 还没有填写</li>
+        # <li> **1** : 已经填写</li></ul>
         # @type RecipientFillStatus: String
-        # @param IsPromoter: 是否发起方
+        # @param IsPromoter: 此角色是否是发起方角色
+
+        # <ul><li> **true** : 是发起方角色</li>
+        # <li> **false** : 不是发起方角色</li></ul>
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type IsPromoter: Boolean
-        # @param Components: 填写控件内容
+        # @param Components: 此角色的填写控件列表
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Components: Array
 
@@ -7522,19 +7951,19 @@ module TencentCloud
         # 可以通过<a href="https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo" target="_blank">DescribeFlowDetailInfo</a>接口查看原流程中的签署人列表。
         # @type ApproverNumber: Integer
         # @param ApproverType: 指定签署人类型，目前支持
-        # <ul><li> **ORGANIZATION**：企业（默认值）</li>
+        # <ul><li> **ORGANIZATION**：企业(默认值)</li>
         # <li> **ENTERPRISESERVER**：企业静默签</li></ul>
         # @type ApproverType: String
         # @param Name: 签署人姓名，最大长度50个字。
         # @type Name: String
         # @param IdCardType: 签署方经办人的证件类型，支持以下类型
-        # <ul><li>ID_CARD : 居民身份证  (默认值)</li>
+        # <ul><li>ID_CARD : 居民身份证(默认值)</li>
         # <li>HONGKONG_AND_MACAO : 港澳居民来往内地通行证</li>
         # <li>HONGKONG_MACAO_AND_TAIWAN : 港澳台居民居住证(格式同居民身份证)</li></ul>
         # @type IdCardType: String
         # @param IdCardNumber: 证件号码，应符合以下规则
-        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
-        # <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
+        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成(如存在X，请大写)。</li>
+        # <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母(但“I”、“O”除外)，后7位为阿拉伯数字。</li>
         # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         # @type IdCardNumber: String
         # @param Mobile: 签署人手机号。
@@ -7675,10 +8104,13 @@ module TencentCloud
       # 签署二维码的基本信息，用于创建二维码，用户可扫描该二维码进行签署操作。
       class SignQrCode < TencentCloud::Common::AbstractModel
         # @param QrCodeId: 二维码ID，为32位字符串。
+
+        # 注: 需要保留此二维码ID, 用于后序通过<a href="https://qian.tencent.com/developers/partnerApis/templates/ChannelCancelMultiFlowSignQRCode" target="_blank">取消一码多扫二维码</a>关闭这个二维码的签署功能。
         # @type QrCodeId: String
         # @param QrCodeUrl: 二维码URL，可通过转换二维码的工具或代码组件将此URL转化为二维码，以便用户扫描进行流程签署。
         # @type QrCodeUrl: String
-        # @param ExpiredTime: 二维码的有截止时间，格式为Unix标准时间戳（秒）。 一旦超过二维码的有效期限，该二维码将自动失效。
+        # @param ExpiredTime: 二维码的有截止时间，格式为Unix标准时间戳（秒），可以通过入参的QrEffectiveDay来设置有效期，默认为7天有效期。
+        # 一旦超过二维码的有效期限，该二维码将自动失效。
         # @type ExpiredTime: Integer
 
         attr_accessor :QrCodeId, :QrCodeUrl, :ExpiredTime
@@ -8036,7 +8468,7 @@ module TencentCloud
         # 注: `现在仅支持ID_CARD居民身份证类型`
         # @type ProxyLegalIdCardType: String
         # @param ProxyLegalIdCardNumber: 第三方平台子客企业法定代表人的证件号码, 应符合以下规则
-        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li>
+        # <ul><li>居民身份证号码应为18位字符串，由数字和大写字母X组成（如存在X，请大写）。</li></ul>
         # @type ProxyLegalIdCardNumber: String
         # @param ProxyAddress: 第三方平台子客企业详细住所，最大长度500个字符
 
@@ -8350,17 +8782,17 @@ module TencentCloud
 
       # 用量明细
       class UsageDetail < TencentCloud::Common::AbstractModel
-        # @param ProxyOrganizationOpenId: 子客企业唯一标识
+        # @param ProxyOrganizationOpenId: 子客企业标识
         # @type ProxyOrganizationOpenId: String
         # @param ProxyOrganizationName: 子客企业名
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ProxyOrganizationName: String
-        # @param Date: 日期，当需要汇总数据时日期为空
+        # @param Date: 对应的消耗日期, **如果是汇总数据则为1970-01-01**
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Date: String
-        # @param Usage: 消耗数量
+        # @param Usage: 消耗合同数量
         # @type Usage: Integer
-        # @param Cancel: 撤回数量
+        # @param Cancel: 撤回合同数量
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Cancel: Integer
         # @param FlowChannel: 消耗渠道
@@ -8388,9 +8820,16 @@ module TencentCloud
         end
       end
 
-      # 接口调用者信息
+      # 接口调用的员工信息
       class UserInfo < TencentCloud::Common::AbstractModel
-        # @param OpenId: 第三方应用平台自定义，对应第三方平台子客企业员的唯一标识。一个OpenId在一个子客企业内唯一对应一个真实员工，不可在其他子客企业内重复使用。（例如，可以使用经办人企业名+员工身份证的hash值，需要第三方应用平台保存），最大64位字符串
+        # @param OpenId: 第三方应用平台自定义，对应第三方平台子客企业员工的唯一标识。
+
+
+        # 注意:
+        # 1. OpenId在子客企业对应一个真实员工，**本应用唯一, 不可重复使用**，最大64位字符串
+        # 2. 可使用用户在贵方企业系统中的Userid或者hash值作为子客企业的员工OpenId
+        # 3. **员工加入企业后**, 可以通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录子客控制台后, 在**组织架构**模块查看员工们的OpenId, 样式如下图
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/bb67fb66c926759df3a0af5838fdafd5.png)
         # @type OpenId: String
         # @param Channel: 内部参数，暂未开放使用
         # @type Channel: String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-essbasic
 version: !ruby/object:Gem::Version
-  version: 3.0.695
+  version: 3.0.697
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-07 00:00:00.000000000 Z
+date: 2023-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,11 +33,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/v20201222/models.rb
-- lib/v20201222/client.rb
-- lib/tencentcloud-sdk-essbasic.rb
-- lib/v20210526/models.rb
 - lib/v20210526/client.rb
+- lib/v20210526/models.rb
+- lib/tencentcloud-sdk-essbasic.rb
+- lib/v20201222/client.rb
+- lib/v20201222/models.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: