Invoices and payments

Invoices are the bills you send customers; payments are the money they send back. This page covers the whole cycle: drafting an invoice, issuing it, sending it, getting paid by hand or online, part payments, refunds, credit and debit notes, proforma invoices, withholding tax, reminders, statements and reporting invoices to the tax authority (KRA eTIMS, FIRS, ETA). Accountants, clerks and owners use it daily. The screens are Finance → Invoices and Finance → Payments; the settings are under Settings → Preferences.

What you need before you start

You want to Permission needed
See invoices invoicing.view
Create and edit drafts, send by email, create credit and debit notes, convert proformas invoicing.manage
Issue invoices and send them to the tax authority invoicing.issue
See payments invoicing.payments.view
Record payments and refunds invoicing.payments.manage
Export invoicing.export

The built-in Accountant role has every .view permission and the payment permissions; the Member role can only view.

How an invoice moves through its life

Status Meaning What moves it on
Draft Being prepared. No number yet (the title says "Draft"); everything can be changed or deleted. Nothing is posted. Issue.
Issued Final. It has a number from the sequence (for example INV-2026-00042), is locked, counted as owed, posted to the ledger and taken out of stock. A payment (part or full), Cancel, or a credit note.
Partially paid Some money received; the rest is still due. More payments.
Paid Nothing is due. A refund of its payment reopens it.
Cancelled Withdrawn. Amount due becomes 0. Issued invoices are reversed in the ledger. Final.

An issued invoice whose due date has passed while money is still owed is overdue: its due date shows in red and the status badge turns red. Overdue is not a separate status; it is worked out every day.

Find your way around the invoice list

  1. In the menu, open Finance → Invoices.
Invoices list with New invoice, the Overdue and Draft tabs and a Pay link marked
Invoices list with New invoice, the Overdue and Draft tabs and a Pay link marked
Item What it does
New invoice (marker 1) Opens a new draft invoice.
Tabs: Unpaid (default), Overdue (marker 2), Draft (marker 3), Paid, Proforma, All Unpaid shows issued and partially paid; Overdue only those past their due date.
Pay link (marker 4) Opens the customer's online payment page for that invoice in a new tab. Copy its address to send by WhatsApp or SMS.
Export Downloads the list.
Filter Status, Kind (invoices, proforma invoices, debit notes, credit notes), Customer, and Branch when you have branches.

Columns: Number (credit notes say so underneath), Customer, Date, Due (red when overdue), Total, Due amount and Status.

In the Draft tab each row has an Issue button (marker 1) so you can issue several drafts without opening them.

Draft tab of the invoice list with the Issue row action marked
Draft tab of the invoice list with the Issue row action marked

Create an invoice

Most invoices come from somewhere else: a confirmed sales order (Quotations and orders), a subscription renewal (Subscriptions), a till sale or a rental. Use New invoice for anything else.

  1. Open Finance → Invoices and click New invoice.
  2. Pick the Customer (marker 1). Click + next to it to add a new customer without leaving the page.
  3. Leave Kind (marker 2) as Invoice, or choose Proforma invoice, Debit note or Credit note.
  4. If the customer withholds tax, choose the Withholding tax (marker 3).
  5. Set the Due date (marker 4), or leave it empty to have it worked out from the payment terms.
New invoice form with Customer, Kind, Withholding tax and Due date marked
New invoice form with Customer, Kind, Withholding tax and Due date marked
  1. Scroll to Lines. Pick a Product (marker 1): its description, price, unit and tax fill in. Set the Qty (marker 2) and check the Tax (marker 3). Click Add to lines (marker 4) for more lines.
Invoice lines with Product, Qty, Tax and Add to lines marked
Invoice lines with Product, Qty, Tax and Add to lines marked
  1. Add Notes to customer and Terms if needed, then click Create. The draft is saved and opens, with its totals.

Every field on the invoice

Field What to enter
Company (required) The company issuing the invoice. Sets the currency, taxes and number sequence.
Branch Shown when you have branches. Used for branch reports and filters.
Customer (required) Only customers of the chosen company are listed.
Kind (required) Invoice; Proforma invoice (a quote-like bill asking for payment before you deliver; not posted, no stock, its own PF- numbers); Debit note (an extra charge on top of an earlier invoice, DN- numbers); Credit note (money you give back or take off what is owed).
Withholding tax For customers who must withhold tax (government, large companies), for example Withholding VAT 2%. The customer keeps that share of the amount before tax and pays it to the revenue authority; the invoice is settled by the rest. Only for invoices and debit notes.
Date (required) Invoice date, today by default. It decides the year in the number.
Due date Empty: worked out from the customer's Payment terms (days), or Preferences → Invoicing → Default payment terms (days).
Customer reference Their LPO or order number. Stays editable after issuing.
Currency (required) From the company. Choose another for foreign customers; the exchange rate of the date is used for the ledger.
Line Product Optional; a line can be free text. + adds a missing product.
Line Lot Shown for products tracked by lot when Inventory is on. Leave Expiring first or pick a lot.
Line Description (required), Qty (required), Price (required), Disc. %, Tax As printed. Prices include tax when Preferences → Invoicing → Prices include tax is on.
Notes to customer, Terms Printed on the invoice. Notes default from Preferences → Invoices → Default notes on invoices.

The Totals section (on saved invoices) shows Subtotal, Tax, Total, Withheld by customer (when withholding applies) and Amount due.

Issue an invoice

A draft is not yet owed. Issuing makes it final.

  1. Open the draft. Its header shows PDF (marker 1) to preview, Issue (marker 2), Cancel and Delete (marker 3) to throw the draft away.
Draft invoice header with PDF, Issue and Delete marked
Draft invoice header with PDF, Issue and Delete marked
  1. Click Issue, then Confirm (marker 1).
Issue confirmation window with the Confirm button marked
Issue confirmation window with the Confirm button marked

What happens when you issue:

"An invoice needs at least one line before it can be issued" means the draft is empty.

Issued invoice with the lines locked and the Amount due marked
Issued invoice with the lines locked and the Amount due marked

On an issued invoice the Lines (marker 1) and other details are greyed out; only the Customer reference and the notes can still be changed. Amount due (marker 2) is what is still owed. To correct a mistake on an issued invoice, issue a credit note and a new invoice.

Work on an issued invoice

Issued invoice header with Send by email, Record payment, Pay link and Credit note marked
Issued invoice header with Send by email, Record payment, Pay link and Credit note marked
Action When it shows What it does
PDF Always Downloads the invoice PDF: your logo, the customer's and your tax numbers (the label comes from Preferences → Invoicing → Tax ID label on documents), bank details, a QR code that opens the pay page, and the tax authority's reference and QR code once registered.
Delivery note Goods left stock for this invoice Opens the delivery note to print.
Send by email (marker 1) Not a draft Emails the invoice with the PDF attached and a Pay button.
Send to tax authority / Tax authority: registered E-invoicing set up Registers the invoice; turns green once accepted.
Record payment (marker 2) Money still owed Records money received.
Pay link (marker 3) Money still owed Opens the online pay page in a new tab.
Convert to invoice Issued proforma not yet paid Creates a draft invoice with the same lines and closes the proforma.
Debit note Issued invoice or debit note Creates a draft debit note to charge more on this invoice.
Credit note (marker 4) Issued invoice or debit note Creates a draft credit note reversing every line.
Cancel Draft or issued with no payments Cancels it.
Delete Draft Deletes the draft.

Below the form are Notes, Planned and History tabs for internal notes, follow-up activities and the change log.

Send an invoice by email, WhatsApp or SMS

  1. Open the issued invoice and click Send by email.
  2. Check To (marker 1), add Cc addresses if needed, and edit the Subject (marker 2) and Message (marker 3). The default message gives the amount and the due date and says the customer can pay online with the button below.
  3. Click Submit. "Email queued to …" confirms it, and the invoice records when it was sent.
Send by email window with To, Subject and Message marked
Send by email window with To, Subject and Message marked

The email has the PDF attached and a Pay button to the pay page. It is sent from your workspace or your own mail server (Preferences → Email), and replies go to the reply-to address set there.

There is no separate WhatsApp button for invoices: click Pay link, copy the address from the new tab, and paste it into WhatsApp or an SMS. The customer can view, download and pay the invoice from that page.

Every issued invoice has a private pay page. Nobody can guess the address; it shows only that one invoice.

Customer pay page with the invoice summary, M-Pesa and bank transfer options, and Download PDF marked
Customer pay page with the invoice summary, M-Pesa and bank transfer options, and Download PDF marked

The customer sees the invoice summary, Download PDF (marker 1), and one box per payment method you have switched on:

When an online payment succeeds, the gateway tells NaliSuite, a payment is recorded and allocated to the invoice automatically, and the invoice becomes Paid or Partially paid. The pay page always asks for the full amount due.

Switch on online payment methods

  1. Open Settings → Preferences and click Online payments.
  2. Switch on each method you want and paste the keys from the provider. For M-Pesa: Accept M-Pesa (Kenya) (marker 1), M-Pesa environment (Sandbox while testing, then Production), Paybill or Till number (marker 2), Daraja consumer key, Daraja consumer secret, Lipa na M-Pesa passkey and an optional Account reference prefix. For Paystack, Accept cards and bank via Paystack (marker 3) with the public and secret keys; similar fields for Flutterwave and Stripe.
  3. Further down are sections for more gateways (Airtel Money, MTN Mobile Money, Orange Money, Wave, Pesapal, DPO Pay, PayPal, PayFast, Ozow, Peach Payments, Fawry, CinetPay). Each shows a Notification URL to paste into the provider's dashboard. Every provider, where it works and its fields are listed in Online payment providers.
  4. Click Save preferences.
Online payments preferences with Accept M-Pesa, Paybill or Till number and Accept cards and bank via Paystack marked
Online payments preferences with Accept M-Pesa, Paybill or Till number and Accept cards and bank via Paystack marked

Note: Test with the sandbox first. A wrong passkey or shortcode means customers never get the M-Pesa prompt.

Record a payment by hand

Use this for cash, cheques, bank transfers, M-Pesa sent to your till outside the pay page, or card payments on your own machine.

  1. Open the invoice and click Record payment.
  2. Check the Amount (marker 1). It starts at the full amount due; type less for a part payment. It cannot be more than the amount due.
  3. Set the Date the money arrived.
  4. Choose the Method (marker 2): Cash, Bank transfer, Mobile money, Card, Cheque or Other.
  5. Type the Reference (marker 3): the M-Pesa code, cheque number or bank reference. It helps bank reconciliation.
  6. Click Submit. "Payment RCP-2026-000123 recorded" confirms it.
Record payment window with Amount, Method and Reference marked
Record payment window with Amount, Method and Reference marked

What happens: the payment gets a receipt number, is allocated to the invoice, and the invoice's Amount due drops; the status becomes Partially paid or Paid. With Accounting on, the money is debited to the cash, mobile money or bank account (by method) and credited to Accounts receivable. Webhooks for "payment.recorded" are called. The payment appears in the customer portal under Payments.

Part payments

Record each instalment the same way. The invoice stays Partially paid with the remaining Amount due (marker 2) until the Total (marker 1) is covered, and the pay link asks only for what is left.

Totals of a partially paid invoice with Total and Amount due marked
Totals of a partially paid invoice with Total and Amount due marked

Credit notes, debit notes and cancelling

You want to Use
Withdraw an invoice that has no payments Cancel. Issued invoices are reversed in the ledger.
Correct or reverse an invoice that was paid or part-paid, give a discount after the fact, or take back returned goods Credit note.
Charge more on an existing invoice (late fee, item missed) Debit note.

To create a credit note:

  1. Open the issued invoice and click Credit note, then Confirm (marker 1).
Credit note confirmation window with the Confirm button marked
Credit note confirmation window with the Confirm button marked
  1. A draft credit note opens with every line of the invoice and the note "Credit note for invoice …". Remove or reduce lines to credit only part.
  2. Click Issue. It gets a CN- number, reduces what is owed on the original invoice, reverses the sale in the ledger and returns tracked goods to stock.

If the invoice was already paid in full, the credit becomes money you owe the customer; refund it from the payment (see below).

A debit note works the same way: Debit note creates a draft you edit (change the lines to the extra charge) and issue. It is owed like an invoice, can be paid online and appears on statements.

"An invoice with payments cannot be cancelled. Issue a credit note instead." means exactly that.

Use proforma invoices

A proforma invoice asks for payment before you deliver, for example a deposit or a document the customer needs to raise payment. It is not a tax invoice: it is not posted to the ledger, takes nothing from stock and is not sent to the tax authority.

  1. Create an invoice with Kind set to Proforma invoice and issue it. It gets a PF- number and appears in the Proforma tab.
  2. Send it and take payment as usual: Send by email, Pay link or Record payment.
  3. When you are ready to bill for real, click Convert to invoice (marker 1) and confirm. A draft invoice with the same lines opens and the proforma is closed. Issue the draft.
Issued proforma invoice with Convert to invoice marked
Issued proforma invoice with Convert to invoice marked

Withholding tax

When a customer such as a government body withholds part of the tax:

  1. On the invoice, choose the Withholding tax before issuing.
  2. The Withheld by customer amount appears under Totals, and Amount due is reduced by it. The customer pays only the rest.
  3. With Accounting on, the withheld amount is posted to Tax receivable, so you can claim it against your own tax with the withholding certificate the customer gives you.

See and refund payments

Finance → Payments lists every payment, whether recorded by hand or received online.

Payments list with the Method and Status columns and the View action marked
Payments list with the Method and Status columns and the View action marked

Columns: Number (the receipt number), Date, Customer, Amount, Method (marker 1), Gateway, Reference and Status (marker 2): completed, pending (an online payment waiting for confirmation), failed or refunded. Filter by Status and Method. Click View (marker 3) to open one.

The payment page shows the details (gateway, gateway reference, payer phone, who recorded it, or "Online") and Allocated to (marker 2): which invoices it paid and how much each.

Payment page with Refund and Allocated to marked
Payment page with Refund and Allocated to marked

To refund:

  1. Open the payment and click Refund (marker 1).
  2. Type the Amount (marker 1). It starts at what can still be refunded.
  3. For a gateway payment, Send the money back through … is on: the gateway returns the money to the customer. Switch it off when you gave the money back another way, such as cash; the refund is then only recorded.
  4. Type the Reason (marker 2) and click Refund.
Refund window with Amount and Reason marked
Refund window with Amount and Reason marked

The invoices the payment settled are reopened for the refunded amount (newest first, after any unallocated balance is used), the ledger reverses the receipt, and a Refunds section lists each refund. A gateway refund may show "processing" until the gateway confirms it.

Remind customers who have not paid

Reminders are sent by email every morning at 08:00 to customers with outstanding invoices that have a due date and were issued.

There are two ways to set them up:

A simple schedule. In Settings → Preferences → Subscriptions, set Payment reminder schedule, for example -3, 1, 7, 14: three days before the due date, then one, seven and fourteen days after. Each step is sent once. (The setting lives with Subscriptions, which runs the daily reminders.)

Escalating dunning levels. In Settings → Preferences → Invoices, under Dunning levels after the due date, click Add a level (marker 4) for each step and fill in:

Field What to enter
Days overdue (required, marker 1) When this level is sent, for example 3, 14, 30.
Also tell the finance team (marker 2) Also sends your team an "Overdue invoices" notification.
Subject For example "Reminder: {number} is overdue".
Message (marker 3) The text. Tags: {number}, {amount}, {due_date}, {days}, {company}, {name}.
Dunning levels with Days overdue, Also tell the finance team, Message and Add a level marked
Dunning levels with Days overdue, Also tell the finance team, Message and Add a level marked

When dunning levels exist, they replace the schedule after the due date (the reminders before the due date still follow the schedule). Each invoice records the highest level reached and is never sent the same level twice. Customers without an email address get no reminders. An overdue renewal invoice also marks its subscription Past due.

Send a customer statement

Open the customer under Sales → Contacts and click Statement. Choose the period, then download the PDF or switch on Email it to the customer. See Contacts and CRM.

Statement window on a contact
Statement window on a contact

Report invoices to the tax authority (eTIMS, FIRS, ETA)

Where the law requires electronic invoicing, NaliSuite sends each issued invoice to the tax authority and prints the authority's reference and QR code on the PDF.

  1. Open Settings → Preferences → Invoices and find E-invoicing (tax authority) (marker 4).
  2. Authority: leave Country default (Kenya uses KRA eTIMS, Nigeria FIRS, Egypt ETA) or choose one.
  3. Switch on Send every issued invoice automatically to send at the moment of issue.
  4. Fill in the credentials for your authority:
    • KRA eTIMS: eTIMS OSCU URL (sandbox address shown until you change it), KRA PIN (defaults to the company tax ID), Branch ID (usually 00), Device communication key.
    • FIRS: FIRS API URL, FIRS business ID, FIRS service ID, FIRS API key, FIRS API secret.
    • ETA: ETA API URL, ETA identity URL, Registration number (RIN), ETA client ID, ETA client secret, Activity code.
  5. Click Save preferences.
Invoices preferences with the draft invoice switch, credit limit rule, bank details and the e-invoicing section marked
Invoices preferences with the draft invoice switch, credit limit rule, bank details and the e-invoicing section marked

On an issued invoice, Send to tax authority sends it by hand (or again after a refusal). Once accepted, the button reads Tax authority: registered and turns green, and "Registered as …" shows the reference. If the authority refuses it, the reason stays on the invoice ("Last attempt: …") so you can correct and resend. Proforma invoices are never sent.

Invoice preferences

Settings → Preferences has three tabs that affect invoices. Values apply to the whole organisation; use the selector at the top (marker 1) to set a different value for one company.

Preferences page with the company selector marked
Preferences page with the company selector marked

Invoices tab (see the screenshot above under e-invoicing):

Setting What it does
Create a draft invoice when a sales order is confirmed (marker 1) Orders invoiced "When confirmed" get a draft invoice automatically.
Default due days after issue Due date for invoices without payment terms.
When a customer goes over their credit limit (marker 2) Do nothing, Warn, but allow the order or invoice (default), Block confirming orders and issuing invoices.
Bank details shown on invoices and the pay page (marker 3) Bank name, account name and number, branch, paybill.
E-invoicing (tax authority) (marker 4) See above.
Dunning levels after the due date See Remind customers who have not paid.
Default notes on invoices Printed on every new invoice.

Invoicing tab:

Invoicing preferences with Default payment terms, Prices include tax and Tax ID label marked
Invoicing preferences with Default payment terms, Prices include tax and Tax ID label marked
Setting What it does
Default payment terms (days) (marker 1, required) Used when a customer has no payment terms.
Prices include tax (marker 2) On: prices you type already include VAT, and tax is worked out from them. Off: tax is added on top. Applies to new quotations and invoices.
Tax ID label on documents (marker 3) The label printed before tax numbers, for example "PIN" in Kenya or "TIN".

Online payments tab: see Switch on online payment methods.

Common questions

I issued an invoice with a mistake. Can I edit it? No, issued invoices are locked so your books and the tax authority stay in step. Issue a Credit note for it and create a new invoice. If it has no payments and was not registered with the tax authority, you can Cancel it instead.

Why is the Record payment button missing? The invoice is a draft, already paid or cancelled, or you lack invoicing.payments.manage.

"Allocation to INV-… exceeds the amount due." You typed more than is owed. Record only the amount due; record extra money as a separate payment when you have another invoice to apply it to.

A customer paid by M-Pesa but the invoice is still unpaid. If they paid through the pay page, check Finance → Payments for a pending or failed payment. If they sent money to your paybill directly, record the payment by hand with the M-Pesa code as the reference.

Can the customer pay part of an invoice online? The pay page always asks for the full amount due. Record part payments by hand.

Do drafts appear in the customer portal or on statements? No. Only issued invoices are shown to customers and counted as owed.

How do I stop reminders for one customer? Remove their email address, or record the payment or a credit note so nothing is outstanding.