tencentcloud-sdk-essbasic 3.0.678 → 3.0.680

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2bfd7dbd5a5de34e7cfdfab8c533cf28fbb688ad
-  data.tar.gz: 1d66d53c9b02c505ff17172a124f450b90e4a2f8
+  metadata.gz: 6bbdfeec2f5d1dc72b0192b2f0ecc3cc9fcc5996
+  data.tar.gz: 8fd260b485b275a73616f631601c5f3126684de3
 SHA512:
-  metadata.gz: d2235a8aa9c65e364afb46854497f2e4cb57e891e84349ad2b112e33799879d9c6ac2e9161133a2bbd8a66f21f654e4cf3889e28c0fa53fc062e0ff0331fe29b
-  data.tar.gz: 4b1b1fb1fc85b3a5efd1a892eab8d40f7b3544edfcf415894aacf708321dfa3598b5769acfe6d20723b4410928889e8fea583086d2de7c3a6ede8194cf278776
+  metadata.gz: 69524c740f2a24a54811b6bec221e29fdc04a262006bdbc47ed842abe82cf0ce0f2f199926dbbd2998b59b10a490f71b8f0013fef38f904ed774bf36e32e43cc
+  data.tar.gz: c553b902eb96c4fc6adfbde02e9ae634c7b1d07d00a450dd879b79ae87171a1ee9638fabcaa7110383a5de972aec6a51978bb808002ca13fd5e9a0d1cf76ec79

data/lib/VERSION

@@ -1 +1 @@
-3.0.678
+3.0.680

data/lib/tencentcloud-sdk-essbasic.rb

@@ -2,12 +2,12 @@
 
 require 'tencentcloud-sdk-common'
 
-require_relative 'v20201222/client'
-require_relative 'v20201222/models'
-
 require_relative 'v20210526/client'
 require_relative 'v20210526/models'
 
+require_relative 'v20201222/client'
+require_relative 'v20201222/models'
+
 module TencentCloud
   module Essbasic
   end

data/lib/v20210526/client.rb

@@ -305,7 +305,62 @@ module TencentCloud
 
         # 接口（ChannelCreateFlowByFiles）用PDF文件创建签署流程。
 
-        # 注: `此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。`
+        # 适用场景：适用非制式的合同文件签署，开发者有每个签署流程的PDF，可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
+
+        # **注**:
+        # <ul>
+        # <li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
+        # <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号（FileIds）进行使用。整体的逻辑如下图</li>
+        # </ul>
+
+        # ![image](https://dyn.ess.tencent.cn/guide/capi/ChannelCreateFlowByFiles.png)
+
+        # **可以作为发起方和签署方的角色列表**
+        # <table>
+        # <thead>
+        # <tr>
+        # <th>场景编号</th>
+        # <th>可作为发起方类型</th>
+        # <th>可作为签署方的类型</th>
+        # </tr>
+        # </thead>
+
+        # <tbody>
+        # <tr>
+        # <td>场景一</td>
+        # <td>第三方子企业A员工</td>
+        # <td>第三方子企业A员工</td>
+        # </tr>
+
+        # <tr>
+        # <td>场景二</td>
+        # <td>第三方子企业A员工</td>
+        # <td>第三方子企业B(不指定经办人)</td>
+        # </tr>
+
+        # <tr>
+        # <td>场景三</td>
+        # <td>第三方子企业A员工</td>
+        # <td>第三方子企业B员工</td>
+        # </tr>
+
+        # <tr>
+        # <td>场景四</td>
+        # <td>第三方子企业A员工</td>
+        # <td>个人/自然人</td>
+        # </tr>
+
+        # <tr>
+        # <td>场景五</td>
+        # <td>第三方子企业A员工</td>
+        # <td>SaaS平台企业员工</td>
+        # </tr>
+        # </tbody>
+        # </table>
+
+        # **注**:
+        # `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+        # `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
         # @param request: Request instance for ChannelCreateFlowByFiles.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowByFilesRequest`
@@ -1080,7 +1135,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 对流程的合同文件进行数字签名验证，判断文件是否被篡改。
+        # 对合同流程文件进行数字签名验证，判断数字签名是否有效，合同文件内容是否被篡改。
 
         # @param request: Request instance for ChannelVerifyPdf.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelVerifyPdfRequest`
@@ -1104,8 +1159,15 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建出证报告，返回报告 ID。需要配合出证套餐才能调用。
-        # 出证需要一定时间，建议调用创建出证24小时之后再通过DescribeChannelFlowEvidenceReport进行查询。
+        # 提交申请出证报告任务并返回报告ID。
+
+        # 注意：
+        # <ul><li>使用此功能`需搭配出证套餐` ，使用前请联系对接的客户经理沟通。</li>
+        # <li>操作人必须是`发起方或者签署方企业的(非走授权书认证)法人或者超管`。</li>
+        # <li>合同流程必须所有参与方`已经签署完成`。</li>
+        # <li>出证过程需一定时间，建议在`提交出证任务后的24小时之后`，通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。</li></ul>
+
+        # <svg id="SvgjsSvg1006" width="262" height="229" xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svgjs="http://svgjs.com/svgjs"><defs id="SvgjsDefs1007"><pattern patternUnits="userSpaceOnUse" id="pattern_mark_0" width="300" height="300"><text x="150" y="100" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><pattern patternUnits="userSpaceOnUse" id="pattern_mark_1" width="300" height="300"><text x="150" y="200" fill="rgba(229,229,229,0.8)" font-size="18" transform="rotate(-45, 150, 150)" style="dominant-baseline: middle; text-anchor: middle;"></text></pattern><marker id="SvgjsMarker1021" markerWidth="12" markerHeight="8" refX="9" refY="4" viewBox="0 0 12 8" orient="auto" markerUnits="userSpaceOnUse" stroke-dasharray="0,0"><path id="SvgjsPath1022" d="M0,0 L12,4 L0,8 L0,0" fill="#323232" stroke="#323232" stroke-width="1"></path></marker></defs><rect id="svgbackgroundid" width="262" height="229" fill="transparent"></rect><rect id="SvgjsRect1009" width="262" height="229" fill="url(#pattern_mark_0)"></rect><rect id="SvgjsRect1010" width="262" height="229" fill="url(#pattern_mark_1)"></rect><g id="SvgjsG1011" transform="translate(31.75,25)"><path id="SvgjsPath1012" d="M 0 0L 198 0L 198 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1013"><text id="SvgjsText1014" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="178px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1015" dy="16" x="99"><tspan id="SvgjsTspan1016" style="text-decoration:;fill: rgb(28, 30, 33);">CreateFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1017" dy="16" x="99"><tspan id="SvgjsTspan1018" style="text-decoration:;fill: rgb(51, 51, 51);">提交申请出证报告任务</tspan></tspan></text></g></g><g id="SvgjsG1019"><path id="SvgjsPath1020" d="M130.75 84.5L130.75 114.5L130.75 114.5L130.75 143.2" stroke="#323232" stroke-width="1" fill="none" marker-end="url(#SvgjsMarker1021)"></path></g><g id="SvgjsG1023" transform="translate(25,145)"><path id="SvgjsPath1024" d="M 0 0L 211.5 0L 211.5 59L 0 59Z" stroke="rgba(86,146,48,1)" stroke-width="1" fill-opacity="1" fill="#e7ebed"></path><g id="SvgjsG1025"><text id="SvgjsText1026" font-family="微软雅黑" text-anchor="middle" font-size="13px" width="192px" fill="#323232" font-weight="400" align="middle" lineHeight="125%" anchor="middle" family="微软雅黑" size="13px" weight="400" font-style="" opacity="1" y="10.375" transform="rotate(0)"><tspan id="SvgjsTspan1027" dy="16" x="106"><tspan id="SvgjsTspan1028" style="text-decoration:;fill: rgb(28, 30, 33);">DescribeFlowEvidenceReport</tspan></tspan><tspan id="SvgjsTspan1029" dy="16" x="106"><tspan id="SvgjsTspan1030" style="text-decoration:;fill: rgb(51, 51, 51);">获取出证报告任务执行结果</tspan></tspan></text></g></g></svg>
 
         # @param request: Request instance for CreateChannelFlowEvidenceReport.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::CreateChannelFlowEvidenceReportRequest`
@@ -1129,7 +1191,40 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 此接口（CreateChannelOrganizationInfoChangeUrl）用于创建子客企业信息变更链接，支持创建企业超管变更链接或企业基础信息变更链接，通过入参ChangeType指定。
+        # 此接口（CreateChannelOrganizationInfoChangeUrl）用于创建子客企业信息变更链接（需要在移动端打开，会跳转到微信小程序），支持创建企业超管变更链接或企业基础信息变更链接，通过入参 ChangeType 指定。
+
+
+        # <h3 id="1-企业超管变更">1. 企业超管变更</h3>
+
+        # <p>换成企业的其他员工来当超管</p>
+
+        # <h3 id="2-企业基础信息变更">2. 企业基础信息变更</h3>
+
+        # <h4 id="可以变动">可以变动</h4>
+
+        # <ul>
+        # <li>企业名称<br>
+        # </li>
+        # <li>法定代表人姓名(新法人有邀请链接)<br>
+        # </li>
+        # <li>企业地址和所在地</li>
+        # </ul>
+
+        # <h4 id="不可变动">不可变动</h4>
+
+        # <ul>
+        # <li>统一社会信用代码<br>
+        # </li>
+        # <li>企业主体类型</li>
+        # </ul>
+
+        # <p>如果企业名称变动会引起下面的变动</p>
+
+        # <ul>
+        # <li>合同:   老合同不做任何处理,   新发起的合同需要用新的企业名字作为签署方, 否则无法签署</li>
+        # <li>印章:   会删除所有的印章所有的机构公章和合同专用章,  然后用新企业名称生成新的机构公章 和合同专用章,  而法人章, 财务专用章和人事专用章不会处理</li>
+        # <li>证书:   企业证书会重新请求CA机构用新企业名称生成新的证书</li>
+        # </ul>
 
         # @param request: Request instance for CreateChannelOrganizationInfoChangeUrl.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::CreateChannelOrganizationInfoChangeUrlRequest`
@@ -1190,6 +1285,57 @@ module TencentCloud
         # 如若在模板中配置了动态表格, 上传的附件必须为A4大小
         # 合同发起人必须在电子签已经进行实名。
 
+        # **整体的逻辑如下**
+
+        # ![image](https://dyn.ess.tencent.cn/guide/capi/CreateFlowsByTemplates.png)
+
+        # **可以作为发起方和签署方的角色列表**
+        # <table>
+        # <thead>
+        # <tr>
+        # <th>场景编号</th>
+        # <th>可作为发起方类型</th>
+        # <th>可作为签署方的类型</th>
+        # </tr>
+        # </thead>
+
+        # <tbody>
+        # <tr>
+        # <td>场景一</td>
+        # <td>第三方子企业A员工</td>
+        # <td>第三方子企业A员工</td>
+        # </tr>
+
+        # <tr>
+        # <td>场景二</td>
+        # <td>第三方子企业A员工</td>
+        # <td>第三方子企业B(不指定经办人)</td>
+        # </tr>
+
+        # <tr>
+        # <td>场景三</td>
+        # <td>第三方子企业A员工</td>
+        # <td>第三方子企业B员工</td>
+        # </tr>
+
+        # <tr>
+        # <td>场景四</td>
+        # <td>第三方子企业A员工</td>
+        # <td>个人/自然人</td>
+        # </tr>
+
+        # <tr>
+        # <td>场景五</td>
+        # <td>第三方子企业A员工</td>
+        # <td>SaaS平台企业员工</td>
+        # </tr>
+        # </tbody>
+        # </table>
+
+        # **注**:
+        # `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+        # `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
+
         # @param request: Request instance for CreateFlowsByTemplates.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::CreateFlowsByTemplatesRequest`
         # @rtype: :class:`Tencentcloud::essbasic::V20210526::CreateFlowsByTemplatesResponse`
@@ -1313,7 +1459,14 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查询企业扩展服务授权信息，企业经办人需要是企业超管或者法人
+        # 查询企业扩展服务的开通和授权情况，当前支持查询以下内容：
+        # 1. 企业自动签
+        # 2. 企业与港澳台居民签署合同
+        # 3. 使用手机号验证签署方身份
+        # 4. 骑缝章
+        # 5. 拓宽签署方年龄限制
+
+        # 注: 此接口 参数Agent. ProxyOperator.OpenId 需要传递超管或者法人的OpenId
 
         # @param request: Request instance for DescribeExtendedServiceAuthInfo.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::DescribeExtendedServiceAuthInfoRequest`

data/lib/v20210526/models.rb

@@ -87,10 +87,12 @@ module TencentCloud
       class ApproverItem < TencentCloud::Common::AbstractModel
         # @param SignId: 签署方唯一编号
 
-        # 在动态签署人场景下，可以用此编号确定参与方
+        # 在<a href="https://qian.tencent.com/developers/company/dynamic_signer" target="_blank">动态补充签署人</a>场景下，可以用此编号确定参与方
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type SignId: String
         # @param RecipientId: 签署方角色编号
+
+        # 在<a href="https://qian.tencent.com/developers/company/dynamic_signer" target="_blank">动态补充签署人</a>场景下，可以用此编号确定参与方
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type RecipientId: String
         # @param ApproverRoleName: 签署方角色名称
@@ -986,8 +988,7 @@ module TencentCloud
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
         # @param FillApproverType: 签署人信息补充方式
 
-        # <ul><li>**0**: 补充或签人，支持补充多个企业经办签署人（默认）注: `不可补充个人签署人`</li>
-        # <li>**1**: 补充动态签署人，可补充企业和个人签署人。注: `每个签署方节点签署人是唯一的，一个节点只支持传入一个签署人信息`</li></ul>
+        # <ul><li>**1**: 补充动态签署人，可补充企业和个人签署人。注: `每个签署方节点签署人是唯一的，一个节点只支持传入一个签署人信息`</li></ul>
         # @type FillApproverType: Integer
 
         attr_accessor :Agent, :FlowId, :Approvers, :Operator, :FillApproverType
@@ -1095,9 +1096,7 @@ module TencentCloud
         # @param Unordered: 合同流程的签署顺序类型：
         # <ul><li> **false**：(默认)有序签署, 本合同多个参与人需要依次签署 </li>
         # <li> **true**：无序签署, 本合同多个参与人没有先后签署限制</li></ul>
-
-        # 注
-        # `有序签署时以传入FlowApprovers数组的顺序作为签署顺序`
+        # **注**: `有序签署时以传入FlowApprovers数组的顺序作为签署顺序`
         # @type Unordered: Boolean
         # @param FlowType: 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为255个字符，仅限中文、字母、数字和下划线组成。
         # @type FlowType: String
@@ -1136,9 +1135,7 @@ module TencentCloud
         # @param SignBeanTag: 签署方签署控件（印章/签名等）的生成方式：
         # <ul><li> **0**：在合同流程发起时，由发起人指定签署方的签署控件的位置和数量。</li>
         # <li> **1**：签署方在签署时自行添加签署控件，可以拖动位置和控制数量。</li></ul>
-
-        # 注:
-        # `发起后添加控件功能不支持添加签批控件`
+        # **注**: `发起后添加控件功能不支持添加签批控件`
         # @type SignBeanTag: Integer
         # @param CcInfos: 合同流程的抄送人列表，最多可支持50个抄送人，抄送人可查看合同内容及签署进度，但无需参与合同签署。
         # @type CcInfos: Array
@@ -1232,7 +1229,8 @@ module TencentCloud
 
       # ChannelCreateFlowByFiles返回参数结构体
       class ChannelCreateFlowByFilesResponse < TencentCloud::Common::AbstractModel
-        # @param FlowId: 合同签署流程ID
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type FlowId: String
         # @param Approvers: 签署方信息，如角色ID、角色名称等
@@ -3383,9 +3381,11 @@ module TencentCloud
 
       # ChannelVerifyPdf请求参数结构体
       class ChannelVerifyPdfRequest < TencentCloud::Common::AbstractModel
-        # @param FlowId: 流程ID
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         # @type FlowId: String
-        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填。
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -3416,18 +3416,35 @@ module TencentCloud
 
       # ChannelVerifyPdf返回参数结构体
       class ChannelVerifyPdfResponse < TencentCloud::Common::AbstractModel
-        # @param VerifyResult: 验签结果，1-文件未被篡改，全部签名在腾讯电子签完成； 2-文件未被篡改，部分签名在腾讯电子签完成；3-文件被篡改；4-异常：文件内没有签名域；5-异常：文件签名格式错误
+        # @param VerifyResult: 验签结果代码，代码的含义如下：
+
+        # <ul><li>**1**：文件未被篡改，全部签名在腾讯电子签完成。</li>
+        # <li>**2**：文件未被篡改，部分签名在腾讯电子签完成。</li>
+        # <li>**3**：文件被篡改。</li>
+        # <li>**4**：异常：文件内没有签名域。</li>
+        # <li>**5**：异常：文件签名格式错误。</li></ul>
         # @type VerifyResult: Integer
-        # @param PdfVerifyResults: 验签结果详情,内部状态1-验签成功，在电子签签署；2-验签成功，在其他平台签署；3-验签失败；4-pdf文件没有签名域；5-文件签名格式错误
+        # @param PdfVerifyResults: 验签结果详情，每个签名域对应的验签结果。状态值如下
+        # <ul><li> **1** :验签成功，在电子签签署</li>
+        # <li> **2** :验签成功，在其他平台签署</li>
+        # <li> **3** :验签失败</li>
+        # <li> **4** :pdf文件没有签名域</li>
+        # <li> **5** :文件签名格式错误</li></ul>
         # @type PdfVerifyResults: Array
+        # @param VerifySerialNo: 验签序列号, 为11为数组组成的字符串
+        # @type VerifySerialNo: String
+        # @param PdfResourceMd5: 合同文件MD5哈希值
+        # @type PdfResourceMd5: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :VerifyResult, :PdfVerifyResults, :RequestId
+        attr_accessor :VerifyResult, :PdfVerifyResults, :VerifySerialNo, :PdfResourceMd5, :RequestId
 
-        def initialize(verifyresult=nil, pdfverifyresults=nil, requestid=nil)
+        def initialize(verifyresult=nil, pdfverifyresults=nil, verifyserialno=nil, pdfresourcemd5=nil, requestid=nil)
           @VerifyResult = verifyresult
           @PdfVerifyResults = pdfverifyresults
+          @VerifySerialNo = verifyserialno
+          @PdfResourceMd5 = pdfresourcemd5
           @RequestId = requestid
         end
 
@@ -3441,6 +3458,8 @@ module TencentCloud
               @PdfVerifyResults << pdfverifyresult_tmp
             end
           end
+          @VerifySerialNo = params['VerifySerialNo']
+          @PdfResourceMd5 = params['PdfResourceMd5']
           @RequestId = params['RequestId']
         end
       end
@@ -3881,9 +3900,17 @@ module TencentCloud
 
       # CreateChannelFlowEvidenceReport请求参数结构体
       class CreateChannelFlowEvidenceReportRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填
+        # @param Agent: 员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+        # <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+        # <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+        # </ul>
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
-        # @param FlowId: 签署流程编号
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
         # @type FlowId: String
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -3914,15 +3941,14 @@ module TencentCloud
 
       # CreateChannelFlowEvidenceReport返回参数结构体
       class CreateChannelFlowEvidenceReportResponse < TencentCloud::Common::AbstractModel
-        # @param ReportId: 出证报告 ID，可用户DescribeChannelFlowEvidenceReport接口查询出证PDF的下载地址
-
+        # @param ReportId: 出证报告 ID，可用于<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>查询出证任务结果和出证PDF的下载URL
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ReportId: String
-        # @param Status: 出征任务的执行状态,状态列表如下
+        # @param Status: 出证任务执行的状态, 状态含义如下：
 
-        # - EvidenceStatusExecuting : 出征任务正在执行中
-        # - EvidenceStatusSuccess : 出征任务执行成功
-        # - EvidenceStatusFailed : 出征任务执行失败
+        # <ul><li>**EvidenceStatusExecuting**：  出证任务在执行中</li>
+        # <li>**EvidenceStatusSuccess**：  出证任务执行成功</li>
+        # <li>**EvidenceStatusFailed** ： 出征任务执行失败</li></ul>
         # @type Status: String
         # @param ReportUrl: 废除，字段无效
         # 注意：此字段可能返回 null，表示取不到有效值。
@@ -3949,10 +3975,18 @@ module TencentCloud
 
       # CreateChannelOrganizationInfoChangeUrl请求参数结构体
       class CreateChannelOrganizationInfoChangeUrlRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 关于渠道应用的相关信息，包括子客企业及应用编、号等详细内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+        # <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+        # <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+        # </ul>
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
         # @param ChangeType: 企业信息变更类型，可选类型如下：
-        # <ul><li>**1**：企业超管变更</li><li>**2**：企业基础信息变更</li></ul>
+        # <ul><li>**1**：企业超管变更, 可以将超管换成同企业的其他员工</li>
+        # <li>**2**：企业基础信息变更, 可以改企业名称 , 所在地址 , 法人名字等信息</li></ul>
         # @type ChangeType: Integer
 
         attr_accessor :Agent, :ChangeType
@@ -3973,7 +4007,7 @@ module TencentCloud
 
       # CreateChannelOrganizationInfoChangeUrl返回参数结构体
       class CreateChannelOrganizationInfoChangeUrlResponse < TencentCloud::Common::AbstractModel
-        # @param Url: 创建的企业信息变更链接。
+        # @param Url: 创建的企业信息变更链接。需要在移动端打开，会跳转到微信腾讯电子签小程序进行更换。
         # @type Url: String
         # @param ExpiredTime: 链接过期时间。链接7天有效。
         # @type ExpiredTime: Integer
@@ -4174,15 +4208,29 @@ module TencentCloud
 
       # CreateFlowsByTemplates请求参数结构体
       class CreateFlowsByTemplatesRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 均必填。
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+        # <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+        # <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+        # </ul>
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
         # @param FlowInfos: 要创建的合同信息列表，最多支持一次创建20个合同
         # @type FlowInfos: Array
-        # @param NeedPreview: 是否为预览模式；默认为false，即非预览模式，此时发起合同并返回FlowIds；若为预览模式，不会发起合同，会返回PreviewUrls；
-        # 预览链接有效期300秒；
-        # 同时，如果预览的文件中指定了动态表格控件，需要进行异步合成；此时此接口返回的是合成前的文档预览链接，而合成完成后的文档预览链接会通过：回调通知的方式、或使用返回的TaskInfo中的TaskId通过ChannelGetTaskResultApi接口查询；
+        # @param NeedPreview: 是否为预览模式，取值如下：
+        # <ul><li> **false**：非预览模式（默认），会产生合同流程并返回合同流程编号FlowId。</li>
+        # <li> **true**：预览模式，不产生合同流程，不返回合同流程编号FlowId，而是返回预览链接PreviewUrl，有效期为300秒，用于查看真实发起后合同的样子。</li></ul>
+
+        # 注:
+
+        # `如果预览的文件中指定了动态表格控件，此时此接口返回的是合成前的文档预览链接，合成完成后的文档预览链接需要通过回调通知的方式或使用返回的TaskInfo中的TaskId通过ChannelGetTaskResultApi接口查询得到`
         # @type NeedPreview: Boolean
-        # @param PreviewType: 预览链接类型 默认:0-文件流, 1- H5链接 注意:此参数在NeedPreview 为true 时有效,
+        # @param PreviewType: 预览模式下产生的预览链接类型
+        # <ul><li> **0** :(默认) 文件流 ,点开后后下载预览的合同PDF文件 </li>
+        # <li> **1** :H5链接 ,点开后在浏览器中展示合同的样子</li></ul>
+        # 注: `此参数在NeedPreview 为true时有效`
         # @type PreviewType: Integer
         # @param Operator: 操作者的信息，不用传
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
@@ -4224,14 +4272,17 @@ module TencentCloud
 
       # CreateFlowsByTemplates返回参数结构体
       class CreateFlowsByTemplatesResponse < TencentCloud::Common::AbstractModel
-        # @param FlowIds: 多个合同ID
+        # @param FlowIds: 生成的合同流程ID数组，合同流程ID为32位字符串。
+        # 建议开发者妥善保存此流程ID数组，以便于顺利进行后续操作。
         # @type FlowIds: Array
         # @param CustomerData: 第三方应用平台的业务信息, 与创建合同的FlowInfos数组中的CustomerData一一对应
         # @type CustomerData: Array
         # @param ErrorMessages: 创建消息，对应多个合同ID，
         # 成功为“”,创建失败则对应失败消息
         # @type ErrorMessages: Array
-        # @param PreviewUrls: 预览模式下返回的预览文件url数组
+        # @param PreviewUrls: 合同预览链接URL数组。
+
+        # 注：如果是预览模式(即NeedPreview设置为true)时, 才会有此预览链接URL
         # @type PreviewUrls: Array
         # @param TaskInfos: 复杂文档合成任务（如，包含动态表格的预览任务）的任务信息数组；
         # 如果文档需要异步合成，此字段会返回该异步任务的任务信息，后续可以通过ChannelGetTaskResultApi接口查询任务详情；
@@ -4594,9 +4645,14 @@ module TencentCloud
 
       # DescribeExtendedServiceAuthInfo请求参数结构体
       class DescribeExtendedServiceAuthInfoRequest < TencentCloud::Common::AbstractModel
-        # @param Agent: 应用相关信息。 此接口Agent.ProxyOrganizationOpenId、Agent. ProxyOperator.OpenId、Agent.AppId 必填
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
 
-        # 注: 此接口 参数Agent. ProxyOperator.OpenId 需要传递超管或者法人的OpenId
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.ProxyOrganizationOpenId</li>
+        # <li>第三方平台子客企业标识: Agent. ProxyOperator.OpenId</li>
+        # <li>第三方平台子客企业中的员工标识: Agent.AppId</li>
+        # </ul>
         # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
 
         attr_accessor :Agent
@@ -4615,7 +4671,7 @@ module TencentCloud
 
       # DescribeExtendedServiceAuthInfo返回参数结构体
       class DescribeExtendedServiceAuthInfoResponse < TencentCloud::Common::AbstractModel
-        # @param AuthInfo: 企业扩展服务授权信息
+        # @param AuthInfo: 服务开通和授权的信息列表，根据查询类型返回所有支持的扩展服务开通和授权状况，或者返回特定扩展服务的开通和授权状况。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type AuthInfo: Array
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -5010,11 +5066,11 @@ module TencentCloud
         end
       end
 
-      # 企业扩展服务授权信息
+      # 扩展服务开通和授权的详细信息
       class ExtentServiceAuthInfo < TencentCloud::Common::AbstractModel
         # @param Type: 扩展服务类型
         # <ul>
-        #   <li>AUTO_SIGN             企业静默签（自动签署）</li>
+        #   <li>AUTO_SIGN             企业自动签（自动签署）</li>
         # <li>  OVERSEA_SIGN          企业与港澳台居民*签署合同</li>
         # <li>  MOBILE_CHECK_APPROVER 使用手机号验证签署方身份</li>
         #  <li> PAGING_SEAL           骑缝章</li>
@@ -5024,14 +5080,12 @@ module TencentCloud
         # @type Type: String
         # @param Name: 扩展服务名称
         # @type Name: String
-        # @param Status: 服务状态
-        # ENABLE 开启
-        # DISABLE 关闭
+        # @param Status: 扩展服务的开通状态： ENABLE：开通 DISABLE：未开通
         # @type Status: String
-        # @param OperatorOpenId: 最近操作人第三方应用平台的用户openid
+        # @param OperatorOpenId: 操作扩展服务的操作人第三方应用平台的用户openid
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type OperatorOpenId: String
-        # @param OperateOn: 最近操作时间戳，单位秒
+        # @param OperateOn: 扩展服务的操作时间，格式为Unix标准时间戳（秒）。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type OperateOn: Integer
 
@@ -5279,18 +5333,62 @@ module TencentCloud
 
       # 创建签署流程签署人入参。
 
-      # 其中签署方FlowApproverInfo需要传递的参数
-      # 非单C、单B、B2C合同，ApproverType、RecipientId（模板发起合同时）必传，建议都传。
-
-      # 其他身份标识，注：`如果发起的是动态签署方（即ApproverOption.FillType指定为1），可以不指定具体签署人信息`
-
-      # <ul><li>1-个人：Name、Mobile必传</li>
-      # <li>2-第三方平台子客企业指定经办人：OpenId必传，OrgName必传、OrgOpenId必传；</li>
-      # <li>3-第三方平台子客企业不指定经办人：OrgName必传、OrgOpenId必传；</li>
-      # <li>4-非第三方平台子客企业(平台企业)：Name、Mobile必传，OrgName必传，且NotChannelOrganization=True。</li></ul>
-
-      # RecipientId参数：
-      # 从DescribeTemplates接口中，可以得到模板下的签署方Recipient列表，根据模板自定义的Rolename在此结构体中确定其RecipientId。
+      # **各种场景传参说明**:
+
+      # <table>
+      # <thead>
+      # <tr>
+      # <th>场景编号</th>
+      # <th>可作为发起方类型</th>
+      # <th>可作为签署方的类型</th>
+      # <th>签署方传参说明</th>
+      # </tr>
+      # </thead>
+
+      # <tbody>
+      # <tr>
+      # <td>场景一</td>
+      # <td>第三方子企业A员工</td>
+      # <td>第三方子企业A员工</td>
+      # <td>OpenId、OrgName、OrgOpenId必传 ,ApproverType设置为ORGANIZATION</td>
+      # </tr>
+
+      # <tr>
+      # <td>场景二</td>
+      # <td>第三方子企业A员工</td>
+      # <td>第三方子企业B(不指定经办人)</td>
+      # <td>OrgName、OrgOpenId必传 ,ApproverType设置为ORGANIZATION</td>
+      # </tr>
+
+      # <tr>
+      # <td>场景三</td>
+      # <td>第三方子企业A员工</td>
+      # <td>第三方子企业B员工</td>
+      # <td>OpenId、OrgName、OrgOpenId必传, ApproverType设置为ORGANIZATION</td>
+      # </tr>
+
+      # <tr>
+      # <td>场景四</td>
+      # <td>第三方子企业A员工</td>
+      # <td>个人/自然人</td>
+      # <td>Name、Mobile必传, ApproverType设置为PERSON</td>
+      # </tr>
+
+      # <tr>
+      # <td>场景五</td>
+      # <td>第三方子企业A员工</td>
+      # <td>SaaS平台企业员工</td>
+      # <td>Name、Mobile、OrgName必传，且NotChannelOrganization=True。 ApproverType设置为ORGANIZATION</td>
+      # </tr>
+      # </tbody>
+      # </table>
+
+      # **注1**: `使用模板发起合同时，RecipientId（模板发起合同时）必传`
+
+      # RecipientId参数获取：
+      # 从<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFlowTemplates" target="_blank">DescribeFlowTemplates接口</a>接口中，可以得到模板下的签署方Recipient列表，根据模板自定义的Rolename在此结构体中确定其RecipientId。
+
+      # **注2**:  `如果发起的是动态签署方（即ApproverOption.FillType指定为1），可以不指定具体签署人信息`,  动态签署方可以参考<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">此文档</a>
       class FlowApproverInfo < TencentCloud::Common::AbstractModel
         # @param Name: 签署方经办人的姓名。
         # 经办人的姓名将用于身份认证和电子签名，请确保填写的姓名为签署方的真实姓名，而非昵称等代名。

metadata

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