Configure
Receipt printers
Connect receipt printers and cash drawers to Bitta Retail POS: PrintNode, Business Central printers, USB or LAN printers, routed by company, store or terminal.
updated: applies-to: 1.0.0.141
Bitta Retail POS sends every receipt, kitchen label and test print to a print destination: a record that names the purpose, the transport, the print language and the scope (company, store or terminal). When a sale completes, the register looks for the most specific active default destination for that purpose, so one company-wide route can serve every till while a single counter prints to its own USB printer. This page covers routing, the five transports, USB pairing, LAN printers and the cash drawer.
Prerequisites
- The
BAA POS - Adminpermission set. - For WebUSB: Chrome or Edge on the till and a USB thermal receipt printer.
- For PrintNode: a PrintNode account with the printer set up in PrintNode, its API key and the printer's numeric ID.
- For BC Printer: a printer registered on the standard Printer Management page, for example a Universal Print printer.
- For LAN: an Epson ePOS-Print or Star WebPRNT network printer with an HTTPS address.
How routing works
- Purpose: use
ReceiptorKitchen Label.Cash DrawerandTestalso appear in the list but are not used for routing, andKitchen Ticketcannot be saved; a Kitchen Label destination carries both labels and grouped tickets. - Scope: leave Store Code and Terminal ID blank for a company-wide destination, fill Store Code for one store, or both for one terminal. A Terminal ID needs its Store Code.
- Resolution: terminal default first, then store default, then company default. If none exists, the job fails with "No active default print destination is configured".
- Defaults: only one active Is Default destination per purpose and scope, and a default must be Active.
- Copies: Default Copies from 1 to 99.
Company initialization creates a company-wide RECEIPT-BROWSER receipt destination when no compatible default exists. A company-wide KITCHEN-WEBUSB kitchen destination is created by the demo data, or by the setup wizard for an Order and Fulfillment register when kitchen output is configured.
Add a print destination
- Search for POS Print Destinations, or choose Print Destinations on POS Setup.
- Choose New. In General, fill in Code, Description and Purpose, and select Active and Is Default.
- In Routing Scope, fill in Store Code and Terminal ID as needed.
- In Output, choose Transport and Print Language, then the field that transport asks for: PrintNode Printer ID, Endpoint URL, BC Printer Name or Report ID.
- Choose Test Destination. It validates the route and creates a retained test job. Browser and BC Printer print the Bitta Retail POS Printer Test page ("If you can read this page, this Business Central print destination is working."), PrintNode prints at once, and WebUSB and LAN jobs wait until the register on that till pushes them.
Choose a transport
| Transport | Print Language | Drawer kick | Notes |
|---|---|---|---|
| Browser (print dialog / PDF) | RDLC, with Report ID set to the POS Receipt report | No | Opens the print dialog on the till. Cannot be used for automatic receipts. |
| PrintNode (silent ESC/POS) | ESC/POS (ZPL is accepted for kitchen labels) | Yes | Sent from Business Central to your PrintNode printer by its numeric ID. |
| BC Printer (Universal Print / Printer Management - silent) | RDLC, with BC Printer Name and Report ID | No | Page output, no paper cut. Suits low-volume or A4 printers. |
| WebUSB (direct - free) | ESC/POS | Yes | Prints from the open POS Register page; falls back to WebSerial for USB-serial printers. |
| LAN (ePOS-Print / WebPRNT) | ePOS-Print or WebPRNT | Yes | The browser posts to the printer's address; prints from the open POS Register page. |
With Auto Print Receipt on, Browser receipts are refused and recorded in POS Print Jobs for attention, because a print dialog cannot print silently. Failed jobs and retries are covered in Print and reprint receipts.
PrintNode key
On POS Setup, choose Set PrintNode API Key, paste the key in API Key and choose OK. The key goes to Isolated Storage, is shared by all companies in the environment, and is never shown again; the Receipt Printing FastTab only reports whether one is set. Use Test PrintNode Connection to check it and Clear PrintNode API Key to remove it. PrintNode Timeout (sec) accepts 5 to 120 seconds; the default is 30.
Pair a USB receipt printer
- On the register, choose Printer in the status bar, then Connect Receipt Printer. The Printer button shows when the register profile allows Printer Menu.
- On Connect Receipt Printer, choose the Connect receipt printer button and pick the printer in the browser's device picker.
- Check the Status line. The browser remembers the pairing for the Business Central site, so you pair once per till.
The same Printer menu also offers Process Print Queue, Recover Last Receipt and Reprint Last Kitchen Output.
LAN printers
- The Endpoint URL must end with
/cgi-bin/epos/service.cgifor Epson ePOS-Print or/StarWebPRNT/SendMessagefor Star WebPRNT, matching the Print Language. - HTTPS is required. A plain
http://address is rejected unless an administrator selects Allow Insecure LAN Printer HTTP on the Advanced Settings FastTab of POS Setup and confirms the warning.
WARNING
Plain HTTP printing is unencrypted, and browsers can still block it from Business Central's HTTPS pages. Configure HTTPS on the printer and leave the override off.
Cash drawer
The drawer kick rides on the first copy of a sale's automatic receipt, so it needs Auto Print Receipt on and a PrintNode, WebUSB or LAN receipt destination; Browser and BC Printer cannot pulse a drawer, and reprints never open it. Drawer Open Mode on POS Terminals decides when it fires:
| Drawer Open Mode | Kicks the drawer |
|---|---|
| Default (use POS Setup) | When Open Drawer On Cash is on and the sale has a cash tender |
| On Cash Only | When the sale has a cash tender |
| On Every Sale | After every sale |
| Never | Never automatically |
NOTE
A drawer pulse without a receipt (No Sale, pay in, pay out, safe drop) follows the terminal's Receipt Transport Override, or the company Print Transport when the override is (Default - use POS Setup), not the print destination. Both fields are hidden by default; add Receipt Transport Override to POS Terminals with Personalize and set it to PrintNode, WebUSB or LAN for tills with a drawer. PrintNode also needs a printer ID, from the terminal's PrintNode Printer ID Override or the company PrintNode Printer ID on POS Setup (also hidden, and editable only while Print Transport is PrintNode), and LAN needs LAN Printer Endpoint URL and LAN Printer Protocol, both hidden columns on POS Terminals.
The test pages and printed reports are described in All POS reports.
What's next
Connect integrated card payments: Stripe Terminal setup.