Warehouses

The Warehouses page lists all warehouses in the inventory service. Each warehouse represents a physical or logical storage location where stock is received, stored, and shipped. Warehouses are either Simple (stock tracked at the warehouse level) or Bin-Managed (stock organized into bin locations within the warehouse).

Accessing the Page

Navigate to Inventory → Stock → Warehouses in the sidebar, or go to /inventory/stock/warehouses.

List Columns

Column	Default Visible	Sortable	Description
Code	Yes	Yes	Unique warehouse code (uppercase)
Name	Yes	Yes	Warehouse display name
Type	Yes	No	Simple or Bin-Managed
Status	Yes	Yes	Active or Inactive badge
Default	Yes	No	Indicates the default warehouse for the tenant

Status Values

Status	Description
Active	Warehouse is available for stock operations
Inactive	Warehouse is disabled and excluded from dropdowns

Warehouse Type Values

Type	Description
Simple	Stock is tracked at the warehouse level without internal bin organization
Bin-Managed	Stock is organized into bin locations; bin assignment is required on transfer lines

Filtering

Filter	Type	Description
Search	Free text	Searches by code or name
Status	Dropdown	Active, Inactive, or All (default shows Active)

Sorting

Click any sortable column header to sort:

• First click — Ascending (A→Z, 0→9)
• Second click — Descending (Z→A, 9→0)
• Third click — Remove sort

Default sort: Name ascending.

Pagination

The list uses a Load More pattern:

• Page size: 20 records per load
• Load More button appears at the bottom when more results exist
• Total record count displays above the table

Actions

Page Actions

Action	Description
Create Warehouse	Opens the Create Warehouse dialog

Row Actions

Each row has a dropdown menu:

Action	Description
Edit	Opens the Edit Warehouse dialog
Delete	Deletes the warehouse after confirmation

Creating a Warehouse

Click Create Warehouse to open the Create New Warehouse dialog.

Fields

Field	Required	Type	Description	Default	Validation
Code	Yes	Text	Unique warehouse identifier — converted to uppercase on save	—	Max 20 chars; real-time async uniqueness check
Name	Yes	Text	Warehouse display name	—	Max 100 chars
Description	No	Textarea	Optional description	—	Max 500 chars
Warehouse Type	Yes	Select	Simple or Bin-Managed	Simple	Cannot be changed after creation
Allow Negative Stock	No	Toggle	Permits stock levels to go below zero	Off	—
Set as Default Warehouse	No	Toggle	Makes this warehouse the tenant default	Off	—

When Bin-Managed is selected, an info notice appears: system bins (Receiving, Shipping, Damaged) are created automatically.

The Code field validates in real-time with a debounced check. A green border confirms availability; a red border and message indicate a duplicate. The submit button is disabled while validation is in progress.

After successful creation, the dialog closes and the new warehouse appears in the list.

Editing a Warehouse

Click the row actions menu and select Edit to open the Edit Warehouse dialog. The edit form uses the same fields as Creating. The following fields are read-only after creation:

• Code — displayed but locked
• Warehouse Type — displayed but locked with a note that type cannot be changed

Editable fields in edit mode:

Field	Required	Type	Description	Validation
Name	Yes	Text	Warehouse display name	Max 100 chars
Description	No	Textarea	Warehouse description	Max 500 chars
Allow Negative Stock	No	Toggle	Permits stock below zero	—
Set as Default Warehouse	No	Toggle	Sets this as tenant default	—
Active	No	Toggle	Activates or deactivates the warehouse	—

Deleting a Warehouse

1. Click the row actions menu on the target warehouse and select Delete
2. A confirmation dialog asks: “Are you sure you want to delete warehouse [Name]?”
3. Click Delete to confirm — the warehouse is removed from the list

Warehouses with existing stock transactions cannot be deleted. Deactivate them instead by editing and toggling Active to off.

Common tasks

1. Open the page from Inventory → Stock → Warehouses.
2. Click Create Warehouse to add a new warehouse, or click a row action to edit an existing one.
3. Complete the form and save — the list refreshes to reflect the change.

Related Pages

• Bin Locations — Manage bin locations within Bin-Managed warehouses
• Stock Levels — View current stock quantities per warehouse
• Stock In — Receive inventory into a warehouse
• Stock Out — Issue inventory from a warehouse
• Stock Transfers — Move inventory between warehouses