Printer & Scale In The Android App
Connect a Bluetooth receipt printer and a Bluetooth weighing scale to a phone or tablet running the till, print the receipt after each sale, open the cash drawer on cash sales, and weigh items sold by weight straight into the line.
This is the app’s version of Receipt Printers & Cash Drawers on the web. It works only in the Android app, with classic Bluetooth (serial) devices that are paired with the phone. Bluetooth Low Energy (BLE) printers and scales are not supported. A device with no Bluetooth shows a note instead of the settings.
Before You Start
- You need the Use POS permission. The Printer & Scale button shows on Point of Sale only to people who hold it.
- The settings are saved on the phone, not on your account or workspace. Set up each till phone on its own.
- Pair the printer and the scale in Android’s own Bluetooth settings first. Their PIN is often 0000 or 1234.
- On Android 12 and later, allow Nearby devices when the app asks, so the till can reach them.
Set Up The Receipt Printer
- Open Point of Sale and tap Printer & Scale. Tap Refresh devices if the printer is not listed, or Bluetooth settings to pair it.
- Under Receipt printer, tap the printer. Printers are listed first.
- Choose the Paper width: 58mm or 80mm.
- Leave Print the receipt after each sale on to print without asking.
- Tap Test print. The test page shows the paper width, bold and right-aligned text, a QR code and a cut. If the QR code is missing, the printer has no built-in QR support.
The printer must understand ESC/POS, the language most thermal receipt printers use. Tap Forget printer to stop printing from this phone.
What Prints After A Sale
- A sale saved online prints the same receipt the web till prints straight to a printer, eTIMS QR code included. It uses the paper width set on the sale’s POS counter, not the width chosen on this phone.
- A sale captured offline prints a receipt marked PROVISIONAL RECEIPT and Not yet synced, at this phone’s paper width. The prices and tax are the ones the phone held; the final receipt follows once the sale syncs.
- Printing never holds up a sale. If the printer is off, out of range or out of paper, the sale is still saved and a short message says the receipt was not printed.
- With Print the receipt after each sale off, nothing prints from the app.
The Cash Drawer
Plug the drawer into the printer’s drawer port. The app opens it by sending the open signal with the receipt, so it opens only when a receipt prints.
- Online, the drawer opens for a cash sale when the counter has Open the cash drawer on cash sales ticked on the web.
- Offline, the provisional receipt opens the drawer for every cash sale.
- M-Pesa and card sales do not open it.
Set Up The Scale
- On Printer & Scale, under Scale, tap the paired scale.
- Set the Unit when the scale sends none: kg, g or lb.
- Tap Live reading and put something on the scale. The weight shows with Steady, Settling… or Overload, and the last line the scale sent.
- Tap Stop reading when it looks right. Tap Forget scale to remove it.
The scale must stream its readings on its own. The app understands, without setup: ST/US indicator lines (A&D, CAS, Ohaus and most generic indicators), Mettler Toledo MT-SICS, XK3190 “=” lines, and a plain number with a unit. For anything else, type a Custom format (optional) pattern with brackets around the number, and a Steady when the line matches (optional) pattern such as ^ST. A scale that only answers a command is not supported. Without a steady flag, a reading counts as steady after four equal readings in a row.
Selling By Weight At The Till
- Add the item to the sale. A Weigh button shows next to Qty when a scale is set up on this phone and the item’s unit of measure is a weight: kg, g, t or lb.
- Tap Weigh and put the item on the scale.
- The first steady reading above zero is converted into the item’s unit and placed in the quantity. An unsteady or overloaded reading is shown but never used.
The scale is connected only while the weigh sheet is open. Items counted in pieces never show the Weigh button, so a weight cannot land in a count of pieces. See Units of Measure & Decimals for setting an item’s unit.
Barcode Scanning
Scanning at the app till uses the phone’s camera, not a device set up on this screen. A scanned item already on the sale adds one to its quantity. A barcode that matches nothing offers Search by name, Sell as open item where open items are allowed, or Ask a manager to register it when online. People with Edit items see those barcodes under Unknown Barcodes on Point of Sale.
Common Issues
- “No paired devices.” Pair the device in Android’s Bluetooth settings, turn Bluetooth on, then tap Refresh devices.
- “Allow Nearby devices for AWRA in Settings.” The Bluetooth permission was refused. Allow it in the phone’s app settings.
- The receipt is the wrong width. An online sale prints at its counter’s paper width. Change it on the counter on the web.
- No Weigh button. No scale is set up on this phone, or the item’s unit is not a weight unit.
- The weight never settles. Use Live reading to see what the scale sends, and add a custom format or steady pattern if needed.
- The drawer does not open. Check it is plugged into the printer, that auto-print is on, and, for online sales, the counter’s open-drawer setting.
Feature overview: Point of sale.
Need help with this topic?
Capture the module, record number, branch or warehouse, user, visible message, and what you expected to happen before contacting support.