Warehouses — SanadiqCloud

Product version: 1.0.0+1
Last updated: 2026-08-13 Audience: Tenant Owners, Tenant Employees, Regular Users

A. What is a Warehouse?

A Warehouse is a facility at a Location (site address). Stock pools and bins hang under the facility:

Location (address) → Warehouse (facility) → Warehouse zones + Stock pools → Items / bins

Each warehouse has a type (warehouse, distribution_center, retail_store, manufacturing, online_fulfillment), status (active / inactive / archived), and optional manager. Warehouse zones are a separate module (Warehouse Zones) — add them from warehouse detail or Inventory → Warehouse zones. 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:

Use the search bar to filter by name or code. Use the Type and Status dropdowns to narrow results.

C. Creating a Warehouse

1. Click + Create Warehouse on the warehouse list page.
2. Fill in the required fields:

3. 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

1. Navigate to Inventory > Warehouses and click the warehouse row.
2. Click the Edit button (pencil icon).
3. Modify any editable fields. Note that Code may be immutable after creation depending on your tenant configuration.
4. Click Save Changes.

You can update the name, description, type, status, manager, and location assignment.

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 with link to the parent location
• Manager profile snippet (if assigned)
• Created and Updated timestamps

Classification

• Warehouse type — Facility kind
• Status — Whether the warehouse appears in operational dropdowns
• Manager and location — People and site assignment

Zones are not listed as warehouse classification fields. Use Add zone (hero) or Warehouse Zones.

Inline stock pools

Lists inventories (stock pools) in this warehouse. Open a pool 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 stock pool, add zone, barcode search of pools. Create transfer / adjustment / pick list / requisition from the hub Explore tiles, a stock pool (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:

1. Open the warehouse detail view.
2. Click the Status badge or the Edit button.
3. Select a new status:

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:

1. Open the warehouse detail view.
2. Click Delete.
3. 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.

You cannot delete a warehouse that contains active inventories. Archive or delete all inventories first.

Next: Warehouse Zones
See also: Locations | Stock & Inventory | Physical Locations | Adjustments | Transfers