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 bilanciarsi. Beancount applica il resto per te — segnala come errore qualsiasi transazione i cui numeri non tornano invece di accettarla silenziosamente, così il software cattura gli errori che un principiante altrimenti non noterebbe.

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 "dare" e "avere" — usa numeri con segno che devono sommare a zero. Il denaro che esce da un conto è negativo, il denaro che entra è positivo, e una transazione è valida quando le sue scritture si annullano a vicenda. È la stessa partita doppia che fanno i contabili, con il vocabolario che confonde i principianti rimosso.

Se hai usato software di contabilità tradizionale, la traduzione è: un dare è un numero positivo e un avere è un numero negativo. Consulta il riferimento sulla Sintassi del Linguaggio per come si scrivono le scritture, oppure Dare e Avere Spiegati per il contesto contabile in parole semplici.

Perché il denaro viene sempre da qualche parte, e la somma zero è ciò che trasforma questo fatto in un controllo degli errori. Se spendi 40 $ per la spesa, quel denaro ha lasciato un conto bancario — registrare entrambe le metà significa che le due devono annullarsi, e qualsiasi errore di battitura in uno dei due importi viene segnalato come errore invece di produrre silenziosamente un saldo sbagliato.

Ecco perché un registro 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 il tuo registro rispetto alla realtà.

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

La Guida Rapida illustra un esempio completo di saldo di apertura.

Inizia grossolano e dividi solo quando una suddivisione più fine cambierebbe una decisione. Una ventina di conti è più che sufficiente per iniziare; se ti ritrovi a chiederti se "Expenses:Food" dovrebbe separare la spesa dal ristorante, il test utile è se faresti davvero qualcosa di diverso conoscendo la suddivisione.

Rinominare e dividere in seguito è un trova-e-sostituisci in un file di testo, quindi il costo di iniziare in modo semplice è basso. I nomi dei conti si annidano, così puoi iniziare con una categoria ampia e dividerla in sottoconti in seguito senza riscrivere la storia — consulta 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, così ogni transazione si autocontrolla, e il file resta ricercabile con grep, confrontabile con diff e scriptabile finché esisteranno i file di testo. Ottieni anche una vera cronologia delle versioni: git log sul tuo registro mostra esattamente cosa è cambiato, quando e perché.

La differenza pratica emerge con più conti, valute o investimenti, dove un foglio di calcolo a partita singola deriva silenziosamente dalla realtà. Consulta Contabilità Trasparente e Verificabile.

Se vuoi solo sapere quanto hai speso per il caffè, sì — un foglio di calcolo va bene. La partita doppia si ripaga nel momento in cui hai diversi conti, un mutuo, un conto titoli o più di una valuta, perché sono esattamente le situazioni in cui il monitoraggio a partita singola perde denaro senza dirtelo.

Un modo utile di pensarci: la partita doppia è un checksum per le tue finanze. Consulta l'Introduzione per la motivazione più estesa.

No. Fava è un'interfaccia web completa sullo stesso file di testo — stati patrimoniali, conti economici, grafici e inserimento delle transazioni — e Beancount.io la esegue per te con il tuo registro nel cloud. Il file di testo rimane la fonte di verità, così puoi usare l'interfaccia web quotidianamente e passare al terminale solo quando vuoi. Se preferisci davvero un terminale, il comando bea crea, verifica e genera report su quello stesso file — consulta la guida rapida alla CLI.

Consulta Funzionalità dell'Interfaccia per cosa può fare l'interfaccia, oppure prova la demo dal vivo.

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

Aspettati di scrivere o modificare una regola per istituto: le esportazioni CSV delle banche sono notoriamente incoerenti, e un nome di esercente contenente una virgola non preceduta da escape è un problema reale e comune. Consulta Importazione Intelligente per il percorso automatizzato.

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

Gli importatori deduplicano rispetto alle voci già presenti nel tuo registro, abbinando per data, importo e beneficiario, e segnalano qualsiasi cosa ambigua affinché tu la confermi invece di tirare a indovinare. Il flusso di lavoro abituale marca le importazioni incerte come pendenti così le rivedi prima che diventino parte del registro permanente.

OFX lo rende più semplice del CSV: ogni transazione porta un FITID che la banca mantiene stabile tra i download, così un importatore può abbinare per identità invece che per inferenza — il convertitore OFX lo conserva come campo di metadati id:.

L'altra metà della risposta sono i trasferimenti: il denaro che si sposta tra due conti che possiedi appare nelle esportazioni di entrambe le banche. Registralo una volta come singola transazione con due scritture.

No — e per molte persone questo è il motivo per cui usano affatto la contabilità in testo semplice. Puoi esportare tu stesso OFX o CSV dalla tua banca e non consegnare mai le credenziali a un aggregatore. Se preferisci la sincronizzazione automatica, Beancount.io usa un aggregatore autorizzato dalla banca invece di memorizzare la tua password di home banking.

Leggi i dettagli nella pagina sulla sicurezza.

Aggiungi un'asserzione balance per il saldo di chiusura dell'estratto conto, datata il giorno successivo alla data di chiusura. Le asserzioni di saldo vengono valutate all'inizio della loro data, quindi l'asserzione del mattino successivo è quella che include ogni transazione fino all'ultimo giorno dell'estratto conto. Se il tuo registro è in disaccordo con la banca, bea check segnala un errore Balance failed ed esce con codice diverso da zero, il che trasforma la riconciliazione da un confronto manuale in qualcosa che il software verifica ogni volta che viene eseguito.

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

Nativamente, e questo è uno dei suoi maggiori vantaggi rispetto alle app di finanza personale. Ogni importo porta con sé la sua valuta, i conti possono contenerne diverse contemporaneamente, e le conversioni sono registrate esplicitamente con @ per un prezzo o {} per un costo, così un cambio 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. Consulta Sintassi del Linguaggio, Precisione e Tolleranze e Contabilità Multi-Valuta per il lato contabile.

Usa Prezzi dal Vivo per gli asset supportati in un registro Beancount.io ospitato, oppure recupera le quotazioni in file di prezzi locali per Beancount e Fava upstream. Il selettore ti permette di scegliere una valuta di quotazione e copiare gli include gestiti. Anche le versioni compatibili di bea supportano gli include gestiti; la guida di configurazione rimanda alle loro istruzioni.

I prezzi gestiti influenzano la valutazione di mercato, non gli importi delle transazioni o la base di costo. Il tuo prezzo personale ha priorità per la stessa data e coppia. Gli aggiornamenti possono usare prezzi in cache obsoleti durante un'interruzione, e una quotazione successiva non può colmare una data di valutazione storica mancante.

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 scaturisce dall'aritmetica automaticamente invece di essere qualcosa che calcoli a mano.

Beancount supporta i metodi di attribuzione STRICT, FIFO, LIFO e NONE. L'attribuzione a costo medio è analizzata ma non completamente implementata — se la tua giurisdizione fiscale richiede il costo medio, pianifica di tenerne traccia con un plugin o con lotti espliciti. Consulta Gestione dell'Inventario.

Esattamente come qualsiasi altra merce: una criptovaluta è un'unità con un costo, quindi si applicano gli stessi macchinari di lotti e attribuzione. Uno scambio di un token con un altro è una singola transazione che riduce un lotto e ne apre un altro, che è anche il modo in cui ottieni la plusvalenza realizzata che la maggior parte delle autorità fiscali vuole che venga dichiarata.

Consulta Monitoraggio del Portafoglio di Criptovalute e i modelli per criptovalute già pronti.

Le imprese lo usano, incluse aziende 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 c'è modifica concorrente multiutente, nessuna interfaccia di fatturazione integrata e nessun flusso di approvazione dei conti da pagare — è un registro, non un ERP.

Consulta Configurazioni Specifiche per Settore e la vetrina Registro Aperto dei libri contabili reali di aziende.

Tienili separati — sia come alberi di conti distinti di primo livello in un unico file, sia come due file combinati con include. Mescolarli rende il conto economico dell'azienda privo di significato e rende più difficile il periodo delle imposte, e separarli non costa nulla in partenza.

Due file è di solito la scelta più pulita una volta che l'azienda ha un proprio conto bancario. Consulta Supporto Multi-File.

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

Consulta Modelli di Rendicontazione Finanziaria per il lato dei report, Configurazioni Specifiche per Settore per esempi pratici, e Comprendere i Crediti 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 delle transazioni, che puoi produrre come CSV o PDF dall'interfaccia web o con una query.

Consulta le Guide alla Preparazione Fiscale, Modelli di Rendicontazione Finanziaria e Query con SQL per estrarre esattamente i numeri che ti chiedono.

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

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

Non nativamente — questa è una vera lacuna piuttosto che una funzionalità nascosta. Il budgeting integrato di Beancount è limitato, e le persone che vogliono un comportamento rigoroso a buste tipicamente usano un plugin della comunità o modellano le buste come conti.

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

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

Consulta Funzionalità dell'Interfaccia.

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

Per una cattura rapida senza app, molte persone registrano una nota approssimativa e la riconciliano nel registro in seguito.

Un decennio di finanze personali è qualche megabyte e si carica ben sotto il 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 a ciò il limite è il comfort di modifica e diff, non il tempo di caricamento: dividere per anno con include mantiene i singoli file piccoli, ma i file inclusi formano comunque un unico registro combinato che Beancount carica e ricalcola completamente, quindi è una comodità di organizzazione dei file piuttosto che un'accelerazione o un modo per tenere libri contabili separati.

Consulta Supporto Multi-File per come dividere un registro che cresce.