voltaria_sdk 2.38.2 → 2.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6095890459b2bb1e8524e4d8d0f4334cb7b28cbe01eaf2d5f36e20463fa6201d
-  data.tar.gz: f101e5811fbbb22b70f3ea48dac111d6df5b826e2311a502656537df12523d1a
+  metadata.gz: fa3a57b1b9c8993bd0e429d8d57d0bfcc06597e3b00f338f03401739292dfa64
+  data.tar.gz: 6d9577466d3c30a5076ba06ac6108bc80ebc5f5a19f04c1cf95b5e11ac1a772f
 SHA512:
-  metadata.gz: '067309d18e77b44409573fd27608c7f7b8b7d42c7aaf6ce514539cc6a263ddb7a08a189b5fb456321b99fc241d846f7925edfda3ee2b25e407c5b44634cab247'
-  data.tar.gz: '0791433a7509d7ef6f122a3ada65bee8bd0d7ba17d0b13db1bab7c234d7e46bbdef261e214e9d2822dcbc35dfd5d1ae37de9e68570bcbd725fbf8ef1600d1ed4'
+  metadata.gz: d28a73814ee80ca6072c96d13afa1917021f875685ececade8411058128808721605144179359866683f38016638740275cebddc2a330f44eaaf88a3c52ce8ef
+  data.tar.gz: '01679e6401ea2f6cccf78f76f785ca98c5d6a69fbfa5f9bb1f753f97e941d122c1206f5fce91ab47a0170f2a6ad6ac253fac4ddd2dfd8aacfd9ce55c0fddfe2c'

data/lib/voltaria/loans/client.rb

@@ -276,6 +276,47 @@ module Voltaria
         raise error_class.new(response.body, code: code)
       end
 
+      # Calculate the indicative early settlement figure for a loan as of the given settlement date. The amount is
+      # indicative only, not a binding quote, and has no validity period — it changes as repayments are recorded and as
+      # the settlement date moves. Confirm the final amount with Voltaria before collecting from the borrower.
+      #
+      # @param request_options [Hash]
+      # @param params [Voltaria::Loans::Types::EarlySettlementPayload]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :loan_id
+      #
+      # @return [Voltaria::Types::EarlySettlementResponse]
+      def calculate_settlement(request_options: {}, **params)
+        params = Voltaria::Internal::Types::Utils.normalize_keys(params)
+        request_data = Voltaria::Loans::Types::EarlySettlementPayload.new(params).to_h
+        non_body_param_names = ["loan_id"]
+        body = request_data.except(*non_body_param_names)
+
+        request = Voltaria::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v2/loans/#{URI.encode_uri_component(params[:loan_id].to_s)}/calculate-settlement",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Voltaria::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Voltaria::Types::EarlySettlementResponse.load(response.body)
+        else
+          error_class = Voltaria::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
       # Create multiple loans in a single request. Processing happens asynchronously. Returns a task ID for tracking
       # progress.
       #

data/lib/voltaria/loans/types/early_settlement_payload.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Voltaria
+  module Loans
+    module Types
+      class EarlySettlementPayload < Internal::Types::Model
+        field :loan_id, -> { String }, optional: false, nullable: false
+        field :settlement_date, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/voltaria/types/early_settlement_response.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Voltaria
+  module Types
+    class EarlySettlementResponse < Internal::Types::Model
+      field :loan_id, -> { String }, optional: false, nullable: false
+      field :settlement_date, -> { String }, optional: false, nullable: false
+      field :settlement_amount, -> { String }, optional: false, nullable: false
+      field :settlement_irr, -> { String }, optional: false, nullable: false
+      field :original_irr, -> { String }, optional: true, nullable: false
+      field :minimum_fee, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/voltaria/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Voltaria
-  VERSION = "2.38.2"
+  VERSION = "2.40.0"
 end

data/lib/voltaria.rb

@@ -90,6 +90,7 @@ require_relative "voltaria/types/document_response"
 require_relative "voltaria/types/drawdown_checklist_response"
 require_relative "voltaria/types/drawdown_status_enum"
 require_relative "voltaria/types/drawdown_response"
+require_relative "voltaria/types/early_settlement_response"
 require_relative "voltaria/types/validation_error_loc_item"
 require_relative "voltaria/types/validation_error"
 require_relative "voltaria/types/http_validation_error"
@@ -203,6 +204,7 @@ require_relative "voltaria/loans/types/list_loans_request"
 require_relative "voltaria/loans/types/loan_create_payload"
 require_relative "voltaria/loans/types/get_loan_by_id_request"
 require_relative "voltaria/loans/types/delete_loan_request"
+require_relative "voltaria/loans/types/early_settlement_payload"
 require_relative "voltaria/loans/types/bulk_loan_create_payload"
 require_relative "voltaria/loans/types/get_bulk_loan_status_request"
 require_relative "voltaria/loans/types/loan_default_payload"

data/reference.md

@@ -4211,6 +4211,76 @@ client.loans.delete_loan(loan_id: "loan_id")
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.loans.<a href="/lib/voltaria/loans/client.rb">calculate_settlement</a>(loan_id, request) -> Voltaria::Types::EarlySettlementResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Calculate the indicative early settlement figure for a loan as of the given settlement date. The amount is indicative only, not a binding quote, and has no validity period — it changes as repayments are recorded and as the settlement date moves. Confirm the final amount with Voltaria before collecting from the borrower.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```ruby
+client.loans.calculate_settlement(loan_id: "loan_id")
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**loan_id:** `String` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**settlement_date:** `String` — Date the loan would be settled. Must be today or later. Defaults to today when omitted.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `Voltaria::Loans::RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: voltaria_sdk
 version: !ruby/object:Gem::Version
-  version: 2.38.2
+  version: 2.40.0
 platform: ruby
 authors:
 - Voltaria
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-24 00:00:00.000000000 Z
+date: 2026-09-11 00:00:00.000000000 Z
 dependencies: []
 description: The Voltaria Ruby library provides convenient access to the Voltaria
   API from Ruby.
@@ -114,6 +114,7 @@ files:
 - lib/voltaria/loans/client.rb
 - lib/voltaria/loans/types/bulk_loan_create_payload.rb
 - lib/voltaria/loans/types/delete_loan_request.rb
+- lib/voltaria/loans/types/early_settlement_payload.rb
 - lib/voltaria/loans/types/get_bulk_loan_status_request.rb
 - lib/voltaria/loans/types/get_loan_by_id_request.rb
 - lib/voltaria/loans/types/get_loan_review_request_request.rb
@@ -182,6 +183,7 @@ files:
 - lib/voltaria/types/drawdown_checklist_response.rb
 - lib/voltaria/types/drawdown_response.rb
 - lib/voltaria/types/drawdown_status_enum.rb
+- lib/voltaria/types/early_settlement_response.rb
 - lib/voltaria/types/http_validation_error.rb
 - lib/voltaria/types/installment_response.rb
 - lib/voltaria/types/installment_response_with_client_info.rb