Skip to content
Penahak now runs hotels, restaurants and retail on one ledger.
Penahak

Retail POS messages and what they mean

  • Retail POS Troubleshooting
  • Updated October 13, 2026
On this page

Messages the retail POS shows when something cannot be done yet, and what to do about each. When a message says nothing was saved, fix the cause it names and try again.

Opening the till

The till cannot reach the desktop app

On screenCould not access terminal agent.

What it meansThe screen could not talk to the Penahak POS desktop app on this computer, so it does not know which terminal this is.

What to doOpen the Penahak POS desktop app on the till and try again.

Terminals: register a till and bind its computer Problems by symptom

Items to set before selling

On screenList of items need to set in configuration page

What it meansThe till found something it needs missing and lists each one under this heading. Nothing can be sold until the list is empty.

What to doSet each listed item: the table in Open the till says where. Then open POS Sales again.

Open the till and accept the cash Set up a shop for the retail POS: checklist

A ledger, customer or product is not set

On screenSales ledger not set / Sales return ledger not set / Cancel Product not set / Cancel Customer not set / Cash Book ledger not set / Anonymous customer not set

What it meansOne of the accounts the till books to is missing in Configuration.

What to doIn Configuration set Sales ledger, Sales return ledger, Anonymous customer (tab Sales), Cash ledger (tab Voucher) and Cancel product, Cancel customer (tab Miscellaneous).

Configuration settings the till uses Open the till and accept the cash

A numbering series is not set

On screenSales Document Number not set / Sales Return Document Number not set / Journal Voucher Document Number not set / Cash Bank Document Number not set / Debit Note Document Number not set / Payment Document Number not set / Receipt Document Number not set

What it meansThe branch has no active numbering series for that kind of document that covers today.

What to doOn Document numbering add the series for the branch, active, with dates inside the active fiscal year.

Numbering series the till needs Open the till and accept the cash

Accept the petty cash

On screenYou've received petty cash amount Rs. ... For your counter. Please verify in your respective counter.

What it meansThe supervisor gave this till a float for today (and a colleague may have handed cash over to you). Pressing Accept takes responsibility for the drawer.

What to doCount the drawer and press Accept. If the amount is wrong, press Cancel and tell your supervisor.

Open the till and accept the cash Petty cash: the float for each till

Cash and shifts

Yesterday's cash is not handed over

On screenPlease hand over the previous day's cash.

What it meansYou took responsibility for a till on an earlier day and did not hand the cash over. The till will not open until you do.

What to doPress Cash handover, finish the hand over, then open POS Sales again.

Hand over the cash at the end Open the till and accept the cash

The hand over does not match the sales

On screenHandover amount mismatch: Deficit Amount :<n> / Excess amount :<n>

What it meansThe notes and coins counted differ from the cash sales amount of the till. The window asks to type the difference to confirm.

What to doCount again. If the count is right, type the number and confirm; the difference is recorded on the hand over.

Hand over the cash at the end

Petty cash rows not selected

On screenSome of records have not been selected. Would you like to update the petty cash data for these terminals?

What it meansTerminals with an amount are not ticked. If you go on, their floats for today are removed (when not yet accepted).

What to doTick the terminals to keep, or type the number to confirm the removal.

Petty cash: the float for each till

Building the bill

Not enough stock

On screenNot in stock

What it meansThe quantity asked for is more than the stock of the branch's default warehouse, and the company blocks negative stock. The quantity stays as it was.

What to doLower the quantity, or receive or transfer stock first.

Quantities, units and the stock limit

No stock left to add

On screenAvailable Stock is <number>

What it meansThe product is already on the bill in the full quantity the shop holds, so another scan is refused. A warning, not an error.

What to doLeave the line as it is, or lower another line of the same product.

Quantities, units and the stock limit

No stock for a product picked in the search drawer

On screenInformation: Stock quantity less than or equal to 0!

What it meansThe product picked in Search Product has no stock, so it is not added.

What to doChoose another product, or receive stock.

Find and add products

Product search needs three letters

On screenPlease enter at least 3 characters to search product information / No product found with the given search criteria

What it meansThe name box lists products only after three characters, and shows the second sentence when nothing matches.

What to doType at least three letters, or scan the code.

Find and add products

A gift card and other products on one bill

On screenNormal product and gift card product cannot be purchased in a single transaction.

What it meansA gift card sale is a separate bill: it cannot share a bill with other products.

What to doFinish the first bill, then sell the other items on a new one.

Sell a gift card and pay with one

The same gift card twice

On screenThis gift card already included on current sales list.

What it meansThat card number is already a line on this bill.

What to doScan a different card.

Sell a gift card and pay with one

Customer search needs three characters

On screenPlease enter at least 3 characters to search customer information / No customer found with the given search criteria

What it meansThe customer list needs three characters; the second sentence means no active customer matches.

What to doType more of the name, mobile number, PAN or card number; check the customer is active.

Walk-in, named and new customers

The customer is not valid

On screenCustomer is not valid.

What it meansThe customer looked up by number or card was not found, or is inactive.

What to doSearch again by name or mobile number.

Walk-in, named and new customers

A new customer needs a name and a mobile number

On screenPlease provide mobile number and customer name to register as regular customer.

What it meansRegister needs both Name and Mobile Number (10 digits).

What to doFill both and press Register again.

Walk-in, named and new customers

Nothing to hold

On screenThere is no any data to save as draft.

What it meansThe bill has no products, so there is nothing to hold.

What to doAdd products, then press Draft.

Put a bill on hold and recall it

The bill was held

On screenSales data saved as draft successfully

What it meansThe lines were saved under the mobile number, for 30 minutes. Not an error.

What to doRecall it from the arrow of Draft.

Put a bill on hold and recall it

Payment and receipt

No payment line

On screenPlease select a payment option.

What it meansThe bill has no payment lines and no customer to leave it on credit.

What to doPress Cash or Bank/Wallet Payment, enter the amount, and save again.

Take the payment: cash, bank and wallet

No product on the bill

On screenPlease scan a product to proceed further.

What it meansThe bill has no lines.

What to doScan or search a product first.

Find and add products

The bank amount is zero

On screenBank amount must be greater than 0!!!!!

What it meansThe bank or wallet line has an amount of zero or less.

What to doEnter the amount, or switch the Bank/Wallet Payment off.

Take the payment: cash, bank and wallet

Confirm a credit sale

On screenCredit sales confirmation: You are going to do sales on credit. Are you authorized to do so? Please make sure twice with higher authority.

What it meansA named customer who is not a cash selling customer is paying less than the total. The sale is saved only if the cashier types Credit.

What to doType Credit and press Yes if the supervisor allows it; No goes back.

Sell on credit to a named customer

The customer is over the credit limit

On screenThe customer is over their credit limit or on hold. Ask a credit controller to release it, or take payment now.

What it meansThe bill leaves a balance on a customer who is over the credit limit or credit days, or on hold. Nothing was saved. A bill paid in full is never blocked.

What to doTake payment now, or ask the credit controller to release the credit and save again.

Sell on credit to a named customer

The credit check could not run

On screenThe customer's credit could not be checked just now, so the bill was not saved. Please try again in a moment.

What it meansThe credit check timed out, or another sale for the same customer was being saved. Nothing was saved.

What to doPress Sales/Print again after a moment.

Sell on credit to a named customer

Printing

The printer is offline

On screenPrinting failed: <printer>: <reason> (buttons Retry print and Cancel)

What it meansThe Penahak POS desktop app found the printer offline. The bill is saved.

What to doFix the printer (power, paper, cable, online) and press Retry print once.

Print the receipt and reprint a bill Problems by symptom

Returns and replacements

The receipt number cannot be used for the exchange

On screenReceipt no is not valid.

What it meansOn Sales Replacement: the bill has no Non-Cash return, or its return was already used in an exchange, or the number is wrong.

What to doCheck the return was made as Non-Cash and the number is that of the old bill.

Sales replacement: exchange goods

Loyalty and gift cards

The loyalty discount is more than the points are worth

On screenLoyalty discount amount exceeded.

What it meansThe discount typed is more than the customer's points can pay for. The box is cleared.

What to doType a smaller amount, up to the points' value.

Spend points on a bill: the loyalty adjustment policy

The gift card is not valid

On screenGift card is not valid.

What it meansNo sold, active, unexpired gift card with a balance has that number.

What to doCheck the number; check the card on Card Reprint.

Sell a gift card and pay with one

The gift card has no balance

On screenBalance is not sufficient.

What it meansThe card has no balance left to use.

What to doUse another card or pay by another method.

Sell a gift card and pay with one

Another loyalty policy covers these dates

On screenAnother loyalty policy already runs on these dates.

What it meansThe new policy's start or end date falls inside another policy's dates (active or not).

What to doChange the dates so that they do not overlap, or end the other policy first.

Loyalty policy: how customers earn points

Setup screens

The computer is already bound to another terminal

On screenThis computer is already bound to another terminal.

What it meansUpdate Agent found another terminal with the same computer (the same MAC address).

What to doPress Reset terminal on the other terminal first, then bind this one.

Terminals: register a till and bind its computer

The terminal is bound

On screenTerminal settings have been updated to selected agent successfully.

What it meansThe computer is bound to the terminal; the desktop app has its name and the company logo. Not an error.

What to doOpen POS Sales.

Terminals: register a till and bind its computer

No product ticked for labels

On screenProduct list not selected.

What it meansPrint or export was pressed with no product ticked on Product SKU.

What to doTick the products to print.

Print product barcode labels

More in Troubleshooting