Zum Hauptinhalt springen

Beancount Cheat Sheet: Syntax und Direktiven

Einseitige Beancount-Syntaxreferenz: Kontotypen und Vorzeichen, Commodities, Transaktionen und Buchungen, Saldo, Metadaten, Ereignisse, Tags und Optionen.

Kontostruktur​

Kontotypen und Vorzeichen​

Typ           Vorzeichen  Beispiel
------------------------------------------------
Assets        (+)         Assets:US:BofA:Checking
Liabilities   (-)         Liabilities:Credit:Amex
Income        (-)         Income:Salary:Gross
Expenses      (+)         Expenses:Food:Restaurant
Equity        (-)         Equity:Opening-Balances

Währungsformat​

Waren sind großgeschriebene Symbole — Währungen, Ticker und benutzerdefinierte Einheiten. Dies sind Benennungsbeispiele, keine Direktiven:

Währungen:        USD, EUR, CAD, AUD
Investments:      GOOG, AAPL, VTI
Kryptowährungen:  BTC, ETH
Benutzerdefinierte Einheiten: HOURS, AIRMILES, HOME_MAYST

Anweisungssyntax​

Kontoverwaltung​

; Konten eröffnen
2024-01-01 open Assets:Checking             ; Einfach
2024-01-01 open Assets:Investing USD,GOOG   ; Mit Einschränkungen
 
; Konten schließen
2024-12-31 close Assets:Old:Account

Währungsdeklaration​

2024-01-01 commodity VTSAX
    name: "Vanguard Total Stock Market Index"
    asset-class: "equity"

Transaktionsaufzeichnung​

; Einfache Transaktion
2024-01-15 * "Grocery Store" "Weekly shopping"
    Assets:Checking     -100.00 USD
    Expenses:Food:Groceries
 
; Mit Metadaten und Tags (#work ist ein Tag, ^invoice-123 ist ein Link)
2024-01-15 * "Restaurant" "Business dinner" #work ^invoice-123
    id: "T-1234"
    receipt: "path/to/receipt.pdf"
    Expenses:Meals      80.00 USD
    Liabilities:Credit

Buchungsspezifikationen​

Dies sind Posten-Zeilen — jede steht innerhalb einer Transaktion, eingerückt unter ihrer Datumszeile:

; Einfacher Betrag
Assets:Cash              100.00 USD
 
; Einstandskostenverfolgung
Assets:Invest:VTSAX      10 VTSAX {100.00 USD}        ; Kosten pro Einheit
Assets:Invest:VTSAX      10 VTSAX {{1000.00 USD}}     ; Gesamtkosten
Assets:Invest:VTSAX      10 VTSAX {100.00 # 9.95 USD} ; Pro Einheit plus Gesamtgebühr
 
; Preisspezifikationen
Assets:Forex            1000.00 USD @ 0.85 EUR        ; Pro Einheit
Assets:Forex            1000.00 USD @@ 850.00 EUR     ; Gesamtpreis
 
; Datierte Lots
Assets:Invest:VTSAX      10 VTSAX {100.00 USD, 2024-01-15}

Saldenverifizierung​

; Kontostandsausgleich: füllt Assets:Checking bis Equity:Opening-Balances auf
2024-01-01 pad Assets:Checking Equity:Opening-Balances
 
; Kontostandsbestätigung: wird zu Beginn ihres Datums geprüft, daher nach dem Pad datieren
2024-02-01 balance Assets:Checking  1000.00 USD

Metadaten-Verfolgung​

; Notizanhang
2024-01-15 note Assets:Checking "Called bank about fee"
 
; Dokumentverknüpfung
2024-01-15 document Assets:Checking "path/to/statement.pdf"
 
; Preisaufzeichnung
2024-01-15 price VTSAX  100.00 USD

Für gehostete Ledger können Live Prices datierte Bewertungspreise automatisch liefern. Wählen Sie unterstützte Asset-Paare im Picker aus und kopieren Sie dann die Includes in Ihr Ledger. Halten Sie Transaktionspreise und Einstandskosten explizit.

Ereignisaufzeichnung​

; Standortverfolgung
2024-01-15 event "location" "New York, USA"
 
; Eigenschaftsänderungen
2024-01-15 event "address" "123 Main Street"

Tag-Verwaltung​

; Tag-Gültigkeitsbereich: #vacation gilt für jede Transaktion zwischen pushtag und poptag
pushtag #vacation
2024-01-15 * "Hotel"
    Expenses:Travel:Lodging   200.00 USD
    Assets:Credit
poptag #vacation

Konfigurationsoptionen​

; Grundeinstellungen
option "title" "Personal Finance Ledger"
option "operating_currency" "USD"
 
; Kontobenennung
option "name_assets" "Assets"
option "name_liabilities" "Liabilities"
option "name_income" "Income"
option "name_expenses" "Expenses"
option "name_equity" "Equity"
 
; Dokumentverwaltung
option "documents" "/path/to/docs"

Kommentare und Organisation​

; Einzeiliger Kommentar
 
* Abschnittsüberschrift
** Unterabschnitt
; Transaktionsblock folgt...
 
; Kontogruppierung
; Assets
2024-01-15 ...
 
; Expenses
2024-01-16 ...

Diese Referenz bietet einen vollständigen Überblick über Beancounts Syntax-Elemente mit praktischen Beispielen.

Quelle: https://beancount.io/de/docs/Basics/cheatsheet