Skip to main content

Freelancer Invoicing Example — beancount.io

A Beancount ledger for running a freelance practice: invoicing on accrual, chasing what is owed, sales tax you collect on someone else's behalf, expenses rebilled to clients, and quarterly estimated tax. Ledger notes

June 2026
Last entry Jul 20, 2026 (4 months ago)
Period data
PeriodNet WorthIncomeExpensesNet Profit
2026-01-3132,000.00 USD15,500.00 USD0.00 USD15,500.00 USD
2026-02-2841,200.00 USD9,200.00 USD0.00 USD9,200.00 USD
2026-03-3141,200.00 USD0.00 USD0.00 USD0.00 USD
2026-04-3040,700.00 USD4,792.40 USD5,292.40 USD-500.00 USD
2026-05-3138,300.00 USD0.00 USD2,400.00 USD-2,400.00 USD
2026-06-3030,950.00 USD0.00 USD7,350.00 USD-7,350.00 USD
2026-07-3130,950.00 USD0.00 USD0.00 USD0.00 USD

Financial positionJun 30, 2026

Net Worth

30,950.00 USD

-7,350.00 USD · -19.2%from previous month

Assets

31,290.00 USD

Liabilities

-340.00 USD

Money movementJune 2026

Money in

—

Top sources
No money movement for this period.

Money out

7,350.00 USD

3-month average2,564.13 USD187% above

Top spending

Cash Flow

Loading account roles…

Recent activity

Jul 20

Jun 30

Jun 15

May 31

May 22

May 15

May 6

Apr 30

README.md

Freelancer Invoicing Example — beancount.io

A Beancount ledger for running a freelance practice: invoicing on accrual, chasing what is owed, sales tax you collect on someone else's behalf, expenses rebilled to clients, and quarterly estimated tax.

The organising idea is that invoicing and getting paid are two different events. An invoice recognises the revenue and creates a receivable; the payment only settles it. Recording revenue when cash lands instead makes your income statement a description of your clients' payment habits rather than of your work.

Quick Start

bash
make install   # Install beancount + fava via uv
make check     # Verify the ledger has zero errors
make serve     # Open Fava at http://localhost:4739

File Guide

FileWhat it demonstrates
main.beanEntry point — options and include directives
accounts.beanPer-client receivables, the sales-tax liability, and the cost chart
transactions/invoicing.beanIssuing invoices with invoice: and due: metadata
transactions/payments.beanOn-time, partial, late, and never — including a bad-debt write-off
transactions/sales-tax.beanTax you collect is a liability, not revenue
transactions/rebilled-expenses.beanPassing project costs to a client, gross vs net
transactions/estimated-taxes.beanReserving cash (not an expense) vs paying it (an expense)

The one thing to copy

Put the invoice number on both the invoice and its payment:

beancount
2026-01-09 * "Northwind Traders" "January retainer"
  invoice: "2026-001"
  due: 2026-02-08
  Assets:Receivable:Northwind   6,000.00 USD
  Income:Consulting            -6,000.00 USD

A per-client receivable account plus due: turns "what is overdue, and by how long" into a balance report instead of a memory exercise.