Chapter 4 of 8Page 11 of 13

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 - Admin permission 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 Receipt or Kitchen Label. Cash Drawer and Test also appear in the list but are not used for routing, and Kitchen Ticket cannot 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

  1. Search for POS Print Destinations, or choose Print Destinations on POS Setup.
POS Print Destinations by company, store, terminal and purpose
Step 1: every route with its purpose, transport, language and scope.
  1. Choose New. In General, fill in Code, Description and Purpose, and select Active and Is Default.
  2. In Routing Scope, fill in Store Code and Terminal ID as needed.
  3. 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.
POS Print Destination card for RECEIPT-BROWSER with the General, Routing Scope and Output groups
Steps 2 to 4: one destination, its scope and its transport.
  1. 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.

Receipt Printing FastTab on POS Setup with Auto Print Receipt, Open Drawer On Cash and the PrintNode API Key status
Company receipt options and the PrintNode key status.

Pair a USB receipt printer

  1. On the register, choose Printer in the status bar, then Connect Receipt Printer. The Printer button shows when the register profile allows Printer Menu.
  2. On Connect Receipt Printer, choose the Connect receipt printer button and pick the printer in the browser's device picker.
Connect Receipt Printer page for WebUSB pairing
Step 2: the Connect receipt printer button opens the browser device picker.
  1. 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.cgi for Epson ePOS-Print or /StarWebPRNT/SendMessage for 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
POS Terminals list with the Drawer Open Mode column for each demo terminal
Drawer Open Mode decides when each terminal kicks the drawer.

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.

// next step

Ready to try Bitta Retail POS?