Glossario

La contabilità in testo semplice prende in prestito il vocabolario dalla contabilità a partita doppia e aggiunge alcune parole specifiche di Beancount. Questo glossario definisce i termini che incontrerai leggendo questi documenti o il tuo stesso file di registro, ciascuno con un breve esempio dove utile. Ogni voce ha il suo collegamento, così puoi indirizzare un collega direttamente a una definizione.

Conto​

Un conto è un contenitore nominato che traccia un flusso di valore, scritto come gerarchia separata da due punti sotto uno dei cinque tipi di radice: Assets, Liabilities, Equity, Income o Expenses. La gerarchia è l'intera struttura organizzativa dei tuoi libri — Assets:US:BofA:Checking e Expenses:Food:Restaurant si ordinano e si aggregano automaticamente. Ogni conto deve essere dichiarato prima di essere utilizzato. Vedi Sintassi del linguaggio Beancount per le regole di denominazione.

Principio di competenza​

La contabilità per competenza registra i ricavi quando sono maturati e i costi quando sono sostenuti, indipendentemente da quando il denaro si muove effettivamente. La contabilità per cassa fa il contrario: riconosce entrambi solo quando il denaro cambia mano. La competenza dà un quadro più fedele della performance di un periodo, motivo per cui una fattura inviata a marzo appartiene a marzo anche se il cliente paga a maggio.

Ammortamento​

L'ammortamento distribuisce un singolo pagamento importante sui periodi che copre effettivamente, così ogni mese si fa carico della sua giusta quota di costo. Un premio assicurativo annuale pagato a gennaio è una spesa di tutti i dodici mesi, non solo di gennaio. In Beancount puoi scrivere le registrazioni divise a mano o generararle con un plugin — vedi Ammortizza.

Verifica di saldo​

Una verifica di saldo è una direttiva balance che dichiara quale deve essere il saldo di un conto all'inizio di una data data, così il tuo estratto conto bancario diventa un controllo automatico sui tuoi libri. Se il saldo calcolato differisce di più della tolleranza della verifica, Beancount fallisce sonoramente con gli importi attesi e effettivi. Quella tolleranza è un'unità dell'ultimo decimale che hai scritto — 4.27 RGAGX accetta qualsiasi valore da 4.26 a 4.28 — e un ~ prima della valuta imposta la tua. Spargere una verifica per conto per estratto conto è il modo più economico per mantenere un registro affidabile.

2026-01-01 balance Assets:US:BofA:Checking   4,321.00 USD

Beancount​

Beancount è un sistema di contabilità a partita doppia open-source il cui registro è un file di testo semplice che modifichi in qualsiasi editor di testo e convalidi con uno strumento a riga di comando. Offre una sintassi rigorosa e analizzabile, un linguaggio di interrogazione e un'interfaccia web, senza database o formato di file proprietario. Poiché il registro è testo, vive felicemente in Git insieme al tuo codice. Inizia con Introduzione a Beancount.

Linguaggio di interrogazione Beancount​

Il linguaggio di interrogazione Beancount, di solito abbreviato BQL, è il linguaggio simile a SQL che usi per fare domande al tuo registro. Opera sulle direttive analizzate piuttosto che su un database, quindi SELECT account, sum(position) WHERE year = 2026 risponde immediatamente dallo stesso file che modifichi. Leggi la guida al linguaggio di interrogazione per la grammatica completa.

Metodo di prenotazione​

Un metodo di prenotazione è la regola che Beancount applica quando una riduzione deve scegliere quali lotti esistenti prelevare. Beancount 3.2.3 accetta sette nomi: STRICT (il predefinito, dove identifichi tu stesso il lotto), STRICT_WITH_SIZE, NONE, FIFO, LIFO, HIFO e AVERAGE. Impostane uno per conto sulla sua direttiva open, o per l'intero file con option "booking_method". Sei dei sette sono implementati: AVERAGE viene analizzato, ma solleva AVERAGE method is not supported nel momento in cui deve prenotare una riduzione. Il metodo che scegli cambia le tue plusvalenze realizzate, quindi scegli quello che la tua giurisdizione fiscale si aspetta e mantienilo stabile. Gestione dell'inventario esegue tutti e sette sugli stessi lotti e pubblica il registro che fallisce sotto AVERAGE.

Piano dei conti​

Un piano dei conti è l'elenco completo dei conti che il tuo registro usa, insieme alla struttura che li organizza. In Beancount non esiste un file di piano separato — il insieme delle direttive open è il tuo piano dei conti. Progettarlo bene all'inizio risparmia un sacco di rinomina in seguito; vedi Configurazioni specifiche per settore per punti di partenza.

Direttiva di chiusura​

Una direttiva close segna la data dopo la quale un conto non può più essere utilizzato, che è il modo in cui si ritira un conto bancario o un prestito estinto senza cancellarne la storia. Le transazioni passate rimangono valide e segnalabili; solo le nuove registrazioni vengono rifiutate. Chiudere i conti inutilizzati mantiene i report leggibili mentre un registro invecchia.

2026-03-31 close Assets:US:OldBank:Checking

Merce​

Una merce è qualsiasi unità di valore che il tuo registro traccia — una valuta come USD, un ticker azionario come AAPL, una criptovaluta come BTC, o qualcosa che inventi come VACATION-DAYS. Beancount non converte mai tra merci alle tue spalle, quindi un importo è sempre un numero abbinato alla merce in cui è denominato. Una direttiva commodity opzionale ti permette di allegare metadati come un nome o una classe di attività.

Base di costo​

La base di costo è ciò che hai effettivamente pagato per una partecipazione, registrata nella valuta con cui hai pagato e portata insieme alla partecipazione per tutto il tempo in cui la possiedi. Beancount la scrive tra parentesi graffe — 10 AAPL {150.00 USD} significa dieci azioni acquisite a 150 dollari ciascuna. Raddoppia le parentesi graffe e il numero diventa il totale piuttosto che il prezzo unitario, quindi 10 AAPL {{1,500.00 USD}} registra lo stesso lotto. Poiché la base viaggia con la posizione, le plusvalenze escono dall'aritmetica quando vendi. Vedi Gestione dell'inventario.

Direttiva​

Una direttiva è un'istruzione in un file Beancount, di solito datata, e le direttive sono ciò di cui è fatto un registro. Dodici tipi portano una data: open, close, balance, price, note, document, pad, event, commodity, custom, query e la transazione stessa. Alcune non portano alcuna data e agiscono sul file piuttosto che su un giorno — option, include, plugin e la coppia pushtag/poptag. Beancount ordina quelle datate per data prima di elaborarle, quindi puoi tenerle nell'ordine che si legge meglio; una non datata ha effetto dove è scritta.

Contabilità a partita doppia​

La contabilità a partita doppia è la pratica di registrare ogni evento economico come almeno due registrazioni corrispondenti, così che i loro pesi sommino sempre a zero. Il denaro non viene mai creato o distrutto — si sposta solo tra conti, motivo per cui la tecnica cattura errori che un elenco a colonna singola non farebbe mai. Un peso è l'importo proprio di una registrazione, o il suo costo o prezzo convertito in una sola valuta, quindi due gambe in merci diverse si annullano comunque. Beancount applica la regola rigorosamente: una transazione le cui registrazioni non quadrano è un errore, non un avvertimento.

2026-03-02 * "Bank" "Buy euros"
  Assets:US:BofA:EUR       100.00 EUR @ 1.08 USD
  Assets:US:BofA:Checking -108.00 USD

Budget a buste​

Il budget a buste mette da parte denaro per uno scopo prima di spenderlo, così ogni categoria ha il suo limite invece di competere per un saldo aggregato. Il nome deriva dalle buste di carta che le persone una volta riempivano di contanti il giorno di paga. In un registro in testo semplice modelli le buste con conti dedicati o direttive di budget — vedi Budget.

Fava​

Fava è l'interfaccia web per Beancount: grafici, bilanci, conti economici, un editor di interrogazioni e un modulo di inserimento, serviti dal tuo file di registro. È principalmente di sola lettura e gira localmente, quindi cambia il modo in cui vedi i tuoi libri senza cambiare come li registri. beancount.io ospita una versione gestita insieme ai suoi strumenti; la guida Funzionalità dell'interfaccia copre cosa puoi fare lì.

Inventario​

Un inventario è la collezione di posizioni che un conto detiene attualmente, ciascuna con la sua merce e, dove rilevante, la sua base di costo e data di acquisizione. Un conto di intermediazione che ha comprato la stessa azione tre volte detiene tre lotti separati in un inventario, non un numero unico miscelato. Mantenere i lotti distinti è ciò che rende possibili calcoli accurati delle plusvalenze.

Giornale​

Il giornale è l'elenco cronologico di tutto ciò che è accaduto nei tuoi libri — il flusso grezzo di transazioni, in ordine di data, prima di qualsiasi raggruppamento o sintesi. È la vista che scorri quando vuoi rispondere "cosa ho fatto effettivamente a marzo?". La pagina del giornale di Fava è di solito il posto più veloce per individuare una voce classificata male.

Registro​

Un registro è il set completo di registrazioni contabili per una singola entità, che in Beancount significa il tuo file di testo semplice (più qualsiasi cosa includa). La parola funge sia da nome dell'intero libro dei conti che da nome del file stesso. Poiché è testo, un registro può essere sottoposto a diff, revisionato, ramificato e unito come codice sorgente.

Lotto​

Un lotto è una specifica acquisizione di una merce, identificata dalla sua base di costo e data di acquisizione. Comprare lo stesso ETF a gennaio e di nuovo a giugno crea due lotti, e vendere in seguito significa scegliere quale lotto stai vendendo. I lotti sono il motivo per cui Beancount può calcolare le plusvalenze realizzate esattamente invece che approssimarle.

2026-06-15 * "Broker" "Buy VTI"
  Assets:US:Broker:VTI     5 VTI {260.00 USD, 2026-06-15}
  Assets:US:Broker:Cash            -1,300.00 USD

Narrazione​

La narrazione è la descrizione in testo libero di a cosa serviva una transazione, scritta come seconda stringa tra virgolette sulla riga della transazione. È per gli umani: "Affitto mensile", "Spesa e articoli per la casa". Beancount non la analizza, ma è ciò che leggerai quando la voce non avrà più senso tra sei mesi.

Direttiva di apertura​

Una direttiva open dichiara un conto, la data in cui inizia a essere utilizzabile e opzionalmente le merci che può contenere e il metodo di prenotazione che usa. Beancount richiede che ogni conto sia aperto prima della sua prima registrazione, che è ciò che impedisce a un errore di battitura di creare silenziosamente un conto nuovo. Limitare le merci consentite trasforma un'altra intera classe di errori in errori.

2026-01-01 open Assets:US:Broker:VTI   VTI   "FIFO"

Pad​

Una direttiva pad dice a Beancount di inserire qualsiasi importo necessario per far riuscire la prossima verifica di saldo su un conto, prenotando la differenza su un secondo conto. Esiste esattamente per un lavoro: aprire un registro a metà della vita senza ricostruire anni di storia. Ripetere il padding oltre quella configurazione iniziale di solito significa che un errore reale viene coperto.

Beneficiario​

Il beneficiario è con chi hai fatto la transazione, scritto come prima stringa tra virgolette su una riga di transazione. Mantenere i beneficiari coerenti — sempre "Whole Foods", mai a volte "WholeFoods" — è ciò che fa funzionare i report basati sui beneficiari e gli importatori automatizzati. Beancount tratta il beneficiario come opzionale; una transazione può avere solo una narrazione.

Contabilità in testo semplice​

La contabilità in testo semplice è la pratica di tenere i tuoi libri in un file di testo leggibile dall'uomo sotto controllo di versione, elaborato da strumenti open-source a riga di comando. Scambia un'interfaccia punta-e-clicca per durabilità, revisionabilità e automazione: i tuoi dati sopravvivono a qualsiasi fornitore, ogni cambiamento è un diff revisionabile e qualsiasi script può leggerli. Beancount, Ledger e hledger sono le tre implementazioni più note.

Plugin​

Un plugin è un modulo Python che Beancount carica durante l'elaborazione del tuo file, permettendogli di aggiungere, trasformare o convalidare direttive prima che i report vengano costruiti. I plugin sono il modo in cui la previsione, i piani di ammortamento e i controlli personalizzati sono implementati senza cambiare il linguaggio principale. Ne abiliti uno con una riga plugin indipendente all'inizio del tuo registro, mai con un'option — option "plugin" "…" viene rifiutato con Option 'plugin' may not be set. La guida Plugin di previsione illustra un esempio reale.

Registrazione​

Una registrazione è una gamba di una transazione: un conto, un importo e opzionalmente un costo o prezzo. Ciò che deve sommare a zero attraverso una transazione non sono gli importi grezzi ma i loro pesi: un importo semplice pesa se stesso, 10 FUND @ 38.46 USD pesa 384.60 USD, e 10 FUND {384.61 USD} pesa 3,846.10 USD, perché le parentesi graffe singole contengono il costo di una unità. Al massimo una registrazione può lasciare il suo importo vuoto, nel qual caso Beancount calcola la cifra di bilanciamento per te. Vedi Precisione e tolleranze per le regole complete sui pesi.

Direttiva prezzo​

Una direttiva price registra il tasso di cambio tra due merci in una data, che è il modo in cui Beancount converte una partecipazione al suo valore di mercato nei report. Una direttiva price è puro dato di riferimento: non muove denaro e non appartiene a nessuna transazione. Non confonderla con il prezzo @ scritto dentro una registrazione, che è aritmetica — dà a 10 FUND @ 38.46 USD un peso di 384.60 USD e quindi decide se la transazione quadra. Senza direttive prezzo, un portafoglio quadra ancora al costo ma non può essere valutato al mercato.

2026-06-30 price VTI   271.40 USD

Riconciliazione​

La riconciliazione è l'atto di dimostrare che i tuoi libri concordano con un record esterno come un estratto conto bancario o di intermediazione. Nella contabilità in testo semplice è in gran parte meccanica: aggiungi una verifica di saldo per ogni data di estratto conto e lascia che lo strumento ti dica se i numeri corrispondono. Un registro che si riconcilia pulitamente ogni mese è uno da cui puoi dichiarare le tasse senza paura.

Tag e collegamenti​

Tag e collegamenti sono le due etichette che alleghi alle transazioni per raggrupparle al di fuori della gerarchia dei conti: un tag con # segna un tema come #trip-japan, e un collegamento con ^ lega insieme voci correlate come ^invoice-2026-014. I tag rispondono a "mostrami tutto in questa categoria"; i collegamenti rispondono a "mostrami le voci che appartengono a questo singolo evento". Entrambi sono filtrabili in Fava e interrogabili in BQL — vedi Filtraggio e ricerca.

Transazione​

Una transazione è un evento economico datato insieme alle registrazioni che lo registrano, ed è la direttiva che scriverai più spesso. Porta un flag (* per confermato, ! per da-rivedere), un beneficiario opzionale, una narrazione e due o più registrazioni i cui pesi sommano a zero. Tutto il resto in un file Beancount esiste per dichiarare, controllare o annotare transazioni.

2026-02-14 * "Blue Bottle" "Coffee with Dana"
  Expenses:Food:Coffee      9.50 USD
  Assets:US:BofA:Checking  -9.50 USD

Ancora bloccato su una parola? Il Centro di assistenza indicizza ogni guida su questo sito, e il Promemoria mette la sintassi per ogni direttiva fianco a fianco.