Enable supported foreign currencies for a business unit

Purpose

A unit can accept foreign-currency work with explicit choices for rates and missing prices.

How It Works

The controller enables foreign-currency work on the chosen unit. They select the currencies the unit uses and review each currency’s pricing and rate choices. Account editors then use that configured context. Rate maintenance supplies the quotes needed for subsequent work. Switching a currency off can fail when existing accounts or rates depend on it. Staff remove those dependencies before trying again. Concurrent changes must preserve the same valid accounting context.

Relationships

Foreign-currency accounts and rate maintenance depend on this enabled set.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes: Single-currency operation rejects foreign-currency work using the legacy treatment.Enabled foreign currencies carry explicit sourcing and missing-price choices.Existing account and rate dependencies protect their currencies from removal.
Surfaces: consoleapi
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R1services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D2services-accounting:docs/architecture/accounting-2.0/02-decisions.md#P-3

Controls

27 controls apply, from the corpus control catalogue.

TC-IAM-001 TC-IAM-002 TC-IAM-004 TC-IAM-005 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-AZ-005 TC-AZ-006 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004 TC-CRY-001 TC-DAT-001 TC-DAT-002 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-PI-001 TC-PI-003 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

Key	Checked at	Scope
`accounting.business-units.update`	api	tenant
`accounting.business-units.read`	api	tenant

Business Rules

9 rules, 7 to be proved before approval. A rule's product intent is derived from its origin: 9 confirmed by a product decision, the rest inheriting this capability's confirmed.

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Confirmed	Multicurrency starts disabled; enabling it requires a supported currency, and the supported set takes effect only while the switch is enabled. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R1 proved by `ATS-ACC-BKS-002-01`, `TST-ACC-BKS-074`	validation	api, service, console	test services-accounting:modules/books/tests/integration/services/persistence/business-units.integration.spec.js#refuses Enable Multicurrency on a create with no supported currency, in Rhythm 1.0’s words
`02`must prove Confirmed	A unit with multicurrency disabled refuses non-base currencies for accounts, prices, transactions and rates using the carried-forward refusal message. ✗ A conflicting configuration receives the stated refusal. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R1 proved by `ATS-ACC-BKS-002-02`, `TST-ACC-BKS-173`	policy	service	test services-accounting:modules/books/tests/unit/rules/multi-currency-rules.spec.js#refuses a foreign currency when the flag is off, with 1.0’s sentence
`03`must prove Confirmed	The supported set contains at most 200 offered currencies, without duplicates or the unit’s base currency. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D2 proved by `ATS-ACC-BKS-002-03`, `ATS-ACC-BKS-002-10`, `TST-ACC-BKS-046`, `TST-ACC-BKS-074`	validation	api, service, database	test services-accounting:modules/books/tests/e2e/business-units.e2e.spec.js#answers 400 to a supported currency named twice, in Rhythm 1.0’s words
`04`must prove Confirmed	Each supported currency chooses table or provider rates and calculated or prohibited missing-price handling, defaulting to table and calculate; the base currency has neither setting. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D2 proved by `ATS-ACC-BKS-001-14`, `ATS-ACC-BKS-002-04`, `ATS-ACC-BKS-002-15`, `TST-ACC-BKS-053`, `TST-ACC-BKS-063`, `TST-ACC-BKS-074`	policy	api, service, database	test services-accounting:modules/books/tests/integration/services/persistence/business-units.integration.spec.js#answers each supported currency with its settings, the defaults for one that stated none, and the codes beside them
`05`must prove Confirmed	Removing a supported currency or disabling multicurrency is refused while accounts or rates use it, with the unit, currency and dependent kinds identified; disabling an unused set clears it. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R1 proved by `ATS-ACC-BKS-002-05`, `ATS-ACC-BKS-002-12`, `ATS-ACC-BKS-002-13`, `ATS-ACC-BKS-007-10`, `TST-ACC-BKS-005`, `TST-ACC-BKS-046`, `TST-ACC-BKS-067`, `TST-ACC-BKS-074`	invariant	service, database	test services-accounting:modules/books/tests/e2e/business-units.e2e.spec.js#answers 409 naming the currency, the unit and the kinds of account that use it
`06`must prove Confirmed	GL, bank and merchant accounts accept only currencies enabled for their business unit. ✗ A conflicting configuration receives the stated refusal. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D2 proved by `ATS-ACC-BKS-002-06`, `ATS-ACC-BKS-002-13`, `ATS-ACC-BKS-002-14`, `TST-ACC-BKS-005`, `TST-ACC-BKS-045`, `TST-ACC-BKS-055`, `TST-ACC-BKS-056`	validation	api, service, database	test services-accounting:modules/books/tests/e2e/gl-accounts.e2e.spec.js#answers 400 to a currency the unit is not enabled for, in Rhythm 1.0’s words
`07` Confirmed	When codes and detailed currency settings are both supplied, the codes define membership and the matching settings define each member’s behaviour.	policy	service	test services-accounting:modules/books/tests/integration/services/persistence/business-units.integration.spec.js#lets the codes govern when both are sent (the console’s round trip), the settings applying to the codes they name
`08`must prove Confirmed	An account creation and concurrent removal of its currency cannot both succeed with the account left in an unsupported currency. proved by `ATS-ACC-BKS-002-07`, `TST-ACC-BKS-006`	invariant	database	test react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0007.spec.ts#ACT-ACC-0007
`09` Confirmed	The console displays supported currencies while multicurrency is enabled and asks for confirmation before disabling it and clearing the set. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R1	policy	console	documented services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R1

Scenarios

Id	Given	When	Then	Provenance
`01`	A unit needs Canadian-dollar and euro trading.	The controller enables both currencies and selects provider rates with prohibited base-price calculation for euros.	A Canadian-dollar cash account can be saved, after which the currency cannot be removed while that account uses it.	test react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0006.spec.ts#ACT-ACC-0006
`02`	Two administrators change the same unit concurrently.	One drops euros as the other adds a euro account.	One request succeeds and the refused request explains the conflict.	test react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0007.spec.ts#ACT-ACC-0007

Planning

Implementation

Enable supported foreign currencies for a business unit ​

Purpose ​

How It Works ​

Relationships ​