How to videos

Rundocs › Hardware

Scanner troubleshooting

Last updated 2026-05-15

Barcode scanner acting up at the counter — beeping without entering anything, scanning unwrapped, not detected by the computer? This page is the field guide. For first-time setup, see Hardware setup.

Scanner beeps three times but nothing lands in Rundoo

The scanner read the barcode but couldn't deliver the result to the computer. The handheld unit and its base are out of sync — usually because the scanner drifted out of range, was paired to a different base, or someone scanned a config barcode that broke the link.

Fix: scan the QR code on the side of the base (the small barcode printed on the cradle itself). One short beep means the scanner is paired again. Test by scanning any UPC into Notepad — you should see |0123456789|.

Scanner beeps four times after every scan

The scanner is throwing a battery fault. The handheld unit can read but is rejecting its own output because the battery is mis-seated or running below the threshold.

Fix: pop the battery out, wait 10 seconds, reseat it. Scan a barcode to confirm a single short beep returns. If the four-beep pattern persists, the battery is end-of-life — order a replacement from Rundoo Support or POSGuys.

Scanner isn't detected by the computer at all

The computer doesn't see the scanner as a connected device — no driver popup, no entry in Device Manager (Windows) or System Information (Mac), and config sheets don't take.

Work through these in order:

  1. Try a different USB port. Flaky or partially-failing USB-A ports are common at the counter. Plug the cradle into a known-good port (the back of the computer beats the front; a USB hub introduces failure modes — skip it during troubleshooting).

  2. Try a different cable. USB cables fail more often than scanners. Swap with another scanner's cable if you have one nearby.

  3. Try on a different computer. If the scanner works on another machine, the issue is the original computer's port or USB stack — restart the original computer first, then escalate to your IT or Rundoo Support if it still won't pick up.

  4. Power cycle the cradle. Unplug the cradle from USB, wait 30 seconds, plug it back in. Wait for the cradle LED to settle before re-pairing the scanner.

Scans aren't wrapped with the pipe character

When you scan into Notepad and see 0123456789 instead of |0123456789|, the scanner's prefix/suffix config didn't take. Rundoo uses the pipe wrap as a marker that input is a barcode scan rather than typed text — without it, the cart treats scans like keystrokes and won't add products.

Fix:

  1. Print the config sheet — don't scan it from a screen. Screen rendering varies; printed barcodes scan reliably. Pull Rundoo's DS2278 config sheet from Rundoo Support (or the per-model sheet from Hardware setup) and print it on a regular printer.

  2. Scan the QR code at the top of the printed sheet. One short beep = config applied.

  3. Confirm. Scan any UPC into Notepad and check the wrap.

  4. If it still doesn't take, fall through to manual config with Zebra 123Scan — walkthrough in Hardware setup under Fallback: manual config with Zebra 123Scan.

Scans are landing as new products instead of matching existing ones

The scanner is wrapping correctly, but Rundoo doesn't recognize the UPC because no product is attached to that barcode yet. By design, an unattached UPC scan opens the new-product flow.

Fix: to attach an existing product to that UPC, open the product, go to its Settings tab, focus the Additional IDs field, and scan the barcode while focused there. The number populates; click Save. Subsequent scans of that barcode will add the product to the cart.

Bluetooth scanner won't stay connected

For Bluetooth scanners (Socket Mobile, LS4278, etc.), drops between sales usually mean range or interference — not pairing.

Fix:

  • Move the cradle to within 6 feet of where the scanner is used at the counter.

  • Keep the cradle clear of large metal (steel shelving, register hood) and other 2.4 GHz devices (cordless phones, microwaves).

  • If drops persist, switch to a wired USB scanner. Wired is more reliable at a busy counter and one less thing to charge.

Specific scanner model isn't working

Most mainstream scanners are HID-compatible and configurable with a pipe-wrap config sheet — see the per-model list under Using a non-DS2278 scanner in Hardware setup. If your model isn't there, ask Rundoo Support — we can often find a config sheet, or confirm whether the model is incompatible.