POS Common Issues and Fixes

How to use this guide

Find the symptom that matches what you see, read the likely cause, then follow the numbered steps. If the fix needs a permission or setup change you do not have, escalate to your store supervisor.

The register will not open / warehouse required message

The register needs shared stock, so the Warehouse module must be active.

1. Confirm you opened Point of Sale > Register and not another screen.
2. If you see a warehouse-required message, ask an administrator to confirm the Warehouse module is enabled.
3. Confirm your store has a backing warehouse set; without it the store is not POS-ready.

I cannot select my store when opening a shift

Only stores you are assigned to appear in the dropdown.

1. Check that you are assigned to the store — ask your supervisor to add you.
2. Confirm the store's status is active and it has a backing warehouse.
3. Confirm the store has at least one active terminal.

"You already have an open shift"

You can only run one open shift at a time.

1. Return to the Register — it opens straight to selling if a shift is already open.
2. If the earlier shift was left open by mistake, close it (count and close), then open a fresh one.

Barcode not found or item missing

1. Try searching by name instead of scanning.
2. If it still does not appear, the item is not in this store's assortment — ask a supervisor to add it.
3. Confirm you are at the correct store for that product.

Out of stock / stock limit reached

1. The store has no more available stock for that item; you cannot oversell.
2. Reduce the quantity, or ask about a stock transfer or receiving.

Discount will not apply

1. Percentage discount needs the apply-discounts permission — have a supervisor apply it.
2. SC/PWD discount requires the holder's name and ID number; enter both.
3. A percentage of zero is ignored — enter a rate greater than zero.

Payment or checkout is rejected

1. Make sure the total tendered covers the grand total before confirming.
2. Use only a valid method — cash, card, e-wallet, bank, gift, or store credit.
3. Enter a positive amount and any required approval / reference.

A refund or void is blocked

1. Refunds need your own open shift on the same store.
2. Voids only work while the sale's original shift is still open — after close, process a refund.
3. Both need the matching approval permission; call a supervisor if you lack it.

Large cash variance at closing

1. Recount the drawer carefully.
2. Check for cash in/out movements you forgot to record before closing.
3. Add a note explaining the difference and hand it to your supervisor for approval.