Financial Reports

Financial reports provide you with a comprehensive overview of your business activity through interactive visualizations and detailed data on payments, taxes, and performance by period.

Overview

The reports module automatically displays data for the current fiscal period, configured in your company settings. Reports adapt according to your company type and currency settings.

Information Displayed

• Period totals: Total payments and taxes collected for the current period
• Time chart: Evolution of revenue and payments over multiple periods
• Detailed table: Invoice list with payment details by client
• Multi-currency support: Automatic conversion and display by currency

Fiscal Period Types

The system supports two types of fiscal periods:

Quarterly Reports

• 3-month periods (Q1, Q2, Q3, Q4)
• Display format: “1-2024” for first quarter 2024
• Chart by quarter

Monthly Reports

• One-month periods
• Display format: “032024” for March 2024
• Chart by month

Data and Metrics

Types of Data Displayed

For Companies with Tax

• Converted Total Invoiced: Total invoice amount in main currency
• Converted Total Payments: Total amount of payments received
• Tax Collected: VAT and other taxes collected

For Companies without Tax

• Total Invoiced: Total amount of invoices issued
• Total Payments: Total amount of payments received

Multi-Currency Support

When multi-currency support is enabled:

• Display in native currency for each transaction
• Automatic conversion to company’s main currency
• Separate totals by currency in charts
• Additional columns in tables

Data Visualization

Interactive Chart (LayerCake)

The main chart uses LayerCake technology to provide:

• Multi-series lines: One line for each metric
• Interactive tooltip: Details on hover over points
• Color legend: Clear identification of each series
• Zoom and navigation: Responsive interface

Series Colors

• Green (#06D001): Converted total invoiced
• Red (#FF204E): Converted total payments
• Purple (#5409DA): Tax collected
• Light green (#A0C878): Total invoiced by currency
• Pastel green (#B7F486): Total payments by currency

Detailed Table

The table presents data with:

• Adaptive columns: Adjustment according to company settings
• Responsive design: Optimized for mobile and tablet
• Period totals: Automatic summary rows
• Currency formatting: Display with currency symbols

Configuration and Settings

Required Settings

1. Fiscal Period: Defined in Company > Settings > Tax Information
2. Company Type: Determines tax display
3. Main Currency: For multi-currency conversions
4. Multi-Currency Support: Enables/disables advanced features

Company Types and Taxes

• Types 1-2: Companies without VAT (no tax display)
• Types 3+: Companies with VAT (full tax display)

Responsive Interface

Desktop Display

• Full-width chart (300px height)
• Table with all columns visible
• Horizontal legend below chart

Mobile Display

• Automatic chart adaptation
• Table in responsive mode with labels
• Totals reorganized in stacked cards

Empty Data Management

When no data is available:

• Display informative message with icon
• Explanation about absence of reports
• Suggestions for generating data

Technical Use Cases

Storybook Integration

The component is tested with different scenarios:

• Single-currency reports: Standard configuration
• Multi-currency reports: Conversion management
• Company without VAT: Simplified display
• Monthly period: Alternative display format
• Large data volumes: Performance and rendering

Data Structure

interface PaymentsReports {
  payment_period: string;        // "1-2024" or "032024"
  company_id?: number;
  client_id?: number;           // null for totals
  invoice_id?: number;
  number?: string;              // Invoice number
  total_invoiced: number;       // Invoiced amount
  total_payments: number;       // Paid amounts
  tax_payments: number;         // Tax collected
  currency_id: number;          // Transaction currency
  converted_total_invoiced: number;    // Converted to main currency
  converted_total_payments: number;    // Converted to main currency
  converted_tax_payments: number;      // Converted to main currency
}

Financial reports are an essential tool for managing your business activity. Once the fiscal period is properly configured, they provide you with a clear and precise view of your financial performance, adapted to your company type and specific needs.