1. Overview
The Finance module is the ERP general ledger, treasury, and partner sub-ledger system. It covers:
| Area | Capabilities |
|---|---|
| Master data | Currencies, rates, chart of accounts, fiscal periods, voucher types, tax codes, dimensions |
| Journals | Manual journal entries with approval and posting |
| Treasury | Cash boxes, bank accounts, cheques, payment/receipt vouchers |
| Partners | Customer/vendor sub-ledgers, credit/debit notes, aging, statements |
| Control | Budgets vs actual, bank reconciliation, year-end closing |
| Reporting | GL, trial balance, financial statements, dashboard |
| Integration | Auto-posted journals from Sales, Purchasing, Manufacturing, and internal treasury documents |
2. Getting started
2.1 Recommended setup order
- Currencies and exchange rates
- Chart of accounts
- Fiscal year and periods
- Journal voucher types
- Tax codes
- Financial dimensions and mandatory policies
- Treasury cash boxes and bank accounts
- Customer and vendor sub-ledgers
- Then journals, payment vouchers, budgets, reconciliations
2.2 Main navigation
| Menu | Path | Purpose |
|---|---|---|
| Overview | /finance/overview |
Dashboard |
| Chart of accounts | /finance/chart-of-accounts |
Account maintenance |
| Account tree | /finance/account-tree |
Hierarchical view |
| Voucher types | /finance/voucher-types |
Numbering prefixes and kinds |
| Journal entries | /finance/journal-entries |
Manual journals |
| Financial dimensions | /finance/financial-dimensions |
Analytic dimensions |
| General ledger | /finance/general-ledger |
Account movements |
| Fiscal periods | /finance/fiscal-periods |
Open/close periods and year |
| Subsidiary customers | /finance/subsidiary-customers |
AR partners |
| Subsidiary vendors | /finance/subsidiary-vendors |
AP partners |
| Partner notes | /finance/partner-notes |
Credit/debit notes |
| Bank accounts | /finance/treasury-banks |
Banks |
| Cash boxes | /finance/treasury-cash |
Cash |
| Checks | /finance/treasury-checks |
Cheques |
| Receipt / payment vouchers | /finance/payment-vouchers |
Cash/bank receipts and payments |
| Budgets | /finance/budgets |
Budget plans and variance |
| Financial statements | /finance/financial-statements |
BS / P and L / cash flow |
| Partner aging | /finance/partner-aging |
Aging buckets |
| Partner statement | /finance/partner-statement |
Partner ledger statement |
| Accounting reports | /finance/accounting-reports |
Trial balance |
| Bank reconciliation | /finance/bank-reconciliations |
Bank vs book |
| Currency rates | /finance/currency-rates |
Exchange rates |
| Tax codes | /finance/tax-codes |
VAT and tax definitions |
3. Currencies and exchange rates
Currencies
| Field | Meaning |
|---|---|
| Code / name / symbol | Identity |
| Base currency | Only one base currency; cannot delete it |
| Decimal places | Rounding precision |
| Active | Available for use |
Exchange rates
| Field | Meaning |
|---|---|
| Currency | Foreign currency |
| Rate date | Effective date |
| Rate | Conversion to base |
| Default for day | Preferred rate for that day |
When posting a journal in a non-base currency, the system uses the rate you enter, otherwise the latest rate on or before the entry date. Missing rates block posting.
4. Chart of accounts
Accounts form a tree of header and posting nodes.
| Concept | Values |
|---|---|
| Node type | Header or Posting |
| Category | Asset, Liability, Equity, Revenue, Expense |
| Balance nature | Debit or Credit |
| Control account | If yes, not directly postable on lines |
| Active / level / sort | Structure and display |
Posting rule: only active Posting accounts that are not control accounts may appear on journal lines.
Delete is blocked if the account has children or general-ledger movements. Tree view can optionally include balances.
Typical seeded posting accounts include cash, banks, AR, AP, VAT, retained earnings, sales revenue, and expense accounts used by integration.
5. Fiscal years and periods
Fiscal year
Year number, name, start/end dates, open flag, optional closing journal link.
Fiscal period
Belong to a year; code/name; type Monthly, Quarterly, or Yearly; start/end; closed flag and audit fields.
Rules:
- Posting requires an open period and open year.
- Closing the year closes remaining open periods and can post a Closing voucher to retained earnings when P and L balances exist.
- Year reopen reverses the closing journal when present.
6. Voucher types
Journal voucher types control numbering and document kind.
| Field | Meaning |
|---|---|
| Code / name / prefix | Identity and number prefix |
| Kind | Journal, Payment, Receipt, Transfer, Opening, Closing |
| Next number / fiscal year | Sequence allocation |
| Active | Available |
Numbers typically look like {Prefix}-{FiscalYear}-{NNNN}. Seeded types often include JV, PV, RV, TV, OV, CV. Payment/receipt vouchers use PV/RV kinds.
7. Tax codes
| Field | Meaning |
|---|---|
| Code / name | Identity |
| Tax kind | Output or Input |
| Rate | 0–100 percent |
| GL account | Where tax posts |
| Active | On/off |
Used on partner notes and by Sales/Purchasing posting amounts. Seeded VAT-out / VAT-in codes commonly map to output/input VAT accounts.
8. Financial dimensions
Analytic tags on journal lines and payment vouchers.
| System dimension | Examples |
|---|---|
| Region, Branch, Cost Center, Project | Organizational analytics |
| Employee, Cash Box, Partner | Operational links |
Maintain types, values (tree), derivation rules, and mandatory policies per voucher type. Missing a mandatory dimension on a line blocks save/post.
9. Journal entries
Manual (and integration) double-entry documents.
Header fields
Voucher type, number, entry date, description, status, fiscal period, currency, exchange rate, totals, approval/posting audit, optional reverse link, source module/document.
Lines
Line number, account, description, debit or credit, foreign amounts, line rate, dimensions.
Statuses
| Status | Meaning |
|---|---|
| Draft | Editable |
| Pending approval | Submitted for approval |
| Approved | Ready to post |
| Posted | Written to GL |
| Cancelled | Abandoned |
Key rules
- Debits must equal credits and totals must be greater than zero.
- A line cannot have both debit and credit, or negatives.
- Accounts must be postable.
- Period/year must be open.
- There is no unpost; corrections use Reverse.
- Integration documents are often created already Approved and Posted.
10. Payment and receipt vouchers
Treasury documents that move money between partners and cash/bank.
| Kind | Partner side |
|---|---|
| Receipt | Customer |
| Payment | Vendor |
| Field | Meaning |
|---|---|
| Date / number | Document identity |
| Partner | Sub-ledger partner |
| Treasury kind | Cash box or bank account |
| Treasury account | Selected cash/bank |
| Amount / currency / rate | Value |
| Allocations | Apply to open invoices/notes |
| Dimensions | Analytic tags |
| Status | Draft, Posted, Cancelled |
Posting pattern: Receipt debits treasury and credits partner; Payment debits partner and credits treasury. Allocation totals cannot exceed voucher amount. Unpost requires journal reverse permission.
11. Treasury
Cash boxes and bank accounts
| Entity | Extra fields |
|---|---|
| Cash box | Code, name, GL account, currency, active |
| Bank account | Plus bank name and account number |
Link each treasury account to a posting GL account for automatic journals.
Cheques
| Field | Meaning |
|---|---|
| Number / direction | Issued or Received |
| Status | Pending, Cleared, Bounced, Cancelled, Endorsed |
| Amount / date | Value |
| Bank / partner | Optional links |
| Journal entry | Created when cleared |
Cheques can allocate to open partner documents within the cheque amount.
12. Bank reconciliation
Reconcile bank statement activity to book GL movements for a bank account that has a GL link.
| Field | Meaning |
|---|---|
| Bank account | Target bank |
| Statement date / balance | Bank statement |
| Book balance | From GL |
| Difference | Statement vs book |
| Status | Open or Reconciled |
Workspace actions: add/delete statement lines, match/unmatch to GL, import statement, auto-match, then Reconcile.
13. Partner sub-ledgers and notes
Partners
| Type | Use |
|---|---|
| Customer | Accounts receivable |
| Vendor | Accounts payable |
Fields: code, name, contact, optional GL account, active. Transactions track invoices, payments, and notes with open amounts and closed flags.
Partner notes
Credit notes and debit notes with subtotal, tax, total, optional tax code, status Draft / Posted / Cancelled. Posting creates a journal and sub-ledger movement.
14. Budgets
| Field | Meaning |
|---|---|
| Code / name | Budget identity |
| Fiscal year | Scope |
| Status | Draft, Active, Closed |
| Lines | Account, optional period, dimensions, budget amount |
Actions: activate, close, copy, and budget vs actual with variance amount and percent against GL actuals.
UI: budget list, detail, and variance screens.
15. General ledger and statements
General ledger
Posted journals write movements with account, date, journal reference, debit/credit, and running balance. Browse by account.
Trial balance
Opening, period, and closing debit/credit totals for a selected range.
Financial statements
| Statement | Content |
|---|---|
| Balance sheet | Assets, liabilities, equity |
| Profit and loss | Revenue and expenses |
| Cash flow | Operating / Investing / Financing sections |
| Dimension balances | Analytic cuts |
| Currency revaluation | Preview/post FX revaluation |
16. Partner aging and statements
Aging
Open partner transactions bucketed as Current, 1–30, 31–60, 61–90, and Over 90 days.
Partner statement
Opening balance, movement lines, and closing balance for a partner; multi-partner book views are available for ledger review.
17. Dashboard
Overview metrics such as:
- Counts of accounts, journals, posted/pending documents
- Banks, cash boxes, customers, vendors, open cheques
- Key balances and YTD net income
- Recent journal entries
Route: /finance/overview.
18. Integration with other modules
| Source | Typical effect |
|---|---|
| Sales invoice | AR, revenue, VAT; sub-ledger invoice |
| Purchase invoice | AP, expense, VAT; sub-ledger invoice |
| Payment / receipt voucher | Treasury vs partner |
| Cheque clear | Treasury journal |
| Partner credit/debit note | Note journal + sub-ledger |
| Manufacturing production cost | Inventory / WIP / FG / variance accounts |
| Year-end closing | Closing voucher to retained earnings |
Not auto-posted today: Payroll and Inventory modules do not call Finance posting for their own documents; related COA accounts may still exist for manual or manufacturing use.
Reversing an invoice posting is blocked if payments have already reduced the open amount.
19. Permissions summary
Permission group: Finance.
| Resource | Key abilities |
|---|---|
| Chart of accounts | Create, Update, Delete |
| Financial dimensions | Create, Update, Delete |
| Currencies / exchange rates | CRUD |
| Voucher types | CRUD |
| Fiscal periods | Create, Close, Reopen |
| Journal entries | CRUD, Approve, Post, Reverse |
| Payment vouchers | CRUD, Post |
| Partner sub-ledgers | CRUD |
| Bank accounts / cash boxes / cheques | CRUD |
| Budgets | CRUD |
| Bank reconciliations | Create, Update, Reconcile |
| Partner notes | CRUD, Post |
| Tax codes | CRUD |
| General ledger / Reports / Dashboard | Read access groups |
Separate Approve / Post / Reverse rights so makers and checkers can be split. Unposting payment vouchers relies on journal Reverse.
Appendix A — Quick procedures
A.1 Post a manual journal
- Ensure period is open and accounts/dimensions are ready.
- Create journal entry with balanced lines.
- Submit if required, then Approve.
- Post to write GL.
- If wrong, Reverse rather than editing the posted document.
A.2 Record a customer receipt
- Create Receipt voucher for the customer and cash/bank.
- Allocate to open invoices as needed.
- Post — JE and sub-ledger update.
- Use partner statement/aging to verify.
A.3 Clear a cheque
- Register cheque as Pending.
- Set status to Cleared when banked — posts JE.
- If bounced, status Bounced reverses the posting.
A.4 Close the fiscal year
- Close remaining periods.
- Preview year-end closing if available.
- Close fiscal year — generates closing journal when needed.
- Reopen only if you must reverse the closing entry.
A.5 Reconcile a bank account
- Ensure bank has a GL account.
- Create reconciliation for statement date.
- Import/enter lines and match to GL.
- Reconcile when difference is explained.
Appendix B — Operating notes
| Topic | Guidance |
|---|---|
| Corrections | Reverse posted journals; do not expect Unpost on JE |
| Mandatory dimensions | Configure per voucher type before go-live |
| Integration docs | Often appear already Posted with source document link |
| Base currency | Protect the single base currency |
| Control accounts | Use headers/control for structure; post only to posting accounts |
Appendix C — Document control
| Item | Value |
|---|---|
| Title | Finance Module User Guide |
| Source of truth | modules/finance and frontend/src/app/modules/finance |
| Format | Markdown + Mermaid (PDF edition embeds rendered figures) |
| Screenshots | Not included (by design) |
This guide describes functional capabilities of the Finance module as implemented in the Vertex ERP codebase. UI labels may appear in English or Arabic depending on language settings.