Track stock and stock locations

Inventory shows how much of each variant your store holds at each stock location, and lists the locations themselves. What a shopper can buy is what is available: the units on the shelf less the units that open orders reserve. A variant that tracks stock sells out when nothing is available, unless it keeps selling at zero.

• Every member can read the page. Adjusting stock needs the Tier 3 support role or higher, and creating or changing locations needs the Admin or Owner role. The page says which of these you can do.
• A variant counts stock when Track stock is ticked on it in Products.
• Create at least one location before you count stock. The first location becomes the default.

1. In the dashboard, open the organization, then Commerce, then Products, then Inventory.
2. Choose All items or Low stock, which lists the items at or below their low stock threshold.
3. When the store has more than one location, change Every location to one location to see only its stock.
4. Search by SKU or title.

Each row is one item: the stock behind a variant. The first three locations that are turned on get a column each, and Other locations adds up the rest. Each location's figure is what is available there, with the units stocked, reserved and incoming beneath it. Available gives the total across locations, marked Low stock, Sold out or Not tracked. Low at gives the item's threshold and whether it is Its own or The store's. Select the product's name to open it.

1. On the item's row, select Adjust….
2. Choose the Location. The dialog shows what is On the shelf, Reserved, Available and Incoming there.
3. Choose how to change the count:
   • Add or remove: enter the Change, such as 10 or -3. Stock never goes below 0.
   • Set the count: enter what is On the shelf after you counted it. Units reserved for open orders stay held.
4. Optionally, enter Incoming: the units on their way to this location, such as an open purchase order.
5. Check the line that says what the count will be after the change, then select Save stock.

Orders move stock on their own. Placing an order reserves its units, shipping takes them off the shelf, and cancelling an order or refunding units before they ship frees them. Sellable units counted back on a return go back on the shelf. A webhook provider can set the count at its location to what its warehouse counts.

1. In Commerce, then Setup, then Settings, find the Low stock card.
2. Tick Email when stock runs low.
3. Enter Low at: an item counts as low when its available units, over every location, are at or below this. It is 20 unless you set it.
4. In Send to, enter up to 10 addresses of your own people, one per line. The email never goes to a shopper.
5. Select Save changes.

To hold one item to a different threshold, open its menu here, select Low stock threshold…, enter the number, then select Save threshold. Leave it blank to follow the store's again. An item's own threshold marks it Low stock even while the emails are off; the store's counts only while they are on. Setting a threshold needs the Admin or Owner role.

Each time an item falls to its threshold, one email lists what fell, whether an order, a count or a sync moved it. The item is not emailed about again until its stock has risen above the threshold. Your organization webhooks also receive commerce.inventory.low_stock for each item.

1. Under Locations, select New location….
2. Enter a Name, such as the warehouse's.
3. Enter the address: Street, Building or unit, Postal code, City, Province or state and Country. The country is a two-letter code such as NL. Orders ship from here, so taxes and shipping zones read it.
4. When a fulfilment provider packs the orders taken from this location, choose it in Fulfilled by. Otherwise keep No provider: the store ships them itself.
5. Tick Make it the default location to send new stock and imports there. The first location is always the default.
6. Select Create location.

A store has up to 100 locations. The Sells to column shows the sales channels that sell from each one; choose them under Sells from on each channel in Storefront. Send orders to a fulfilment provider explains how Fulfilled by routes orders.

Each action is in the menu on the location's row.

Edit location…

Change the name, the address or who fulfils it, then select Save location.

Make default

New stock and imports go to it. Turn a location on before you make it the default.

Turn off and Turn on

Shoppers cannot buy the stock at a turned-off location. To turn off the default location, make another one the default first.

Delete location…

Type the location's name, then select Delete location. Only an empty location that nothing refers to can be deleted: no stock, shipping zone, fulfilment or return. The default location cannot be deleted. Turn a location off instead to stop selling from it.

• The item's figures change at once in the list, and the Low stock count follows.
• Shoppers can buy what is available at the locations each storefront's sales channel sells from.
• A new location gets a column in the list, and orders can ship from it.

Adjust… is missing

Your role is below Tier 3 support, or none of the item's variants tracks stock.

The storefront says a variant is sold out, but it has stock

The stock may be at a turned-off location, or at a location the storefront's sales channel does not sell from. Check Sells to on the location.

A variant sells when it has no stock

It keeps selling at zero. Untick Keep selling at zero on the variant in Products.

A location cannot be deleted

Something still refers to it: stock, a shipping zone, a fulfilment or a return. Turn it off instead.

Low stock lists nothing, though some items are nearly out

The store's threshold counts only while Email when stock runs low is on. Turn it on, or give those items a threshold of their own.

No low stock email arrived

Check that Send to lists at least one address. An item that was already low is emailed about again only after it has been restocked above its threshold.

• Add and edit your store's products
• Send orders to a fulfilment provider
• Import products, customers, promotions and orders

Stock levels are under https://api.coritan.com/api/v1/orgs/{org_slug}/commerce/inventory-items, and a batch route sets up to 1,000 counts at one location by SKU. ?below_threshold=true lists the items marked Low stock, and PATCH on an item sets its low_stock_threshold. Set stock levels and Add stock locations have the details.

curl "https://api.coritan.com/api/v1/orgs/acme/commerce/inventory-items?below_threshold=true" \
  -H "Authorization: Bearer $CORITAN_TOKEN"