Skip to main content

Tutorial overview

This tutorial walks through three real scenarios from start to finish. By the end you’ll understand how to use every part of the system.
Complete the one-time setup (accounts and category rules) before running through these scenarios. See Initial setup below.

Initial setup

Create your financial accounts

Go to Admin → Financial Management → Accounts and create these nine accounts:

Create your category rules

Go to Admin → Financial Management → Category Rules and create three rules:

Scenario 1: Central receives Sunday mobile money offerings

Situation: It’s Monday 15 January 2024. Members sent mobile money during Sunday’s service. You need to import the statement, match transactions to members, and calculate distributions.

1.1 Prepare the CSV file

Save this as central_mm_jan15.csv:

1.2 Import the statement

Go to Import Transactions and configure:
Upload the file and click Preview Import. You’ll see: Total: 7 transactions — 3,300,000 UGX Click Import Transactions.

1.3 Reconcile

Go to Financial Management → Reconciliation.
1

John Doe — 500,000 UGX (95% confidence)

System shows: Phone exact match · Kampala BranchAction: Click Approve.
2

Mary Ssempa — 300,000 UGX (92% confidence)

System shows: Phone exact match · Entebbe BranchAction: Click Approve.
3

Peter Kato — 750,000 UGX (two suggestions)

System shows Peter Kato at 88% (phone exact match) and Peter Kateregga at 65% (name similar, no phone match).Action: Click Approve on the first suggestion — Peter Kato.
4

Grace Nakato — 200,000 UGX (name match, different phone)

System finds Grace Nakato (78%) but her saved phone 0772555777 differs from this transaction’s 0772555666.Action: Click Edit.In the modal:
  • Contact: Grace Nakato ✓
  • Tick Add 0772555666 as new payment method → Provider: MTN
  • Location: Kampala Branch ✓
  • Category: Offering ✓
  • Click Save Match
Grace now has two saved phone numbers — future transactions from either will score 95%+.
5

David Mugisha — 1,000,000 UGX (94% confidence)

System shows: Phone exact match · Entebbe BranchAction: Click Approve.
6

Sarah Nambi — 400,000 UGX (91% confidence, Saturday)

Category shows Tithe (correct — she sent Saturday evening, not during service).Action: Click Approve.
7

Unknown Sender — 150,000 UGX (no match)

You call the number and find out it’s a visitor: James Okello.Action: Click Manual Match.In the modal:
  1. Type “James Okello” — not found
  2. Click + Create New Contact: James Okello
  3. Fill in the quick form:
  4. Click Create & Match
James is added to contacts, 0701777888 is saved as his payment method, and the transaction is matched.

1.3b Bulk approve (faster method)

Instead of approving transactions one by one:
  1. Tick the boxes next to John, Mary, Peter, David, and Sarah (all ≥90% confidence)
  2. Click Approve All High Confidence
  3. The system approves all 5 at once
  4. You only need to handle Grace (new phone) and the Unknown Sender individually
This saves significant time when processing a large week of transactions.

1.4 Calculate distributions

Go to Distributions → + New Distribution Batch:
Click Calculate Distributions. The system applies Central’s rules:

Offerings — 2,900,000 UGX

(John 500k + Mary 300k + Peter 750k + Grace 200k + David 1M + James 150k)

Tithe — 400,000 UGX

(Sarah — Kampala Branch) Total distributed: 3,300,000 UGX ✓ Click Submit for Approval.

1.5 Execute transfers (after approval)

Once leadership approves, go to the batch and mark each transfer as you complete it in your bank: Each line shows “Executed” with the date once saved.

1.6 View the report

Go to Financial Management → Reports, select Reconciliation Summary, and set the date range to Jan 15 – Jan 21, 2024. Match Rate: 100% ✓ By category: Offering — 6 transactions (2,900,000 UGX) · Tithe — 1 transaction (400,000 UGX) Click Export to Excel to download.

Scenario 2: Location receives cash and sends to Central

Situation: It’s Monday 22 January 2024. Kampala Branch collected cash during Sunday’s service and has one direct bank deposit. They need to reconcile and calculate their distribution.

2.1 Prepare the CSV

Save as kampala_branch_jan22.csv:

2.2 Import to the branch account

Preview shows all three rows. The two Sunday collections are auto-marked Offering; Timothy’s weekday deposit stays Tithe. Total: 1,350,000 UGX — Click Import Transactions.

2.3 Reconcile

Cash collections don’t match to individuals — they represent aggregated Sunday giving. For each cash collection row:
  • The system shows a Location field (auto-filled to Kampala Branch) and Category
  • Click Approve as Cash Collection
Timothy’s deposit matches by name from the narration (82% confidence, Kampala Branch):
  • Click Approve
All three transactions reconciled.

2.4 Calculate Kampala Branch distributions

The system applies location rules (same rule applies to both Tithe and Offering): Total: 1,350,000 UGX ✓ Submit for approval, then execute:
  1. Transfer 540,000 from Kampala Branch to Central Bank → mark as transferred
  2. Transfer 405,000 from Kampala Branch to Welfare → mark as transferred
  3. The 405,000 retention stays in the branch account — mark the retention line as complete

Scenario 3: January Arise & Build campaign

Situation: It’s Monday 29 January 2024. Members have been giving to the building fund throughout January. You need to process these special transactions.

3.1 Prepare the CSV

Save as arise_build_jan29.csv:

3.2 Import

Preview shows all four rows auto-categorized as Arise & Build — the keyword rule matched each narration (“Arise and Build”, “Building Fund”, “building”, “Project”). Total: 9,250,000 UGX — Click Import Transactions.

3.3 Reconcile

1

Joseph Mukasa — 2,000,000 UGX (94% confidence)

Phone exact match. Click Approve.
2

Company Donation Ltd — 5,000,000 UGX (no match)

This is an organization, not a person. Click Manual Match.In the modal:
  1. Search “Company Donation Ltd” — not found
  2. Click + Create New Contact
  3. Set contact type to Company
  4. Fill in:
  5. Click Create & Match
3

Rebecca Nakalema — 1,500,000 UGX

Phone exact match. Click Approve.
4

Samuel Okoth — 750,000 UGX

Phone exact match. Click Approve.

3.4 Calculate Arise & Build distributions

Central’s rules for Arise & Build: Total: 9,250,000 UGX ✓ Submit for approval and execute the two transfers.

3.5 What about regular donations?

The Arise & Build rules don’t apply to regular Donation transactions. If you have those in the same import, the distribution rules differ:

Quick reference

Distribution rules at a glance

Location split is proportional to how much members of each branch contributed.

Common CSV formats

The system recognizes all three formats — it searches for Date, Amount, and Name/Description columns automatically.

Pro tips

Typical weekly time investment

Total: ~55 minutes per week.

Auto-match accuracy grows over time

The system learns phone numbers with every approved match. Expect ~60% in week one, climbing to 95%+ after three months. To speed up this learning curve:
  • Always approve correct matches (don’t skip them)
  • Add the new payment method when editing a match with a different phone number
  • Keep contact records and locations up to date

Handling common edge cases

End-of-month checklist

  • All transactions reconciled (0 pending)
  • All disputed items resolved or documented
  • All distributions approved
  • All transfers executed and marked
  • Monthly summary report generated
  • Export to Excel for accounting records

Training new team members

Give new finance team members these staged practice exercises: By week 4, they’ll be comfortable with the full workflow.

Summary: what you’ve learned

Set up accounts — 9 accounts covering Central, branches, and all destination accounts Created category rules — auto-categorize by time, date, and keywords Imported transactions from CSV — mobile money, bank, and cash formats Reconciled using three methods:
  • Auto-match suggestions (up to 95% confidence)
  • Manual matching for new phones or unknown people
  • Bulk approve for speed on high-confidence batches
Calculated distributions:
  • Central: 10% tithe, 30% ops, 60% to locations (split by member branch)
  • Locations: 40% to Central, 30% welfare, 30% retain
  • Different rules for Donations and Arise & Build
Executed and tracked transfers with bank reference numbers Generated and exported reports

Next steps

  1. Set up your real accounts using the tables in the Initial Setup section above
  2. Import last week’s statements as a practice run
  3. Do a test reconciliation with your finance team watching
  4. Calculate a test distribution — don’t execute it yet
  5. Review the results with leadership before going live
  6. Start using it for real next Monday