Hotel360 Hotel360User Guide

Printers and Print Management

Introduction

Print Management is where you connect Hotel360 to the thermal (receipt-roll) printers in your business and decide which printer prints what. Open Office > Print Management. It needs the Open Print Management permission.

The page has seven tabs, in the order you will use them: Agent Token, Computer ID, Printers, Department Printers, Accommodation, Receipt Style and Print Jobs.

How Printing Works

Web printing does not go straight from your browser to a printer. Hotel360 sends each print to a small program called the print agent, which runs on a Windows, Linux or Mac computer in your business. The agent then sends it to the printer.

  • The agent must be running on the computer the printer is connected to. If it is off, prints wait in a queue and nothing comes out.
  • Every computer that runs an agent has a computer name. Printers and print jobs are tied to that name.
  • The agent finds the printers on its computer and reports them to Hotel360. You do not add printers by hand: they appear on the Printers tab after the agent connects.
  • A printer with an IP address is printed to over the network. A USB printer is printed to through the computer's own printer list.

The phone app can also send tickets and receipts straight to a network printer. See The Hotel360 Phone App.

Setting Up Printing Step by Step

  1. On the computer that has the printer attached, download the print agent for your system (Windows, Linux or macOS) from the Downloads page of the Hotel360 website and run it.
  2. Open Print Management > Agent Token and press Generate Token (if there is none). Copy the token.
  3. Paste the token into the agent when it asks "Paste the agent token from Print Management". The agent connects, finds its printers and sets itself to start with the computer.
  4. Back in Hotel360, open the Printers tab. The printers appear there. For network printers, type the IP Address and Port (usually 9100).
  5. Open Computer ID on every till or reception browser and pick that computer's name.
  6. Open Department Printers and assign printers to departments by type.
  7. For lodge receipts, pick the Accommodation printer.
  8. Make a sale or booking and check that it prints.

Note

Keep the agent running whenever the business is open. Set the computer to start it at boot.

Agent Token

The token is the password that lets the agent connect your business to Hotel360. One token serves every agent in the business.

  • Generate Token: creates a token. A Copy button copies it.
  • Regenerate Token: makes a new token. The old one stops working. The warning is "This will invalidate the current token. All connected agents will need to be reconfigured. Continue?"
  • Revoke Token: removes it. The warning is "This will disconnect all agents. Continue?"

The Agent Token tab, and the token itself, are shown only to people with the Reveal or rotate the print agent token permission. Everyone else with Open Print Management sees the other tabs and starts on Computer ID. Treat the token like a password.

Computer ID

The Computer ID tab tells Hotel360 which computer you are working at. This is how a bill printed from this till reaches this till's printers.

  1. Open Print Management > Computer ID on the till or reception computer.
  2. In This Computer's Name, choose the name from the list. The list comes from the agents that have connected.
  3. You see "Computer identified as: ..." and a green Identified as badge. A yellow Not Identified badge means you have not chosen yet.

The choice is remembered for about 30 days in that browser. Do it on each computer that prints.

Warning

A browser that is Not Identified cannot find its own printers. Bills may say "No bill printer configured for this computer", and some prints can be queued for a computer name nobody listens to. See A lodge receipt or bill never prints.

Printers

The Printers tab (Synced Printers) lists every printer the agents have found.

Column Meaning
Printer The printer's name.
Computer The computer the printer is attached to.
ESC/POS Yes if it is a normal thermal receipt printer. Click the badge to switch. Receipts need Yes.
No bold On sends that printer's jobs without bold text. Turn it on only for printers whose paper cut lands inside the next slip after bold text (the model JP-R840).
IP Address and Port For network printers. Port is 9100 unless the printer manual says otherwise.
Status available when the printer is ready. Any other state shows as a warning.
Last Seen A green Online badge when that computer's agent is connected now, otherwise when it was last seen, or Never.

Delete all printers (red button) removes every synced printer and every department assignment. The agent re-syncs on its next heartbeat, but you must assign printers to departments again.

Department Printers

This tab has a card for each department. It lists that department's printers by Computer, Printer, Type and Copies, with Set Default and a red bin button to remove.

The Four Printer Types

Type What prints on it
Bill The guest's copy of the bill. It is also the fallback for kitchen tickets and cashier copies when no order or cashier printer is set on that till.
Order The kitchen or bar order ticket, printed when an order is saved. See Order Stations.
Receipt Receipts, such as lodge receipts and receipts printed from the phone app.
Cashier The cashier's own copy of a bill. Only used when Print Cashiers Copy bill is on in Admin > Settings.

Copies is how many copies to print each time. Default marks the printer to use when a department has more than one of the same type (one default per department, type and station).

Adding a Printer to a Department

  1. Open Print Management > Department Printers.
  2. In the department's card press Add Printer to (department name).
  3. Choose the Computer, then the Printer (the list shows printers on that computer).
  4. Choose the Type: Bill, Order, Receipt or Cashier.
  5. For an Order printer you may fill Station (optional). See below.
  6. Set Copies and press Add. You see "Printer added to department".

If you leave something out you see "Please select department, computer, and printer". Only one printer of a given type, station and computer can be added to a department. Trying again gives, for example, "A bill printer is already configured for Till 1" or "A Counter order printer is already configured for Till 1".

Order Stations

Normally one kitchen ticket prints for each order. Some items are not made in the kitchen. Soft drinks may be handed over at a Counter, or a bar may pour drinks away from the main bar. An order station lets those items print on their own ticket on a different printer.

A station is just a name you give to an order printer, such as Counter or Pastry. Items go to a station because of their sub-category. Everything else stays on the kitchen ticket.

Setting Up a Station

1. Create the station printer.

  1. Open Print Management > Department Printers and add an Order printer to the department.
  2. In Station (optional) type the station's name, for example Counter. The box says "Leave blank for the kitchen. Name it (e.g. Counter) and pick it on categories whose orders print here." The name can be up to 40 characters. Typing Kitchen is the same as leaving it blank.
  3. Press Add. In the table the printer shows a Type badge Order and an amber Station: Counter badge. A normal kitchen order printer shows a grey Kitchen badge.

2. Point sub-categories at the station.

  1. Open POS > Products > Add Product, then press the + next to Subcategories (or edit an existing one).
  2. Choose the category, type the Subcategory Name.
  3. Use the drop-down Print orders at. It shows Print orders at: Kitchen and one line for each station that exists, such as Print orders at: Counter. Choose the station.
  4. Save. The sub-category's list shows an amber badge with the station name.

Note

The Print orders at choice only appears once the department has at least one order printer with a station name. Stations belong to a department, so a Counter in the Bar and a Counter in the Restaurant are set up separately. It is set on sub-categories, not on categories. Products in a sub-category with no choice print in the kitchen.

What Prints Where

When an order is saved, Hotel360 sorts its items by the station of each item's sub-category.

flowchart LR
    A[Order saved] --> B{Sub-category station}
    B -->|Kitchen / none| C[Kitchen ticket]
    B -->|Counter, has printer| D[Counter ticket]
    B -->|Counter, no printer| C
  • The kitchen ticket holds every item that has no station, plus any item whose station has no printer.
  • Each station ticket holds only that station's items. Its title shows the station, for example "Order #1042 (Counter)", and the ticket carries the station name.
  • A station with no printer falls back to the kitchen ticket, so nothing is lost. If a station's printer has been removed, its items go back to the kitchen.
  • Which printer is used: for the kitchen ticket, the Order printer (no station) on this till's computer, or if there is none, the Bill printer on this till. For a station ticket, the station's printer on this till's computer first, then the station's default printer, then any printer with that station name. A station printer may be on another computer.
  • A till with no kitchen printer still prints station tickets. Only the kitchen items are missed.

Order tickets are switched off per department under Admin > Settings > Order Ticket Printing. When it is off, no kitchen or station ticket prints. See Users, Roles and Settings. Tickets are split the same way on the web and in the phone app.

Accommodation Printer

The Accommodation tab sets the printer for lodge receipts and lodge bills.

  1. Open Print Management > Accommodation.
  2. In Receipt Printer choose a printer. Only ESC/POS printers are listed, as "Printer name (Computer name)".
  3. In Receipt Copies type how many copies to print.

Each change saves immediately ("Accommodation printer updated"). Lodge prints go to the agent on the accommodation printer's own computer, so the reception browser does not need its own printer. That agent must be running. If no accommodation printer is chosen, you see "Accommodation printer not configured. Please configure in Print Management."

Receipt Style

These apply to every thermal print: bills, orders, lodge and service receipts, vouchers. Changes take effect on the next print.

Setting Choices
Paper Width 80mm, a standard wide roll, or 58mm, a small narrow roll. Match your roll: the wrong width cuts off item names or runs off the edge.
Printer Font Font A, standard and wider, or Font B, compact and denser.
Kitchen Order Ticket Classic: compact, item then quantity. Large: tall and spaced out, quantity first, with the order number, table and every item in double height so it can be read from a distance.

The Print Jobs tab shows jobs that are still waiting to be printed. Press Refresh to load the latest (up to 50). The columns are ID, Title, Printer, Type, Computer, Status and Created. The status is pending, processing, completed or failed, though this list shows jobs waiting for an agent.

If jobs pile up here, no agent is picking them up. Usually the agent is switched off on that computer, or the Computer shown is a name that has no agent.

When a Print Fails

If a printer cannot be reached, the till shows a red Print failed message that reads "(title) did not print. Check the printer, then reprint." It appears for about 10 seconds. A network printer is tried up to 3 times before Hotel360 gives up on it, so a short Wi-Fi or cable glitch often fixes itself. See Common Problems and How to Fix Them.