CentriPOS has multiple scanner behaviors. The general camera dialog captures one code and closes; purchase-order receiving scans continuously; a USB/Bluetooth scanner types into the focused field; a remote customer-display scan adds only one unambiguous sellable match.

Before you beginRecord the exact screen, time, expected behavior, and smallest repeatable steps. Remove unnecessary customer and payment data from screenshots.

Step by step

  1. First identify the workflow. In Sell, the barcode button beside Search products or scan barcode… opens the one-code camera dialog. In a product or variant form, the camera captures a code into that field. In Receive Stock, Scan Barcode opens continuous receiving mode.
  2. For camera scanning, allow camera access and point the rear/environment camera at the full code inside the scan box. The general dialog closes after a successful decode. If it cannot read the label, type the printed MFC, UPC, or barcode and choose Capture code or press Enter.
  3. In Sell, a normal captured code becomes the search value; review and choose the intended result. A USB/Bluetooth scanner behaves as typed input, so keep the Sell search or intended Barcode field focused. Do not assume the scanner’s Enter suffix completes or adds a normal search result.
  4. A printed label-override code has the form LBL- plus eight letters/numbers. In Sell, an active, unexpired override can add its exact product/variant automatically with the saved unit-price override and callout note. If the product is unavailable at the current register, CentriPOS refuses it.
  5. A remote customer-display scan adds directly only when exactly one exact barcode match resolves among products allowed at the current location/register. Checkout activity or a live sale lock pauses remote scanning; no match or multiple matches returns Needs review and tells the register user to resolve it with search.
  6. For Receive Stock, choose Scan Barcode and scan product or case-pack barcodes continuously. A product/variant barcode adds one unit; a packaging barcode adds its configured units-per-pack, capped at the remaining PO quantity. The same code is ignored for two seconds to prevent camera duplicate reads. Choose Done Scanning when finished.
  7. If receiving says No matching product for barcode, confirm the code belongs to a remaining PO line or a packaging-unit barcode mapped to that same product and variant. Receiving’s camera dialog has no manual-code input, so enter the quantity directly when the camera cannot decode.
  8. For a catalog field, scan or manually capture the code, then save the product/variant form. Product-level matching uses the product barcode and active product codes without a variant; variant matching uses the variant barcode and active codes assigned to that variant.
  9. When characters do not appear from a USB/Bluetooth scanner, test in a plain text field, then check power, pairing/cable, keyboard mode, focus, and scanner suffix. When the camera preview does not start, recheck browser camera permission, secure-site access, and whether another app owns the camera; the current dialogs log camera-start errors but do not show a detailed on-screen error.
  10. When a code finds no result, compare the exact trimmed code without assuming SKU is a barcode alias. Check product Barcode, variant Barcode, and active additional product-code rows. Search can find broader product identifiers, but exact automatic matching uses barcode aliases.
  11. When a remote scan reports no single matching product or a normal search shows several candidates, look for duplicate product- and variant-level barcode aliases. Correct the catalog data rather than choosing an arbitrary item. Retest at the same location and register because sellable availability is part of exact remote resolution.

Screen and contract reference

Control or areaWhat it means
General camera dialogUses the environment-facing camera at 10 fps, captures one decoded value, calls the screen’s scan action, and closes.
Capture codeManual fallback for the general camera dialog; trims the entered value and submits it.
Keyboard-wedge scannerUSB/Bluetooth scanner that types characters into whichever field currently has focus.
Normal Sell scanPopulates Sell search; the cashier reviews and selects the intended product unless a specialized override path applies.
Exact barcode aliasCase-insensitive trimmed product barcode, active product code, variant barcode, or active variant-assigned product code.
Product-level codeProduct barcode or active additional code with no variant_id.
Variant-level codeVariant barcode or active additional code assigned to that exact variant.
LBL overrideActive label_scan_overrides record matching LBL-[A-Z0-9]{8}; it can carry product, variant, price override, and callout note.
Remote scanCustomer-display broadcast that adds only one unique exact match among products sellable at the active location/register.
Continuous receive scannerStays open for repeated PO scans and suppresses the same decoded text for two seconds.
Packaging barcodeReceiving-only mapped code whose scan increments the PO line by units-per-pack rather than one.
Remaining capReceiving never increments a line above its still-receivable quantity.
No visible camera errorCamera-start failures currently go to the browser console; use permissions/device checks or manual input where offered.
Duplicate matchMore than one exact alias resolves the same scanned code; automatic remote add returns no match and requires catalog correction.

Expected result

A controlled barcode scan enters the complete code once and resolves to the correct CentriPOS product or configured override without adding an unrelated item.

Troubleshooting

  • Capture the exact screen, time, expected result, and smallest repeatable steps.
  • Remove unnecessary customer and payment information from screenshots.
  • Include only safe receipt, order, or record references when contacting support.

More guides

Build an itemized payment in MoneyUse Products or Amount & description to build one receipt, attach the customer, and follow the appropriate payment or service-estimate workflow.
Take a one-time payment in Virtual TerminalReview a one-time amount, tax and contact at the correct payment station, use its verified secure checkout, and recover the original receipt after an uncertain result.
Review booking payments, refunds and earned careKeep a booking’s customer payments, unused advances, completed care, cancellation fees and refunds distinct, then read a correctly scoped accrual report.
Configure booking properties and customer pagesSet accommodations, service packages, availability, required intake and payment terms, then review the correctly branded booking page before sharing it.