Barcode scanning

Scanning is the fastest way to sell with Bitta Retail POS. The scan box under the item tiles takes input from any keyboard-wedge scanner (one that types the code and sends Enter) or from the keyboard. Every scan is checked first against standard Business Central Item References, so the register reads the same barcodes your purchasing and warehouse teams already maintain; POS-specific formats and fields are only fallbacks.

Prerequisites

• The BAA POS - User permission set and a signed-in register. See POS user permissions and Shifts and Z reports.
• Enable Barcode Scanning turned on in POS Setup (Advanced Settings FastTab). When it is off, the scan box is hidden and a scan returns "Barcode scanning is turned off in POS Setup."
• Items mapped to Business Central items, with barcodes on Item References. See Barcode setup and Item catalog setup.

Scan an item

1. Open POS Register. The scan box (Scan or type barcode, then Enter) has focus as soon as the register is ready, so the first scan lands there.
2. Scan the barcode, or type it and press Enter. The box clears, the item is added to the cart, and the box keeps focus for the next scan. In the demo company, 2000000000046 adds Demo Coffee Beans 1 kg.

3. Scan the same item again to raise the quantity. A scan merges into an existing line only when the item, variant and unit of measure all match; a different variant or unit of measure gets its own line.

How a scan is resolved

Bitta Retail POS tries each source in a fixed order and stops at the first match:

1. Item References of type Bar Code whose Reference No. equals the scanned text. References outside their Starting Date and Ending Date (compared with the work date) are ignored.
2. POS Barcode Setup formats. Each active format that fits the barcode length, prefix and check digit extracts an item code, and optionally a quantity or a price. The extracted item code is looked up through Item References again.
3. The Barcode field on the POS item, for older catalogs that keep a barcode there.
4. The POS Item No. itself, so typing an item number also works.

The resolved Business Central item must map to exactly one active POS item. If it maps to none, or to more than one, the scan is refused with a message that names the barcode and the Business Central item, so a manager knows what to fix.

Variants and units of measure

An Item Reference can carry a Variant Code and a Unit of Measure. A scan of that reference adds exactly that variant and unit, with no variant picker. In the demo company, the Medium T-shirt barcode 2000000000105 adds the Demo T-Shirt line Medium (M).

• A reference whose unit of measure is not set up for the item is refused: "Barcode ... refers to unit of measure ..., which is not configured for Business Central item ...".
• A reference without a unit of measure sells in the POS item's base unit.
• A reference without a variant follows the item's variant rules: the default variant if one is set, a refusal if variants are mandatory, otherwise no variant. See Sell item variants.

Weighted and price-embedded barcodes

Scale and deli labels carry the item code plus a weight or a price inside the barcode. The formats live on POS Barcode Setup List, and Create Default Barcode Setups adds three:

Code	Prefix	What it reads
STANDARD	none	13 digits: a 12-digit item code and a check digit. Quantity is always 1.
WEIGHTED	2	5-digit item code, then a 5-digit weight with 3 decimals, one unused digit, then a check digit.
PRICED	3	6-digit item code, then a 4-digit price with 2 decimals, one unused digit, then a check digit.

A weighted barcode adds its embedded quantity immediately, with no scale. A price-embedded barcode applies its embedded price to the line as an explicit barcode-price override instead of the normal price calculation.

Scanning a plain identity barcode for an item marked Sold by Weight is different: it opens the weight capture surface so the weight comes from a scale or is entered by hand. See Sell by weight with scales.

When a scan does not resolve

An unknown barcode shows a red alert under the scan box: "No POS item matches barcode ... Try again, or ask a manager to add the item." It is never a dialog, so it cannot steal focus. The alert clears when you start typing or scanning again, and on its own after 8 seconds.

Other refusals use the same inline alert:

• Duplicate references: "Barcode ... has more than one active Business Central Item Reference." Remove the duplicate before scanning again.
• Blocked variant: "Variant ... of item ... is blocked and cannot be sold."
• Mandatory variant missing: "Item ... has variants. Scan the variant barcode or pick the variant on the item."

What's next

Sell items that come in sizes and colors: Sell item variants. To check what each register shows, see Setups by store type.