commerce-warehouse
Manage warehouses, locations, and inventory movements. Use when setting up warehouses, creating zones/bins, moving stock between locations, or tracking location-level inventory.
SKILL.mdskills/commerce-warehouse/SKILL.md
GitHubCommerce 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 ...orstateset "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--applyneeded. - 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