Scanning is part of Register → Sell, not a separate navigation screen. The Barcode icon marks the search/scanner affordance. A local camera or keyboard scan fills product search and still requires selection or Enter on the highlighted result; only a connected-display remote scan with one exact match adds directly. Never assume a beep means the intended item reached the cart.
Before you beginConfirm the business, location, and register in the top bar. Finish or park any active cart before changing register context.
Step by step
- Open Register → Sell and confirm the correct business, location, register, and open session. Clear unrelated product filters when the intended item is not available in the current search scope.
- For a USB or Bluetooth scanner configured as a keyboard, place focus in Search products or scan barcode… when necessary and scan once. The scanner types the printed value; CentriPOS ranks matching products and enabled variants in the result menu.
- Read the highlighted result before pressing Enter. An exact variant code should highlight that variant; selecting a master product with enabled variants opens the variant picker rather than guessing a variant. Click the intended product/variant or use Arrow Up, Arrow Down, and Enter.
- For the device camera, choose the Barcode icon beside product search when that interactive button is present. Allow camera access only on the trusted pos.getcentri.com app and point the rear camera at one code inside the scan box.
- If the camera cannot read the code, type the complete printed MFC, UPC, or barcode in the manual field and choose Capture code, or press Enter there. Camera recognition and Capture code close the scanner and place the decoded value into Sell search; they do not silently choose among ambiguous results.
- CentriPOS search can match product name, SKU, base barcode, active configured product codes, brand, category, tag, supplier, variant name, variant SKU, and variant attributes. Treat a broad text match as a search suggestion, not proof that the printed barcode belongs to that row.
- Barcode identity is exact and case-insensitive after surrounding spaces are trimmed. A product-level match can use the product barcode or an active product code without a variant assignment. A variant-level match can use the variant barcode or an active product code assigned to that exact variant.
- When a printed CentriPOS override label begins with LBL- and has the complete supported token, Sell checks the active label override for the current tenant. A valid unexpired label can add its product/variant with the printed price override or callout note.
- Read override feedback. Label added to register confirms the mapped item was added. Label override is unavailable means the code is missing, inactive, or expired. Label product is unavailable at this register means its mapped product or variant is not currently sellable in this operating context. Label scan failed reports a lookup error.
- For a connected customer display or supported remote scanner, the scan must belong to the same active register session. Checkout activity or another user’s live-sale lock pauses the scan. A remote scan adds directly only when one exact available product or variant is resolved; otherwise it reports No single matching product was found and tells the cashier to resolve it in register search.
- Availability still controls scanning. Product/category location or register restrictions and active Availability Rules can remove a catalog record from Sell even when its barcode is correct. Scanning does not bypass inactive products, disabled variants, operating-context restrictions, or a live-sale lock.
- After every scan, confirm the cart line’s product name, variant, quantity, unit price, label override/callout when applicable, tax, and fulfillment. Scanning the same item again can increase quantity through normal cart behavior; verify the displayed quantity rather than counting scanner beeps.
- If a scan produces no useful result, type or paste the complete printed value into Sell search and compare it with the product and variant’s saved Barcode and active product codes. Then search by product name to keep the sale moving without attaching an unrelated item.
- If more than one result appears for a supposedly unique barcode, stop and have an authorized catalog user resolve the duplicate product/variant codes. Do not choose whichever row appears first simply to complete the sale.
- For camera problems, confirm browser camera permission, close other apps using the camera, improve lighting and focus, or use the manual Capture code field. Cancel closes the camera without changing the cart.
- For hardware-scanner problems, test whether the device types the complete code once into a harmless text field, including any configured Enter suffix. Correct scanner pairing or prefix/suffix settings before retrying in a live cart.
- Before payment, compare the physical label with the final cart one more time. If the wrong row was selected, remove it and add the verified item; do not edit the description or price to disguise a mismatched catalog record.
Screen and contract reference
| Control or area | What it means |
|---|---|
| Barcode icon | Sell search indicator and, in the supported search-bar layout, the button that opens Scan Barcode with the device camera. |
| Search products or scan barcode… | Product search field receiving typed text, keyboard-style scanner input, or a captured camera code. |
| Result menu | Up to the ranked matching products and enabled variants available in the current Sell scope. |
| Arrow Up / Arrow Down / Enter | Keyboard controls for reviewing and selecting the highlighted search result. |
| Variant picker | Opens when a selected master product has enabled variants; a master barcode does not guess which variant is intended. |
| Scan Barcode | Camera dialog using the environment-facing camera with a barcode scan region. |
| Manual code field | Fallback for typing the complete MFC, UPC, or barcode when the camera cannot decode it. |
| Capture code | Trims the manual value, sends it to Sell search, and closes the scanner; it does not bypass result review. |
| Cancel | Stops and closes the camera without adding an item. |
| Product barcode | Base barcode stored directly on the product. |
| Active product code | Additional saved code; without a variant assignment it resolves at product level, and with a variant assignment it resolves only to that variant. |
| Variant barcode | Barcode stored directly on an enabled variant. |
| Exact barcode match | Case-insensitive equality after trimming; distinct from broad product-search ranking. |
| LBL override code | Tenant-specific active, unexpired CentriPOS label token that can carry a mapped product/variant, printed price override, or callout note. |
| Label added to register | Successful override-label confirmation. |
| Label override is unavailable | The override row is missing, inactive, or expired. |
| Label product is unavailable at this register | The override target is not in the current sellable product/variant set. |
| Remote scan | Same-session scan broadcast from a connected customer-display or supported scanner surface. |
| Remote scan paused | Checkout is busy or a live sale is locked by another user. |
| Remote scan needs review | No single exact sellable match exists; resolve it in Register search. |
| Availability enforcement | Product/category location/register restrictions and active rules still apply to scanner results. |
| Cart verification | Required check of exact product, variant, quantity, price, tax, fulfillment, and any label override before payment. |
Expected result
The scanned code adds the correct product and variant once. If it does not match, no unrelated item should be left in the cart.
Troubleshooting
- Confirm the active location, register, and register-session status before repeating the action.
- Do not refresh or retry while a card terminal shows a payment in progress.
- If totals differ, review every cart line, discount, fulfillment charge, and tax before payment.
CentriPOS API explorer · API Center administration
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.