04 - Beancount-Grundlagen für Anwender¶
Beancount speichert Buchhaltung als lesbaren Text. Jede Transaktion gibt an, was wann passiert ist, wer beteiligt war und welche Konten sich geändert haben.
Grundlegende Transaktionsstruktur¶
2026-01-13 ! "Trägerwerk Soziale Dienste in Sachsen-Anhalt GmbH" "RgNr. T-2504"
Vermoegen:Bank:Sparkasse-Tohuwabohu:Freies-Geld 680.00 EUR
Einnahmen:Sonstiges
| Teil | Bedeutung |
|---|---|
2026-01-13 |
Datum der Transaktion. |
! |
Statuskennzeichen. In diesem System wird es üblicherweise für importierte oder noch nicht endgültig geprüfte Einträge verwendet. |
| Erster Anführungszeichen-Text | Zahlungsempfänger oder -sender. |
| Zweiter Anführungszeichen-Text | Beschreibung oder Buchungstext der Bank. |
| Erste Kontenzeile | Wohin das Geld geflossen ist oder woher es kam. |
| Zweite Kontenzeile | Die entgegengesetzte Kategorie. Wenn kein Betrag angegeben ist, berechnet Beancount ihn automatisch. |
Kontonamen¶
Kontonamen sind durch Doppelpunkte getrennt:
Vermoegen:Bank:Sparkasse-NICA:Freies-Geld
Lesen Sie es von links nach rechts: Vermögen, Bankkonto, NICA Sparkasse, frei verfügbare Mittel.
Die fünf Kontofamilien¶
| Familie | Bedeutung | Beispiel |
|---|---|---|
Vermoegen |
Vermögenswerte: Bank, PayPal, Bargeld, Inventar. | Vermoegen:Bank:Sparkasse-NICA |
Verbindlichkeiten |
Verbindlichkeiten: Geld, das Personen oder anderen geschuldet wird. | Verbindlichkeiten:Person:Marc-Bielert |
Equity |
Eröffnungsbilanzen und Ausgleichsbuchungen. | Equity:Opening-Balances |
Einnahmen |
Einnahmen. | Einnahmen:Vereinsbeitrag |
Ausgaben |
Ausgaben. | Ausgaben:Buero:Miete |
Vorzeichen für Einnahmen und Ausgaben¶
In Beancount-Berichten erscheinen Einnahmen intern oft mit einem negativen Vorzeichen und Ausgaben mit einem positiven Vorzeichen. Fava und die Dashboards präsentieren diese Werte oft benutzerfreundlicher. Ändern Sie keine Transaktionen nur deshalb, weil eine Einnahmenzahl in einer Rohabfrage negativ erscheint.
Saldenprüfungen¶
Eine Saldenprüfung besagt, dass ein Konto zu einem bestimmten Datum einen bestimmten Saldo haben muss:
2026-03-13 balance Vermoegen:Bank:Sparkasse-NICA 1234.56 EUR
Wenn Beancount diesen Saldo nicht aus den Transaktionen vor diesem Datum ermitteln kann, zeigt Fava einen Fehler an. Saldenprüfungen sind der wichtigste Mechanismus zur Qualitätskontrolle.
Konten eröffnen und schließen¶
Bevor ein Konto verwendet wird, wird es eröffnet:
2025-04-01 open Ausgaben:Projekt:25-ZGV:Honorar
Wenn ein Projekt abgeschlossen ist und das Projektkonto Null ist, kann es geschlossen werden:
2026-02-27 close Ausgaben:Projekt:TOHUCON-25
Geschlossene Konten sollten normalerweise keine neuen Transaktionen mehr erhalten.
Kommentare und Belege¶
Zeilen, die mit ; beginnen, sind Kommentare. Sie erklären Entscheidungen oder unsichere Situationen und beeinflussen die Zahlen nicht.
Belege können mit document-Zeilen verknüpft werden:
2025-10-02 document Ausgaben:Projekt:TOHUCON-25:Essen "Belege Ausgaben/Quittung-Tohu25-001.pdf"