Maduuka Frequently Asked Questions

Yes. Maduuka is built to work offline. You can open a POS session, make sales, accept cash payments, and print receipts without internet. Mobile money payments, SMS receipts, and WhatsApp receipts require internet because they depend on external networks.

Sales made offline are saved on your phone. When the phone reconnects to the internet, Maduuka automatically syncs the offline sales to the cloud. A sync indicator at the top of the screen turns green when all data has uploaded.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Maduuka Phase 1 supports MTN Mobile Money Uganda and Airtel Money Uganda. Additional mobile money gateways for other African markets will be added as Maduuka expands.

If the customer does not confirm the MoMo prompt within 90 seconds, the payment request expires and Maduuka shows Payment Timed Out. Ask the customer to check their phone. You can retry the payment or switch to another method such as cash or Airtel Money. No money is deducted when a payment times out.

Card payments such as Visa and Mastercard are not available in Phase 1. They are planned for a future update. Current payment methods are Cash, MTN MoMo, Airtel Money, and credit accounts.

Yes. Maduuka does not store customer MoMo PINs or payment credentials. Mobile money transactions go through official MTN and Airtel APIs over encrypted connections. Business MoMo credentials are stored using industry-standard encryption, and owner accounts can be protected with two-factor authentication.

Maduuka uses Uganda Revenue Authority income tax bands defined in the Uganda Income Tax Act. Monthly chargeable income is gross salary minus the employee NSSF contribution. PAYE is then applied at the correct band: 0% up to UGX 235,000, 10% on the next UGX 265,000, 20% on the next UGX 500,000, and 30% above UGX 1,000,000 per month. Maduuka keeps the bands updated, so you do not calculate PAYE manually.

Yes, for mobile money. After approving a payroll run, you can initiate bulk salary payments to staff MTN MoMo or Airtel Money numbers directly from Maduuka. For bank transfers, Maduuka generates bank payment files for Centenary Bank, Stanbic, ABSA, KCB, Equity, and Dfcu formats for upload to your bank portal.

An approved payroll cannot be edited because that protects your financial records. To correct the mistake, create an adjustment in the following month's payroll with a one-off earning or deduction. Add a note explaining that it corrects the previous month. Your accountant can advise on the correct adjustment amount.

After approving a payroll run, open the payroll run and tap Send Payslips. Payslips can be sent by WhatsApp as PDF files or by email. Staff do not need Maduuka accounts to receive payslips.

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.

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.

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.

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.