Was Beancount ist: doppelte Buchführung im Klartext

Dieser Leitfaden fasst Best Practices für die Textbuchhaltung mit dem leistungsstarken Open-Source-Tool Beancount zusammen. Er behandelt die grundlegende Philosophie, die grundlegende bis fortgeschrittene Syntax, praktische Fallstudien für komplexe Vermögenswerte und langfristige Strategien zur Hauptbuchverwaltung.

Teil 1: Das "Warum" - Grundlagen einer intelligenten Buchhaltung​

Bevor wir uns mit dem "Wie" befassen, ist es entscheidend, das "Warum" zu verstehen. Effektive Buchhaltung ist das Fundament der persönlichen Finanzverwaltung und ein notwendiger Schritt hin zu finanzieller Klarheit und Freiheit.

Über die Ausgabenverfolgung hinaus: Der Weg zu finanzieller Klarheit​

Einfache Ausgabenverfolgungs-Apps sagen Ihnen, wohin Ihr Geld geflossen ist. Ein robustes Buchhaltungssystem sagt Ihnen das und noch viel mehr: Es liefert ein vollständiges Bild Ihrer finanziellen Gesundheit, einschließlich Ihres Nettovermögens, Ihres Cashflows und der Performance Ihrer Investitionen. Das Hauptziel ist Beobachtbarkeit – ein klares, datenbasiertes Verständnis Ihres Finanzlebens zu gewinnen, das es Ihnen ermöglicht, fundierte Entscheidungen zu treffen, Risiken einzuschätzen und auf langfristige Ziele wie den Ruhestand hinzuarbeiten.

Warum doppelte Buchführung? Die Macht eines ausbalancierten Systems​

Im Gegensatz zur einfachen Buchführung (eine einfache Liste von Ausgaben) erfasst die doppelte Buchführung jede Transaktion als einen Wertefluss zwischen mindestens zwei Konten. Ihr Kernprinzip ist die grundlegende Bilanzgleichung:

$\text{Vermögen} = \text{Verbindlichkeiten} + \text{Eigenkapital (Nettovermögen)}$

Dieses System stellt sicher, dass Ihre Bücher immer ausgeglichen sind, was Fehler drastisch reduziert. Es liefert ein vollständiges Finanzbild, indem es wesentliche Berichte wie eine Bilanz (was Sie besitzen und schulden) und eine Gewinn- und Verlustrechnung (was Sie verdient und ausgegeben haben) erstellt.

Teil 2: Erste Schritte mit Beancount​

Beancount ist ein leistungsstarkes, auf Python basierendes Tool für die Textbuchhaltung.

Ihr erster Blick mit Fava auf Beancount.io​

Beancount.io bietet eine leistungsstarke Umgebung, die die Beancount-Engine mit einer mobilen App (iOS, Android) und einer Web-App kombiniert – Fava, eine fantastische webbasierte Oberfläche zur Visualisierung Ihres Hauptbuchs. Eine Installation ist nicht erforderlich. Wenn Sie die Plattform nutzen, interagieren Sie direkt mit einem Texteditor für Ihre Hauptbuchdatei (z.B. main.bean) und sehen die von Fava generierten Berichte in Echtzeit aktualisiert.

Fava wandelt den von Ihnen geschriebenen Klartext in interaktive Diagramme, Finanzberichte und filterbare Transaktionslisten um und gibt Ihnen so einen klaren Überblick über Ihre Finanzberichte.

Oder starten Sie im Terminal mit bea​

Wenn Sie lieber in einer Shell arbeiten möchten, ist bea die Beancount.io-Befehlszeile. Es ist kein Konto erforderlich: Installieren Sie es mit brew install bex-co/tap/bea oder uv tool install beancount-io, und es erstellt, validiert, fragt ab und berichtet über dieselbe Klartextdatei. Der CLI-Schnellstart bringt Ihnen in wenigen Minuten Ihr erstes Hauptbuch, und Ihr erster Monat mit bea schließt einen vollständigen Monat von Anfang bis Ende ab.

Die fünf Kernkontotypen​

Beancount verwendet fünf Kontotypen auf oberster Ebene, die die Struktur Ihres Hauptbuchs bilden:

Die Beancount-Gleichung​

Beancount setzt seine eigene Version der Bilanzgleichung durch, bei der die Summe aller Buchungen in Ihrem gesamten Hauptbuch Null ergibt:

$\text{Vermögen} + \text{Ausgaben} + \text{Verbindlichkeiten} + \text{Einkommen} + \text{Eigenkapital} = 0$

Aus diesem Grund enthalten Income-, Liabilities- und Equity-Konten konventionsgemäß negative Werte – sie sind die Quellen von Mitteln, die Ihre Assets und Expenses erhöhen.

Teil 3: Die Sprache von Beancount - Kern-Syntax​

Alle Einträge in Beancount sind Direktiven, die mit einem Datum beginnen.

Konten definieren (open) und Waren​

Bevor Sie ein Konto verwenden können, müssen Sie es mit der open-Direktive deklarieren. Sie können optional auch die Währungen oder "Waren" angeben, die es enthalten wird.

; YYYY-MM-DD open Account:Name [Commodity1, Commodity2, ...]
2020-01-01 open Assets:Bank:US:Chase:Checking      USD
2020-01-01 open Liabilities:CreditCard:US:Discover USD
2020-01-01 open Expenses:Food:Groceries
2020-01-01 open Income:Salary:Google

Waren können reale Währungen (z.B. USD, JPY) oder jede von Ihnen definierte benutzerdefinierte Einheit sein, wie Flugmeilen (MILES_UA) oder Aktienticker (HOOL).

Erste Transaktion aufzeichnen (*)​

Transaktionen sind der häufigste Eintrag. Sie beginnen mit einem Datum, einem Flag (* für eine abgeschlossene Transaktion oder ! für eine unvollständige), einem optionalen Zahlungsempfänger und einer Beschreibung. Jede folgende Zeile (mit zwei Leerzeichen eingerückt) ist eine "Buchung" auf ein Konto.

; YYYY-MM-DD * "Payee" "Description"
;   Account1      Amount Commodity
;   Account2     -Amount Commodity
 
2024-07-28 * "Trader Joe's" "Weekly groceries"
  Expenses:Food:Groceries     125.50 USD
  Liabilities:CreditCard:US:Discover  -125.50 USD

Der Einfachheit halber können Sie bei einer Transaktion mit nur zwei Buchungen den Betrag in der zweiten Zeile weglassen, und Beancount berechnet ihn automatisch.

2024-07-28 * "Trader Joe's" "Weekly groceries"
  Expenses:Food:Groceries     125.50 USD
  Liabilities:CreditCard:US:Discover

Transaktionsbezogene Balance: Wichtiger für den täglichen Gebrauch ist, dass jede einzelne Transaktion ebenfalls ausgeglichen sein muss – die Summe aller Buchungen innerhalb einer einzelnen Transaktion muss Null ergeben. Wenn eine Transaktion nicht ausgeglichen ist, zeigt Beancount einen Fehler wie diesen an:

Umgang mit Multi-Währungs-Transaktionen (@ und @@)​

Beancount zeichnet sich durch die Buchhaltung in mehreren Währungen aus.

• Verwenden Sie @, um einen Umrechnungspreis pro Einheit anzugeben.
• Verwenden Sie @@, um die Gesamtkosten der Umrechnung anzugeben.

; Buying a flight in EUR with a USD card
2024-08-01 * "Lufthansa" "Flight to Berlin"
  Expenses:Travel:Flights      500.00 EUR @@ 545.00 USD  ; 500 EUR cost me 545 USD in total
  Liabilities:CreditCard:US:Discover  -545.00 USD

Teil 4: Genauigkeit sicherstellen - Die Kunst des Abgleichs​

Eine wichtige Praxis zur Führung eines genauen Hauptbuchs ist der regelmäßige Abgleich. Dabei werden die Salden in Ihrem Beancount-Hauptbuch mit offiziellen Kontoauszügen Ihrer Finanzinstitute verglichen.

Automatisierung von Prüfungen mit Saldenbestätigungen (balance)​

Die balance-Direktive ist Ihr wichtigstes Werkzeug für automatisierte Prüfungen. Sie bestätigen, dass ein Konto an einem bestimmten Datum einen bestimmten Saldo hatte. Beancount meldet einen Fehler, wenn der berechnete Saldo nicht mit Ihrer Bestätigung übereinstimmt. Dies ist unschätzbar wertvoll, um Fehler schnell zu lokalisieren.

Hinweis: Die Saldenbestätigung prüft den Zustand des Kontos zu Beginn des angegebenen Tages (vor allen Transaktionen an diesem Tag).

; From your monthly credit card statement
2024-08-01 balance Liabilities:CreditCard:US:Discover  -1432.78 USD

Verknüpfen von Belegdokumenten (document)​

Sie können auf externe Dateien wie Kontoauszüge oder Belege verlinken und so eine prüfbare Spur erstellen. Fava macht diese Links anklickbar.

2024-08-01 document Liabilities:CreditCard:US:Discover "statements/discover-2024-07.pdf"

Fehler korrigieren und Salden initialisieren​

Wenn Sie Ihr Hauptbuch starten oder eine Unstimmigkeit finden, die Sie nicht zurückverfolgen können, müssen Sie eine Anpassung vornehmen. Die Standardpraxis ist die Verwendung eines speziellen Equity-Kontos.

; Initializing a cash account when starting your ledger
2020-01-01 * "Initial Balance" "Setting up cash account"
  Assets:Cash:Wallet           200.00 USD
  Equity:Opening-Balances     -200.00 USD

Das Konto Equity:Opening-Balances enthält Beträge, die aus unbekannten oder externen Quellen in Ihr Hauptbuch gelangen.

Für schnelle Korrekturen, bei denen die genaue Abweichung unwichtig ist, kann die pad-Direktive den Saldo eines Kontos automatisch an eine spätere balance-Bestätigung anpassen und die Differenz einem Eigenkapitalkonto zuordnen. Verwenden Sie dies mit Vorsicht, da es größere Probleme verbergen kann. Explizite Anpassungen sind im Allgemeinen sicherer.

Teil 5: Fortgeschrittene & realistische Transaktionsmuster​

Schulden verfolgen: Verwaltung von Forderungen und Verbindlichkeiten​

Die doppelte Buchführung ist perfekt geeignet, um Geld zu verfolgen, das Ihnen geschuldet wird (Assets:Receivables) oder das Sie schulden (Liabilities:Payable).

Beispiel: Sie bezahlen ein Gruppenessen über $90, und Ihr Freund Bob schuldet Ihnen seinen Anteil von $45.

1. Die ursprüngliche Ausgabe und die Forderung erfassen:

   2024-08-05 * "Dinner Place" "Dinner with Bob"
     Expenses:Food:Restaurant          45.00 USD  ; Your share
     Assets:Receivables:Bob            45.00 USD  ; Bob owes you
     Assets:Bank:US:Chase:Checking    -90.00 USD

2. Wenn Bob Ihnen das Geld zurückzahlt:

   2024-08-06 * "Bob" "Paid me back for dinner"
     Assets:Bank:US:Chase:Checking     45.00 USD
     Assets:Receivables:Bob           -45.00 USD

Das Konto Assets:Receivables:Bob ist nun Null und Ihre Bücher sind perfekt ausgeglichen.

Vermögenswerte vs. Ausgaben: Ein Autokauf und Abschreibung​

Ein großer Kauf wie ein Auto ist keine einfache Ausgabe; es ist der Erwerb eines Vermögenswerts, der im Laufe der Zeit an Wert verliert (Abschreibung).

1. Den Kauf als Vermögenswert erfassen:

   2023-01-15 * "Toyota Dealer" "Purchase of a new car"
     Assets:Car:ToyotaCamry         30000.00 USD
     Assets:Bank:US:Chase:Checking -30000.00 USD

2. Die jährliche Abschreibung erfassen: Angenommen, Sie schätzen, dass das Auto jedes Jahr $3.000 an Wert verliert. Am Ende des Jahres erfassen Sie dies als Ausgabe.

   2023-12-31 * "Depreciation" "Annual car value depreciation"
     Expenses:Depreciation:Car      3000.00 USD
     Assets:Car:ToyotaCamry        -3000.00 USD

Nach diesem Eintrag spiegelt Ihr Konto Assets:Car:ToyotaCamry korrekt den neuen Wert des Autos wider ($27.000), und Sie haben die Nutzungskosten für dieses Jahr ordnungsgemäß als Ausgabe verbucht.

Teil 6: Vertiefung - Modellierung komplexer realer Vermögenswerte​

Fallstudie 1: Buchhaltung für Immobilien​

Ein Eigenheim ist oft Ihr größter Vermögenswert und Ihre größte Verbindlichkeit. So modellieren Sie es.

1. Konten und eine benutzerdefinierte Ware erstellen:

   2022-01-01 commodity HOUSE_123MAIN
     name: "Property at 123 Main St"
   2022-01-01 open Assets:Property:Home:123Main        HOUSE_123MAIN
   2022-01-01 open Liabilities:Mortgage:HomeLoan       USD
   2022-01-01 open Expenses:Home:Interest
   2022-01-01 open Expenses:Home:PropertyTax

2. Den Kauf erfassen: Angenommen, Sie kaufen ein Haus für $500.000 mit einer Anzahlung von $100.000 und einem Darlehen von $400.000.

   2022-03-15 * "Settlement Company" "Purchase of 123 Main St"
     Assets:Property:Home:123Main          1 HOUSE_123MAIN {500000.00 USD}
     Assets:Bank:DownPayment          -100000.00 USD
     Liabilities:Mortgage:HomeLoan    -400000.00 USD

3. Monatliche Hypothekenzahlungen erfassen: Ihre monatliche Zahlung besteht aus einem Tilgungsanteil (reduziert die Verbindlichkeit) und einem Zinsanteil (eine Ausgabe).

   2022-04-01 * "Mortgage Bank" "Monthly Mortgage Payment"
     Liabilities:Mortgage:HomeLoan      800.00 USD   ; Principal
     Expenses:Home:Interest            1200.00 USD   ; Interest
     Assets:Bank:US:Chase:Checking    -2000.00 USD

4. Wertsteigerung verfolgen (nicht realisierte Gewinne): Der Marktwert eines Hauses ändert sich. Um dies zu verfolgen, ohne Ihr offizielles Nettovermögen zu beeinflussen (da der Gewinn erst beim Verkauf realisiert wird), können Sie eine Preis-Direktive mit einer "virtuellen" Währung verwenden.

   ; The purchase price is the real cost basis
   2022-03-15 price HOUSE_123MAIN   500000.00 USD
    
   ; An updated market estimate is an unrealized gain
   2024-01-01 price HOUSE_123MAIN   550000.00 USD.UNREALIZED

Dies ermöglicht es Ihnen, den geschätzten Wert in Favas Diagrammen zu sehen, ohne Ihre Bilanz unangemessen aufzublähen.

Entdecken Sie ein Live-Beispielhauptbuch für Immobilien mit Hypothekenverfolgung, Abschreibung und Immobilienverkauf:

Fallstudie 2: Verfolgung von Restricted Stock Units (RSUs)​

RSUs sind eine übliche Form der Aktienvergütung. Die Buchhaltung umfasst die Verfolgung der ursprünglichen Zuteilung, der Unverfallbarkeitsereignisse und des Steuerabzugs.

1. Ersteinrichtung: Erstellen Sie Waren für übertragene (HOOL) und nicht übertragene (HOOL.UNVEST) Aktien sowie für jedes Konto, das die späteren Einträge berühren. Alle im Voraus zu deklarieren, ermöglicht es, dass die beiden folgenden Transaktionen eigenständig geladen werden können.

   2021-01-01 commodity HOOL
   2021-01-01 commodity HOOL.UNVEST
   2021-01-01 open Assets:Brokerage:Etrade:HOOL          HOOL
   2021-01-01 open Assets:Grant:Unvested                 HOOL.UNVEST
   2021-01-01 open Income:Grant:Awards                   HOOL.UNVEST
   2021-01-01 open Expenses:Grant:Vested                 HOOL.UNVEST
   2021-01-01 open Income:Salary:Hooli:RSU               USD
   2021-01-01 open Expenses:Taxes:Federal                USD
   2021-01-01 open Expenses:Taxes:State                  USD

2. Die ursprüngliche Zuteilung erfassen: Diese Transaktion zeigt die gesamte Zuteilung, die auf ein nicht übertragenes Vermögenskonto fließt. Es ist noch nichts steuerpflichtig, daher ist der gesamte Eintrag in der Tracking-Ware HOOL.UNVEST denominiert.

   2021-02-01 * "Hooli" "Initial RSU Grant"
     Assets:Grant:Unvested        1000 HOOL.UNVEST
     Income:Grant:Awards         -1000 HOOL.UNVEST

3. Ein Unverfallbarkeitsereignis erfassen: Dies ist die wichtigste Transaktion. Wenn Aktien unverfallbar werden, erkennen Sie Einkommen, der Arbeitgeber behält Aktien zur Zahlung der Steuern ein, und Sie behalten den Rest. Angenommen, 100 Aktien werden zu je $150,00 unverfallbar, also:

   • Bruttovergütung: 100 × $150,00 = $15.000,00
   • Für Steuern einbehaltene Aktien: 40 × $150,00 = $6.000,00 (Bund $4.800,00 + Staat $1.200,00)
   • Aktien, die Sie behalten: 60 × $150,00 = $9.000,00 Anschaffungskosten
   • Bargeld an Sie: $0,00 – der gesamte Steuerabzug erfolgt in Aktien

   Diese Beträge bilden den Eintrag, und sie stimmen überein: $6.000,00 Steuern plus $9.000,00 einbehaltene Aktien ergeben exakt die $15.000,00 Einkommen.

   2022-02-01 * "Hooli" "RSU Vesting Event"
     ; Ordinary income: 100 shares * $150.00
     Income:Salary:Hooli:RSU                   -15000.00 USD
     ; Tax withheld, funded by 40 of the 100 shares (40 * $150.00 = $6,000.00)
     Expenses:Taxes:Federal                      4800.00 USD
     Expenses:Taxes:State                        1200.00 USD
     ; The 60 shares you keep, at their $150.00 vesting-day basis
     Assets:Brokerage:Etrade:HOOL                  60 HOOL {150.00 USD}
     ; Retire the 100 unvested units the grant was tracking
     Assets:Grant:Unvested                       -100 HOOL.UNVEST
     Expenses:Grant:Vested                        100 HOOL.UNVEST

Diese einzige, ausbalancierte Transaktion modelliert das gesamte Ereignis: Die nicht übertragene Zuteilung wird reduziert, Einkommen wird erkannt, Steuern werden einbehalten, und die 60 netto übertragenen Aktien erscheinen mit den korrekten Anschaffungskosten für zukünftige Kapitalgewinnberechnungen auf Ihrem Brokerage-Konto.

Zwei Details sind es wert, in Ihr eigenes Hauptbuch übernommen zu werden. Erstens: Schreiben Sie den Steuerabzug Konto für Konto auf, anstatt ihn von einem Sammelkonto absorbieren zu lassen – wenn die Bundes- und Staatsbuchungen nicht die Summe des Werts der einbehaltenen Aktien ergeben, wird die Transaktion nicht ausgeglichen sein, und Beancount wird es Ihnen mitteilen. Zweitens: Lassen Sie keine Leerzeile zwischen Buchungen: Eine Leerzeile beendet die Transaktion, und Beancount meldet einen Syntaxfehler für die Buchungen, die danach folgen.

Wenn Ihr Arbeitgeber die einbehaltenen Aktien auf dem freien Markt verkauft, anstatt sie zum Unverfallbarkeitspreis zurückzunehmen, ist der Verkauf eine separate Transaktion – eine Reduzierung von Assets:Brokerage:Etrade:HOOL gegen Bargeld – und jede Differenz zwischen Verkaufspreis und der Basis von $150,00 ist ein kleiner Kapitalgewinn oder -verlust. Halten Sie dies aus dem Unverfallbarkeitseintrag heraus.

Teil 7: Projektmanagement für Ihr Hauptbuch​

Wenn Ihr Hauptbuch wächst, wird die Organisation entscheidend.

Verwendung von Versionskontrolle (Git) zum Schutz Ihrer Daten​

Da Ihr Hauptbuch eine Textdatei ist, ist es perfekt für die Versionskontrolle mit Git geeignet. Dies gibt Ihnen eine vollständige Historie aller Änderungen und schützt Sie vor versehentlichem Löschen oder Fehlern. Warnung: Ihre Finanzdaten sind äußerst sensibel. Verwenden Sie ein privates Repository auf Diensten wie GitHub/GitLab oder hosten Sie Ihr eigenes.

Organisieren mit Tags (#) und Links (^)​

Beancount bietet zwei Möglichkeiten, Transaktionen über Konten hinaus zu gruppieren:

• Tags (#): Verwenden Sie sie für Ereignisse oder Projekte. Sie können beispielsweise alle Transaktionen filtern, die mit einer bestimmten Reise zusammenhängen. 2024-07-20 * "Hotel" "Wien" #reise-europa-2024
• Links (^): Verwenden Sie sie, um finanziell zusammenhängende Transaktionen zu verbinden, die zu unterschiedlichen Zeitpunkten stattfinden, wie eine Bargeldabhebung und die damit verbundene Bankgebühr.

Eine skalierbare Strategie zur Strukturierung Ihrer Dateien (include)​

Eine einzelne, riesige Datei ist schwer zu verwalten. Verwenden Sie die include-Direktive, um Ihr Hauptbuch in mehrere Dateien aufzuteilen. main.bean:

; Main ledger file
 
; Global options
option "title" "My Personal Ledger"
option "operating_currency" "USD"
 
; Include account declarations and other files
include "accounts.bean"
include "years/2023.bean"
include "years/2024.bean"
include "events/trip-europe-2024.bean"

Eine robuste Organisationsstrategie, in der Reihenfolge der Priorität:

1. Nach Ereignis: Erstellen Sie eine separate Datei für ein größeres, in sich abgeschlossenes Ereignis (z.B. reise-europa-2024.bean).
2. Nach Kategorie/Zahlungsempfänger: Für sehr regelmäßige, wiederkehrende Transaktionen wie Betriebskosten oder Gehalt gruppieren Sie diese in einer eigenen Datei (z.B. wiederkehrend-miete.bean).
3. Nach Konto: Für Transaktionen, die eng mit einem bestimmten Konto verbunden sind (Zinsen, Gebühren, Kreditkartenzahlungen), erwägen Sie eine kontospezifische Datei.
4. Nach Datum: Für alle anderen allgemeinen Transaktionen ist eine einfache Aufteilung nach Jahr (2024.bean) oder Monat (2024/07.bean) effektiv.

Teil 8: Fazit​

Beancount hat eine steile Lernkurve, belohnt die Mühe jedoch mit beispielloser Leistungsfähigkeit, Flexibilität und Kontrolle über Ihre Finanzdaten. Indem Sie die Prinzipien der doppelten Buchführung und die praktischen Werkzeuge von Beancount annehmen, können Sie von der einfachen Ausgabenverfolgung zu einem vollständigen, genauen und aufschlussreichen System der persönlichen Finanzverwaltung übergehen. Ihr Hauptbuch wird zu einem dauerhaften, privaten und unschätzbaren Vermögenswert, um Ihre Vergangenheit zu verstehen und Ihre Zukunft zu planen.

Erste Schritte mit Beancount.io​

Beancount.io ist eine moderne cloudbasierte Finanzverwaltungsplattform, die Ihre textbasierten Transaktionsaufzeichnungen in umfassende Finanzberichte umwandelt, einschließlich Gewinn- und Verlustrechnungen, Bilanzen und Probebilanzen. Durch die Kombination der Zuverlässigkeit von Klartextdateien mit leistungsstarken Visualisierungswerkzeugen hilft Ihnen Beancount.io, präzise Kontrolle über Ihr Finanzleben zu behalten und gleichzeitig wertvolle Einblicke in Ihre Investitionsperformance zu gewinnen.

Beginnen Sie Ihre finanzielle Reise mit Beancount.io – sehen Sie sich die aktuellen Pläne und Preise an, um zu erfahren, was jede Stufe beinhaltet.

Entdecken Sie das Live-Hauptbuch →

Entdecken Sie das Live-Hauptbuch →

Entdecken Sie das Live-Hauptbuch →