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
- 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.
- Writes require
--apply.
Warehouse Types
- Distribution (default), Manufacturing, Retail, ThirdParty, Consignment, Returns
Location Types
- Bulk, Pick, Staging, Receiving, Shipping, Quarantine, Returns, Production, Packing, CrossDock
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.
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.
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
1---2name: commerce-warehouse3description: Manage warehouses, locations, and inventory movements. Use when setting up warehouses, creating zones/bins, moving stock between locations, or tracking location-level inventory.4---5
6# Commerce Warehouse
7
8Manage warehouse facilities, location hierarchies, and inventory movements across zones, aisles, racks, and bins.
9
10## How It Works
11
121. Create a warehouse with type and address.
132. Define locations within the warehouse (zones, aisles, racks, bins).
143. Track inventory at each location with on-hand, reserved, and available quantities.
154. Move inventory between locations with full audit trail.
165. Adjust location inventory with reason codes and references.
17
18## Usage
19
20- 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`.
21- Writes require `--apply`.
22
23## Warehouse Types
24
25- Distribution (default), Manufacturing, Retail, ThirdParty, Consignment, Returns
26
27## Location Types
28
29- Bulk, Pick, Staging, Receiving, Shipping, Quarantine, Returns, Production, Packing, CrossDock
30
31## Movement Types
32
33- Receipt, Transfer, Pick, Adjustment, Shipment, Return
34
35## Output
36
37```json
38{"status":"moved","from_location":"LOC-A1-01","to_location":"LOC-B2-03","sku":"WIDGET-001","quantity":25}
39```
40
41## Present Results to User
42
43- Warehouse and location identifiers created or updated.
44- Inventory quantities at affected locations.
45- Movement audit trail with reason and reference.
46
47## Troubleshooting
48
49- Insufficient stock at location: check on-hand minus reserved before moving.
50- Location not found: verify the warehouse and location hierarchy exist.
51- Duplicate location code: location codes must be unique within a warehouse.
52
53## References
54- references/warehouse-locations.md
55- /home/dom/stateset-icommerce/crates/stateset-core/src/models/warehouse.rs
56- /home/dom/stateset-icommerce/crates/stateset-embedded/src/warehouse.rs
majiayu000