04 - Podstawy Beancount dla użytkowników¶

Beancount przechowuje księgowość w postaci czytelnego tekstu. Każda transakcja informuje, co się wydarzyło, kiedy, kto był zaangażowany i które konta się zmieniły.

Podstawowy format transakcji¶

2026-01-13 ! "Tragerwerk Soziale Dienste in Sachsen-Anhalt GmbH" "RgNr. T-2504"
  Vermoegen:Bank:Sparkasse-Tohuwabohu:Freies-Geld  680.00 EUR
  Einnahmen:Sonstiges

Część	Znaczenie
`2026-01-13`	Data transakcji.
`!`	Znacznik statusu. W tym systemie jest powszechnie używany dla wpisów zaimportowanych lub jeszcze nieostatecznie przejrzanych.
Pierwszy tekst w cudzysłowie	Odbiorca lub nadawca.
Drugi tekst w cudzysłowie	Opis lub tekst księgowy z banku.
Pierwsza linia konta	Miejsce, skąd pieniądze przyszły lub dokąd poszły.
Druga linia konta	Przeciwstawna kategoria. Jeśli nie podano kwoty, Beancount oblicza ją automatycznie.

Nazwy kont¶

Nazwy kont są oddzielone dwukropkami:

Vermoegen:Bank:Sparkasse-NICA:Freies-Geld

Czytaj od lewej do prawej: aktywa, konto bankowe, Sparkasse NICA, wolne środki.

Pięć rodzin kont¶

Rodzina	Znaczenie	Przykład
`Vermoegen`	Aktywa: bank, PayPal, gotówka, zapasy.	`Vermoegen:Bank:Sparkasse-NICA`
`Verbindlichkeiten`	Zobowiązania: pieniądze należne ludziom lub innym.	`Verbindlichkeiten:Person:Marc-Bielert`
`Equity`	Salda początkowe i wpisy wyrównujące.	`Equity:Opening-Balances`
`Einnahmen`	Przychody.	`Einnahmen:Vereinsbeitrag`
`Ausgaben`	Wydatki.	`Ausgaben:Buero:Miete`

Znaki przychodów i wydatków¶

W raportach Beancount przychody często pojawiają się wewnętrznie ze znakiem ujemnym, a wydatki ze znakiem dodatnim. Fava i pulpity nawigacyjne często prezentują te wartości w sposób bardziej przyjazny dla użytkownika. Nie zmieniaj transakcji tylko dlatego, że liczba przychodów wygląda na ujemną w surowym zapytaniu.

Sprawdzanie salda¶

Sprawdzenie salda stwierdza, że konto musi mieć określone saldo w danym dniu:

2026-03-13 balance Vermoegen:Bank:Sparkasse-NICA 1234.56 EUR

Jeśli Beancount nie może dopasować tego salda z transakcji sprzed tej daty, Fava wyświetli błąd. Sprawdzanie salda jest głównym mechanizmem kontroli jakości.

Otwieranie i zamykanie kont¶

Zanim konto zostanie użyte, jest otwierane:

2025-04-01 open Ausgaben:Projekt:25-ZGV:Honorar

Gdy projekt zostanie zakończony, a konto projektu będzie miało saldo zero, można je zamknąć:

2026-02-27 close Ausgaben:Projekt:TOHUCON-25

Zamknięte konta zazwyczaj nie powinny otrzymywać nowych transakcji.

Komentarze i dokumenty¶

Linie zaczynające się od ; to komentarze. Wyjaśniają one decyzje lub niepewne sytuacje i nie wpływają na liczby.

Potwierdzenia można powiązać za pomocą linii document:

2025-10-02 document Ausgaben:Projekt:TOHUCON-25:Essen "Belege Ausgaben/Quittung-Tohu25-001.pdf"