Modal walkthrough
This page is a guided tour of the picking modal as it appears when you click Packing Slips from the order list toolbar.
Toolbar (top)
Section titled “Toolbar (top)”| Control | What it does |
|---|---|
| View toggle | Switch between Order Picking and Batch Picking. Persists for the session; the default is set in plugin settings. |
| Print ▾ | Drop-down with Packing Slips (one per order) and Items List (consolidated pick list). Both render via the plugin’s PDF pipeline; the file is downloaded inline. |
| Next | Advances the workflow — transitions the current order (or all orders, depending on the In progress / Complete state config) and optionally sends an email. See Order states. |
| Close (×) | Closes the modal. No state is changed if you close before clicking Next. |
Order header (Order Picking only)
Section titled “Order header (Order Picking only)”Per order, you see:
- Order number — clickable, opens the standard Shopware order detail in a new tab.
- Total quantity — sum of physical line-item quantities (after filtering, e.g. minus digital items).
- Ship-to / Bill-to addresses — purely informational; not editable here.
- Customer comment — checkout note, if enabled in the Modal window | Order Picking card.
Items list
Section titled “Items list”Each row represents one order line. Columns (configurable):
| Column | Source |
|---|---|
| Photo | First product image (cover) — toggle in modalOrdersListItemsListColumns / modalItemsListColumns. |
| Product name | Always shown. Variant attributes rendered with optional bold + color tint. |
| Product number | SKU, optional. |
| Manufacturer number | Optional. Also used as a scanner-match field if enabled. |
| EAN | Optional. Also used as a scanner-match field. |
| Quantity | Required count. Highlighted (color + background) if greater than 1, when the highlight switch is on. |
| Stock | Current warehouse stock for the product. Optional. |
| Available stock | Shopware’s availableStock. Optional. |
| Custom field | One custom-field column per layout — pick any product custom field in settings. |
Picking interactions
Section titled “Picking interactions”- Click row — marks the line picked (or unpicked if it was already picked). The row visually changes state.
- Scan barcode — the EAN / manufacturer number scanner watches global keyboard input. On a hit, the matching row is marked and the success sound plays.
- Quantity scan mode — instead of one click marking the whole line, each scan increments a per-row counter until it reaches the required quantity. Useful when the same SKU appears multiple times and you want to verify each unit.
Status messages
Section titled “Status messages”Several auxiliary modals appear over the picking modal:
- EAN scanner modal — flashes during a scan to show the captured code; turns red if no match was found, green on hit.
- Quantity scan modal — appears in quantity mode while you scan multiple units of the same item.
- Change order state modal — confirmation dialog before transitioning state on Next (when manual confirmation is selected).
- Success notification modal — optional confirmation that the state change went through.
- Message modal — generic surface for warnings (e.g. “some digital items were hidden due to the plugin configuration”).
Sticky headers
Section titled “Sticky headers”Column headers stick to the top of the items list as you scroll. Toggle in settings (modalOrdersListStickyHeader / modalItemsListStickyHeader). Recommended on; particularly useful when an order has dozens of lines.
Keyboard
Section titled “Keyboard”The scanner reads global key events, so the modal is “always listening” — you do not need to click into an input. Be aware that this means any text field inside the modal that you click into temporarily redirects keystrokes to that field; close it or click outside to resume scanning.