Delete a product after its dependencies are removed

Purpose

An administrator chooses Delete for a product that no longer needs a continuing identity.

How It Works

An administrator chooses Delete for a product that no longer needs a continuing identity. The service checks its lock and the accounting setup’s lock. Database references prevent removal while another bundle or a transaction depends on it. Successful deletion removes the product’s owned configuration. The template cleanup happens after that commit. A cleanup failure therefore leaves a removed product and requires operational follow-up. Some transaction-reference refusals still surface as server errors rather than useful explanations. Product delete authority does not bypass those dependencies.

Relationships

The product record supplies the identity and configuration used by this outcome.

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: Removal respects records that still depend on the product.
Surfaces: consoleapi
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11

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

Permissions

Key	Checked at	Scope
`accounting.products.delete`	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	Products included in another product’s bundle cannot be removed. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3 proved by `ATS-ACC-PRD-005-09`, `ATS-ACC-PRD-006-01`, `ATS-ACC-PRD-006-11`, `ATS-ACC-PRD-011-09`, `TST-ACC-PRD-030`, `TST-ACC-PRD-031`, `TST-ACC-PRD-040`	policy	service, database	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses deleting a product another product bundles, 409, and keeps it
`02`must prove Proposed	Invoice product references, invoice discount-product references and installment line references prevent product deletion. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3 proved by `ATS-ACC-PRD-006-02`, `ATS-ACC-PRD-006-03`, `TST-ACC-PRD-011`	policy	database	observed services-accounting:modules/transactions/db/invoice-lines.table.ts:invoice_lines_product_fk; modules/transactions/db/invoice-lines.table.ts:invoice_lines_discount_product_fk; modules/billing/db/installment-schedule-lines.table.ts:installment_schedule_lines_product_fk
`03`must prove Proposed	Deletion cascades to prices, components, feature collections, accounting setup and its children, and migrated pricing handovers. proved by `ATS-ACC-PRD-006-04`, `ATS-ACC-PRD-006-10`, `ATS-ACC-PRD-009-04`, `TST-ACC-PRD-031`, `TST-ACC-PRD-040`	invariant	database	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#takes its prices, components, accounting setup and the setup’s collections with it
`04`must prove Proposed	Either product lock prevents deletion. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11 proved by `ATS-ACC-PRD-006-05`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	permission	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a product locked against deletes
`05`must prove Proposed	A lock preventing deletion of the accounting setup also prevents deletion of its owning product. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11 proved by `ATS-ACC-PRD-006-06`, `ATS-ACC-PRD-006-11`, `ATS-ACC-PRD-015-17`, `TST-ACC-PRD-040`	permission	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#refuses a product whose accounting setup is locked against deletes, leaving the product and its setup (DEF-ACT-0101)
`06`must prove Proposed	After product deletion commits, Accounting clears its owned confirmation template; cleanup failure is logged and leaves the deletion committed. proved by `ATS-ACC-PRD-006-07`, `ATS-ACC-PRD-006-11`, `ATS-ACC-PRD-014-07`, `TST-ACC-PRD-039`	lifecycle	service	test services-accounting:modules/products/tests/integration/services/persistence/products.features.integration.spec.js#leaves the delete standing when Platform cannot clear the template
`07`must prove Proposed	A business unit containing products cannot be deleted. proved by `ATS-ACC-PRD-006-08`, `TST-ACC-PRD-030`	policy	database	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers 409 to deleting a business unit that still has products
`08`must prove Proposed	Product deletion requires product delete permission. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3 proved by `ATS-ACC-PRD-006-09`, `TST-ACC-PRD-028`	permission	api	test services-accounting:modules/products/tests/e2e/products-security.e2e.spec.js#is refused deleting a product
`09` Proposed	Deletion returns not found for products outside the current workspace or absent from it. proved by `ATS-ACC-PRD-006-10`	validation	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#answers another tenant’s product as absent and leaves it

Scenarios

Id	Given	When	Then	Provenance
`01`	A mistaken product has prices and accounting configuration.	An administrator confirms Delete in the row menu.	The product and owned configuration disappear and subsequent retrieval returns not found.	test react-console:acceptance/accounting/playwright/journeys/products/ACT-ACC-0107.spec.ts#ACT-ACC-0107

Edge Cases

Id	Given	When	Then	Provenance
`02`	A second product includes this product in its bundle.	An administrator attempts deletion.	Removal fails with guidance about the bundle dependency.	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers 409 to deleting a product a bundle includes

Planning

Implementation

Delete a product after its dependencies are removed ​

Purpose ​

How It Works ​

Relationships ​