Foundation
Ledger (append-only double-entry journal)
This manual is a draft and may change.
What it does
Ledger is your permanent, double-entry record of money in and out. Each sale, refund or donation is recorded once and balanced, and can never be edited; mistakes are fixed by a reversing entry.
Who uses it
Your bookkeeper or accountant reads it, once they have been given the Ledger viewer role. Other apps such as online checkout write to it automatically. Staff do not type into it directly.
Setup
- Ask your platform team to install Ledger (append-only double-entry journal). There is no install button in the admin yet.
- It installs these first, automatically: Companies / org units, Sequences, Money, currencies and tax codes.
- Ledger is installed together with Companies, Sequences and Money and Tax.
- A starter list of accounts is available: Cash, Cash clearing, Accounts receivable, Sales tax payable, Opening balance equity, Revenue, Donations (unrestricted and restricted) and Payment processing fees.
- Ask your accountant whether you need extra accounts.
Admin tasks
Ledger
- Open Ledger (you need the Ledger viewer role). The screen is for reading only.
- Trial balance shows, for each currency, every account with its debit, credit and balance, and a total.
- Journal (latest 50) lists the most recent entries. Each shows its number, date, source, memo and lines; reversals are marked Reversal with the reason.
- To correct something, reverse the entry in the app that posted it; this screen cannot change anything.
How entries appear
- When an online order is paid, the ledger records cash clearing, revenue and sales tax for it.
- When an order is refunded, the entry is reversed, or a correcting entry is added for a partial refund.
Fixing a mistake
- Entries can never be edited or deleted.
- A reversal with a reason (up to 255 characters) is posted instead. A reversal can happen only once per entry.
Nightly check
- Every night the ledger checks that all entries balance. Any problem is reported, never silently fixed.
Member view
Members do not see this app.
Styling it to your brand
Every app takes its colours, fonts and corners from the brand profile you enter once in the Brand intake on 1vsm.com. It applies to every app automatically, so there is nothing to set up for this one.
Troubleshooting
- An entry was refused as unbalanced: total debits and total credits must match in each currency.
- An entry was refused as having too few lines: it needs at least two.
- An account is refused: it must exist on your site and not be archived.
- A repeat posting was refused as a conflict: the same reference was used with different amounts.
- A reversal was refused: it needs a reason and the entry must belong to your site.
- The nightly check reports a problem: ask your platform team; an incorrect entry is corrected by a reversal.
FAQ
Can I edit a past entry? No. Reverse it and post a new one.
Does posting twice double count? No. A repeat of the same reference returns the same entry.
Which currencies are supported? Standard currencies in whole minor units such as cents.
Is there a report screen? There is a read-only trial balance and journal. Profit and loss and other statements are not built yet.
What to connect
Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.