La comptabilitat en text net manlleva vocabulari de la comptabilitat de doble entrada i afegeix un grapat de paraules pròpies específiques 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 indicar directament a un company una definició.
Compte
Un compte és una categoria amb nom que fa el seguiment d'un flux de valor, escrit com una jerarquia separada per dos punts sota un dels cinc tipus d'arrel: Assets, Liabilities, Equity, Income o Expenses. La jerarquia és l'estructura organitzativa completa dels vostres llibres: Assets:US:BofA:Checking i Expenses:Food:Restaurant s'ordenen i s'agreguen automàticament. Cada compte s'ha de declarar abans d'utilitzar-lo. Vegeu Sintaxi del llenguatge Beancount per a les regles de nomenclatura.
Base de meritació
La comptabilitat de meritació registra els ingressos quan es guanyen i les despeses quan s'incorren, independentment de quan es mogui 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, per això una factura que vau enviar al març pertany al març fins i tot si el client paga al maig.
Amortització
L'amortització reparteix un únic pagament gran entre els períodes que cobreix realment, de manera que cada mes assumeix 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é escriviu els assentaments dividits a mà o bé els genereu amb un connector: vegeu Amortitzar.
Comprovació de saldo
Una comprovació de saldo és una directriu 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 converteix en una verificació automàtica dels vostres llibres. Si el saldo calculat difereix més que la tolerància de la comprovació, Beancount falla amb un missatge clar mostrant els imports esperat i real. Aquesta tolerància és una unitat de l'últim decimal que heu escrit: 4.27 RGAGX accepta qualsevol valor entre 4.26 i 4.28, i un ~ abans de la divisa estableix la vostra pròpia. Afegir una comprovació per compte i per extracte és la manera més econòmica de mantenir un llibre major fiable.
2026-01-01 balance Assets:US:BofA:Checking 4,321.00 USDBeancount
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 consultes i una interfície web, sense base de dades ni format de fitxer propietari. Com que el llibre major és text, viu feliçment a Git al costat del vostre codi. Comenceu amb Introducció a Beancount.
Llenguatge de consultes Beancount
El llenguatge de consultes Beancount, habitualment abreujat BQL, és el llenguatge semblant a SQL que feu servir per fer preguntes al vostre llibre major. S'executa sobre les directrius 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 consultes 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 extreure. Beancount 3.2.3 accepta set noms: STRICT (el predeterminat, on identifiqueu vosaltres mateixos el lot), STRICT_WITH_SIZE, NONE, FIFO, LIFO, HIFO i AVERAGE. Establiu-ne un per compte a la directriu open, o per a tot el fitxer amb option "booking_method". Sis dels set estan implementats: AVERAGE s'analitza, però genera l'error AVERAGE method is not supported en el moment que ha de reservar una reducció. El mètode que trieu canvia els vostres guanys de capital realitzats, per tant trieu el que espera la vostra jurisdicció fiscal i manteniu-lo estable. Gestió d'inventaris executa els 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 dels comptes que utilitza el vostre llibre major, juntament amb l'estructura que els organitza. A Beancount no hi ha cap fitxer de pla separat: el conjunt de directrius open és el vostre pla de comptes. Dissenyar-lo bé al principi estalvia molts reanomenaments posteriors; vegeu Configuracions específiques per indústria per a punts de partida.
Directriu close
Una directriu 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 amortitzat sense esborrar-ne l'historial. Les transaccions passades continuen sent vàlides i reportables; només es rebutgen els assentaments nous. Tancar comptes no utilitzats manté els informes llegibles a mesura que un llibre major envelleix.
2026-03-31 close Assets:US:OldBank:CheckingCommodity
Una commodity és qualsevol unitat de valor que el vostre llibre major segueix: una divisa com USD, un símbol borsari com AAPL, un actiu criptogràfic com BTC o alguna cosa que inventeu com VACATION-DAYS. Beancount mai converteix entre commodities darrere vostre, de manera que un import és sempre un número aparellat amb la commodity en què està denominat. Una directriu 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 divisa amb què vau pagar i transportat al costat de la participació durant tot el temps que la teniu. Beancount ho escriu entre claus: 10 AAPL {150.00 USD} significa deu accions adquirides a 150 dòlars cadascuna. Dobleu les claus i el número 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 viatja amb la posició, els guanys de capital surten de l'aritmètica quan veneu. Vegeu Gestió d'inventaris.
Directriu
Una directriu és una instrucció en un fitxer Beancount, normalment datada, i les directrius són el que compon un llibre major. Dotze tipus porten data: open, close, balance, price, note, document, pad, event, commodity, custom, query i la pròpia transacció. Uns quants no porten data i actuen sobre el fitxer en lloc d'un dia: option, include, plugin i el parell pushtag/poptag. Beancount ordena les datades per data abans de processar, de manera que podeu mantenir-les en l'ordre que millor es llegeixi; una sense data té efecte on està escrita.
Comptabilitat de doble entrada
La comptabilitat de doble entrada és la pràctica de registrar cada esdeveniment econòmic com a mínim com a 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, per això la tècnica detecta errors que una llista d'una sola columna mai no detectaria. Un pes és l'import propi d'un assentament, o el seu cost o preu convertit de nou a una divisa, de manera que dues potes en commodities diferents encara es cancel·len. Beancount aplica la regla estrictament: una transacció els assentaments 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 USDPressupost per sobres
El pressupost per sobres reserva diners per a un propòsit abans de gastar-los, de manera que cada categoria té el seu propi límit en lloc de competir per un saldo combinat. El nom prové dels sobres de paper que la gent omplia amb efectiu el dia de cobrament. En un llibre major de text net modeleu els sobres amb comptes dedicats o directrius 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 la seva pròpia eina; la guia Funcions de la interfície cobreix què hi podeu fer.
Inventari
Un inventari és la col·lecció de posicions que un compte manté 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 corredoria que va comprar la mateixa acció tres vegades manté tres lots separats en un sol inventari, no un número combinat. 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 cru 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 del 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 per a una entitat, que a Beancount significa el vostre fitxer de text net (més qualsevol cosa que inclogui). La paraula serveix tant per al nom del llibre complet de comptes com per al nom del mateix fitxer. Com que és text, un llibre major es pot diferenciar, 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 més tard implica 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 USDNarració
La narració és la descripció en text lliure de per a què servia una transacció, escrita com la 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 d'aquí a sis mesos.
Directriu open
Una directriu open declara un compte, la data en què comença a ser utilitzable i, opcionalment, les commodities que pot contenir i el mètode de reserva que utilitza. Beancount requereix que cada compte s'obri abans del seu primer assentament, que és el que evita que un error tipogràfic creï silenciosament un compte nou. 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 directriu pad indica a Beancount que insereixi la quantitat que calgui per fer que la següent comprovació de saldo en un compte tingui èxit, reservant 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'historial. Utilitzar pad 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 la primera cadena entre cometes a una línia de transacció. Mantenir els beneficiaris coherents — 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 opcional; una transacció pot portar només una narració.
Comptabilitat en text net
La comptabilitat en 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 codi obert de línia d'ordres. 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 directrius 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. N'activeu un amb una línia plugin independent a la part superior del vostre llibre major, mai amb una option: option "plugin" "…" es rebutja amb Option 'plugin' may not be set. La guia Connector de previsió recorre un exemple real.
Assentament
Un assentament és una pota d'una transacció: un compte, un import i, opcionalment, un cost o preu. El que ha de sumar zero en una transacció no són els imports bruts sinó els seus pesos: un import simple 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 assentament pot deixar el seu import en blanc, en aquest cas Beancount calcula la xifra d'equilibri per a vosaltres. Vegeu Precisió i toleràncies per a les regles completes de pesos.
Directriu price
Una directriu price registra el tipus de canvi entre dues commodities en una data, que és com Beancount converteix una participació al seu valor de mercat en els informes. Una directriu price és purament dades de referència: no mou diners i no pertany a cap transacció. No la confongueu amb el preu @ escrit dins d'un assentament, 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 directrius price, una cartera continua quadrant al cost però no es pot valorar a mercat.
2026-06-30 price VTI 271.40 USDConciliació
La conciliació és l'acte de demostrar que els vostres llibres coincideixen amb un registre extern com un extracte bancari o de corredoria. En comptabilitat en text net és en gran part mecànica: afegiu una comprovació 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 etiquetes 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". Ambdós són filtrables a Fava i consultables a BQL: vegeu Filtrar i cercar.
Transacció
Una transacció és un esdeveniment econòmic datat juntament amb els assentaments que el registren, i és la directriu que escriureu més sovint. Porta una marca (* per confirmada, ! per revisar), un beneficiari opcional, una narració i dos o més assentaments els pesos dels quals sumen zero. Tota la resta 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 USDEncara encallat amb una paraula? El Centre d'ajuda indexa totes les guies d'aquest lloc, i la Fulla de referència posa la sintaxi de cada directriu costat per costat.