Printing (on the POS)

Overview

A printer turns each sale into paper — a customer receipt, a kitchen chit for the line, a delivery docket, or a product label. The POS tablet drives the printers attached to its register, choosing the right template by printer type, paper width, and the job at hand.

Printing is set up in two places. The hardware for each register — make, connection, header text — is defined once in the admin dashboard under POS Settings. On the tablet, Printer Settings lets staff add printers, point them at the kitchen or the counter, and reprint anything. This page covers the tablet side.

Settings live on the register

Everything you add under Printer Settings is saved to the register the tablet is logged in to — not the device. Swap tablets on the same register and the printers come with it. A tablet with no register assigned shows an empty-register prompt instead.

Opening Printer Settings

1. On the POS tablet open Settings (bottom of the tab bar).
2. Under Main, tap Printer Settings.
3. You'll see the list of printers already on this register, plus Add printer to create a new one.

Tapping a printer opens its detail form. The trash icon on a printer's form deletes it from the register.

Adding a printer

Every printer shares a few core fields, then shows extra connection fields that depend on its type.

Field	What it does
Printer type	The driver to use — see the table below. Picking a type changes which connection fields appear. Required.
Printer name	A label so staff can tell printers apart (e.g. Kitchen or Front Counter).
Copy Count	How many copies of each job this printer prints.
Paper width	58mm or 80mm for receipt printers; 40, 50, or 60mm for label printers. The width auto-selects the matching template.

Printer types and how they connect

Printer type	How it connects
Epson	Network — auto-discovery of printers on the LAN, plus an IP address.
Star	Network — IP address.
TSC	Network — IP address. A label printer (barcodes / kitchen labels).
iMin / iMin v2	Network — IP address plus paper width.
Nyx	Network — IP address plus paper width.
Rongta	Network — IP address plus paper width.
Sunmi	Built-in printer on Sunmi hardware — no connection details.
Sunmi-cloud	Cloud — App Id, App Key, Serial number, and Shop Id.
BLE Bluetooth	Bluetooth — the device address.
Adyen	Adyen terminal — API Key, POIID (Terminal ID), and Live Endpoint URL Prefix.
PAX	Built-in printer on PAX hardware — no connection details.
ZPL	A label printer (Zebra-style barcodes / kitchen labels).
Other	A generic network printer — IP address.

Network printers need a fixed address

Network printers (Epson, Star, TSC, iMin, Nyx, Rongta, Other) are reached by IP address, so give each one a static IP on your router. If the address changes the POS can't find it. Epson can also discover printers on the network to fill the address in for you.

What each printer is for

A printer isn't just hardware — you also tell it which jobs to take. These options sit on the same detail form.

Setting	What it does
Support Printing Types	Which jobs this printer accepts: kitchen_chit, delivery_chit, and/or receipt. A printer with no matching type is skipped for that job.
Auto Print	Print automatically at the right moment — receipts on payment, kitchen chits on confirm — without anyone tapping print.
Socket Print	Print orders pushed in over the network (see below), with a channel picker.
Print QR Code	Add a QR code to the printout (e.g. a member sign-up or feedback QR).
Tags	Restrict this printer to specific product categories — so a drinks station only prints drinks, a hot kitchen only prints food.
Copy Count	Number of copies (also shown above). A tip option is available for receipts.

TSC printers can't print receipts

The receipt type isn't available on TSC label printers — they print labels and chits only. Pick a receipt-capable printer (Epson, Sunmi, Star, and so on) for the counter.

Socket Print channels

When Socket Print is on, this printer listens for orders arriving over the network and prints the ones whose source you've ticked:

• customer — orders placed in the member app
• kiosk — self-service kiosk orders
• pos — orders rung up on a POS
• grab — GrabFood
• foodpanda — foodpanda
• keeta — Keeta

This is how an incoming online order lands on the kitchen printer with no one touching the tablet. See Socket auto-print below for how paid online orders are handled.

What's on each printout

Receipt

The customer receipt prints, top to bottom:

• the merchant header (name, outlet)
• the table / order / daily-order number
• a document title — TAX RECEIPT when the order is paid, or PRE-SETTLEMENT BILL when it isn't yet
• the customer name, and the order / receipt / printing / payment times
• the line items with prices
• Sub Total
• Discounts, itemised
• Service Charge
• BCRS Deposit (the SG $0.10 container-return deposit, where it applies)
• GST / Tax
• the Grand Total
• the Payments taken and any Change Amount
• optional total-macros and, for pre-orders, the pickup or delivery time

The 58mm and 80mm layouts are chosen automatically from the printer's type and paper width. Whether the total-macros block prints is set per printer (isPrintTotalMacros).

Bean & Brew example: a customer orders two flat whites. The 80mm counter printer prints a TAX RECEIPT with the two lines, a 9% GST line, the 10% Service Charge, the Grand Total, and PayNow as the payment — all in one tap when Auto Print is on.

Kitchen chit

Kitchen chits print per batch — each time staff confirm an order, the last batch of items fires to the kitchen. A chit lists the items, their modifiers, and any remarks (special requests, best-before notes) so the line can make the order. Subsequent confirms print as Order 2, Order 3, and so on.

Delivery chit

Delivery orders print a delivery chit alongside the kitchen chit, carrying the delivery details for the driver.

Labels (TSC / ZPL)

Label printers print product barcodes and kitchen labels rather than full receipts. TSC uses TSC templates and ZPL uses Zebra templates; both are driven by the label paper widths (40 / 50 / 60mm).

Adyen terminal receipts

When you take payment on an Adyen terminal, the receipt and kitchen text are built from the terminal's own output rather than the standard template, so the card details print exactly as the terminal reports them.

Reprinting

You rarely need to reprint by hand, but you can.

• From the basket — header icons print a quotation/invoice for the current items, a take-out bill, or Print All (a take-out bill for every basket that has items).
• From an order — open the order in the Orders tab, then use its print popover to print the receipt, kitchen chit, or delivery chit again. The Payment successful! screen also offers PRINT/REPRINT RECEIPT and PRINT/REPRINT KITCHEN CHIT straight after a sale.

If no suitable printer is configured you'll see "No printer found to print {type}".

Socket auto-print

The POS keeps a live connection to the order server. When a paid online order arrives — one matching the register's default-paid status, or a cash-on-delivery order fulfilled before payment — and it isn't assigned to the staff member on this tablet, the POS auto-prints its kitchen chit and receipt (plus a delivery chit for delivery orders) and plays a notification sound.

Reprints are safe

Auto-print is idempotent — the same order won't print twice, even if the socket reconnects or the order updates again. So you can leave a kitchen printer running on Socket Print without worrying about duplicate tickets.

This pairs with Socket Print above: tick the channels you want the printer to listen to (customer, kiosk, grab, foodpanda, keeta), and incoming orders print themselves.

Related

• POS Settings — where each register's printer hardware is defined in the admin dashboard.
• Receipt printer not printing — what to check when nothing comes out.
• Payments (on the POS) — taking the tenders that print on the receipt.
• Order management (on the POS) — reopening and reprinting past orders.
• Kitchen Display (KDS) — the screen-based alternative to kitchen chits.