Salta al contenuto principale

Tutorial Beancount: installazione e primo ledger

Installa Beancount, crea il tuo primo file di ledger, imposta conti e opzioni, quindi validalo — una procedura guidata al primo successo.

Pronto a prendere il controllo delle tue finanze? Questa guida ti farà iniziare con Beancount in pochi minuti. Imparerai come creare il tuo primo registro, configurare gli account essenziali e registrare le tue prime transazioni.

Vista del registro beancount.io che elenca transazioni in doppia contabilità in testo semplice con filtri per tipo di direttiva

Esplora il registro live →

Configurazione Iniziale​

Creazione del 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 (exits 0 when clean)
bea --file ledger.beancount check
 
# Browse balances, reports, and charts in the web interface
fava ledger.beancount

bea check è il validatore: esce con codice 0 quando il registro è pulito, e elenca ogni errore uscendo con codice diverso da zero altrimenti. Installalo con l'avvio rapido CLI. Fava è l'interfaccia web — eseguilo e apri l'indirizzo http://localhost:5000 stampato per visualizzare stato patrimoniale, conto economico e registri degli account.

Report Comuni​

Beancount 3 produce report tramite l'interfaccia web di Fava, il comando unico bea report, oppure query ad hoc con bea query, che esegue il Linguaggio di Query Beancount. Beancount 3 ha rimosso i suoi comandi più vecchi di report e web; bea report e Fava li sostituiscono.

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

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 balance verifica l'account all'inizio della sua data, quindi deve essere datata dopo il pad (o qualsiasi transazione) che dovrebbe includere. Datare il pad e il balance nello stesso giorno lascia il pad inutilizzato e l'asserzione incompleta — Beancount segnala Unused Pad entry e Balance failed. L'account Equity:Opening-Balances deve essere aperto prima di poterci applicare il padding.

Chiusura degli Account​

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

De-duplicazione 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

    • Mantieni un file principale all'inizio
    • 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
    • Padding degli account in modo appropriato
    • Tracciamento delle chiusure degli account

  4. Gestione delle Valute

    • Dichiara le valute operative
    • Usa codici merceologici coerenti
    • Specifica i vincoli valutari

Passi Successivi​

Ora che hai un registro di base configurato:

  1. Registra Transazioni Regolari: Inizia con le tue spese e entrate quotidiane
  2. Configura Importazioni dai Conti Bancari: Usa importazioni CSV o connessioni bancarie per automatizzare l'inserimento dati. Incolla un estratto conto nel convertitore CSV in Beancount per ottenere voci bilanciate nel tuo browser, oppure usa OFX e QIF in Beancount per download .ofx, .qfx e .qif.
  3. Copia una Struttura Collaudata: Scarica un file iniziale eseguibile dalle sezioni finanza personale quotidiana, budget a buste o lavoro autonomo della galleria di registri funzionanti, poi adatta i modelli patrimoniali e di investimento dalla stessa galleria
  4. Impara la Sintassi Avanzata: Esplora il riferimento alla sintassi per scenari più complessi
  5. Genera i Tuoi Primi Report: Usa le funzionalità dell'interfaccia utente per creare report finanziari e analizzare le tue spese
  6. Lavora dal Terminale: Installa la riga di comando bea con l'avvio rapido CLI, poi chiudi un intero mese in modo completo in Il tuo primo mese con bea

Riferimento Rapido​

Tipi di Account Comuni:

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

Comandi Essenziali:

  • bea --file ledger.beancount check - Valida il tuo registro (esce con codice diverso da zero in caso di errori)
  • bea --file ledger.beancount report balance-sheet - Stampa uno stato patrimoniale
  • bea --file ledger.beancount query "SELECT ..." - Interroga saldi e transazioni
  • fava ledger.beancount - Avvia l'interfaccia web per report e grafici

Queste linee guida stabiliscono una solida base per la gestione delle finanze personali con Beancount. Pronto ad aggiungere la tua prima transazione? Consulta la nostra guida alle transazioni via interfaccia utente.

Tutorial Beancount: installazione e primo ledger

Fonte: https://beancount.io/it/docs/Basics/getting-started