Configuració d'Opcions a Beancount

El comportament de Beancount es pot personalitzar mitjançant directives option col·locades a la part superior del fitxer principal del llibre major. Aquests parells clau-valor controlen tot, des dels noms dels comptes arrel fins a com es gestionen les conversions de divises. Configurar correctament aquestes opcions és essencial per adaptar Beancount a les vostres necessitats específiques. ⚙️

Opcions de Configuració Bàsiques

Aquestes opcions controlen la configuració fonamental del vostre llibre major.

Ajustaments Bàsics

Aquestes són algunes de les opcions més comunes que establireu.

option "title" "Llibre Major Personal"
option "render_commas" "TRUE"
option "plugin_processing_mode" "raw"

• title: Estableix el títol per als informes i les interfícies web.
• render_commas: Si és TRUE, els números als informes es formataran amb separadors de milers (p. ex., 1,000,000.00).
• plugin_processing_mode: Controla com es carreguen els connectors (plugins). raw carrega només els connectors que especifiqueu explícitament, mentre que default inclou un conjunt estàndard de connectors útils.

Personalització del Nom del Compte

Podeu canviar el nom dels cinc tipus de compte fonamentals de Beancount. Això és purament cosmètic i canvia la manera com apareixen als informes.

option "name_assets" "Actius"
option "name_liabilities" "Passius"
option "name_equity" "Patrimoni"
option "name_income" "Ingressos"
option "name_expenses" "Despeses"

Configuració del Compte de Patrimoni

Beancount crea automàticament diversos comptes de patrimoni especials per gestionar els saldos inicials i els càlculs d'ingressos. Podeu especificar noms personalitzats per a aquests comptes.

option "account_previous_balances" "Saldos-Inicials"
option "account_previous_earnings" "Beneficis:Anteriors"
option "account_current_earnings" "Beneficis:Actuals"
option "account_previous_conversions" "Conversions:Anteriors"
option "account_current_conversions" "Conversions:Actuals"
option "account_rounding" "Arrodoniment"

• account_previous_balances: El compte utilitzat per injectar saldos inicials al vostre llibre major.
• account_current_earnings: El compte que acumula tots els ingressos i les despeses totals del període actual, calculant efectivament el vostre benefici net.
• account_rounding: El compte on es registren les petites discrepàncies de l'arrodoniment automatitzat.

Ajustaments de Precisió i Tolerància

Aquestes opcions controlen com Beancount gestiona l'arrodoniment i els petits desequilibris en les transaccions.

Configuració de Tolerància Predeterminada

Beancount pot inferir automàticament una tolerància per a les transaccions amb múltiples divises o costos, permetent petites diferències d'arrodoniment sense causar errors.

option "inferred_tolerance_default" "USD:0.01"
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

• inferred_tolerance_default: Estableix la tolerància predeterminada per a una divisa determinada. Podeu utilitzar *:0.5 per establir un valor predeterminat per a totes les divises.
• inferred_tolerance_multiplier: Un factor aplicat a la tolerància per proporcionar un marge d'error lleugerament més gran.
• infer_tolerance_from_cost: Si és True, la tolerància s'inferirà del nombre de dígits del cost.

Mètode de Registre

Aquesta opció defineix com Beancount gestiona les transaccions on s'infereix una part.

option "booking_method" "SIMPLE"

• SIMPLE: Permet que només es pugui equilibrar automàticament un commodity per transacció. Aquest és el mètode recomanat i més comú.
• FULL: Permet equilibrar múltiples commodities, que és un mètode més complex i rarament necessari.

Gestió de Divises

Una configuració adequada de la moneda és vital per a una informació precisa.

Divisa Operativa

Podeu declarar una o més "divises operatives". Aquestes són les divises principals en què feu transaccions i que voleu veure als informes.

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

Declarar divises operatives indica a Beancount que creï columnes dedicades per a elles als informes, cosa que facilita veure la vostra posició financera en les vostres divises més utilitzades. Establir conversion_currency a NOTHING desactiva la columna de conversió automàtica, que sovint es prefereix per obtenir informes més nets.

Gestió de Documents

Beancount pot enllaçar transaccions a fitxers externs com ara rebuts o factures. L'opció documents especifica la carpeta o les carpetes arrel on s'emmagatzemen aquests fitxers.

option "documents" "/path/to/documents/archive"

Requisits:

• Els fitxers han de tenir el nom en el format AAAA-MM-DD.descripció.ext (p. ex., 2025-07-28.amazon-order.pdf).
• Podeu especificar diverses opcions documents per a diferents carpetes.
• Els camins poden ser absoluts o relatius al fitxer principal del llibre major.

Sistema de Connectors (Plugins)

La funcionalitat de Beancount es pot ampliar amb connectors.

Configuració de Connectors

Podeu habilitar un connector especificant la ruta del mòdul.

option "plugin" "beancount.plugins.module_name"

Com s'ha esmentat anteriorment, l'opció plugin_processing_mode controla si Beancount carrega només els connectors especificats (raw) o també un conjunt predeterminat (default).

Límits i Restriccions Tècniques

Aquestes opcions controlen els aspectes tècnics de l'analitzador de Beancount.

Gestió de Cadenes de Caràcters

Podeu establir un límit al nombre de línies permeses en una cadena de caràcters de diverses línies per evitar errors d'anàlisi.

option "long_string_maxlines" "64"

Funcions Experimentals

Beancount de vegades inclou funcions experimentals que podeu habilitar amb una opció. Per exemple, per habilitar la sintaxi de tolerància explícita:

option "experiment_explicit_tolerances" "True"

Això us permet especificar la tolerància directament en una publicació de transaccions, com ara: 532.23 ~ 0.001 USD.

Controls del Comportament del Sistema

Aquestes opcions serveixen per mantenir la compatibilitat o comportaments específics del sistema.

Suport Legacy

Aquesta opció habilita els valors de tolerància antics i fixos per a la compatibilitat amb versions anteriors amb llibres majors antics.

option "use_legacy_fixed_tolerances" "True"

Les toleràncies legacy fixes eren:

• Directives Balance/Pad: 0.015 unitats
• Transaccions: 0.005 unitats

Configuració Recomanada ✅

Per a la majoria d'usuaris, la configuració següent proporciona un punt de partida sòlid i sensat.

Configuració Bàsica

option "title" "Llibre Major Personal"
option "operating_currency" "USD"  // Canvieu-ho a la vostra divisa principal
option "documents" "/home/user/Documents/beancount" // Canvieu-ho a la ruta dels vostres documents
option "render_commas" "TRUE"

Control de Precisió

option "inferred_tolerance_default" "USD:0.01" // Canvieu-ho a la vostra divisa principal
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

Estructura de Comptes

option "account_previous_balances" "Patrimoni:Saldos-Inicials"
option "account_current_earnings" "Patrimoni:Beneficis-Actuals"
option "account_rounding" "Despeses:Arrodoniment"

Aquesta configuració proporciona una base sòlida per a un nou llibre major de Beancount, assegurant una informació clara, un control de precisió sensat i una estructura lògica del compte de patrimoni.