Configurazione delle Opzioni

Il comportamento di Beancount può essere personalizzato utilizzando le direttive option posizionate all'inizio del tuo file di registro principale. Queste coppie chiave-valore controllano tutto, dai nomi dei tuoi conti principali a come vengono gestite le conversioni di valuta. Configurare correttamente queste opzioni è essenziale per adattare Beancount alle tue esigenze specifiche. ⚙️

Opzioni di Configurazione Principali​

Queste opzioni controllano l'impostazione fondamentale del tuo registro.

Impostazioni di Base​

Queste sono alcune delle opzioni più comuni che imposterai.

option "title" "Registro Personale"
option "render_commas" "TRUE"
option "plugin_processing_mode" "raw"

• title: Imposta il titolo per report e interfacce web.
• render_commas: Se TRUE, i numeri nei report saranno formattati con i separatori delle migliaia (es., 1.000.000,00).
• plugin_processing_mode: Controlla come vengono caricati i plugin. raw carica solo i plugin che specifichi esplicitamente, mentre default include un set standard di plugin utili.

Personalizzazione dei Nomi dei Conti​

Puoi rinominare i cinque tipi fondamentali di conti di Beancount. Questo è puramente estetico e ne modifica l'aspetto nei report.

option "name_assets" "Attività"
option "name_liabilities" "Passività"
option "name_equity" "Patrimonio Netto"
option "name_income" "Redditi"
option "name_expenses" "Spese"

Configurazione dei Conti di Patrimonio Netto​

Beancount crea automaticamente diversi conti speciali di patrimonio netto per gestire i saldi di apertura e il calcolo dei redditi. Puoi specificare nomi personalizzati per questi conti.

option "account_previous_balances" "Saldi-Apertura"
option "account_previous_earnings" "Utili:Precedenti"
option "account_current_earnings" "Utili:Correnti"
option "account_previous_conversions" "Conversioni:Precedenti"
option "account_current_conversions" "Conversioni:Correnti"
option "account_rounding" "Arrotondamento"

• account_previous_balances: Il conto utilizzato per iniettare i saldi di apertura nel tuo registro.
• account_current_earnings: Il conto che accumula tutti i totali di redditi e spese per il periodo corrente, calcolando di fatto il tuo reddito netto.
• account_rounding: Il conto in cui vengono registrate piccole discrepanze derivanti da arrotondamenti automatici.

Impostazioni di Precisione e Tolleranza​

Queste opzioni controllano come Beancount gestisce arrotondamenti e piccoli squilibri nelle transazioni.

Configurazione della Tolleranza Predefinita​

Beancount può dedurre automaticamente una tolleranza per transazioni con più valute o costi, consentendo piccole differenze di arrotondamento senza causare errori.

option "inferred_tolerance_default" "USD:0,01"
option "inferred_tolerance_multiplier" "1,1"
option "infer_tolerance_from_cost" "True"

• inferred_tolerance_default: Imposta la tolleranza predefinita per una data valuta. Puoi usare *:0,5 per impostare un valore predefinito per tutte le valute.
• inferred_tolerance_multiplier: Un fattore applicato alla tolleranza per fornire un margine di errore leggermente più ampio.
• infer_tolerance_from_cost: Se True, la tolleranza verrà dedotta dal numero di cifre nel costo.

Metodo di Registrazione​

Questa opzione definisce come Beancount gestisce le transazioni in cui una gamba è dedotta.

option "booking_method" "SIMPLE"

• SIMPLE: Consente di bilanciare automaticamente solo una merce per transazione. Questo è il metodo raccomandato e più comune.
• FULL: Consente di bilanciare più merci, un metodo più complesso e raramente necessario.

Gestione delle Valute​

Una corretta configurazione delle valute è fondamentale per report accurati.

Valuta Operativa​

Puoi dichiarare una o più "valute operative". Queste sono le valute principali con cui effettui transazioni e che desideri vedere nei report.

option "operating_currency" "USD"
option "operating_currency" "EUR"
option "conversion_currency" "NOTHING"

Dichiarare le valute operative indica a Beancount di creare colonne dedicate nei report, rendendo facile vedere la tua posizione finanziaria nelle valute più utilizzate. Impostando conversion_currency su NOTHING si disabilita la colonna di conversione automatica, spesso preferita per report più puliti.

Gestione dei Documenti​

Beancount può collegare transazioni a file esterni come ricevute o fatture. L'opzione documents specifica le cartelle principali in cui sono archiviati questi file.

option "documents" "/percorso/archivio/documenti"

Requisiti:

• I file devono essere nominati usando il formato AAAA-MM-GG.descrizione.est (es., 2025-07-28.amazon-order.pdf).
• Puoi specificare più opzioni documents per cartelle diverse.
• I percorsi possono essere assoluti o relativi al file di registro principale.

Sistema di Plugin​

Le funzionalità di Beancount possono essere estese con plugin.

Configurazione dei Plugin​

Abiliti un plugin specificandone il percorso del modulo.

option "plugin" "beancount.plugins.nome_modulo"

Come accennato in precedenza, l'opzione plugin_processing_mode controlla se Beancount carica solo i plugin specificati (raw) o anche un set predefinito (default).

Limiti e Vincoli Tecnici​

Queste opzioni controllano gli aspetti tecnici del parser di Beancount.

Gestione delle Stringhe​

Puoi impostare un limite al numero di righe consentite in una stringa multilinea per prevenire errori di parsing.

option "long_string_maxlines" "64"

Funzionalità Sperimentali​

Beancount a volte include funzionalità sperimentali che puoi abilitare con un'opzione. Ad esempio, per abilitare la sintassi esplicita delle tolleranze:

option "experiment_explicit_tolerances" "True"

Questo ti permette di specificare la tolleranza direttamente in una registrazione di transazione, come: 532,23 ~ 0,001 USD.

Controlli del Comportamento di Sistema​

Queste opzioni servono per mantenere la compatibilità o comportamenti di sistema specifici.

Supporto Legacy​

Questa opzione abilita i vecchi valori di tolleranza fissi per compatibilità con registri più vecchi.

option "use_legacy_fixed_tolerances" "True"

Le tolleranze fisse legacy erano:

• Direttive Balance/Pad: 0,015 unità
• Transazioni: 0,005 unità

Configurazione Raccomandata ✅​

Per la maggior parte degli utenti, la seguente configurazione fornisce un punto di partenza robusto e sensato.

Impostazione di Base​

option "title" "Registro Personale"
option "operating_currency" "USD"  // Cambia con la tua valuta principale
option "documents" "/home/utente/Documenti/beancount" // Cambia con il tuo percorso documenti
option "render_commas" "TRUE"

Controllo della Precisione​

option "inferred_tolerance_default" "USD:0,01" // Cambia con la tua valuta principale
option "inferred_tolerance_multiplier" "1,1"
option "infer_tolerance_from_cost" "True"

Struttura dei Conti​

option "account_previous_balances" "Patrimonio-Netto:Saldi-Apertura"
option "account_current_earnings" "Patrimonio-Netto:Utili-Correnti"
option "account_rounding" "Spese:Arrotondamento"

Questa configurazione fornisce una solida base per un nuovo registro Beancount, garantendo report chiari, un controllo sensato della precisione e una struttura logica dei conti di patrimonio netto.