User guide
The app is your ledger of obligations: what you owe, to whom, when, and what has been paid. This guide walks with you from the first invoice to the Tools page, in the order you will do things on day one.
1 · Add your first invoice
The first way — by hand: tap “+ Invoice” on the invoices screen. Five fields are required: the entity (who you pay), the invoice number as the entity wrote it, the amount, the invoice date, and the due — a period in days or a date, either one. No invoice is saved without a due date. Attaching a document is optional.
Type the entity's name as it is; if it is new the app creates it and asks you to confirm the name — an extra space or a different letter creates a duplicate of an entity you already have. And if you enter an invoice whose entity and number already exist, the app tells you before saving.
The second way — from a code: at the top of the add screen are two buttons: “Scan an invoice code from a PDF or image” and “Scan an invoice code with the camera”. The code is one of two: the tax invoice code printed on the seller's invoice — the seller, amount, tax and date are read from it, and the invoice number and the due are left to you — or a code drawn by another AwanPro on a colleague's phone, which brings you the whole invoice field by field. Either way, saving is yours after review: the amount, the date and the entity name. If the name on the invoice differs from the one you have, choose your entity once — its VAT number is linked to it, and every invoice after that is saved under your name for it.
The third way — by sharing: got the invoice in WhatsApp or by email? Share it from there to AwanPro, and it opens the add screen filled in from its code.
However you add it, the invoice appears in the “Pending” tab, and what sits above it updates: the four cards (total · pending · partial · paid) and the coloured stripes: overdue, due today, within three days, and this week.
2 · Record a payment
Tap the invoice and its sheet opens. There is Record a payment with any amount, date, time and payment method, and Confirm payment, which fills in the whole remainder with today's date and time — change them if you paid on another day. “Change status” to paid does the same.
A partial payment moves the invoice to “partial” and keeps it in Pending until it is complete. Every payment has a voucher with a serial number within the year (PAY‑2026‑0007) that appears in the “Payments” tab with its date and method.
Paid more than the remainder? The extra is not lost: it is kept as a credit balance for the entity, deducted on its own from its next invoice — or you apply it to whichever invoice you like with “Apply credit”. And if you delete a payment, the whole operation is cancelled — all its vouchers — its effects on the invoices and the balance are reversed, and that is logged.
When you pay from your bank app: from the invoice sheet, copy the amount, the invoice number or the entity name with one tap — a raw number that pastes as it is.
3 · Entities and their accounts
An entity is whoever you pay: a landlord, a supplier, a telecom company. It is created on its own with the first invoice, or you add it with “+ Entity”. Every entity shows as a card summarising its invoices: how many, the total, how much was paid and how much remains, and the usual due period with it; you can search and sort them.
Open the entity and you find its card: general details, contact details, address, bank details, and any fields you add. Its statement: every invoice, payment and balance between you, with dates — a complete document to read from the top and send to it. And its balance history records everything that entered its balance and left it.
An advance payment is recorded from the “Payments” tab without an invoice: it applies to the entity's oldest pending invoice, and whatever is left stays as a credit deducted from the next. An entity cannot be deleted while it has an invoice, even archived, or a voucher, a balance, or a recurring template — the app tells you which — so you merge it into another entity instead, and everything moves over.
4 · Invoices that repeat
Rent and subscriptions are not typed in every month. From “Automatic invoices” you add a template: the entity, the amount, the repeat — monthly, quarterly, yearly, or every number of days you type — the start date it counts from, an end date if you want one, the due period, an advance notification a number of days before, and a prefix from which the invoice number is generated each time (ELEC‑2026‑10).
On the date the app generates the invoice itself and records it like any invoice you entered, and notifies you. Every generated invoice is written in the audit log as coming from the recurring invoices.
5 · Tasks and reminders
Anything that is not an invoice but has a date — renewing a commercial registration, a monthly stocktake, reviewing a contract — is written as a task: a title, details, a date, a time and a priority (high · medium · low). And a reminder that rings at its time: once, or every day, every week, every so many days, on weekdays you choose, or every month, quarter or year — and stops on its own when the task is done.
Every task has a checklist: items you tick off one by one, and a bar that shows how much is done. If you turn on “Close the task when its checklist is complete”, it closes itself on the last item and reopens if you untick one.
For the repeating ones there are automatic tasks: a template with its items, from a start date you choose, generates a copy on every date — and each copy stays independent with its own items.
6 · What goes out and what comes in
Out: from the ⋮ menu on the invoices screen, export what you see — after filtering between two dates if you like — to Excel or PDF, and send it from the share sheet to your accountant with any app.
In from a file: “Import data” reads an Excel file with the entity, the amount, the invoice date, the due, and any fields you like, shows it to you for review before saving — what blocks saving in red, what deserves a look in orange — and adds to what you have without erasing. No due date is assumed for an invoice that has none written. A database file — a backup from another phone, or from the web app — replaces everything in the app, and a copy of your data is saved first.
In from the camera: point it at a tax invoice code and the seller, amount, tax and date are read and the fields filled; saving is yours. And between two phones: “This invoice's code” draws it on your screen, and the other app reads it field by field and saves nothing until its owner approves. Likewise “This entity's card code” and “Import from a code” on the entities screen — if the card holds a lot of data it is shown as several codes, scanned one after another in any order. All of it offline, with no file sent.
7 · The archive and the audit log
An invoice whose business is done is moved to the archive from its sheet: it leaves the lists and the figures but is not deleted, and comes back with a tap. Permanent deletion is a separate door, with a confirmation.
The audit log writes everything that happened: an addition, an edit, a partial payment, a credit applied, an entity renamed or merged, a move to the archive, an import. So when a figure differs from what you remember, you know when it changed and why. It filters by operation type.
8 · Tools
Appearance is light, dark, or follows the device. Language is one of ten, or the device's — and your choice sticks however the phone's language changes.
Reminders: one combined notification morning and evening with what you owe — overdue, today, and this week — at two times you set, with a button that tries it right away instead of waiting for the morning. On the same page are the permissions the notification needs to arrive on time, and “Exemption from battery saving” for devices that stop idle apps.
Currency name — write it as you like (SAR, $, €) and choose where it shows: everywhere, only in reports and notifications, or nowhere. The default payment method comes pre-selected in every payment; change it for one payment if needed.
Saved backups: the app saves a copy on its own after every operation that touches money, before any restore or wipe, daily at a time you set, and instantly with a button — each named by its reason, kept in the device and in the “AwanPro” folder in Documents so it survives uninstalling the app, and you set how many to keep. From here you restore, and share any of them with any app. “A backup for the web app” writes a file the web app can read.
Wipe data — the financial data only, or all of it — is at the end of the page, runs only after you type the confirmation word, and a backup is saved first. And last, “About the app”: the version, the privacy policy, the terms and the website.
9 · Notifications
For notifications to reach you, open Tools ← Reminders: at the top are three permissions, each with its state: app notifications — without it no notification shows at all; exact timing — without it the notification arrives within a window, not at the exact time; exemption from battery saving — because some devices stop idle apps. Grant them there, then tap “Check reminders now” and a notification arrives immediately.
Then in the phone's settings: some devices — Huawei, Honor, Xiaomi and some Samsung — stop the app after it is closed even with the permissions granted; then the app tells you when the notification arrives late and opens its page in the settings for you: Battery ⟵ “Manage manually” and enable running in the background.
And if you have not opened the app for a while, the system narrows its share of notifications — the app tells you that too, and opening it now and then is enough. “Diagnostics” on the same page tells you whether the time is scheduled and when it last ran.
Odd questions
I added an invoice and don't know its due date yet?
No invoice is saved without a due date. Write the closest you know — thirty days, say — and change it when you know; the status and colour follow the new date.
What is the difference between “Record a payment” and “Confirm payment”?
Record a payment is for any amount — part of the remainder or more than it — while Confirm payment and Change status to paid fill in the whole remainder; in all three the date, time and method are yours.
I paid more than the invoice — where did the difference go?
It was kept as a credit balance for the entity. You see it on its card and in its statement, and it is deducted on its own from its next invoice — or you apply it to any of its invoices from the invoice sheet with “Apply credit”.
Why won't the app delete an entity?
Because it has an invoice, even archived, or a voucher, a balance, or a recurring template. The app tells you which. Delete those first, or merge the entity into another and everything moves over.
I changed my phone — how do I move my data?
The most complete way: from Tools ← Saved backups, share the latest backup to the new phone with any app — or take it from the “AwanPro” folder in Documents — then import it from the same backups screen and all your data returns. If you moved to the new phone with Android's transfer tool — by cable or Wi‑Fi — the app and its data moved with it. For invoices and entities alone: export to Excel and import it, or the invoice's or entity card's code with the camera if it is just one.
Does my data reach anyone?
No. No account and no server; everything is on your device. Codes are read from the screen offline, and files leave only when you share them yourself.
Does it work offline?
Entirely. Codes are read from the screen and the camera, files from your phone, and notifications come from the app itself.
Why have notifications stopped arriving?
Start with the permissions: open Tools ← Reminders and make sure all three are granted — app notifications, exact timing, and exemption from battery saving — then tap “Check reminders now”. If the notification arrives, the app is fine and the blocker is the phone: on Huawei, Xiaomi and their like, enable running in the background from the app's page in the settings. And if you haven't opened the app for a while, the system may have narrowed its share — open it now and then. Chapter 9 explains this.
Support
Didn't find your answer? Write to support@awanpro.app — and mention the app version (at the bottom of the Tools page) and your phone model.