Order state transitions
The picking modal does not own its own concept of “done” — it drives Shopware’s existing order state machine. You decide which states map to “In Progress”, “Complete” and “Incomplete”, and the modal transitions orders into them on the Next button.
The three slots
Section titled “The three slots”Set in Settings → Plugins → Packing Slips → Order Picking:
- Order in progress state — set when the picker starts working on an order. Optional. Leave empty to skip the In Progress transition entirely.
- Order complete state — set when an order is fully picked.
- Order incomplete state — set when Next is clicked while some lines are still unpicked.
Each slot accepts any state_machine_state from the standard order.state machine — Shopware’s own (open, in_progress, completed, cancelled), or any custom state you have added through the State Machine module. The clearable-button on each select lets you wipe a slot if you don’t want that transition to fire.
When the In Progress transition fires
Section titled “When the In Progress transition fires”Two options, set in When to set in progress state:
| Option | Behavior |
|---|---|
| All processing orders immediately (default) | Every selected order is moved to In Progress as soon as the modal opens. Useful when you select a wave and commit to it all at once. |
| Only current order (progressively in single mode) | An order moves to In Progress only when the picker focuses it (in single-order view). Useful when pickers cherry-pick from a long selection. |
Customer emails per transition
Section titled “Customer emails per transition”Three independent switches:
- Send email on In Progress state change
- Send email on Complete state change
- Send email on Incomplete state change
These piggy-back on Shopware’s standard state-machine event emails. If you have configured a Mail template + Event action for that transition, the plugin’s state change fires it; if not, no mail is sent.
Manual vs auto confirmation
Section titled “Manual vs auto confirmation”The Order state confirmation mode controls whether Next pops up a confirmation modal:
| Mode | Confirmation modal shown for |
|---|---|
| Manual confirmation for all orders (default) | Every Next click. Safest. |
| Auto-confirm complete orders only | Skipped when the order is fully picked. Shown for incomplete orders. |
| Auto-confirm incomplete orders only | The inverse. Shown for fully-picked orders, skipped for incomplete. |
| Auto-confirm all orders | No confirmation, ever. Fastest. |
After a confirmed transition, the Show success notification after changing order states switch decides whether to also pop a “state changed” success modal. Useful for new pickers; turn it off once your team is fluent.
Pick List state (Batch Picking)
Section titled “Pick List state (Batch Picking)”A fourth, separate slot — Order state on Pick List print — only fires when you print the Items List PDF from the toolbar:
- All currently selected orders move to that state at print time.
- Optional matching email switch (Send email on Pick List state change).
Common use: pickers print a pick list at the start of a wave, all orders move to pick_list_printed, and the next stage of the workflow takes it from there.
Leaving slots empty
Section titled “Leaving slots empty”If a slot is empty:
- That transition does not fire.
- The Next button still advances visually, but no
statechange is written to the database.
This is useful if you only want the plugin for picking ergonomics and let your existing automation (Flow Builder, etc.) drive states.