Skip to content

Create a tax jurisdiction

Goal

Add a country, state, or region jurisdiction for determination rules.

Who it is for

tax.manage.

Preconditions

  • Module statutory_compliance on.
  • Unique code (max 64) planned for the tenant.

Steps

  1. Open Tax jurisdictions → New jurisdiction.
  2. Enter required code and name (translatable; default locale required).
  3. Optionally set country (ISO 2-letter; stored uppercased), level (country / state / region, default country), and region.
  4. Save. New rows are active by default.

Result

Toast Jurisdiction created. The jurisdiction can be selected on determination rules.

Hard stops

  • Duplicate or invalid code / missing default-locale name → 422.
  • country not exactly 2 characters → 422.

BlueMatrix Help — product documentation for tenants