| name | commerce-fulfillment |
| description | Manage fulfillment waves, pick tasks, pack tasks, and ship tasks. Use when processing outbound orders through the warehouse pick-pack-ship workflow. |
Commerce Fulfillment
Orchestrate outbound order fulfillment through wave planning, picking, packing, and shipping handoff.
How It Works
- Create a wave to group orders for efficient processing.
- Generate pick tasks for items in the wave.
- Workers complete picks, recording actual quantities.
- Create pack tasks and assign items to cartons.
- Create ship tasks and complete with carrier and tracking.
Usage
- MCP tools:
create_wave, list_waves, release_wave, create_pick_task, complete_pick, create_pack_task, add_carton, create_ship_task, complete_ship.
- Writes require
--apply.
Wave Types
- Batch (default): group multiple orders
- Priority: expedited orders
- Zone: orders for a specific warehouse zone
- Single: one order per wave
Status Flows
Wave: Draft -> Released -> InProgress -> Completed (or Cancelled)
Pick: Pending -> Assigned -> InProgress -> Completed (or Short/Cancelled)
Pack: Pending -> Assigned -> ReadyToPack -> InProgress -> Completed (or Cancelled)
Ship: Pending -> ReadyToShip -> LabelPrinted -> Shipped (or Cancelled)
Package Types
- Box (default), Envelope, Tube, Pallet, Custom
Output
{"status":"shipped","wave_id":"WAVE-2025-001","picks_completed":12,"cartons_packed":3,"tracking":"1Z999AA10123456784"}
Present Results to User
- Wave number and order count.
- Pick completion rates and any short picks.
- Carton counts with dimensions and weights.
- Shipping labels and tracking numbers.
Troubleshooting
- Short pick: item not at expected location; check inventory and create adjustment.
- Wave stuck in progress: verify all pick tasks are completed.
- Carton overweight: split items across multiple cartons.
References
- references/fulfillment-flow.md
- /home/dom/stateset-icommerce/crates/stateset-core/src/models/fulfillment.rs
- /home/dom/stateset-icommerce/crates/stateset-embedded/src/fulfillment.rs
