Sales

Find, Scan and Add Items to a Sale

The item box is the cashier's first control: it accepts item names, SKU values and barcode scans, and it can fall back to quick sale only when that is the right business choice.

Menu path
Home -> New Sale -> Find item name, sku or barcode
Verified from
Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence

frontend/modules/sales_write.html #sales_new_item_name placeholder and item/category/recent tabs, frontend/static/script/js/modules/js/sales.js scannerDetection, addByBarcode, renderRecentItems and autocomplete fallback, frontend/static/script/js/modules/js/sales.js cameraScan BarcodeDetector path, api/src/repositories/item.repository.js getOnlineItemsAjaxList barcode and normal search conditions

Item search fieldThe live search field accepts item name, SKU or barcode; scanner input lands in the same place.
Search suggestionSuggestions show the item, category, price and stock state so cashiers can choose the right product.
No-match decisionsWhen no product matches, the cashier sees separate choices for Quick Sale and Create item.
Barcode sourceScanning works only when the item record has the SKU, Barcode or Extra barcodes the counter will use.
Cart confirmationEvery searched, scanned or tile-selected item must be checked in the cart before tender.

What the Item Search Accepts

The New Sale search box is intentionally broad. The placeholder in the current app says Find item name, sku or barcode, and the barcode scanner handler uses that same input.

  • Type part of an item name when the cashier knows the product name.
  • Type or scan the SKU when the shop uses SKU as the internal lookup value.
  • Scan the product barcode when the item record has the matching barcode.
  • Search suggestions show product name, category, price and stock status.
  • Click an item tile when it is already visible in the Items tab.
  • Use the camera button only on devices where Chrome or Edge exposes BarcodeDetector and camera permission is allowed.
  • Use recent items when the cashier repeatedly sells the same fast-moving products.
  • When no result exists, Posnic offers Sell as quick sale and Create item as separate actions.

Read the Suggestion Row

Suggestion detailWhat it tells the cashierWhat to do
Item nameThe exact product that will enter the sale.Stop if the name is similar but not exact.
CategoryThe product group, useful when names repeat.Use it to distinguish variants or departments.
PriceThe current selling price after item tax/discount behavior.Confirm with shelf label before overriding.
Stock badgeIn stock, low stock, out of stock, service or not tracked.Do not force a tracked out-of-stock product without owner approval.
Fallback actionNo catalog item matched.Create the item for reusable stock, Quick Sale only for one-off amounts.

Add a Catalog Item

  1. Open Home -> New Sale.
  2. Click inside Find item name, sku or barcode.
  3. Type the item name, SKU or scan the barcode.
  4. Choose the correct suggestion from the list.
  5. Confirm the cart line shows the correct item name, quantity, price and tax.
  6. Use the item tile instead of the search result when the product is already visible on the screen.
  7. If the wrong item appears, remove the cart line before continuing.
  8. Repeat for every product before opening PAY.

Use a Hardware Barcode Scanner

Most USB/Bluetooth barcode scanners behave like a keyboard: they type the code and press Enter. Posnic listens for that fast input pattern and calls the barcode add path.

  • Keep the cursor in the item search field before scanning.
  • Set the scanner to send Enter at the end of a code.
  • Use clean, unique item barcodes; do not reuse the same barcode for multiple items.
  • The scanner path searches primary Barcode and Extra barcodes for barcode mode.
  • If Track inventory is on and Negative Stock is off, the barcode path checks available quantity before adding the item.
  • If the scanner types slowly like a keyboard, Posnic treats it as manual text and shows suggestions.
  • If Posnic says the barcode item was not found, fix the item record before blaming the scanner.

Use Camera Scan

The camera scan button appears only when the runtime supports camera barcode detection. When a code is found, Posnic sends it into the same add-by-barcode path as a hardware scanner.

  • Use Chrome or Edge where camera BarcodeDetector is available.
  • Allow camera permission when the browser asks.
  • Point the camera at one clear barcode at a time.
  • Close the scan modal if the camera view is unclear and use manual search instead.
  • Do not depend on camera scan for live checkout until it has been tested on the actual counter device.

If Scan or Search Fails

SymptomLikely reasonCorrect action
No suggestion appearsName, SKU or barcode does not match a current item.Open Items and verify item name, SKU and barcode.
Wrong item appearsDuplicate or reused code.Fix duplicate SKU/barcode values before using scanner checkout.
Camera button missingDevice/browser does not support BarcodeDetector or camera access.Use hardware scanner or manual search.
Item exists but cannot sellStock, status, branch or price settings block the sale.Review the item record and inventory settings.
Customer is waitingThe product is missing from catalog.Use the missing-item decision rules instead of guessing.