Problems & questions
Every message zrsPOS can show, what it means and what to do, and the usual questions.
- Find what a message means
Every message zrsPOS shows has a support code and a page of its own. How to find it, what each page says, who acts on it, and the lists of messages by area.
- A sale has no document
A sale was paid but no document came out. Where to look on the till and in the admin, the usual causes, and the sales zrsPOS never invoices by design.
- The receipt did not print
The document was issued but the receipt did not come out. What to check first, the print app's own messages, and how to print the receipt again.
- SAGE is slow or unreachable
SAGE did not answer, or answered too late. What zrsPOS does with the sale, what the till and the admin show, what to check, and why no sale is ever issued twice.
- When SAGE refuses a sale
SAGE checked the document and refused it. Where the refusal shows, how to read it, the fix button, Try again, and what never to do.
- A document is wrong
A document already issued in SAGE can't be changed. What to do when a return used the wrong document, an order was edited or cancelled after its document, or a total differs.
- The NIF is refused
The NIF tile says the NIF is invalid, or a company NIF asks for an address. Why, and what to do for a Portuguese NIF, a foreign tax number or a company.
- SAGE connection and Shopify messages
Every message about reaching your SAGE - the connection test, reading SAGE, issuing - and about Shopify’s own messages to zrsPOS, each with its page.
- Sales messages
Every message about a sale - SAGE refused its document, it waits or was not issued, or something changed after its document - each with its page.
- Setup messages
Every message about the setup - stores and séries, SAGE items, payments, salespeople, your plan and going live - each with its page.
- Returns messages
Every message about a return or an exchange at the till - waiting for another document, needing a person, store credit - each with its page.
- Online returns messages
Every message about an online order brought back to a store - the setup, finding the online invoice, crediting it - each with its page.
- Till close messages
Every message about the till - at the till, the closing rules, SAGE tills and the close in SAGE, and after the close - each with its page.
- Tax Free messages
Every message about Tax Free - the SAGE codes, desks and tablets, Global Blue, and Tax Free sales and returns - each with its page.
- Printing messages
Every message about printers, the tablets’ tiles and block, and how customers get their documents - each with its page.
Every message
- A card is booked as cash
ZP-CARD-AS-CASH - A close has items to look at
ZP-TILL-CLOSE-DIFFERS - A document failed to issue
ZP-ISSUANCE-ERROR - A location is not set up
ZP-LOCATION-UNCONFIGURED - A receipt was not printed
ZP-RECEIPT-NOT-PRINTED - A refund item is missing
ZP-REFUND-ITEM-MISSING - A refund of a go-live test order — check the test document in SAGE before crediting
ZP-GOLIVE-TEST-REFUND - A SAGE sale import failed
ZP-SAGE-IMPORT-FAILED - A SAGE till needs a store
ZP-TILL-TILLS-INVALID - A sale never reached issuing
ZP-SALE-LOST - A sale reached Shopify but not zrsPOS
ZP-SHOPIFY-SALE-MISSED - A store has no SAGE till
ZP-TILL-SAGE-NO-TILL - A Tax Free form failed
ZP-TAXFREE-ISSUE-FAILED - A template could not draw a document
ZP-TEMPLATE-RENDER-FAILED - A test document may be left in SAGE: {doc} — cancel it in SAGE
ZP-TEST-DOCUMENT-LEFT - A till close is not in SAGE
ZP-TILL-CLOSE-NOT-POSTED - An earlier document could not be confirmed
ZP-GHOST-LOOKUP - An island custom-sale item is missing
ZP-ISLAND-ITEM-MISSING - An item is missing in SAGE
ZP-ITEM-MISSING - Automatic retries have ended
ZP-RETRY-ENDED - Cash removed without a count
ZP-TILL-REMOVED-WITHOUT-COUNT - Choose who closes
ZP-TILL-SCOPE-INVALID - Choose who may close
ZP-TILL-PERMISSION-INVALID - Close not found
ZP-TILL-NOT-FOUND - Close yesterday first
ZP-TILL-CLOSE-YESTERDAY-FIRST - Confirm this step for the new company
ZP-STEP-RECONFIRM - Connection to SAGE refused
ZP-SAGE-REFUSED - Connection to SAGE without HTTPS
ZP-SAGE-HTTP - Counted-cash source missing
ZP-TILL-COUNTED-INVALID - Custom-sale item is missing
ZP-CUSTOM-SALE-ITEM - Customer’s credit is cancelled
ZP-CREDIT-CANCELLED - Customers get no document
ZP-DELIVERY-NOTHING - Differences are open
ZP-DIFFERENCES-OPEN - Document e-mail is off
ZP-EMAIL-OFF - Document has no issuer NIF
ZP-ISSUER-NIF-MISSING - Document type not found in SAGE
ZP-DOCUMENT-TYPE-NOT-FOUND - Exchange unreadable in Shopify
ZP-EXCHANGE-LOOKUP - Extra packs are waiting on your spending cap
ZP-BILLING-CAP-REACHED - Float stores not valid
ZP-TILL-FLOAT-INVALID - Global Blue test environment
ZP-TAXFREE-TEST-ENVIRONMENT - Invalid document type
ZP-DOCUMENT-TYPE-INVALID - Invalid e-mail address
ZP-TILL-EMAIL-INVALID - Invalid notices
ZP-TILL-NOTICES-INVALID - Invalid request
ZP-TILL-REQUEST-INVALID - Invalid staff member
ZP-TILL-STAFF-INVALID - Invoice already credited
ZP-ALREADY-CREDITED - Islands tax zone not confirmed
ZP-ISLANDS-UNVERIFIED - Issuing interrupted by a restart
ZP-STALE-REAPED - Item does not exist in SAGE
ZP-ITEM-NOT-FOUND - Item the online invoice does not bill
ZP-ONLINE-ITEM-NOT-INVOICED - Items with no match in SAGE
ZP-UNMAPPED-ITEMS - Location not set up yet
ZP-STORE-UNCONFIGURED - More than one online invoice fits
ZP-ONLINE-AMBIGUOUS - New sales are no longer issued
ZP-LICENCE-ARCHIVE-ONLY - New-customer defaults missing
ZP-CUSTOMER-MISSING - No confirmed manager
ZP-TILL-NO-MANAGER - No default SAGE payment method
ZP-TENDER-DEFAULT-MISSING - No online shop série ticked
ZP-ONLINE-SERIES-MISSING - No plan chosen
ZP-PLAN-MISSING - No store sells on the POS
ZP-NO-POS-STORE - No Tax Free desk for this store
ZP-TAXFREE-DESK-MISSING - No Tax Free tablet set up
ZP-TAXFREE-NO-TABLET - Not a valid amount
ZP-TILL-AMOUNT-INVALID - Not known whether the return was made in a store
ZP-ONLINE-ORIGIN-UNKNOWN - Nothing of yesterday to close
ZP-TILL-NOTHING-YESTERDAY - Online invoice already credited
ZP-ONLINE-ALREADY-CREDITED - Online invoice in another currency
ZP-ONLINE-CURRENCY - Online invoice not found
ZP-ONLINE-NO-MATCH - Online order unreadable in Shopify
ZP-ONLINE-LOOKUP - Online payment method has no SAGE payment method
ZP-ONLINE-TENDER - Online refund pending
ZP-ONLINE-REFUND-PENDING - Online return in preview
ZP-ONLINE-PREVIEW - Online shop série not usable
ZP-ONLINE-SERIES-INVALID - Only a manager may do this
ZP-TILL-MANAGER-REQUIRED - Only a manager may reopen the till
ZP-TILL-MANAGER-REQUIRED-REOPEN - Only a manager sees earlier closes
ZP-TILL-HISTORY-MANAGERS - Only one manager left
ZP-TILL-LAST-MANAGER - Order cancelled after a document was issued
ZP-CANCELLED-WITH-DOC - Order edited after invoicing
ZP-ORDER-EDITED - Order unreadable in Shopify
ZP-ORDER-UNREADABLE - Order with no items
ZP-NO-LINE-ITEMS - Original invoice unreadable in SAGE
ZP-ORIGINAL-UNREADABLE - Payment failed
ZP-BILLING-PAYMENT-FAILED - Payment method has no SAGE payment method
ZP-TENDER-UNMAPPED - Period with too much activity
ZP-TILL-PERIOD-TOO-LARGE - Plan suspended by zrsPOS
ZP-LICENCE-SUSPENDED - Receipts are waiting and not printing
ZP-PRINTER-STUCK - Refund of a sale with no document
ZP-NO-ORIGINAL-DOCUMENT - Refund with no items and no money
ZP-NOTHING-TO-CREDIT - Register number unknown
ZP-TILL-REGISTER-UNKNOWN - Register sessions stores not valid
ZP-TILL-CASH-OFF-INVALID - SAGE answers for another company
ZP-SAGE-OTHER-COMPANY - SAGE answers with a redirect
ZP-SAGE-REDIRECT - SAGE API key refused
ZP-SAGE-UNAUTHORIZED - SAGE certificate error
ZP-SAGE-TLS - SAGE company not read
ZP-COMPANY-UNREAD - SAGE could not be reached while issuing
ZP-UNREACHABLE - SAGE could not be read
ZP-SAGE-FACTS-UNAVAILABLE - SAGE did not answer a lookup
ZP-SAGE-LOOKUP-FAILED - SAGE did not answer an admin read
ZP-SAGE-UNREACHABLE - SAGE did not answer in time while issuing
ZP-TIMEOUT - SAGE functions could not be confirmed
ZP-LICENCE-UNKNOWN - SAGE internal error
ZP-SAGE-SERVER-ERROR - SAGE is not connected yet
ZP-SAGE-NOT-CONFIGURED - SAGE may still be closing the till
ZP-TILL-SAGE-STILL-WORKING - SAGE payment method not on the till report
ZP-NO-TILL-REPORT - SAGE refused the credit note as a store-credit voucher
ZP-STORE-CREDIT-NRE-REFUSED - SAGE refused the document on validation
ZP-SAGE-VALIDATION - SAGE refused the request
ZP-SAGE-REJECTED - SAGE refused the Tax Free VAT group
ZP-TAXFREE-GROUP-REFUSED - SAGE refused: the payments do not add up to the total
ZP-PAYMENT-SUM-MISMATCH - SAGE’s figures for a close could not be read
ZP-CLOSE-READING-FAILED - Sale from before zrsPOS
ZP-PRE-ZRSPOS - Sale held while your plan was inactive
ZP-DOCS-HELD - Sale zrsPOS did not issue, by decision
ZP-SALE-SKIPPED - Salespeople list unreadable
ZP-TILL-STAFF-UNREADABLE - Salespeople waiting for confirmation
ZP-SELLERS-PENDING - Salespeople without a SAGE salesman code
ZP-SELLERS-UNLINKED - Sending closes to SAGE is paused
ZP-TILL-SAGE-DISABLED - Sending closes to SAGE unavailable
ZP-TILL-SAGE-FORMAT-UNCONFIRMED - Série not communicated to the AT
ZP-SERIES-NOT-COMMUNICATED - Settings are read-only
ZP-LICENCE-READ-ONLY - Setup is no longer ready
ZP-SETUP-NOT-READY - Shopify access cannot be renewed
ZP-SHOPIFY-TOKEN-FAILING - Shopify charged no VAT on this sale
ZP-SHOP-VAT-OFF - Shopify events not finished
ZP-WEBHOOK-UNFINISHED - Shopify location not decided
ZP-LOCATION-UNDECIDED - Shopify locations could not be read
ZP-LOCATIONS-UNKNOWN - Simplified invoice over the limit
ZP-FS-OVER-LIMIT - SmartAPI licence missing
ZP-LICENCE-MISSING - Some steps need attention
ZP-STEPS-NOT-WORKING - Store credit has no SAGE payment method
ZP-STORE-CREDIT-TENDER - Store credit has no SAGE payment method for returns
ZP-STORE-CREDIT-UNMAPPED - Store credit has no SAGE voucher
ZP-VOUCHER-MISSING - Store settings incomplete
ZP-STORE-SETTINGS-MISSING - Tax code not accepted
ZP-TAX-CODE-INVALID - Tax Free sale with shipping
ZP-TAXFREE-SHIPPING - Tax Free setup incomplete
ZP-TAXFREE-SETUP-INCOMPLETE - Test sale not done
ZP-TEST-NOT-READ-BACK - The address is not SAGE’s SmartAPI
ZP-SAGE-NOT-SMART-API - The clock is off
ZP-TILL-CLOCK-SKEW - The close is being sent to SAGE
ZP-TILL-SAGE-BUSY - The company’s name and address are missing
ZP-COMPANY-DETAILS-MISSING - The connection test got no answer
ZP-SAGE-TIMEOUT - The count is below the cash sales
ZP-TILL-COUNT-BELOW-SALES - The document total does not match
ZP-TOTAL-MISMATCH - The drawer count is missing
ZP-TILL-COUNTED-REQUIRED - The exchange waits for the credit note
ZP-AWAITING-RETURN-CREDIT - The float is missing
ZP-TILL-FLOAT-REQUIRED - The item has the wrong VAT
ZP-ITEM-WRONG-VAT - The item tracks stock
ZP-ITEM-STOCK - The money refunded does not match the goods
ZP-REFUND-DISCREPANCY - The order is not paid yet
ZP-NOT-PAID - The paper width is not the one the printer reports
ZP-PRINTER-PAPER-WIDTH - The payment methods do not match Shopify
ZP-PAYMENT-MISMATCH - The payments do not add up
ZP-TENDER-MISMATCH - The period changed
ZP-TILL-CHANGED - The print app needs updating
ZP-PRINT-APP-OUTDATED - The printer has not been checked recently
ZP-PRINTER-UNCHECKED - The printer is not answering
ZP-PRINTER-OFFLINE - The return waits for the sale’s invoice
ZP-AWAITING-ORIGINAL - The SAGE address is on the local network
ZP-SAGE-PRIVATE-ADDRESS - The SAGE codes for Tax Free are missing
ZP-TAXFREE-UNCONFIGURED - The SAGE connection has not been tested for a while
ZP-CONNECTION-STALE - The SAGE till is already in use
ZP-TILL-IN-USE - The sale’s payments cannot be read in Shopify yet
ZP-PAYMENT-SPLIT-UNREAD - The série does not exist in SAGE
ZP-SERIES-EXHAUSTED - The série has no till close document (FCX)
ZP-FCX-MISSING - The série numbering needs fixing
ZP-NUMBERING-CHAIN - The shipping item is missing
ZP-SHIPPING-ITEM-MISSING - The Shopify POS session did not close
ZP-TILL-SHOPIFY-SESSION-FAILED - The store has no SAGE salesman code
ZP-SALESMAN-UNSET - The store must be named
ZP-TILL-LOCATION-REQUIRED - The store-credit voucher is for another credit note
ZP-VOUCHER-WRONG-DOC - The store’s payment term is not in SAGE
ZP-PAYMENT-TERM-MISSING - The store’s SAGE salesman code is not usable
ZP-SALESPERSON-MISSING - The store’s till does not exist in SAGE
ZP-TILL-MISSING - The store’s VAT zone is not in SAGE
ZP-ZONE-NOT-IN-SAGE - The store’s VAT zone is not known yet
ZP-TAXFREE-ZONE-UNKNOWN - The tablet must be named
ZP-TILL-DEVICE-REQUIRED - The Tax Free form could not be voided
ZP-TAXFREE-VOID-FAILED - The Tax Free VAT-exempt group is missing
ZP-TAXFREE-GROUP-GRANDFATHERED - The till changed in the meantime
ZP-TILL-CONFLICT - The zrsPOS block is missing on the tablet
ZP-TABLET-MISSING-BLOCK - The zrsPOS tile is missing on the tablet
ZP-TABLET-MISSING-TILE - This close was not meant for SAGE
ZP-TILL-SAGE-NOTHING-TO-RETRY - This tablet belongs to another store
ZP-TILL-DEVICE-ELSEWHERE - This tablet has no till open
ZP-TILL-NO-TILL-OPEN - This tablet is on another SAGE till
ZP-TILL-DEVICE-ON-OTHER-TILL - Till not closed
ZP-TILL-CLOSE-FORGOTTEN - Unknown SAGE address
ZP-SAGE-DNS - Unknown SAGE till
ZP-TILL-UNKNOWN - Unknown store
ZP-TILL-LOCATION-UNKNOWN - Unrecognised SAGE error
ZP-UNKNOWN - Value-only refund on a Tax Free sale
ZP-TAXFREE-VALUE-REFUND - VAT zone not accepted at this store
ZP-ZONE-NOT-DOMESTIC - Waiting for your approval in Shopify
ZP-PLAN-PENDING - What counts as cash is not valid
ZP-TILL-CASH-TENDERS-INVALID - Who closes cannot change today
ZP-TILL-SCOPE-LOCKED