Finance

The Finance module is the accounting engine of Kooperacia. It handles income, expenses, monthly fee generation, payment collection, and financial reporting.

Finance Overview

Navigate to Finance in the sidebar. The main view shows two tabs:

Ledger — all income and expense entries.
Payments — resident payment records against issued fees.

The period selector at the top lets you filter by month, quarter, or custom date range.

Ledger Entries

Income Entries

Income entries record money received — monthly fees, parking charges, late-payment penalties, etc.

To add an income entry:

Click + New Entry → choose Income.
Select the date, category, and amount.
Optionally link to a unit (if it's a unit-specific payment).
Add a description and attach a receipt or document.
Click Save.

Expense Entries

Expense entries record money spent on behalf of the building — utilities, repairs, cleaning, insurance, etc.

To add an expense entry:

Click + New Entry → choose Expense.
Select the date, category (electricity, water, elevator maintenance, etc.), and amount.
Add the vendor/supplier name.
Attach a scanned invoice (PDF or image).
Click Save.

Editing and Deleting Entries

Click any entry row to open its detail view.
Click Edit to modify any field. Changes are logged with a timestamp.
Click Delete to remove the entry (requires manager or treasurer confirmation).

Fee Wizard

The Fee Wizard automates the monthly fee generation process — the most important financial operation in the system.

Running the Fee Wizard

Click Fee Wizard in the Finance toolbar.
Select the billing period (month and year).
Review the fee template applied to each entrance or unit.
Preview the generated fee amounts in the summary table.
Click Generate Fees to create fee entries for all applicable units.

The wizard checks for already-generated fees for the selected period. If fees exist, it shows a warning and lets you overwrite or skip.

Fee Templates

Fee templates define how charges are calculated:

Template Type	Calculation Method
Fixed per unit	Same amount for every unit in the entrance.
Per square meter	Unit area × configured rate.
Custom per unit	Each unit has its own manually set amount.
Mixed	Combination of base + per-m² component.

Templates are configured under Building Management → Entrances → Fee Template.

After generating fees, the Fee Summary modal shows:

Total amount issued this period.
Breakdown by entrance.
Units with zero fees (fee-exempt).
Estimated collection rate based on historical payment patterns.

Payments

Viewing Payment Status

Navigate to Finance → Payments to see all units and their payment status for the selected period:

Status	Meaning
Paid	Full amount received.
Partial	Part of the fee has been paid.
Overdue	Payment due date has passed with no payment.
Pending	Fee issued, due date not yet reached.
Exempt	Unit marked fee-exempt for this period.

Recording a Manual Payment

When a resident pays cash or bank transfer:

Click the unit row.
Click + Record Payment.
Enter the amount, date, and payment method (cash, transfer, card).
Optionally add a reference number from the bank transfer.
Click Save — the unit's balance is updated immediately.

Online Payments

If a payment provider is configured (ePay, Stripe, Iris Solutions), residents can pay directly from their account. Online payments are automatically recorded and reconciled.

Payment History

Each unit has a full Payment History showing all payments ever made:

Date, amount, method, and recorded-by user.
Running balance.
Printable receipt for each transaction.

Income Editor

The Income Editor is a bulk tool for quickly entering multiple income items at once:

Click Income Editor in the Finance toolbar.
A spreadsheet-style grid appears with one row per unit.
Enter the payment amount for each unit that paid.
Set a shared date and description for all entries.
Click Save All — all entries are saved in a single operation.

This is especially useful for cash collection days where the treasurer receives payments from many residents simultaneously.

Reports

Period Summary

Select a period and click Reports → Period Summary to see:

Total income, total expenses, net balance.
Breakdown by category.
Collection rate (% of issued fees that were paid).

Debtor Report

Reports → Debtors lists all units with outstanding balances:

Sorted by amount owed (highest first).
Shows how many months overdue.
Includes contact details for follow-up.
Exportable as PDF or CSV.

Annual Financial Statement

Reports → Annual Statement generates a full-year income and expense report suitable for presenting at the annual general meeting (AGM):

Monthly breakdown.
Category totals.
Year-over-year comparison.
Export to PDF.