Beancount-zelfstudie: installatie en eerste grootboek

Klaar om de controle over uw financiën te nemen? Deze gids brengt u binnen enkele minuten aan de slag met Beancount. U leert hoe u uw eerste grootboek maakt, essentiële accounts instelt en uw eerste transacties registreert.

Verken het live grootboek →

Initiële installatie​

Uw eerste grootboek maken​

; 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

Essentiële configuratie​

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

Bestandsorganisatie​

Aanbevolen structuur​

; 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

Sectie-organisatie​

1. Eeuwigdurende accounts

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

2. Bankrekeningen

   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. Beleggingsrekeningen

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

Validatie en rapportage​

Basisvalidatie​

# 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 is de validator: deze eindigt met status 0 wanneer het grootboek correct is, en vermeldt elke fout en eindigt met een niet-nulstatus als dat niet zo is. Installeer het met de CLI-snelstart. Fava is de webinterface — voer het uit en open het getoonde http://localhost:5000-adres voor de balans, winst-en-verliesrekening en accountdagboeken.

Veelgebruikte rapporten​

Beancount 3 genereert rapporten via de webinterface van Fava, het eenmalige commando bea report, of ad-hocquery's met bea query, die de Beancount-querytaal uitvoert. Beancount 3 heeft de oudere rapport- en webcommando's verwijderd; bea report en Fava vervangen deze.

# 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'"

Beheer van beginsaldi​

Paddingvoorbeeld​

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

Een balance-assertie controleert het account aan het begin van de datum, dus deze moet na de pad (of elke transactie die het moet omvatten) worden gedateerd. Het op dezelfde dag dateren van de pad en de balance laat de pad ongebruikt en de assertie tekort — Beancount rapporteert Unused Pad entry en Balance failed. Het Equity:Opening-Balances-account moet worden geopend voordat er tegen wordt gepadded.

Accounts afsluiten​

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

Transactiededuplicatie​

Overboekingen afhandelen​

; 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

Balansasserties​

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

Beste praktijken​

1. Bestandsorganisatie

   • Houd in eerste instantie één hoofdbestand aan
   • Gebruik duidelijke sectiekoppen
   • Groepeer gerelateerde accounts bij elkaar

2. Accountnamen

   • Gebruik consistente naamgevingsconventies
   • Neem land-/instellingsvoorvoegsels op
   • Handhaaf een logische hiërarchie

3. Saldo verificatie

   • Regelmatige saldoasserties
   • Pad-accounts op de juiste wijze
   • Volg accountsluitingen

4. Valuta-afhandeling

   • Declareer bedrijfsvaluta's
   • Gebruik consistente goederencodes
   • Specificeer valutabeperkingen

Volgende stappen​

Nu u een basisgrootboek hebt ingesteld:

1. Registreer reguliere transacties: Begin met uw dagelijkse uitgaven en inkomsten
2. Stel bankaccountimporten in: Gebruik CSV-importen of bankverbindingen om gegevensinvoer te automatiseren. Plak een afschrift-export in de CSV-naar-Beancount-omzetter om gebalanceerde invoeren in uw browser te krijgen, of gebruik OFX & QIF naar Beancount voor .ofx-, .qfx- en .qif-downloads.
3. Kopieer een beproefde indeling: Download een uitvoerbaar startbestand uit de secties huishouden, envelopbudgettering of freelance van de werkende grootboekvoorbeelden en pas vervolgens de eigendoms- en investeringspatronen van dezelfde galerij aan
4. Leer geavanceerde syntaxis: Verken syntaxreferentie voor complexere scenario's
5. Genereer uw eerste rapporten: Gebruik de UI-functies om financiële rapporten te maken en uw uitgaven te analyseren
6. Werk vanuit de terminal: Installeer de bea-commandoregel met de CLI-snelstart en sluit daarna een volledige maand af in Uw eerste maand met bea

Snelle referentie​

Veelvoorkomende accounttypen:

• Assets:Bank:Checking - Uw betaalrekening
• Expenses:Food:Groceries - Uitgaven aan boodschappen
• Income:Salary:Company - Inkomsten uit arbeid
• Liabilities:CreditCard:Visa - Creditcardschuld

Essentiële commando's:

• bea --file ledger.beancount check - Valideer uw grootboek (eindigt met niet-nulstatus bij fouten)
• bea --file ledger.beancount report balance-sheet - Druk een balans af
• bea --file ledger.beancount query "SELECT ..." - Vraag saldi en transacties op
• fava ledger.beancount - Start de webinterface voor rapporten en grafieken

Deze richtlijnen leggen een solide basis voor het beheren van persoonlijke financiën met Beancount. Klaar om uw eerste transactie toe te voegen? Bekijk onze UI-transactiegids.