Warehouses

Warehouse management is an Admin-only feature. Warehouses are physical storage locations linked to stocks and shipping operations.

List Warehouses

GET/warehouses🔒 Session — can viewAny

Paginated list of warehouses.

Create Warehouse

POST/warehouses/store🔒 Session — can create

Create a new warehouse.

Field	Type	Required	Description
name	string	Yes	Warehouse name (1–100 chars, unique)
status	string	Yes	Warehouse status (enum value)
city_id	string	Yes	City ID (must exist)
shipping_company_id	string	No	Default shipping company ID

Show Warehouse

GET/warehouses/{warehouse}/show🔒 Session — can view

View warehouse details.

Update Warehouse

PATCH/warehouses/{warehouse}/update🔒 Session — can update

Update warehouse details.

Field	Type	Required	Description
name	string	Yes	Warehouse name (unique, excluding current)
status	string	Yes	Warehouse status
city_id	string	No	City ID
shipping_company_id	string	No	Default shipping company ID

Delete Warehouses (Bulk)

DELETE/warehouses/delete🔒 Session — can delete

Bulk delete warehouses.

Field	Type	Required	Description
ids	array	Yes	Array of warehouse IDs

Search Warehouses

GET/search/warehouses🔒 Session

Search warehouses for autocomplete. Returns [{id, text}].