fdx-apimatic-sdk 0.0.1

data/lib/fdx_v660_api/models/annuity_account_entity.rb

@@ -0,0 +1,409 @@
+# fdx_v660_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+require 'date'
+require_relative 'account_entity'
+
+module FdxV660Api
+  # An annuity account type
+  class AnnuityAccountEntity < AccountEntity
+    # The periodic (usually monthly) interest rate earned on the account
+    # @return [InterestRateEntity10]
+    attr_accessor :earned_interest
+
+    # Indicates type of payout such as immediate or deferred
+    # @return [PayoutType2]
+    attr_accessor :payout_type
+
+    # The type of annuity product, e.g. Fixed or Variable
+    # @return [PolicyProductType2]
+    attr_accessor :policy_product_type
+
+    # Amount paid out, based on mode frequency
+    # @return [Float]
+    attr_accessor :payout_amount
+
+    # Frequency of annuity payments
+    # @return [PayoutMode2]
+    attr_accessor :payout_mode
+
+    # Date the payout starts
+    # @return [Date]
+    attr_accessor :payout_start_date
+
+    # Date the payout ends
+    # @return [Date]
+    attr_accessor :payout_end_date
+
+    # Total number of payouts
+    # @return [Integer]
+    attr_accessor :number_modal_payouts
+
+    # Cash surrender value (net) available if contract is surrendered
+    # @return [Float]
+    attr_accessor :surrender_value
+
+    # Percentage of the accumulated value to be paid to the payee each year;
+    # used exclusive of payoutChangeAmount
+    # @return [Float]
+    attr_accessor :payout_change_percentage
+
+    # Incremental modal amount (positive or negative) by which the payout amount
+    # will be changed; used exclusive of payoutPercentage
+    # @return [Float]
+    attr_accessor :payout_change_amount
+
+    # The number of modal periods comprising the duration of the certain period
+    # of an annuity payout
+    # @return [PeriodCertainType2]
+    attr_accessor :period_certain_type
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['earned_interest'] = 'earnedInterest'
+      @_hash['payout_type'] = 'payoutType'
+      @_hash['policy_product_type'] = 'policyProductType'
+      @_hash['payout_amount'] = 'payoutAmount'
+      @_hash['payout_mode'] = 'payoutMode'
+      @_hash['payout_start_date'] = 'payoutStartDate'
+      @_hash['payout_end_date'] = 'payoutEndDate'
+      @_hash['number_modal_payouts'] = 'numberModalPayouts'
+      @_hash['surrender_value'] = 'surrenderValue'
+      @_hash['payout_change_percentage'] = 'payoutChangePercentage'
+      @_hash['payout_change_amount'] = 'payoutChangeAmount'
+      @_hash['period_certain_type'] = 'periodCertainType'
+      @_hash = super().merge(@_hash)
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      _arr = %w[
+        earned_interest
+        payout_type
+        policy_product_type
+        payout_amount
+        payout_mode
+        payout_start_date
+        payout_end_date
+        number_modal_payouts
+        surrender_value
+        payout_change_percentage
+        payout_change_amount
+        period_certain_type
+      ]
+      (_arr << super()).flatten!
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      _arr = []
+      (_arr << super()).flatten!
+    end
+
+    def initialize(earned_interest: SKIP, payout_type: SKIP,
+                   policy_product_type: SKIP, payout_amount: SKIP,
+                   payout_mode: SKIP, payout_start_date: SKIP,
+                   payout_end_date: SKIP, number_modal_payouts: SKIP,
+                   surrender_value: SKIP, payout_change_percentage: SKIP,
+                   payout_change_amount: SKIP, period_certain_type: SKIP,
+                   line_of_business: SKIP, line_of_business_type: SKIP,
+                   routing_transit_number: SKIP, balance_type: SKIP,
+                   contact: SKIP, interest_rate: SKIP, interest_rate_type: SKIP,
+                   interest_rate_as_of: SKIP, prior_interest_rate: SKIP,
+                   interest_rate_index: SKIP, early_penalty_flag: SKIP,
+                   transfer_in: SKIP, transfer_out: SKIP, bill_pay_status: SKIP,
+                   micr_number: SKIP, last_activity_date: SKIP,
+                   reward_program_id: SKIP, reward_balances: SKIP,
+                   transactions_included: SKIP, bank_institution_id: SKIP,
+                   bank_transit_id: SKIP,
+                   account_category: 'Annuity Account entity', account_id: SKIP,
+                   parent_account_id: SKIP, error: SKIP, account_type: SKIP,
+                   domicile: SKIP, account_number: SKIP,
+                   account_number_display: SKIP, product_id: SKIP,
+                   product_name: SKIP, nickname: SKIP, status: SKIP,
+                   description: SKIP, account_open_date: SKIP,
+                   account_close_date: SKIP, currency: SKIP,
+                   data_clusters: SKIP, transfer_out_use_cases: SKIP,
+                   fi_attributes: SKIP, links: SKIP, additional_properties: nil)
+      @earned_interest = earned_interest unless earned_interest == SKIP
+      @payout_type = payout_type unless payout_type == SKIP
+      @policy_product_type = policy_product_type unless policy_product_type == SKIP
+      @payout_amount = payout_amount unless payout_amount == SKIP
+      @payout_mode = payout_mode unless payout_mode == SKIP
+      @payout_start_date = payout_start_date unless payout_start_date == SKIP
+      @payout_end_date = payout_end_date unless payout_end_date == SKIP
+      @number_modal_payouts = number_modal_payouts unless number_modal_payouts == SKIP
+      @surrender_value = surrender_value unless surrender_value == SKIP
+      @payout_change_percentage = payout_change_percentage unless payout_change_percentage == SKIP
+      @payout_change_amount = payout_change_amount unless payout_change_amount == SKIP
+      @period_certain_type = period_certain_type unless period_certain_type == SKIP
+      @additional_properties = additional_properties
+
+      # Call the constructor of the base class
+      super(line_of_business: line_of_business,
+            line_of_business_type: line_of_business_type,
+            routing_transit_number: routing_transit_number,
+            balance_type: balance_type,
+            contact: contact,
+            interest_rate: interest_rate,
+            interest_rate_type: interest_rate_type,
+            interest_rate_as_of: interest_rate_as_of,
+            prior_interest_rate: prior_interest_rate,
+            interest_rate_index: interest_rate_index,
+            early_penalty_flag: early_penalty_flag,
+            transfer_in: transfer_in,
+            transfer_out: transfer_out,
+            bill_pay_status: bill_pay_status,
+            micr_number: micr_number,
+            last_activity_date: last_activity_date,
+            reward_program_id: reward_program_id,
+            reward_balances: reward_balances,
+            transactions_included: transactions_included,
+            bank_institution_id: bank_institution_id,
+            bank_transit_id: bank_transit_id,
+            account_category: account_category,
+            account_id: account_id,
+            parent_account_id: parent_account_id,
+            error: error,
+            account_type: account_type,
+            domicile: domicile,
+            account_number: account_number,
+            account_number_display: account_number_display,
+            product_id: product_id,
+            product_name: product_name,
+            nickname: nickname,
+            status: status,
+            description: description,
+            account_open_date: account_open_date,
+            account_close_date: account_close_date,
+            currency: currency,
+            data_clusters: data_clusters,
+            transfer_out_use_cases: transfer_out_use_cases,
+            fi_attributes: fi_attributes,
+            links: links,
+            additional_properties: additional_properties)
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      earned_interest = InterestRateEntity10.from_hash(hash['earnedInterest']) if
+        hash['earnedInterest']
+      payout_type = hash.key?('payoutType') ? hash['payoutType'] : SKIP
+      policy_product_type =
+        hash.key?('policyProductType') ? hash['policyProductType'] : SKIP
+      payout_amount = hash.key?('payoutAmount') ? hash['payoutAmount'] : SKIP
+      payout_mode = hash.key?('payoutMode') ? hash['payoutMode'] : SKIP
+      payout_start_date =
+        hash.key?('payoutStartDate') ? hash['payoutStartDate'] : SKIP
+      payout_end_date =
+        hash.key?('payoutEndDate') ? hash['payoutEndDate'] : SKIP
+      number_modal_payouts =
+        hash.key?('numberModalPayouts') ? hash['numberModalPayouts'] : SKIP
+      surrender_value =
+        hash.key?('surrenderValue') ? hash['surrenderValue'] : SKIP
+      payout_change_percentage =
+        hash.key?('payoutChangePercentage') ? hash['payoutChangePercentage'] : SKIP
+      payout_change_amount =
+        hash.key?('payoutChangeAmount') ? hash['payoutChangeAmount'] : SKIP
+      period_certain_type =
+        hash.key?('periodCertainType') ? hash['periodCertainType'] : SKIP
+      line_of_business =
+        hash.key?('lineOfBusiness') ? hash['lineOfBusiness'] : SKIP
+      line_of_business_type =
+        hash.key?('lineOfBusinessType') ? hash['lineOfBusinessType'] : SKIP
+      routing_transit_number =
+        hash.key?('routingTransitNumber') ? hash['routingTransitNumber'] : SKIP
+      balance_type = hash.key?('balanceType') ? hash['balanceType'] : SKIP
+      contact = AccountContactEntity.from_hash(hash['contact']) if hash['contact']
+      interest_rate = hash.key?('interestRate') ? hash['interestRate'] : SKIP
+      interest_rate_type =
+        hash.key?('interestRateType') ? hash['interestRateType'] : SKIP
+      interest_rate_as_of = if hash.key?('interestRateAsOf')
+                              (DateTimeHelper.from_rfc3339(hash['interestRateAsOf']) if hash['interestRateAsOf'])
+                            else
+                              SKIP
+                            end
+      prior_interest_rate =
+        hash.key?('priorInterestRate') ? hash['priorInterestRate'] : SKIP
+      interest_rate_index =
+        hash.key?('interestRateIndex') ? hash['interestRateIndex'] : SKIP
+      early_penalty_flag =
+        hash.key?('earlyPenaltyFlag') ? hash['earlyPenaltyFlag'] : SKIP
+      transfer_in = hash.key?('transferIn') ? hash['transferIn'] : SKIP
+      transfer_out = hash.key?('transferOut') ? hash['transferOut'] : SKIP
+      bill_pay_status =
+        hash.key?('billPayStatus') ? hash['billPayStatus'] : SKIP
+      micr_number = hash.key?('micrNumber') ? hash['micrNumber'] : SKIP
+      last_activity_date =
+        hash.key?('lastActivityDate') ? hash['lastActivityDate'] : SKIP
+      reward_program_id =
+        hash.key?('rewardProgramId') ? hash['rewardProgramId'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      reward_balances = nil
+      unless hash['rewardBalances'].nil?
+        reward_balances = []
+        hash['rewardBalances'].each do |structure|
+          reward_balances << (RewardBalanceEntity.from_hash(structure) if structure)
+        end
+      end
+
+      reward_balances = SKIP unless hash.key?('rewardBalances')
+      transactions_included =
+        hash.key?('transactionsIncluded') ? hash['transactionsIncluded'] : SKIP
+      bank_institution_id =
+        hash.key?('bankInstitutionId') ? hash['bankInstitutionId'] : SKIP
+      bank_transit_id =
+        hash.key?('bankTransitId') ? hash['bankTransitId'] : SKIP
+      account_category = hash['accountCategory'] ||= 'Annuity Account entity'
+      account_id = hash.key?('accountId') ? hash['accountId'] : SKIP
+      parent_account_id =
+        hash.key?('parentAccountId') ? hash['parentAccountId'] : SKIP
+      error = Error3.from_hash(hash['error']) if hash['error']
+      account_type = hash.key?('accountType') ? hash['accountType'] : SKIP
+      domicile = DomicileEntity3.from_hash(hash['domicile']) if hash['domicile']
+      account_number = hash.key?('accountNumber') ? hash['accountNumber'] : SKIP
+      account_number_display =
+        hash.key?('accountNumberDisplay') ? hash['accountNumberDisplay'] : SKIP
+      product_id = hash.key?('productId') ? hash['productId'] : SKIP
+      product_name = hash.key?('productName') ? hash['productName'] : SKIP
+      nickname = hash.key?('nickname') ? hash['nickname'] : SKIP
+      status = hash.key?('status') ? hash['status'] : SKIP
+      description = hash.key?('description') ? hash['description'] : SKIP
+      account_open_date =
+        hash.key?('accountOpenDate') ? hash['accountOpenDate'] : SKIP
+      account_close_date =
+        hash.key?('accountCloseDate') ? hash['accountCloseDate'] : SKIP
+      currency = CurrencyEntity4.from_hash(hash['currency']) if hash['currency']
+      data_clusters = hash.key?('dataClusters') ? hash['dataClusters'] : SKIP
+      transfer_out_use_cases =
+        hash.key?('transferOutUseCases') ? hash['transferOutUseCases'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      fi_attributes = nil
+      unless hash['fiAttributes'].nil?
+        fi_attributes = []
+        hash['fiAttributes'].each do |structure|
+          fi_attributes << (FiAttributeEntity.from_hash(structure) if structure)
+        end
+      end
+
+      fi_attributes = SKIP unless hash.key?('fiAttributes')
+      # Parameter is an array, so we need to iterate through it
+      links = nil
+      unless hash['links'].nil?
+        links = []
+        hash['links'].each do |structure|
+          links << (HateoasLink.from_hash(structure) if structure)
+        end
+      end
+
+      links = SKIP unless hash.key?('links')
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      AnnuityAccountEntity.new(earned_interest: earned_interest,
+                               payout_type: payout_type,
+                               policy_product_type: policy_product_type,
+                               payout_amount: payout_amount,
+                               payout_mode: payout_mode,
+                               payout_start_date: payout_start_date,
+                               payout_end_date: payout_end_date,
+                               number_modal_payouts: number_modal_payouts,
+                               surrender_value: surrender_value,
+                               payout_change_percentage: payout_change_percentage,
+                               payout_change_amount: payout_change_amount,
+                               period_certain_type: period_certain_type,
+                               line_of_business: line_of_business,
+                               line_of_business_type: line_of_business_type,
+                               routing_transit_number: routing_transit_number,
+                               balance_type: balance_type,
+                               contact: contact,
+                               interest_rate: interest_rate,
+                               interest_rate_type: interest_rate_type,
+                               interest_rate_as_of: interest_rate_as_of,
+                               prior_interest_rate: prior_interest_rate,
+                               interest_rate_index: interest_rate_index,
+                               early_penalty_flag: early_penalty_flag,
+                               transfer_in: transfer_in,
+                               transfer_out: transfer_out,
+                               bill_pay_status: bill_pay_status,
+                               micr_number: micr_number,
+                               last_activity_date: last_activity_date,
+                               reward_program_id: reward_program_id,
+                               reward_balances: reward_balances,
+                               transactions_included: transactions_included,
+                               bank_institution_id: bank_institution_id,
+                               bank_transit_id: bank_transit_id,
+                               account_category: account_category,
+                               account_id: account_id,
+                               parent_account_id: parent_account_id,
+                               error: error,
+                               account_type: account_type,
+                               domicile: domicile,
+                               account_number: account_number,
+                               account_number_display: account_number_display,
+                               product_id: product_id,
+                               product_name: product_name,
+                               nickname: nickname,
+                               status: status,
+                               description: description,
+                               account_open_date: account_open_date,
+                               account_close_date: account_close_date,
+                               currency: currency,
+                               data_clusters: data_clusters,
+                               transfer_out_use_cases: transfer_out_use_cases,
+                               fi_attributes: fi_attributes,
+                               links: links,
+                               additional_properties: additional_properties)
+    end
+
+    # Validates an instance of the object from a given value.
+    # @param [AnnuityAccountEntity | Hash] The value against the validation is performed.
+    def self.validate(value)
+      return true if value.instance_of? self
+
+      return false unless value.instance_of? Hash
+
+      true
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      super_string = super().sub(/^<[^ ]+ /, '').sub(/>$/, '')
+      "<#{class_name} #{super_string}, earned_interest: #{@earned_interest}, payout_type:"\
+      " #{@payout_type}, policy_product_type: #{@policy_product_type}, payout_amount:"\
+      " #{@payout_amount}, payout_mode: #{@payout_mode}, payout_start_date: #{@payout_start_date},"\
+      " payout_end_date: #{@payout_end_date}, number_modal_payouts: #{@number_modal_payouts},"\
+      " surrender_value: #{@surrender_value}, payout_change_percentage:"\
+      " #{@payout_change_percentage}, payout_change_amount: #{@payout_change_amount},"\
+      " period_certain_type: #{@period_certain_type}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      super_string = super().inspect.sub(/^<[^ ]+ /, '').sub(/>$/, '')
+      "<#{class_name} #{super_string}, earned_interest: #{@earned_interest.inspect}, payout_type:"\
+      " #{@payout_type.inspect}, policy_product_type: #{@policy_product_type.inspect},"\
+      " payout_amount: #{@payout_amount.inspect}, payout_mode: #{@payout_mode.inspect},"\
+      " payout_start_date: #{@payout_start_date.inspect}, payout_end_date:"\
+      " #{@payout_end_date.inspect}, number_modal_payouts: #{@number_modal_payouts.inspect},"\
+      " surrender_value: #{@surrender_value.inspect}, payout_change_percentage:"\
+      " #{@payout_change_percentage.inspect}, payout_change_amount:"\
+      " #{@payout_change_amount.inspect}, period_certain_type: #{@period_certain_type.inspect}>"
+    end
+  end
+end

data/lib/fdx_v660_api/models/annuity_details_entity.rb

@@ -0,0 +1,206 @@
+# fdx_v660_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module FdxV660Api
+  # The details of an annuity reported on either AnnuityAccount or
+  # AnnuitySecurity
+  class AnnuityDetailsEntity < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The periodic (usually monthly) interest rate earned on the account
+    # @return [InterestRateEntity10]
+    attr_accessor :earned_interest
+
+    # Indicates type of payout such as immediate or deferred
+    # @return [PayoutType2]
+    attr_accessor :payout_type
+
+    # The type of annuity product, e.g. Fixed or Variable
+    # @return [PolicyProductType2]
+    attr_accessor :policy_product_type
+
+    # Amount paid out, based on mode frequency
+    # @return [Float]
+    attr_accessor :payout_amount
+
+    # Frequency of annuity payments
+    # @return [PayoutMode2]
+    attr_accessor :payout_mode
+
+    # Date the payout starts
+    # @return [Date]
+    attr_accessor :payout_start_date
+
+    # Date the payout ends
+    # @return [Date]
+    attr_accessor :payout_end_date
+
+    # Total number of payouts
+    # @return [Integer]
+    attr_accessor :number_modal_payouts
+
+    # Cash surrender value (net) available if contract is surrendered
+    # @return [Float]
+    attr_accessor :surrender_value
+
+    # Percentage of the accumulated value to be paid to the payee each year;
+    # used exclusive of payoutChangeAmount
+    # @return [Float]
+    attr_accessor :payout_change_percentage
+
+    # Incremental modal amount (positive or negative) by which the payout amount
+    # will be changed; used exclusive of payoutPercentage
+    # @return [Float]
+    attr_accessor :payout_change_amount
+
+    # The number of modal periods comprising the duration of the certain period
+    # of an annuity payout
+    # @return [PeriodCertainType2]
+    attr_accessor :period_certain_type
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['earned_interest'] = 'earnedInterest'
+      @_hash['payout_type'] = 'payoutType'
+      @_hash['policy_product_type'] = 'policyProductType'
+      @_hash['payout_amount'] = 'payoutAmount'
+      @_hash['payout_mode'] = 'payoutMode'
+      @_hash['payout_start_date'] = 'payoutStartDate'
+      @_hash['payout_end_date'] = 'payoutEndDate'
+      @_hash['number_modal_payouts'] = 'numberModalPayouts'
+      @_hash['surrender_value'] = 'surrenderValue'
+      @_hash['payout_change_percentage'] = 'payoutChangePercentage'
+      @_hash['payout_change_amount'] = 'payoutChangeAmount'
+      @_hash['period_certain_type'] = 'periodCertainType'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        earned_interest
+        payout_type
+        policy_product_type
+        payout_amount
+        payout_mode
+        payout_start_date
+        payout_end_date
+        number_modal_payouts
+        surrender_value
+        payout_change_percentage
+        payout_change_amount
+        period_certain_type
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(earned_interest: SKIP, payout_type: SKIP,
+                   policy_product_type: SKIP, payout_amount: SKIP,
+                   payout_mode: SKIP, payout_start_date: SKIP,
+                   payout_end_date: SKIP, number_modal_payouts: SKIP,
+                   surrender_value: SKIP, payout_change_percentage: SKIP,
+                   payout_change_amount: SKIP, period_certain_type: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @earned_interest = earned_interest unless earned_interest == SKIP
+      @payout_type = payout_type unless payout_type == SKIP
+      @policy_product_type = policy_product_type unless policy_product_type == SKIP
+      @payout_amount = payout_amount unless payout_amount == SKIP
+      @payout_mode = payout_mode unless payout_mode == SKIP
+      @payout_start_date = payout_start_date unless payout_start_date == SKIP
+      @payout_end_date = payout_end_date unless payout_end_date == SKIP
+      @number_modal_payouts = number_modal_payouts unless number_modal_payouts == SKIP
+      @surrender_value = surrender_value unless surrender_value == SKIP
+      @payout_change_percentage = payout_change_percentage unless payout_change_percentage == SKIP
+      @payout_change_amount = payout_change_amount unless payout_change_amount == SKIP
+      @period_certain_type = period_certain_type unless period_certain_type == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      earned_interest = InterestRateEntity10.from_hash(hash['earnedInterest']) if
+        hash['earnedInterest']
+      payout_type = hash.key?('payoutType') ? hash['payoutType'] : SKIP
+      policy_product_type =
+        hash.key?('policyProductType') ? hash['policyProductType'] : SKIP
+      payout_amount = hash.key?('payoutAmount') ? hash['payoutAmount'] : SKIP
+      payout_mode = hash.key?('payoutMode') ? hash['payoutMode'] : SKIP
+      payout_start_date =
+        hash.key?('payoutStartDate') ? hash['payoutStartDate'] : SKIP
+      payout_end_date =
+        hash.key?('payoutEndDate') ? hash['payoutEndDate'] : SKIP
+      number_modal_payouts =
+        hash.key?('numberModalPayouts') ? hash['numberModalPayouts'] : SKIP
+      surrender_value =
+        hash.key?('surrenderValue') ? hash['surrenderValue'] : SKIP
+      payout_change_percentage =
+        hash.key?('payoutChangePercentage') ? hash['payoutChangePercentage'] : SKIP
+      payout_change_amount =
+        hash.key?('payoutChangeAmount') ? hash['payoutChangeAmount'] : SKIP
+      period_certain_type =
+        hash.key?('periodCertainType') ? hash['periodCertainType'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      AnnuityDetailsEntity.new(earned_interest: earned_interest,
+                               payout_type: payout_type,
+                               policy_product_type: policy_product_type,
+                               payout_amount: payout_amount,
+                               payout_mode: payout_mode,
+                               payout_start_date: payout_start_date,
+                               payout_end_date: payout_end_date,
+                               number_modal_payouts: number_modal_payouts,
+                               surrender_value: surrender_value,
+                               payout_change_percentage: payout_change_percentage,
+                               payout_change_amount: payout_change_amount,
+                               period_certain_type: period_certain_type,
+                               additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} earned_interest: #{@earned_interest}, payout_type: #{@payout_type},"\
+      " policy_product_type: #{@policy_product_type}, payout_amount: #{@payout_amount},"\
+      " payout_mode: #{@payout_mode}, payout_start_date: #{@payout_start_date}, payout_end_date:"\
+      " #{@payout_end_date}, number_modal_payouts: #{@number_modal_payouts}, surrender_value:"\
+      " #{@surrender_value}, payout_change_percentage: #{@payout_change_percentage},"\
+      " payout_change_amount: #{@payout_change_amount}, period_certain_type:"\
+      " #{@period_certain_type}, additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} earned_interest: #{@earned_interest.inspect}, payout_type:"\
+      " #{@payout_type.inspect}, policy_product_type: #{@policy_product_type.inspect},"\
+      " payout_amount: #{@payout_amount.inspect}, payout_mode: #{@payout_mode.inspect},"\
+      " payout_start_date: #{@payout_start_date.inspect}, payout_end_date:"\
+      " #{@payout_end_date.inspect}, number_modal_payouts: #{@number_modal_payouts.inspect},"\
+      " surrender_value: #{@surrender_value.inspect}, payout_change_percentage:"\
+      " #{@payout_change_percentage.inspect}, payout_change_amount:"\
+      " #{@payout_change_amount.inspect}, period_certain_type: #{@period_certain_type.inspect},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+  end
+end