Glossari de Beancount i comptabilitat en text pla

La comptabilitat de text pla manlleva vocabulari de la partida doble i hi afegeix un grapat de paraules pròpies de Beancount. Aquest glossari defineix els termes que trobaràs mentre llegeixes aquesta documentació o el teu propi fitxer de llibre major, cadascun amb un exemple breu quan ajuda. Cada entrada té el seu propi enllaç, de manera que pots dirigir un company directament a una definició.

Compte​

Un compte és una caixa amb nom que fa el seguiment d'un flux de valor, escrit com una jerarquia separada per dos punts sota un dels cinc tipus arrel: Assets, Liabilities, Equity, Income o Expenses. La jerarquia és tota l'estructura organitzativa dels teus llibres — Assets:US:BofA:Checking i Expenses:Food:Restaurant s'ordenen i s'agrupen automàticament. Cada compte s'ha de declarar abans d'usar-lo. Consulta Beancount Language Syntax per a les regles de nomenclatura.

Base de meritació​

La comptabilitat de meritació registra els ingressos quan es guanyen i les despeses quan es contreuen, independentment de quan es mou realment l'efectiu. La comptabilitat de caixa fa el contrari: reconeix tots dos només quan els diners canvien de mans. La meritació ofereix una imatge més fidel del rendiment d'un període, i és per això que una factura que vas enviar al març pertany al març encara que el client pagui al maig.

Amortització​

L'amortització reparteix un sol pagament gran entre els períodes que realment cobreix, de manera que cada mes suporta la seva part justa del cost. Una prima d'assegurança anual pagada al gener és una despesa de tots dotze mesos, no només del gener. A Beancount, o bé escrius els apunts dividits a mà o bé els generes amb un connector — consulta Amortize.

Comprovació de saldo​

Una asserció de saldo és una directiva balance que estableix quin ha de ser el saldo d'un compte a l'inici d'una data determinada, de manera que el teu extracte bancari es converteix en una comprovació automàtica dels teus llibres. Si el saldo calculat difereix més que la tolerància de l'asserció, Beancount falla sorollosament amb els imports esperats i reals. Aquesta tolerància és una unitat de l'última xifra decimal que has escrit — 4.27 RGAGX accepta qualsevol valor entre 4,26 i 4,28 — i un ~ davant de la divisa estableix la teva pròpia. Escampar una asserció per compte i per extracte és la manera més barata de mantenir un llibre major fiable.

2026-01-01 balance Assets:US:BofA:Checking   4,321.00 USD

Beancount​

Beancount és un sistema de comptabilitat de partida doble de codi obert el llibre major del qual és un fitxer de text pla que edites amb qualsevol editor de text i validas amb una eina de línia d'ordres. Ofereix una sintaxi estricta i analitzable, un llenguatge de consulta i una interfície web, sense base de dades ni format de fitxer propietari. Com que el llibre major és text, conviu feliçment a Git al costat del teu codi. Comença amb Introduction to Beancount.

Llenguatge de consultes Beancount​

Beancount Query Language, normalment abreujat BQL, és el llenguatge similar a SQL que fas servir per fer preguntes al teu llibre major. S'executa sobre les directives analitzades en lloc d'una base de dades, de manera que SELECT account, sum(position) WHERE year = 2026 respon immediatament a partir del mateix fitxer que edites. Llegeix la guia del llenguatge de consulta per a la gramàtica completa.

Mètode de reserva​

Un mètode d'assignació és la regla que Beancount aplica quan una reducció ha de triar quines lots existents consumir. Beancount 3.2.3 accepta set noms: STRICT (el predeterminat, en què identifiques tu mateix el lot), STRICT_WITH_SIZE, NONE, FIFO, LIFO, HIFO i AVERAGE. Estableix-ne un per compte a la seva directiva open, o per a tot el fitxer amb option "booking_method". Sis dels set estan implementats: AVERAGE s'analitza, però genera AVERAGE method is not supported en el moment que ha d'assignar una reducció. El mètode que triïs canvia els teus guanys de capital realitzats, així que tria el que espera la teva jurisdicció fiscal i mantén-lo estable. Inventory Management executa tots set sobre els mateixos lots, i publica el llibre major que falla amb AVERAGE.

Pla de comptes​

Un pla de comptes és la llista completa de comptes que utilitza el teu llibre major, juntament amb l'estructura que els organitza. A Beancount no hi ha cap fitxer de pla separat — el conjunt de directives open és el teu pla de comptes. Dissenyar-lo bé des del principi estalvia moltes reanomenades després; consulta Industry-Specific Setups per a punts de partida.

Directriu close​

Una directiva close marca la data a partir de la qual un compte ja no es pot utilitzar, que és com retires un compte bancari o un préstec pagat sense esborrar-ne l'historial. Les transaccions passades continuen sent vàlides i reportables; només es rebutgen els apunts nous. Tancar els comptes no utilitzats manté els informes llegibles a mesura que un llibre major envelleix.

2026-03-31 close Assets:US:OldBank:Checking

Commodity​

Una commodity és qualsevol unitat de valor que el teu llibre major fa el seguiment — una divisa com USD, un tíquer borsari com AAPL, un actiu criptogràfic com BTC, o una cosa que t'inventis com VACATION-DAYS. Beancount mai converteix entre commodities a la teva esquena, de manera que un import sempre és un nombre aparellat amb la commodity en què està denominat. Una directiva commodity opcional et permet adjuntar metadades com un nom o una classe d'actiu.

Base de cost​

La base de cost és el que realment vas pagar per una participació, registrat en la divisa amb què vas pagar i arrossegat juntament amb la participació mentre la posseeixis. Beancount l'escriu entre claus — 10 AAPL {150.00 USD} significa deu accions adquirides a 150 dòlars cadascuna. Dobla les claus i el nombre es converteix en el total en lloc del preu unitari, de manera que 10 AAPL {{1,500.00 USD}} registra el mateix lot. Com que la base acompanya la posició, els guanys de capital surten de l'aritmètica quan venes. Consulta Inventory Management.

Directriu​

Una directiva és una instrucció en un fitxer de Beancount, normalment datada, i les directives són allò de què està fet un llibre major. Dotze tipus porten data: open, close, balance, price, note, document, pad, event, commodity, custom, query i la transacció mateixa. Unes quantes no en porten i actuen sobre el fitxer en lloc d'un dia — option, include, plugin i la parella pushtag/poptag. Beancount ordena les datades per data abans de processar-les, de manera que pots mantenir-les en l'ordre que es llegeixi millor; una sense data té efecte allà on està escrita.

Comptabilitat de doble entrada​

La partida doble és la pràctica de registrar cada esdeveniment econòmic com a mínim com dues entrades coincidents, de manera que els seus pesos sempre sumin zero. Els diners no es creen ni es destrueixen mai — només es mouen entre comptes, i és per això que la tècnica detecta errors que una llista d'una sola columna mai no detectaria. Un pes és l'import propi d'un apunt, o el seu cost o preu convertit de nou en una sola divisa, de manera que dues potes en commodities diferents encara es cancel·len. Beancount aplica la regla estrictament: una transacció els apunts de la qual no quadren és un error, no un avís.

2026-03-02 * "Bank" "Buy euros"
  Assets:US:BofA:EUR       100.00 EUR @ 1.08 USD
  Assets:US:BofA:Checking -108.00 USD

Pressupost per sobres​

El pressupost per sobres reserva diners per a una finalitat abans que els gastis, de manera que cada categoria té el seu propi límit en lloc de competir per un sol saldo compartit. El nom prové dels sobres de paper que la gent omplia amb efectiu el dia de paga. En un llibre major de text pla modeles els sobres amb comptes dedicats o directives de pressupost — consulta Budgets.

Fava​

Fava és la interfície web per a Beancount: gràfics, balanços, comptes de resultats, un editor de consultes i un formulari d'entrada, servits des del teu fitxer de llibre major. És principalment de lectura i s'executa localment, de manera que canvia com veus els teus llibres sense canviar com els registres. beancount.io allotja una versió gestionada al costat de les seves pròpies eines; la guia UI Features cobreix què hi pots fer.

Inventari​

Un inventari és el conjunt de posicions que un compte té actualment, cadascuna amb la seva pròpia commodity i, quan és rellevant, la seva pròpia base de cost i data d'adquisició. Un compte de corretatge que ha comprat la mateixa acció tres vegades té tres lots separats en un inventari, no un sol nombre combinat. Mantenir els lots diferenciats és el que fa possible càlculs precisos de guanys.

Diari​

El diari és la llista cronològica de tot el que ha passat als teus llibres — el flux brut de transaccions, en ordre de data, abans de qualsevol agrupació o resum. És la vista que repasses quan vols respondre "què vaig fer realment al març?". La pàgina de diari de Fava sol ser el lloc més ràpid per detectar una entrada mal categoritzada.

Llibre major​

Un llibre major és el conjunt complet de registres comptables d'una entitat, que a Beancount significa el teu fitxer de text pla (més tot el que inclou). La paraula també serveix com a nom del llibre de comptes sencer i com a nom del fitxer mateix. Com que és text, un llibre major es pot comparar, revisar, ramificar i fusionar com el codi font.

Lot​

Un lot és una adquisició específica d'una commodity, identificada per la seva base de cost i data d'adquisició. Comprar el mateix ETF al gener i de nou al juny crea dos lots, i vendre després significa triar quin lot estàs venent. Els lots són la raó per la qual Beancount pot calcular els guanys realitzats exactament en lloc d'aproximar-los.

2026-06-15 * "Broker" "Buy VTI"
  Assets:US:Broker:VTI     5 VTI {260.00 USD, 2026-06-15}
  Assets:US:Broker:Cash            -1,300.00 USD

Narració​

La narració és la descripció de text lliure de per a què servia una transacció, escrita com la segona cadena entre cometes a la línia de transacció. És per als humans: "Lloguer mensual", "Queviures i llar". Beancount no l'analitza, però és el que llegiràs quan l'entrada ja no tingui sentit d'aquí a sis mesos.

Directriu open​

Una directiva open declara un compte, la data en què comença a ser utilitzable i, opcionalment, les commodities que pot contenir i el mètode d'assignació que utilitza. Beancount requereix que cada compte s'obri abans del seu primer apunt, que és el que impedeix que una errata creï silenciosament un compte nou de trinca. Restringir les commodities permeses converteix tota una altra classe d'errors en errors.

2026-01-01 open Assets:US:Broker:VTI   VTI   "FIFO"

Pad​

Una directiva pad indica a Beancount que insereixi l'import que calgui per fer que la propera asserció de saldo d'un compte tingui èxit, registrant la diferència a un segon compte. Existeix exactament per a una feina: obrir un llibre major a mig camí de la seva vida sense reconstruir anys d'historial. Fer servir pad més enllà d'aquesta configuració inicial normalment significa que s'està tapant un error real.

Beneficiari​

El beneficiari és amb qui vas transaccionar, escrit com la primera cadena entre cometes en una línia de transacció. Mantenir els beneficiaris consistents — sempre "Whole Foods", mai de vegades "WholeFoods" — és el que fa funcionar els informes basats en beneficiaris i els importadors automatitzats. Beancount tracta el beneficiari com a opcional; una transacció pot portar només una narració.

Comptabilitat en text net​

La comptabilitat de text pla és la pràctica de mantenir els teus llibres en un fitxer de text llegible per humans sota control de versions, processat per eines de línia d'ordres de codi obert. Canvia una interfície de punta i clic per durabilitat, auditabilitat i automatització: les teves dades sobreviuen a qualsevol proveïdor, cada canvi és un diff revisable, i qualsevol script les pot llegir. Beancount, Ledger i hledger són les tres implementacions més conegudes.

Connector​

Un connector és un mòdul de Python que Beancount carrega mentre processa el teu fitxer, permetent-li afegir, transformar o validar directives abans que es construeixin els informes. Els connectors són com s'implementen la previsió, els calendaris d'amortització i les comprovacions personalitzades sense canviar el llenguatge central. Se n'activa un amb una línia plugin independent a la part superior del teu llibre major, mai amb una option — option "plugin" "…" es rebutja amb Option 'plugin' may not be set. La guia Forecast Plugin explica un exemple real.

Assentament​

Un apunt és una pota d'una transacció: un compte, un import i, opcionalment, un cost o un preu. El que ha de sumar zero en una transacció no són els imports bruts sinó els seus pesos: un import pla es pesa a si mateix, 10 FUND @ 38.46 USD pesa 384.60 USD, i 10 FUND {384.61 USD} pesa 3,846.10 USD, perquè les claus simples contenen el cost d'una unitat. Com a màxim un apunt pot deixar el seu import en blanc, cas en què Beancount calcula la xifra de compensació per tu. Consulta Precision & Tolerances per a les regles completes de pes.

Directriu price​

Una directiva price registra el tipus de canvi entre dues commodities en una data, que és com Beancount converteix una participació al seu valor de mercat als informes. Una directiva price és dades de referència pures: no mou diners i no pertany a cap transacció. No la confonguis amb el preu @ escrit dins d'un apunt, que és aritmètica — dona a 10 FUND @ 38.46 USD un pes de 384.60 USD i, per tant, decideix si la transacció quadra. Sense directives de preu, una cartera encara quadra a cost però no es pot valorar a mercat.

2026-06-30 price VTI   271.40 USD

Live Prices proporciona directives de preu gestionades per a actius admesos en llibres majors allotjats. El teu propi preu guanya per a la mateixa data i parella, incloent-hi la parella recíproca. Un preu gestionat en una data posterior encara pot aplicar-se a una valoració posterior.

Conciliació​

La conciliació és l'acte de demostrar que els teus llibres coincideixen amb un registre extern com un extracte bancari o de corretatge. En la comptabilitat de text pla és en gran part mecànica: afegeix una asserció de saldo per a cada data d'extracte i deixa que l'eina et digui si els nombres coincideixen. Un llibre major que es concilia netament cada mes és un del qual pots presentar impostos sense por.

Etiquetes i enllaços​

Les etiquetes i els enllaços són les dues etiquetes que adjuntes a les transaccions per agrupar-les fora de la jerarquia de comptes: una etiqueta amb # marca un tema com #trip-japan, i un enllaç amb ^ lliga entrades relacionades com ^invoice-2026-014. Les etiquetes responen "mostra'm tot el que hi ha en aquesta categoria"; els enllaços responen "mostra'm les entrades que pertanyen a aquest esdeveniment concret". Tots dos són filtrables a Fava i consultables en BQL — consulta Filtering and Searching.

Transacció​

Una transacció és un esdeveniment econòmic datat juntament amb els apunts que el registren, i és la directiva que escriuràs més sovint. Porta un indicador (* per confirmada, ! per necessita revisió), un beneficiari opcional, una narració i dos o més apunts els pesos dels quals sumen zero. Tota la resta d'un fitxer de Beancount existeix per declarar, comprovar o anotar transaccions.

2026-02-14 * "Blue Bottle" "Coffee with Dana"
  Expenses:Food:Coffee      9.50 USD
  Assets:US:BofA:Checking  -9.50 USD

Encara encallat amb una paraula? El Help Center indexa totes les guies d'aquest lloc, i el Cheatsheet posa la sintaxi de cada directiva costat per costat.