Skip to content

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.

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.

Two options, set in When to set in progress state:

OptionBehavior
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.

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.

The Order state confirmation mode controls whether Next pops up a confirmation modal:

ModeConfirmation modal shown for
Manual confirmation for all orders (default)Every Next click. Safest.
Auto-confirm complete orders onlySkipped when the order is fully picked. Shown for incomplete orders.
Auto-confirm incomplete orders onlyThe inverse. Shown for fully-picked orders, skipped for incomplete.
Auto-confirm all ordersNo 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.

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.

If a slot is empty:

  • That transition does not fire.
  • The Next button still advances visually, but no state change 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.