Stock Movements
General
The Stock Movements feature provides a chronological history of all stock changes for a specific product variant within a warehouse. This view allows users to audit exactly when, why, and by how much a stock level changed, ensuring full transparency over inventory fluctuations.
This page is accessible with the permission stock_movements__list .
Stock Movements
Movement Types (Root Causes)
Stock changes are categorized into two reasons:
- Stock updated by merchant: Represents a direct manual or system update sent by the merchant.
- Order: Represents a change triggered by customer activity. This occurs when an item is reserved or blocked due to a new order, resulting in an automatic recalculation of the available (virtual) stock.
Calculation of Stock Change
For each movement, the system calculates the impact on the inventory level compared to the previous state. Therefore the Stock Change represents the numerical difference between the current quantity and the immediate previous quantity (e.g., -1 or +20).
Note on Data Retention: Stock movement records are stored for 14 days. If a variant has its first update within this window and no previous record exists for comparison, the stock change will be displayed as a dash “—”. A tooltip will inform the user that no baseline data is available within the retention period to calculate a delta.
