Zum Hauptinhalt springen

Funktionierende Ledger-Beispiele

Kopiere sechs Live-, validierte Beancount-Ledger-Muster: Haushaltsfinanzen, Umschlag-Budgets, Freelancer-Rechnungsstellung, Mietobjekt, Krypto und Aktienkostenbasis.

Kopieren Sie eine bewährte Kontostruktur aus einem dieser sechs live Beancount-Hauptbücher und benennen Sie dann die Konten um und ersetzen Sie die fiktiven Beträge durch Ihre eigenen. Jedes eingebettete Hauptbuch ist öffentlich, in Git versioniert und mit bea check validiert. Um eine Börsenmeldung eines börsennotierten Unternehmens auf dieselbe Weise nachzubilden, siehe Ein börsennotiertes Unternehmen in Beancount modellieren.

Mit einer heruntergeladenen Datei beginnen​

Überspringen Sie Copy-Paste: Die Muster Haushalt, Umschläge und Freelancer werden jeweils als lauffähiges Starter-Hauptbuch mit fiktiven Beispieldaten geliefert.

  1. Wählen Sie eines der folgenden Muster: Haushalt für Bargeld und Karten, Umschläge für Budgetziele, Freelancer für Rechnungen.
  2. Laden Sie die Datei über den Link neben diesem Muster herunter.
  3. Validieren Sie die gespeicherte Datei mit bea --file <file> check. Ein sauberes Hauptbuch beendet bea check mit Exit-Code 0; Fehler werden mit einem Exit-Code ungleich null aufgelistet.
  4. Öffnen Sie es mit fava und verwenden Sie die angezeigte Adresse in Ihrem Browser.

Alltägliche persönliche Finanzen​

Verwenden Sie ein Bestandskonto pro Bank, eine Verbindlichkeit pro Kreditkarte und Aufwandskonten für die Fragen, die Ihre Berichte beantworten sollen. Das vollständige Beispiel zeigt außerdem Gehaltsabrechnung, Sozialleistungen, Überweisungen, Saldenbestätigungen und Anlagebestände.

Alltägliches Hauptbuch für persönliche Finanzen in neuem Tab öffnen

Kopieren Sie diese Struktur, wenn Sie einen Satz Bücher für Bargeld, Karten, Einkommen und gewöhnliche Ausgaben wünschen:

option "operating_currency" "USD"
 
2026-01-01 open Assets:Bank:Checking USD
2026-01-01 open Liabilities:CreditCard USD
2026-01-01 open Equity:Opening-Balances USD
2026-01-01 open Expenses:Food:Groceries USD
 
2026-01-01 * "Opening balance"
  Assets:Bank:Checking          3,000.00 USD
  Equity:Opening-Balances      -3,000.00 USD
 
2026-01-18 * "Corner Market" "Weekly groceries"
  Liabilities:CreditCard          -71.90 USD
  Expenses:Food:Groceries          71.90 USD
 
2026-01-25 * "Credit card" "Statement payment"
  Liabilities:CreditCard           71.90 USD
  Assets:Bank:Checking            -71.90 USD

Das Kreditkartenkonto trennt das Kaufdatum vom Datum der Barzahlung. Fügen Sie jedem realen Konto eine monatliche balance-Bestätigung hinzu, damit ein Importfehler nicht unbemerkt bleibt.

Laden Sie dieses Muster als household-starter.bean herunter, führen Sie dann bea --file household-starter.bean check und fava household-starter.bean aus. Die Datei entspricht dem obigen Codeblock: Checking endet bei 2928,10 USD, Lebensmittel bei 71,90 USD und die Karte bei null. Ersetzen Sie Corner Market, die 3.000,00 Eröffnung und die 71,90 Beträge durch Ihre eigene Bank, Karte und Ausgaben.

Umschlag-Budgetierung mit Übertrag​

Modellieren Sie jeden Umschlag als Eigenkapital-Unterkonto, das über dem realen Bankkonto liegt. Die Zuweisung eines Gehaltsschecks verschiebt Wert innerhalb des Eigenkapitals, während ein Einkauf sowohl die Geldbewegung als auch die Budgetentscheidung erfasst.

Hauptbuch für Umschlagbudgetierung in neuem Tab öffnen

Kopieren Sie den Equity:Budget-Baum und halten Sie den Plan vom Geld getrennt:

option "operating_currency" "USD"
 
2026-01-01 open Assets:Bank:Checking USD
2026-01-01 open Income:Salary USD
2026-01-01 open Expenses:Groceries USD
2026-01-01 open Equity:Budget:Unallocated USD
2026-01-01 open Equity:Budget:Groceries USD
 
2026-01-05 * "Acme Corp" "January salary"
  Assets:Bank:Checking          4,100.00 USD
  Income:Salary                -4,100.00 USD
 
2026-01-05 * "Budget" "Fund groceries"
  Equity:Budget:Unallocated      -550.00 USD
  Equity:Budget:Groceries         550.00 USD
 
2026-01-08 * "Whole Foods" "Weekly shop"
  Assets:Bank:Checking           -128.44 USD
  Expenses:Groceries              128.44 USD
  Equity:Budget:Groceries        -128.44 USD
  Equity:Budget:Unallocated       128.44 USD

Die beiden Paare im Einkauf gleichen sich unabhängig aus. Diese Trennung ermöglicht es Ihnen, einen Umschlag zurückzusetzen oder neu zuzuweisen, ohne den abgestimmten Banksaldo zu ändern. Für Favas Ziel-versus-Ist-Anzeige verwenden Sie stattdessen die einfacheren Budget-Direktiven.

Laden Sie dieses Muster als envelope-budgeting-starter.bean herunter, führen Sie dann bea --file envelope-budgeting-starter.bean check und fava envelope-budgeting-starter.bean aus. Die Datei entspricht dem obigen Codeblock: Checking endet bei 3971,56 USD, und der Lebensmittel-Umschlag enthält 421,56 USD gegen -421,56 USD Nicht zugewiesen. Ersetzen Sie Acme Corp, das 4.100,00 Gehalt und die 550,00 Zuweisung durch Ihr eigenes Gehalt und Ihre Umschläge.

Freelancer-Rechnungsstellung und Forderungen​

Erfassen Sie eine Rechnung, wenn Sie den Umsatz verdienen, und gleichen Sie dann die Forderung aus, wenn der Kunde zahlt. Ein separates Forderungskonto pro Kunde macht unbezahlte und teilweise bezahlte Rechnungen als gewöhnliche Salden sichtbar.

Freelancer-Rechnungshauptbuch in neuem Tab öffnen

Kopieren Sie den Forderungsbaum und setzen Sie die Rechnungsnummer auf beide Ereignisse:

option "operating_currency" "USD"
 
2026-01-01 open Assets:Bank:Business USD
2026-01-01 open Assets:Receivable:Northwind USD
2026-01-01 open Income:Consulting USD
 
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
 
2026-02-05 * "Northwind Traders" "Payment — invoice 2026-001"
  invoice: "2026-001"
  Assets:Bank:Business           6,000.00 USD
  Assets:Receivable:Northwind   -6,000.00 USD

Fügen Sie Umsatzsteuer einer Verbindlichkeit hinzu, nicht dem Einkommen, und verschieben Sie geschätzte Steuerbargeld in ein Reservekonto, bevor Sie sie zahlen. Das Live-Hauptbuch zeigt beide Muster, Teilzahlungen, weiterberechnete Kosten und eine Forderungsabschreibung.

Laden Sie dieses Muster als freelance-starter.bean herunter, führen Sie dann bea --file freelance-starter.bean check und fava freelance-starter.bean aus. Die Datei entspricht dem obigen Codeblock: Business endet bei 6000,00 USD, Consulting bei -6000,00 USD und die Forderung bei null. Ersetzen Sie Northwind Traders, Rechnung 2026-001 und die 6.000,00 Beträge durch Ihre eigenen Kunden und Rechnungen.

Mietobjekt und Hypotheken-Tilgungsanteil​

Behandeln Sie die Immobilie als Vermögenswert, die Hypothek als Verbindlichkeit und die Kaution eines Mieters als Geld, das Sie zurückzahlen müssen. Teilen Sie jede Hypothekenzahlung in Zinsen, Kapital und Treuhand auf, damit Bilanz und Gewinn- und Verlustrechnung unterschiedliche Wahrheiten erzählen.

Hauptbuch für Mietimmobilien in neuem Tab öffnen

Kopieren Sie die Gruppen Immobilie, Schulden und Betriebskonto, bevor Sie monatliche Aktivitäten hinzufügen:

option "operating_currency" "USD"
 
1970-01-01 commodity PROP123MAIN
2024-01-01 open Assets:RealEstate:Property PROP123MAIN
2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Assets:Bank:EscrowImpound USD
2024-01-01 open Liabilities:Mortgage USD
2024-01-01 open Income:RealEstate:Rent USD
2024-01-01 open Expenses:RealEstate:MortgageInterest USD
 
2024-03-15 * "Escrow" "Buy rental property"
  Assets:RealEstate:Property       1 PROP123MAIN {400,000.00 USD}
  Assets:Bank:Checking                       -80,000.00 USD
  Liabilities:Mortgage                      -320,000.00 USD
 
2024-04-01 * "Bank" "Mortgage payment"
  Expenses:RealEstate:MortgageInterest         1,866.67 USD
  Liabilities:Mortgage                           262.39 USD
  Assets:Bank:EscrowImpound                      566.67 USD
  Assets:Bank:Checking                        -2,695.73 USD

Halten Sie Land, abschreibungsfähigen Gebäudewert, Kapitalverbesserungen, kumulierte Abschreibungen und Treuhandaktivitäten getrennt. Der Leitfaden für Mietimmobilien erklärt, wie diese Salden in Berichte einfließen.

Krypto-Lots und Kostenbasis​

Geben Sie jedem Kauf Kosten in geschweiften Klammern und identifizieren Sie dasselbe Lot, wenn Sie verkaufen. Beancount führt dann Anschaffungsdatum und Basis durch Wallets, Börsen und steuerpflichtige Veräußerungen, anstatt eine Investition auf einen einzigen gemischten Saldo zu reduzieren.

Hauptbuch für Krypto-Kostenbasis in neuem Tab öffnen

Kopieren Sie das Rohstoffkonto, die Börsenkonten und die explizite Buchung des realisierten Gewinns:

option "operating_currency" "USD"
 
1970-01-01 commodity BTC
2024-01-01 open Assets:Crypto:Coinbase:BTC BTC
2024-01-01 open Assets:Crypto:Coinbase:USD USD
2024-01-01 open Expenses:Crypto:Fees:Trading USD
2024-01-01 open Income:Crypto:CapitalGains:ShortTerm USD
 
2024-02-15 * "Coinbase" "Buy 0.10 BTC"
  Assets:Crypto:Coinbase:BTC     0.10 BTC {43,800.00 USD, 2024-02-15}
  Assets:Crypto:Coinbase:USD   -4,380.00 USD
 
2024-08-20 * "Coinbase" "Sell the February lot"
  Assets:Crypto:Coinbase:BTC    -0.10 BTC {43,800.00 USD, 2024-02-15}
  Assets:Crypto:Coinbase:USD    5,900.00 USD
  Expenses:Crypto:Fees:Trading      8.85 USD
  Assets:Crypto:Coinbase:USD       -8.85 USD
  Income:Crypto:CapitalGains:ShortTerm -1,520.00 USD

Übertragungen zwischen Ihren eigenen Wallets bewahren das Lot, anstatt Einkommen zu erzeugen. Das Live-Hauptbuch setzt sich durch Staking, Mining, dezentrale Finanz und NFTs fort; der Bestandsleitfaden erklärt Buchungsmethoden und Lot-Reduzierung.

Das Krypto-Beispiel verwendet statische datierte Preise, damit Sie seine Berichte reproduzieren können. Für Ihre eigenen unterstützten Bestände in einem gehosteten Hauptbuch richten Sie Live-Preise ein, um Bewertungsnotierungen automatisch zu pflegen. Übereinstimmende Symbole und Notierungswährungen sind wichtig; Feeds verändern diese Transaktionsbeispiele nicht.

Aktien-Lots, Dividenden und Splits​

Eine Aktie ist keine Zahl, sie ist ein Lot: eine Menge, die zu bekannten Kosten an einem bekannten Datum erworben wurde. Schreiben Sie jeden Broker-Kauf mit einem expliziten {cost, date} und ein späterer Verkauf kann das genaue Lot benennen, das er veräußert, sodass Beancount den realisierten Gewinn und seine Haltedauer berechnet, anstatt zwei Lots zu mitteln. Eine Dividende bleibt als Einkommen sichtbar, anstatt in einem angepassten Aktienkurs zu verschwinden.

Hauptbuch für Aktienkostenbasis und Dividenden in neuem Tab öffnen

Kopieren Sie das Broker-Diagramm, das datierte Lot und den Verkauf eines spezifischen Lots:

option "operating_currency" "USD"
option "booking_method" "STRICT"
 
1970-01-01 commodity ACME
2024-01-01 open Assets:Brokerage:Cash USD
2024-01-01 open Assets:Brokerage:ACME ACME
2024-01-01 open Equity:Opening USD
2024-01-01 open Income:Dividends:Qualified USD
2024-01-01 open Income:CapitalGains:LongTerm USD
2024-01-01 open Expenses:Brokerage:Commissions USD
 
2024-01-08 * "Broker" "Wire funding to taxable brokerage account"
  Assets:Brokerage:Cash                  50,000.00 USD
  Equity:Opening                        -50,000.00 USD
 
2024-06-18 * "Broker" "Buy 150 ACME @ $68.20"
  Assets:Brokerage:ACME                        150 ACME {68.20 USD, 2024-06-18}
  Expenses:Brokerage:Commissions              4.95 USD
  Assets:Brokerage:Cash                 -10,234.95 USD
 
2025-03-14 * "Broker" "ACME quarterly cash dividend"
  Assets:Brokerage:Cash                      63.00 USD
  Income:Dividends:Qualified                -63.00 USD
 
2026-02-20 * "Broker" "Sell 60 ACME from the 2024 lot — long-term gain"
  Assets:Brokerage:ACME                        -60 ACME {68.20 USD, 2024-06-18}
  Assets:Brokerage:Cash                   5,778.00 USD
  Expenses:Brokerage:Commissions              4.95 USD
  Assets:Brokerage:Cash                      -4.95 USD
  Income:CapitalGains:LongTerm           -1,686.00 USD
 
2026-02-21 balance Assets:Brokerage:ACME              90 ACME
2026-02-21 balance Assets:Brokerage:Cash      45,601.10 USD

Die Gewinnbuchung ist die Arithmetik, kein Ausgleichsposten: 60 Aktien zu je 96,30 USD verkauft sind 5.778,00 USD Erlös gegen 4.092,00 USD Basis, und das Datum 2024-06-18 des Lots ist das, was es langfristig macht. Das Live-Hauptbuch setzt sich durch eine reinvestierte ETF-Ausschüttung, einen 4-für-1-Split, der die Gesamtbasis bewahrt, einen kurzfristigen Verkauf aus einem zweiten Lot und Aktienanzahlbestätigungen zum Jahresende fort. option "booking_method" "STRICT" ist das, was „40 ACME verkaufen" in einen Fehler statt in einen stillen Durchschnitt verwandelt; der Optionsleitfaden behandelt die Alternativen.

Das Aktien-Beispiel verwendet fiktive Symbole wie ACME und statische Preisdateien. Ersetzen Sie keinen realen Ticker-Feed für einen fiktiven Rohstoff. Wählen Sie unterstützte Paare für Ihre eigenen Bestände mit Live-Preisen, während Sie manuelle Preise für dieses reproduzierbare Beispiel beibehalten.

Quelle: https://beancount.io/de/docs/examples