Setting Up a Warehouse

This guide walks you through the initial configuration of a new warehouse — from creating the warehouse entity to enrolling your first items.

Before you start

• You need the create:warehouse permission (and update:warehouse to edit one later). Grant each action explicitly — a manage:warehouse permission is not honoured by the access checks; see Users and Roles
• Have your warehouse layout planned: zones, aisles, racking structure, and bin naming convention
• Have your item catalog ready or know which items need to be enrolled

---

Step 1 — Create the warehouse

1. In the sidebar, open Master Data → Warehouses and click ADD NEW WAREHOUSE (the Master Data section is only visible to admin/superadmin role names — see Navigating the App)
2. Enter a code — a short unique identifier (e.g., DC-01, MAIN)
3. Enter a name — a human-readable label
4. If this is your primary facility, check Main Warehouse
5. If this is a sub-warehouse, link it to the main warehouse
6. Click Save

When the warehouse is created, the system automatically creates four virtual bins for it:

Bin	Type	Purpose
Receiving Dock	RECEIVING_DOCK	Where inbound stock lands during receiving
Dispatch Dock	DISPATCH_DOCK	Where outbound stock stages before leaving
In Transit	IN_TRANSIT	For stock mid-transfer
Quality Hold	QUALITY_HOLD	For quarantined stock

These bins are managed by the system — do not delete them.

---

Step 2 — Set up zones

Create zones to organise your warehouse by function:

1. In the sidebar, open Locations → Zones and click ADD NEW ZONE
2. Pick the warehouse the zone belongs to
3. Enter a code and name
4. Select the appropriate zone type (see Location Hierarchy for type descriptions)
5. Add a description if helpful
6. Click Save

Typical zones for a standard warehouse:

Zone	Type
Receiving	receiving
Bulk Storage	storage
Pick Face	picking
Dispatch / Staging	staging
Returns	return
Quarantine	quarantine

---

Step 3 — Set up aisles, racks, shelves, and bins

Work down the hierarchy for each storage zone. See Managing Locations for detailed steps.

At minimum you need at least one storage bin before you can receive stock. Virtual bins (dock, transit, hold) are already created.

---

Step 4 — Enroll items

Items must be enrolled in the warehouse before they can be received. See Managing Items for the full process.

When enrolling, you will set:

• The item’s tracking type for this warehouse (BULK, LOT, SERIAL, or RFID)
• Optional reorder points and min/max quantities
• Optional price information

---

Step 5 — Set up users and roles

Before staff can use the warehouse, create roles with appropriate permissions and assign users. See Users and Roles.

---

Checklist

• Warehouse created
• Virtual bins confirmed (dock, dispatch, transit, hold)
• Zones created and typed correctly
• Aisles, racks, shelves, and bins created
• Items enrolled with correct tracking types
• Roles created and users assigned