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.

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.

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.

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.

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.

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 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