跳到主要内容

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. 账本备注

2026年6月
最后一笔记录 2026年7月20日(4个月前)
各期间数据
期间净值收入开支净利润
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

财务状况2026年6月30日

净值

30,950.00 USD

-7,350.00 USD · -19.2%较上月

资产

31,290.00 USD

负债

-340.00 USD

资金流动2026年6月

资金流入

—

主要来源
此期间没有资金流动。

资金流出

7,350.00 USD

前 3 个月平均2,564.13 USD高 187%

主要支出

现金流

正在加载账户角色…

近期活动

7月20日

6月30日

6月15日

5月31日

5月22日

5月15日

5月6日

4月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.