How a sale becomes a document
From the payment at the till to the certified document in SAGE and the printed receipt - a sale, a return, an exchange, and what happens when SAGE is slow.
A sale
- The sale is paid in Shopify POS. Staff sell as usual; the NIF tile adds the customer's NIF when they give one.
- Shopify tells zrsPOS. zrsPOS finds each line's SAGE item by barcode (the barcode of the Shopify variant) and builds the document with Shopify's prices.
- SAGE issues it in the série of the store where the sale was made: an invoice-receipt (FR) with a NIF or for Tax Free; without a NIF, a simplified invoice (FS) up to the store's limit, or an FR above it. See Which document a sale issues.
- zrsPOS reads the document back and prints the receipt on the till's printer, or e-mails it, as the store delivers. The document is attached to the Shopify order.
It takes a few seconds. The zrsPOS tile shows the last sale's document.
A return or an exchange
- A return at the till issues the store's returns document (a credit note or a refund note) against the sale's invoice, and prints at the till. See A return at the till.
- An exchange at the till issues two documents: the credit for what came back, then a new FS or FR for what went out. See An exchange at the till.
- A refund of a till sale made in the Shopify admin is credited too, but never prints.
When SAGE is slow or does not answer
- zrsPOS tries the sale as it arrives, and once more a few seconds later. Then it stops and the sale waits, with its cause, in Queue and errors on the till and in Documents in the admin. Once SAGE answers, a person presses Try again or Process all.
- Never repeat or cancel the sale. The sale is safe in Shopify; a repeated sale would be invoiced twice.
- No duplicates. When SAGE created a document but its answer never arrived, zrsPOS finds it in SAGE and uses it instead of issuing another.
See A sale without a document.
Edge cases
- A sale waiting for another document (a return made before its sale's invoice came out, the new invoice of an exchange) issues by itself as soon as that document does.
- A sale whose line has no SAGE item (a barcode missing in SAGE) waits until the item is there; nothing is lost. See Items with no match in SAGE.
- A store's printer off: the document is issued anyway, and the receipt waits for the printer.
- A document never changes once issued. A mistake is corrected with a credit note and a new document. See A document is wrong.