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.

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

  1. Open Settings and select Countries.
  2. Select the add button.
  3. Enter the Country Name and the two-character Code.
  4. Choose the Default Currency and the Default Calendar.
  5. Choose the Default Business Day Convention. It starts at ModifiedFollowing.
  6. Enter the postal code label, pattern and requirement if the country has them.
  7. 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

From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.