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

  1. Click + Create Warehouse on the warehouse list page.
  2. 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
  1. 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 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:

  1. Open the warehouse detail view.
  2. Click the Status badge or the Edit button.
  3. 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:

  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.

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