Configure prices by audience, period and currency

Purpose

An administrator fills the price grid for the audiences and currencies a product needs.

How It Works

An administrator fills the price grid for the audiences and currencies a product needs. Fixed-priced kinds start with a standard base-currency amount. Donations instead let the giver supply an amount. A grid cell can hold money, a percentage, a conversion choice or a prohibition. Validation checks the required backing cells and rejects overlapping time windows. Named periods can refer back to the always period, but never a different named period. Commerce owns audience selection and conversion when a purchase is priced. Accounting supplies validated configuration. The console has stricter current-price expectations and different time-boundary handling that need a settled shared contract.

Relationships

This outcome uses create a product with a permanent identity.

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: The grid supplies pricing configuration for eligible audiences.
Surfaces: consoleapi
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4services-accounting:docs/migrations/accounting-modernization/products-a12-a13/README.md#Provenance

Controls

22 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-DAT-001 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-PI-001 TC-PI-003 TC-PI-005

Permissions

Key	Checked at	Scope
`accounting.products.create`	api	tenant
`accounting.products.update`	api	tenant

Business Rules

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

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Proposed	A fixed-priced product requires a manually set standard price in its business unit’s base currency. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-002-15`, `ATS-ACC-PRD-008-01`, `ATS-ACC-PRD-008-11`, `TST-ACC-PRD-014`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	validation	service, console	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses an Accounting Product without a standard price in the base currency
`02`must prove Proposed	A giver-priced product rejects price rows because the purchaser supplies the amount. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-01`, `TST-ACC-PRD-014`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	validation	service, console	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a Donation Product with prices
`03`must prove Proposed	Price currencies must belong to the unit, and supported foreign currencies require multicurrency to be enabled. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-02`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	validation	service, database	test services-accounting:modules/products/tests/unit/rules/product-rules.spec.js#refuses a supported currency when the unit has Enable Multicurrency off (1.0: off is a single-currency unit)
`04`must prove Proposed	Each price cell selects an amount, a percentage of standard, conversion or prohibition and supplies only the values that mode requires, with percentages from zero to one hundred and at most two decimals. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-03`, `TST-ACC-PRD-031`, `TST-ACC-PRD-040`	validation	api, service, database	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a percentage cell without a percent, and a set cell with one
`05`must prove Proposed	Conversion and prohibition modes cannot apply to the base currency. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-04`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	validation	service	test services-accounting:modules/products/tests/unit/rules/product-rules.spec.js#refuses prohibiting the base currency
`06`must prove Proposed	A percentage price cannot target the standard audience and requires a set standard price in the same currency from its own period or the always period. ✓ A member price can be set to eighty percent of the standard euro price.✗ The member percentage has no basis when the corresponding standard euro price is absent. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-05`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	calculation	service, database	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a percentage cell on the standard audience, and one with no standard price to be a percentage of
`07`must prove Proposed	A converted price requires its own audience’s set or percentage base-currency price from the same period or the always period. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-06`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	calculation	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a calculated cell in the base currency, and one whose audience has no base-currency price to convert
`08`must prove Proposed	Validation uses backing rows from the matching or always period and never another named period; Commerce owns actual price selection. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-05`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	calculation	service	observed services-accounting:modules/products/services/rules/product-rules.ts:rowsBacking
`09`must prove Proposed	Rows sharing audience, currency and period cannot overlap in time, with opening instants included and closing instants excluded. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-07`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	invariant	service, database	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a dated price beside one that applies always, in the same audience and currency
`10`must prove Proposed	Known audiences are standard, member and active Commerce audiences in the workspace; before that vocabulary exists, previously held audiences are also accepted. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-008-08`, `TST-ACC-PRD-035`, `TST-ACC-PRD-040`	validation	service	test services-accounting:modules/products/tests/integration/services/persistence/pricing-audiences.integration.spec.js#refuses an inactive audience and an unknown one, naming the vocabulary
`11` Proposed	Price amounts use nonnegative integer minor units of their currency. proved by `ATS-ACC-PRD-008-10`	validation	api, database	test services-accounting:modules/products/tests/integration/db/products.table.integration.spec.js#refuses a negative amount
`12`must prove Proposed	Each product accepts up to five hundred price cells and replaces the entire grid on creation or replacement. proved by `ATS-ACC-PRD-004-11`, `ATS-ACC-PRD-008-09`, `ATS-ACC-PRD-010-05`, `ATS-ACC-PRD-016-09`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`	validation	api, service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses more than 500 prices (the bound of the grid)
`13` Proposed	Documented pricing responsibility assigns missing foreign-currency cells to unit defaults and conversion with frozen rates to Commerce. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4	policy		documented services-accounting:docs/accounting/products.md#Prices (the grid: A12 and A13, 2026-10-17)
`14` Proposed	The product API retains the deprecated audience alias in responses and accepts it instead of the current audience field.	policy	api, service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#accepts the deprecated alias audience in place of audience_id, answering both
`15` Proposed	The console fills an empty standard foreign-currency cell with prohibition unless the unit default supplies conversion.	policy	console	observed react-console:lib/accounting-config/product-form.ts:formToWrite

Scenarios

Id	Given	When	Then	Provenance
`01`	A US-dollar product also supports euro and Canadian-dollar pricing.	Staff set a dollar amount, member percentage, euro conversion and Canadian-dollar prohibition.	The saved grid contains those choices in minor units at the initial version.	test react-console:acceptance/accounting/playwright/journeys/products/ACT-ACC-0100.spec.ts#ACT-ACC-0100

Edge Cases

Id	Given	When	Then	Provenance
`02`	A standard dollar row has no date boundaries.	An administrator adds another standard dollar row starting in January.	The overlapping applicability rejects the save.	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a dated price beside one that applies always, in the same audience and currency

Planning

Implementation

Configure prices by audience, period and currency ​

Purpose ​

How It Works ​

Relationships ​