FAQ di Beancount: Domande sulla contabilità in testo semplice

Circa cinque concetti, non una laurea. Ti servono i cinque tipi di conto (attività, passività, patrimonio netto, ricavi, costi), l'idea che ogni transazione sposta valore tra almeno due di essi, e la regola che una transazione deve essere in equilibrio. Beancount applica il resto per te — segnala come errore qualsiasi transazione i cui numeri non tornano, invece di accettarla in silenzio, così il software cattura gli errori che un principiante potrebbe altrimenti non notare.

Inizia con l'Introduzione a Beancount, tieni il Glossario aperto in una scheda, e aggiungi le tue prime transazioni nella Guida rapida.

Beancount non usa affatto le parole "addebito" e "accredito" — usa numeri con segno che devono sommare a zero. Il denaro che esce da un conto è negativo, quello che entra è positivo, e una transazione è valida quando le sue registrazioni si compensano. È la stessa partita doppia che usano i contabili, senza il vocabolario che confonde i principianti.

Se hai usato software di contabilità tradizionale, la traduzione è: un addebito è un numero positivo e un accredito è un numero negativo. Consulta il riferimento alla Sintassi del linguaggio per come sono scritte le registrazioni, oppure Addebiti e accrediti spiegati per il background contabile in inglese semplice.

Perché il denaro viene sempre da qualche parte, e il bilanciamento a zero è ciò che trasforma questo fatto in un controllo degli errori. Se spendi 40 $ in generi alimentari, quel denaro è uscito da un conto bancario — registrando entrambe le metà, le due parti devono compensarsi, e qualsiasi errore di battitura in entrambi gli importi viene segnalato come errore invece di produrre silenziosamente un saldo sbagliato.

Questo è il motivo per cui una contabilità in testo semplice è più affidabile di un foglio di calcolo delle spese: la struttura stessa si autocontrolla. Un'asserzione di saldo è il meccanismo correlato che verifica la tua contabilità contro la realtà.

Registra una transazione nella data di inizio che sposti il saldo attuale di ciascun conto da Equity:Opening-Balances, poi aggiungi un'asserzione di balance per bloccarlo. Non devi ricostruire la tua storia finanziaria — scegli una data di inizio, prendi i saldi come sono quel giorno, e vai avanti da lì.

La Guida rapida illustra un esempio completo di saldi iniziali.

Inizia in modo sintetico e suddividi solo quando una suddivisione più fine cambierebbe una decisione. Una ventina di conti è sufficiente per iniziare; se ti trovi a chiederti se "Spese:Alimentari" debba separare i generi alimentari dai ristoranti, il test utile è se faresti davvero qualcosa di diverso sapendo la suddivisione.

Rinominare e suddividere più tardi è un'operazione di ricerca e sostituzione in un file di testo, quindi il costo di iniziare in modo semplice è basso. I nomi dei conti si annidano, quindi puoi iniziare con una categoria ampia e suddividerla in sottoconti più tardi senza riscrivere la storia — vedi Come progettare un piano dei conti se vuoi una struttura da copiare.

Un foglio di calcolo non può dirti quando è sbagliato. La contabilità in testo semplice applica la partita doppia, quindi ogni transazione si autocontrolla, e il file resta cercabile, differenziabile e scriptabile finché esistono file di testo. Ottieni anche una vera cronologia delle versioni: git log sul tuo registro mostra esattamente cosa è cambiato, quando, e chi.

La differenza pratica emerge con più conti, più valute o investimenti, dove un foglio di calcolo a entrata singola devia silenziosamente dalla realtà. Vedi Contabilità trasparente e verificabile.

Se vuoi solo sapere quanto hai speso per il caffè, sì — un foglio di calcolo è sufficiente. La partita doppia diventa utile nel momento in cui hai più conti, un mutuo, un conto di intermediazione, o più di una valuta, perché sono esattamente le situazioni in cui il monitoraggio a entrata singola perde denaro senza che tu te ne accorga.

Un modo utile di pensarci: la partita doppia è un checksum per le tue finanze. Vedi l'Introduzione per una trattazione più lunga.

No. Fava è un'interfaccia web completa sullo stesso file di testo — bilanci, grafici, inserimento transazioni — e Beancount.io la esegue per te con il tuo registro nel cloud. Il file di testo rimane la fonte di verità, quindi puoi usare l'interfaccia web per il lavoro quotidiano e passare alla riga di comando solo quando vuoi. Se preferisci il terminale, il comando bea crea, verifica e genera report sullo stesso file — consulta la guida rapida alla CLI.

Vedi Funzionalità dell'interfaccia per cosa può fare l'interfaccia, oppure prova la demo live.

La maggior parte delle persone importa l'80–95% delle transazioni e inserisce a mano il resto. In ordine approssimativo di affidabilità: un download OFX/QFX diretto dalla tua banca, un export CSV con regole di importazione, una connessione aggregatore e — solo come ultima risorsa — un estratto conto PDF convertito in CSV. Il bank sync di Beancount.io gestisce la connessione e la categorizzazione per te.

Aspettati di scrivere o modificare una regola per ogni istituto: gli export CSV delle banche sono notoriamente incoerenti, e un nome di commerciante contenente una virgola non escaped è un problema reale e comune. Vedi Smart Import per il percorso automatizzato.

Per un file singolo, due convertitori browser gratuiti fanno la parte meccanica senza caricare nulla: CSV to Beancount per gli export da fogli di calcolo, e OFX & QIF to Beancount per i download .ofx, .qfx, .qbo e .qif che le banche offrono quando non offrono affatto CSV.

Gli importatori deduplicano rispetto alle voci già presenti nel tuo registro, confrontando data, importo e beneficiario, e segnalano qualsiasi voce ambigua per la tua conferma invece di indovinare. Il flusso di lavoro abituale segna le importazioni incerte come in sospeso così le rivedi prima che diventino parte del registro permanente.

OFX rende tutto più facile del CSV: ogni transazione ha un FITID che la banca mantiene stabile tra i download, quindi un importatore può corrispondere per identità invece che per inferenza — il convertitore OFX lo conserva come metadato id:.

L'altra metà della risposta sono i trasferimenti: il denaro che si sposta tra due conti di tua proprietà appare negli export di entrambe le banche. Registralo una sola volta come un'unica transazione con due registrazioni.

No — e per molte persone questo è proprio il motivo per usare la contabilità in testo semplice. Puoi esportare OFX o CSV dalla tua banca da solo e non consegnare mai le credenziali a un aggregatore. Se preferisci la sincronizzazione automatizzata, Beancount.io usa un aggregatore autorizzato dalla banca invece di memorizzare la tua password di online banking.

Leggi i dettagli nella pagina sulla sicurezza.

Aggiungi un'asserzione di balance per il saldo di chiusura dell'estratto conto, datata il giorno dopo la data di chiusura. Le asserzioni di saldo vengono valutate all'inizio della loro data, quindi l'asserzione del mattino successivo include tutte le transazioni fino all'ultimo giorno dell'estratto conto. Se il tuo registro non concorda con la banca, bea check segnala un errore Balance failed ed esce con codice non-zero, trasformando la riconciliazione da un confronto manuale in qualcosa che il software controlla ogni volta che viene eseguito.

Una cadenza mensile è sufficiente per la maggior parte delle persone. Vedi Filtrare e cercare per rintracciare una discrepanza.

In modo nativo, e questo è uno dei suoi maggiori vantaggi rispetto alle app di finanza personale. Ogni importo porta la sua valuta, i conti possono detenerne più di una contemporaneamente, e le conversioni sono registrate esplicitamente con @ per un prezzo o {} per un costo, quindi una variazione del tasso di cambio non riscrive mai silenziosamente la tua storia.

Nulla viene convertito alle tue spalle — vedi sempre sia la valuta originale che il valore convertito. Vedi Sintassi del linguaggio, Precisione e tolleranze, e Contabilità multi-valuta per il lato contabile.

Registra gli acquisti con un costo tra parentesi graffe — 10 AAPL {150.00 USD} — e Beancount tiene traccia di ogni lotto separatamente. Quando vendi, indichi quale lotto stai riducendo, e la plusvalenza emerge automaticamente dall'aritmetica invece di essere qualcosa che calcoli a mano.

Beancount supporta i metodi di registrazione STRICT, FIFO, LIFO e NONE. La registrazione a costo medio viene analizzata ma non è completamente implementata — se la tua giurisdizione fiscale richiede il costo medio, pianifica di tenerlo traccia con un plugin o lotti espliciti. Vedi Gestione dell'inventario.

Esattamente come qualsiasi altra merce: una criptovaluta è un'unità con un costo, quindi si applicano gli stessi meccanismi di lotto e registrazione. Uno scambio di un token con un altro è una singola transazione che riduce un lotto e ne apre un altro, ed è anche così che ottieni la plusvalenza realizzata che la maggior parte delle autorità fiscali vuole dichiarata.

Vedi Tracciamento del portafoglio di criptovalute e i modelli di criptovalute già pronti.

Le aziende lo usano, incluse società con centinaia di migliaia di transazioni. Gestisce la contabilità per competenza, strutture multi-entità e i report che un commercialista si aspetta. I limiti onesti sono che non esiste modifica concorrente multi-utente, nessuna interfaccia di fatturazione integrata e nessun flusso di approvazione per i debiti — è una contabilità, non un ERP.

Vedi Configurazioni specifiche per settore e la vetrina Open Ledger di libri contabili aziendali reali.

Tienili separati — come alberi di conti di primo livello distinti in un unico file o come due file combinati con include. Mescolarli rende il conto economico dell'azienda privo di significato e rende più difficile la dichiarazione dei redditi, e separarli non costa nulla all'inizio.

Due file sono di solito la scelta più pulita una volta che l'azienda ha il proprio conto bancario. Vedi Supporto multi-file.

Modella i crediti come un conto attività e i debiti come una passività, poi registra la fattura quando la emetti e il pagamento quando arriva — questa è la contabilità per competenza, e Beancount la supporta direttamente. Quello che non ha è un'interfaccia di fatturazione: tiene traccia di quanto ti è dovuto, non genera o invia la fattura.

Vedi Modelli di report finanziari per il lato report, Configurazioni specifiche per settore per esempi pratici, e Capire i crediti commerciali per i concetti.

Esporta i report invece del registro. Il tuo commercialista quasi certamente non vuole un file di testo — vuole un conto economico, uno stato patrimoniale e un elenco di transazioni, che puoi produrre come CSV o PDF dall'interfaccia web o con una query.

Vedi le Guide alla preparazione fiscale, Modelli di report finanziari e Query con SQL per estrarre esattamente i numeri che chiede.

Tutti e tre sono sistemi a partita doppia in testo semplice con formati di file simili. Ledger è l'originale e il parser più permissivo; hledger è una reimplementazione in Haskell nota per regole di importazione CSV amichevoli e documentazione; Beancount ha il parser più rigoroso e il supporto più forte per investimenti, lotti e più valute, oltre a un'API plugin Python.

Il rigore è il vero compromesso: Beancount rifiuta di caricare un file che trova ambiguo, il che cattura errori presto al costo di essere più pignolo. Vedi Beancount vs Ledger CLI e Beancount vs hledger.

Non nativamente — questo è un divario reale, non una funzionalità nascosta. Il budget integrato di Beancount è limitato, e le persone che vogliono un comportamento a buste rigoroso usano tipicamente un plugin della community o modellano le buste come conti.

Se il budget a buste è la cosa principale che vuoi, leggi Beancount vs YNAB prima di cambiare. Per cosa funziona oggi, vedi Budgeting in Beancount.

Sì. La direttiva document collega un file a un conto e a una data, e l'interfaccia web ti consente di caricare e sfogliare quei documenti accanto alle transazioni a cui appartengono. Le ricevute restano come file ordinari sul disco, quindi sono portabili quanto il registro stesso.

Vedi Funzionalità dell'interfaccia.

Sì — Beancount.io pubblica app per iOS e Android per visualizzare il tuo registro e catturare transazioni in movimento, che è il divario che la maggior parte delle configurazioni in testo semplice lascia aperto.

Per una cattura rapida senza app, molte persone registrano una nota approssimativa e la riconciliano nel registro più tardi.

Un decennio di finanze personali è pochi megabyte e si carica in meno di un secondo. Beancount ricalcola i saldi dall'intera cronologia delle transazioni a ogni caricamento, e questo resta veloce fino a centinaia di migliaia di voci. Oltre quel limite, il limite è il comfort di modifica e differenziazione, non il tempo di caricamento: dividere per anno con include mantiene piccoli i singoli file, ma i file inclusi formano comunque un unico registro combinato che Beancount carica e ricalcola per intero, quindi è una comodità organizzativa dei file piuttosto che un'accelerazione o un modo per tenere libri separati.

Vedi Supporto multi-file per come dividere un registro in crescita.