Glossario

La contabilità in testo semplice prende in prestito il lessico della contabilità in partita doppia e aggiunge alcuni termini propri di Beancount. Questo glossario definisce i termini che incontrerai leggendo questi documenti o il tuo registro contabile, ciascuno con un breve esempio dove utile. Ogni voce ha un proprio collegamento, così puoi indicare un collega direttamente a una definizione.

Conto​

Un conto è un contenitore nominato che tiene traccia di un flusso di valore, scritto come una gerarchia separata da due punti sotto uno di cinque tipi radice: Assets (Attività), Liabilities (Passività), Equity (Patrimonio netto), Income (Entrate) o Expenses (Spese). La gerarchia è l'intera struttura organizzativa del tuo registro — Assets:US:BofA:Checking e Expenses:Food:Restaurant vengono ordinati e aggregati 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 le entrate quando sono guadagnate e le spese quando sono sostenute, indipendentemente da quando il denaro si sposta effettivamente. La contabilità per cassa fa l'opposto: riconosce entrambe solo quando il denaro cambia di mano. La competenza fornisce un quadro più fedele della performance di un periodo, motivo per cui una fattura emessa a marzo appartiene a marzo anche se il cliente paga a maggio.

Ammortamento​

L'ammortamento ripartisce un unico pagamento significativo nei periodi che copre effettivamente, così ogni mese si fa carico della sua giusta parte di costo. Un premio assicurativo annuale pagato a gennaio è una spesa di tutti e dodici i mesi, non solo di gennaio. In Beancount puoi scrivere le registrazioni di ripartizione a mano o generarli con un plugin — vedi Ammortamento.

Verifica di saldo​

Una verifica di saldo è una direttiva balance che stabilisce quale deve essere il saldo di un conto all'inizio di una data specifica, in modo che il tuo estratto conto bancario diventi un controllo automatico sui tuoi libri contabili. Se il saldo calcolato differisce, Beancount fallisce con un messaggio sonoro riportando gli importi previsti ed effettivi. Spargere una verifica per conto per estratto conto è il modo più economico per mantenere affidabile un registro contabile.

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

Beancount​

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

Linguaggio di interrogazione Beancount​

Il Linguaggio di interrogazione Beancount, solitamente abbreviato BQL, è il linguaggio simile a SQL che usi per interrogare il tuo registro contabile. 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 registrazione​

Un metodo di registrazione è la regola che Beancount applica quando una riduzione deve scegliere quali lotti esistenti prelevare. Le scelte sono STRICT (devi identificare il lotto tu stesso), FIFO, LIFO, AVERAGE e NONE, impostate per conto nella sua direttiva open. Il metodo che scegli modifica le tue plusvalenze realizzate, quindi scegli quello previsto dalla tua giurisdizione fiscale e mantienilo stabile.

Piano dei conti​

Un piano dei conti è l'elenco completo dei conti utilizzati dal tuo registro, insieme alla struttura che li organizza. In Beancount non esiste un file separato per il piano — l'insieme delle direttive open è il tuo piano dei conti. Progettarlo bene all'inizio evita molte ridenominazioni in seguito; vedi Strutture per settore specifico per spunti iniziali.

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 dismette un conto bancario o un prestito estinto senza cancellarne la cronologia. Le transazioni passate rimangono valide e segnalabili; solo le nuove registrazioni vengono rifiutate. Chiudere i conti inutilizzati mantiene leggibili i report man mano che il registro invecchia.

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

Commodity​

Una commodity è qualsiasi unità di valore tracciata dal tuo registro — una valuta come USD, un ticker azionario come AAPL, un asset crittografico come BTC, o qualcosa che inventi tu come VACATION-DAY. Beancount non converte mai tra commodity alle tue spalle, quindi un importo è sempre un numero abbinato alla commodity in cui è denominato. Una direttiva opzionale commodity ti consente di allegare metadati come un nome o una classe di attività.

Costo base​

Il costo base è ciò che hai effettivamente pagato per una partecipazione, registrato nella valuta con cui hai pagato e portato avanti insieme alla partecipazione per tutto il tempo in cui la possiedi. Beancount lo scrive tra parentesi graffe — 10 AAPL {150.00 USD} significa dieci azioni acquisite a 150 dollari ciascuna. Poiché la base viaggia con la posizione, le plusvalenze emergono dall'aritmetica quando vendi. Vedi Gestione dell'inventario.

Direttiva​

Una direttiva è un'istruzione datata in un file Beancount, e le direttive sono tutto ciò che un registro contiene. Ogni riga che inizia con una data è una direttiva: open, close, balance, price, note, document, pad, event, commodity e la transazione stessa. Beancount ordina le direttive per data prima di elaborarle, così puoi tenerle nell'ordine che preferisci per la lettura.

Contabilità in partita doppia​

La contabilità in partita doppia è la pratica di registrare ogni evento economico con almeno due voci corrispondenti, in modo che gli importi si sommino sempre a zero. Il denaro non viene mai creato o distrutto — si sposta solo tra conti, motivo per cui questa tecnica coglie errori che un elenco a colonna singola non coglierebbe mai. Beancout applica la regola rigorosamente: una transazione le cui registrazioni non bilanciano è un errore, non un avviso.

Budget a pacchetti (Envelope budgeting)​

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

Fava​

Fava è l'interfaccia web per Beancount: grafici, stati patrimoniali, conti economici, un editor di interrogazioni e un modulo di inserimento, serviti dal tuo file di registro. È prevalentemente in sola lettura e funziona localmente, quindi cambia il modo in cui vedi i tuoi libri senza cambiare il modo in cui li registri. beancount.io ospita una versione gestita insieme alla propria strumentazione; la guida Funzionalità dell'interfaccia utente copre cosa puoi fare.

Inventario​

Un inventario è la raccolta di posizioni attualmente detenute da un conto, ciascuna con la propria commodity e, ove pertinente, il proprio costo base e la data di acquisizione. Un conto titoli che ha acquistato la stessa azione tre volte detiene tre lotti separati in un inventario, non un unico numero aggregato. 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 contabili — il flusso grezzo delle transazioni, in ordine di data, prima di qualsiasi raggruppamento o riepilogo. È la vista che esamini quando vuoi rispondere a "cosa ho fatto realmente a marzo?". La pagina del giornale di Fava è di solito il posto più veloce per individuare una registrazione mal classata.

Registro / Ledger​

Un registro (ledger) è l'insieme completo delle scritture contabili per un'entità, che in Beancount significa il tuo file di testo semplice (più tutto ciò che include). La parola funge sia da nome dell'intera raccolta di conti che da nome del file stesso. Poiché è testo, un registro può essere confrontato (diff), revisionato, ramificato e unito come il codice sorgente.

Lotto​

Un lotto è una specifica acquisizione di una commodity, identificata dal suo costo base e dalla data di acquisizione. Acquistare 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 di approssimarle.

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

Descrizione (Narration)​

La descrizione (narration) è la spiegazione in formato libero dello scopo di una transazione, scritta come la seconda stringa tra virgolette sulla riga della transazione. È per gli umani: "Affitto mensile", "Spesa alimentare e casalinghi". Beancount non la analizza, ma è ciò che leggerai quando la registrazione non avrà più senso tra sei mesi.

Direttiva di apertura (Open directive)​

Una direttiva open dichiara un conto, la data da cui inizia ad essere utilizzabile, e opzionalmente le commodity che può detenere e il metodo di registrazione che utilizza. Beancount richiede che ogni conto sia aperto prima della sua prima registrazione, il che impedisce a un errore di battitura di creare silenziosamente un conto inesistente. Limitare le commodity consentite trasforma un'altra intera classe di errori in segnalazioni di errore.

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

Stub (Pad)​

Una direttiva pad dice a Beancount di inserire l'importo necessario per far sì che la successiva verifica di saldo su un conto abbia successo, registrando la differenza su un secondo conto. Esiste esattamente per un compito: aprire un registro a metà del suo ciclo di vita senza ricostruire anni di cronologia. Usare gli stub oltre questa configurazione iniziale di solito significa che un vero errore viene nascosto.

Beneficiario (Payee)​

Il beneficiario (payee) è colui con cui hai effettuato la transazione, scritto come la 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 sul beneficiario e gli importatori automatizzati. Beancount tratta il beneficiario come opzionale; una transazione può avere solo una descrizione.

Contabilità in testo semplice​

La contabilità in testo semplice è la pratica di tenere i tuoi libri contabili 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 con durabilità, verificabilità e automazione: i tuoi dati sopravvivono a qualsiasi fornitore, ogni modifica è 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 vengono implementati senza modificare il linguaggio principale. Ne attivi uno con una riga plugin all'inizio del tuo registro — la guida Plugin di previsione illustra un esempio reale.

Registrazione (Posting)​

Una registrazione (posting) è una gamba di una transazione: un conto, un importo, e opzionalmente un costo o prezzo. Una transazione necessita di almeno due registrazioni, e i loro importi devono sommare a zero. Al massimo una registrazione può lasciare il suo importo vuoto, nel qual caso Beancount calcola l'importo di equilibrio per te.

Direttiva prezzo (Price directive)​

Una direttiva price registra il tasso di cambio tra due commodity a una data, che è il modo in cui Beancount converte una partecipazione al suo valore di mercato nei report. I prezzi sono puri dati di riferimento — non muovono mai denaro e non appaiono mai in una transazione. Senza di essi, un portafoglio bilancia 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 contabili concordano con una registrazione esterna come un estratto conto bancario o di un intermediario. 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 perfettamente ogni mese è uno da cui puoi preparare le tasse senza timore.

Etichette e collegamenti (Tags and links)​

Etichette e collegamenti sono le due etichette che alleghi alle transazioni per raggrupparle al di fuori della gerarchia dei conti: un'etichetta con # segna un tema come #viaggio-giappone, e un collegamento con ^ lega insieme voci correlate come ^fattura-2026-014. Le etichette rispondono a "mostrami tutto in questa categoria"; i collegamenti rispondono a "mostra 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 descrizione, e due o più registrazioni i cui importi sommano a zero. Tutto il resto in un file Beancount esiste per dichiarare, controllare o annotare transazioni.

2026-02-14 * "Blue Bottle" "Caffè con 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 Prontuario mette a confronto la sintassi di ogni direttiva.