tencentcloud-sdk-ess 3.0.1126 → 3.0.1128

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5376498f7cb5095d64af689c89b541ed4071d61b
-  data.tar.gz: 26ef43f10c52a6c514801be8140d2da8e2bc9f94
+  metadata.gz: 74f46911859935afedd3d2f1a54b1b7879e9f6a3
+  data.tar.gz: 7dbe248d3307accfd0350c74b7b3ea9031dc3030
 SHA512:
-  metadata.gz: 95fab607ef8d46f3d2286d8c7ff935e4656ef6dce328f0de758def6b0cd8a8838babe397a711e6a7ddc4803dadfbd3542a92cb5926045339293e94c7a2cf38ac
-  data.tar.gz: d19fcb2d7f489f5adb0c96e867dc4ad9a8481f6f2a5f205aa0b17e29bcffd6961413b3407c8e0fe1f4bf7bf6c0b6c62f721a474134736ef823c0116574e048fc
+  metadata.gz: 153eaf6fc8ced759185c26f2ee8fa2278adb21dee12a44a353441ddf2078b6550a5d6a23dd1b52b5003a08e73c9d03ab03550336f66850ed6bd773971a8b7794
+  data.tar.gz: 0d8c38b92528eb9a3c6d230f706b3fb4009a5c0874f358c8853d58c1f60c24a21ac59f17394de2508c7bcf80e5b7f2ffe6d18f1fb772a9fa12967ec3cddaa51f

data/lib/VERSION

@@ -1 +1 @@
-3.0.1126
+3.0.1128

data/lib/v20201111/client.rb

@@ -481,6 +481,36 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 此接口（CreateContractReviewWebUrl）用来创建合同审查web页面链接（此web页面可以通过iframe方式嵌入到贵方系统的网页中）。
+
+        # 适用场景：根据合同内容识别出合同的风险信息。审查结果由AI生成，仅供参考。请结合相关法律法规和公司制度要求综合判断。
+
+        # 注:
+        # 1. pdf、word格式限制大小为10M以下
+        # 2. 如果文件资源为word类型生成的链接不能进行iframe嵌入，需要在单独窗口打开
+
+        # @param request: Request instance for CreateContractReviewWebUrl.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateContractReviewWebUrlRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateContractReviewWebUrlResponse`
+        def CreateContractReviewWebUrl(request)
+          body = send_request('CreateContractReviewWebUrl', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateContractReviewWebUrlResponse.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
+
         # 此接口（CreateConvertTaskApi）用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
         # 前提条件：源文件已经通过 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">文件上传接口</a>完成上传，并得到了源文件的资源Id。<br />
         # 适用场景1：已经上传了一个word文件，希望将该word文件转换成pdf文件后发起合同
@@ -2587,6 +2617,34 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 此接口（DescribeContractReviewWebUrl）用来创建合同审查web页面链接（此web页面可以通过iframe方式嵌入到贵方系统的网页中）。
+
+        # 适用场景：根据合同内容识别出合同的风险信息。审查结果由AI生成，仅供参考。请结合相关法律法规和公司制度要求综合判断。
+
+        # 注意:  `如果文件资源为word类型生成的链接不能进行iframe嵌入，需要在单独窗口打开`
+
+        # @param request: Request instance for DescribeContractReviewWebUrl.
+        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeContractReviewWebUrlRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeContractReviewWebUrlResponse`
+        def DescribeContractReviewWebUrl(request)
+          body = send_request('DescribeContractReviewWebUrl', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeContractReviewWebUrlResponse.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
+
         # 查询企业扩展服务的授权详情（列表），当前支持查询以下内容：
         # 1. 企业自动签（本企业授权、集团企业授权、合作企业授权）
         # 2. 批量签署能力

data/lib/v20201111/models.rb

@@ -1677,33 +1677,41 @@ module TencentCloud
 
         # 注:  `目前，此接口仅支持5个文件发起。每个文件限制在10M以下，文件必须是PDF格式`
         # @type ResourceIds: Array
-        # @param PolicyType: 合同审查的审查立场方。
+        # @param PolicyType: 合同审查的审查尺度。默认为`0`严格尺度
 
-        # 审查立场方如下：
+        # 审查尺度如下：
         # <ul>
         #     <li>**0** - 【严格】以保护己方利益为核心，对合同条款进行严格把控，尽可能争取对己方有利的条款，同时对对方提出的不合理条款可进行坚决修改或删除。</li>
         #     <li>**1** - 【中立】以公平合理为原则，平衡双方的权利义务，既不过分强调己方利益，也不过度让步，力求达成双方均可接受的条款。</li>
         #     <li>**2** - 【宽松】以促成交易为核心，对合同条款的修改要求较为宽松，倾向于接受对方提出的条款，以尽快达成合作。</li>
         # </ul>
         # @type PolicyType: Integer
-        # @param Role: 合同审查中的角色信息，通过明确入参角色的名称和描述，可以提高合同审查的效率和准确性。
+        # @param Role: 合同审查中的角色信息，通过明确入参角色的名称和描述，可以提高合同审查的效率和准确性。用户不做配置时大模型会根据合同内容推荐出风险识别角色的名称和描述信息。
         # @type Role: :class:`Tencentcloud::Ess.v20201111.models.RiskIdentificationRoleInfo`
         # @param ChecklistId: 用户配置的审查清单ID，基于此清单ID批量创建合同审查任务，为32位字符串。
-        # [点击查看审查清单ID在控制台上的位置](https://qcloudimg.tencent-cloud.cn/raw/2c6588549e28ca49bd8bb7f4a072b19e.png)
+        # [点击查看审查清单ID在控制台上的位置](https://qcloudimg.tencent-cloud.cn/raw/2c6588549e28ca49bd8bb7f4a072b19e.png)。如果用户不做此配置大模型会根据合同内容在当前企业下的审查清单和系统默认的清单中选择一个清单进行审查。
         # @type ChecklistId: String
         # @param Agent: 代理企业和员工的信息。
         # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param Comment: 备注信息，长度不能超过100个字符
+        # @type Comment: String
+        # @param UserData: 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为 1024长度。
+
+        # 在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的[回调通知](https://qian.tencent.com/developers/company/callback_types_v2)模块。
+        # @type UserData: String
 
-        attr_accessor :Operator, :ResourceIds, :PolicyType, :Role, :ChecklistId, :Agent
+        attr_accessor :Operator, :ResourceIds, :PolicyType, :Role, :ChecklistId, :Agent, :Comment, :UserData
 
-        def initialize(operator=nil, resourceids=nil, policytype=nil, role=nil, checklistid=nil, agent=nil)
+        def initialize(operator=nil, resourceids=nil, policytype=nil, role=nil, checklistid=nil, agent=nil, comment=nil, userdata=nil)
           @Operator = operator
           @ResourceIds = resourceids
           @PolicyType = policytype
           @Role = role
           @ChecklistId = checklistid
           @Agent = agent
+          @Comment = comment
+          @UserData = userdata
         end
 
         def deserialize(params)
@@ -1722,6 +1730,8 @@ module TencentCloud
             @Agent = Agent.new
             @Agent.deserialize(params['Agent'])
           end
+          @Comment = params['Comment']
+          @UserData = params['UserData']
         end
       end
 
@@ -2479,6 +2489,67 @@ module TencentCloud
         end
       end
 
+      # CreateContractReviewWebUrl请求参数结构体
+      class CreateContractReviewWebUrlRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param ResourceId: 需要审查的合同文件资源ID,可通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">UploadFiles</a>接口获取文件资源ID。
+
+        # 注:  `目前，每个文件限制在10M以下，文件仅支持pdf、doc、docx格式`
+        # @type ResourceId: String
+        # @param UserData: 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为 1024长度。
+
+        # 在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的[回调通知](https://qian.tencent.com/developers/company/callback_types_v2)模块。
+        # @type UserData: String
+
+        attr_accessor :Operator, :ResourceId, :UserData
+
+        def initialize(operator=nil, resourceid=nil, userdata=nil)
+          @Operator = operator
+          @ResourceId = resourceid
+          @UserData = userdata
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @ResourceId = params['ResourceId']
+          @UserData = params['UserData']
+        end
+      end
+
+      # CreateContractReviewWebUrl返回参数结构体
+      class CreateContractReviewWebUrlResponse < TencentCloud::Common::AbstractModel
+        # @param TaskId: 接口返回的合同审查任务ID，可以调用接口<a href="https://qian.tencent.com/developers/companyApis/embedPages/DescribeContractReviewWebUrl" target="_blank">获取合同审查结果web页面</a>查看审查任务的结果。
+
+        # 注意： `当ResourceId参数不为空时才会返回此值。`
+        # @type TaskId: String
+        # @param WebUrl: 合同审查嵌入式web页面链接。
+
+        # 注意：`链接有效期为5分钟，且链接仅能使用一次。如果上传的合同文件为word时不能进行iframe方式嵌入到贵方系统的网页中，需要单独页面打开此链接显示`
+        # @type WebUrl: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TaskId, :WebUrl, :RequestId
+
+        def initialize(taskid=nil, weburl=nil, requestid=nil)
+          @TaskId = taskid
+          @WebUrl = weburl
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @TaskId = params['TaskId']
+          @WebUrl = params['WebUrl']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateConvertTaskApi请求参数结构体
       class CreateConvertTaskApiRequest < TencentCloud::Common::AbstractModel
         # @param ResourceType: 需要进行转换的资源文件类型
@@ -8298,7 +8369,7 @@ module TencentCloud
 
       # DescribeContractReviewTask返回参数结构体
       class DescribeContractReviewTaskResponse < TencentCloud::Common::AbstractModel
-        # @param ChecklistId: 用于审查任务的审查清单ID。
+        # @param ChecklistId: 用于审查任务的审查清单ID。注意：如果用户没有配置清单时此值可能为空，需要等大模型根据合同内容推荐出可以使用的审查清单。
         # @type ChecklistId: String
         # @param CreatedOn: 合同审查任务创建时间。
         # @type CreatedOn: Integer
@@ -8319,7 +8390,8 @@ module TencentCloud
 
         # 注意：`审查结果由AI生成，仅供参考。请结合相关法律法规和公司制度要求综合判断。`
         # @type Risks: Array
-        # @param Role: 合同审查中的角色信息。
+        # @param Role: 合同审查中的角色信息。注意：注意：如果用户没有配置审查角色时此值可能为null，需要等大模型根据合同内容推荐出审查角色信息。
+        # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Role: :class:`Tencentcloud::Ess.v20201111.models.RiskIdentificationRoleInfo`
         # @param Status: 合同审查任务状态。
         # 状态如下：
@@ -8333,12 +8405,18 @@ module TencentCloud
         # @type Status: Integer
         # @param TaskId: 合同审查任务ID
         # @type TaskId: String
+        # @param Comment: 审查任务备注信息，长度不能超过100个字符
+        # @type Comment: String
+        # @param UserData: 调用方自定义的个性化字段(可自定义此名称)，并以base64方式编码，支持的最大数据大小为 1024长度。
+
+        # 在合同状态变更的回调信息等场景中，该字段的信息将原封不动地透传给贵方。回调的相关说明可参考开发者中心的[回调通知](https://qian.tencent.com/developers/company/callback_types_v2)模块。
+        # @type UserData: String
         # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :ChecklistId, :CreatedOn, :FinishedOn, :PolicyType, :ResourceId, :Risks, :Role, :Status, :TaskId, :RequestId
+        attr_accessor :ChecklistId, :CreatedOn, :FinishedOn, :PolicyType, :ResourceId, :Risks, :Role, :Status, :TaskId, :Comment, :UserData, :RequestId
 
-        def initialize(checklistid=nil, createdon=nil, finishedon=nil, policytype=nil, resourceid=nil, risks=nil, role=nil, status=nil, taskid=nil, requestid=nil)
+        def initialize(checklistid=nil, createdon=nil, finishedon=nil, policytype=nil, resourceid=nil, risks=nil, role=nil, status=nil, taskid=nil, comment=nil, userdata=nil, requestid=nil)
           @ChecklistId = checklistid
           @CreatedOn = createdon
           @FinishedOn = finishedon
@@ -8348,6 +8426,8 @@ module TencentCloud
           @Role = role
           @Status = status
           @TaskId = taskid
+          @Comment = comment
+          @UserData = userdata
           @RequestId = requestid
         end
 
@@ -8371,6 +8451,66 @@ module TencentCloud
           end
           @Status = params['Status']
           @TaskId = params['TaskId']
+          @Comment = params['Comment']
+          @UserData = params['UserData']
+          @RequestId = params['RequestId']
+        end
+      end
+
+      # DescribeContractReviewWebUrl请求参数结构体
+      class DescribeContractReviewWebUrlRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写userId。
+
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param TaskId: 合同审查任务ID，该参数通过调用接口<a href="https://qian.tencent.com/developers/companyApis/embedPages/CreateContractReviewWebUrl" target="_blank">创建合同审查web页面</a>获取。
+        # @type TaskId: String
+
+        attr_accessor :Operator, :TaskId
+
+        def initialize(operator=nil, taskid=nil)
+          @Operator = operator
+          @TaskId = taskid
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @TaskId = params['TaskId']
+        end
+      end
+
+      # DescribeContractReviewWebUrl返回参数结构体
+      class DescribeContractReviewWebUrlResponse < TencentCloud::Common::AbstractModel
+        # @param WebUrl: 合同审查嵌入式web页面链接。
+        # 注意：`链接有效期为5分钟，且链接仅能使用一次。如果上传的合同文件为word时不能进行iframe方式嵌入到贵方系统的网页中，需要单独页面打开此链接显示`
+        # @type WebUrl: String
+        # @param Status: 合同审查任务状态。任务状态为`5`时没有WebUrl链接。
+        # 状态如下：
+        # <ul>
+        #     <li>**1** - 合同审查任务创建成功</li>
+        #     <li>**2** - 合同审查任务排队中</li>
+        #     <li>**3** - 合同审查任务执行中</li>
+        #     <li>**4** - 合同审查任务执行成功</li>
+        #     <li>**5** - 合同审查任务执行失败</li>
+        # </ul>
+        # @type Status: Integer
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :WebUrl, :Status, :RequestId
+
+        def initialize(weburl=nil, status=nil, requestid=nil)
+          @WebUrl = weburl
+          @Status = status
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @WebUrl = params['WebUrl']
+          @Status = params['Status']
           @RequestId = params['RequestId']
         end
       end
@@ -10296,7 +10436,7 @@ module TencentCloud
         # @type SealDescription: String
         # @param ForbidEditSealDescription: 是否禁止编辑印章描述内容
         # <ul><li>（默认） false -否</li> <li> true - 禁止编辑</li></ul>
-        # @type ForbidEditSealDescription: String
+        # @type ForbidEditSealDescription: Boolean
 
         attr_accessor :ShowFlowDetailComponent, :ShowTemplateComponent, :SkipUploadFile, :ForbidEditWatermark, :SealDescription, :ForbidEditSealDescription
 
@@ -13636,12 +13776,14 @@ module TencentCloud
         # @type RiskPresentation: Array
         # @param Content: PDF风险原文内容
         # @type Content: String
+        # @param Positions: 审查出的PDF段落位置信息
+        # @type Positions: Array
         # @param RiskBasis: 审查依据
         # @type RiskBasis: String
 
-        attr_accessor :RiskId, :RiskName, :RiskDescription, :RiskLevel, :RiskAdvice, :RiskPresentation, :Content, :RiskBasis
+        attr_accessor :RiskId, :RiskName, :RiskDescription, :RiskLevel, :RiskAdvice, :RiskPresentation, :Content, :Positions, :RiskBasis
 
-        def initialize(riskid=nil, riskname=nil, riskdescription=nil, risklevel=nil, riskadvice=nil, riskpresentation=nil, content=nil, riskbasis=nil)
+        def initialize(riskid=nil, riskname=nil, riskdescription=nil, risklevel=nil, riskadvice=nil, riskpresentation=nil, content=nil, positions=nil, riskbasis=nil)
           @RiskId = riskid
           @RiskName = riskname
           @RiskDescription = riskdescription
@@ -13649,6 +13791,7 @@ module TencentCloud
           @RiskAdvice = riskadvice
           @RiskPresentation = riskpresentation
           @Content = content
+          @Positions = positions
           @RiskBasis = riskbasis
         end
 
@@ -13660,6 +13803,14 @@ module TencentCloud
           @RiskAdvice = params['RiskAdvice']
           @RiskPresentation = params['RiskPresentation']
           @Content = params['Content']
+          unless params['Positions'].nil?
+            @Positions = []
+            params['Positions'].each do |i|
+              positioninfo_tmp = PositionInfo.new
+              positioninfo_tmp.deserialize(i)
+              @Positions << positioninfo_tmp
+            end
+          end
           @RiskBasis = params['RiskBasis']
         end
       end
@@ -13834,6 +13985,42 @@ module TencentCloud
         end
       end
 
+      # 坐标详情
+      class PositionInfo < TencentCloud::Common::AbstractModel
+        # @param X: PDF文件页X坐标位置,以PDF单页左上角为坐标原点
+        # @type X: Float
+        # @param Y: PDF文件页Y坐标位置,以PDF单页左上角为坐标原点
+        # @type Y: Float
+        # @param Width: 距离X坐标的宽度，用于在PDF文件进行画框。
+        # @type Width: Float
+        # @param Height: 距离Y坐标的高度，用于在PDF文件进行画框。
+        # @type Height: Float
+        # @param PageIndex: PDF文件页码索引，此值加1就是对应PDF文件的页码。
+        # @type PageIndex: Integer
+        # @param Id: 系统生成的唯一ID值
+        # @type Id: String
+
+        attr_accessor :X, :Y, :Width, :Height, :PageIndex, :Id
+
+        def initialize(x=nil, y=nil, width=nil, height=nil, pageindex=nil, id=nil)
+          @X = x
+          @Y = y
+          @Width = width
+          @Height = height
+          @PageIndex = pageindex
+          @Id = id
+        end
+
+        def deserialize(params)
+          @X = params['X']
+          @Y = params['Y']
+          @Width = params['Width']
+          @Height = params['Height']
+          @PageIndex = params['PageIndex']
+          @Id = params['Id']
+        end
+      end
+
       # 预设的动态签署方的补充信息，仅匹配对应信息的签署方才能领取合同。暂时仅对个人参与方生效。
       class PresetApproverInfo < TencentCloud::Common::AbstractModel
         # @param Name: 预设参与方姓名。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.1126
+  version: 3.0.1128
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-08-19 00:00:00.000000000 Z
+date: 2025-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common