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
- Open Tax jurisdictions → New jurisdiction.
- Enter required code and name (translatable; default locale required).
- Optionally set country (ISO 2-letter; stored uppercased), level (
country/state/region, default country), and region. - 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.