Salable quantity by source

Upstream MSI shows one salable quantity per stock. When it is lower than the quantity on hand, nothing says where the difference sits.

msi-core breaks it down. The Product Salable Quantity section of the product form and the Salable Quantity column of the product grid report, for every source of a stock:

• the quantity on hand;
• that source’s reservation balance;
• the salable quantity they add up to.

The aggregate Magento already showed becomes the total of that breakdown, so a salable quantity lower than the quantity on hand can be traced to the source holding the difference.

Sources that contribute nothing are still listed and labelled, for example a disabled source or a source item set out of stock, so a zero reads as a reason rather than a defect.

One stock with three sources. The breakdown shows where the gap between quantity on hand and salable quantity sits, and why a source contributes nothing.

Behaviour

• Single-source mode is untouched. With one source the breakdown would only repeat the aggregate, so the section renders exactly as upstream.
• Without source-level reservations the breakdown degrades to the quantity on hand, because reservations are then held per stock and cannot be attributed to a source.
• The grid resolves a whole page in one pair of queries and keeps the breakdown collapsed until it is expanded, which costs no further request.

There is nothing to configure.