Changing an entity’s tax registration

An operating entity’s tax registration says where it pays tax and what kind of payer it is. Withholding on the interest it pays follows from both. You set them with Change Tax Registration.

What you set

Field What it is
Tax Jurisdiction The country the entity is taxed in, picked from your organisation’s countries.
Tax Reference Number The entity’s number with that country’s tax authority.
Withholding Payer Class The kind of payer the entity is, picked from the withholding regime’s payer classes. Leave it empty if no class applies.

The jurisdiction is stored as its two-letter ISO 3166-1 alpha-2 code, such as ZA. The picker shows the code with the country’s name: “ZA – South Africa”. Its register row is ISO 3166-1 alpha-2.

Change the registration

Example: Sam records that Woodgrove Bank is taxed in South Africa as a registered bank.

  1. Open the operating entity.
  2. Select Change Tax Registration.
  3. Under Tax Jurisdiction, pick ZA – South Africa.
  4. Enter the Tax Reference Number.
  5. Under Withholding Payer Class, pick Registered bank.
  6. Set the Effective Date.
  7. Select Apply.

The entity’s details show the jurisdiction and the payer class by name. If your organisation needs a second approver, the change waits for approval.

When the change is refused

What you picked What happens
A country with no statutory withholding rule Refused. The message names the country and points to Settings → Withholding.
A payer class that has been retired Refused. Pick an active class.
No jurisdiction Accepted. The entity has no tax jurisdiction yet.

For example, if the regime has no rule for Namibia, picking NA is refused with this message: “No statutory withholding rule for NA. The withholding regime lists its rules under Settings → Withholding; raise a rule for NA.”

Retired values stay on the entity

If a country or a payer class is retired after you chose it, the entity keeps it. Its details still show the name. The picker shows the retired value greyed out, so you cannot choose it again for another entity.

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.