Glossari

La comptabilitat de text net pren vocabulari de la comptabilitat de doble entrada i hi afegeix un grapat de paraules pròpies de Beancount. Aquest glossari defineix els termes que trobareu mentre llegiu aquesta documentació o el vostre propi fitxer de llibre major, cadascun amb un exemple breu quan ajuda. Cada entrada té el seu propi enllaç, perquè pugueu assenyalar directament una definició a un company.

Compte​

Un compte és un contenidor amb nom que segueix un flux de valor, escrit com una jerarquia separada per dos punts sota un de cinc tipus arrel: Assets, Liabilities, Equity, Income o Expenses. La jerarquia és tota l'estructura organitzativa dels vostres llibres — Assets:US:BofA:Checking i Expenses:Food:Restaurant s'ordenen i es resumeixen automàticament. Cada compte s'ha de declarar abans de ser utilitzat. Vegeu Sintaxi del llenguatge Beancount per a les regles de nomenclatura.

Base meritada​

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

Amortització​

L'amortització distribueix un únic pagament gran al llarg dels períodes que realment cobreix, de manera que cada mes suporti 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 escriviu els assentaments dividits a mà o els genereu amb un connector — vegeu Amortitzar.

Verificació de saldo​

Una verificació 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 vostre extracte bancari es converteixi en una comprovació automàtica dels vostres llibres. Si el saldo calculat difereix, Beancount falla amb estrepit mostrant les quantitats esperada i real. Escampar una verificació per compte i 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 doble entrada de codi obert el llibre major del qual és un fitxer de text net que editeu en qualsevol editor de text i valideu amb una eina de línia d'ordres. Us 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, viu feliç a Git juntament amb el vostre codi. Comenceu amb Introducció a Beancount.

Llenguatge de consulta Beancount​

El llenguatge de consulta Beancount, normalment abreujat BQL, és el llenguatge semblant a SQL que feu servir per fer preguntes al vostre 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 des del mateix fitxer que editeu. Llegiu la guia del llenguatge de consulta per a la gramàtica completa.

Mètode de reserva​

Un mètode de reserva és la regla que aplica Beancount quan una reducció ha de triar quins lots existents cal reduir. Les opcions són STRICT (heu d'identificar el lot vosaltres mateixos), FIFO, LIFO, AVERAGE i NONE, configurades per compte a la seva directiva open. El mètode que trieu canvia els vostres guanys de capital realitzats, així que escolliu el que la vostra jurisdicció fiscal espera i manteniu-lo estable.

Pla de comptes​

Un pla de comptes és la llista completa de comptes que fa servir el vostre 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 vostre pla de comptes. Dissenyar-lo bé des del principi estalvia molt de canviar noms més tard; vegeu Configuracions específiques per indústria per a punts de partida.

Directiva close​

Una directiva close marca la data després de la qual un compte ja no es pot utilitzar, que és com jubileu un compte bancari o un préstec pagat sense esborrar-ne la història. Les transaccions passades continuen sent vàlides i informables; només es rebutgen els assentaments nous. Tancar comptes no utilitzats manté els informes llegibles a mesura que el llibre major envelleix.

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

Mercaderia​

Una mercaderia és qualsevol unitat de valor que el vostre llibre major segueix — una moneda com USD, un ticker d'accions com AAPL, un actiu cripto com BTC, o alguna cosa que inventeu com VACATION-DAYS. Beancount mai converteix entre mercaderies darrere la vostra esquena, de manera que una quantitat sempre és un nombre aparellat amb la mercaderia en què es denomina. Una directiva commodity opcional us permet adjuntar metadades com un nom o una classe d'actiu.

Base de cost​

La base de cost és el que realment vau pagar per una participació, registrat en la moneda amb què vau pagar i transportat al costat de la participació mentre la poseeixeu. Beancount l'escriu entre claus — 10 AAPL {150.00 USD} significa deu accions adquirides a 150 dòlars cadascuna. Com que la base viatja amb la posició, els guanys de capital surten de l'aritmètica quan veneu. Vegeu Gestió d'inventaris.

Directiva​

Una directiva és una instrucció datada en un fitxer Beancount, i les directives són tot el que conté un llibre major. Cada línia que comença amb una data n'és una: open, close, balance, price, note, document, pad, event, commodity i la transacció mateixa. Beancount ordena les directives per data abans de processar-les, de manera que les podeu mantenir en l'ordre que millor es llegeixi.

Comptabilitat de doble entrada​

La comptabilitat de doble entrada és la pràctica de registrar cada esdeveniment econòmic com a mínim amb dues entrades coincidents, de manera que les quantitats sempre sumin zero. Els diners mai es creen ni es destrueixen — només es mouen entre comptes, per això la tècnica detecta errors que una llista d'una sola columna mai detectaria. Beancount aplica la regla estrictament: una transacció els assentaments de la qual no quadren és un error, no un avís.

Pressupost per sobres​

El pressupost per sobres reserva diners per a un propòsit abans de gastar-los, de manera que cada categoria tingui el seu propi límit en lloc de competir per un saldo agrupat. El nom ve dels sobres de paper que la gent omplia amb efectiu el dia de la paga. En un llibre major de text net modeleu els sobres amb comptes dedicats o directives de pressupost — vegeu Pressupostos.

Fava​

Fava és la interfície web per a Beancount: gràfics, balanços de situació, comptes de resultats, un editor de consultes i un formulari d'entrada, servits des del vostre fitxer de llibre major. És principalment de lectura i s'executa localment, de manera que canvia com veieu els vostres llibres sense canviar com els registreu. beancount.io allotja una versió gestionada juntament amb les seves pròpies eines; la guia de Funcions de la interfície d'usuari cobreix què hi podeu fer.

Inventari​

Un inventari és la col·lecció de posicions que un compte té actualment, cadascuna amb la seva pròpia mercaderia i, quan és rellevant, la seva pròpia base de cost i data d'adquisició. Un compte de corredoria que va comprar la mateixa acció tres vegades manté tres lots separats en un inventari, no un nombre barrejat. Mantenir els lots distints és el que fa possibles càlculs precisos de guanys.

Diari​

El diari és la llista cronològica de tot el que ha passat als vostres llibres — el flux brut de transaccions, en ordre de data, abans de qualsevol agrupació o resum. És la vista que escanegeu quan voleu 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 vostre fitxer de text net (més qualsevol cosa que inclogui). La paraula serveix tant com a nom de tot el llibre de comptes com a nom del fitxer mateix. Com que és text, un llibre major es pot comparar, revisar, bifurcar i fusionar com a codi font.

Lot​

Un lot és una adquisició específica d'una mercaderia, 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 més tard significa triar quin lot veneu. 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ó en text lliure de per a què era una transacció, escrita com a segona cadena entre cometes a la línia de transacció. És per a humans: "Lloguer mensual", "Queviures i llar". Beancount no la analitza, però és el que llegireu quan l'entrada ja no tingui sentit sis mesos més endavant.

Directiva open​

Una directiva open declara un compte, la data en què comença a ser utilitzable i, opcionalment, les mercaderies que pot contenir i el mètode de reserva que fa servir. Beancount requereix que cada compte s'obri abans del seu primer assentament, que és el que impedeix que un error de mecanografia creï silenciosament un compte nou. Restringir les mercaderies permeses converteix tota una altra classe d'errors en errors.

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

Pad​

Una directiva pad diu a Beancount que insereixi la quantitat que calgui per fer que la següent verificació de saldo en un compte tingui èxit, imputant la diferència a un segon compte. Existeix per a exactament una feina: obrir un llibre major a mig camí de la vida sense reconstruir anys d'història. Fer padding més enllà d'aquesta configuració inicial sol significar que s'està amagant un error real.

Beneficiari​

El beneficiari és amb qui vau fer la transacció, escrit com a primera cadena entre cometes en una línia de transacció. Mantenir els beneficiaris coherents — sempre "Whole Foods", mai de vegades "WholeFoods" — és el que fa que funcionin 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 de text net​

La comptabilitat de text net és la pràctica de mantenir els vostres 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 fer clic per durabilitat, auditabilitat i automatització: les vostres dades sobreviuen a qualsevol proveïdor, cada canvi és una diferència 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 Python que Beancount carrega mentre processa el vostre fitxer, que li permet 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 nucli. N'activeu un amb una línia plugin a la part superior del vostre llibre major — la guia del Connector de previsió recorre un exemple real.

Assentament​

Un assentament és una pota d'una transacció: un compte, una quantitat i, opcionalment, un cost o preu. Una transacció necessita com a mínim dos assentaments, i les seves quantitats han de sumar zero. Com a màxim un assentament pot deixar la seva quantitat en blanc, en aquest cas Beancount calcula la xifra d'equilibri per a vosaltres.

Directiva price​

Una directiva price registra el tipus de canvi entre dues mercaderies en una data, que és com Beancount converteix una participació al seu valor de mercat en els informes. Els preus són dades de referència pures — mai mouen diners i mai apareixen en una transacció. Sense ells, una cartera encara quadra al cost, però no es pot valorar a mercat.

2026-06-30 price VTI   271.40 USD

Conciliació​

La conciliació és l'acte de demostrar que els vostres llibres coincideixen amb un registre extern com un extracte bancari o de corredoria. En la comptabilitat de text net és en gran part mecànica: afegiu una verificació de saldo per a cada data d'extracte i deixeu que l'eina us digui si els números coincideixen. Un llibre major que es concilia netament cada mes és un del qual podeu presentar impostos sense por.

Etiquetes i enllaços​

Les etiquetes i els enllaços són les dues marques que adjunteu 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 ^ uneix entrades relacionades com ^invoice-2026-014. Les etiquetes responen "mostra'm tot en aquesta categoria"; els enllaços responen "mostra'm les entrades que pertanyen a aquest esdeveniment únic". Totes dues són filtrables a Fava i consultables a BQL — vegeu Filtratge i cerca.

Transacció​

Una transacció és un esdeveniment econòmic datat juntament amb els assentaments que el registren, i és la directiva que escriureu més sovint. Porta una marca (* per confirmada, ! per revisar), un beneficiari opcional, una narració i dos o més assentaments les quantitats dels quals sumen zero. Tot el demés en un fitxer 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 Centre d'ajuda indexa totes les guies d'aquest lloc, i la Xinxa posa la sintaxi de cada directiva una al costat de l'altra.