tencentcloud-sdk-ess 3.0.737 → 3.0.739

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b6c0758ff227c92b452d7ce0faae944a0c5c3078
-  data.tar.gz: 3711d8b5e994141a8ccb0c95d348204bfa947915
+  metadata.gz: e5cfc61d08897fa20a39117d833d24b9f1d434e5
+  data.tar.gz: 6be41d1fb7cda5b8812af83f8393daf7e51b91f2
 SHA512:
-  metadata.gz: 107483ab8669f2eacfa57030bf35feb5f29169cb2ac3f144e22f2c1ec1b15699f09185968fdce481c8c11c4758572b0f36c93958c72588ad24afbc1549f2cf32
-  data.tar.gz: 1013daa74952d6c42edb32be2ec731b078db41d2d719a079648638911af57c5ec29e6244b2f198f4307a66cd5eb1cea17029d6e3ef02b9a361de6952e09a01b6
+  metadata.gz: b0eb2325769157c6f08c30630408654ba9bf1825f646dc0d6add2a0c73ccf221461d9f74bc13c2dd1d5ad1138a2c1e35155258d0496e017495af5f91c749d58a
+  data.tar.gz: c8c6edf59d87ffab45b483ed7052da2ee4439b7b1d0ff264bda999954fc2b8a06256200d3dc70ae47218150539282e904a80e40c6ccb8036b2075f14fb38d6c6

data/lib/VERSION

@@ -1 +1 @@
-3.0.737
+3.0.739

data/lib/v20201111/client.rb

@@ -1436,12 +1436,25 @@ module TencentCloud
         end
 
         # 查询企业扩展服务的开通和授权情况，当前支持查询以下内容：
-        # 1. 企业自动签
-        # 2. 企业与港澳台居民签署合同
-        # 3. 使用手机号验证签署方身份
-        # 4. 骑缝章
-        # 5. 批量签署能力
-        # 6. 拓宽签署方年龄限制
+
+        # 1. **企业自动签署**
+        # 2. **批量签署授权**
+        # 3. **企业与港澳台居民签署合同**
+        # 4. **拓宽签署方年龄限制**
+        # 5. **个人签署方仅校验手机号**
+        # 6. **隐藏合同经办人姓名**
+        # 7. **正楷临摹签名失败后更换其他签名类型**
+        # 8. **短信通知签署方**
+        # 9. **个人签署方手动签字**
+        # 10. **骑缝章**
+        # 11. **签署密码开通引导**
+
+
+        # 对应能力开通页面在Web控制台-更多-企业设置-拓展服务，如下图所示:
+
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/7d79746ecca1c5fe878a2ec36ed69c23.jpg)
+
+        # 注: <font color='red'>所在企业的超管、法人才有权限调用此接口</font>(Operator.UserId需要传递超管或者法人的UserId)
 
         # @param request: Request instance for DescribeExtendedServiceAuthInfos.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeExtendedServiceAuthInfosRequest`
@@ -1929,6 +1942,49 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 管理企业扩展服务 ，企业经办人需要是企业超管或者法人。
+
+        # 跳转小程序的几种方式：主要是设置不同的EndPoint
+        # 1. 通过链接Url直接跳转到小程序，不需要返回
+        # 设置EndPoint为WEIXINAPP，得到链接打开即可。
+
+        # 2. 客户App直接跳转到小程序-->腾讯电子签小程序操作完成-->返回App
+        # 跳转到小程序的实现，参考官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html">打开 App</a>
+        # 设置EndPoint为APP，得到path。
+
+        # 3. 客户小程序直接跳到电子签小程序-->腾讯电子签小程序操作完成--->回到客户小程序
+        # 跳转到小程序的实现，参考官方文档（分为<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>
+        # 设置EndPoint为APP，得到path。
+
+        # 4.其中小程序的原始Id如下，或者查看小程序信息自助获取。
+
+        # | 小程序 | AppID | 原始ID |
+        # | ------------ | ------------ | ------------ |
+        # | 腾讯电子签（正式版） | wxa023b292fd19d41d | gh_da88f6188665 |
+        # | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
+
+        # @param request: Request instance for ModifyExtendedService.
+        # @type request: :class:`Tencentcloud::ess::V20201111::ModifyExtendedServiceRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::ModifyExtendedServiceResponse`
+        def ModifyExtendedService(request)
+          body = send_request('ModifyExtendedService', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ModifyExtendedServiceResponse.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
+
         # 此接口（ModifyIntegrationDepartment）用于更新企业的部门信息，支持更新部门名称、客户系统部门ID和部门序号等信息。
 
         # @param request: Request instance for ModifyIntegrationDepartment.

data/lib/v20201111/models.rb

@@ -5133,12 +5133,17 @@ module TencentCloud
         # @param ExtendServiceType: 要查询的扩展服务类型。
         # 默认为空，即查询当前支持的所有扩展服务信息。
         # 若需查询单个扩展服务的开通情况，请传递相应的值，如下所示：
-        # <ul><li>OPEN_SERVER_SIGN：企业静默签署</li>
+        # <ul><li>OPEN_SERVER_SIGN：企业自动签署</li>
+        # <li>BATCH_SIGN：批量签署</li>
         # <li>OVERSEA_SIGN：企业与港澳台居民签署合同</li>
-        # <li>MOBILE_CHECK_APPROVER：使用手机号验证签署方身份</li>
+        # <li>AGE_LIMIT_EXPANSION：拓宽签署方年龄限制</li>
+        # <li>MOBILE_CHECK_APPROVER：个人签署方仅校验手机号</li>
+        # <li>HIDE_OPERATOR_DISPLAY：隐藏合同经办人姓名</li>
+        # <li>ORGANIZATION_OCR_FALLBACK：正楷临摹签名失败后更换其他签名类型</li>
+        # <li>ORGANIZATION_FLOW_NOTIFY_TYPE：短信通知签署方</li>
+        # <li>HIDE_ONE_KEY_SIGN：个人签署方手动签字</li>
         # <li>PAGING_SEAL：骑缝章</li>
-        # <li>BATCH_SIGN：批量签署</li>
-        # <li>AGE_LIMIT_EXPANSION：拓宽签署方年龄限制</li></ul>
+        # <li>ORGANIZATION_FLOW_PASSWD_NOTIFY：签署密码开通引导</li></ul>
         # @type ExtendServiceType: String
         # @param Agent: 代理企业和员工的信息。
         # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
@@ -6452,17 +6457,25 @@ module TencentCloud
       # 扩展服务开通和授权的详细信息
       class ExtendAuthInfo < TencentCloud::Common::AbstractModel
         # @param Type: 扩展服务的类型，可能是以下值：
-        # <ul><li>OPEN_SERVER_SIGN：企业静默签署</li>
+        # <ul><li>OPEN_SERVER_SIGN：企业自动签署</li>
+        # <li>BATCH_SIGN：批量签署</li>
         # <li>OVERSEA_SIGN：企业与港澳台居民签署合同</li>
-        # <li>MOBILE_CHECK_APPROVER：使用手机号验证签署方身份</li>
+        # <li>AGE_LIMIT_EXPANSION：拓宽签署方年龄限制</li>
+        # <li>MOBILE_CHECK_APPROVER：个人签署方仅校验手机号</li>
+        # <li>HIDE_OPERATOR_DISPLAY：隐藏合同经办人姓名</li>
+        # <li>ORGANIZATION_OCR_FALLBACK：正楷临摹签名失败后更换其他签名类型</li>
+        # <li>ORGANIZATION_FLOW_NOTIFY_TYPE：短信通知签署方</li>
+        # <li>HIDE_ONE_KEY_SIGN：个人签署方手动签字</li>
         # <li>PAGING_SEAL：骑缝章</li>
-        # <li>BATCH_SIGN：批量签署</li></ul>
+        # <li>ORGANIZATION_FLOW_PASSWD_NOTIFY：签署密码开通引导</li></ul>
         # @type Type: String
         # @param Name: 扩展服务的名称
         # @type Name: String
         # @param Status: 扩展服务的开通状态：
-        # ENABLE：开通
-        # DISABLE：未开通
+        # <ul>
+        # <li>ENABLE : 已开通</li>
+        # <li>DISABLE : 未开通</li>
+        # </ul>
         # @type Status: String
         # @param OperatorUserId: 操作扩展服务的操作人UserId，员工在腾讯电子签平台的唯一身份标识，为32位字符串。
         # 注意：此字段可能返回 null，表示取不到有效值。
@@ -8103,6 +8116,88 @@ module TencentCloud
         end
       end
 
+      # ModifyExtendedService请求参数结构体
+      class ModifyExtendedServiceRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param ServiceType: 要管理的拓展服务类型。
+        # <ul><li>OPEN_SERVER_SIGN：企业自动签署</li>
+        # <li>OVERSEA_SIGN：企业与港澳台居民签署合同</li>
+        # <li>AGE_LIMIT_EXPANSION：拓宽签署方年龄限制</li>
+        # <li>MOBILE_CHECK_APPROVER：个人签署方仅校验手机号</li>
+        # <li>HIDE_OPERATOR_DISPLAY：隐藏合同经办人姓名</li>
+        # <li>ORGANIZATION_OCR_FALLBACK：正楷临摹签名失败后更换其他签名类型</li>
+        # <li>ORGANIZATION_FLOW_NOTIFY_TYPE：短信通知签署方</li>
+        # <li>HIDE_ONE_KEY_SIGN：个人签署方手动签字</li>
+        # <li>PAGING_SEAL：骑缝章</li>
+        # <li>ORGANIZATION_FLOW_PASSWD_NOTIFY：签署密码开通引导</li></ul>
+        # @type ServiceType: String
+        # @param Operate: 操作类型
+        # <ul>
+        # <li>OPEN : 开通</li>
+        # <li>CLOSE : 关闭</li>
+        # </ul>
+        # @type Operate: String
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param Endpoint: 链接跳转类型，支持以下类型
+        # <ul>
+        # <li>WEIXINAPP : 短链直接跳转到电子签小程序  (默认值)</li>
+        # <li>APP : 第三方APP或小程序跳转电子签小程序</li>
+        # </ul>
+        # @type Endpoint: String
+
+        attr_accessor :Operator, :ServiceType, :Operate, :Agent, :Endpoint
+
+        def initialize(operator=nil, servicetype=nil, operate=nil, agent=nil, endpoint=nil)
+          @Operator = operator
+          @ServiceType = servicetype
+          @Operate = operate
+          @Agent = agent
+          @Endpoint = endpoint
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @ServiceType = params['ServiceType']
+          @Operate = params['Operate']
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @Endpoint = params['Endpoint']
+        end
+      end
+
+      # ModifyExtendedService返回参数结构体
+      class ModifyExtendedServiceResponse < TencentCloud::Common::AbstractModel
+        # @param OperateUrl: 操作跳转链接，有效期24小时
+        # 若操作时没有返回跳转链接，表示无需跳转操作，此时会直接开通/关闭服务。
+
+        # 当操作类型是 OPEN 且 扩展服务类型是  OPEN_SERVER_SIGN 或者 OVERSEA_SIGN 时返回操作链接，
+        # 返回的链接当前操作人（超管或法人）点击链接完成服务开通操作。
+        # @type OperateUrl: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :OperateUrl, :RequestId
+
+        def initialize(operateurl=nil, requestid=nil)
+          @OperateUrl = operateurl
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @OperateUrl = params['OperateUrl']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # ModifyIntegrationDepartment请求参数结构体
       class ModifyIntegrationDepartmentRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.737
+  version: 3.0.739
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-12-27 00:00:00.000000000 Z
+date: 2023-12-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common