zrsPOSTroubleshooting
A sale was made but no document appeared. Check the zrsPOS tile's subtitle and Queue & errors. If the sale is queued, wait or press Process all. If it says the store is not configured, finish steps 4 and 5. If you are not live yet, sales are ignored by design.
The receipt did not print. Open the zrsPOS tile → Printer. If it says "to configure", pick this till's printer. For pull printers, the printer's page in the app shows the last contact time; no contact means the printer lost power or network. For direct printers, use Print test and check the router rule.
The print app says "No connection to zrsPOS". The POS device has no internet, or the printer was deleted in the admin (the app then says it was revoked). Check Wi-Fi first; the app retries by itself. See The print app.
Printing stops when the POS device's screen goes off. Open zrsPOS Print and press Allow running in the background (battery), then allow it. Android otherwise stops the app.
The Epson printer has no Server Direct Print option. Check for an Epson firmware update for that model. Otherwise connect the printer by USB to the POS device and use the print app, or switch the printer to Direct. See Step 7 — Printers.
"Store not configured" on a sale. The store's série, document types, warehouse or final-consumer PartyID are missing. Open step 4 and complete them; run Audit SAGE in step 5.
The wrong document type was used for a return. Step 4 lets you choose NC or NRE per store. Change it; future returns use the new choice.
An order was edited after invoicing. zrsPOS raises an alert on Documents and on the order. Correct in SAGE (credit note and new invoice as your accountant advises), then mark the alert handled.
The NIF was rejected. Portuguese NIFs are checked for a valid checksum. For foreign tax numbers, switch on Foreign tax number on the NIF tile.
SAGE is unreachable. Documents queue and retry automatically. Test the connection in step 2; check the firewall allows zrsPOS's address and that the SAGE API service is running.