--- id: CON-COM-FUL-005 name: Stock feature: FEAT-COM-FUL-04 product_area: commerce module: fulfillment revision: 1 status: draft product_intent: proposed implementation_evidence: observed source_sha: services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b react-console: baf6dae382d6f41dce976c7f848667ccc37e076f definition: >- Stock combines physical and reserved SKU quantities at warehouse locations with the movement and allocation records explaining their availability. owned_by: MOD-COM-FUL synonyms: - inventory - stock item - on hand not_to_be_confused_with: - Catalog merchandise and variant definitions - The monetary cost-layer and valuation records - Warehouse shipment preparation and departure facets: - name: Warehouse meaning: Warehouse sites carry address and allocation-priority information. used_for: Understanding warehouse in the stock workflow. provenance: observed source: 'services-commerce:modules/inventory/db/warehouses.table.ts' - name: Location meaning: >- A location identifies a bin or designated receiving, restricted or damaged-goods area within a warehouse. used_for: Understanding location in the stock workflow. provenance: observed source: 'services-commerce:modules/inventory/db/inventory-locations.table.ts' - name: Stock item and balances meaning: >- A location item records on-hand, held, allocated, restricted, backordered and available quantities for its SKU. used_for: Understanding stock item and balances in the stock workflow. provenance: observed source: 'services-commerce:modules/inventory/db/inventory-items.table.ts' - name: Movement meaning: >- An immutable physical ledger records receipts, corrections, restrictions, shipment, restock, transfer and count effects. used_for: Understanding movement in the stock workflow. provenance: observed source: 'services-commerce:modules/inventory/db/inventory-movements.table.ts' - name: Allocation meaning: >- Individual buyer allocations progress through hold, commitment, picking, shipment, release or backorder. used_for: Understanding allocation in the stock workflow. provenance: observed source: 'services-commerce:modules/inventory/db/inventory-allocations.table.ts' - name: Transfer meaning: >- Linked outgoing and incoming entries move available stock and its cost between locations. used_for: Understanding transfer in the stock workflow. provenance: observed source: 'services-commerce:modules/inventory/services/stock/transfer-stock.ts' - name: Count meaning: >- A retained shelf observation supplies corrections when the count completes. used_for: Understanding count in the stock workflow. provenance: observed source: >- services-commerce:modules/inventory/services/persistence/inventory-counts.ts - name: Stock finding and reorder point meaning: >- Reconciliation and warehouse findings describe discrepancies and shortages using replenishment thresholds. used_for: Understanding stock finding and reorder point in the stock workflow. provenance: observed source: >- services-commerce:modules/inventory/services/reconciliation/nightly-inventory.ts relationships: - to: CON-COM-FUL-004 statement: Return disposition can restock goods and restore their original cost. provenance: test source: >- services-commerce:modules/shipping/tests/integration/services/returns/return-receiving.integration.spec.js#restocks the two units at the bin they shipped from: the return_restock movement naming the disposition, on hand up two, the two reliefs reversed at 1500 with the restore_cogs fact of 3000 - to: CON-COM-FUL-001 statement: Authorization of delivery permits committed stock units to become picked. provenance: observed source: >- services-commerce:modules/inventory/services/persistence/inventory-allocations.ts:pickUnitsOfLine lifecycle: [] acted_on_by: - CAP-COM-FUL-012 - CAP-COM-FUL-014 - CAP-COM-FUL-015 - CAP-COM-FUL-016 - CAP-COM-FUL-017 - CAP-COM-FUL-018 - CAP-COM-FUL-019 - CAP-COM-FUL-020 visible_to: - ACT-COM-010 - ACT-COM-009 - ACT-COM-011 - ACT-COM-013 evidence: - repository: services-commerce sources: - >- services-commerce:modules/shipping/tests/integration/services/returns/return-receiving.integration.spec.js#restocks the two units at the bin they shipped from: the return_restock movement naming the disposition, on hand up two, the two reliefs reversed at 1500 with the restore_cogs fact of 3000 - >- services-commerce:modules/inventory/services/persistence/inventory-allocations.ts:pickUnitsOfLine - repository: react-console sources: [] supersedes: [] --- # Stock ## What It Is Stock describes the physical units of a product SKU held at warehouse locations and their availability for buyers. The record distinguishes goods on hand from units already reserved, allocated, quarantined or damaged. It also retains backorders for demand that existing stock cannot yet satisfy. Staff need these distinctions to answer whether goods can be sold, where they can be picked and why apparently present units are unavailable. Movements and allocations provide the explanation behind balances. A movement records a physical change such as receipt, shipment or correction. An allocation identifies a unit held or committed for a buyer and follows it through later handling. The database uses these ledgers to maintain balances instead of treating an edited stock number as sufficient evidence. Product configuration supplies the tracking and shortage policy; stock records describe the quantities at actual locations. ## What It Is Not The merchandise product and its variants belong to the catalog and describe what is sold. Stock describes quantities of those products in places. Cost layers and valuation supply monetary accounting for the goods and currently have a separately registered owner. A shipment organizes outward handling, while a count records observations of the shelf. None of these replaces the immutable movement record that explains a balance change. ## How It Is Used Administrators organize warehouses and locations, and warehouse staff record incoming goods, corrections and transfers through authorized operations. Selling reads availability and creates holds or commitments. Arriving stock can satisfy waiting backorders before it becomes available to another buyer. Departure and return disposition contribute their own movements. Staff compare shelf observations through counts and investigate findings raised by the floor or nightly checks. Reconciliation reports most discrepancies rather than silently replacing their balances. ## Its Facets **Warehouse.** Warehouse sites carry address and allocation-priority information. Understanding warehouse in the stock workflow. **Location.** A location identifies a bin or designated receiving, restricted or damaged-goods area within a warehouse. Understanding location in the stock workflow. **Stock item and balances.** A location item records on-hand, held, allocated, restricted, backordered and available quantities for its SKU. Understanding stock item and balances in the stock workflow. **Movement.** An immutable physical ledger records receipts, corrections, restrictions, shipment, restock, transfer and count effects. Understanding movement in the stock workflow. **Allocation.** Individual buyer allocations progress through hold, commitment, picking, shipment, release or backorder. Understanding allocation in the stock workflow. **Transfer.** Linked outgoing and incoming entries move available stock and its cost between locations. Understanding transfer in the stock workflow. **Count.** A retained shelf observation supplies corrections when the count completes. Understanding count in the stock workflow. **Stock finding and reorder point.** Reconciliation and warehouse findings describe discrepancies and shortages using replenishment thresholds. Understanding stock finding and reorder point in the stock workflow. ## How It Relates The catalog supplies product and SKU information. Orders and checkouts supply the buyer references behind allocations. Obligations authorize physical delivery and shipments record departure. Return disposition determines which incoming goods become stock again. The costing boundary remains a Product decision because physical operations and monetary relief are closely connected while registered separately. ## What It Could Become The product should provide warehouse staff with stock history, count and findings screens. It should also make incomplete nightly scans visible so staff can judge the reach of reconciliation. Before design begins, Product should settle costing ownership and the place where stock and shipping problems appear for investigation.