tencentcloud-sdk-python-essbasic 3.0.1022__py2.py3-none-any.whl → 3.0.1031__py2.py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
tencentcloud/__init__.py CHANGED
@@ -14,4 +14,4 @@
14
14
  # limitations under the License.
15
15
 
16
16
 
17
- __version__ = '3.0.1022'
17
+ __version__ = '3.0.1031'
@@ -170,14 +170,15 @@ class EssbasicClient(AbstractClient):
170
170
 
171
171
 
172
172
  def ChannelCreateBatchQuickSignUrl(self, request):
173
- """该接口用于发起合同后,生成个人用户的批量签署链接, 暂时不支持企业端签署 <br/>
174
- `注意:`<br/>
175
- `1. 该接口目前仅支持签署人类型是个人签署方的批量签署场景(ApproverType=PERSON)。` <br/>
176
- `2. 该接口可生成批量签署链接的C端签署人必须仅有手写签名和时间类型的签署控件,不支持填写控件 。` <br/>
177
- `3. 请确保C端签署人在批量签署合同中为待签署状态,如需顺序签署请待前一位参与人签署完成后,再创建该C端用户的签署链接。` <br/>
178
- `4. 该签署链接有效期为30分钟,过期后将失效,如需签署可重新创建批量签署链接 。` <br/>
179
- `5. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,不支持微信小程序嵌入。`<br/>
180
- 跳转到小程序的实现,参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式),如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
173
+ """该接口用于发起合同后,生成个人用户的批量签署链接, 暂时不支持企业端签署。
174
+ **注意**:
175
+ 1. 该接口目前仅支持签署人类型是**个人签署方的批量签署场景**(ApproverType=PERSON)。
176
+ 2. 该接口可生成批量签署链接的C端签署人**必须仅有手写签名和时间类型的签署控件**,**不支持填写控件** 。
177
+ 3. 请确保C端签署人在批量签署合同中**为待签署状态**,如需顺序签署请待前一位参与人签署完成后,再创建该C端用户的签署链接。
178
+ 4. 该签署链接**有效期为30分钟**,过期后将失效,如需签署可重新创建批量签署链接 。
179
+ 5. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
180
+ 跳转到小程序的实现,参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式),如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
181
+ 6. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
181
182
 
182
183
  :param request: Request instance for ChannelCreateBatchQuickSignUrl.
183
184
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateBatchQuickSignUrlRequest`
@@ -229,7 +230,25 @@ class EssbasicClient(AbstractClient):
229
230
 
230
231
 
231
232
  def ChannelCreateBoundFlows(self, request):
232
- """此接口(ChannelCreateBoundFlows)用于子客领取合同,经办人需要有相应的角色,合同不能重复领取。
233
+ """此接口(ChannelCreateBoundFlows)用于子客企业领取未归属给员工的合同,将合同领取给当前员工,合同不能重复领取。
234
+
235
+
236
+ **未归属合同发起方式**
237
+ 指定对应企业的OrganizationOpenId和OrganizationName而不指定具体的参与人(OpenId/名字/手机号等), 则合同进入待领取状态, 示例代码如下
238
+ ```
239
+ FlowApprovers: []*essbasic.FlowApproverInfo{
240
+ {
241
+ ApproverType: common.StringPtr("ORGANIZATION"),
242
+ OrganizationOpenId: common.StringPtr("org_dianziqian"),
243
+ OrganizationName: common.StringPtr("典子谦示例企业"),
244
+ }
245
+ },
246
+ ```
247
+
248
+ 可以<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">生成子客登录链接</a>登录控制台查看带领取的合同
249
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/a34d0cc56ec871613e94dfc6252bc072.png)
250
+
251
+ 注: `支持批量领取, 如果有一个合同流程无法领取会导致接口报错, 使得所有合同都领取失败`
233
252
 
234
253
  :param request: Request instance for ChannelCreateBoundFlows.
235
254
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateBoundFlowsRequest`
@@ -345,7 +364,7 @@ class EssbasicClient(AbstractClient):
345
364
  <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号(FileIds)进行使用。整体的逻辑如下图</li>
346
365
  </ul>
347
366
 
348
- ![image](https://dyn.ess.tencent.cn/guide/capi/ChannelCreateFlowByFiles.png)
367
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
349
368
 
350
369
  **可以作为发起方和签署方的角色列表**
351
370
  <table>
@@ -584,7 +603,8 @@ class EssbasicClient(AbstractClient):
584
603
  1. 合同中当前状态为 **待签署** 的签署人是催办的对象
585
604
  2. **每个合同只能催办一次**
586
605
 
587
- **催办的效果**: 对方会受到如下的短信通知
606
+ **催办的效果**: 对方会收到如下的短信通知
607
+
588
608
  ![image](https://qcloudimg.tencent-cloud.cn/raw/3caf94b7f540fa5736270d38528d3a7b.png)
589
609
 
590
610
 
@@ -638,14 +658,15 @@ class EssbasicClient(AbstractClient):
638
658
 
639
659
 
640
660
  def ChannelCreateFlowSignUrl(self, request):
641
- """该接口用于发起合同后,生成个人用户的签署链接, 暂时不支持企业端签署。 <br/>
661
+ """该接口用于发起合同后,生成个人用户的签署链接, 暂时不支持企业端签署 <br/>
642
662
 
643
- `注意:`<br/>
644
- `1. 该接口目前仅支持签署人类型是个人签署方的场景(PERSON)。` <br/>
645
- `2. 该接口可生成签署链接的C端签署人必须仅有手写签名和时间类型的签署控件,不支持填写控件 。` <br/>
646
- `3. 该签署链接有效期为30分钟,过期后将失效,如需签署可重新创建签署链接 。` <br/>
647
- `4. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,不支持微信小程序嵌入`。<br/>
648
- 跳转到小程序的实现,参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式),如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
663
+ **注意**
664
+ 1. 该接口目前**仅支持签署人类型是个人签署方**的场景(PERSON)。
665
+ 2. 该接口可生成签署链接的C端签署人必须仅有手写签名和时间类型的签署控件,**不支持填写控件** 。
666
+ 3. 该签署**链接有效期为30分钟**,过期后将失效,如需签署可重新创建签署链接 。
667
+ 4. 该接口返回的签署链接适用于APP集成的场景,支持APP打开或浏览器直接打开,**不支持微信小程序嵌入**。
668
+ 跳转到小程序的实现,参考微信官方文档(分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式),如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>。
669
+ 5. 因h5涉及人脸身份认证能力基于慧眼人脸核身,对Android和iOS系统均有一定要求, 因此<font color='red'>App嵌入H5签署合同需要按照慧眼提供的<a href="https://cloud.tencent.com/document/product/1007/61076">慧眼人脸核身兼容性文档</a>做兼容性适配</font>。
649
670
 
650
671
  :param request: Request instance for ChannelCreateFlowSignUrl.
651
672
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowSignUrlRequest`
@@ -669,21 +690,21 @@ class EssbasicClient(AbstractClient):
669
690
 
670
691
  def ChannelCreateMultiFlowSignQRCode(self, request):
671
692
  """此接口(ChannelCreateMultiFlowSignQRCode)用于创建一码多扫流程签署二维码。
672
- 适用场景:无需填写签署人信息,可通过模板id生成签署二维码,签署人可通过扫描二维码补充签署信息进行实名签署。
673
- 常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
674
-
675
- **本接口适用于发起方没有填写控件的 B2C或者单C模板**
676
-
677
- **若是B2C模板,还要满足以下任意一个条件**
678
693
 
679
- - 模板中配置的签署顺序是无序
680
- - B端企业的签署方式是静默签署
681
- - B端企业是非首位签署
694
+ **适用场景**:
695
+ 签署人可通过扫描二维码补充签署信息进行实名签署。常用于提前不知道签署人的身份信息场景,例如:劳务工招工、大批量员工入职等场景。
682
696
 
683
- 通过一码多扫二维码发起的合同,合同涉及到的回调消息可参考文档[合同发起及签署相关回调
697
+ **注意**:
698
+ 1. 本接口适用于**发起方没有填写控件的 B2C或者单C模板**, 若是B2C模板,还要满足以下任意一个条件
699
+ - 模板中配置的签署顺序是无序
700
+ - B端企业的签署方式是静默签署
701
+ - B端企业是非首位签署
702
+ 2. 通过一码多扫二维码发起的合同,合同涉及到的回调消息可参考文档[合同发起及签署相关回调
684
703
  ]( https://qian.tencent.com/developers/partner/callback_types_contracts_sign)
704
+ 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)
685
705
 
686
- 用户通过签署二维码发起合同时,因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](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)
706
+ 二维码的样式如下图:
707
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/27317cf5aacb094fb1dc6f94179a5148.png )
687
708
 
688
709
  :param request: Request instance for ChannelCreateMultiFlowSignQRCode.
689
710
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateMultiFlowSignQRCodeRequest`
@@ -843,7 +864,7 @@ class EssbasicClient(AbstractClient):
843
864
 
844
865
  适用场景1:创建当前企业的自定义角色,并且创建时不进行权限的设置(PermissionGroups 参数不传),角色中的权限内容可通过接口 ChannelModifyRole 完成更新。
845
866
 
846
- 适用场景2:创建当前企业的自定义角色,并且创建时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考接口 ChannelDescribeRoles 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
867
+ 适用场景2:创建当前企业的自定义角色,并且创建时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考[查询角色列表接口](https://qian.tencent.com/developers/partnerApis/accounts/ChannelDescribeRoles) 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
847
868
 
848
869
  :param request: Request instance for ChannelCreateRole.
849
870
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateRoleRequest`
@@ -1039,7 +1060,7 @@ class EssbasicClient(AbstractClient):
1039
1060
 
1040
1061
 
1041
1062
  def ChannelDeleteSealPolicies(self, request):
1042
- """删除指定印章下多个授权信息
1063
+ """此接口(ChannelDeleteSealPolicies)用于删除已指定员工印章授权信息,删除员工的印章授权后,该员工使用印章进行盖章时,将需要提交印章授权申请且通过审核后才能使用该印章进行签署。
1043
1064
 
1044
1065
  :param request: Request instance for ChannelDeleteSealPolicies.
1045
1066
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelDeleteSealPoliciesRequest`
@@ -1061,6 +1082,29 @@ class EssbasicClient(AbstractClient):
1061
1082
  raise TencentCloudSDKException(type(e).__name__, str(e))
1062
1083
 
1063
1084
 
1085
+ def ChannelDescribeBillUsageDetail(self, request):
1086
+ """通过此接口(ChannelDescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。
1087
+
1088
+ :param request: Request instance for ChannelDescribeBillUsageDetail.
1089
+ :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelDescribeBillUsageDetailRequest`
1090
+ :rtype: :class:`tencentcloud.essbasic.v20210526.models.ChannelDescribeBillUsageDetailResponse`
1091
+
1092
+ """
1093
+ try:
1094
+ params = request._serialize()
1095
+ headers = request.headers
1096
+ body = self.call("ChannelDescribeBillUsageDetail", params, headers=headers)
1097
+ response = json.loads(body)
1098
+ model = models.ChannelDescribeBillUsageDetailResponse()
1099
+ model._deserialize(response["Response"])
1100
+ return model
1101
+ except Exception as e:
1102
+ if isinstance(e, TencentCloudSDKException):
1103
+ raise
1104
+ else:
1105
+ raise TencentCloudSDKException(type(e).__name__, str(e))
1106
+
1107
+
1064
1108
  def ChannelDescribeEmployees(self, request):
1065
1109
  """获取企业员工信息, 可以获取员工的名字,OpenId,UserId和简述的角色等信息,支持设置过滤条件以筛选员工查询结果。
1066
1110
 
@@ -1087,7 +1131,21 @@ class EssbasicClient(AbstractClient):
1087
1131
 
1088
1132
 
1089
1133
  def ChannelDescribeFlowComponents(self, request):
1090
- """查询流程填写控件内容,可以根据流程Id查询该流程相关联的填写控件信息和填写内容。 注意:使用此接口前,需要在【企业应用管理】-【应用集成】-【第三方应用管理】中开通【下载应用内全量合同文件及内容数据】功能。
1134
+ """用于获取合同中填写控件填写状态和填写的内容。
1135
+
1136
+ **注意**: `附件控件不会出现在结果列表中`
1137
+
1138
+
1139
+ **授权**:
1140
+ 此接口需要授权, 有两种开通权限的途径
1141
+
1142
+ **第一种**: 需第三方应用的子企业登录控制台进行授权, 授权在**企业中心**的**授权管理**区域, 界面如下图
1143
+ 授权过程需要**子企业超管**扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>
1144
+
1145
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/8b483dfebdeafac85051279406944048.png)
1146
+
1147
+ **第二种**: 第三方应用的配置接口打开全第三个应用下的所有自己起开通, 需要**渠道方企业的超管**扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
1148
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/238979ef51dd381ccbdbc755a593debc/channel_DescribeResourceUrlsByFlows_appilications2.png)
1091
1149
 
1092
1150
  :param request: Request instance for ChannelDescribeFlowComponents.
1093
1151
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelDescribeFlowComponentsRequest`
@@ -1110,8 +1168,11 @@ class EssbasicClient(AbstractClient):
1110
1168
 
1111
1169
 
1112
1170
  def ChannelDescribeOrganizationSeals(self, request):
1113
- """查询子客企业电子印章,需要操作者具有管理印章权限
1114
- 客户指定需要获取的印章数量和偏移量,数量最多100,超过100按100处理;入参InfoType控制印章是否携带授权人信息,为1则携带,为0则返回的授权人信息为空数组。接口调用成功返回印章的信息列表还有企业印章的总数,只返回启用的印章。
1171
+ """此接口(ChannelDescribeOrganizationSeals)查询子客企业电子印章。<br />
1172
+ 注:
1173
+ 1. `查询子客企业电子印章,需要操作者具有管理印章权限`
1174
+ 2. `客户指定需要获取的印章数量和偏移量,数量最多100,超过100按100处理`
1175
+ 3. `此接口只能查询启用的印章`
1115
1176
 
1116
1177
  :param request: Request instance for ChannelDescribeOrganizationSeals.
1117
1178
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelDescribeOrganizationSealsRequest`
@@ -1135,7 +1196,16 @@ class EssbasicClient(AbstractClient):
1135
1196
 
1136
1197
  def ChannelDescribeRoles(self, request):
1137
1198
  """分页查询企业角色列表,法人的角色是系统保留角色,不会返回,按照角色创建时间升序排列。
1138
- 相关系统默认角色说明可参考文档:https://cloud.tencent.com/document/product/1323/61355
1199
+
1200
+
1201
+ <font color="red">**系统默认角色**</font>说明可参考下表
1202
+
1203
+ | 角色名称| 建议授予对象 | 角色描述 |
1204
+ | --- | --- | --- |
1205
+ | **超级管理员** |电子签业务最高权限,可以授权给法务/企业法人/业务负责人等 | 所有功能和数据管理权限,只能设置一位超管。 |
1206
+ | **业务管理员**|IT 系统负责人,可以授权给CTO等 | 企业合同模块、印章模块、模板模块等全量功能及数据权限。 |
1207
+ | **经办人**|企业法务负责人等 | 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看企业所有合同数据。 |
1208
+ | **业务员**|销售员、采购员 等| 发起合同、签署合同(含填写、拒签)、撤销合同、持有印章等权限能力,可查看自己相关所有合同数据。 |
1139
1209
 
1140
1210
  :param request: Request instance for ChannelDescribeRoles.
1141
1211
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelDescribeRolesRequest`
@@ -1244,7 +1314,7 @@ class EssbasicClient(AbstractClient):
1244
1314
 
1245
1315
  适用场景1:更新当前企业的自定义角色的名称或描述等其他信息,更新时不进行权限的设置(PermissionGroups 参数不传)。
1246
1316
 
1247
- 适用场景2:更新当前企业的自定义角色的权限信息,更新时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考接口 ChannelDescribeRoles 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
1317
+ 适用场景2:更新当前企业的自定义角色的权限信息,更新时进行权限的设置(PermissionGroups 参数要传),权限树内容 PermissionGroups 可参考[查询角色列表接口](https://qian.tencent.com/developers/partnerApis/accounts/ChannelDescribeRoles) 的输出。此处注意权限树内容可能会更新,需尽量拉取最新的权限树内容,并且权限树内容 PermissionGroups 必须是一颗完整的权限树。
1248
1318
 
1249
1319
  :param request: Request instance for ChannelModifyRole.
1250
1320
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelModifyRoleRequest`
@@ -1267,7 +1337,7 @@ class EssbasicClient(AbstractClient):
1267
1337
 
1268
1338
 
1269
1339
  def ChannelUpdateSealStatus(self, request):
1270
- """本接口(ChannelUpdateSealStatus)用于第三方应用平台为子客企业更新印章状态
1340
+ """此接口(ChannelUpdateSealStatus)用于第三方应用平台为子客企业更新印章状态。
1271
1341
 
1272
1342
  :param request: Request instance for ChannelUpdateSealStatus.
1273
1343
  :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelUpdateSealStatusRequest`
@@ -1322,7 +1392,7 @@ class EssbasicClient(AbstractClient):
1322
1392
  - 出证过程需一定时间,建议在**提交出证任务后的24小时之后**,通过<a href="https://qian.tencent.com/developers/partnerApis/certificate/DescribeChannelFlowEvidenceReport" target="_blank">获取出证报告任务执行结果</a>接口进行查询执行结果和出证报告的下载URL。
1323
1393
 
1324
1394
 
1325
- ![image](https://dyn.ess.tencent.cn/guide/capi/channel_CreateChannelFlowEvidenceReport.png)
1395
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
1326
1396
 
1327
1397
  :param request: Request instance for CreateChannelFlowEvidenceReport.
1328
1398
  :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateChannelFlowEvidenceReportRequest`
@@ -1465,7 +1535,7 @@ class EssbasicClient(AbstractClient):
1465
1535
 
1466
1536
  **整体的逻辑如下**
1467
1537
 
1468
- ![image](https://dyn.ess.tencent.cn/guide/capi/CreateFlowsByTemplates.png)
1538
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/e193519d4383fa74782a9e19147ef01a/CreateFlowsByTemplates.png)
1469
1539
 
1470
1540
  **可以作为发起方和签署方的角色列表**
1471
1541
  <table>
@@ -1602,7 +1672,9 @@ class EssbasicClient(AbstractClient):
1602
1672
 
1603
1673
 
1604
1674
  def DescribeBillUsageDetail(self, request):
1605
- """通过此接口(DescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。
1675
+ """废弃接口
1676
+
1677
+ 通过此接口(DescribeBillUsageDetail)查询该第三方平台子客企业的套餐消耗详情。
1606
1678
 
1607
1679
  :param request: Request instance for DescribeBillUsageDetail.
1608
1680
  :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeBillUsageDetailRequest`
@@ -1632,7 +1704,7 @@ class EssbasicClient(AbstractClient):
1632
1704
  - 使用此功能`需搭配出证套餐` ,使用前请联系对接的客户经理沟通。
1633
1705
  - 需调用创建并返回出证报告接口<a href="https://qian.tencent.com/developers/partnerApis/certificate/CreateChannelFlowEvidenceReport" target="_blank">提交申请出证报告任务</a>获取报告编号后调用当前接口获取报告链接。
1634
1706
 
1635
- ![image](https://dyn.ess.tencent.cn/guide/capi/channel_CreateChannelFlowEvidenceReport.png)
1707
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/1b4307ed143a992940c41d61192d3a0f/channel_CreateChannelFlowEvidenceReport.png)
1636
1708
 
1637
1709
  :param request: Request instance for DescribeChannelFlowEvidenceReport.
1638
1710
  :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeChannelFlowEvidenceReportRequest`
@@ -1751,23 +1823,24 @@ class EssbasicClient(AbstractClient):
1751
1823
 
1752
1824
  **适用场景**
1753
1825
  该接口常用来配合<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>接口,作为创建合同的前置接口使用。
1754
- 通过此接口查询到模板信息后,再通过调用创建合同的接口,指定模板ID,指定模板中需要的填写控件内容等,完成合同文档的的创建。
1826
+ 通过此接口查询到模板信息后,再通过调用创建合同的接口,指定模板ID,指定模板中需要的填写控件内容等,完成合同文档的创建。
1755
1827
 
1756
- **模版的来源**
1828
+ **模板的来源**
1757
1829
  子客企业的模板有两种途径获取
1758
1830
  - 渠道方(平台方)配置完成后, 分发给同应用的各个子企业
1759
1831
  - 子客企业通过CreateConsoleLoginUrl创建的链接登录子客控制台自己创建
1760
1832
 
1761
1833
  **一个模板通常会包含以下结构信息**
1762
1834
 
1763
- - 模板模版ID, 模板名字等基本信息
1835
+ - 模板ID, 模板名字等基本信息
1764
1836
  - 发起方参与信息Promoter、签署参与方 Recipients,后者会在模板发起合同时用于指定参与方
1765
1837
  - 发起方和签署方的填写控件 Components
1766
1838
  - 签署方的签署控件 SignComponents
1767
1839
 
1768
- ![image](https://dyn.ess.tencent.cn/guide/capi/channel_DescribeTemplates.png)
1840
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/ab81fa948a0a6fea14f48cac91d0e36a/channel_DescribeTemplates.png)
1841
+
1842
+ 模板中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
1769
1843
 
1770
- 模版中各元素的层级关系, 所有的填写控件和签署控件都归属某一个角色(通过控件的ComponentRecipientId来关联)
1771
1844
  ![image](https://qcloudimg.tencent-cloud.cn/raw/45c638bd93f9c8024763add9ab47c27f.png)
1772
1845
 
1773
1846
 
@@ -1797,8 +1870,9 @@ class EssbasicClient(AbstractClient):
1797
1870
 
1798
1871
 
1799
1872
  def DescribeUsage(self, request):
1800
- """此接口(DescribeUsage)用于获取第三方平台所有合作企业流量消耗情况。
1801
- 注: 此接口每日限频50次,若要扩大限制次数,请提前与客服经理或邮件至e-contract@tencent.com进行联系。
1873
+ """此接口(DescribeUsage)用于获取此应用下子客企业的合同消耗数量。
1874
+
1875
+ 注: 此接口**每日限频50次**,若要扩大限制次数,请提前与客服经理或邮件至e-contract@tencent.com进行联系。
1802
1876
 
1803
1877
  :param request: Request instance for DescribeUsage.
1804
1878
  :type request: :class:`tencentcloud.essbasic.v20210526.models.DescribeUsageRequest`
@@ -1826,8 +1900,8 @@ class EssbasicClient(AbstractClient):
1826
1900
 
1827
1901
  注:
1828
1902
  <ul>
1829
- <li>仅支持下载 **本企业** 下合同,链接会 **登录企业控制台** </li>
1830
- <li> **链接仅可使用一次**,不可重复使用</li>
1903
+ <li>仅支持下载 <b>本企业</b> 下合同,链接会 <b>登录企业控制台</b> </li>
1904
+ <li> <b>链接仅可使用一次</b>,不可重复使用</li>
1831
1905
  </ul>
1832
1906
 
1833
1907
  :param request: Request instance for GetDownloadFlowUrl.
@@ -1900,23 +1974,24 @@ class EssbasicClient(AbstractClient):
1900
1974
 
1901
1975
 
1902
1976
  def OperateChannelTemplate(self, request):
1903
- """此接口(OperateChannelTemplate)用于针对第三方应用平台模板库中的模板对子客企业可见性的查询和设置。
1904
-
1905
- > **使用场景**
1906
- >
1907
- > 1:查询 OperateType=SELECT
1908
- > - 查询第三方应用平台模板库的可见性以及授权的子客列表。
1909
- >
1910
- > 2:修改部分子客授权 OperateType=UPDATE
1911
- > - 对子客企业进行模板库中模板可见性的进行修改操作。
1912
- >- 当模板未发布时,可以修改可见性AuthTag(part/all),当模板发布后,不可做此修改
1913
- > - 若模板已发布且可见性AuthTag是part,可以通过ProxyOrganizationOpenIds增加子客的授权范围。如果是自动领取的模板,增加授权范围后会自动下发。
1914
- >
1915
- > 3:取消部分子客授权 OperateType=DELETE
1916
- > - 对子客企业进行模板库中模板可见性的进行删除操作。
1917
- > - 主要对于手动领取的模板,去除授权后子客在模板库中看不到,就无法再领取了。但是已经领取过成为自有模板的不会同步删除。
1918
- > - 对于自动领取的模板,由于已经下发,更改授权不会影响。
1919
- > - 如果要同步删除子客自有模板库中的模板,请使用OperateType=UPDATE+Available参数处理。
1977
+ """此接口(OperateChannelTemplate)用于针对第三方应用平台模板库中的模板对子客企业发布授权的查询和设置。
1978
+ 平台模板库中的模板的位置在控制台 企业应用管理 中下面的应用模板库管理目录, 可以参照下图位置
1979
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/7f2b6c94164b3e931efc9a037e0400f7.png)
1980
+
1981
+ # 支持的操作
1982
+
1983
+ ## 1. 查询模板的子客企业授权 (OperateType=SELECT)
1984
+ - 查询模板的授权子企业列表
1985
+
1986
+ ## 2. 修改模板的子客企业授权 (OperateType=UPDATE)
1987
+ - 当模板未发布时,可以修改模板的模板授权范围是**所有第三方应用合作企业**(AuthTag设置为all)或者**指定第三方应用合作企业**(AuthTag设置为part),**当模板发布后,不可做此修改**
1988
+ - 如果模板是部分授权, 可通过ProxyOrganizationOpenIds增加子客的授权范围。
1989
+
1990
+ ## 3. 取消模板的子客企业授权 (OperateType=DELETE)
1991
+ - 对子客企业进行模板库中模板授权范围的进行删除操作。
1992
+ - 主要对于手动领取的模板,去除授权后子客在模板库中看不到,就无法再领取了。但是**已经领取过成为自有模板的不会同步删除**。
1993
+ - 对于自动领取的模板,由于已经下发,更改授权不会影响。
1994
+ - 如果要同步删除子客自有模板库中的模板,请使用OperateType=UPDATE+Available参数处理。
1920
1995
 
1921
1996
  :param request: Request instance for OperateChannelTemplate.
1922
1997
  :type request: :class:`tencentcloud.essbasic.v20210526.models.OperateChannelTemplateRequest`
@@ -2006,7 +2081,7 @@ class EssbasicClient(AbstractClient):
2006
2081
 
2007
2082
  - **员工离职的场景**: 将员工置为离职, 员工无法登录控制台和腾讯电子签小程序进行操作了, 同时给此员工分配的openid会被回收可以给其他新员工使用 (离职后员工数据会被置空, 再次加入公司会从零开始) , 若员工信息有误可通过离职后在新增来解决, 离职员工状态为**离职**
2008
2083
 
2009
- ![image](https://dyn.ess.tencent.cn/guide/capi/channel_SyncProxyOrganizationOperators.png)
2084
+ ![image](https://qcloudimg.tencent-cloud.cn/raw/7a27a6bb0e4d39c2f6aa2a0b39946181/channel_SyncProxyOrganizationOperators.png)
2010
2085
 
2011
2086
  **注**:
2012
2087
  - 新增员工可以配置白名单限制注册使用对应openid的员工必须满足SyncProxyOrganizationOperators导入的(默认生成子客登录链接生成的链接可以任意员工点击注册绑定对应的openid), 此白名单需要咨询接入经理
@@ -2042,7 +2117,7 @@ class EssbasicClient(AbstractClient):
2042
2117
 
2043
2118
  注:
2044
2119
  1. 图片类型(png/jpg/jpeg)限制大小为5M以下, PDF/word/excel等其他格式限制大小为60M以下
2045
- 2. <font color='red'>此接口调用时需要单独设置Domain请求域名 </font>, 联调开发环境为 **file.test.ess.tencent.cn**,正式环境需要设置为**file.ess.tencent.cn**,代码示例
2120
+ 2. <font color='red'>此接口调用时需要单独设置Domain请求域名 </font>, 联调开发环境为 <font color='red'>file.test.ess.tencent.cn</font>,正式环境需要设置为<font color='red'>file.ess.tencent.cn</font>,代码示例
2046
2121
  ```
2047
2122
  HttpProfile httpProfile = new HttpProfile();
2048
2123
  httpProfile.setEndpoint("file.test.ess.tencent.cn");