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