Warehouses

Warehouses

A warehouse is any place you hold stock — a back room, a second branch, a van. The system tracks quantities per location.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/warehouses

Requires subscriptionwarehouse.manage5,000 IQD / month

Overview

Businesses with one stockroom can ignore warehouses entirely; a default location exists and everything lands there. The module matters once stock sits in more than one place and “how many do we have” needs a “where”.

Warehouses — Warehouse list
Warehouse list
Warehouse list — Warehouses with product counts, total stock value and low-stock counts.

Warehouse fields

Warehouse record
ParameterTypeRequiredDescription
warehouse_idintegerOptionalInternal identifier.
namestringRequiredWhat the location is called.
addressstringOptionalWhere it is.
is_defaultbooleanOptionalWhether new stock lands here when no location is specified.
is_activebooleanOptionalInactive warehouses stop being offered but keep their history.
total_productsintegerOptionalHow many distinct products are held here. Read-only.
total_stock_valuedecimalOptionalValue of stock held, at cost. Read-only.
low_stock_countintegerOptionalHow many products here are at or below their alert level. Read-only.
NoteOne warehouse is the default. Opening stock on a new product goes there unless initial_warehouse_id says otherwise, and a POS shift can be tied to a particular location so sales draw from the right stock.

Per-warehouse stock

A product's total quantity is the sum of what is held across all locations. The per-warehouse breakdown is available from the product itself, at GET /api/v1/products/{id}/stock.

WarningA product can show plenty in total while the branch actually serving a customer has none. When stock is split across locations, check the breakdown rather than the headline number.

Stock value

total_stock_value is calculated at cost — using purchase_price— not at what you would sell it for. It answers “how much money is tied up here”, not “what is this worth on the shelf”.

Alerts

The alerts view collects every product at or below its qty_alert threshold, per location, so a reorder list can be worked through in one place.

Requires subscriptionwarehouse.alerts2,000 IQD / month

In this section