mindee 3.12.0 → 3.14.0

data/lib/mindee/product/bill_of_lading/bill_of_lading_v1_document.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require_relative '../../parsing'
+require_relative 'bill_of_lading_v1_shipper'
+require_relative 'bill_of_lading_v1_consignee'
+require_relative 'bill_of_lading_v1_notify_party'
+require_relative 'bill_of_lading_v1_carrier'
+require_relative 'bill_of_lading_v1_carrier_item'
+
+module Mindee
+  module Product
+    module BillOfLading
+      # Bill of Lading API version 1.1 document data.
+      class BillOfLadingV1Document < Mindee::Parsing::Common::Prediction
+        include Mindee::Parsing::Standard
+        # A unique identifier assigned to a Bill of Lading document.
+        # @return [Mindee::Parsing::Standard::StringField]
+        attr_reader :bill_of_lading_number
+        # The shipping company responsible for transporting the goods.
+        # @return [Mindee::Product::BillOfLading::BillOfLadingV1Carrier]
+        attr_reader :carrier
+        # The goods being shipped.
+        # @return [Array<Mindee::Product::BillOfLading::BillOfLadingV1CarrierItem>]
+        attr_reader :carrier_items
+        # The party to whom the goods are being shipped.
+        # @return [Mindee::Product::BillOfLading::BillOfLadingV1Consignee]
+        attr_reader :consignee
+        # The date when the bill of lading is issued.
+        # @return [Mindee::Parsing::Standard::DateField]
+        attr_reader :date_of_issue
+        # The date when the vessel departs from the port of loading.
+        # @return [Mindee::Parsing::Standard::DateField]
+        attr_reader :departure_date
+        # The party to be notified of the arrival of the goods.
+        # @return [Mindee::Product::BillOfLading::BillOfLadingV1NotifyParty]
+        attr_reader :notify_party
+        # The place where the goods are to be delivered.
+        # @return [Mindee::Parsing::Standard::StringField]
+        attr_reader :place_of_delivery
+        # The port where the goods are unloaded from the vessel.
+        # @return [Mindee::Parsing::Standard::StringField]
+        attr_reader :port_of_discharge
+        # The port where the goods are loaded onto the vessel.
+        # @return [Mindee::Parsing::Standard::StringField]
+        attr_reader :port_of_loading
+        # The party responsible for shipping the goods.
+        # @return [Mindee::Product::BillOfLading::BillOfLadingV1Shipper]
+        attr_reader :shipper
+
+        # @param prediction [Hash]
+        # @param page_id [Integer, nil]
+        def initialize(prediction, page_id)
+          super()
+          @bill_of_lading_number = StringField.new(prediction['bill_of_lading_number'], page_id)
+          @carrier = BillOfLadingV1Carrier.new(prediction['carrier'], page_id)
+          @carrier_items = []
+          prediction['carrier_items'].each do |item|
+            @carrier_items.push(BillOfLadingV1CarrierItem.new(item, page_id))
+          end
+          @consignee = BillOfLadingV1Consignee.new(prediction['consignee'], page_id)
+          @date_of_issue = DateField.new(prediction['date_of_issue'], page_id)
+          @departure_date = DateField.new(prediction['departure_date'], page_id)
+          @notify_party = BillOfLadingV1NotifyParty.new(prediction['notify_party'], page_id)
+          @place_of_delivery = StringField.new(prediction['place_of_delivery'], page_id)
+          @port_of_discharge = StringField.new(prediction['port_of_discharge'], page_id)
+          @port_of_loading = StringField.new(prediction['port_of_loading'], page_id)
+          @shipper = BillOfLadingV1Shipper.new(prediction['shipper'], page_id)
+        end
+
+        # @return [String]
+        def to_s
+          shipper = @shipper.to_s
+          consignee = @consignee.to_s
+          notify_party = @notify_party.to_s
+          carrier = @carrier.to_s
+          carrier_items = carrier_items_to_s
+          out_str = String.new
+          out_str << "\n:Bill of Lading Number: #{@bill_of_lading_number}".rstrip
+          out_str << "\n:Shipper:"
+          out_str << shipper
+          out_str << "\n:Consignee:"
+          out_str << consignee
+          out_str << "\n:Notify Party:"
+          out_str << notify_party
+          out_str << "\n:Carrier:"
+          out_str << carrier
+          out_str << "\n:Items:"
+          out_str << carrier_items
+          out_str << "\n:Port of Loading: #{@port_of_loading}".rstrip
+          out_str << "\n:Port of Discharge: #{@port_of_discharge}".rstrip
+          out_str << "\n:Place of Delivery: #{@place_of_delivery}".rstrip
+          out_str << "\n:Date of issue: #{@date_of_issue}".rstrip
+          out_str << "\n:Departure Date: #{@departure_date}".rstrip
+          out_str[1..].to_s
+        end
+
+        private
+
+        # @param char [String]
+        # @return [String]
+        def carrier_items_separator(char)
+          out_str = String.new
+          out_str << '  '
+          out_str << "+#{char * 38}"
+          out_str << "+#{char * 14}"
+          out_str << "+#{char * 13}"
+          out_str << "+#{char * 18}"
+          out_str << "+#{char * 10}"
+          out_str << "+#{char * 13}"
+          out_str << '+'
+          out_str
+        end
+
+        # @return [String]
+        def carrier_items_to_s
+          return '' if @carrier_items.empty?
+
+          line_items = @carrier_items.map(&:to_table_line).join("\n#{carrier_items_separator('-')}\n  ")
+          out_str = String.new
+          out_str << "\n#{carrier_items_separator('-')}"
+          out_str << "\n  |"
+          out_str << ' Description                          |'
+          out_str << ' Gross Weight |'
+          out_str << ' Measurement |'
+          out_str << ' Measurement Unit |'
+          out_str << ' Quantity |'
+          out_str << ' Weight Unit |'
+          out_str << "\n#{carrier_items_separator('=')}"
+          out_str << "\n  #{line_items}"
+          out_str << "\n#{carrier_items_separator('-')}"
+          out_str
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/bill_of_lading/bill_of_lading_v1_notify_party.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative '../../parsing'
+
+module Mindee
+  module Product
+    module BillOfLading
+      # The party to be notified of the arrival of the goods.
+      class BillOfLadingV1NotifyParty < Mindee::Parsing::Standard::FeatureField
+        include Mindee::Parsing::Standard
+        # The address of the notify party.
+        # @return [String]
+        attr_reader :address
+        # The  email of the shipper.
+        # @return [String]
+        attr_reader :email
+        # The name of the notify party.
+        # @return [String]
+        attr_reader :name
+        # The phone number of the notify party.
+        # @return [String]
+        attr_reader :phone
+
+        # @param prediction [Hash]
+        # @param page_id [Integer, nil]
+        def initialize(prediction, page_id)
+          super(prediction, page_id)
+          @address = prediction['address']
+          @email = prediction['email']
+          @name = prediction['name']
+          @phone = prediction['phone']
+          @page_id = page_id
+        end
+
+        # @return [Hash]
+        def printable_values
+          printable = {}
+          printable[:address] = format_for_display(@address)
+          printable[:email] = format_for_display(@email)
+          printable[:name] = format_for_display(@name)
+          printable[:phone] = format_for_display(@phone)
+          printable
+        end
+
+        # @return [String]
+        def to_s
+          printable = printable_values
+          out_str = String.new
+          out_str << "\n  :Address: #{printable[:address]}"
+          out_str << "\n  :Email: #{printable[:email]}"
+          out_str << "\n  :Name: #{printable[:name]}"
+          out_str << "\n  :Phone: #{printable[:phone]}"
+          out_str
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/bill_of_lading/bill_of_lading_v1_page.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative '../../parsing'
+require_relative 'bill_of_lading_v1_document'
+
+module Mindee
+  module Product
+    module BillOfLading
+      # Bill of Lading API version 1.1 page data.
+      class BillOfLadingV1Page < Mindee::Parsing::Common::Page
+        # @param prediction [Hash]
+        def initialize(prediction)
+          super(prediction)
+          @prediction = BillOfLadingV1PagePrediction.new(
+            prediction['prediction'],
+            prediction['id']
+          )
+        end
+      end
+
+      # Bill of Lading V1 page prediction.
+      class BillOfLadingV1PagePrediction < BillOfLadingV1Document
+        # @return [String]
+        def to_s
+          out_str = String.new
+          out_str << "\n#{super}"
+          out_str
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/bill_of_lading/bill_of_lading_v1_shipper.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative '../../parsing'
+
+module Mindee
+  module Product
+    module BillOfLading
+      # The party responsible for shipping the goods.
+      class BillOfLadingV1Shipper < Mindee::Parsing::Standard::FeatureField
+        include Mindee::Parsing::Standard
+        # The address of the shipper.
+        # @return [String]
+        attr_reader :address
+        # The  email of the shipper.
+        # @return [String]
+        attr_reader :email
+        # The name of the shipper.
+        # @return [String]
+        attr_reader :name
+        # The phone number of the shipper.
+        # @return [String]
+        attr_reader :phone
+
+        # @param prediction [Hash]
+        # @param page_id [Integer, nil]
+        def initialize(prediction, page_id)
+          super(prediction, page_id)
+          @address = prediction['address']
+          @email = prediction['email']
+          @name = prediction['name']
+          @phone = prediction['phone']
+          @page_id = page_id
+        end
+
+        # @return [Hash]
+        def printable_values
+          printable = {}
+          printable[:address] = format_for_display(@address)
+          printable[:email] = format_for_display(@email)
+          printable[:name] = format_for_display(@name)
+          printable[:phone] = format_for_display(@phone)
+          printable
+        end
+
+        # @return [String]
+        def to_s
+          printable = printable_values
+          out_str = String.new
+          out_str << "\n  :Address: #{printable[:address]}"
+          out_str << "\n  :Email: #{printable[:email]}"
+          out_str << "\n  :Name: #{printable[:name]}"
+          out_str << "\n  :Phone: #{printable[:phone]}"
+          out_str
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/financial_document/financial_document_v1_document.rb

@@ -6,7 +6,7 @@ require_relative 'financial_document_v1_line_item'
 module Mindee
   module Product
     module FinancialDocument
-      # Financial Document API version 1.9 document data.
+      # Financial Document API version 1.10 document data.
       class FinancialDocumentV1Document < Mindee::Parsing::Common::Prediction
         include Mindee::Parsing::Standard
         # The customer's address used for billing.
@@ -48,6 +48,12 @@ module Mindee
         # The locale detected on the document.
         # @return [Mindee::Parsing::Standard::LocaleField]
         attr_reader :locale
+        # The date on which the payment is due / fullfilled.
+        # @return [Mindee::Parsing::Standard::DateField]
+        attr_reader :payment_date
+        # The purchase order number.
+        # @return [Mindee::Parsing::Standard::StringField]
+        attr_reader :po_number
         # The receipt number or identifier only if document is a receipt.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :receipt_number
@@ -123,6 +129,8 @@ module Mindee
             @line_items.push(FinancialDocumentV1LineItem.new(item, page_id))
           end
           @locale = LocaleField.new(prediction['locale'], page_id)
+          @payment_date = DateField.new(prediction['payment_date'], page_id)
+          @po_number = StringField.new(prediction['po_number'], page_id)
           @receipt_number = StringField.new(prediction['receipt_number'], page_id)
           @reference_numbers = []
           prediction['reference_numbers'].each do |item|
@@ -161,11 +169,13 @@ module Mindee
           out_str = String.new
           out_str << "\n:Locale: #{@locale}".rstrip
           out_str << "\n:Invoice Number: #{@invoice_number}".rstrip
+          out_str << "\n:Purchase Order Number: #{@po_number}".rstrip
           out_str << "\n:Receipt Number: #{@receipt_number}".rstrip
           out_str << "\n:Document Number: #{@document_number}".rstrip
           out_str << "\n:Reference Numbers: #{reference_numbers}".rstrip
           out_str << "\n:Purchase Date: #{@date}".rstrip
           out_str << "\n:Due Date: #{@due_date}".rstrip
+          out_str << "\n:Payment Date: #{@payment_date}".rstrip
           out_str << "\n:Total Net: #{@total_net}".rstrip
           out_str << "\n:Total Amount: #{@total_amount}".rstrip
           out_str << "\n:Taxes:#{@taxes}".rstrip

data/lib/mindee/product/financial_document/financial_document_v1_line_item.rb

@@ -50,6 +50,20 @@ module Mindee
 
         # @return [Hash]
         def printable_values
+          printable = {}
+          printable[:description] = format_for_display(@description)
+          printable[:product_code] = format_for_display(@product_code)
+          printable[:quantity] = @quantity.nil? ? '' : Field.float_to_string(@quantity)
+          printable[:tax_amount] = @tax_amount.nil? ? '' : Field.float_to_string(@tax_amount)
+          printable[:tax_rate] = @tax_rate.nil? ? '' : Field.float_to_string(@tax_rate)
+          printable[:total_amount] = @total_amount.nil? ? '' : Field.float_to_string(@total_amount)
+          printable[:unit_measure] = format_for_display(@unit_measure)
+          printable[:unit_price] = @unit_price.nil? ? '' : Field.float_to_string(@unit_price)
+          printable
+        end
+
+        # @return [Hash]
+        def table_printable_values
           printable = {}
           printable[:description] = format_for_display(@description, 36)
           printable[:product_code] = format_for_display(@product_code, nil)
@@ -64,7 +78,7 @@ module Mindee
 
         # @return [String]
         def to_table_line
-          printable = printable_values
+          printable = table_printable_values
           out_str = String.new
           out_str << format('| %- 37s', printable[:description])
           out_str << format('| %- 13s', printable[:product_code])

data/lib/mindee/product/financial_document/financial_document_v1_page.rb

@@ -6,7 +6,7 @@ require_relative 'financial_document_v1_document'
 module Mindee
   module Product
     module FinancialDocument
-      # Financial Document API version 1.9 page data.
+      # Financial Document API version 1.10 page data.
       class FinancialDocumentV1Page < Mindee::Parsing::Common::Page
         # @param prediction [Hash]
         def initialize(prediction)

data/lib/mindee/product/fr/bank_account_details/bank_account_details_v2_bban.rb

@@ -36,24 +36,13 @@ module Mindee
           # @return [Hash]
           def printable_values
             printable = {}
-            printable[:bban_bank_code] = format_for_display(@bban_bank_code, nil)
-            printable[:bban_branch_code] = format_for_display(@bban_branch_code, nil)
-            printable[:bban_key] = format_for_display(@bban_key, nil)
-            printable[:bban_number] = format_for_display(@bban_number, nil)
+            printable[:bban_bank_code] = format_for_display(@bban_bank_code)
+            printable[:bban_branch_code] = format_for_display(@bban_branch_code)
+            printable[:bban_key] = format_for_display(@bban_key)
+            printable[:bban_number] = format_for_display(@bban_number)
             printable
           end
 
-          # @return [String]
-          def to_table_line
-            printable = printable_values
-            out_str = String.new
-            out_str << format('| %- 10s', printable[:bban_bank_code])
-            out_str << format('| %- 12s', printable[:bban_branch_code])
-            out_str << format('| %- 4s', printable[:bban_key])
-            out_str << format('| %- 15s', printable[:bban_number])
-            out_str << '|'
-          end
-
           # @return [String]
           def to_s
             printable = printable_values

data/lib/mindee/product/fr/energy_bill/energy_bill_v1.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'energy_bill_v1_document'
+require_relative 'energy_bill_v1_page'
+
+module Mindee
+  module Product
+    module FR
+      # Energy Bill module.
+      module EnergyBill
+        # Energy Bill API version 1 inference prediction.
+        class EnergyBillV1 < Mindee::Parsing::Common::Inference
+          @endpoint_name = 'energy_bill_fra'
+          @endpoint_version = '1'
+
+          # @param prediction [Hash]
+          def initialize(prediction)
+            super
+            @prediction = EnergyBillV1Document.new(prediction['prediction'], nil)
+            @pages = []
+            prediction['pages'].each do |page|
+              if page.key?('prediction') && !page['prediction'].nil? && !page['prediction'].empty?
+                @pages.push(EnergyBillV1Page.new(page))
+              end
+            end
+          end
+
+          class << self
+            # Name of the endpoint for this product.
+            # @return [String]
+            attr_reader :endpoint_name
+            # Version for this product.
+            # @return [String]
+            attr_reader :endpoint_version
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mindee/product/fr/energy_bill/energy_bill_v1_document.rb

@@ -0,0 +1,235 @@
+# frozen_string_literal: true
+
+require_relative '../../../parsing'
+require_relative 'energy_bill_v1_energy_supplier'
+require_relative 'energy_bill_v1_energy_consumer'
+require_relative 'energy_bill_v1_subscription'
+require_relative 'energy_bill_v1_energy_usage'
+require_relative 'energy_bill_v1_taxes_and_contribution'
+require_relative 'energy_bill_v1_meter_detail'
+
+module Mindee
+  module Product
+    module FR
+      module EnergyBill
+        # Energy Bill API version 1.0 document data.
+        class EnergyBillV1Document < Mindee::Parsing::Common::Prediction
+          include Mindee::Parsing::Standard
+          # The unique identifier associated with a specific contract.
+          # @return [Mindee::Parsing::Standard::StringField]
+          attr_reader :contract_id
+          # The unique identifier assigned to each electricity or gas consumption point. It specifies the exact
+          # location where the energy is delivered.
+          # @return [Mindee::Parsing::Standard::StringField]
+          attr_reader :delivery_point
+          # The date by which the payment for the energy invoice is due.
+          # @return [Mindee::Parsing::Standard::DateField]
+          attr_reader :due_date
+          # The entity that consumes the energy.
+          # @return [Mindee::Product::FR::EnergyBill::EnergyBillV1EnergyConsumer]
+          attr_reader :energy_consumer
+          # The company that supplies the energy.
+          # @return [Mindee::Product::FR::EnergyBill::EnergyBillV1EnergySupplier]
+          attr_reader :energy_supplier
+          # Details of energy consumption.
+          # @return [Array<Mindee::Product::FR::EnergyBill::EnergyBillV1EnergyUsage>]
+          attr_reader :energy_usage
+          # The date when the energy invoice was issued.
+          # @return [Mindee::Parsing::Standard::DateField]
+          attr_reader :invoice_date
+          # The unique identifier of the energy invoice.
+          # @return [Mindee::Parsing::Standard::StringField]
+          attr_reader :invoice_number
+          # Information about the energy meter.
+          # @return [Mindee::Product::FR::EnergyBill::EnergyBillV1MeterDetail]
+          attr_reader :meter_details
+          # The subscription details fee for the energy service.
+          # @return [Array<Mindee::Product::FR::EnergyBill::EnergyBillV1Subscription>]
+          attr_reader :subscription
+          # Details of Taxes and Contributions.
+          # @return [Array<Mindee::Product::FR::EnergyBill::EnergyBillV1TaxesAndContribution>]
+          attr_reader :taxes_and_contributions
+          # The total amount to be paid for the energy invoice.
+          # @return [Mindee::Parsing::Standard::AmountField]
+          attr_reader :total_amount
+          # The total amount to be paid for the energy invoice before taxes.
+          # @return [Mindee::Parsing::Standard::AmountField]
+          attr_reader :total_before_taxes
+          # Total of taxes applied to the invoice.
+          # @return [Mindee::Parsing::Standard::AmountField]
+          attr_reader :total_taxes
+
+          # @param prediction [Hash]
+          # @param page_id [Integer, nil]
+          def initialize(prediction, page_id)
+            super()
+            @contract_id = StringField.new(prediction['contract_id'], page_id)
+            @delivery_point = StringField.new(prediction['delivery_point'], page_id)
+            @due_date = DateField.new(prediction['due_date'], page_id)
+            @energy_consumer = EnergyBillV1EnergyConsumer.new(prediction['energy_consumer'], page_id)
+            @energy_supplier = EnergyBillV1EnergySupplier.new(prediction['energy_supplier'], page_id)
+            @energy_usage = []
+            prediction['energy_usage'].each do |item|
+              @energy_usage.push(EnergyBillV1EnergyUsage.new(item, page_id))
+            end
+            @invoice_date = DateField.new(prediction['invoice_date'], page_id)
+            @invoice_number = StringField.new(prediction['invoice_number'], page_id)
+            @meter_details = EnergyBillV1MeterDetail.new(prediction['meter_details'], page_id)
+            @subscription = []
+            prediction['subscription'].each do |item|
+              @subscription.push(EnergyBillV1Subscription.new(item, page_id))
+            end
+            @taxes_and_contributions = []
+            prediction['taxes_and_contributions'].each do |item|
+              @taxes_and_contributions.push(EnergyBillV1TaxesAndContribution.new(item, page_id))
+            end
+            @total_amount = AmountField.new(prediction['total_amount'], page_id)
+            @total_before_taxes = AmountField.new(prediction['total_before_taxes'], page_id)
+            @total_taxes = AmountField.new(prediction['total_taxes'], page_id)
+          end
+
+          # @return [String]
+          def to_s
+            energy_supplier = @energy_supplier.to_s
+            energy_consumer = @energy_consumer.to_s
+            subscription = subscription_to_s
+            energy_usage = energy_usage_to_s
+            taxes_and_contributions = taxes_and_contributions_to_s
+            meter_details = @meter_details.to_s
+            out_str = String.new
+            out_str << "\n:Invoice Number: #{@invoice_number}".rstrip
+            out_str << "\n:Contract ID: #{@contract_id}".rstrip
+            out_str << "\n:Delivery Point: #{@delivery_point}".rstrip
+            out_str << "\n:Invoice Date: #{@invoice_date}".rstrip
+            out_str << "\n:Due Date: #{@due_date}".rstrip
+            out_str << "\n:Total Before Taxes: #{@total_before_taxes}".rstrip
+            out_str << "\n:Total Taxes: #{@total_taxes}".rstrip
+            out_str << "\n:Total Amount: #{@total_amount}".rstrip
+            out_str << "\n:Energy Supplier:"
+            out_str << energy_supplier
+            out_str << "\n:Energy Consumer:"
+            out_str << energy_consumer
+            out_str << "\n:Subscription:"
+            out_str << subscription
+            out_str << "\n:Energy Usage:"
+            out_str << energy_usage
+            out_str << "\n:Taxes and Contributions:"
+            out_str << taxes_and_contributions
+            out_str << "\n:Meter Details:"
+            out_str << meter_details
+            out_str[1..].to_s
+          end
+
+          private
+
+          # @param char [String]
+          # @return [String]
+          def subscription_separator(char)
+            out_str = String.new
+            out_str << '  '
+            out_str << "+#{char * 38}"
+            out_str << "+#{char * 12}"
+            out_str << "+#{char * 12}"
+            out_str << "+#{char * 10}"
+            out_str << "+#{char * 11}"
+            out_str << "+#{char * 12}"
+            out_str << '+'
+            out_str
+          end
+
+          # @return [String]
+          def subscription_to_s
+            return '' if @subscription.empty?
+
+            line_items = @subscription.map(&:to_table_line).join("\n#{subscription_separator('-')}\n  ")
+            out_str = String.new
+            out_str << "\n#{subscription_separator('-')}"
+            out_str << "\n  |"
+            out_str << ' Description                          |'
+            out_str << ' End Date   |'
+            out_str << ' Start Date |'
+            out_str << ' Tax Rate |'
+            out_str << ' Total     |'
+            out_str << ' Unit Price |'
+            out_str << "\n#{subscription_separator('=')}"
+            out_str << "\n  #{line_items}"
+            out_str << "\n#{subscription_separator('-')}"
+            out_str
+          end
+
+          # @param char [String]
+          # @return [String]
+          def energy_usage_separator(char)
+            out_str = String.new
+            out_str << '  '
+            out_str << "+#{char * 38}"
+            out_str << "+#{char * 12}"
+            out_str << "+#{char * 12}"
+            out_str << "+#{char * 10}"
+            out_str << "+#{char * 11}"
+            out_str << "+#{char * 12}"
+            out_str << '+'
+            out_str
+          end
+
+          # @return [String]
+          def energy_usage_to_s
+            return '' if @energy_usage.empty?
+
+            line_items = @energy_usage.map(&:to_table_line).join("\n#{energy_usage_separator('-')}\n  ")
+            out_str = String.new
+            out_str << "\n#{energy_usage_separator('-')}"
+            out_str << "\n  |"
+            out_str << ' Description                          |'
+            out_str << ' End Date   |'
+            out_str << ' Start Date |'
+            out_str << ' Tax Rate |'
+            out_str << ' Total     |'
+            out_str << ' Unit Price |'
+            out_str << "\n#{energy_usage_separator('=')}"
+            out_str << "\n  #{line_items}"
+            out_str << "\n#{energy_usage_separator('-')}"
+            out_str
+          end
+
+          # @param char [String]
+          # @return [String]
+          def taxes_and_contributions_separator(char)
+            out_str = String.new
+            out_str << '  '
+            out_str << "+#{char * 38}"
+            out_str << "+#{char * 12}"
+            out_str << "+#{char * 12}"
+            out_str << "+#{char * 10}"
+            out_str << "+#{char * 11}"
+            out_str << "+#{char * 12}"
+            out_str << '+'
+            out_str
+          end
+
+          # @return [String]
+          def taxes_and_contributions_to_s
+            return '' if @taxes_and_contributions.empty?
+
+            line_items = @taxes_and_contributions.map(&:to_table_line).join(
+              "\n#{taxes_and_contributions_separator('-')}\n  "
+            )
+            out_str = String.new
+            out_str << "\n#{taxes_and_contributions_separator('-')}"
+            out_str << "\n  |"
+            out_str << ' Description                          |'
+            out_str << ' End Date   |'
+            out_str << ' Start Date |'
+            out_str << ' Tax Rate |'
+            out_str << ' Total     |'
+            out_str << ' Unit Price |'
+            out_str << "\n#{taxes_and_contributions_separator('=')}"
+            out_str << "\n  #{line_items}"
+            out_str << "\n#{taxes_and_contributions_separator('-')}"
+            out_str
+          end
+        end
+      end
+    end
+  end
+end