Skip to main content

How to read the stock history

StoreLinkr keeps a full audit trail of every stock change for each product. You can see exactly when the stock changed, by how much, which warehouse it happened in, who or what caused it, and the resulting total. This makes it easy to answer questions like "why did this product go out of stock?" or "who set this quantity?".

Open a product and go to the Stock tab to find the stock history.

The stock chart

At the top of the history you'll find a chart showing the product's total available stock over time. Every recorded change adds a point to the line, so you can see trends, sudden drops from orders, and restocks at a glance.

The change log

Below the chart, a table lists every individual change, newest first:

ColumnMeaning
DateWhen the change happened.
SourceWhat caused the change (see below).
Stock locationThe warehouse affected, or for a product-level change.
Changed byThe user (e.g. an email address) or the system/integration that made the change.
ReferenceExtra context, such as the order number for an order deduction.
ChangeThe delta: a green +n for an increase, a red -n for a decrease.
TotalThe product's total available stock after this change.

Change sources

Every entry is tagged with the source of the change:

  • Import source — stock was updated by an integration (a POS, WMS or ERP such as CycleSoftware, Picqer or StockHub) during a stock import.
  • Order deduction — stock was reduced because a new order came in. The reference shows the order number. See Automatic Stock Deduction.
  • Manual override — someone changed the stock by hand on the product's Stock tab. The reference shows the warehouse name.
  • Recalculation — the total was recomputed from the underlying warehouses (for example after a sync).

Location-based changes

Changes are recorded per warehouse. If a single event affects more than one warehouse — for example an order for 3 units that takes 2 from one warehouse and 1 from another — StoreLinkr writes one entry per warehouse, each showing that warehouse's own change. Every entry still carries the resulting product total, so the chart always reflects the true overall stock level.

Product-level changes (for products without warehouses, or a total-only manual edit) are recorded with an empty Stock location column.

Reading the history over the API

The full stock history is also available through the API, both per product and as a recent-changes overview across your whole catalog. See Stock API.