POS User Guide Docs

Frequently asked questions

Short, plain answers to the things shop owners ask most. If your question isn't here, try the search box at the top, or head to Troubleshooting when something isn't working as expected.

Getting started

How do I make my first sale?

Open the POS screen from the sidebar, add items by scanning a barcode or tapping a product tile, then press Pay and take the money. The full walkthrough is on The POS screen.

I just installed it — what should I set up first?

Set your company details, currency and timezone first, then add a few products. The Getting started page walks you through it in order, and General settings covers each option.

Do I need any special hardware to begin?

No. You can run sales on any computer, tablet or phone with a web browser. A barcode scanner, receipt printer and cash drawer make life easier, but they're optional — see Hardware & printing when you're ready to add them.

How do I find my way around the screens?

Everything lives in the left sidebar, grouped by area. There's also a search box (press Ctrl + K) to jump straight to any page. See Finding your way.

Selling & payments

How do I give a refund?

On the POS screen open the ⋯ More menu, choose Refund / Return, look up the original receipt and pick what's coming back. Full steps are on Returns & refunds. You'll need the refund permission — see Users & roles.

Can I take card or QR payments?

Yes. You can record a card payment, and if you connect a payment provider (such as Stripe, Razorpay or Paystack) the customer can scan a QR code and pay on their phone. See Taking payments.

Can one sale be paid part cash, part card?

Yes — that's called a split tender. In the Pay window add a payment row for each method until the total is covered. Taking payments shows how.

Why won't a sale complete?

A walk-in (no customer) sale must be paid in full before it can finish. Either collect the rest, or attach a saved customer so the remainder can be left on credit. More fixes are on Troubleshooting.

A customer changed their mind mid-sale — can I pause it?

Yes. Press Hold to park the basket, serve the next person, then reopen the held sale to finish it. No need to re-scan anything.

How do I apply a discount?

You can reduce a single line or the whole basket, by a percentage or a fixed amount. See Discounts & pricing.

What's a shift, and do I have to use them?

A shift is one cashier's session at the till — you open it with a starting cash amount and close it by counting the drawer. It's optional, but it makes your end-of-day cash count accurate. See Shifts & cash drawer.

Products & stock

How do I add a product?

Go to Products in the sidebar and click New product. Give it a name, price and (if you have one) a barcode. The Products page covers every field.

Can I import lots of products at once?

Yes. Every list screen has CSV/Excel import and export, so you can bring in your whole catalogue from a spreadsheet. Open Products and use the Import button.

Do I need a barcode scanner?

No, but it's the fastest way to ring up items. Most USB scanners work the moment you plug them in — they simply type the code for you. You can also tap product tiles or search by name. See Hardware & printing.

Do I have to invent a code (SKU) for every product?

No — leave the SKU blank and one is generated when you save, following the pattern you set in Settings → Numbering. Type your own whenever you'd rather, and it's kept exactly as entered. See Product codes.

What about items that have no barcode at all?

Click Generate next to the Barcode field on the product and the system creates a real, scannable in-store barcode for it — then print a label. It only ever happens when you ask for it. See Barcodes for items that don't have one.

How do I print barcode labels?

Pick the products, choose a label layout and print to an ordinary A4 sheet of sticker labels. See Barcode labels.

Can the system tell staff where a product is kept?

Yes. Record a shelf location on a product — aisle, rack, shelf, bin — and it shows on the cashier screen, your stock lists, deliveries and (optionally) printed labels. A product can be kept in several places at once (shop floor, godown, fridge, locked cabinet), and each store keeps its own answer. See Shelf locations.

Do I have to type a location onto every product one by one?

No. From the products list you can filter to an aisle's worth of items and set the location on all of them at once — including every product matching your filter, not just the page you can see. Locations also come in and out through CSV/Excel import and export. See Setting locations in bulk.

Can I print a sheet to count stock on paper?

Yes — open a stock reconciliation and choose Print count sheet. It's grouped by shelf location in walk order, and there's a blind option that hides the expected quantities so whoever counts writes down what they actually see. See Printing a count sheet.

How do I track items by batch and expiry date?

Turn on batch tracking for those products. The system then records each batch's expiry and sells the soonest-to-expire first. This is mainly for pharmacies — see Batches & expiry.

How do I sell items by weight?

Mark the product as sold by weight. The till then asks for the weight (or reads it from a scale barcode) and works out the price. See Weighed & scale items.

My stock count looks wrong — how do I fix it?

For a one-off correction (damage, breakage, a miscount) use a Stock adjustment. To recount a whole shelf or store, run a Stock reconciliation.

Customers & credit

Can a customer pay later (on credit)?

Yes, as long as you attach a saved customer to the sale before paying. You can then leave part or all of it unpaid; the balance is added to what they owe. See Customers.

How do I collect money a customer owes?

Go to Customer payments, pick the customer and record what they paid. The system can spread it across their oldest unpaid sales automatically. See Customer payments.

How do I see who owes me money?

The aged receivables report lists every customer with an outstanding balance, grouped by how overdue it is. Find it under Reports.

Do I have to add a customer to every sale?

No. Most sales are walk-ins with no customer attached. You only need a customer for credit, loyalty, or keeping a purchase history. See Customers.

Can I run a points / rewards scheme?

Yes. Turn it on under Settings → Loyalty points and set how fast points are earned and what they're worth. Any sale with a customer attached earns them automatically, and the cashier can spend them as money off a later purchase. See Loyalty points.

A customer's discount is wrong — where does it come from?

If the customer's own discount field is blank, they get their group's rate — so changing the group changes them too. Type a number on the customer to override it just for them (it replaces the group rate, it isn't added to it). See Customer groups.

Can I create a sale without using the cashier screen?

Yes — Sales → New sale raises a full sale from the back office, for phone orders or invoices. It doesn't need an open shift, and cash recorded there doesn't count towards a drawer count. See Creating a sale from the back office.

Money & reports

How do I set my currency?

Open General settings and set your currency, symbol position and decimal places once — it applies everywhere in the app. See General settings.

How do I add tax (VAT / GST)?

Create your tax rates and group them, then assign them to products. The system adds tax to sales automatically. See Taxes.

What reports can I see, and can I export them?

You get sales summaries, best-sellers, money owed to you and more — and every report exports to CSV or Excel. See Reports.

How do I check today's takings before closing?

If you use shifts, the X report shows the running total without closing the till, and the Z report finalises it at close. See Shifts & cash drawer.

Someone took cash out of the till for petty spending — how do I record it?

Use Cash in / out from the ⋯ menu on the cashier screen, or the Cash drawer panel on the shift. Choose Expense as the reason and POS books a real expense as well as reducing the drawer, so it lands on your profit & loss instead of showing up as a shortage. It works the other way too — a cash expense recorded in the back office takes the money out of the drawer for you. See Putting cash in and taking cash out.

Why do my older sales show 100% profit?

They were recorded before the system stored the cost on each sale line, so there's no cost to subtract. Run Settings → System Health → Rebuild historical sale costs — it works out what each item actually cost when it sold, previews the result, and writes nothing until you confirm. See Profit, cost and margin.

Setup, staff & data

How do I add a staff member and limit what they can do?

Create the person under Users & roles and give them a role. A role is a tick-list of permissions, so you decide exactly what they can see and do — for example, sell but not give refunds. See Users & roles.

Can I use it without internet?

Yes — the checkout screen keeps working when the connection drops. Sales are saved on the device and sync up the moment you're back online. See Selling offline.

Is my data sent anywhere?

No. This is self-hosted software that runs on your own server, so your sales and customer data stay with you. The only outside contact is optional: a payment provider if you take online payments, an AI provider if you switch AI features on, and a check for software updates.

What is the "cron job" and do I really need it?

It's a single scheduled task you add in your hosting control panel that nudges the POS once a minute. Selling works fine without it, but anything meant to happen on its own won't: automatic backups, scheduled report emails, low-stock alerts and update checks. It takes about two minutes to set up — see Setting up the cron job.

How do I back up my data?

Go to Backup & restore, create a backup and download the file to a safe place. You can restore from it later if you ever need to. See Backup & restore. Always take a backup before any big change.

Can I run more than one store?

Yes. One install runs one company, and that company can have several stores (locations) with their own tills. You can even move stock between them. See Stores & terminals and Stock transfers.

Can staff at one branch see another branch's figures?

No. Each user is assigned to the stores they work at, and lists, reports, exports and scheduled report emails only ever include those stores. Administrators see everything. See Which stores a user can see.

What happens when I deactivate a member of staff?

They're locked out immediately — any session they already have open ends the next time it's used, so someone who has left can't keep working from a browser they never signed out of. Their sales history is kept. POS also stops you from removing the last administrator or switching off your own account. See Built-in guardrails.

Can I use the app in another language?

Yes. You can switch languages, and right-to-left languages display correctly. You can also export the text to translate it yourself. See Languages.

How do I update to a new version?

The app checks for updates and tells you when one is available; you can apply it from Updates & license. Take a backup first. See Updates & license.

Still stuck?

If something isn't behaving, the Troubleshooting page lists common problems and their fixes. Unsure what a word means? Check the Glossary.


Related: Troubleshooting · Glossary · Getting started · The POS screen