Organize warehouses and stock locations

Purpose

Administrators define where stock is held and how sellable locations are selected.

How It Works

An administrator creates warehouses and the locations within them. Names, codes and priorities help staff recognize those places and explain allocation order. Location kinds distinguish sellable areas from goods needing separate treatment. Configuration replacements use the version staff read. Existing stock and dependent records can prevent removal of a place. The current evidence does not establish a warehouse-management console workflow. The product should provide one that makes those dependencies visible before deletion.

Relationships

Keep stock movements and transfers accountable supplies or consumes related delivery records.
Allocate stock and explain what buyers can obtain supplies or consumes related delivery records.
Configure shipping coverage and collection options supplies or consumes related delivery records.

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: Warehouse and location priorities guide stock selection.Restricted stock places are excluded from ordinary selling.
Surfaces: api

Controls

21 controls apply, from the corpus control catalogue.

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

Permissions

Key	Checked at	Scope
`commerce.inventory.read`	api	tenant
`commerce.inventory.create`	api	tenant
`commerce.inventory.update`	api	tenant
`commerce.inventory.delete`	api	tenant

Business Rules

8 rules, 7 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	Warehouse identity is supplied or derived from its name and remains stable, with duplicate identities and negative priorities rejected. proved by `ATS-COM-FUL-016-01`, `TST-COM-FUL-059`, `TST-COM-FUL-060`	validation	service, database	test services-commerce:modules/inventory/tests/integration/services/persistence/inventory-configuration.integration.spec.js#refuses a second warehouse under one id (400) and a negative priority (400)
`02`must prove Proposed	Allocation order sorts warehouses by increasing priority, puts unset priorities last and breaks ties by name and identity. proved by `ATS-COM-FUL-016-01`, `TST-COM-FUL-059`, `TST-COM-FUL-060`	calculation	service	test services-commerce:modules/inventory/tests/integration/services/persistence/inventory-configuration.integration.spec.js#lists the warehouses in allocation order (priority first, none last), the active ones alone on request, and by search
`03`must prove Proposed	Warehouse and location replacement reject stale versions and locked records, while deletion is prevented by dependent locations, items or counts. proved by `ATS-COM-FUL-010-08`, `ATS-COM-FUL-016-02`, `ATS-COM-FUL-016-09`, `TST-COM-FUL-057`, `TST-COM-FUL-059`, `TST-COM-FUL-060`	validation	service, database	test services-commerce:modules/inventory/tests/e2e/inventory.e2e.spec.js#reads the warehouse made with the shelf, lists it, replaces it at the version read (a stale one 409) and refuses its delete while locations belong to it (409)
`04`must prove Proposed	Locations retain their owning warehouse, have unique codes within it and select bin, zone, receiving, quarantine, returns or damaged, defaulting to bin. proved by `ATS-COM-FUL-016-03`, `TST-COM-FUL-057`, `TST-COM-FUL-060`	validation	service, database	test services-commerce:modules/inventory/tests/integration/services/persistence/inventory-configuration.integration.spec.js#refuses a code twice in one warehouse (400), a warehouse the tenant has not (400), and a kind outside the six (400)
`05`must prove Proposed	Sellable locations include bins, zones and receiving areas ordered by warehouse and pick priority, excluding quarantine, returns and damaged areas. proved by `ATS-COM-FUL-016-04`, `ATS-COM-FUL-016-07`, `ATS-COM-FUL-017-10`, `ATS-COM-FUL-018-13`, `TST-COM-FUL-060`	policy	service	test services-commerce:modules/inventory/tests/integration/services/persistence/inventory-configuration.integration.spec.js#answers the sellable locations across warehouses in allocation order: the main warehouse (priority 1) before the depot (2), bins by pick priority, quarantine and returns left out
`06`must prove Proposed	A stock location holding an item rejects deletion. proved by `ATS-COM-FUL-016-02`, `TST-COM-FUL-057`, `TST-COM-FUL-059`, `TST-COM-FUL-060`	invariant	service, database	test services-commerce:modules/inventory/tests/integration/services/persistence/inventory-configuration.integration.spec.js#refuses deleting a warehouse its locations belong to (409) and a location an item is held at (409); deletes them once free, 404 after
`07`must prove Proposed	Readers can inspect warehouses, locations and stock records, writes require administrator permissions, application-denied callers are rejected and other workspaces' records are unavailable. proved by `ATS-COM-FUL-016-05`, `TST-COM-FUL-057`	permission	api, database	test services-commerce:modules/inventory/tests/e2e/inventory.e2e.spec.js#lets a reader list and read everything, and refuses it every write 403 permission_missing
`08` Proposed	A warehouse, location and stock console workspace is not established by the pinned screen evidence.	policy	console	unknown FND-COM-FUL-004

Scenarios

Id	Given	When	Then	Provenance
`01`	The main warehouse has priority one and the depot priority two.	Read the locations eligible to supply stock.	Main-warehouse bins lead in pick-priority order and quarantine is excluded.	test services-commerce:modules/inventory/tests/integration/services/persistence/inventory-configuration.integration.spec.js#answers the sellable locations across warehouses in allocation order: the main warehouse (priority 1) before the depot (2), bins by pick priority, quarantine and returns left out

Planning

Implementation

Organize warehouses and stock locations ​

Purpose ​

How It Works ​

Relationships ​