Feature docs

Accounting app on Vareons: install, expenses, ledger, and assets

The accounting app is the id finance marketplace card opening /dashboard/finance: it toggles between a Simple mode for daily expenses by category, wallet, and status, and an Advanced mode with ledger, receivables, payables, cash flow, budgets, assets, and reports.

Last verified: 2026-09-19

The app installs from the /dashboard/apps marketplace with an Install button on the "Accounting" card described as daily bookkeeping and financial reports, after which an Open button leads to /dashboard/finance. The card carries a Free badge.

The page has a mode toggle — Simple with a zap icon and Advanced with a sparkles icon — and a "Finance Management" title with a per-mode description. The Simple mode (default) lists categories: general expenses, salaries, rent, electricity, water, internet, transportation, maintenance, marketing, purchases, and other, with add, edit, and delete expense buttons plus search and filters for category, wallet, status, and date. The Advanced mode has eight tabs: overview, ledger, receivables, payables, cash flow, budgeting, assets, and reports.

The simple flow fetches stats by period and expenses by filter through GET simple/stats and GET simple/expenses with pagination, and every create, update, or delete goes through POST, PUT, and DELETE on simple/expenses followed by refetching the list and stats. The advanced flow fetches seven parallel routes on toggle — overview, accounts, invoices, bills, cash flow, budgets, and assets — with a journal-entry dialog, report generation, and quick insights.

Simple expenses are stored in the Expense model, accounts in Account, sales invoices in Invoice, purchase bills and vendors in Bill and Supplier, and postings in JournalEntry, with every financial activity written to ActivityLog and AuditLog through the lib/finance/activityLogger.js helper that never throws. Currency comes from the tenant currency formatter in lib/theme with user data from lib/user/getUserInfo.

Setup steps in Vareons

  1. Install the app from the marketplace

    Open /dashboard/apps, press Install on the accounting card, then press Open to reach /dashboard/finance.

  2. Record a daily expense

    From Simple mode press add expense, pick the category, wallet, amount, and date, then save.

  3. Filter and review stats

    Use search and category, status, and period filters, and review the stats cards refreshed after each operation.

  4. Switch to Advanced mode

    Toggle to Advanced to open the ledger, receivables, payables, cash flow, budgets, and assets, and add journal entries from the dedicated dialog.

  5. Generate a report

    From the Reports tab generate the needed report and review quick insights before the monthly close.

Frequently asked questions

Is the accounting app free?

Yes, the card carries a Free badge with free billing type, and installation needs no purchase.

What is the difference between Simple and Advanced?

Simple covers daily expenses by category and wallet; Advanced is full bookkeeping: ledger, AR/AP, cash flow, budgets, assets, reports, and journals.

What expense categories exist?

General, salaries, rent, electricity, water, internet, transportation, maintenance, marketing, purchases, and other.

Is financial activity logged?

Yes, every operation is written to ActivityLog and AuditLog through the logging helper without blocking the operation if logging fails.

Where does the currency come from?

From the tenant currency formatter following your store settings, so amounts render in your local currency automatically.

Troubleshooting

1) Stats stale: refetch; every operation reloads the list and stats together. 2) Empty advanced tab: toggle back to Simple and return; the seven-way parallel fetch needs a stable connection. 3) Rejected expense: complete category, amount, and date; the server validates fields. 4) Report not generating: confirm movements exist in the requested period.

Important limitations

• Simple mode is expenses only, without sales and purchase invoices. • Budgets are yearly and assets follow the available routes. • The logging helper never throws, so a rare log may be skipped silently. • Reports depend on complete movement entry.

Related links

تواصل معنا على واتساب