OBJECT

StockTotals

Caution: use freeToAllocateQuantity (FTA) unless you have a good reason to opt for another field. Quantities other than FTA require more expensive calculations, which are reflected in query complexity scores.

Quantities in StockTotals have the following meaning

         physical      ordered             incoming*
          /      \      /     \             /      \
freeToAllocate  allocated     demand - linked*    unlinked*

demand is decreased by linked quantity when supplier module is enabled

unshipped = all ordered items which are not in a "sent" shipment

availableNow = freeToAllocate - demand

available* = availableNow + unlinked*

on delivery* = number of incoming items from supplier orders, which are present in supplier deliveries

*from the Supplier Module

Caution: neither stockOffset from ProductVariant, nor threshold from Warehouse are included in the returned freeToAllocate. If your integration requires them for stock calculation, you can fetch these numbers and compare to the returned stock values.

More information

link GraphQL Schema definition

1type StockTotals {
2# Free to allocate (FTA) is the quantity to use in most cases: what is available for purchase and allocation
3# to new orders at the moment. The FTA does not include possible warehouse threshold nor variant's stock offset.
4freeToAllocateQuantity: Int!
5
6# Physical is what is on warehouse shelf, both FTA and already allocated to orders.
7physicalQuantity: Int!
8
9# Quantity assigned to orders, but not shipped yet.
10allocatedQuantity: Int!
11
12# What is ordered, but not allocated yet, and not linked to a purchase (supplier) order. Usually backorder and/or
13# preorder.
14demandQuantity: Int!
15
16# The quantity of ordered products, allocated or demand, but not yet shipped.
17unshippedQuantity: Int!
18
19# This is the amount of products available to allocate to orders minus the stock that has created demand.
20availableNowQuantity: Int!
21
22# This field is only populated if you are using the Supplier Module and have purchase orders with products that are not
23# yet delivered.
24incomingQuantity: Int!
25
26# The part of incomingQuantity, which is already linked to orders. It decreases demandQuantity.
27linkedIncomingQuantity: Int!
28
29# The part of incomingQuantity, which is not linked to orders. It also increases available quantity.
30unlinkedIncomingQuantity: Int!
31
32# This field is populated if a product is on a purchase order delivery that has not yet been accepted.
33onDeliveryQuantity: Int!
34
35# Total stock, which is or will be available: FTA - demand + unlinked incoming quantity.
36availableQuantity: Int!
37
38}