Yammbo Food POS works without a printer, but you can connect printers for receipts and kitchen tickets, a cash drawer, a barcode scanner and a customer-facing display.
Printers
The printer list is per tablet: it is not shared with the others. If you use two tablets, set up the printers on each one.
Add a printer
- Go to Settings > Printers and hardware > Printers.
- Tap Add printer.
- Type a Name, for example Kitchen.
- Under Connection choose how it connects (see below).
- Under Paper width choose 58 mm or 80 mm, depending on your printer.
- Mark what you want it for:
- Prints receipts: sales receipts, bills and shift closings.
- Stations it prints: the stations whose tickets will come out of this printer (for example Kitchen or Bar).
- Has a cash drawer: if the drawer is connected to this printer.
- Tap Test to print a test page.
Connection types
| Connection | What to do |
|---|---|
| Bluetooth | Pair the printer first in Android’s Bluetooth settings. Then pick it from the list. If none shows up, the app says “There are no paired devices.” If a permission is missing it says “Without the Bluetooth permission the list of paired printers cannot be shown.”: grant it. |
| Network (IP) | Type the printer’s IP address and the port (Port; the usual one is 9100). The printer and the tablet must be on the same network. |
| USB | Plug in the printer and tap Ask for permission. “USB printer detected: (name)” may also appear with an Add button. |
| Built-in printer | For devices with a built-in printer (Sunmi). It works on a best-effort basis and has not been verified on real devices, so always run a test with Test. |
The port must be between 1 and 65535.
What prints and where
- Receipts: after charging, with the Print button. You can also reprint from the Sales history with Reprint receipt. With no receipt printer you will see “No receipt printer is set up on this device.”
- Kitchen tickets: when you tap Send to kitchen, one ticket comes out per station, on the printers that have that station checked. A product with no station does not print in the kitchen.
- Table bill: Print check prints a bill marked “NOT AN INVOICE”; see Tables.
- Shift closing: prints by itself when you close, with Print close report again if you need it.
- Voids: when you void a product that was already sent, a VOIDED notice prints on its station’s printer.
- Tickets coming from other devices: a tablet with the Kitchen or bar role can print orders from other devices (see Several tablets).
Logo on the receipt
The logo you upload in Settings > Business shows on the top bar and the PIN screen. It is not printed on the receipt yet.
Cash drawer
The drawer opens through the printer that has Has a cash drawer checked. The printer setup also has a Drawer pin field. To open it by hand use Open drawer, found in the ⋮ menu of the register screen or in the Shift section; the app asks for a reason. If no receipt printer has a drawer, the reason is logged but the app warns you: “It was recorded, but no receipt printer has a drawer.”
If it does not print
The warning looks like “Could not print on (name): (reason)”. The most common reasons:
| Reason | What to do |
|---|---|
| ”Bluetooth is turned off” | Turn on the tablet’s Bluetooth. |
| ”No Bluetooth printer was chosen” | Edit the printer and pick one from the list. |
| ”The printer’s IP address is missing” | Type the IP in the setup. |
| ”Permission to use the USB printer is missing” | Tap Ask for permission and accept. |
| ”The USB printer is busy with another app” | Close the other app that uses the printer. |
| ”The built-in printer did not answer” | Try again with Test. |
More cases in Troubleshooting.
Barcode scanner
- With the camera: on the register screen tap Scan barcode and point the camera at the code. If the permission is missing you will see “No camera permission”; grant it in Android.
- USB or Bluetooth keyboard-type scanner: connect it to the tablet and scan with the sales screen open; the product is added by itself.
- If the code does not exist: “No product with code (name)”.
- The same code cannot be on two active products: “Another active product already uses that barcode.”
Barcodes are assigned when you create the product (see Menu).
Customer display
It shows the customer their order while you build it. There are two ways to do it.
Option 1: a second screen connected to the tablet
- Go to Settings > Printers and hardware > Customer screen.
- Turn on Show the sale on the customer screen.
- If Android detects the screen you will see “Second screen detected: (name)”. Otherwise, “No second screen connected”.
Options for that screen:
- Offer the receipt on the customer screen.
- The customer screen is a touch screen.
- Welcome message (optional) (up to 120 characters).
- Show preview.
Option 2: another tablet over Wi-Fi
- On the register, first turn on Show the sale on the customer screen. If not, you will see: “Turn on ‘Show the sale on the customer screen’ to pair tablets.”
- On the register, go to Settings > Location and devices > Tablets connected over Wi-Fi and tap Pair a tablet. A 6-digit code and the register’s address appear.
- On the other tablet choose Use this tablet as the customer screen; on a fresh install it is Customer screen for another register.
- Pick the register from the list or type its IP and port, enter the 6-digit code and tap Link.
Both tablets must be on the same Wi-Fi and run the same app version. This display does not ask for a food.yammbo.com account.
To leave customer display mode, press and hold the top-left corner for 3 seconds.
If the display loses its connection it shows “Reconnecting to the register”. If the register removed it, you will see “This tablet is no longer paired” and a Link again button.
| Message | What to do |
|---|---|
| ”This tablet is not connected to a Wi-Fi network.” | Connect it to the location’s Wi-Fi. |
| ”The code is not correct.” | Check the code on the register. |
| ”The code expired…” | Link again to get a new one. |
| ”Too many attempts. Ask for a new code on the register.” | Generate another code. |
| ”Could not reach the register. Make sure both tablets are on the same Wi-Fi network.” | Check the network of both tablets. |