Warehouses
A warehouse is any place you hold stock — a back room, a second branch, a van. The system tracks quantities per location.
DigitalKey ERP — Docs · digital-key.co/docs/warehouses
warehouse.manage5,000 IQD / monthOverview
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”.

Warehouse fields
| Parameter | Type | Required | Description |
|---|---|---|---|
warehouse_id | integer | Optional | Internal identifier. |
name | string | Required | What the location is called. |
address | string | Optional | Where it is. |
is_default | boolean | Optional | Whether new stock lands here when no location is specified. |
is_active | boolean | Optional | Inactive warehouses stop being offered but keep their history. |
total_products | integer | Optional | How many distinct products are held here. Read-only. |
total_stock_value | decimal | Optional | Value of stock held, at cost. Read-only. |
low_stock_count | integer | Optional | How many products here are at or below their alert level. Read-only. |
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.
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.
warehouse.alerts2,000 IQD / monthIn this section
- Stock Transfers — moving stock between locations.
- Stock Adjustments — correcting counts.