Beancount-Tutorial: Installation und erstes Ledger

Bereit, die Kontrolle über Ihre Finanzen zu übernehmen? Dieser Leitfaden bringt Sie in wenigen Minuten mit Beancount zum Laufen. Sie lernen, wie Sie Ihr erstes Hauptbuch erstellen, wesentliche Konten einrichten und Ihre ersten Transaktionen erfassen.

Erkunden Sie das Live-Hauptbuch →

Ersteinrichtung​

Erstellen Ihres ersten Hauptbuchs​

; Basic structure for a new ledger
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances
 
2024-01-02 * "Initial Deposit"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

Grundlegende Konfiguration​

option "title" "Personal Finance Ledger"
option "operating_currency" "USD"

Dateiorganisation​

Empfohlene Struktur​

; 1. Configuration Options
option "title" "Personal Ledger"
option "operating_currency" "USD"
 
; 2. Account Declarations
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD
2024-01-01 open Equity:Opening-Balances
 
; 3. Initial Balances
; Pad fills the gap up to Equity:Opening-Balances, so it must be dated
; before the assertion. Balance assertions are checked at the start of
; their day, so assert the next morning.
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-02 balance Assets:Checking 1000.00 USD
 
; 4. Transactions
2024-01-15 * "Grocery Store" "Weekly groceries"
  Expenses:Food            50.00 USD
  Assets:Checking

Abschnittsorganisation​

1. Dauerhafte Konten

   2024-01-01 open Liabilities:Payables    USD
   2024-01-01 open Assets:Receivables      USD

2. Bankkonten

   2024-01-01 open Assets:Bank:Checking     USD
   2024-01-01 open Assets:Bank:Savings      USD
   2024-01-01 open Income:Bank:Interest     USD

3. Investmentkonten

   2024-01-01 open Assets:Investment:Cash    USD
   2024-01-01 open Assets:Investment:Stocks  VTSAX
   2024-01-01 open Income:Investment:Dividend USD

Validierung und Berichterstattung​

Grundlegende Validierung​

# Check for errors (exits 0 when clean)
bea --file ledger.beancount check
 
# Browse balances, reports, and charts in the web interface
fava ledger.beancount

bea check ist der Validator: Er beendet sich mit Exit-Code 0, wenn das Hauptbuch sauber ist, und listet jeden Fehler auf und beendet sich andernfalls mit einem Nicht-Null-Exit-Code. Installieren Sie ihn mit dem CLI-Schnellstart. Fava ist die Weboberfläche – führen Sie sie aus und öffnen Sie die angezeigte Adresse http://localhost:5000 für die Bilanz, die Gewinn- und Verlustrechnung und Kontenjournale.

Häufige Berichte​

Beancount 3 erstellt Berichte über die Weboberfläche von Fava, den Ein-Befehl bea report oder Ad-hoc-Abfragen mit bea query, das die Beancount-Abfragesprache ausführt. Beancount 3 hat seine älteren Berichts- und Web-Befehle entfernt; bea report und Fava ersetzen sie.

# Balance sheet, in one command
bea --file ledger.beancount report balance-sheet
 
# Income statement, in one command
bea --file ledger.beancount report income-statement
 
# Balance-sheet numbers: balances by asset, liability, and equity account
bea --file ledger.beancount query "SELECT account, sum(position) AS balance WHERE account ~ '^(Assets|Liabilities|Equity)' GROUP BY account ORDER BY account"
 
# Income-statement numbers: totals by income and expense account
bea --file ledger.beancount query "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bea --file ledger.beancount query "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

Verwaltung von Anfangsbeständen​

Padding-Beispiel​

2024-01-01 open Assets:Checking    USD
2024-01-01 open Equity:Opening-Balances
 
; Pad account to match a known balance
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Assert the known balance the next day: assertions are evaluated at the
; start of their date, and the pad transaction must fall before it
2024-01-02 balance Assets:Checking 1525.00 USD

Eine balance-Bestätigung prüft das Konto am Anfang ihres Datums, daher muss sie nach dem pad (oder einer beliebigen Transaktion) datiert sein, die sie einschließen soll. Wenn pad und balance am selben Tag datiert werden, bleibt das Padding ungenutzt und die Bestätigung ist zu knapp – Beancount meldet Unused Pad entry und Balance failed. Das Konto Equity:Opening-Balances muss geöffnet werden, bevor dagegen gepaddet wird.

Kontoschließung​

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; Account closed

Transaktions-Deduplizierung​

Behandlung von Überweisungen​

; Credit card payment - combined view
2024-01-15 * "Credit Card Payment"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD
 
; Flag for pending match
2024-01-15 * "Pending CC Payment"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

Saldobestätigungen​

; Regular balance checks prevent duplicates
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

Bewährte Praktiken​

1. Dateiorganisation

   • Beginnen Sie zunächst mit einer Hauptdatei
   • Verwenden Sie klare Abschnittsüberschriften
   • Gruppieren Sie verwandte Konten zusammen

2. Kontonamen

   • Verwenden Sie konsistente Namenskonventionen
   • Fügen Sie Länder-/Institutionspräfixe hinzu
   • Pflegen Sie eine logische Hierarchie

3. Saldoüberprüfung

   • Regelmäßige Saldobestätigungen
   • Padding von Konten angemessen anwenden
   • Kontoschließungen nachverfolgen

4. Währungshandhabung

   • Betriebswährungen deklarieren
   • Konsistente Warencodes verwenden
   • Währungsbeschränkungen festlegen

Nächste Schritte​

Jetzt, da Sie ein einfaches Hauptbuch eingerichtet haben:

1. Regelmäßige Transaktionen erfassen: Beginnen Sie mit Ihren täglichen Ausgaben und Einnahmen
2. Bankkonto-Importe einrichten: Nutzen Sie CSV-Importe oder Bankverbindungen, um die Dateneingabe zu automatisieren. Fügen Sie einen Kontoauszugs-Export in den CSV-zu-Beancount-Konverter ein, um in Ihrem Browser ausgeglichene Einträge zu erhalten, oder verwenden Sie OFX & QIF zu Beancount für .ofx, .qfx- und .qif-Downloads.
3. Ein bewährtes Layout kopieren: Laden Sie eine lauffähige Startdatei aus den Abschnitten Haushalt, Umschlagbudgetierung oder Freiberufler der funktionierenden Hauptbuch-Beispiele herunter und passen Sie dann die Vermögens- und Investitionsmuster aus derselben Galerie an
4. Erweiterte Syntax lernen: Erkunden Sie die Syntaxreferenz für komplexere Szenarien
5. Ihre ersten Berichte erstellen: Nutzen Sie die UI-Funktionen, um Finanzberichte zu erstellen und Ihre Ausgaben zu analysieren
6. Vom Terminal aus arbeiten: Installieren Sie die bea-Befehlszeile mit dem CLI-Schnellstart und schließen Sie dann einen ganzen Monat von Anfang bis Ende ab in Ihr erster Monat mit bea

Kurzreferenz​

Häufige Kontotypen:

• Assets:Bank:Checking – Ihr Girokonto
• Expenses:Food:Groceries – Lebensmittelausgaben
• Income:Salary:Company – Arbeitseinkommen
• Liabilities:CreditCard:Visa – Kreditkartenschulden

Wesentliche Befehle:

• bea --file ledger.beancount check – Hauptbuch validieren (beendet sich bei Fehlern mit Nicht-Null-Exit-Code)
• bea --file ledger.beancount report balance-sheet – Eine Bilanz ausgeben
• bea --file ledger.beancount query "SELECT ..." – Salden und Transaktionen abfragen
• fava ledger.beancount – Weboberfläche für Berichte und Diagramme starten

Diese Richtlinien schaffen eine solide Grundlage für die Verwaltung persönlicher Finanzen mit Beancount. Bereit, Ihre erste Transaktion hinzuzufügen? Schauen Sie sich unsere UI-Transaktionsanleitung an.