Skip to content
Bodek Ledger

Recording and applying payments

A $15,000 bill with $2,000 against it is $13,000 outstanding — and both numbers are facts you can click into.

Updated · 2 min read

On this page

This is the thing Ledger is built around, so it is worth understanding properly.

Two separate acts

Recording money is saying "this moved". A cheque arrived; you paid a supplier. It is a fact about the world, and it is true whether or not you know yet what it was for.

Applying money is saying "and it was for this". It points some or all of a payment at an invoice or a bill.

They are separate on purpose. On a real job money arrives before anybody has worked out which of three outstanding invoices it covers, and a system that insists on knowing is a system people stop using.

The worked example

You raise a bill for $15,000. It shows as $15,000 outstanding.

Two weeks later you pay $2,000 of it. Record the payment, then apply it to the bill.

The bill now reads:

  • Total $15,000
  • Paid $2,000
  • Outstanding $13,000
  • Status Part paid

Every one of those figures is derived. Nothing was typed. Open the bill and the $2,000 is a row you can click, which takes you to the payment it came from.

Applying across several documents

One cheque often covers three invoices. Open the payment, choose Apply, and type an amount against each one — or press Fill oldest first and let Ledger spread it.

The panel shows what is left as you type, and will not let you apply more than the payment holds or more than a document still owes.

Un-applying

Press Un-apply on any applied amount. The money stays recorded — it just stops pointing at that document. Nothing is lost and the payment is free to use elsewhere.

Why the balances cannot drift

amount_paid and balance are recomputed from the applied amounts every single time anything changes. No code anywhere writes them directly. That means:

  • a part payment cannot leave a stale balance behind
  • voiding an invoice releases the payments that were against it
  • editing an invoice's total recalculates what is outstanding

And if you want to prove it rather than take our word for it: Settings → Check the books re-derives every balance in the project from its payments and tells you if anything disagreed. It should always find nothing.

Still stuck? Contact support and we'll get back to you as soon as possible.