fdx-api-sdk-ruby 1.0.0

data/lib/fdx_api/models/form1098_q1.rb

@@ -0,0 +1,337 @@
+# fdx_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module FdxApi
+  # Qualifying Longevity Annuity Contract Information
+  class Form1098Q1 < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Year for which taxes are being paid
+    # @return [Integer]
+    attr_accessor :tax_year
+
+    # True to indicate this is a corrected tax form
+    # @return [TrueClass | FalseClass]
+    attr_accessor :corrected
+
+    # Long-term persistent identity of the source account. Not the account
+    # number
+    # @return [String]
+    attr_accessor :account_id
+
+    # Long-term persistent id for this tax form. Depending upon the data
+    # provider, this may be the same id as the enclosing tax statement id, or
+    # this may be a different id, or this id may be omitted.
+    # @return [String]
+    attr_accessor :tax_form_id
+
+    # Date of production or delivery of the tax form
+    # @return [Date]
+    attr_accessor :tax_form_date
+
+    # Additional explanation text or content about this tax form
+    # @return [String]
+    attr_accessor :additional_information
+
+    # Enumerated name of the tax form entity e.g. "TaxW2"
+    # @return [TypeFormType1]
+    attr_accessor :tax_form_type
+
+    # Issuer's name, address, phone, and TIN. Issuer data need only be
+    # transmitted on enclosing TaxStatement, if it is the same on all its
+    # included tax forms.
+    # @return [TaxParty8]
+    attr_accessor :issuer
+
+    # Recipient's name, address, phone, and TIN. Recipient data need only be
+    # transmitted on enclosing TaxStatement, if it is the same on all its
+    # included tax forms.
+    # @return [TaxParty1]
+    attr_accessor :recipient
+
+    # Additional attributes for this tax form when defined fields are not
+    # available. Some specific additional attributes already defined by
+    # providers: Fields required by [IRS
+    # FIRE](https://www.irs.gov/e-file-providers/filing-information-returns-elec
+    # tronically-fire): Name Control, Type of Identification Number (EIN, SSN,
+    # ITIN, ATIN). (ATIN is tax ID number for pending adoptions.) Tax form
+    # provider field for taxpayer notification: Recipient Email Address.
+    # @return [Array[TaxFormAttribute]]
+    attr_accessor :attributes
+
+    # Present if an error was encountered while retrieving this form
+    # @return [Error1]
+    attr_accessor :error
+
+    # Links to retrieve this form as data or image, or to invoke other APIs
+    # @return [Array[HateoasLink]]
+    attr_accessor :links
+
+    # Account number
+    # @return [String]
+    attr_accessor :account_number
+
+    # Plan number
+    # @return [String]
+    attr_accessor :plan_number
+
+    # Plan name
+    # @return [String]
+    attr_accessor :plan_name
+
+    # Plan sponsor's EIN
+    # @return [String]
+    attr_accessor :plan_sponsor_id
+
+    # Box 1a, Annuity amount on start date
+    # @return [Float]
+    attr_accessor :annuity_amount
+
+    # Box 1b, Annuity start date
+    # @return [Date]
+    attr_accessor :start_date
+
+    # Box 2, Start date may be accelerated
+    # @return [TrueClass | FalseClass]
+    attr_accessor :can_be_accelerated
+
+    # Box 3, Total premiums
+    # @return [Float]
+    attr_accessor :total_premiums
+
+    # Box 4, Fair market value of qualifying longevity annuity contract (FMV of
+    # QLAC)
+    # @return [Float]
+    attr_accessor :fair_market_value
+
+    # Box 5, Total monthly premiums paid for the contract and date of the last
+    # payment in the month
+    # @return [Array[DateAndAmount]]
+    attr_accessor :premiums
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['tax_year'] = 'taxYear'
+      @_hash['corrected'] = 'corrected'
+      @_hash['account_id'] = 'accountId'
+      @_hash['tax_form_id'] = 'taxFormId'
+      @_hash['tax_form_date'] = 'taxFormDate'
+      @_hash['additional_information'] = 'additionalInformation'
+      @_hash['tax_form_type'] = 'taxFormType'
+      @_hash['issuer'] = 'issuer'
+      @_hash['recipient'] = 'recipient'
+      @_hash['attributes'] = 'attributes'
+      @_hash['error'] = 'error'
+      @_hash['links'] = 'links'
+      @_hash['account_number'] = 'accountNumber'
+      @_hash['plan_number'] = 'planNumber'
+      @_hash['plan_name'] = 'planName'
+      @_hash['plan_sponsor_id'] = 'planSponsorId'
+      @_hash['annuity_amount'] = 'annuityAmount'
+      @_hash['start_date'] = 'startDate'
+      @_hash['can_be_accelerated'] = 'canBeAccelerated'
+      @_hash['total_premiums'] = 'totalPremiums'
+      @_hash['fair_market_value'] = 'fairMarketValue'
+      @_hash['premiums'] = 'premiums'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        tax_year
+        corrected
+        account_id
+        tax_form_id
+        tax_form_date
+        additional_information
+        tax_form_type
+        issuer
+        recipient
+        attributes
+        error
+        links
+        account_number
+        plan_number
+        plan_name
+        plan_sponsor_id
+        annuity_amount
+        start_date
+        can_be_accelerated
+        total_premiums
+        fair_market_value
+        premiums
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(tax_year: SKIP, corrected: SKIP, account_id: SKIP,
+                   tax_form_id: SKIP, tax_form_date: SKIP,
+                   additional_information: SKIP, tax_form_type: SKIP,
+                   issuer: SKIP, recipient: SKIP, attributes: SKIP, error: SKIP,
+                   links: SKIP, account_number: SKIP, plan_number: SKIP,
+                   plan_name: SKIP, plan_sponsor_id: SKIP, annuity_amount: SKIP,
+                   start_date: SKIP, can_be_accelerated: SKIP,
+                   total_premiums: SKIP, fair_market_value: SKIP,
+                   premiums: SKIP, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @tax_year = tax_year unless tax_year == SKIP
+      @corrected = corrected unless corrected == SKIP
+      @account_id = account_id unless account_id == SKIP
+      @tax_form_id = tax_form_id unless tax_form_id == SKIP
+      @tax_form_date = tax_form_date unless tax_form_date == SKIP
+      @additional_information = additional_information unless additional_information == SKIP
+      @tax_form_type = tax_form_type unless tax_form_type == SKIP
+      @issuer = issuer unless issuer == SKIP
+      @recipient = recipient unless recipient == SKIP
+      @attributes = attributes unless attributes == SKIP
+      @error = error unless error == SKIP
+      @links = links unless links == SKIP
+      @account_number = account_number unless account_number == SKIP
+      @plan_number = plan_number unless plan_number == SKIP
+      @plan_name = plan_name unless plan_name == SKIP
+      @plan_sponsor_id = plan_sponsor_id unless plan_sponsor_id == SKIP
+      @annuity_amount = annuity_amount unless annuity_amount == SKIP
+      @start_date = start_date unless start_date == SKIP
+      @can_be_accelerated = can_be_accelerated unless can_be_accelerated == SKIP
+      @total_premiums = total_premiums unless total_premiums == SKIP
+      @fair_market_value = fair_market_value unless fair_market_value == SKIP
+      @premiums = premiums unless premiums == 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.
+      tax_year = hash.key?('taxYear') ? hash['taxYear'] : SKIP
+      corrected = hash.key?('corrected') ? hash['corrected'] : SKIP
+      account_id = hash.key?('accountId') ? hash['accountId'] : SKIP
+      tax_form_id = hash.key?('taxFormId') ? hash['taxFormId'] : SKIP
+      tax_form_date = hash.key?('taxFormDate') ? hash['taxFormDate'] : SKIP
+      additional_information =
+        hash.key?('additionalInformation') ? hash['additionalInformation'] : SKIP
+      tax_form_type = hash.key?('taxFormType') ? hash['taxFormType'] : SKIP
+      issuer = TaxParty8.from_hash(hash['issuer']) if hash['issuer']
+      recipient = TaxParty1.from_hash(hash['recipient']) if hash['recipient']
+      # Parameter is an array, so we need to iterate through it
+      attributes = nil
+      unless hash['attributes'].nil?
+        attributes = []
+        hash['attributes'].each do |structure|
+          attributes << (TaxFormAttribute.from_hash(structure) if structure)
+        end
+      end
+
+      attributes = SKIP unless hash.key?('attributes')
+      error = Error1.from_hash(hash['error']) if hash['error']
+      # 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')
+      account_number = hash.key?('accountNumber') ? hash['accountNumber'] : SKIP
+      plan_number = hash.key?('planNumber') ? hash['planNumber'] : SKIP
+      plan_name = hash.key?('planName') ? hash['planName'] : SKIP
+      plan_sponsor_id =
+        hash.key?('planSponsorId') ? hash['planSponsorId'] : SKIP
+      annuity_amount = hash.key?('annuityAmount') ? hash['annuityAmount'] : SKIP
+      start_date = hash.key?('startDate') ? hash['startDate'] : SKIP
+      can_be_accelerated =
+        hash.key?('canBeAccelerated') ? hash['canBeAccelerated'] : SKIP
+      total_premiums = hash.key?('totalPremiums') ? hash['totalPremiums'] : SKIP
+      fair_market_value =
+        hash.key?('fairMarketValue') ? hash['fairMarketValue'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      premiums = nil
+      unless hash['premiums'].nil?
+        premiums = []
+        hash['premiums'].each do |structure|
+          premiums << (DateAndAmount.from_hash(structure) if structure)
+        end
+      end
+
+      premiums = SKIP unless hash.key?('premiums')
+
+      # 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.
+      Form1098Q1.new(tax_year: tax_year,
+                     corrected: corrected,
+                     account_id: account_id,
+                     tax_form_id: tax_form_id,
+                     tax_form_date: tax_form_date,
+                     additional_information: additional_information,
+                     tax_form_type: tax_form_type,
+                     issuer: issuer,
+                     recipient: recipient,
+                     attributes: attributes,
+                     error: error,
+                     links: links,
+                     account_number: account_number,
+                     plan_number: plan_number,
+                     plan_name: plan_name,
+                     plan_sponsor_id: plan_sponsor_id,
+                     annuity_amount: annuity_amount,
+                     start_date: start_date,
+                     can_be_accelerated: can_be_accelerated,
+                     total_premiums: total_premiums,
+                     fair_market_value: fair_market_value,
+                     premiums: premiums,
+                     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} tax_year: #{@tax_year}, corrected: #{@corrected}, account_id:"\
+      " #{@account_id}, tax_form_id: #{@tax_form_id}, tax_form_date: #{@tax_form_date},"\
+      " additional_information: #{@additional_information}, tax_form_type: #{@tax_form_type},"\
+      " issuer: #{@issuer}, recipient: #{@recipient}, attributes: #{@attributes}, error:"\
+      " #{@error}, links: #{@links}, account_number: #{@account_number}, plan_number:"\
+      " #{@plan_number}, plan_name: #{@plan_name}, plan_sponsor_id: #{@plan_sponsor_id},"\
+      " annuity_amount: #{@annuity_amount}, start_date: #{@start_date}, can_be_accelerated:"\
+      " #{@can_be_accelerated}, total_premiums: #{@total_premiums}, fair_market_value:"\
+      " #{@fair_market_value}, premiums: #{@premiums}, 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} tax_year: #{@tax_year.inspect}, corrected: #{@corrected.inspect},"\
+      " account_id: #{@account_id.inspect}, tax_form_id: #{@tax_form_id.inspect}, tax_form_date:"\
+      " #{@tax_form_date.inspect}, additional_information: #{@additional_information.inspect},"\
+      " tax_form_type: #{@tax_form_type.inspect}, issuer: #{@issuer.inspect}, recipient:"\
+      " #{@recipient.inspect}, attributes: #{@attributes.inspect}, error: #{@error.inspect},"\
+      " links: #{@links.inspect}, account_number: #{@account_number.inspect}, plan_number:"\
+      " #{@plan_number.inspect}, plan_name: #{@plan_name.inspect}, plan_sponsor_id:"\
+      " #{@plan_sponsor_id.inspect}, annuity_amount: #{@annuity_amount.inspect}, start_date:"\
+      " #{@start_date.inspect}, can_be_accelerated: #{@can_be_accelerated.inspect},"\
+      " total_premiums: #{@total_premiums.inspect}, fair_market_value:"\
+      " #{@fair_market_value.inspect}, premiums: #{@premiums.inspect}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+  end
+end

data/lib/fdx_api/models/form1098_t.rb

@@ -0,0 +1,338 @@
+# fdx_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module FdxApi
+  # Tuition Statement, from FILER (1st-2nd boxes as issuer) to STUDENT (3rd-6th
+  # boxes as recipient)
+  class Form1098T < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Year for which taxes are being paid
+    # @return [Integer]
+    attr_accessor :tax_year
+
+    # True to indicate this is a corrected tax form
+    # @return [TrueClass | FalseClass]
+    attr_accessor :corrected
+
+    # Long-term persistent identity of the source account. Not the account
+    # number
+    # @return [String]
+    attr_accessor :account_id
+
+    # Long-term persistent id for this tax form. Depending upon the data
+    # provider, this may be the same id as the enclosing tax statement id, or
+    # this may be a different id, or this id may be omitted.
+    # @return [String]
+    attr_accessor :tax_form_id
+
+    # Date of production or delivery of the tax form
+    # @return [Date]
+    attr_accessor :tax_form_date
+
+    # Additional explanation text or content about this tax form
+    # @return [String]
+    attr_accessor :additional_information
+
+    # Enumerated name of the tax form entity e.g. "TaxW2"
+    # @return [TypeFormType1]
+    attr_accessor :tax_form_type
+
+    # Issuer's name, address, phone, and TIN. Issuer data need only be
+    # transmitted on enclosing TaxStatement, if it is the same on all its
+    # included tax forms.
+    # @return [TaxParty8]
+    attr_accessor :issuer
+
+    # Recipient's name, address, phone, and TIN. Recipient data need only be
+    # transmitted on enclosing TaxStatement, if it is the same on all its
+    # included tax forms.
+    # @return [TaxParty1]
+    attr_accessor :recipient
+
+    # Additional attributes for this tax form when defined fields are not
+    # available. Some specific additional attributes already defined by
+    # providers: Fields required by [IRS
+    # FIRE](https://www.irs.gov/e-file-providers/filing-information-returns-elec
+    # tronically-fire): Name Control, Type of Identification Number (EIN, SSN,
+    # ITIN, ATIN). (ATIN is tax ID number for pending adoptions.) Tax form
+    # provider field for taxpayer notification: Recipient Email Address.
+    # @return [Array[TaxFormAttribute]]
+    attr_accessor :attributes
+
+    # Present if an error was encountered while retrieving this form
+    # @return [Error1]
+    attr_accessor :error
+
+    # Links to retrieve this form as data or image, or to invoke other APIs
+    # @return [Array[HateoasLink]]
+    attr_accessor :links
+
+    # By checking the box in STUDENT'S TIN, filer is making a true and accurate
+    # certification under penalty of perjury that they have complied with
+    # standards promulgated by the Secretary for obtaining such individual's TIN
+    # @return [TrueClass | FalseClass]
+    attr_accessor :student_tin_certification
+
+    # Account number
+    # @return [String]
+    attr_accessor :account_number
+
+    # Box 8, Check if at least half-time student
+    # @return [TrueClass | FalseClass]
+    attr_accessor :half_time
+
+    # Box 1, Payments received for qualified tuition and related expenses
+    # @return [Float]
+    attr_accessor :qualified_tuition_fees
+
+    # Box 4, Adjustments made for a prior year
+    # @return [Float]
+    attr_accessor :adjustment_prior_year
+
+    # Box 5, Scholarships or grants
+    # @return [Float]
+    attr_accessor :scholarship
+
+    # Box 6, Adjustments to scholarships or grants for a prior year
+    # @return [Float]
+    attr_accessor :adjust_scholarship
+
+    # Box 7, Check if the amount in box 1 or box 2 includes amounts for an
+    # academic period beginning January - March of next year
+    # @return [TrueClass | FalseClass]
+    attr_accessor :include_jan_mar
+
+    # Box 9, Check if graduate student
+    # @return [TrueClass | FalseClass]
+    attr_accessor :graduate
+
+    # Box 10, Insurance contract reimbursement / refund
+    # @return [Float]
+    attr_accessor :insurance_refund
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['tax_year'] = 'taxYear'
+      @_hash['corrected'] = 'corrected'
+      @_hash['account_id'] = 'accountId'
+      @_hash['tax_form_id'] = 'taxFormId'
+      @_hash['tax_form_date'] = 'taxFormDate'
+      @_hash['additional_information'] = 'additionalInformation'
+      @_hash['tax_form_type'] = 'taxFormType'
+      @_hash['issuer'] = 'issuer'
+      @_hash['recipient'] = 'recipient'
+      @_hash['attributes'] = 'attributes'
+      @_hash['error'] = 'error'
+      @_hash['links'] = 'links'
+      @_hash['student_tin_certification'] = 'studentTinCertification'
+      @_hash['account_number'] = 'accountNumber'
+      @_hash['half_time'] = 'halfTime'
+      @_hash['qualified_tuition_fees'] = 'qualifiedTuitionFees'
+      @_hash['adjustment_prior_year'] = 'adjustmentPriorYear'
+      @_hash['scholarship'] = 'scholarship'
+      @_hash['adjust_scholarship'] = 'adjustScholarship'
+      @_hash['include_jan_mar'] = 'includeJanMar'
+      @_hash['graduate'] = 'graduate'
+      @_hash['insurance_refund'] = 'insuranceRefund'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        tax_year
+        corrected
+        account_id
+        tax_form_id
+        tax_form_date
+        additional_information
+        tax_form_type
+        issuer
+        recipient
+        attributes
+        error
+        links
+        student_tin_certification
+        account_number
+        half_time
+        qualified_tuition_fees
+        adjustment_prior_year
+        scholarship
+        adjust_scholarship
+        include_jan_mar
+        graduate
+        insurance_refund
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(tax_year: SKIP, corrected: SKIP, account_id: SKIP,
+                   tax_form_id: SKIP, tax_form_date: SKIP,
+                   additional_information: SKIP, tax_form_type: SKIP,
+                   issuer: SKIP, recipient: SKIP, attributes: SKIP, error: SKIP,
+                   links: SKIP, student_tin_certification: SKIP,
+                   account_number: SKIP, half_time: SKIP,
+                   qualified_tuition_fees: SKIP, adjustment_prior_year: SKIP,
+                   scholarship: SKIP, adjust_scholarship: SKIP,
+                   include_jan_mar: SKIP, graduate: SKIP,
+                   insurance_refund: SKIP, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @tax_year = tax_year unless tax_year == SKIP
+      @corrected = corrected unless corrected == SKIP
+      @account_id = account_id unless account_id == SKIP
+      @tax_form_id = tax_form_id unless tax_form_id == SKIP
+      @tax_form_date = tax_form_date unless tax_form_date == SKIP
+      @additional_information = additional_information unless additional_information == SKIP
+      @tax_form_type = tax_form_type unless tax_form_type == SKIP
+      @issuer = issuer unless issuer == SKIP
+      @recipient = recipient unless recipient == SKIP
+      @attributes = attributes unless attributes == SKIP
+      @error = error unless error == SKIP
+      @links = links unless links == SKIP
+      unless student_tin_certification == SKIP
+        @student_tin_certification =
+          student_tin_certification
+      end
+      @account_number = account_number unless account_number == SKIP
+      @half_time = half_time unless half_time == SKIP
+      @qualified_tuition_fees = qualified_tuition_fees unless qualified_tuition_fees == SKIP
+      @adjustment_prior_year = adjustment_prior_year unless adjustment_prior_year == SKIP
+      @scholarship = scholarship unless scholarship == SKIP
+      @adjust_scholarship = adjust_scholarship unless adjust_scholarship == SKIP
+      @include_jan_mar = include_jan_mar unless include_jan_mar == SKIP
+      @graduate = graduate unless graduate == SKIP
+      @insurance_refund = insurance_refund unless insurance_refund == 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.
+      tax_year = hash.key?('taxYear') ? hash['taxYear'] : SKIP
+      corrected = hash.key?('corrected') ? hash['corrected'] : SKIP
+      account_id = hash.key?('accountId') ? hash['accountId'] : SKIP
+      tax_form_id = hash.key?('taxFormId') ? hash['taxFormId'] : SKIP
+      tax_form_date = hash.key?('taxFormDate') ? hash['taxFormDate'] : SKIP
+      additional_information =
+        hash.key?('additionalInformation') ? hash['additionalInformation'] : SKIP
+      tax_form_type = hash.key?('taxFormType') ? hash['taxFormType'] : SKIP
+      issuer = TaxParty8.from_hash(hash['issuer']) if hash['issuer']
+      recipient = TaxParty1.from_hash(hash['recipient']) if hash['recipient']
+      # Parameter is an array, so we need to iterate through it
+      attributes = nil
+      unless hash['attributes'].nil?
+        attributes = []
+        hash['attributes'].each do |structure|
+          attributes << (TaxFormAttribute.from_hash(structure) if structure)
+        end
+      end
+
+      attributes = SKIP unless hash.key?('attributes')
+      error = Error1.from_hash(hash['error']) if hash['error']
+      # 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')
+      student_tin_certification =
+        hash.key?('studentTinCertification') ? hash['studentTinCertification'] : SKIP
+      account_number = hash.key?('accountNumber') ? hash['accountNumber'] : SKIP
+      half_time = hash.key?('halfTime') ? hash['halfTime'] : SKIP
+      qualified_tuition_fees =
+        hash.key?('qualifiedTuitionFees') ? hash['qualifiedTuitionFees'] : SKIP
+      adjustment_prior_year =
+        hash.key?('adjustmentPriorYear') ? hash['adjustmentPriorYear'] : SKIP
+      scholarship = hash.key?('scholarship') ? hash['scholarship'] : SKIP
+      adjust_scholarship =
+        hash.key?('adjustScholarship') ? hash['adjustScholarship'] : SKIP
+      include_jan_mar =
+        hash.key?('includeJanMar') ? hash['includeJanMar'] : SKIP
+      graduate = hash.key?('graduate') ? hash['graduate'] : SKIP
+      insurance_refund =
+        hash.key?('insuranceRefund') ? hash['insuranceRefund'] : 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.
+      Form1098T.new(tax_year: tax_year,
+                    corrected: corrected,
+                    account_id: account_id,
+                    tax_form_id: tax_form_id,
+                    tax_form_date: tax_form_date,
+                    additional_information: additional_information,
+                    tax_form_type: tax_form_type,
+                    issuer: issuer,
+                    recipient: recipient,
+                    attributes: attributes,
+                    error: error,
+                    links: links,
+                    student_tin_certification: student_tin_certification,
+                    account_number: account_number,
+                    half_time: half_time,
+                    qualified_tuition_fees: qualified_tuition_fees,
+                    adjustment_prior_year: adjustment_prior_year,
+                    scholarship: scholarship,
+                    adjust_scholarship: adjust_scholarship,
+                    include_jan_mar: include_jan_mar,
+                    graduate: graduate,
+                    insurance_refund: insurance_refund,
+                    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} tax_year: #{@tax_year}, corrected: #{@corrected}, account_id:"\
+      " #{@account_id}, tax_form_id: #{@tax_form_id}, tax_form_date: #{@tax_form_date},"\
+      " additional_information: #{@additional_information}, tax_form_type: #{@tax_form_type},"\
+      " issuer: #{@issuer}, recipient: #{@recipient}, attributes: #{@attributes}, error:"\
+      " #{@error}, links: #{@links}, student_tin_certification: #{@student_tin_certification},"\
+      " account_number: #{@account_number}, half_time: #{@half_time}, qualified_tuition_fees:"\
+      " #{@qualified_tuition_fees}, adjustment_prior_year: #{@adjustment_prior_year}, scholarship:"\
+      " #{@scholarship}, adjust_scholarship: #{@adjust_scholarship}, include_jan_mar:"\
+      " #{@include_jan_mar}, graduate: #{@graduate}, insurance_refund: #{@insurance_refund},"\
+      " 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} tax_year: #{@tax_year.inspect}, corrected: #{@corrected.inspect},"\
+      " account_id: #{@account_id.inspect}, tax_form_id: #{@tax_form_id.inspect}, tax_form_date:"\
+      " #{@tax_form_date.inspect}, additional_information: #{@additional_information.inspect},"\
+      " tax_form_type: #{@tax_form_type.inspect}, issuer: #{@issuer.inspect}, recipient:"\
+      " #{@recipient.inspect}, attributes: #{@attributes.inspect}, error: #{@error.inspect},"\
+      " links: #{@links.inspect}, student_tin_certification:"\
+      " #{@student_tin_certification.inspect}, account_number: #{@account_number.inspect},"\
+      " half_time: #{@half_time.inspect}, qualified_tuition_fees:"\
+      " #{@qualified_tuition_fees.inspect}, adjustment_prior_year:"\
+      " #{@adjustment_prior_year.inspect}, scholarship: #{@scholarship.inspect},"\
+      " adjust_scholarship: #{@adjust_scholarship.inspect}, include_jan_mar:"\
+      " #{@include_jan_mar.inspect}, graduate: #{@graduate.inspect}, insurance_refund:"\
+      " #{@insurance_refund.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end