lib/v20210526/client.rb in tencentcloud-sdk-essbasic-3.0.932 vs lib/v20210526/client.rb in tencentcloud-sdk-essbasic-3.0.933
- old
+ new
@@ -458,23 +458,25 @@
raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
end
# 接口（ChannelCreateFlowGroupByFiles）用于使用 PDF 文件创建合同组签署流程。
- # 合同组是将多个合同签署流程组织在一起，多个合同同时创建，每个签署方得到一个签署链接，`一次完成合同组中多个合同的签署`。合同组的合同`不能拆分一个一个签署`，只能作为一个整体签署。
+ # - 该接口允许通过选择多个模板一次性创建多个合同，这些合同被组织在一个合同组中。
+ # - 每个签署方将收到一个签署链接，通过这个链接可以访问并签署合同组中的所有合同。
+ # - 合同组中的合同必须作为一个整体进行签署，不能将合同组拆分成单独的合同进行逐一签署。
- # 适用场景：该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+ # <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
- # **注**:
- # <ul>
- # <li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
- # <li>合同组暂不支持抄送功能</li>
- # <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号（FileIds）进行使用。</li>
- # </ul>
+ # ### 1. 适用场景
+ # 该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+
+ # ### 2. 发起方要求和签署方实名要求
+ # - **发起方要求**：作为合同发起方的第三方子企业A的员工必须进行实名认证。
+ # - **签署方要求**：签署方可以是多种身份（如第三方子企业的员工、个人、SaaS平台企业员工），其中企业和员工可以不进行实名认证。
# **可以作为发起方和签署方的角色列表**
# <table>
# <thead>
# <tr>
# <th>场景编号</th>
@@ -491,41 +493,39 @@
# </tr>
# <tr>
# <td>场景二</td>
# <td>第三方子企业A员工</td>
- # <td>第三方子企业B(不指定经办人)</td>
+ # <td>第三方子企业B员工</td>
# </tr>
# <tr>
# <td>场景三</td>
# <td>第三方子企业A员工</td>
- # <td>第三方子企业B员工</td>
+ # <td>个人/自然人</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员工企业中的企业和个人/员工可以未实名`
+ # ### 3. 签署方参数差异
+ # - 根据签署方的不同类型（第三方子企业的员工、个人、SaaS平台企业员工），传递的参数也不同。具体参数的结构和要求可以参考开发者中心提供的 `FlowApproverInfo` 结构体说明。
- # `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
+ # ### 4. 合同额度的扣减与返还
+ # - **扣减时机**：合同一旦发起，相关的合同额度就会被扣减，合同组下面的每个合同都要扣减一个合同额度。
+ # - **返还条件**：只有在合同被撤销且没有任何签署方签署过，或者只有自动签署的情况下，合同额度才会被返还。
+ # - **不返还的情况**：如果合同已过期、被拒签、签署完成或已解除，合同额度将不会被返还。
- # `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
+ # ### 5. 静默（自动）签署的限制
+ # - 在使用静默（自动）签署功能时，合同签署方不能有填写控件。<font color="red">此接口静默签(企业自动签)能力为白名单功能</font>，使用前请联系对接的客户经理沟通。
- # `4. 静默（自动）签署不支持合同签署方存在填写功能`
+ # ### 6.合同组暂不支持抄送功能
# @param request: Request instance for ChannelCreateFlowGroupByFiles.
# @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowGroupByFilesRequest`
# @rtype: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowGroupByFilesResponse`
def ChannelCreateFlowGroupByFiles(request)
@@ -547,20 +547,25 @@
raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
end
# 接口（ChannelCreateFlowGroupByTemplates）用于通过多模板创建合同组签署流程。
- # 合同组是将多个合同签署流程组织在一起，多个合同同时创建，每个签署方得到一个签署链接，`一次完成合同组中多个合同的签署`。合同组的合同`不能拆分一个一个签署`，只能作为一个整体签署。
+ # - 该接口允许通过选择多个模板一次性创建多个合同，这些合同被组织在一个合同组中。
+ # - 每个签署方将收到一个签署链接，通过这个链接可以访问并签署合同组中的所有合同。
+ # - 合同组中的合同必须作为一个整体进行签署，不能将合同组拆分成单独的合同进行逐一签署。
- # 适用场景：该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+ # <img src="https://qcloudimg.tencent-cloud.cn/raw/a63074a0293c9ff5bf6c0bb74c0d3b20.png" width="400" />
- # **注**:
- # <ul>
- # <li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
- # <li>合同组暂不支持抄送功能</li>
- # </ul>
+
+ # ### 1. 适用场景
+
+ # 该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
+
+ # ### 2. 发起方要求和签署方实名要求
+ # - **发起方要求**：作为合同发起方的第三方子企业A的员工必须进行实名认证。
+ # - **签署方要求**：签署方可以是多种身份（如第三方子企业的员工、个人、SaaS平台企业员工），其中企业和员工可以不进行实名认证。
# **可以作为发起方和签署方的角色列表**
# <table>
# <thead>
# <tr>
# <th>场景编号</th>
@@ -573,45 +578,42 @@
# <tr>
# <td>场景一</td>
# <td>第三方子企业A员工</td>
# <td>第三方子企业A员工</td>
# </tr>
-
# <tr>
# <td>场景二</td>
# <td>第三方子企业A员工</td>
- # <td>第三方子企业B(不指定经办人)</td>
+ # <td>第三方子企业B员工</td>
# </tr>
# <tr>
# <td>场景三</td>
# <td>第三方子企业A员工</td>
- # <td>第三方子企业B员工</td>
+ # <td>个人/自然人</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员工企业中的企业和个人/员工可以未实名`
+ # ### 3. 签署方参数差异
+ # - 根据签署方的不同类型（第三方子企业的员工、个人、SaaS平台企业员工），传递的参数也不同。具体参数的结构和要求可以参考开发者中心提供的 `FlowApproverInfo` 结构体说明。
- # `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
+ # ### 4. 合同额度的扣减与返还
+ # - **扣减时机**：合同一旦发起，相关的合同额度就会被扣减，合同组下面的每个合同都要扣减一个合同额度。
+ # - **返还条件**：只有在合同被撤销且没有任何签署方签署过，或者只有自动签署的情况下，合同额度才会被返还。
+ # - **不返还的情况**：如果合同已过期、被拒签、签署完成或已解除，合同额度将不会被返还。
- # `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度），合同组中每个合同会扣减一个合同额度`
+ # ### 5. 静默（自动）签署的限制
+ # - 在使用静默（自动）签署功能时，合同签署方不能有填写控件。<font color="red">此接口静默签(企业自动签)能力为白名单功能</font>，使用前请联系对接的客户经理沟通。
- # `4. 静默（自动）签署不支持合同签署方存在填写功能`
+ # ### 6.合同组暂不支持抄送功能
# @param request: Request instance for ChannelCreateFlowGroupByTemplates.
# @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowGroupByTemplatesRequest`
# @rtype: :class:`Tencentcloud::essbasic::V20210526::ChannelCreateFlowGroupByTemplatesResponse`
def ChannelCreateFlowGroupByTemplates(request)
@@ -2521,10 +2523,11 @@
# ### 1. 确保合同的PDF已经合成后，再调用本接口。
# 用户创建合同或者提交签署动作后，后台需要1~3秒的时间就进行合同PDF合成或者签名，为了确保您下载的是签署完成的完整合同文件，我们建议采取下面两种方式的一种来<font color="red"><b>确保PDF已经合成完成，然后在调用本接口</b></font>。
# **第一种**：请确保您的系统配置了[接收合同完成通知的回调](https://qian.tencent.com/developers/partner/callback_types_contracts_sign)功能。一旦所有参与方签署完毕，我们的系统将自动向您提供的回调地址发送完成通知。
+
# **第二种**：通过调用我们的[获取合同信息](https://qian.tencent.com/developers/partnerApis/flows/DescribeFlowDetailInfo)接口来主动检查合同的签署状态。请仅在确认合同状态为“全部签署完成”后，进行文件的下载操作。
# ### 2. 有两种开通下载权限的途径。
# **第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图。
@@ -2533,10 +2536,11 @@
# 
# **第二种**: 渠道方企业在**企业应用管理**的配置界面打开需要配置的应用，点击**应用扩展服务**开通此功能，需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
# 注:
# 1. `请注意如果第三方应用的子客主动关闭了渠道端下载渠道子客合同功能开关，那么渠道方开通了此功能也无法下载子客的合同文件`
+
# 
# @param request: Request instance for DescribeResourceUrlsByFlows.
# @type request: :class:`Tencentcloud::essbasic::V20210526::DescribeResourceUrlsByFlowsRequest`
# @rtype: :class:`Tencentcloud::essbasic::V20210526::DescribeResourceUrlsByFlowsResponse`
@@ -2676,10 +2680,9 @@
# - **直接开通的情形：** 若在操作过程中接口没有返回跳转链接，这表明无需进行任何跳转操作。此时，相应的企业拓展服务将会直接被开通或关闭。
# - **需要法人或者超管签署开通协议的情形：** 当需要开通以下企业拓展服务时， 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员（超管）或法人。由他们点击该链接，完成服务的开通操作。
# - **AUTO_SIGN（企业自动签）**
# - **DOWNLOAD_FLOW（授权渠道下载合同）**
- # - **OVERSEA_SIGN（企业与港澳台居民签署合同）**
# 注意： `在调用此接口以管理企业扩展服务时，操作者（ Agent.ProxyOperator.OpenId）必须是企业的超级管理员（超管）或法人`
# 对应的扩展服务能力可以在控制台的【扩展服务】中找到
\ No newline at end of file