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
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 detail | What it tells the cashier | What to do |
|---|---|---|
| Item name | The exact product that will enter the sale. | Stop if the name is similar but not exact. |
| Category | The product group, useful when names repeat. | Use it to distinguish variants or departments. |
| Price | The current selling price after item tax/discount behavior. | Confirm with shelf label before overriding. |
| Stock badge | In stock, low stock, out of stock, service or not tracked. | Do not force a tracked out-of-stock product without owner approval. |
| Fallback action | No catalog item matched. | Create the item for reusable stock, Quick Sale only for one-off amounts. |
Add a Catalog Item
- Open Home -> New Sale.
- Click inside Find item name, sku or barcode.
- Type the item name, SKU or scan the barcode.
- Choose the correct suggestion from the list.
- Confirm the cart line shows the correct item name, quantity, price and tax.
- Use the item tile instead of the search result when the product is already visible on the screen.
- If the wrong item appears, remove the cart line before continuing.
- 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
| Symptom | Likely reason | Correct action |
|---|---|---|
| No suggestion appears | Name, SKU or barcode does not match a current item. | Open Items and verify item name, SKU and barcode. |
| Wrong item appears | Duplicate or reused code. | Fix duplicate SKU/barcode values before using scanner checkout. |
| Camera button missing | Device/browser does not support BarcodeDetector or camera access. | Use hardware scanner or manual search. |
| Item exists but cannot sell | Stock, status, branch or price settings block the sale. | Review the item record and inventory settings. |
| Customer is waiting | The product is missing from catalog. | Use the missing-item decision rules instead of guessing. |