| name | commerce-warehouse |
| description | Manage warehouses, locations, and inventory movements. Use when setting up warehouses, creating zones/bins, moving stock between locations, or tracking location-level inventory. |
Commerce Warehouse
Manage warehouse facilities, location hierarchies, and inventory movements across zones, aisles, racks, and bins.
How It Works
- Create a warehouse with type and address.
- Define locations within the warehouse (zones, aisles, racks, bins).
- Track inventory at each location with on-hand, reserved, and available quantities.
- Move inventory between locations with full audit trail.
- Adjust location inventory with reason codes and references.
Usage
- CLI:
stateset warehouse ... or stateset "list warehouse locations"
- Writes require
--apply.
- MCP tools:
list_warehouses, get_warehouse, create_warehouse, update_warehouse, list_locations, get_location, create_location, get_location_inventory, adjust_location_inventory, move_inventory, list_movements.
Permissions
- Read:
list_warehouses, get_warehouse, list_locations, get_location, get_location_inventory, list_movements — no --apply needed.
- Write:
create_warehouse, update_warehouse, create_location, adjust_location_inventory, move_inventory — requires --apply.
Examples
stateset warehouse create --name "East DC" --type Distribution --apply
stateset warehouse create-location WH-EAST --type Pick --code LOC-A1-01 --apply
stateset warehouse move --sku WIDGET-001 --from LOC-A1-01 --to LOC-B2-03 --quantity 25 --apply
stateset warehouse inventory LOC-A1-01 --include-reserved
Warehouse Types
- Distribution (default), Manufacturing, Retail, ThirdParty, Consignment, Returns
Location Types
- Bulk, Pick, Staging, Receiving, Shipping, Quarantine, Returns, Production, Packing, CrossDock
Status Flows
Warehouse: Active -> Inactive -> Decommissioned
Movement: Pending -> InProgress -> Completed (or Cancelled)
Location: Active -> Inactive -> Blocked
Movement Types
- Receipt, Transfer, Pick, Adjustment, Shipment, Return
Output
{"status":"moved","from_location":"LOC-A1-01","to_location":"LOC-B2-03","sku":"WIDGET-001","quantity":25}
Present Results to User
- Warehouse and location identifiers created or updated.
- Inventory quantities at affected locations.
- Movement audit trail with reason and reference.
- Location utilization and capacity status.
Troubleshooting
- Insufficient stock at location: check on-hand minus reserved before moving.
- Location not found: verify the warehouse and location hierarchy exist.
- Duplicate location code: location codes must be unique within a warehouse.
- Movement stuck in progress: verify both source and destination locations are active.
Error Codes
INSUFFICIENT_LOCATION_STOCK: On-hand quantity minus reserved is insufficient for the requested move.LOCATION_NOT_FOUND: The specified warehouse or location code does not exist in the hierarchy.DUPLICATE_LOCATION_CODE: A location with this code already exists within the warehouse.
Related Skills
- commerce-receiving: Put-away tasks move received goods into warehouse locations.
- commerce-quality: Quality holds block inventory movement at specific locations.
- commerce-backorders: Warehouse stock levels determine backorder allocation.
References
- references/warehouse-locations.md
- /home/dom/stateset-icommerce/crates/stateset-core/src/models/warehouse.rs
- /home/dom/stateset-icommerce/crates/stateset-embedded/src/warehouse.rs
