Offer a collection of products as a bundle

Purpose

An integrator supplies the products included in a bundle and their quantities.

How It Works

An integrator supplies the products included in a bundle and their quantities. Each included item needs an explicit allocation price. Validation checks the workspace and business unit of each component. It also checks sellability and prevents repeated components or cycles. Quantity-weighted allocations cannot exceed the bundle’s applicable price limits. A retired component already held by the bundle can remain. The Accounting console currently hides bundle editing and preserves loaded components. Purchase presentation and posting treatment require the owning downstream modules.

Relationships

This outcome uses configure prices by audience, period and currency.

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: Bundle allocations stay within validated product relationships.
Surfaces: api
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D10.1services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D12services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R24

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.update`	api	tenant

Business Rules

9 rules, 8 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	Bundle components are accepted only for kinds supporting bundles, including Accounting Products among Accounting’s kinds. proved by `ATS-ACC-PRD-011-01`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`	validation	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses components on a Donation Product
`02`must prove Proposed	Each component must be a unique, existing sellable product in the bundle’s unit and must differ from the bundle itself. proved by `ATS-ACC-PRD-002-15`, `ATS-ACC-PRD-011-02`, `TST-ACC-PRD-040`	validation	service, database	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a component of another business unit, naming both units
`03`must prove Proposed	Retired components already held by a bundle may remain, but newly added retired components are rejected. proved by `ATS-ACC-PRD-005-09`, `ATS-ACC-PRD-006-11`, `ATS-ACC-PRD-011-03`, `ATS-ACC-PRD-011-09`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	lifecycle	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#keeps a retired component the bundle already holds when a replacement resends it, and refuses a new retired one
`04`must prove Proposed	Component relationships cannot create a cycle back to the containing bundle. proved by `ATS-ACC-PRD-011-04`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	invariant	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses closing a cycle: B including A when A includes B
`05`must prove Proposed	Each component requires an explicit price, including when its price is zero. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D10.1 proved by `ATS-ACC-PRD-011-05`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	validation	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a component sent without a price, naming it, and stores nothing (ACCT-M1 D10.1, DEF-ACT-0107)
`06`must prove Proposed	Quantity-weighted component totals fit set standard and member prices in the always base-currency period, preferring an undated row and otherwise its first dated row; absent member price counts as zero. ✓ Two components allocated 2000 each contribute 4000 to a bundle priced at 5000.✗ Three such components contribute 6000 and exceed the bundle’s price of 5000. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D12 proved by `ATS-ACC-PRD-008-11`, `ATS-ACC-PRD-011-06`, `ATS-ACC-PRD-011-09`, `ATS-ACC-PRD-016-09`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	calculation	service, console	observed services-accounting:modules/products/services/rules/product-rules.ts:listPrice; services-accounting:modules/products/services/rules/product-rules.ts:bundleTotalsProblem
`07` Proposed	Documented posting responsibility treats inline components as fixed revenue splits rather than separate bundled items.	policy		documented services-accounting:modules/products/db/product-bundle-components.table.ts
`08`must prove Proposed	Bundle replacement accepts at most fifty components and replaces the complete collection. proved by `ATS-ACC-PRD-011-07`, `TST-ACC-PRD-040`	validation	api, service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses more than 50 bundled products
`09`must prove Proposed	The console hides bundle controls but preserves components configured through the API. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R24 proved by `ATS-ACC-PRD-011-08`, `TST-ACC-PRD-005`	policy	console	test react-console:acceptance/accounting/playwright/journeys/products/ACT-ACC-0110.spec.ts#ACT-ACC-0110

Scenarios

Id	Given	When	Then	Provenance
`01`	A course costs 5000 minor units and a workbook belongs to the same unit.	Staff allocate two workbooks at 2000 each.	Two fit within the course price, while three exceed it and are rejected.	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#totals each component price times its quantity (ACCT-M1 D12 A2)

Edge Cases

Id	Given	When	Then	Provenance
`02`	Bundle A includes B.	A caller makes B include A.	The cycle rejects the change.	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses closing a cycle: B including A when A includes B

Planning

Implementation

Offer a collection of products as a bundle ​

Purpose ​

How It Works ​

Relationships ​