Till settings (printer, scale, customer display)

Use this page when you need to pair or re-pair a printer, scale, or customer display on the till, or change how the till behaves at the counter.

Goal

You need to set up or change the till's hardware (receipt printer, scale, customer-facing display, cash drawer) so sales work the way your store expects.

Where this happens

• On the till (Retail POS App or Restaurant POS App): open Settings from the till home screen or drawer (Restaurant POS route /settings, view SettingsView.vue).
• In the back office (Core App): the till's hardware registration lives at the franchise level — your franchise admin can re-register a device.

Prerequisites

• You are signed in to the till with a role that has Settings permission.
• The hardware is plugged in (USB or network) or paired over Bluetooth / Wi-Fi.
• Your franchise admin has approved the device; some franchises only allow approved hardware.

Steps

1. Open Settings on the till

On the till home screen or drawer, open Settings (route /settings). The screen opens on the General tab. The other tabs are: Printer, Special, Display, LED.

2. Set up the printer and cash drawer (Printer tab)

1. Tap the Printer tab.
2. Pick the receipt printer from the printers available on the till.
3. Set the Cash Drawer — pick which printer controls the cash drawer from the dropdown.
4. Print a test receipt to confirm the connection and the drawer kick.

3. Pair the scale (General tab — Scale Configuration)

1. On the General tab, scroll to Scale Configuration.
2. Tick Use Scale Integration to enable the scale.
3. Pick the Scale COM Port, Baud Rate, Data Bits, and Parity the scale uses.
4. Pick the Scale Model / Protocol — CAS / Basic Scale, Sangjie, or Digi.
5. (Optional) set Decimal Places and Scale Unit (kg / g / lb).
6. Place a known weight on the scale to confirm the reading matches.

4. Pair the customer-facing display (Display tab)

1. Tap the Display tab.
2. Pick the Customer Display Screen from the dropdown.
3. Tick Enable Customer Display.
4. Use Open Customer Display to test it (shows the running total during a sale); Close Customer Display when done.

5. Cash drawer tests

The cash drawer opens automatically when the till prints a receipt or ends a cash sale. To test the drawer, print a test receipt from the Printer tab. The drawer kick on the printer you selected in step 2 is what fires the drawer.

6. Save and restart the till (if asked)

Some settings only apply after a till restart. If the screen asks, close the till app and re-open it; do not power off the device.

Expected result

• Every paired device appears in the relevant Settings tab as enabled / connected.
• A test receipt prints from the paired printer and the cash drawer kicks.
• A test weight shows correctly on the till when placed on the scale.
• The customer display mirrors the running sale total.

Edge cases

• A device is not discovered. Check the cable, network, or Bluetooth pairing; restart the device. If still missing, ask your supervisor — some hardware is only allowed at the franchise level.
• The printer prints the wrong characters. The wrong character set is selected; ask your supervisor to set the correct one in Settings → Printer.
• The scale weight is off. Zero or tare the scale from Settings → General → Scale Configuration, or ask your supervisor to recalibrate.
• The till asks for a registration code. The till is not registered to your franchise yet; contact Support with the till's device ID.
• You cannot see Settings on the till. Your role may not have Settings permission; ask your supervisor.

Related

• Till apps (Retail + Restaurant)
• Working offline
• Support & escalation