Barcode scanner not adding items
Why a scan was ignored, what each scan message means, and the scanner settings to check.
Most USB and Bluetooth scanners act like a keyboard: they type the barcode and press Enter. On the sale screen, the scan goes into the search bar and the item is added to the cart.
First checks#
- Scan into a text app (for example Notepad) to confirm the scanner types the full barcode and moves to a new line.
- Make sure the sale screen is showing. Scans don't ring items on other pages.
- Make sure a shift is open. Without one, scans are not added.
- Close any popup or payment screen first.
What the scan messages mean#
- Start a shift first — … was not added. Open a shift, then scan again. See Open and close a shift.
- Scan ignored — … was NOT added. Close payment (or the screen on top) to add it, then scan again. A payment screen or popup was open. BuiltPOS never adds an item behind a payment in progress.
- Open the sale screen to ring up … — it was not added. You scanned on a page that doesn't show the cart (reports, close-out, receipts…).
- Scan … not used — tap a barcode or search field first. On a settings or stock page, tap the barcode or search box, then scan.
- Scan … not used — this field does not take barcodes. The selected box is a quantity, price or name box. Tap a barcode or search box instead.
- Duplicate scan ignored — the scanner sent the same code twice in a row. Scan again if you really want a second one.
"Barcode not found"#
The code isn't in your products yet.
- Tap Sell once at a price… to ring it now at a price you type.
- Or tap Add Product to add it to your catalogue. Adding a product needs an Owner or Admin.
See Quick Add and Quick Edit products.
The wrong item is added, or a code isn't found that should be#
BuiltPOS converts barcodes before looking them up. In Store Management → This Till → Terminal Settings → Barcode Scanner → Scan Conversion you'll find Convert EAN-13 → UPC-A, Convert UPC-E → UPC-A, Convert GTIN-8 → UPC-A and Drop trailing zero. Leave them on unless your products are stored with raw EAN-13, UPC-E or GTIN-8 codes.
Scans type into the wrong box or show a search list#
In Terminal Settings → Barcode Scanner → USB Wedge Listener:
- Switch on Enable global scan capture. (A brand-new Windows install starts with it on; other devices, and tills set up before, start with it off.) With it on, a scan adds the item anywhere on the sale screen, even if no box has the cursor. Recommended for Windows and Android with a USB scanner.
- Set Terminator to match your scanner: Enter (most scanners), Tab, or Timeout for scanners that send nothing after the code.
- Tap Save.
Built-in scanner (Sunmi, Newland, Urovo)#
On these Android devices, switch on Receive scans from the built-in scanner under Terminal Settings → Barcode Scanner → Built-in Scanner. It is off until you turn it on.
Camera scanning (phones and tablets)#
Tap the Scan barcode icon next to the search bar. If you see "BuiltPOS needs the camera to scan barcodes", allow camera access for BuiltPOS in the device's Settings, then try again.
Good to know#
- On iPad and iPhone, use a Bluetooth scanner set to keyboard mode.
- Scanner set-up and models: Barcode scanners. More help: Scanner troubleshooting.
Was this helpful?
Thanks for letting us know.
Sorry it did not help. Tell us what was missing: open Help & Support in the app and choose Report a problem, or email support@builtsofthub.com.
