mindee 4.0.0 → 4.1.2

data/lib/mindee/pdf/pdf_extractor.rb

@@ -46,7 +46,7 @@ module Mindee
           extension = File.extname(@filename)
           basename = File.basename(@filename, extension)
           page_indexes.each do |page_index_list|
-            if page_index_list.empty? || page_index_list.nil?
+            if page_index_list.nil? || page_index_list.empty?
               raise Errors::MindeePDFError, "Empty indexes aren't allowed for extraction #{page_index_list}"
             end
 
@@ -70,12 +70,12 @@ module Mindee
         # rubocop:disable Metrics/PerceivedComplexity
 
         # Extracts invoices as complete PDFs from the document.
-        # @param page_indexes [Array<Array<Integer>, InvoiceSplitterV1PageGroup>]
+        # @param page_indexes [Array<Array<Integer>, InvoiceSplitterV1InvoicePageGroup>]
         # @param strict [bool]
         # @return [Array<Mindee::PDF::PDFExtractor::ExtractedPDF>]
         def extract_invoices(page_indexes, strict: false)
           raise Errors::MindeePDFError, 'No indexes provided.' if page_indexes.empty?
-          unless page_indexes[0].is_a?(Mindee::Product::InvoiceSplitter::InvoiceSplitterV1PageGroup)
+          if page_indexes[0].is_a?(Array) && page_indexes[0].all? { |i| i.is_a?(Integer) }
             return extract_sub_documents(page_indexes)
           end
           return extract_sub_documents(page_indexes.map(&:page_indexes)) unless strict

data/lib/mindee/product/delivery_note/delivery_note_v1_document.rb

@@ -5,7 +5,7 @@ require_relative '../../parsing'
 module Mindee
   module Product
     module DeliveryNote
-      # Delivery note API version 1.1 document data.
+      # Delivery note API version 1.2 document data.
       class DeliveryNoteV1Document < Mindee::Parsing::Common::Prediction
         include Mindee::Parsing::Standard
         # The address of the customer receiving the goods.

data/lib/mindee/product/delivery_note/delivery_note_v1_page.rb

@@ -6,7 +6,7 @@ require_relative 'delivery_note_v1_document'
 module Mindee
   module Product
     module DeliveryNote
-      # Delivery note API version 1.1 page data.
+      # Delivery note API version 1.2 page data.
       class DeliveryNoteV1Page < Mindee::Parsing::Common::Page
         # @param prediction [Hash]
         def initialize(prediction)

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

@@ -12,13 +12,13 @@ module Mindee
         # The customer's address used for billing.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :billing_address
-        # The purchase category among predefined classes.
+        # The purchase category, only for receipts.
         # @return [Mindee::Parsing::Standard::ClassificationField]
         attr_reader :category
         # The address of the customer.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :customer_address
-        # List of company registrations associated to the customer.
+        # List of company registration numbers associated to the customer.
         # @return [Array<Mindee::Parsing::Standard::CompanyRegistrationField>]
         attr_reader :customer_company_registrations
         # The customer account number or identifier from the supplier.
@@ -30,10 +30,11 @@ module Mindee
         # The date the purchase was made.
         # @return [Mindee::Parsing::Standard::DateField]
         attr_reader :date
-        # The document number or identifier.
+        # The document number or identifier (invoice number or receipt number).
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :document_number
-        # One of: 'INVOICE', 'CREDIT NOTE', 'CREDIT CARD RECEIPT', 'EXPENSE RECEIPT'.
+        # The type of the document: INVOICE or CREDIT NOTE if it is an invoice, CREDIT CARD RECEIPT or EXPENSE
+        # RECEIPT if it is a receipt.
         # @return [Mindee::Parsing::Standard::ClassificationField]
         attr_reader :document_type
         # The date on which the payment is due.
@@ -42,34 +43,34 @@ module Mindee
         # The invoice number or identifier only if document is an invoice.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :invoice_number
-        # List of line item details.
+        # List of line item present on the document.
         # @return [Mindee::Product::FinancialDocument::FinancialDocumentV1LineItems]
         attr_reader :line_items
-        # The locale detected on the document.
+        # The locale of 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.
+        # The purchase order number, only if the document is an invoice.
         # @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
-        # List of Reference numbers, including PO number.
+        # List of Reference numbers, including PO number, only if the document is an invoice.
         # @return [Array<Mindee::Parsing::Standard::StringField>]
         attr_reader :reference_numbers
         # The customer's address used for shipping.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :shipping_address
-        # The purchase subcategory among predefined classes for transport and food.
+        # The purchase subcategory for transport and food, only for receipts.
         # @return [Mindee::Parsing::Standard::ClassificationField]
         attr_reader :subcategory
         # The address of the supplier or merchant.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :supplier_address
-        # List of company registrations associated to the supplier.
+        # List of company registration numbers associated to the supplier.
         # @return [Array<Mindee::Parsing::Standard::CompanyRegistrationField>]
         attr_reader :supplier_company_registrations
         # The email of the supplier or merchant.
@@ -78,7 +79,7 @@ module Mindee
         # The name of the supplier or merchant.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :supplier_name
-        # List of payment details associated to the supplier.
+        # List of payment details associated to the supplier (only for invoices).
         # @return [Array<Mindee::Parsing::Standard::PaymentDetailsField>]
         attr_reader :supplier_payment_details
         # The phone number of the supplier or merchant.
@@ -87,10 +88,10 @@ module Mindee
         # The website URL of the supplier or merchant.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :supplier_website
-        # List of tax lines information.
+        # List of all taxes on the document.
         # @return [Mindee::Parsing::Standard::Taxes]
         attr_reader :taxes
-        # The time the purchase was made.
+        # The time the purchase was made (only for receipts).
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :time
         # The total amount of tip and gratuity
@@ -102,7 +103,7 @@ module Mindee
         # The net amount paid: does not include taxes, fees, and discounts.
         # @return [Mindee::Parsing::Standard::AmountField]
         attr_reader :total_net
-        # The total amount of taxes.
+        # The sum of all taxes present on the document.
         # @return [Mindee::Parsing::Standard::AmountField]
         attr_reader :total_tax
 

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

@@ -5,7 +5,7 @@ require_relative '../../parsing'
 module Mindee
   module Product
     module FinancialDocument
-      # List of line item details.
+      # List of line item present on the document.
       class FinancialDocumentV1LineItem < Mindee::Parsing::Standard::FeatureField
         include Mindee::Parsing::Standard
         # The item description.

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

@@ -5,7 +5,7 @@ require_relative 'financial_document_v1_line_item'
 module Mindee
   module Product
     module FinancialDocument
-      # List of line item details.
+      # List of line item present on the document.
       class FinancialDocumentV1LineItems < Array
         # Entries.
         # @return [Array<FinancialDocumentV1LineItem>]

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

@@ -12,7 +12,7 @@ module Mindee
   module Product
     module FR
       module EnergyBill
-        # Energy Bill API version 1.0 document data.
+        # Energy Bill API version 1.2 document data.
         class EnergyBillV1Document < Mindee::Parsing::Common::Prediction
           include Mindee::Parsing::Standard
           # The unique identifier associated with a specific contract.
@@ -188,11 +188,13 @@ module Mindee
           def energy_usage_separator(char)
             out_str = String.new
             out_str << '  '
+            out_str << "+#{char * 13}"
             out_str << "+#{char * 38}"
             out_str << "+#{char * 12}"
             out_str << "+#{char * 12}"
             out_str << "+#{char * 10}"
             out_str << "+#{char * 11}"
+            out_str << "+#{char * 17}"
             out_str << "+#{char * 12}"
             out_str << '+'
             out_str
@@ -206,11 +208,13 @@ module Mindee
             out_str = String.new
             out_str << "\n#{energy_usage_separator('-')}"
             out_str << "\n  |"
+            out_str << ' Consumption |'
             out_str << ' Description                          |'
             out_str << ' End Date   |'
             out_str << ' Start Date |'
             out_str << ' Tax Rate |'
             out_str << ' Total     |'
+            out_str << ' Unit of Measure |'
             out_str << ' Unit Price |'
             out_str << "\n#{energy_usage_separator('=')}"
             out_str << "\n  #{line_items}"

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

@@ -9,6 +9,9 @@ module Mindee
         # Details of energy consumption.
         class EnergyBillV1EnergyUsage < Mindee::Parsing::Standard::FeatureField
           include Mindee::Parsing::Standard
+          # The price per unit of energy consumed.
+          # @return [Float]
+          attr_reader :consumption
           # Description or details of the energy usage.
           # @return [String]
           attr_reader :description
@@ -24,6 +27,9 @@ module Mindee
           # The total cost of energy consumed.
           # @return [Float]
           attr_reader :total
+          # The unit of measurement for energy consumption.
+          # @return [String]
+          attr_reader :unit
           # The price per unit of energy consumed.
           # @return [Float]
           attr_reader :unit_price
@@ -32,11 +38,13 @@ module Mindee
           # @param page_id [Integer, nil]
           def initialize(prediction, page_id)
             super
+            @consumption = prediction['consumption']
             @description = prediction['description']
             @end_date = prediction['end_date']
             @start_date = prediction['start_date']
             @tax_rate = prediction['tax_rate']
             @total = prediction['total']
+            @unit = prediction['unit']
             @unit_price = prediction['unit_price']
             @page_id = page_id
           end
@@ -44,6 +52,8 @@ module Mindee
           # @return [Hash]
           def printable_values
             printable = {}
+            printable[:consumption] =
+              @consumption.nil? ? '' : Parsing::Standard::BaseField.float_to_string(@consumption)
             printable[:description] = format_for_display(@description)
             printable[:end_date] = format_for_display(@end_date)
             printable[:start_date] = format_for_display(@start_date)
@@ -51,6 +61,7 @@ module Mindee
               @tax_rate.nil? ? '' : Parsing::Standard::BaseField.float_to_string(@tax_rate)
             printable[:total] =
               @total.nil? ? '' : Parsing::Standard::BaseField.float_to_string(@total)
+            printable[:unit] = format_for_display(@unit)
             printable[:unit_price] =
               @unit_price.nil? ? '' : Parsing::Standard::BaseField.float_to_string(@unit_price)
             printable
@@ -59,6 +70,8 @@ module Mindee
           # @return [Hash]
           def table_printable_values
             printable = {}
+            printable[:consumption] =
+              @consumption.nil? ? '' : Parsing::Standard::BaseField.float_to_string(@consumption)
             printable[:description] = format_for_display(@description, 36)
             printable[:end_date] = format_for_display(@end_date, 10)
             printable[:start_date] = format_for_display(@start_date, nil)
@@ -66,6 +79,7 @@ module Mindee
               @tax_rate.nil? ? '' : Parsing::Standard::BaseField.float_to_string(@tax_rate)
             printable[:total] =
               @total.nil? ? '' : Parsing::Standard::BaseField.float_to_string(@total)
+            printable[:unit] = format_for_display(@unit, nil)
             printable[:unit_price] =
               @unit_price.nil? ? '' : Parsing::Standard::BaseField.float_to_string(@unit_price)
             printable
@@ -75,11 +89,13 @@ module Mindee
           def to_table_line
             printable = table_printable_values
             out_str = String.new
+            out_str << format('| %- 12s', printable[:consumption])
             out_str << format('| %- 37s', printable[:description])
             out_str << format('| %- 11s', printable[:end_date])
             out_str << format('| %- 11s', printable[:start_date])
             out_str << format('| %- 9s', printable[:tax_rate])
             out_str << format('| %- 10s', printable[:total])
+            out_str << format('| %- 16s', printable[:unit])
             out_str << format('| %- 11s', printable[:unit_price])
             out_str << '|'
           end
@@ -88,11 +104,13 @@ module Mindee
           def to_s
             printable = printable_values
             out_str = String.new
+            out_str << "\n  :Consumption: #{printable[:consumption]}"
             out_str << "\n  :Description: #{printable[:description]}"
             out_str << "\n  :End Date: #{printable[:end_date]}"
             out_str << "\n  :Start Date: #{printable[:start_date]}"
             out_str << "\n  :Tax Rate: #{printable[:tax_rate]}"
             out_str << "\n  :Total: #{printable[:total]}"
+            out_str << "\n  :Unit of Measure: #{printable[:unit]}"
             out_str << "\n  :Unit Price: #{printable[:unit_price]}"
             out_str
           end

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

@@ -31,11 +31,13 @@ module Mindee
           # @return [String]
           def self.line_items_separator(char)
             out_str = String.new
+            out_str << "+#{char * 13}"
             out_str << "+#{char * 38}"
             out_str << "+#{char * 12}"
             out_str << "+#{char * 12}"
             out_str << "+#{char * 10}"
             out_str << "+#{char * 11}"
+            out_str << "+#{char * 17}"
             out_str << "+#{char * 12}"
             out_str
           end
@@ -49,11 +51,13 @@ module Mindee
             end.join
             out_str = String.new
             out_str << ("\n#{self.class.line_items_separator('-')}\n ")
+            out_str << ' | Consumption'
             out_str << ' | Description                         '
             out_str << ' | End Date  '
             out_str << ' | Start Date'
             out_str << ' | Tax Rate'
             out_str << ' | Total    '
+            out_str << ' | Unit of Measure'
             out_str << ' | Unit Price'
             out_str << (" |\n#{self.class.line_items_separator('=')}")
             out_str + lines

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

@@ -15,7 +15,7 @@ module Mindee
           # The type of energy meter.
           # @return [String]
           attr_reader :meter_type
-          # The unit of measurement for energy consumption, which can be kW, m³, or L.
+          # The unit of power for energy consumption.
           # @return [String]
           attr_reader :unit
 
@@ -44,7 +44,7 @@ module Mindee
             out_str = String.new
             out_str << "\n  :Meter Number: #{printable[:meter_number]}"
             out_str << "\n  :Meter Type: #{printable[:meter_type]}"
-            out_str << "\n  :Unit of Measure: #{printable[:unit]}"
+            out_str << "\n  :Unit of Power: #{printable[:unit]}"
             out_str
           end
         end

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

@@ -7,7 +7,7 @@ module Mindee
   module Product
     module FR
       module EnergyBill
-        # Energy Bill API version 1.0 page data.
+        # Energy Bill API version 1.2 page data.
         class EnergyBillV1Page < Mindee::Parsing::Common::Page
           # @param prediction [Hash]
           def initialize(prediction)

data/lib/mindee/product/invoice/invoice_v4_document.rb

@@ -9,13 +9,13 @@ module Mindee
       # Invoice API version 4.9 document data.
       class InvoiceV4Document < Mindee::Parsing::Common::Prediction
         include Mindee::Parsing::Standard
-        # The customer's address used for billing.
+        # The customer billing address.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :billing_address
         # The address of the customer.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :customer_address
-        # List of company registrations associated to the customer.
+        # List of company registration numbers associated to the customer.
         # @return [Array<Mindee::Parsing::Standard::CompanyRegistrationField>]
         attr_reader :customer_company_registrations
         # The customer account number or identifier from the supplier.
@@ -27,7 +27,7 @@ module Mindee
         # The date the purchase was made.
         # @return [Mindee::Parsing::Standard::DateField]
         attr_reader :date
-        # One of: 'INVOICE', 'CREDIT NOTE'.
+        # Document type: INVOICE or CREDIT NOTE.
         # @return [Mindee::Parsing::Standard::ClassificationField]
         attr_reader :document_type
         # The date on which the payment is due.
@@ -36,19 +36,19 @@ module Mindee
         # The invoice number or identifier.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :invoice_number
-        # List of line item details.
+        # List of all the line items present on the invoice.
         # @return [Mindee::Product::Invoice::InvoiceV4LineItems]
         attr_reader :line_items
-        # The locale detected on the document.
+        # The locale of the document.
         # @return [Mindee::Parsing::Standard::LocaleField]
         attr_reader :locale
-        # The date on which the payment is due/ was full-filled.
+        # The date on which the payment is due / was full-filled.
         # @return [Mindee::Parsing::Standard::DateField]
         attr_reader :payment_date
         # The purchase order number.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :po_number
-        # List of Reference numbers, including PO number.
+        # List of all reference numbers on the invoice, including the purchase order number.
         # @return [Array<Mindee::Parsing::Standard::StringField>]
         attr_reader :reference_numbers
         # Customer's delivery address.
@@ -57,16 +57,16 @@ module Mindee
         # The address of the supplier or merchant.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :supplier_address
-        # List of company registrations associated to the supplier.
+        # List of company registration numbers associated to the supplier.
         # @return [Array<Mindee::Parsing::Standard::CompanyRegistrationField>]
         attr_reader :supplier_company_registrations
-        # The email of the supplier or merchant.
+        # The email address of the supplier or merchant.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :supplier_email
         # The name of the supplier or merchant.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :supplier_name
-        # List of payment details associated to the supplier.
+        # List of payment details associated to the supplier of the invoice.
         # @return [Array<Mindee::Parsing::Standard::PaymentDetailsField>]
         attr_reader :supplier_payment_details
         # The phone number of the supplier or merchant.
@@ -75,16 +75,16 @@ module Mindee
         # The website URL of the supplier or merchant.
         # @return [Mindee::Parsing::Standard::StringField]
         attr_reader :supplier_website
-        # List of tax line details.
+        # List of taxes. Each item contains the detail of the tax.
         # @return [Mindee::Parsing::Standard::Taxes]
         attr_reader :taxes
-        # The total amount paid: includes taxes, tips, fees, and other charges.
+        # The total amount of the invoice: includes taxes, tips, fees, and other charges.
         # @return [Mindee::Parsing::Standard::AmountField]
         attr_reader :total_amount
-        # The net amount paid: does not include taxes, fees, and discounts.
+        # The net amount of the invoice: does not include taxes, fees, and discounts.
         # @return [Mindee::Parsing::Standard::AmountField]
         attr_reader :total_net
-        # The total tax: includes all the taxes paid for this invoice.
+        # The total tax: the sum of all the taxes for this invoice.
         # @return [Mindee::Parsing::Standard::AmountField]
         attr_reader :total_tax
 

data/lib/mindee/product/invoice/invoice_v4_line_item.rb

@@ -5,13 +5,13 @@ require_relative '../../parsing'
 module Mindee
   module Product
     module Invoice
-      # List of line item details.
+      # List of all the line items present on the invoice.
       class InvoiceV4LineItem < Mindee::Parsing::Standard::FeatureField
         include Mindee::Parsing::Standard
         # The item description.
         # @return [String]
         attr_reader :description
-        # The product code referring to the item.
+        # The product code of the item.
         # @return [String]
         attr_reader :product_code
         # The item quantity

data/lib/mindee/product/invoice/invoice_v4_line_items.rb

@@ -5,7 +5,7 @@ require_relative 'invoice_v4_line_item'
 module Mindee
   module Product
     module Invoice
-      # List of line item details.
+      # List of all the line items present on the invoice.
       class InvoiceV4LineItems < Array
         # Entries.
         # @return [Array<InvoiceV4LineItem>]

data/lib/mindee/product/invoice_splitter/invoice_splitter_v1.rb

@@ -8,12 +8,12 @@ module Mindee
   module Product
     # Invoice Splitter module.
     module InvoiceSplitter
-      # Invoice Splitter V1 prediction inference.
+      # Invoice Splitter API version 1 inference prediction.
       class InvoiceSplitterV1 < Mindee::Parsing::Common::Inference
         @endpoint_name = 'invoice_splitter'
         @endpoint_version = '1'
-        @has_sync = false
         @has_async = true
+        @has_sync = false
 
         # @param prediction [Hash]
         def initialize(prediction)

data/lib/mindee/product/invoice_splitter/invoice_splitter_v1_document.rb

@@ -1,65 +1,61 @@
 # frozen_string_literal: true
 
 require_relative '../../parsing'
+require_relative 'invoice_splitter_v1_invoice_page_groups'
 
 module Mindee
   module Product
     module InvoiceSplitter
-      # Page Group for Invoice Splitter class
-      class InvoiceSplitterV1PageGroup
-        # @return[Array<Integer>]
-        attr_reader :page_indexes
-
-        # @return[Float, nil]
-        attr_reader :confidence
+      # Invoice Splitter API version 1.2 document data.
+      class InvoiceSplitterV1Document < Mindee::Parsing::Common::Prediction
+        include Mindee::Parsing::Standard
+        # List of page groups. Each group represents a single invoice within a multi-invoice document.
+        # @return [Mindee::Product::InvoiceSplitter::InvoiceSplitterV1InvoicePageGroups]
+        attr_reader :invoice_page_groups
 
-        # @param prediction[Hash]
-        def initialize(prediction)
-          @page_indexes = prediction['page_indexes']
-          @confidence = prediction['confidence'].nil? ? 0.0 : Float(prediction['confidence'])
+        # @param prediction [Hash]
+        # @param page_id [Integer, nil]
+        def initialize(prediction, page_id)
+          super
+          @invoice_page_groups = Product::InvoiceSplitter::InvoiceSplitterV1InvoicePageGroups.new(
+            prediction['invoice_page_groups'], page_id
+          )
         end
 
         # @return [String]
         def to_s
+          invoice_page_groups = invoice_page_groups_to_s
           out_str = String.new
-          out_str << ":Page indexes: #{@page_indexes.join(', ')}"
-          out_str
-        end
-      end
-
-      # Invoice Splitter V1 document prediction.
-      class InvoiceSplitterV1Document < Mindee::Parsing::Common::Prediction
-        # @return[Array<Mindee::Product::InvoiceSplitter::InvoiceSplitterV1PageGroup>]
-        attr_reader :invoice_page_groups
-
-        # @param prediction [Hash]
-        # @param _page_id [Integer, nil]
-        def initialize(prediction, _page_id = nil)
-          super(prediction, nil)
-          construct_invoice_page_groups_from_prediction(prediction)
+          out_str << "\n:Invoice Page Groups:"
+          out_str << invoice_page_groups
+          out_str[1..].to_s
         end
 
-        # Reconstructs the page groups of a prediction
-        # @param prediction [hash]
-        def construct_invoice_page_groups_from_prediction(prediction)
-          @invoice_page_groups = []
-          return unless prediction.key?('invoice_page_groups') && prediction['invoice_page_groups'].any?
+        private
 
-          prediction['invoice_page_groups'].each do |page_group_prediction|
-            @invoice_page_groups.append(InvoiceSplitterV1PageGroup.new(page_group_prediction))
-          end
+        # @param char [String]
+        # @return [String]
+        def invoice_page_groups_separator(char)
+          out_str = String.new
+          out_str << '  '
+          out_str << "+#{char * 74}"
+          out_str << '+'
+          out_str
         end
 
         # @return [String]
-        def to_s
+        def invoice_page_groups_to_s
+          return '' if @invoice_page_groups.empty?
+
+          line_items = @invoice_page_groups.map(&:to_table_line).join("\n#{invoice_page_groups_separator('-')}\n  ")
           out_str = String.new
-          out_str << "\n:Invoice Page Groups:"
-          if !@invoice_page_groups.nil? && @invoice_page_groups.any?
-            @invoice_page_groups.map do |page|
-              out_str << "\n  #{page}"
-            end
-          end
-          out_str[1..].to_s
+          out_str << "\n#{invoice_page_groups_separator('-')}"
+          out_str << "\n  |"
+          out_str << ' Page Indexes                                                             |'
+          out_str << "\n#{invoice_page_groups_separator('=')}"
+          out_str << "\n  #{line_items}"
+          out_str << "\n#{invoice_page_groups_separator('-')}"
+          out_str
         end
       end
     end

data/lib/mindee/product/invoice_splitter/invoice_splitter_v1_invoice_page_group.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative '../../parsing'
+
+module Mindee
+  module Product
+    module InvoiceSplitter
+      # List of page groups. Each group represents a single invoice within a multi-invoice document.
+      class InvoiceSplitterV1InvoicePageGroup < Mindee::Parsing::Standard::FeatureField
+        include Mindee::Parsing::Standard
+        # List of page indexes that belong to the same invoice (group).
+        # @return [Array<Integer>]
+        attr_reader :page_indexes
+
+        # @param prediction [Hash]
+        # @param page_id [Integer, nil]
+        def initialize(prediction, page_id)
+          super
+          @page_indexes = prediction['page_indexes']
+          @page_id = page_id
+        end
+
+        # @return [Hash]
+        def printable_values
+          printable = {}
+          printable[:page_indexes] = format_for_display(@page_indexes)
+          printable
+        end
+
+        # @return [Hash]
+        def table_printable_values
+          printable = {}
+          printable[:page_indexes] = @page_indexes.join(', ')
+          printable
+        end
+
+        # @return [String]
+        def to_table_line
+          printable = table_printable_values
+          out_str = String.new
+          out_str << format('| %- 73s', printable[:page_indexes])
+          out_str << '|'
+        end
+
+        # @return [String]
+        def to_s
+          printable = printable_values
+          out_str = String.new
+          out_str << "\n  :Page Indexes: #{printable[:page_indexes]}"
+          out_str
+        end
+      end
+    end
+  end
+end