Scale barcodes | QuickTill Help Centre

QuickTill supports offline EAN-13 labels containing a scale prefix, a product PLU, a weight value, and the EAN check digit.

The default DIGI profile is:

20 0042 001235 3
│  │    │      └─ EAN-13 check digit
│  │    └──────── 1.235 kg
│  └───────────── product scale PLU
└──────────────── scale prefix

Server setup¶

Apply the Django migrations:

python manage.py migrate_schemas

For each scale product, edit the product in QuickTill or Django Admin:

Enable Sold by weight.
Enter the same Scale PLU programmed on the label scale.
Select KG unless the inventory price and quantity are explicitly maintained per gram.
Maintain inventory quantity and unit price in that selected unit.

Scale PLUs are unique inside a tenant.

Scale setup¶

For the SM-100 default profile:

Select EAN item barcode output.
Use F1F2 CCCC XXXXXX CD.
Set the right-side value to weight.
Set the flag/prefix to 20.
Program each product PLU to match QuickTill.

Print known test labels before going live and confirm that 001235 represents 1.235 kg with the selected scale decimal setting.

POS setup and operation¶

Open the Sell screen and select Scale 20 to change the device profile. The complete profile is stored locally and continues working offline.

Barcodes can be supplied by:

Android camera
USB or Bluetooth keyboard-wedge scanner
The normal search/barcode field followed by Enter
The keyboard button beside the camera button

QuickTill first checks for an ordinary full product barcode. If none exists, it validates the configured scale prefix and EAN-13 checksum, extracts the PLU and weight, and resolves the product from cached inventory. Invalid checksums, unknown PLUs, zero weights, and weights above the configured limit are rejected.

Scale-derived quantities are locked in the cart. To correct a weight, remove the line and scan the correct label. Multiple package labels for the same PLU merge into one cart line while retaining every raw barcode in the sale audit data.