Android App

The Android app is not a smaller copy of the website. It is a complete till built to keep working when the internet does not: everything you enter is saved on the phone first and sent up to the server when a connection returns. That one design decision explains most of what's different about it, and it runs through this whole manual.

Worked examples use the customers Dozie, Adaora and Kenneth — the same names as the web guides, so the two read together.

1. Getting the app

• Install MAT Smart Shop from the Google Play Store.
• It runs on ordinary Android phones and tablets. A tablet on a stand makes a comfortable counter till; a phone is ideal for the floor, a market or deliveries.
• Allow the permissions it asks for when you use a feature: the camera (scanning documents), Bluetooth (receipt printers), and notifications.
• From the menu, Watch: Your First Week plays a short video walking through your first customer, item and sale.

2. Creating a store on the phone

If you don't have a MAT Smart Shop store yet, tap Create a New Account on the sign-in screen. It's the same two-step registration as the website:

1. Step 1 of 2 — company / store name (at least 2 characters, unique across MAT Smart Shop), business address (at least 6 characters) and business email.
2. Step 2 of 2 — your name, country and state (the currency fills in from the country), and a password of at least 6 characters, typed twice.
3. Create My Store.

If the email already has a store, the app offers Add New Store — Confirm Your Identity: enter that account's password to create another store under it. Confirm your email from the message you're sent — see the Store Setup, Users & Security guide for why that matters.

3. Setting up this phone

The first time you sign in on a phone, the app has to fetch your store onto it. This needs an internet connection; afterwards the phone works offline.

1. Connect to Store — "Recover a store into this phone and use offline". Enter your email and password and tap Login.
2. If your account has more than one store: Choose a store for this device. A phone belongs to one store at a time.
3. Select a sales point:
   • Download Record From Date — first choose how far back to bring your history onto the phone (e.g. the start of this year). Further back means more history offline, but a longer first download.
   • Pick a sales point (till) from the list, or type a name under Add a sales point to continue and Save.
   • Confirm "Do you want to continue as Front Counter sales point?"
4. The app downloads your items, customers, payment types and records, then opens Sale Center.

4. Signing in and out

5. Getting around: Sale Center and the menu

5.1 Sale Center — the home screen

A just-made sale or quote opened from here before the phone has synced may say "This sale hasn't synced yet — open it after the next sync." Tap the badge to sync, then open it.

5.2 The menu

Tap ☰ at the top left. The drawer header shows the store and the user — check them before entering anything. The drawer is long; swipe up inside it for the lower groups.

Staff see only the items their permissions allow; opening one they lack shows "You don't have permission to open that screen". Permissions are set by the owner on the website (section 24).

6. Easy Sales

Easy Sales (top of the drawer) is a simple launch pad for newer users, built around three cards:

Below them, shortcuts: Do more with Main Dashboard, Complete online store setup and Setup Delivery Locations.

7. Main Dashboard

• Cash Collected This Month — money actually received, not invoiced.
• Profit & Loss for a date range you can change, with a PROFIT or LOSS bar and Sales, Cost of Sales and Expenses beneath, each with an arrow against the previous period.
• Money Owed To You, with Chase Details →.
• Top Owing Customers (ranked #1, #2…) — tap to collect → records their payment.
• Customers Gone Quiet — "23 days silent", last sale date and what they owe.

The figures come from the phone's own records, so they are only as current as the last sync. For how to read sales, cost and profit, see the Dashboards & Reports guide.

8. Quick Sell — the fastest way to ring up a sale

Android-only, and the reason many shops keep a phone on the counter even when a PC is available.

8.1 The screen

8.2 Typing items

A name that matches nothing offers to create it as a new item. Typing a price with @ overrides the price for this sale only — the item's own price is unchanged.

8.3 Taking the money

With items in the cart, the grey Add items to sell button becomes a green Collect amount. Tap it for the payment sheet:

• Amount due; choose a PAYMENT METHOD (or + New payment type).
• AMOUNT RECEIVED — tap Exact for the exact amount, or type what was handed over. Over-payment shows the Change to give; under-payment shows the Outstanding that stays on the customer's account.
• Collect saves the sale.

If you save something that looks like one you've just saved (same customer, same total), you'll see Possible duplicate — "Save anyway?" Check before you tap yes.

8.4 A full walkthrough: sale → invoice → payment → the customer's account

One Basket Ball to Dozie, followed all the way to his updated balance.

With Dozie attached, the customer row shows his existing balance ("Owes 121,658.25") before you add to it. Tapping the suggestion adds the line and the footer turns into Collect 490.00:

For a credit sale, Save Invoice asks for the payment type the customer will use to settle:

Pay Balance opens Collect Payment, pre-filled with the outstanding amount and the invoice's payment method. COLLECT posts it and offers a receipt:

Back on Sale Center, the Paid count has gone up by one, Dozie's card shows Receipt ›, and the badge reads ↻ Sync now — the sale exists on the phone, and the next sync sends it up.

9. Enter Sales / Quotation

The full sale screen, for when a sale needs more than Quick Sell's speed: several lines with their own tax, a specific payment type, a discount, a paid amount, or a quotation.

1. Enter Date, Select Payment (payment type) and Select Customer. The customer picker has Add New Customer.
2. CLICK TO ADD ITEM. Search the item (or Add New Item), then set Quantity, Unit Price and Apply Tax YES/NO. Amount, tax and total calculate themselves. Add. Repeat for each line; tap a line to delete it.
3. Totals: Discount (amount) or Discount (%), then Net, Tax and Total.
4. Paid Amount — what the customer is paying now. Balance shows what stays on account; Change what to hand back.
5. Loyalty — Compute Customer Loyalty shows the customer's loyalty balance; enter an amount to redeem (it can't exceed their balance).
6. Sell saves a sale ("Sales Is Posted Successfully"). Quote saves a quotation. Cancel discards.

A quotation can't carry a discount amount or a paid amount — add those when it's converted to an invoice.

10. Invoices and the Sales List

Sales List (Sales group) lists every sale on the phone — customer, date, amount and amount paid. Tap one to open the invoice.

Tapping the customer's name on the invoice opens their transaction list — useful for editing their details or loyalty (section 12).

11. Quotations

Quotation List shows every quotation — customer, date, amount. Tap one for the Sales Quotation screen (QUOTE NO, raised by, lines and totals).

A quote made on this phone must sync before it can be converted: "This quote hasn't synced yet — convert it after the next sync."

12. Customers

12.1 Customer Center

• CUSTOMER OVERVIEW — Total Customers, Active, Owing, Settled, Total Owed.
• TOP OWING — highest balances first.
• MONTHLY TREND (last 12 months) — Invoiced, Paid and Owed together. The gap between Invoiced and Paid is your collection problem, drawn.
• ALL CUSTOMERS — search by name or phone; tap one for their profile.

12.2 Customer Profile

• Header: OWING badge, Total Purchases, Payments Made, Outstanding, Last Transaction.
• WhatsApp and Call — one tap to reach them ("No phone number on file" if there isn't one).
• More ▼ → Add Payment or Transaction List.
• TRANSACTION HISTORY (newest first) and BALANCE TIMELINE (last 12 months).
• Tap a payment in the history to re-issue its receipt or void it (if it was recorded in error).

12.3 Adding and editing customers

Customers (Sales group) is the searchable list. Add Customer opens Create Customer:

Add To List queues the customer; add several, then Save List (on the phone) or Save And Sync List (and send them up now). To edit, open the customer's transaction list from an invoice and choose edit, or edit on the website.

13. Collecting payments

Four ways to record money received — all do the same thing to the books:

After collecting, the app offers a Payment receipt to share or download. Sharing receipts is a metered action on the Freemium plan ("Top up your wallet or earn tokens to share receipts" means your usage units have run out — see section 25).

14. Payment Types

Payment Type (Sales group) lists how customers pay. Enter New Type → Save to add one. Tap a type to set its Payment instructions — "Shown on unpaid invoices paid via Zenith Bank": bank name, account name and number. Delete with the bin (asks to confirm). Keep these the same as on the website; see the Store Setup, Users & Security guide, section 8.

15. Items and stock

15.1 Inventory Center

• INVENTORY OVERVIEW — Total Products, Low Stock, Out Of Stock, Stock Value.
• FASTEST SELLERS — by quantity sold and by sales value. High-volume cheap lines and low-volume valuable ones are different businesses; this shows both.
• SLOW MOVERS (IN STOCK) — money sitting on your shelves.
• STOCK MOVEMENTS — the last 6 months, in and out.
• INVENTORY ITEMS — search by name or code; ITEM, CODE, QTY, PRICE, STATUS. Tap one for Item Detail.

15.2 Inventory List and adding items

Add Items opens Item Entry:

1. Choose Product (has stock) or Service (doesn't).
2. Item Name, Purchase Rate (cost), Sales Rate (price).
3. Opening Stock — what's on the shelf today only. Everything arriving later should be a purchase (section 16).
4. Reorder Level — the quantity at which it counts as low stock.
5. Tax — tick if the item is taxable. ("Tax Rate Is Not Set: Go to Edit Shop to set tax rate" means the store has no tax rate yet — section 26.)
6. Add To List; repeat; then Save List. Names already used are refused.

15.3 Item Detail

Tap any item for its dashboard:

16. Purchases and adjustments

Purchase List shows every stock entry with its Status: Opening (starting stock), Purchase (bought, with a cost) or Adjustment (a correction). Search by item name. A wrong entry can be deleted (confirm when asked).

16.1 Recording a purchase

Enter Purchase (or Sale Center → Add Stock, or Item Detail → Restock → Add Purchase):

1. Enter Date and the Item Name. Current Quantity shows what's on hand.
2. New Quantity — how many arrived. Purchase Price — the cost of one unit, not the total.
3. Sales Price is shown for reference — "Set on the item — not changed by this purchase".
4. Add Quantity / Save. Reset clears the form.

16.2 Recording an adjustment

Item Detail → Restock → Add Adjustment opens Adjust Quantity: enter the Difference (positive to add, negative to remove) and the app shows the New Quantity. Use it after a stock count, or for damage and expiry.

17. Expenses

• Expense Class — your spending categories (Rent, Fuel, Salaries…). Add Expense Class → Name and Description → Add To List → Save List.
• Expense — the list of expenses (search by name). Add Expense → Enter Date, Select Expense Class, Amount, Description → Add To List → Save List or Save And Sync List.

On the phone an expense is recorded as paid, with no vendor. For bills you'll pay later, or to keep a supplier's account, record the expense on the website — see the Expenses, Vendors & Budgets guide.

18. Scan a document

• Photograph a written or printed sheet — a sales book page, a supplier invoice, a receipt — and the app reads the names and numbers off it.
• The document type defaults to Auto-detect; tap it to choose the type yourself when the sheet is ambiguous.
• Open Scanner uses the camera; Upload File Instead takes a photo from the gallery.
• Nothing is saved until you've checked the result. Every line can be corrected, re-matched or removed first.
• Scanning uses usage units per page on the Freemium plan.

The review stage — matching read lines to your items, the prices-versus-quantities question, and the cross-checks that catch a dropped line — is documented in full in the Upload & Scan guide. Read it before your first real scan.

19. Customer Follow-Up and SMS

The same audiences as the website — Open Balance, Gone Quiet, Bought Once, Birthdays — drawing on the same SMS unit balance.

The line under the unit balance is the one to read, e.g.:

59 match · 47 can be texted now · 1 on DND (corporate route) · 2 with a dead number · 12 without a phone number

It separates DND numbers (reachable only on the costlier corporate route) from dead numbers (ones that have already failed delivery — fix them on the customer's record). Everything else — filters, the Payment details to quote dropdown feeding {paymentdetails}, the token buttons, the automatic greeting, and the live preview with its character and page count — works as documented in the Customer Follow-Up guide.

To reach one customer without spending SMS units, use the WhatsApp button on their card in Sale Center or on their Customer Profile.

19.1 Automatic Messages

In the app update after version 1.0.8. The screens match the website's — the pictures in the Customer Follow-Up guide, section 12, show the same form.

☰ → Sales → Automatic Messages lists the texts that go out by themselves — a thank-you after each purchase, a note when a customer pays what they owe, or a message on a date you choose. They are the same messages as on the website: one set up on the phone is listed on the website, and the other way round.

• Each message has a switch. Turning it on shows what it would cost in SMS units and asks you to confirm; turning it off warns that anything waiting to go out is cancelled. The switch only moves once the server has agreed, so it never shows "on" for a message that isn't.
• + Add a message lets you pick a ready-made one (thank-you, first-time welcome, payment on account, a date message), then edit it: the name, when it goes, the wording (with buttons for the customer's name, your shop, the amount and the date), and a live preview with the cost.
• Advanced options hold the same settings as the website, including Skip if the sale reaches us more than N days late — a sale rung up offline reaches the server when the phone next syncs, and a thank-you weeks late is skipped (0 = never skip).
• Edit and Delete sit under each message.

After a sale in Quick Sell: while your shop has no purchase message, the app asks once "Thank your customers automatically?" before opening the sale. Turn on shows the cost and asks you to confirm; Not now hides the question for 30 days; pressing back just carries on to the sale. Quotations never ask.

Not in the app yet (website only): the dashboard card, the Msg button for one customer, the ready-made wording list, and the recent-activity list.

20. Wildfire on the phone

Wildfire (Sales group) — "Get more customers using your existing customers" — gathers the storefront actions:

Most of these open the same pages as the website inside the app, so they need an internet connection ("No Internet Connection" otherwise). The Merchant Storefront guide covers each in depth.

21. Reports

All seven reports work offline, from the phone's own records.

22. Offline, sync and your data

22.1 How it works

Every sale, payment, purchase and customer is written to the phone first, whether or not there's a network. When a connection is available the app pushes those records to the server, and fetches changes made elsewhere. The badge on Sale Center and Main Dashboard tells you where things stand:

22.2 The sync controls

22.3 When the phone and the website disagree

It's almost always a sync gap, not a fault. Tap the badge so the phone's records go up, then run Download so the website's come down. Only if a difference survives both is it worth raising with support.

23. This Sales Point

A sales point is a till. On the website you pick one at each sign-in; a phone is bound to one, which is why it can keep selling without a network — it already knows which till it is.

This Sales Point (Admin Management) shows the till's NAME, STATUS, and the dates it last synced up and down. Invoice numbers carry the sales point, so you can tell a phone sale from a web sale in the Sales List.

24. Users and admin

The same permission list governs the website, the phone and the desktop till — a right removed on the web is removed on the phone. See the Store Setup, Users & Security guide, section 12.

25. My Usage, Invite & Earn, Subscription

If a paid plan ends, the app offers Continue on the Free plan, Redeem usage units for days, or subscribing again. Everything about plans, units and invites is explained in the Usage, Billing & Help guide.

26. Settings, printing and updates

26.1 Edit Shop

Shop Name, Phone, Website, Address, State, Currency and Tax Rate (%) — as they appear on invoices. Needs an internet connection; you'll be asked to confirm. Changing the currency changes the label only, never the amounts.

26.2 Version

Shows the Installed Version. Check For New Version; if "There is a new Version of SmartShop", tap Download, then Done Updating. Have the version number ready when you contact support.

26.3 Printing receipts

1. Pair the Bluetooth or thermal printer in Android's own Settings → Bluetooth first.
2. Open an invoice → Print.
3. Choose the printer from the list and Print.

The app can only use a printer the phone already knows. If it's missing from the list, pair it again in Android settings.

27. Android vs web

In practice: sell on the phone, administer on the web. The phone is better at the counter, on a delivery round and in a market; the website is better for bulk data, suppliers, budgets, permissions, multi-store and anything involving a spreadsheet.

28. A day on the app

Kenneth runs a hardware shop with one phone at the counter.

1. Open: sign in; check the badge is green. If the owner changed prices on the website last night, run Download.
2. Serve: walk-ins through Quick Sell (2 hinge @450…); regulars on credit with the customer attached. Quotes for contractors saved with Save Quote.
3. Deliveries: Sale Center → Add Stock, entering the unit cost from the supplier's invoice.
4. Chasing: from Sale Center's quiet-customer strip, a WhatsApp to anyone overdue; a contractor pays part of his balance — Collect › on his invoice, receipt shared on the spot.
5. Close: Daily Sales Report → today → compare the Cash line with the drawer and each transfer line with the bank app. Tap the badge; wait for ✓ Synced.

29. Quick reference and troubleshooting

If something looks wrong

• The badge isn't green. The phone has records the server hasn't got. Get online and tap it.
• The phone shows different figures from the website. Sync, then Download. A gap that survives both is worth reporting.
• A sale isn't on the customer's account. It was saved to Cash — walk-in.
• Stock didn't drop. It was saved as a quotation — convert it with Invoice.
• "This sale/quote hasn't synced yet". Tap the badge, then open it again.
• "You don't have permission to open that screen". Ask the owner to tick that right on the website; it arrives at the next sync.
• Sign-in fails after a password reset. The first sign-in with a new password must be online.
• Auto-sync never seems to run. Check Auto-Sync Interval isn't Disabled, and allow the app to ignore battery optimisation.
• Names like "System Item 456" appear. Validate Data created them — rename them (section 22.2).
• The printer isn't listed. Pair it in Android's Bluetooth settings first.
• Profit looks too good. P&L → tap Cost of Sales → look for lines with an average cost of 0.
• Sharing a receipt asks you to top up. Your usage units have run out — see My Usage.