Withdraw a product from sale and restore it

Purpose

Finance uses the row menu to withdraw or restore a product.

How It Works

Finance uses the row menu to withdraw or restore a product. Deactivation keeps the record available for correction while removing it from ordinary sale. Retirement preserves the record but prevents replacement. Reactivation returns either withdrawn state to active. Each lifecycle action checks the version read and product update authority. An update lock stops the action. The console confirms the choice before submitting it. Existing-invoice preservation is recorded product intent and needs the transaction module’s proof as well as catalogue state checks.

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: Finance can preserve withdrawn products and restore their use.
Surfaces: consoleapi
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11

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

Permissions

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

Business Rules

8 rules, 6 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	Ordinary replacement changes active products to inactive and back; inactive products leave sale while existing invoices remain valid. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-005-01`, `TST-ACC-PRD-003`	lifecycle	api, service	test react-console:acceptance/accounting/playwright/journeys/products/ACT-ACC-0107.spec.ts#ACT-ACC-0107
`02`must prove Proposed	Retirement advances the read version and changes only status, rejecting an already retired product. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-005-02`, `ATS-ACC-PRD-005-07`, `ATS-ACC-PRD-005-09`, `ATS-ACC-PRD-007-10`, `ATS-ACC-PRD-011-09`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`	lifecycle	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#retires the product at version 2, changing nothing else
`03`must prove Proposed	Reactivation makes inactive or retired products active and rejects products already active. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4 proved by `ATS-ACC-PRD-004-11`, `ATS-ACC-PRD-005-03`, `ATS-ACC-PRD-005-07`, `ATS-ACC-PRD-006-11`, `TST-ACC-PRD-040`	lifecycle	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#reactivates an inactive product
`04`must prove Proposed	Retirement and reactivation reject requests missing the read version or carrying an obsolete version. proved by `ATS-ACC-PRD-005-04`, `TST-ACC-PRD-030`, `TST-ACC-PRD-040`	validation	api, service	test services-accounting:modules/products/tests/e2e/products.e2e.spec.js#answers 400 to a lifecycle request without the version read
`05`must prove Proposed	An update lock prevents both retirement and reactivation. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D11 proved by `ATS-ACC-PRD-005-05`, `ATS-ACC-PRD-005-07`, `TST-ACC-PRD-040`, `TST-ACC-PRD-066`	permission	service	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#names the lock when a locked product is retired
`06`must prove Proposed	Both lifecycle actions require product update permission. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D3 proved by `ATS-ACC-PRD-005-06`, `ATS-ACC-PRD-005-08`, `TST-ACC-PRD-028`	permission	api	test services-accounting:modules/products/tests/e2e/products-security.e2e.spec.js#is refused retiring a product
`07` Proposed	Recorded product intent excludes retired products from new invoice selection while preserving existing invoices. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D4	policy		documented services-accounting:docs/milestones/plans/ACCT-M1-plan.md#D4
`08` Proposed	Row actions ask for confirmation before activation, deactivation, retirement and reactivation; retired names do not open the editor.	policy	console	observed react-console:components/accounting-config/products/product-row-actions.tsx:ProductRowActions

Scenarios

Id	Given	When	Then	Provenance
`01`	A currently active workshop product is in the catalogue.	Finance retires it, attempts correction and reactivates it.	Correction fails during retirement and succeeds after restoration to active.	test react-console:acceptance/accounting/playwright/journeys/products/ACT-ACC-0107.spec.ts#ACT-ACC-0107

Edge Cases

Id	Given	When	Then	Provenance
`02`	An inactive product remains in the catalogue.	Finance requests reactivation.	Its status becomes active directly.	test services-accounting:modules/products/tests/integration/services/persistence/products.integration.spec.js#reactivates an inactive product

Planning

Implementation

Withdraw a product from sale and restore it ​

Purpose ​

How It Works ​

Relationships ​