# 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](https://beancount.io/ca/docs/Basics/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](https://beancount.io/ca/docs/Tips/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.

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

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

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

```beancount
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](https://beancount.io/ca/docs/Tips/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](https://beancount.io/ca/docs/Tips/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.

```beancount
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.

```beancount
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](https://beancount.io/ca/docs/Tips/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](https://beancount.io/ca/docs/Basics/precision) 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.

```beancount
2026-06-30 price VTI   271.40 USD
```

[Live Prices](https://beancount.io/ca/docs/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](https://beancount.io/ca/docs/Tips/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.

```beancount
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](https://beancount.io/ca/docs/help-center) indexa totes les guies
d'aquest lloc, i el [Cheatsheet](https://beancount.io/ca/docs/Basics/cheatsheet) posa la sintaxi de cada directiva
costat per costat.
