Salta al contenuto principale
FAQ Beancount: Domande di Contabilità in Testo Semplice

FAQ Beancount: Domande di Contabilità in Testo Semplice

Risposte alle domande che le persone fanno realmente sulla contabilità in testo semplice con Beancount — importare transazioni bancarie, addebiti e accrediti, multivaluta, costo base, libri contabili aziendali e come Beancount si confronta con Ledger e hledger.

Le domande che seguono provengono dalla comunità della contabilità in testo semplice — Reddit, Hacker News, la mailing list di Beancount — e riguardano il funzionamento pratico. Per domande sul servizio Beancount.io stesso (prezzi, piani, supporto, gestione account), consultare le FAQ sul prodotto.

Per iniziare

Quanta contabilità devo conoscere prima di iniziare?

Circa cinque concetti, non una laurea. Servono i cinque tipi di conto (attività, passività, patrimonio netto, entrate, uscite), l'idea che ogni transazione sposti valore tra almeno due di essi e la regola che una transazione deve bilanciarsi. Beancount applica il resto per te — si rifiuta di caricare un file le cui transazioni non si sommano, quindi il software intercetta gli errori che un principiante farebbe altrimenti in silenzio.

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

Dove sono gli addebiti e gli accrediti in Beancount?

Beancount non usa affatto le parole "addebito" e "accredito" — utilizza numeri con segno che devono sommare a zero. Il denaro che esce da un conto è negativo, il denaro che arriva è positivo, e una transazione è valida quando le sue registrazioni si annullano a vicenda. Questa è la stessa contabilità a partita doppia che fanno i contabili, ma con il vocabolario che confonde i principianti rimosso.

Se hai usato software di contabilità tradizionale, la traduzione è: un addebito è un numero positivo e un accredito è un numero negativo. Consulta il riferimento Sintassi del Linguaggio per come si scrivono le registrazioni, oppure Addebiti e Accrediti Spiegati per il background contabile in parole semplici.

Perché le transazioni devono bilanciarsi a zero?

Perché il denaro proviene sempre da qualche parte, e il gioco a somma zero trasforma questo fatto in un controllo degli errori. Se spendi 40 € in generi alimentari, quel denaro è uscito da un conto bancario — registrare entrambe le metà significa che le due devono annullarsi, e qualsiasi errore di battitura in uno dei due importi fa sì che il file non venga caricato invece di produrre silenziosamente un saldo errato.

Questo è il motivo per cui 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 controlla il tuo registro rispetto alla realtà.

Come imposto i miei saldi di apertura?

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

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

Quanto dettagliato dovrebbe essere il mio piano dei conti?

Inizia con poche voci e suddividi solo quando una suddivisione più fine cambierebbe una decisione. Una ventina di conti sono sufficienti per iniziare; se ti ritrovi a chiederti se "Uscite:Cibo" debba separare la spesa al supermercato dai ristoranti, il test utile è se cambieresti effettivamente qualcosa sapendo la suddivisione.

Rinominare e suddividere in seguito è un'operazione di trova-e-sostituisci in un file di testo, quindi il costo di iniziare in modo semplice è basso. I nomi dei conti sono annidabili, così puoi iniziare con una categoria ampia e suddividerla in sottoconti in seguito senza riscrivere la storia — consulta Come Progettare un Piano dei Conti se vuoi una struttura da copiare.

Perché testo semplice?

Perché usare la contabilità in testo semplice invece di un foglio di calcolo?

Un foglio di calcolo non può dirti quando è sbagliato. La contabilità in testo semplice impone la partita doppia, quindi ogni transazione si autocontrolla e il file rimane ricercabile, 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 perché.

La differenza pratica si manifesta con più conti, valute o investimenti, dove un foglio di calcolo a partita semplice si allontana silenziosamente dalla verità. Consulta Contabilità Trasparente e Revisionabile.

La contabilità a partita doppia non è eccessiva per le finanze personali?

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

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

Devo usare la riga di comando?

No. Fava è un'interfaccia web completa sullo stesso file di testo — bilanci, conti economici, grafici e inserimento transazioni — e Beancount.io la esegue per te con il tuo registro nel cloud. Il file di testo rimane la fonte della verità, quindi puoi usare l'interfaccia web giorno per giorno e passare al terminale solo quando vuoi.

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

Importare i tuoi dati

Come importo le mie transazioni bancarie in Beancount?

La maggior parte delle persone importa l'80–95% delle transazioni e inserisce manualmente il resto. In ordine approssimativo di affidabilità: un download OFX/QFX diretto dalla tua banca, un'esportazione CSV con regole di importazione, una connessione 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 bancarie sono notoriamente incoerenti e un nome di commerciante contenente una virgola non escaped è un problema reale e comune. Consulta Importazione Intelligente per il percorso automatizzato.

Come evito di importare la stessa transazione due volte?

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

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

Devo dare a terzi il mio login bancario?

No — e per molti questo è 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 automatica, Beancount.io utilizza un aggregatore autorizzato dalla banca anziché memorizzare la tua password bancaria online.

Leggi i dettagli sulla pagina della sicurezza.

Come riconcilio il mio registro con l'estratto conto bancario?

Aggiungi un'asserzione balance con il saldo di chiusura e la data dell'estratto conto. Beancount si rifiuterà di caricare il file se il tuo registro non corrisponde alla banca, il che trasforma la riconciliazione da un confronto manuale a qualcosa che il software controlla ogni volta che viene eseguito.

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

Valute e investimenti

Come gestisce Beancount più valute?

Nativamente, e questo è uno dei suoi vantaggi più forti rispetto alle app finanziarie per consumatori. Ogni importo porta la sua valuta, i conti possono contenerne 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. Consulta Sintassi del Linguaggio, Precisione e Tolleranze e Contabilità Multivaluta per l'aspetto contabile.

Come traccio il costo base e le plusvalenze?

Registra gli acquisti con un costo tra parentesi graffe — 10 AAPL {150.00 USD} — e Beancount traccia ogni lotto separatamente. Quando vendi, specifichi 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 del costo medio è analizzata ma non completamente implementata — se la tua giurisdizione fiscale richiede il costo medio, pianifica di tracciarlo con un plugin o lotti espliciti. Consulta Gestione dell'Inventario.

Come registro le operazioni in criptovaluta e il loro costo base?

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 per un altro è una singola transazione che riduce un lotto e ne apre un altro, che è anche il modo per ottenere la plusvalenza realizzata che la maggior parte delle autorità fiscali richiede sia dichiarata.

Consulta Tracciamento del Portafoglio Criptovalute e i modelli di criptovaluta già pronti.

Libri contabili aziendali e freelance

Posso usare Beancount per una piccola impresa o è solo per le finanze personali?

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 incorporata e nessun flusso di lavoro di approvazione dei debiti verso fornitori — è un registro, non un ERP.

Consulta Configurazioni Settoriali Specifiche e la vetrina Registro Aperto di libri contabili aziendali reali.

Dovrei tenere registri separati per personale e azienda?

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

Due file sono solitamente la scelta più pulita una volta che l'azienda ha il proprio conto bancario. Consulta Supporto Multi-File.

Come gestisco fatture e crediti verso clienti?

Modella i crediti come un conto di attività e i debiti come un conto di 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: traccia ciò che ti è dovuto, non genera o invia la fattura.

Consulta Modelli di Reportistica Finanziaria per l'aspetto dei report, Configurazioni Settoriali Specifiche per esempi pratici e Comprendere i Crediti Commerciali per i concetti.

Come consegno i miei libri contabili al commercialista in periodo fiscale?

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

Consulta le Guide alla Preparazione Fiscale, i Modelli di Reportistica Finanziaria e Interrogare con SQL per estrarre esattamente i numeri richiesti.

Strumenti ed ecosistema

In cosa differiscono Beancount, Ledger e hledger?

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 le sue amichevoli regole di importazione CSV e la 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 si rifiuta di caricare un file che trova ambiguo, il che intercetta errori precocemente al costo di essere più pignolo. Consulta Beancount vs Ledger CLI e Beancount vs hledger.

Beancount fa il budget con metodo delle buste come YNAB?

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

Se il budget con metodo delle buste è la cosa principale che vuoi, leggi Beancount vs YNAB prima di passare. Per cosa funziona oggi, consulta Gestione del Budget in Beancount.

Posso allegare ricevute alle transazioni?

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

Consulta Funzionalità dell'Interfaccia.

Esiste un'app mobile?

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.

Quanto grande può diventare un registro prima di rallentare?

Un decennio di finanze personali è di pochi megabyte e si carica in ben meno di un secondo. Beancount ricalcola i saldi dall'intera cronologia delle transazioni a ogni caricamento, e questo rimane veloce fino a centinaia di migliaia di voci; oltre, suddividere per anno con include mantiene tutto comodo.

Consulta Supporto Multi-File per come suddividere un registro in crescita.

Ancora bloccato?

Il Centro di Assistenza indicizza l'intera documentazione e il Glossario definisce qualsiasi termine sopra che non fosse familiare.