# FAQ di Beancount: Domande sulla contabilità in testo semplice

Le domande seguenti provengono dalla comunità della contabilità in testo semplice — Reddit, Hacker News,
la mailing list di Beancount — e riguardano come funziona la *pratica*. Per domande sul
servizio Beancount.io stesso (prezzi, piani, supporto, gestione dell'account), consulta le
[FAQ sul prodotto](/faq).

## Per iniziare

### Quanta contabilità devo conoscere prima di iniziare?

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](https://beancount.io/it/docs/introduction-to-beancount), tieni il
[Glossario](https://beancount.io/it/docs/glossary) aperto in una scheda, e aggiungi le tue prime transazioni nella
[Guida Rapida](https://beancount.io/it/docs/Basics/getting-started).

### Dove sono gli addebiti e gli accrediti in Beancount?

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](https://beancount.io/it/docs/Basics/syntax)
per come si scrivono le scritture, oppure
[Dare e Avere Spiegati](/blog/2026/04/08/debits-and-credits-explained-a-plain-english-guide-for-small-business-owners)
per il contesto contabile in parole semplici.

### Perché le transazioni devono bilanciare a zero?

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à.

### Come configuro i saldi iniziali?

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](https://beancount.io/it/docs/Basics/getting-started) illustra un esempio completo di saldo
di apertura.

### Quanto deve essere dettagliato il mio piano dei conti?

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](/blog/2026/03/16/how-to-design-chart-of-accounts-small-business-guide)
se vuoi una struttura da copiare.

## Perché il 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 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](https://beancount.io/it/docs/Solutions/transparent-and-auditable).

### La partita doppia è 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
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](https://beancount.io/it/docs/introduction-to-beancount) per la motivazione più estesa.

### Devo usare la riga di comando?

No. [Fava](/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](https://beancount.io/it/docs/Basics/bea-cli).

Consulta [Funzionalità dell'Interfaccia](https://beancount.io/it/docs/Tips/ui-features) per cosa può fare l'interfaccia, oppure
[prova la demo dal vivo](/demo).

## Inserire i tuoi dati

### Come inserisco le 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 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](/bank-sync) 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
[Smart Import](/smart-import) per il percorso automatizzato.

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

### Come evito di importare la stessa transazione due volte?

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](/tools/ofx-to-beancount) 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.

### Devo dare a terzi le credenziali della mia banca?

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](/security).

### Come riconcilio il mio registro con l'estratto conto della banca?

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](https://beancount.io/it/docs/Tips/filtering-and-searching) per rintracciare una
discrepanza.

## Valute e investimenti

### Come gestisce Beancount più valute?

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](https://beancount.io/it/docs/Basics/syntax),
[Precisione e Tolleranze](https://beancount.io/it/docs/Basics/precision) e
[Contabilità Multi-Valuta](/blog/2026/03/19/multi-currency-accounting-guide-small-business-international)
per il lato contabile.

### Come mantengo aggiornati i prezzi di valutazione?

Usa [Prezzi dal Vivo](https://beancount.io/it/docs/live-prices) 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.

### Come traccio il costo medio e le plusvalenze?

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](https://beancount.io/it/docs/Basics/inventories).

### Come registro le transazioni in criptovalute e il loro costo medio?

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](https://beancount.io/it/docs/Solutions/cryptocurrency-portfolio-tracking) e
i [modelli per criptovalute](https://beancount.io/it/docs/Tips/cryptocurrency-templates-examples) già pronti.

## Libri contabili aziendali e freelance

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

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](https://beancount.io/it/docs/industry-specific-setups) e la
vetrina [Registro Aperto](/open-ledger) dei libri contabili reali di aziende.

### Dovrei tenere registri separati per personale e azienda?

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](https://beancount.io/it/docs/Tips/multi-file-support).

### Come gestisco fatture e crediti commerciali?

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](https://beancount.io/it/docs/financial-reporting-templates) per il lato dei report,
[Configurazioni Specifiche per Settore](https://beancount.io/it/docs/industry-specific-setups) per esempi pratici, e
[Comprendere i Crediti](/blog/2025/08/12/understanding-accounts-receivable)
per i concetti.

### Come consegno i miei libri al commercialista a fine anno?

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](https://beancount.io/it/docs/tax-prep-guides),
[Modelli di Rendicontazione Finanziaria](https://beancount.io/it/docs/financial-reporting-templates) e
[Query con SQL](https://beancount.io/it/docs/Basics/beancount-query-language) per estrarre esattamente i numeri che ti chiedono.

## Strumenti ed ecosistema

### Come differiscono Beancount, Ledger e hledger?

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](/compare/beancount-vs-ledger-cli) e
[Beancount vs hledger](/compare/beancount-vs-hledger).

### Beancount fa il budget a buste come YNAB?

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](/compare/beancount-vs-ynab) prima di cambiare. Per
ciò che funziona oggi, consulta [Budgeting in Beancount](https://beancount.io/it/docs/Tips/budgets).

### Posso allegare ricevute alle transazioni?

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](https://beancount.io/it/docs/Tips/ui-features).

### Esiste un'app mobile?

Sì — Beancount.io pubblica app per [iOS](/beancount-ios) e
[Android](/beancount-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 può diventare grande un registro prima di rallentare?

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](https://beancount.io/it/docs/Tips/multi-file-support) per come dividere un registro che cresce.

## Sei ancora bloccato?

Il [Centro Assistenza](https://beancount.io/it/docs/help-center) indicizza la documentazione completa, e il
[Glossario](https://beancount.io/it/docs/glossary) definisce qualsiasi termine sopra che non ti fosse familiare.
