Manual · Engineering
Manual14 min read

Finance foundation — the four prerequisites

Chart of Accounts, accounting periods, exchange rates and base currency. Nothing posts until these are right.

ForWorkspace ownerFinanceAdministrator

Why this chapter gates everything

Four things must exist before a single operational form will post. Get them right once and every later chapter works. Get them wrong and you will meet the two most common errors in the product.

#PrerequisiteMenuWhy operations needs it
1Chart of Accounts activeAccounting → Chart of AccountsGoods receipt, purchase invoice, sales invoice and demurrage all post to fixed accounts
2An OPEN accounting period covering todayAccounting → Accounting PeriodsNo posting can be dated outside an open period
3Exchange rates for foreign currenciesFinance → Exchange RatesForeign invoices, POs and demurrage convert to base currency at a stored rate
4Base currency chosenAdministration → Workspace SettingsAll report values convert to it

Watch

Two errors that always mean this chapter

If a posting fails with 'Missing chart-of-accounts entries for codes…' or 'No open accounting period found for date…', the operational form is not at fault. Fix the foundation here, then retry.

Chart of Accounts

A standard chart of accounts is seeded automatically when your workspace is created. Your job is to confirm the accounts exist and are Active before anything else. Nothing posts until they do.

CodeAccountTypeUsed by
1000CashASSETPetty cash, cash receipts and payments
1010BankASSETBank receipts and payments, prepaid and asset purchases
1100Driver Advance ReceivableASSETDriver advances
1150Intercompany Due-fromASSETIntercompany
1200Accounts ReceivableASSETSales invoices, receipts, demurrage
1300InventoryASSETGoods received
1400Prepaid ExpensesASSETPrepaid expenses
1500Accumulated DepreciationASSET (contra)Depreciation
1600Fixed AssetsASSETAsset acquisition and disposal
2000Accounts PayableLIABILITYPurchase invoices and payments
2050Goods Received Not Invoiced (GRNI)LIABILITYGoods receipt vs invoice
2100Accrued LiabilitiesLIABILITYAccruals
2150Intercompany Due-toLIABILITYIntercompany
2200Trade PayablesLIABILITYReserved
2300Tax PayableLIABILITYOutput VAT on sales
2310Input VATASSETRecoverable VAT on purchases
3000Retained EarningsEQUITYPeriod close
4000Sales RevenueREVENUESales invoices
4100Demurrage IncomeREVENUEContainer demurrage
5000Operating ExpensesEXPENSEExpenses, amortization, driver pay
5100Depreciation ExpenseEXPENSEDepreciation
5200Gain/Loss on Asset DisposalEXPENSEAsset disposal
9000SuspenseASSETUncategorised cashbook and petty cash

Accounting periods

Create a period — for example 2026-06, running 2026-06-01 to 2026-06-30 — and leave it OPEN. You need one open period covering the date of every transaction. Many teams create a full year as twelve monthly periods.

  • Periods cannot overlap.
  • A date must be covered by exactly one open period to post.
  • Closing a period is permanent for posting: no new entries, and the close writes a closing entry that moves profit or loss to Retained Earnings.

Rule

Opening a year

Create all twelve monthly periods at the start of the year and leave the current month open. Open the next month when you are ready to date entries in it.

Currencies and exchange rates

If you invoice or buy in a currency different from your base currency, add a rate dated on or before the transaction date.

  • The system uses the most recent rate on or before the date.
  • It can invert a stored reverse pair.
  • It throws an error if no rate exists for a genuine foreign conversion — it will not silently use 1.0.

Opening balances (migrating from another system)

If you are switching from another system, enter opening balances as a manual journal entry dated in the first open period: debit each asset, credit each liability and equity, and balance the difference to Retained Earnings (3000).

Manual journalAccounting → Double-Entry Journal

Foundation checklist

CheckDone when
Accounts activeEvery account in the table above exists and is Active
A period covers todayAn OPEN period includes the current date
Rates loadedEvery currency you transact in has a rate on or before today
Base currency confirmedThe workspace base currency matches your reporting currency

Note

Next

With the foundation in place, move to CH 03 to create the parties and locations your operations reference.