tencentcloud-sdk-nodejs 4.0.674 → 4.0.676

package/tencentcloud/services/ess/v20201111/ess_client.js

@@ -96,10 +96,19 @@ callbackinfo包含： 回调地址和签名key
         return this.request("CreateUserAutoSignEnableUrl", req, cb);
     }
     /**
-     * 对企业员工进行印章授权
+     * 此接口（CreateIntegrationRole）用来创建企业自定义的SaaS角色或集团角色。
+
+适用场景1：创建当前企业的自定义SaaS角色或集团角色，并且创建时不进行权限的设置（PermissionGroups 参数不传），角色中的权限内容可通过控制台编辑角色或通过接口 ModifyIntegrationRole 完成更新。
+
+适用场景2：创建当前企业的自定义SaaS角色或集团角色，并且创建时进行权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。
+适用场景3：创建集团角色时可同时设置角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
+
+适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
+
+注意事项：SaaS角色和集团角色对应的权限树是不一样的。
      */
-    async CreateSealPolicy(req, cb) {
-        return this.request("CreateSealPolicy", req, cb);
+    async CreateIntegrationRole(req, cb) {
+        return this.request("CreateIntegrationRole", req, cb);
     }
     /**
      * 本接口（CreateEmbedWebUrl）用于创建嵌入web的链接 本接口支持创建：创建印章，创建模板，修改模板，预览模板，预览合同流程的web链接 进入web连接后与当前控制台操作保持一致
@@ -108,7 +117,7 @@ callbackinfo包含： 回调地址和签名key
         return this.request("CreateEmbedWebUrl", req, cb);
     }
     /**
-     * 对流程的合同文件进行验证，判断文件是否合法。
+     * 对流程的合同文件进行数字签名验证，判断文件是否被篡改。
      */
     async VerifyPdf(req, cb) {
         return this.request("VerifyPdf", req, cb);
@@ -209,6 +218,10 @@ callbackinfo包含： 回调地址和签名key
 - 模板中配置的签署顺序是无序
 - B端企业的签署方式是静默签署
 - B端企业是非首位签署
+
+ 通过一码多扫二维码发起的合同，涉及到的合同回调消息可参考文档[合同发起以及签署相关回调](https://qian.tencent.com/developers/company/callback_types_contracts_sign)
+
+用户通过签署二维码发起合同时，因企业额度不足导致失败 会触发签署二维码相关回调,具体参考文档[签署二维码相关回调](https://qian.tencent.com/developers/company/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)
      */
     async CreateMultiFlowSignQRCode(req, cb) {
         return this.request("CreateMultiFlowSignQRCode", req, cb);
@@ -266,6 +279,18 @@ callbackinfo包含： 回调地址和签名key
     async CreateChannelSubOrganizationModifyQrCode(req, cb) {
         return this.request("CreateChannelSubOrganizationModifyQrCode", req, cb);
     }
+    /**
+     * 此接口（UploadFiles）用于文件上传。<br/>
+适用场景：用于生成pdf资源编号（FileIds）来配合“用PDF创建流程”接口使用，使用场景可详见“用PDF创建流程”接口说明。<br/>
+
+其中上传的文件，图片类型(png/jpg/jpeg)大小限制为5M，其他大小限制为60M。<br/>
+调用时需要设置Domain/接口请求域名为 file.ess.tencent.cn,代码示例：<br/>
+HttpProfile httpProfile = new HttpProfile();<br/>
+httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
+     */
+    async UploadFiles(req, cb) {
+        return this.request("UploadFiles", req, cb);
+    }
     /**
      * 查询出证报告，返回报告 URL。出证报告编号通过CreateFlowEvidenceReport接口获取。
      */
@@ -338,7 +363,6 @@ callbackinfo包含： 回调地址和签名key
     }
     /**
      * 上传了word、excel、图片文件后，通过该接口发起文件转换任务，将word、excel、图片文件转换为pdf文件。
-注：如果是集团代子企业发起任务场景，可以通过对Agent参数（未列在入参列表）设置代理的相关应用信息来支持，Agent参数设置可以参考CreateFlow接口的Agent相关说明。
      */
     async CreateConvertTaskApi(req, cb) {
         return this.request("CreateConvertTaskApi", req, cb);
@@ -358,16 +382,25 @@ callbackinfo包含： 回调地址和签名key
         return this.request("CreateIntegrationUserRoles", req, cb);
     }
     /**
-     * 此接口（UploadFiles）用于文件上传。<br/>
-适用场景：用于生成pdf资源编号（FileIds）来配合“用PDF创建流程”接口使用，使用场景可详见“用PDF创建流程”接口说明。<br/>
+     * 此接口（ModifyIntegrationRole）用来更新企业自定义的SaaS角色或集团角色。
 
-其中上传的文件，图片类型(png/jpg/jpeg)大小限制为5M，其他大小限制为60M。<br/>
-调用时需要设置Domain/接口请求域名为 file.ess.tencent.cn,代码示例：<br/>
-HttpProfile httpProfile = new HttpProfile();<br/>
-httpProfile.setEndpoint("file.test.ess.tencent.cn");<br/>
+适用场景1：更新当前企业的自定义SaaS角色或集团角色，并且更新时不进行角色中权限的更新（PermissionGroups 参数不传）。
+
+适用场景2：更新当前企业的自定义SaaS角色或集团角色，并且更新时进行角色中权限的设置（PermissionGroups 参数要传），权限树内容 PermissionGroups 可参考接口 DescribeIntegrationRoles 的输出。
+适用场景3：更新集团角色管理的子企业列表，可通过设置 SubOrganizationIds 参数达到此效果。
+
+适用场景4：主企业代理子企业操作的场景，需要设置Agent参数，并且ProxyOrganizationId设置为子企业的id即可。
+
+注意事项：SaaS角色和集团角色对应的权限树是不一样的。
      */
-    async UploadFiles(req, cb) {
-        return this.request("UploadFiles", req, cb);
+    async ModifyIntegrationRole(req, cb) {
+        return this.request("ModifyIntegrationRole", req, cb);
+    }
+    /**
+     * 对企业员工进行印章授权
+     */
+    async CreateSealPolicy(req, cb) {
+        return this.request("CreateSealPolicy", req, cb);
     }
     /**
      * 通过此接口，创建企业批量签署链接，企业员工点击链接即可跳转控制台进行批量签署。