Barcode scanner

The picking modal uses a global keyboard listener — there’s no input field to focus, no driver, no pairing step. A standard USB or Bluetooth HID scanner that “types” the barcode followed by Enter is supported out of the box.

How matching works

When the modal sees a burst of keystrokes ending in Enter (or after a brief idle gap), it treats the captured string as a barcode and searches the visible order’s line items for a product whose configured match field equals the scanned value.

Two product fields can be used as match keys, individually or together:

• EAN — the standard product ean field.
• Manufacturer number — the standard product manufacturerNumber field.

Set in Settings → Plugins → Packing Slips → Barcode Scanner → Product fields for barcode matching. If you enable both, the scanner searches both fields and reports the first hit.

Quantity scanning mode

There are two ways the scanner can advance a line:

Mode	Behavior
Single scan (default)	One scan marks the whole line item as complete, regardless of quantity. Fastest. Use when picker integrity is enough.
Quantity scan	The scanner increments a per-line counter. The line marks complete only when the counter equals the line quantity. Use when you want to physically count each unit.

In quantity mode the Quantity scan modal appears while you scan and shows progress (e.g. “2 / 5”) so the picker can keep going without looking at the main grid.

Order completion behavior

When the last required line is picked, the modal can either:

• Auto-advance to the next order (or auto-close the modal if it’s the only one), or
• Wait for manual confirmation — you click Next yourself.

Set in Order completion behavior in the scanner card. Auto-advance suits high-volume batches; manual confirmation suits shops where the picker double-checks before committing.

Audio feedback

Three independent sound switches, with one shared delay control:

Sound	When it plays
Success sound	The scanned barcode matched a visible line item.
Error sound	The scanned barcode did not match anything visible.
Order complete sound	The current order’s last required line was just picked.

Sound delay lets you push the plugin’s sound back by 0.0 – 2.0 seconds. Many hardware scanners play their own confirmation beep on a successful read — without a delay, the plugin’s sound steps on the scanner’s beep. A 0.2 – 0.5 second delay usually cleans this up.

Disabled fields

If you have not selected any match field in Product fields for barcode matching, the scanner is effectively disabled and the modal becomes click-only. The settings card shows a warning in that case.

Out-of-order behavior

The scanner only matches against items in the currently visible order(s):

• Order Picking, single mode — only the active order’s lines.
• Order Picking, list mode — all listed orders’ lines, in order of appearance.
• Batch Picking — all selected orders’ lines, deduplicated by product.

If a picker scans an item that belongs to a different order in the wave, the scanner reports a miss. This is intentional — it prevents accidentally marking a future order’s lines while picking the current one.