POS Errors & Fixes

What it means: the cashier started the sale flow, but the store is still blank.

Example: the cashier added items first, then clicked next, but never chose Main Experience Store or North branch.

• Choose the store first.
• Then choose the terminal for that same store.
• Run the preview again.

What it means: the store is selected, but the counter terminal is not.

Example: the cashier picked North branch, but did not choose North Counter A.

• Pick the terminal that belongs to the store.
• If no terminal appears, ask admin to create or assign one first.

What it means: the cart is empty.

Example: the cashier opened the terminal, selected store and counter, but did not scan anything yet.

• Scan the barcode or search the product.
• Make sure the product is added into the live cart.

What it means: the sale cannot move stock because that store or terminal is not connected to a stock location properly.

Example: the cashier picked a test counter that exists on screen, but its stock warehouse is not set.

• Open store and terminal setup.
• Link the store to the correct warehouse.
• Check that the terminal belongs to that store.

What it means: the cashier chose a non-cash method, but did not save the proof.

Example: payment method is Card Machine, but auth code or slip number was not captured in the popup.

• Open the payment popup again.
• Enter the approval or reference details.
• Then finish the sale.

What it means: a non-cash refund or balance settlement was chosen, but its proof was not saved.

Example: refund method is bank transfer, but the transfer reference was left blank.

• Choose the refund method again if needed.
• Enter the reference, slip, or auth code.
• Process the return or exchange again.

What it means: the user is on Returns, but the sale to return from has not been chosen.

Example: the cashier opened Returns and tried to go ahead before selecting sale MC1-20260405-0042.

• Choose the original sale first.
• Then select the lines that are being returned.

What it means: the sale is selected, but no product line was marked for return.

Example: the cashier opened the sale, but forgot to tick the product card.

• Select one or more return lines.
• Check the quantity and refund amount for each line.

What it means: the return is ready, but the app still does not know whether the money is going back as cash, card, wallet, or store credit.

Example: the cashier chose the return lines, but forgot the refund method field.

• Pick the refund method.
• If it is non-cash, also enter the proof reference.

What it means: the cashier typed a refund that is higher than what the selected quantity allows.

Example: one piece was sold for Rs.500, but the cashier typed Rs.700 as refund for one piece.

• Check the selected quantity again.
• Reduce the refund amount to the allowed value.

What it means: the exchange needs a live register session, but none was selected.

Example: the user selected the old sale and the replacement item, but forgot to choose the current open counter.

• Pick the open register session first.
• Then continue with the exchange.

What it means: the old sale is selected, but no item from that sale was marked for exchange.

Example: the user opened the exchange page and jumped to replacement product without choosing the item coming back.

• Select the original sale line first.
• Then choose the replacement item.

What it means: the replacement product is not available in the selected exchange store.

Example: the customer wants a larger size, but the current counter store does not have that larger size free in stock.

• Choose another replacement product.
• Use another open counter that belongs to a store with stock.
• Or reduce the replacement quantity.

What it means: the exchange page is not allowing a random manual price for the replacement item.

Example: the replacement item sells for Rs.1,000 now, but the user typed Rs.700 by hand.

• Let the page use the current product selling price.
• If a special price is really needed, update the pricing rule instead of forcing it here.

What it means: the assisted order form stays locked until the store check is done.

Example: the seller opened Assisted Orders and tried to fill the right-side form before clicking Check Stores.

• Choose the product and quantity.
• Click Check Stores.
• Then continue to the order steps.

What it means: none of the allowed stores has the item right now.

Example: the customer wants 5 units, but every listed store shows 0.

• Choose another product.
• Reduce the quantity if smaller quantity is available later.
• Restock the item first.

What it means: the seller picked a source store that cannot supply the requested quantity.

Example: source store is North branch, quantity is 4, but North branch has only 2.

• Choose another source store.
• Or lower the quantity.

What it means: pickup store was chosen, but that store itself does not have the item available under the current assisted-order rule.

Example: the user chose South branch as pickup, but South branch is not in the available list for that item.

• Pick a pickup store that appears in the checked stock list.
• If needed, run the availability check again.

What it means: the source warehouse or bin does not have enough released stock for the requested branch movement.

Example: Main Warehouse has 4 units in the selected bin, but the transfer request is for 5.

• Lower the requested quantity.
• Choose another source bin or source warehouse that has enough stock.
• If the request was already created, approval checks the source balance again because another sale or transfer may have used the stock.

What it means: the order quantity is higher than what the selected store combination can support.

Example: pickup or source store has 4, but the seller typed 5.

• Reduce the quantity.
• Or choose stores that have enough stock.

What it means: assisted orders must take payment in an open session that belongs to the pickup store.

Example: pickup store is Main Experience Store, but the selected session belongs to North branch.

• Choose the pickup store first.
• Then choose one of that store's open sessions.
• If no session is listed, open one from Register Sessions.

Meaning: the action crossed a limit set by the business, like a large refund, large discount, large void, or big cash variance.

Example: cashier tries a large discount and the app asks for manager reason or approval.

• This is a control, not a system failure.
• Ask the manager to review or approve the action.

Meaning: the user is trying to work in a store, counter, or session outside their allowed branch scope.

Example: North cashier logs in and tries to use a South branch session.

• Use the correct branch login.
• Or ask admin to fix the user's store or terminal assignment.