Printing & delivery

How your documents reach paper or the customer: who prints, the printers, how the customer gets the document, the gift receipt's words and the address document e-mails come from. Open it in zrsPOS → Settings › Printing & delivery.

Each store has a main printer; each tablet can pick its own, on its page under Stores › the store › its tablets. The tablet checklist has a page of its own: The tablets.

What Working means

A store is Working when it prints (one of its printers in use answered within the last 2 minutes, or zrsPOS is set not to print) and every tablet that opened zrsPOS has its tiles and post-sale block. A printer that stops answering shows Not answering on its page, in the list and on Home. It is a warning: it never stops the store from going live.

Who prints?

One question for the whole shop:

• zrsPOS prints — a receipt prints at the till for each document. The rest of this page is for you.
• We print from SAGE — zrsPOS issues the document and prints nothing; you print it from SAGE.
• Nothing is printed: e-mail only — every document goes to the customer by e-mail. It needs e-mail sending on.

When zrsPOS prints nothing, nothing prints at all: no receipts, Tax Free forms or till close slips, and no reprints. Your printers stay saved, so you can switch back. On a live shop the change asks first and says what customers get from the next sale.

Printers

Printers lists every printer of the stores zrsPOS invoices, with one status each: Answering, Not answering or Not checked. Problems come first; above 20 printers there is a search and pages, and the Not answering filter shows only those. Printers at a store zrsPOS doesn't invoice are listed apart, muted: nothing prints on them; open one to move or delete it.

The print app, the PrintBox and the Epson need nothing changed on the store's router and expose nothing to the internet.

A printer belongs to one store: a store's receipts never go to another store's printer. A store with no printer of its own prints nothing; the tablet says so, and the receipt can be reprinted later or sent by e-mail.

Add printer

In Printers, press Add printer. The task has one step per page:

1. How it gets receipts — print app or PrintBox (recommended), an Epson that fetches receipts, or, under Other ways, straight to the printer's address.
2. Where — the store (only the stores zrsPOS invoices), a name staff recognise ("Balcão"), and whether it becomes the store's main printer. The first printer at a store is always its main one.
3. Connect
   • Print app or PrintBox: a QR code and a 6-digit code, valid 10 minutes. Scan it in zrsPOS Print on the tablet, or type it on the PrintBox's page. Paired shows by itself, with the printers it found.
   • Epson: the printer is saved, and the page shows its Server URL and Printer ID with Copy buttons. On a computer in the store, open the Epson's address in a browser (hold Feed while turning it on to print it), open Server Direct Print, turn it on, paste both values, set Interval to 5 seconds and save. The page shows the printer's first call.
   • Straight to the address: the address type (zrsPOS DDNS, your own DDNS name or a fixed IP), the public address and the router port (a whole number from 1 to 65535). The router guide shows what to set on the router.
4. Test print — prints a test and says whether it printed, or why not.

The Epson, step by step. Do this on a computer or tablet on the same network as the printer, with zrsPOS open in another tab to copy from:

1. Power the printer off, then on again while holding Feed: it prints a slip with its IP address (for example 192.168.1.180).
2. Open http://<that IP>/ in a browser. If it asks for a login, the user is epson and the password is on the label on the printer (older models: epson).
3. Find Server Direct Print in the menu (on some models it sits inside ePOS-Print) and set it to Enable.
4. Paste the Server URL whole, from https:// to the end, and the Printer ID exactly, with no spaces before or after.
5. Set Interval to 5 seconds (more means receipts come out later), send the settings, and Reset or Restart the printer if it asks.
6. Back in zrsPOS, the page shows the first call within seconds.

No Server Direct Print on your model? Check for an Epson firmware update, or connect the printer by USB to a tablet with the print app, or to a PrintBox. The URL and ID are stored in the printer: delete the printer in zrsPOS and add it again, and both change and must be pasted again.

Leaving before the printer is saved asks first: nothing is kept.

One printer

A printer's page holds its status, Print a test (it works on a read-only plan too), and its settings:

• Name, Store (moving it says which printer takes over at the old store), Main printer (prints for the store's tablets with no printer chosen), Paper width (80 or 58 mm), Print automatically and In use.
• Paper width is yours. The print app reports the width it finds, but never changes the one you chose; when they differ, the page says so.
• Connection: the paired app or PrintBox and its version (with Update available when a newer one is out), the Epson's URL and ID, or the direct printer's address and port. Change how it connects runs the task again for this printer.
• Asking for work (print app and PrintBox): how often it asks.
• Tablets printing here, each opening its own page under Stores.
• Unpair the print app: it signs out for good and never comes back by itself; its printers stay saved, not in use. Pair it again with a new code to print with it again. Delete: the printer's waiting receipts are dropped; a print-app printer does not come back by itself.

On a live shop, moving a printer, stopping it, turning off automatic printing or changing the main printer asks first; the name, paper width and how often it asks just save.

Status

One clock, the same on the printer's page, in the list, on Home and at the till:

A test goes through the same queue as a real receipt. If the printer does not collect it within 2 minutes, the test says so; if it collected it but never confirmed it printed, the page says that too and offers to check again.

The queue. Receipts for a printer that asks for work wait in its queue and print on its next call. A receipt that waits more than 4 hours is dropped rather than printed hours late: reprint it from Documents if you still need it. A print the printer never confirmed is tried again up to 3 times, then marked failed. Print history is kept for 30 days.

Delivery

How each customer gets their document at the till. The choices follow Who prints?:

• zrsPOS prints: Printed receipt, By e-mail or Receipt and e-mail.
• We print from SAGE: Nothing from zrsPOS or By e-mail.
• E-mail only: By e-mail or Nothing (customers then get no paper and no e-mail; they can ask for it later).

The e-mail goes only when the sale has the customer's e-mail; without one, the receipt prints (or, where zrsPOS doesn't print, nothing is sent). The e-mail choices say so when e-mail sending is not on for your shop.

Good to know:

• Each document gets at most one automatic e-mail. A repeated order update or a retry never sends it twice; a failure is recorded and not retried by itself: send it again with Send by e-mail at the till or on the order screen.
• In Documents, each document shows whether it was sent by e-mail (with the address masked, j•••@example.com), not sent, or had no customer e-mail.
• A sale issued later (SAGE was down) does not print by itself, but its e-mail goes out when it is issued.
• Returns made in the Shopify admin are not delivered automatically, just as they do not print.
• If the e-mail cannot go out (the provider refuses the address, say), the receipt still prints where zrsPOS prints.
• Document e-mails count towards a daily limit per shop.

Staff can change it (needs e-mail sending): before payment, the NIF tile asks for that sale only. Different at some stores (with two or more invoiced stores): a store can have its own choice; remove it on its page to follow the shop's again. On a live shop a change asks first.

Gift receipt

The closing words on the receipt without prices that staff print from the POS order for a present. Empty prints the default text, shown on the page. At most 200 characters; a sample slip shows how it reads.

E-mail sending

Document e-mails go out from zrsPOS, in your shop's name, until you add your own domain; customers' replies go to your shop's e-mail (Company on documents). To send from your own address, choose Your own domain, type the address and save: the page lists the DNS records to add where your domain is managed. Press Check the DNS records; once all are found, documents go out from your address. Stop using your own domain goes back to zrsPOS's address. While e-mail sending is not on for your shop, the page says so and how to ask for it.

Problems

Each one has a page that says what you see, what happened and what to do.

• The printer is not answering
• The printer has not been checked recently
• The print app is out of date
• The paper width differs from what the printer found
• Document e-mail is off
• E-mail only, and Nothing
• The zrsPOS tile is missing on the tablet
• The zrsPOS block is missing on the tablet