Maduuka Frequently Asked Questions

Answers for business owners who need a POS that controls stock, handles mobile money, protects records, and gives management a clean view of the business.

If your current POS has caused missing receipts, stock confusion, weak cashier control, or painful month-end reporting, this FAQ explains how Maduuka is built differently. It is written for shops, pharmacies, restaurants, supermarkets, and multi-branch businesses that need software staff can actually use every day.

Why businesses switch to Maduuka

One record across every device

Sales, stock, and payments recorded on Android or the web land in the same cloud record, so managers see the same numbers as the till.

Protects stock and receipts

FIFO, FEFO, stock counts, transfers, receipt sequences, sessions, refunds, and audit controls reduce guesswork.

Built for Ugandan operations

MTN MoMo, Airtel Money, Uganda PAYE, Android-first use, cloud backup, and local business workflows are part of the design.

Getting Started

Setup, devices, trial access, users, subscription choices, and what happens to your data.

What devices can I use Maduuka on?
You can use Maduuka on any Android phone running Android 8.0 Oreo or newer with at least 2 GB of RAM. Maduuka also works in modern web browsers including Chrome, Firefox, Edge, and Safari on laptops, desktops, and tablets. The web version does not require installation.
How much does Maduuka cost?
Maduuka is a monthly subscription. Pricing depends on your plan, number of users, and number of branches. Current prices are shown inside your Maduuka account under Settings > Subscription, with plan prices displayed in your local currency.
Are onboarding and staff training included in my subscription?
No. Your subscription covers use of the Maduuka software only. It does not include onboarding, data migration, or staff training. We have designed Maduuka so that owners and managers can set it up themselves — create branches, import products, invite staff, and start selling — using guided screens and industry templates. If you would prefer our team to onboard your business or train your staff, we provide this as a separate paid service, quoted according to the work involved. Contact us for a quote.
Can I try Maduuka before paying?
Yes. Every new account gets a 30-day free trial with full access to its features. No credit card is required to start. At the end of the trial, your account moves to the Free plan and your data is kept; subscribe to the plan that fits your business to continue with full features.
What happens to my data if I cancel?
Your data is not deleted immediately. When you cancel, your account enters a 30-day grace period. During that period you can export your data from Settings > Data Export. After 30 days, your data is permanently deleted from Maduuka servers, so export before the grace period ends.
How do I add more users to my account?
Go to Settings > Users, tap Invite User, enter the user's email address, select their role, and send the invite. The new user receives an email link to set a password and log in. The number of users you can add depends on your subscription plan.

POS and Sales

Offline selling on Android, receipts, split payments, cashier sessions, refunds, and sales history.

Does Maduuka work without an internet connection?
The web app needs a connection. The Maduuka Android app has functions that keep working offline: cash and on-account sales, offline sign-in, customers, expenses, parked carts and daily till work are saved on the phone and sent automatically when the connection returns. Approvals, refunds, reports and the accounting workspace work online. The offline POS app page explains each function.
Can I use my own receipt printer?
Yes. Maduuka supports 80mm Bluetooth thermal receipt printers on Android and USB thermal printers on the web. Confirmed models include Epson TM-T82, Xprinter XP-58, and TP-Link 80mm thermal printers. Printers that use the ESC/POS command standard should work.
How do I handle a customer who wants to pay half cash and half mobile money?
Use split payment. On the payment screen, tap Split Payment, choose Cash, and enter the cash amount. Then tap Add Another Payment, select MTN MoMo or Airtel Money, and enter the remaining amount. Maduuka confirms when the payment total matches the sale amount.
What is a POS session and why do I need to open one?
A POS session is the record of one cashier's shift. It tracks the opening cash float, every sale made during the shift, and the closing cash count. Sessions help owners see what each cashier sold, what they collected, and whether the till cash matches the records. You must open a session before making sales.
Can I refund a sale from a previous day?
Yes, with manager or owner permission. Go to More > Sales History, find the sale, and tap Refund. Enter the reason and refund amount. A manager must approve with their PIN. The refund creates a new transaction, preserving the original sale record.
How do I find a receipt I printed last week?
Go to More > Sales History, use the date filter to select last week's range, then search by customer name, product, or transaction amount. Open the sale to view or reprint the receipt.
What is the receipt gap report?
The receipt gap report checks whether any receipt numbers are missing from the sequence. In a clean sales record, every sale receives a sequential receipt number. Missing numbers may indicate that a sale was deleted after printing. Find it under More > Reports > Receipt Gap Report.

Inventory

FIFO, FEFO, expiry tracking, stock counts, negative stock controls, and branch transfers.

How does FIFO or FEFO work, and why does Maduuka pick a specific batch?
FIFO means First In, First Out: the batch received first is sold first. FEFO means First Expired, First Out: the batch expiring soonest is sold first. For products with expiry dates, Maduuka uses FEFO so old or near-expiry stock moves first. For products without expiry dates, Maduuka uses FIFO. At the POS, Maduuka selects the batch automatically.
What is a stock count and how often should I do it?
A stock count is when you physically count items on your shelves and compare them with Maduuka's records. It helps confirm that stock has not been lost, stolen, damaged, or miscounted. Most retail shops should run a full count monthly, while high-value or fast-moving categories can be counted weekly.
Can I track products that expire?
Yes. When adding a product, turn on Track Expiry Dates. When receiving that product from a supplier, enter the batch number and expiry date. Maduuka can alert you 30, 60, or 90 days before expiry, depending on your inventory settings.
What happens when stock goes to zero? Can I still sell?
By default, Maduuka warns you when stock reaches zero. Whether you can still sell depends on the owner's Allow Sales Below Zero Stock setting. If negative stock is disabled, the product is greyed out in the POS and cannot be added to the cart.
How do I transfer stock between my two branches?
Go to Stock > Stock Transfers > New Transfer. Select the sending branch and receiving branch, add the products and quantities, then send the transfer. The stock is marked In Transit until the receiving branch confirms delivery.

Payments and Mobile Money

MTN MoMo, Airtel Money, cards, split tender, and how payments reach your accounts.

Can my customers pay with MTN MoMo or Airtel Money?
Yes. Customers pay to your MTN MoMo or Airtel Money merchant number as they always do, and the cashier records the payment with its transaction reference. The amount lands on that account's balance in Maduuka and in the books in the same step, ready to reconcile against the provider's statement.
Can a customer pay part in cash and part by mobile money?
Yes. Use split payment at checkout: enter the cash amount, add a second payment for the mobile money amount and its reference, and Maduuka confirms when the total matches the sale. Each part lands in its own account.
Can customers pay by card?
Yes. A payment taken on your own card terminal is recorded against the bank or card account it settles into, so you can reconcile it when the bank statement arrives. Where DPO Pay's hosted checkout is enabled for your business, card payments can also be taken through it.
How do I check that mobile money received matches what the till recorded?
Reconcile the mobile money account against its statement. Each recorded payment carries the reference the customer gave, so matching is a line-by-line exercise, and items that do not match stay visible until someone resolves them.

Accounting and Financial Statements

Double-entry books on every package, upgrading, statements for banks and investors, and corrections.

Does Maduuka keep proper accounts on the Free plan?
Yes. On every package, including Free, each sale, payment, purchase, expense and stock movement is posted to a double-entry ledger as it happens. The smaller packages show you fewer accounting screens, but the books underneath are complete.
If I upgrade later, will my financial statements include my earlier months?
Yes. Upgrading to Premium or an industry package opens the general ledger, trial balance, period close and full statements on the ledger Maduuka has kept since your first sale. There is nothing to re-enter, and your statements include the months before the upgrade.
Can I use Maduuka's statements for a bank loan or an investor?
Yes. Print or download the Profit and Loss, Balance Sheet and Cash Flow Statement as PDFs. Each journal carries the number of the invoice, receipt or bill that created it, so any balance can be followed back to its documents. That is the kind of record lenders, investors and auditors ask to see, and your accountant can sign off from the same books.
Can someone change or delete an old transaction?
No. Posted journals are protected and cannot be edited. Mistakes are corrected with a reversing entry, and documents such as invoices and payments are voided with a reason, never deleted. Each document type keeps an unbroken number sequence, so a missing number would stand out.
Do I still need QuickBooks or another accounting package?
On Premium or an industry package, most small and growing businesses do not. Maduuka produces the ledger, trial balance and financial statements from the same transactions your staff record every day. Your accountant can work directly in Maduuka or take the reports and exports into their own tools for tax and statutory work.

HR and Payroll

Uganda PAYE, NSSF, LST, salary payments, corrections, and payslips.

How does Maduuka calculate PAYE?
Maduuka calculates PAYE from the Uganda Revenue Authority income tax bands held in the payroll settings, and works out employee and employer NSSF and Local Service Tax in the same run. When URA changes the bands, the settings are updated so you do not calculate PAYE by hand. Your accountant should still review the first payroll run after any rate change.
Can I pay salaries through my bank?
Yes. After approving a payroll run, Maduuka produces a bank payment file in the format for Stanbic, Centenary, dfcu, Equity or ABSA, or as a general CSV file, for upload to your bank's business portal. The salary cost, deductions and liabilities post to the books when the run is approved.
What happens if I made a mistake in a payroll that is already approved?
An approved payroll cannot be edited, because that protects your financial records. To correct the mistake, add a one-off earning or deduction in the following month's payroll, with a note explaining that it corrects the previous month. Your accountant can advise on the correct adjustment amount.
How do staff receive their payslips?
Payslips are produced from the approved payroll run and can be exported for printing or sharing with staff. Staff do not need Maduuka accounts to receive them.

Data and Security

Cloud backup, account isolation, stolen-phone recovery, connected devices, and data export.

Is my business data backed up?
Yes. Maduuka automatically backs up data on its cloud servers multiple times per day. Your records are not stored only on your phone. If your phone is lost or damaged, log in on a new device and continue working.
Can my competitor see my data if they also use Maduuka?
No. Each business account is separated from every other account. Maduuka uses a multi-tenant architecture with isolated business data, so another business cannot access your sales, customers, stock, staff, reports, or settings.
What happens if my phone is stolen? Can someone access my Maduuka account?
If your phone is stolen, log in from another device, go to Settings > Security > Connected Devices, find the stolen phone, and tap Revoke Access. This logs the stolen phone out immediately. Enable two-factor authentication so a password alone is not enough to log in.
How do I export all my data?
Go to Settings > Data Export, select the data to export, choose a date range, and tap Export. Maduuka prepares a CSV file for download. For a full account export, select All Data and leave the date range blank.
Smiling woman in a grey sweater using an app on her phone
Android app · works offline

Android app · works offline

Keep selling when the network drops

The Maduuka Android app keeps your counter open through a network cut. Sales and daily work are kept on the phone and sent to your records when the connection returns.

  • Cash and on-account sales with no connection
  • Offline sign-in for staff who signed in online on that phone in the last seven days
  • Customers, expenses and receipt photos saved until they can be sent
  • Every sale checked and numbered by the server when you reconnect

Ready to replace the POS that keeps slowing you down?

Start with a free trial, make test sales, run stock, invite users, and confirm whether Maduuka fits your daily operations before you pay.