Countries
The Countries tab under Settings lists the countries your organisation transacts in. Each country carries defaults and the rules for its addresses.
The country code follows ISO 3166-1 alpha-2. The standards register lists it as complying. The tab itself accepts any two characters, so check the code before you save. Alpha-3 and numeric country codes are not carried.
| Column | What it tells you |
|---|---|
| Code | The two-letter country code |
| Country Name | The name people see |
| Dialling Code | The telephone prefix, without a plus sign |
| Currency | The currency a new account in this country starts with |
| Calendar | The holiday calendar a new account starts with |
| BDC | The business day convention a new account starts with |
| Postal Code Label | What the postal code is called on address forms |
| Postal Code Pattern | The shape a valid postal code must match |
| Postal Code Required | Whether an address must carry a postal code |
| Active | Whether people can pick the country |
Defaults for a new account
When you open an account, you pick a country first. The account then starts with that country’s currency, calendar and business day convention. You can still change each one on the account.
If only one country is listed, it is chosen for you. For the conventions, see business day conventions and holiday calendars.
Postal code rules
An address form checks the postal code against the country it names.
- If Postal Code Required is on, a blank postal code is refused.
- If a pattern is set, a postal code that does not match it is refused.
- The message uses the Postal Code Label. It reads “Postal code is required” or “Postal code is not valid for ZA”.
The pattern is a regular expression.
The South African retail template (za-retail, built on the za country layer) holds one country.
South Africa has code ZA, dialling code 27, currency ZAR and calendar SouthAfrica.
Its convention is ModifiedFollowing. Its postal code pattern is four digits, and a postal code is required.
Alex enters 2196 for a South African address, and it is accepted. Alex enters 21960, and it is refused.
Adding a country
- Open Settings and select Countries.
- Select the add button.
- Enter the Country Name and the two-character Code.
- Choose the Default Currency and the Default Calendar.
- Choose the Default Business Day Convention. It starts at ModifiedFollowing.
- Enter the postal code label, pattern and requirement if the country has them.
- Save.
If the code already exists, the add does nothing. The currency you choose must be one from the currencies tab.
What your organisation configures
- Which countries are listed. List only the countries you transact in.
- The defaults for each country. Currency, calendar and business day convention.
- The postal code rules. Label, pattern and whether a code is required.
- Which countries are active.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.