IB SolutionsGlobal

Chapter 6

Customers

6.1 Adding a customer#

  1. People → Customers → “+ Add Customer.”
  2. Fill in Full Name (required) and Phone Number (required).
  3. Customer Code is generated automatically if you leave it blank.
  4. Set a Credit Limit (leave at 0 for a cash-only customer) and, optionally, Email, TIN (for a business customer — see section 12.5), and Address.
  5. Click “Save Customer.”

6.2 The customer detail page#

Shows the customer's current balance and gives you: 📄 Statement, + Deposit, Credit Limit, + Opening Debt (section 6.3), ⇄ Contra (section 6.5), and Edit. Debts written off (section 6.4) and contras are listed further down the page.

Recording a deposit#

  1. Open the customer, click “+ Deposit.”
  2. Enter the Amount and choose which Deposit to Account it's going into (an active cash, mobile money, or bank account).
  3. Add optional Notes and, if needed, a back-dated Deposit Date.
  4. Check the live “New Balance After Deposit” preview, then click “✓ Confirm Deposit.”

A deposit first pays what the customer owes: their unpaid credit sales and opening debts (section 6.3), oldest first. What's left stays on deposit for later purchases. Editing or deleting a deposit undoes the payments it made.

Adjusting a credit limit#

  1. Open the customer, click “Credit Limit.”
  2. Enter a New Credit Limit (quick preset buttons: 0 / 500 / 1,000 / 2,000 / 5,000 / 10,000) and an optional Reason.
  3. Click “Update Credit Limit.”

6.3 Opening debts#

Money a customer already owed you when you started using IBS is an opening debt. Enter it with the date it has been owed since, and the customer's balance, statement, credit limit, and the Receivables ageing report are right from day one. An opening debt isn't a sale: no stock moves, and it isn't counted as revenue, profit, or tax.

Adding an opening debt#

  1. Open the customer and click “+ Opening Debt.”
  2. Enter the Amount owed and the Owed since date: the date of the old invoice, or when the debt started.
  3. Add an optional Reference (such as the old invoice number) and Notes, and click “Add Opening Debt.”

Importing opening debts#

  1. People → Customers → “📋 Import Opening Debts.”
  2. Click “Download Template” and fill in one row per amount owed: customer (their phone or customer code, or exact name if only one customer has it), amount, and owing_since (YYYY-MM-DD), with optional reference and notes.
  3. Upload the CSV, click “Preview Import →,” check the rows, and confirm.

The customers must already exist, so import them first (section 20.1). Importing the same file twice adds the debts twice.

Paying it off#

  • The customer's page lists each opening debt under Opening Debts, with what's owed, paid, and due. Click “Record Payment” to take a payment by cash, mobile money, bank, or from the customer's unspent deposit.
  • A deposit pays the customer's oldest debts first, opening debts and unpaid credit sales together (section 6.2). If the customer already has an unspent deposit when you add an opening debt, it pays the debt straight away.

Where it shows#

  • The customer's balance and statement, as an “Opening debt” line. It counts toward their credit limit.
  • Receivables (section 19.2), aged from the owed-since date, and the Dashboard's receivables and overdue counts.
  • Customer Transactions (Chapter 16), with the type Opening debt.

After go-live#

Once the business has gone live, a new debt should be a credit sale, so that stock, revenue, and tax are recorded. Set the day you started recording sales in IBS under Administration → Settings → General → Go-live date. While it's blank, nothing changes.

Once it's set, an opening debt must be owed since before the go-live date, in the form and in the import. From the go-live date on, only roles with the Record Opening Debts After Go-Live permission (opening_debts.record; Admin by default) see “+ Opening Debt,” Delete, and “📋 Import Opening Debts.” Recording payments against opening debts is never locked. A go-live date in the future locks nothing until that day.

Correcting a mistake#

An opening debt entered by mistake can be deleted from the customer's page while nothing has been paid or written off on it (after go-live, only with the permission above).

6.4 Writing off a debt#

When a customer will never pay what they owe, or you agree to take less, write off what won't be paid. It isn't a refund or a void: the goods were sold, so the sale and its revenue stand. No money moves, and it isn't an expense. The debt and the customer's balance owe less, and the Profit & Loss shows it as Debts written off.

Writing it off#

  1. Click “Write Off” on the sale's page, next to an opening debt on the customer's page, or next to the debt in Reports → Receivables.
  2. Enter the Amount to write off: all that's still owed, or the part they won't pay.
  3. Choose why: Bad debt (they won't pay) or Settled for less (you agreed to take less).
  4. Write a short Explanation, such as “customer closed the business in March,” and check the Date: the Profit & Loss counts it on that day.
  5. Click “Write Off” and confirm.

Where it shows#

  • The sale's page shows the amount written off in its summary, with the reason and who did it. A sale written off in full shows as Written off in the sales list.
  • The customer's balance and statement, as a “Written off” line. Their page lists every write-off.
  • Receivables no longer counts what was written off.
  • The Profit & Loss and its export: Debts written off, under Operating Expenses.
  • Reports → 🧾 Debts Written Off (needs Manage Customers): every write-off in the period, by customer and by reason, and write-offs reversed in it.
  • The Audit Log.

If they pay after all#

On the sale's or the customer's page, type why in the box next to the write-off and click “Reverse.” The debt is owed again, and an unspent deposit the customer holds pays it straight away; otherwise record the payment as usual. On the Profit & Loss the reversal comes off the period it was made in, so earlier months don't change.

While part of a sale is written off#

A sale with part of it written off can't be edited or voided, because both rebuild what the sale owes and would undo the write-off. Reverse the write-off first. Likewise, an opening debt with a write-off can't be deleted.

6.5 Contra: a customer who is also a supplier#

When a business you sell to also sells to you, you can agree to cancel what it owes you against what you owe it, and pay or collect only the difference. A contra records this in one step. No money moves and profit doesn't change; only the two balances go down. Agree it in writing with the other business first.

Recording a contra#

  1. Click “⇄ Contra” on the customer's page (when they owe you) or on the supplier's page (when you owe them).
  2. Choose the Customer and the Supplier. Each list shows how much is owed.
  3. Enter the Amount: at most the smaller of the two debts.
  4. Enter the Agreement reference (required), such as the date of the signed letter, the Date, and optional Notes, and click “Record Contra.”

For example, you owe Kofi Ltd 10,000 for cement and Kofi Ltd owes you 4,000 for goods it bought from you. A 4,000 contra clears what Kofi Ltd owes you and leaves 6,000 for you to pay them.

What it does#

  • On the customer's side, it pays their oldest debts first, the way a deposit does (section 6.2). Their statement shows a “Contra” line.
  • On the supplier's side, it's a payment on their account, counted against their oldest purchases and opening debts first (section 7.3). Their history shows it as a payment by Contra.
  • Both pages list the contra. No financial account changes, and no report counts it as revenue, cost, or an expense.

Reversing a contra#

Type why in the box next to the contra and click “Reverse.” Both debts are owed again, both ledger lines are removed, and the contra stays on both pages, marked as reversed.