A sale without a document
What to do when a sale has no document yet: never repeat it, read the cause in Queue and errors, and try again once it is fixed.
Sometimes a sale is recorded in Shopify but its document is not issued: SAGE did not answer, the store is not set up, a customer's address is missing. Never repeat or cancel the sale. The sale is safe in Shopify; the document comes once the cause is fixed.
How zrsPOS retries
zrsPOS tries each sale twice, right away: as the sale arrives, and once more a few seconds later. After that it stops, so a sale someone fixed by hand in SAGE is never issued a second time. From then on a person presses Try again.
Queue and errors
Open the zrsPOS tile, then Queue and errors. It lists this store's sales without a document, each with:
- the order and what is missing (invoice or credit note);
- the cause, in words, and how many attempts were made;
- Try again, which retries that sale now and says what happened;
- Technical detail, for whoever supports your shop.
At the bottom, Process all tries again, now, every sale of this store listed there.
- Read the cause. If it is a setting (a store, an item, a payment method), tell a manager.
- Once it is fixed, press Try again on the sale, or Process all.
- When it says Issued ✓ — print it from Documents., print the receipt from Documents: a recovered document never prints by itself.
The same Try again is on the order's zrsPOS documents block.
SAGE not answering
SAGE not answering · sales queued means zrsPOS cannot reach your SAGE (the server is off, or the head office's internet is down). Keep selling: nothing is lost. When SAGE answers again, open Queue and errors and press Process all. If it lasts, tell a manager.
Edge cases
- Process all covers only this till's store: the sales listed there. A sale of another store is retried from that store's tills, or from the admin's Documents.
- Do not issue the sale by hand in SAGE. It would be duplicated. If someone already did, a manager archives the failure in the admin, under Documents.
- A sale already being issued is not tried twice: Not tried now: it is already being issued, was archived, or is not issued by zrsPOS.
- A store not set up yet: its sales wait. Once a manager sets the store up in Settings › Stores, press Process all at a till of that store. See Location not set up yet.
- Sales not invoiced · tell a manager (licence or plan): those sales are held, not queued. Once the plan is active, a manager issues them from the admin's Documents.
- SAGE did not answer in time: the document may have been issued anyway. A retry looks for it in SAGE before issuing, so there is no duplicate.
- After 2 hours without a document, zrsPOS e-mails the shop.
- Try again reaches sales up to 30 days old.
- The credit note of a return waits the same way; an exchange's new invoice follows its credit note by itself.