Warehouses — SanadiqCloud
Product version: 1.0.0+1
Last updated: 2026-10-07 Audience: Tenant Owners, Tenant Employees, Regular Users
A. What is a Warehouse?
A Warehouse is a facility. You create it directly; its address is an optional Google Maps link on the warehouse itself. Inventories and bins hang under the facility:
Warehouse (facility) → Inventories → Items / bins
Each warehouse has a type (warehouse, distribution_center, retail_store, manufacturing, online_fulfillment, vehicle), status (active / inactive / archived), and optional manager. Bin types on the bin form are local presets, not warehouse classification fields.
B. Viewing the Warehouse List
Navigate to Inventory > Warehouses. The warehouse list shows:
| Column | Description |
|---|---|
| Name / code | Display name with code underneath |
| Type | Warehouse, distribution center, retail store, manufacturing, online fulfillment, vehicle |
| Status | Active, inactive, or archived (labels may also show maintenance / closed on older rows) |
| Active | Whether the warehouse is selectable |
| Manager | Assigned manager (if any) |
| Updated | Last update |
Use the search bar to filter by name or code. Use the Type and Status dropdowns to narrow results.
C. Creating a Warehouse
- Click + Create Warehouse on the warehouse list page.
- Fill in the required fields:
| Field | Required | Description |
|---|---|---|
| Name | Yes | Display name (max 255 characters) |
| Code | Yes | Unique identifier code (max 100 characters). Tip: use a short acronym like WH-NYC-01 |
| Type | No | Defaults to warehouse. Options: warehouse, distribution_center, retail_store, manufacturing, online_fulfillment, vehicle (a sales representative's van — see Custody stock) |
| Status | No | Defaults to active. Options: active, inactive, archived |
| Description | No | Free text notes (max 1000 characters) |
| Manager | No | Assign a team member as warehouse manager |
| Location (Google Maps link) | No | Paste a Google Maps link or use your current location |
- Click Save.
After creation, the system generates a unique warehouse_id (business identifier) and id (UUID). The code must be unique across all warehouses in your tenant.
D. Editing a Warehouse
- Navigate to Inventory > Warehouses and click the warehouse row.
- Click the Edit button (pencil icon).
- Modify any editable fields. Note that Code may be immutable after creation depending on your tenant configuration.
- Click Save Changes.
You can update the name, description, type, status, manager, and Google Maps link.
E. Warehouse Detail View
Click a warehouse row to open the detail view. The detail page is organized into sections:
Overview
- Name, Code, Business ID (
warehouse_id) - Type and Status badges
- Location — opens the warehouse's Google Maps link (shown only when set)
- Manager profile snippet (if assigned)
- Created and Updated timestamps
Classification
- Warehouse type — Facility kind
- Status — Whether the warehouse appears in operational dropdowns
- Manager — People assignment
Inline inventories
Lists inventories in this warehouse. Open an inventory for its items and policies (allow_negative_stock, require_approval_for_adjustments, require_approval_for_transfers).
When Allow negative stock is off, outbound operations (transfer ship, adjustment approve, pick-list issue, manual stock decrease) cannot leave an item’s on-hand quantity below its minimum stock level (or below 0 if no minimum is set). The API returns INV_INSUFFICIENT_STOCK with context.max_withdrawable so the app can tell you how many units you may still withdraw.
Configuration actions (not document shortcuts)
Warehouse detail is for facility setup: edit warehouse, add inventory, barcode search of inventories. Create transfer / adjustment / pick list / requisition from the hub Explore tiles, an inventory (transfer), or stock item Operations (item locked). Bin-to-bin moves use the stock item allocations dialog, not warehouse Operations.
F. Activating / Deactivating Warehouses
To change a warehouse's status:
- Open the warehouse detail view.
- Click the Status badge or the Edit button.
- Select a new status:
| Status | Meaning |
|---|---|
| Active | Warehouse is operational. Appears in all dropdowns and selection lists |
| Inactive | Warehouse is temporarily disabled. Hidden from most selection lists but data is preserved |
| Archived | Warehouse is retired. Data is preserved but the warehouse is effectively read-only |
Deactivating a warehouse does not delete its inventories, items, or transaction history. You can reactivate it at any time.
G. Deleting a Warehouse
Warehouses use soft delete. To delete:
- Open the warehouse detail view.
- Click Delete.
- Confirm the action.
The warehouse is marked as is_deleted = true and hidden from all lists. The data remains in the database for audit purposes.
Deleting a warehouse also soft-deletes its inventories (with their items and bins). The delete is refused while any of its inventories is held by an employee (custody stock) and still holds stock or has an open transfer.
Next: Stock & Inventory
See also: Physical Locations | Adjustments | Transfers