Appearance
Legal entities and currencies
Also known as
- multi-entity
- multi-company
- legal entity
- company code
- subsidiary
- currency
- multi-currency
- FX
- foreign exchange
- exchange rate
One Roari ERP organisation can hold several legal entities (companies), each with its own base currency, fiscal calendar and books, and every document can be in any currency. This page explains how entities, currencies, exchange rates and periods work across modules, and where you choose them.
The demo organisation Acme Industries has two entities: HQ · Acme Industries (USD) and EU · Acme Europe (EUR).
The building blocks
| Concept | What it is | Where you set it up |
|---|---|---|
| Organisation | Your whole Roari ERP account, with its name, logo and an organisation-wide base currency. | Company |
| Legal entity | A company that keeps its own books: code, name, legal name, Base currency, Fiscal year starts in, tax IDs, address. One is the Default entity. | Legal entities |
| Currency | Each currency you trade in, with its symbol and Decimals. | Currencies |
| Exchange rate | The rate from one currency to another on a date, of a Rate type: Spot, Average or Closing. | Exchange rates |
| Fiscal year and periods | Each entity's years and monthly periods, each open, closed or locked. | Fiscal years & periods |
Where entities and currencies appear
| Module | Entity | Currency |
|---|---|---|
| Finance | Every journal entry, bill, invoice, payment, receipt, bank account and fixed asset belongs to one entity. Pick the entity in the top bar. | Documents in any currency; ledger amounts also kept in the entity's base currency. |
| Inventory | Each warehouse belongs to an entity; stock postings go to that entity's books. | Stock is valued in the entity's base currency. |
| Procurement and Sales & CRM | Orders post through the warehouse and finance documents of their entity. | Orders, quotes, price lists and vendor prices in the partner's currency. |
| People | Pay runs post payroll to the entity of the pay group. | Salaries in the employee's currency. |
| Planning | Scenarios and budgets per entity. | Base currency of the entity. |
| Reports | Most financial reports have an Entity parameter; empty means All entities. | Base currency; consolidated reports in the group currency. |
Work in one entity
On finance pages the top bar shows two lists:
- Select the Legal entity list (for example HQ · Acme Industries) and choose the entity.
- Select the Period list (for example Oct 2026) and choose the month.
Finance lists, dashboards and new finance documents follow this choice. Roari ERP remembers it in this browser until you change it. When you have not chosen one, the first entity is used.
TIP
New documents created where you do not choose an entity (for example from another module) go to the organisation's Default entity, set in Legal entities.
Record a document in a foreign currency
- On the document (an invoice, a bill, a journal entry), pick the Currency, for example
EURon a HQ document. - Enter the amounts in that currency.
- Optionally type the Exchange rate to the entity's base currency. Left empty, Roari ERP takes the Spot rate on the document date (or the latest rate before it).
When posted, each ledger line keeps the document amount and the base-currency amount. When the customer or vendor pays at a different rate, the difference posts to Realised FX gain/loss.
If no rate exists, posting is refused with: "No EUR→USD exchange rate on or before date; add one in Finance settings → Exchange rates".
Add an exchange rate
- Open FinanceSettingsExchange rates and select New.
- Pick From and To, the Rate type and the Date.
- Type the Rate: 1 unit of From equals rate units of To.
- Save.
| Rate type | Used for |
|---|---|
| Spot | Converting documents on their date. |
| Average | Translating profit and loss in consolidation. |
| Closing | Revaluing foreign balances at period end and translating the balance sheet in consolidation. |
You can also load rates in bulk with an import (Exchange rates in Imports and exports).
Revalue foreign balances at month end
- Open FinanceFX revaluation with the entity chosen in the top bar.
- Set the Revaluation date (usually the period end) and the Rate type (Closing).
- Select Preview. Each account with a foreign balance shows its Foreign balance, Booked value, Rate, Revalued value and Difference.
- Select Post revaluation.
Posts when you select Post revaluation (reversed automatically the next day)
| Account | Debit | Credit |
|---|---|---|
| Foreign-currency balance (receivable, payable, bank) | ✓ (gain on an asset) | ✓ (loss on an asset) |
| Unrealised FX gain/loss | ✓ (loss) | ✓ (gain) |
Intercompany and consolidation
- Stock cannot move between entities by transfer. A transfer between warehouses of different entities is refused ("use an intercompany sale instead"). Sell from one entity to the other.
- Intercompany journals post a matching entry in both entities at once, with due-to and due-from accounts. See Intercompany.
- Consolidation adds up the entities of a group in the group currency: balance sheets at the Closing rate, profit and loss at the Average rate, the difference as a translation adjustment (CTA), with intercompany balances eliminated. See Consolidation and the consolidated trial balance, profit and loss and balance sheet in the Reports catalogue.
Periods: open, closed, locked
| Status | Meaning | What you can do next |
|---|---|---|
| open | Postings dated in the period are accepted. | Close period, Lock period |
| closed | No postings; the period can still be reopened. | Reopen period, Lock period |
| locked | Final: no postings. | Reopen period (needs Permission: finance.period.reopen) |
Posting into a closed or locked period is refused with "Period 2026-09 is closed; postings are not allowed". Periods are per entity: closing HQ's September does not close EU's. See Period close and Close and report.
Permissions
| What | Permission |
|---|---|
| See entities, currencies, rates and periods | Permission: finance.settings.view |
| Change them | Permission: finance.settings.manage |
| Close and lock periods, run FX revaluation | Permission: finance.close.view and the close permissions of Period close |
| Reopen a period | Permission: finance.period.reopen |
Limits and gotchas
- An entity's base currency cannot change once entries exist ("The base currency cannot change once entries exist"). Set it right when you create the entity.
- Keep Spot rates current: documents without a rate on or before their date cannot post.
- Warehouses, bank accounts and pay groups each belong to one entity; choose them with the entity in mind.
- The organisation's base currency (in Company) is used by cross-entity dashboards; each entity still keeps its own books in its own base currency.
