Avvio Rapido

Pronto a prendere il controllo delle tue finanze? Questa guida ti porterà all'uso di Beancount in pochi minuti. Imparerai a creare il tuo primo registro, impostare account essenziali e registrare le tue prime transazioni.

Esplora il registro live →

Configurazione Iniziale​

Creare il Tuo Primo Registro​

; 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

Configurazione Essenziale​

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

Organizzazione dei File​

Struttura Consigliata​

; 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

Organizzazione delle Sezioni​

1. Account Patrimoniali

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

2. Conti Bancari

   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. Conti di Investimento

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

Validazione e Reportistica​

Validazione di Base​

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

bean-check è il validatore: stampa nulla ed esce con codice 0 quando il registro è pulito, ed elenca ogni errore uscendo con codice diverso da zero altrimenti. Fava è l'interfaccia web — eseguila e apri l'indirizzo http://localhost:5000 stampato per visualizzare stato patrimoniale, conto economico e giornali degli account.

Reportistica Comune​

Beancount 3 produce report attraverso l'interfaccia web di Fava o query ad-hoc con bean-query, che esegue il Linguaggio di Query Beancount. I vecchi comandi bean-report e bean-web sono stati rimossi in Beancount 3, quindi i comandi seguenti li sostituiscono.

# Balance-sheet numbers: balances by asset, liability, and equity account
bean-query ledger.beancount "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
bean-query ledger.beancount "SELECT account, sum(position) AS total WHERE account ~ '^(Income|Expenses)' GROUP BY account ORDER BY account"
 
# One account's journal, with a running balance
bean-query ledger.beancount "SELECT date, narration, position, balance WHERE account = 'Assets:Checking'"

Gestione dei Saldi Iniziali​

Esempio di Padding​

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

Un'asserzione di balance verifica l'account all'inizio della sua data, quindi deve essere datata dopo il pad (o qualsiasi transazione) che deve includere. Datare pad e balance nello stesso giorno lascia il pad inutilizzato e l'asserzione fallisce — Beancount riporta Voce pad inutilizzata e Asserzione di saldo fallita. L'account Equity:Opening-Balances deve essere aperto prima di essere usato come contropartita del pad.

Chiusura dell'Account​

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

Deduplicazione delle Transazioni​

Gestione dei Trasferimenti​

; 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

Asserzioni di Saldo​

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

Migliori Pratiche​

1. Organizzazione dei File

   • Inizia con un unico file principale
   • Usa intestazioni di sezione chiare
   • Raggruppa account correlati insieme

2. Nomi degli Account

   • Usa convenzioni di denominazione coerenti
   • Includi prefissi paese/istituto
   • Mantieni una gerarchia logica

3. Verifica dei Saldi

   • Asserzioni di saldo regolari
   • Pad degli account appropriati
   • Traccia le chiusure degli account

4. Gestione delle Valute

   • Dichiarare le valute operative
   • Usa codici di valuta coerenti
   • Specifica vincoli di valuta

Prossimi Passi​

Ora che hai un registro di base configurato:

1. Registra Transazioni Regolari: Inizia con le tue spese e entrate quotidiane
2. Imposta Importazioni dai Conti Bancari: Usa importazioni CSV o connessioni bancarie per automatizzare l'inserimento dati. Incolla un estratto conto nel convertitore CSV to Beancount per ottenere transazioni bilanciate nel browser, oppure usa OFX & QIF to Beancount per download di file .ofx, .qfx e .qif.
3. Copia una Struttura Collaudata: Scarica un file iniziale funzionante dalle sezioni uso domestico, budget a buste, o freelance degli esempi di registro, poi adatta i modelli di proprietà e investimenti dalla stessa galleria
4. Impara la Sintassi Avanzata: Esplora riferimento sintassi per scenari più complessi
5. Genera i Tuoi Primi Report: Usa le funzionalità dell'interfaccia per creare report finanziari e analizzare le tue spese

Riferimento Rapido​

Tipi di Account Comuni:

• Assets:Bank:Checking - Il tuo conto corrente
• Expenses:Food:Groceries - Spese alimentari
• Income:Salary:Company - Reddito da lavoro dipendente
• Liabilities:CreditCard:Visa - Debito su carta di credito

Comandi Essenziali:

• bean-check ledger.beancount - Valida il tuo registro (esce con codice diverso da zero in caso di errori)
• fava ledger.beancount - Avvia l'interfaccia web per report e grafici
• bean-query ledger.beancount "SELECT ..." - Esegui query su saldi e transazioni

Queste linee guida gettano solide fondamenta per gestire le tue finanze personali con Beancount. Pronto ad aggiungere la tua prima transazione? Dai un'occhiata alla guida per aggiungere la tua prima transazione.