Bitta Retail POS guide

Scale and weighed items lab

Verify weighed-item selling in stages: manual entry, virtual COM protocol tests, and physical Web Serial scale acceptance - plus the scale-free weighted and price-embedded barcode path.

status: verified applies-to: 1.0.0.121rev: 3

The scale lab verifies weighed-item selling in three isolated stages - manual weight entry, a virtual serial port, and the physical scale over Web Serial - so protocol logic is never confused with browser or hardware acceptance. Weighted and price-embedded barcodes are a separate, scale-free path and are tested alongside.

Two independent paths

Do not confuse these:

  • Weighted or price-embedded barcode: the scanner reads a barcode whose digits already contain the weight, quantity, or price. Bitta Retail POS parses it against Barcode Setup, resolves the mapped Business Central item reference (variant and unit of measure aware), and adds the line immediately. No live scale is involved. See Barcode scanning and Barcode setup.
  • Live scale: a sold-by-weight tile, Price Check Add, an identity-only scan, or a reweigh opens the register's weight surface, which reads the connected scale over the browser's Web Serial channel.

Roles and prerequisites

The administrator configures the terminal and the item; a cashier performs the capture.

  • HTTPS Business Central in Chrome or Edge (Web Serial requires a Chromium browser on a secure origin).
  • A weighed POS item.
  • Browser permission for the serial port, granted through a direct click on Connect Scale.
  • Correct serial settings on the terminal: baud, data bits, parity, and stop bits.
  • A calibrated test weight for the physical stage.

No hardware is required for the manual or virtual COM stages.

Configure

Enable Weighed Item Capture in the Register Profile and the scale mode in the effective Store/Terminal setup. Supported protocol families are Generic (Rice Lake-style), Brecknell NCI/SBI-240, and current CAS. Configure the stable-reading count and a nonnegative tolerance; capture only confirms once the required number of consecutive stable readings agree within tolerance.

Acceptance scenarios

  1. Manual entry: add the weighed item, choose manual weight, enter gross/tare or net as prompted, and confirm. This proves the item, pricing, and audit trail with no device at all. Manual entry appears only when policy permits it.
  2. Virtual COM: pair a virtual serial-port pair, send captured Generic, NCI, and CAS frames from the producer port, and select the consumer port in the Web Serial chooser. This proves protocol parsing and the stable-reading policy without hardware.
  3. Physical scale: connect the scale, confirm the terminal's serial settings, pair through the browser chooser, place the known weight, wait for the required stable reads, and confirm (or reweigh). The first recommended physical certification device is a Brecknell SBI-240, after the virtual stage passes.
  4. Repeat the capture through each entry path that applies to you: the sold-by-weight tile, a scan or identity-only scan, Price check quantity, and item variants.

Suggested test ids for your evidence log: SCALE-MAN-001 (manual), SCALE-VCOM-GEN-001 (Generic), SCALE-VCOM-NCI-001 (NCI), SCALE-VCOM-CAS-001 (CAS), SCALE-PHY-BRECK-001 (physical acceptance).

Expected results

The sale line records the quantity plus an audited quantity source (Manual, Barcode, or Live Scale) and the gross, tare, and net facts. Lines do not merge across incompatible quantity sources. Unstable or error frames are never actionable - the confirm control stays disabled until the reading is stable.

Records and accounting

Weight facts are stamped on the POS sale line; no separate accounting entry is made at capture. Posting uses the stamped quantity to create the Business Central sales line and, once posted, the normal item ledger and value entries.

Recovery

TIP

If a capture looks wrong, cancel and reweigh before confirming - nothing is committed until you confirm. If the scale will not connect or stabilize, recheck in this order: Chromium browser on HTTPS, serial permission, the selected port, the terminal's serial settings, units and parity, checksum or status text in the frames, and the stable-read policy. Remember the chooser only opens from a direct click on Connect Scale.

Use manual entry to keep selling only when the documented policy permits it, and remember that a weighted or price-embedded barcode never needs the live scale. For symptom-based help see Troubleshooting; scale pairing and read events also emit privacy-safe telemetry - see Telemetry and diagnostics.

// next step

Ready to try Bitta Retail POS?