2 publicacions etiquetades amb "ledger"

Si el teu llibre major viu en text pla, el tancament de final de mes pot ser tant ràpid com auditable.
El procés no ha de ser una carrera frenètica entre fulls de càlcul i calculadores.
Aquesta guia destil·la un procés net i repetible adaptat a Beancount i la seva interfície web, Fava, construït al voltant d'assegurances de saldo, imports intel·ligents i comprovacions lleugeres.

Aquí tens la llista de verificació per a un tancament sense problemes:

1. Recull els extractes i importa totes les transaccions en brut.
2. Normalitza els beneficiaris, descripcions i metadades.
3. Conciliació de cada compte de caixa, banc i crèdit amb les assegurances balance.
4. Verifica les transferències i moviments entre comptes.
5. Actualitza els preus de les inversions i verifica les valoracions.
6. Adjunta o enllaça documents (rebuts, factures) al teu llibre major.
7. Executa consultes i quadres de comandament per a P&L i comprovacions de variància.
8. Registra acumulacions i ajustos segons calgui.
9. Valida el llibre major amb comprovacions automàtiques.
10. Confirma, etiqueta i arxiva el mes.

1. Set the Ground Rules (and Reuse Them)​

Un tancament coherent comença amb una base estable. El teu Pla de Comptes i les opcions clau de Beancount haurien d'estar declarades centralment i canviar-se rarament. Opcions com operating_currency i la gestió de documents asseguren que els teus informes i imports es comportin de manera previsible cada vegada.

Consell: Tracta el teu fitxer d'opcions com a "infraestructura". Canviar-lo pot modificar com es calculen els teus números. Versiona'l amb cura a Git.

2. Import Everything—Then Never Hand-Type It Again​

Automatitzar la importació de dades és l'acceleració més gran per tancar els teus llibres. Utilitza les poderoses eines d'importació de Beancount i els importadors construïts per la comunitat per obtenir fluxos bancaris, fitxers CSV/OFX de targetes de crèdit, dades de corretges i informes de nòmines.

L'objectiu és una importació d'una sola comanda que generi assentaments equilibrats que només cal revisar i confirmar. Això elimina l'entrada manual de dades, la principal font d'errors i retards.

3. Normalize Payees and Metadata Up Front​

Les dades netes són dades fiables. Estandarditza els teus beneficiaris, narracions i etiquetes durant el procés d'importació perquè les teves cerques, regles i informes siguin precisos mes a mes.

El sistema de connectors de Beancount et permet afegir transformacions i validacions lleugeres mentre es carreguen els teus fitxers. Això és perfecte per imposar comprovacions de consistència personalitzades o utilitzar el connector integrat noduplicates per marcar transaccions repetides abans que es converteixin en un problema.

4. Reconcile with balance Assertions​

Per a cada compte que té un extracte (comptes corrents, d'estalvi, targetes de crèdit), utilitza la directiva balance de Beancount per assegurar el saldo de tancament. Aquesta línia senzilla converteix la conciliació d'una comprovació manual a una prova precisa i automatitzada.

; Asserts the balance is exactly 1234.56 at the start of the day
2025-09-01 balance Assets:Bank:Checking   1234.56 USD

Com que els saldos es comproven al començament del dia, és més fàcil utilitzar el primer dia del mes següent per a un extracte de final de mes. Si el saldo calculat per Beancount no coincideix amb la teva assegurança, obtindràs un error precís i una data per iniciar la investigació. Sempre corregeix primer la font de la veritat (les teves transaccions); no "forcis" una conciliació.

5. Tie Out Inter-Account Transfers​

Assegura't que cada transferència aparegui a ambdues cares de la transacció. Un pagament del teu compte corrent a la teva targeta de crèdit, per exemple, hauria d'aparèixer en ambdós comptes. Les transferències desalineades són una font comuna de mals de cap en la conciliació.

Utilitza la directiva pad només per establir saldos d'obertura històrics quan configures un compte per primera vegada. És una eina de configuració, no una ajuda per a la conciliació per arreglar diferències de final de mes.

6. Verify Positions and Prices for Investments​

Per obtenir una visió precisa del teu patrimoni net, necessites valors de mercat actualitzats per a les teves inversions i monedes estrangeres. Utilitza la directiva price de Beancount per registrar aquests valors a la data de tancament.

2025-08-31 price VTI  290.14 USD
2025-08-31 price EUR    1.11 USD

Moltes eines poden obtenir aquests preus automàticament. Després d'actualitzar-los, torna a executar el teu balanç o els informes de patrimoni net per veure els canvis de valoració.

7. Attach Receipts and Source Documents​

Mantén una pista d'auditoria neta enllaçant les transaccions amb els seus documents d'origen. Utilitza l'opció documents al teu fitxer principal de Beancount per apuntar al teu arxiu de rebuts i factures.

option "documents" "/path/to/receipts"

Si anomenes els teus fitxers per data (p. ex., 2025-08-13.vendor.receipt.pdf), Beancount i Fava poden descobrir-los i enllaçar-los automàticament, facilitant la recuperació d'un rebut per a qualsevol transacció amb un sol clic.

8. Review the Month with Fava and BQL​

Un bucle de retroalimentació ràpid és crític. Utilitza Fava per inspeccionar visualment les teves finances. Els seus gràfics i informes són perfectes per desglossar despeses per categoria, comprovar tendències d'ingressos i detectar anomalies d'un cop d'ull.

Per a comprovacions més precises, utilitza el Beancount Query Language (BQL). Aquesta consulta, per exemple, et dóna una classificació detallada de totes les despeses d'agost de 2025:

SELECT account, SUM(position) AS total
FROM postings
WHERE date >= DATE '2025-08-01' AND date < DATE '2025-09-01'
GROUP BY account
ORDER BY total DESC;

8. Post Accruals and Adjustments​

Si utilitzes comptabilitat d'acumulació, registra els teus ajustos de final de mes com a transaccions explícites i datades. Això pot incloure despeses acumulades (com una factura de serveis que encara no has rebut), amortització de despeses prepagades o reconeixement d'ingressos. Mantén-les simples i ben documentades en la narració perquè siguin fàcils d'entendre en revisions futures.

10. Validate, Tag, and Archive​

Abans de finalitzar el mes, executa una comprovació final d'integritat estructural:

beancount -f myfile.beancount

Aquesta ordre detectarà desequilibris, referències a comptes que no has obert i altres errors comuns. Corregeix tot el que assenyal·li.

Un cop tot estigui correcte, confirma els teus canvis al control de versions (com Git) amb un missatge clar i una etiqueta, com ara close-2025-08. Finalment, arxiva els teus extractes bancaris i considera el mes bloquejat.

A Simple Close Script You Can Adapt​

Pots automatitzar la majoria d'aquests passos amb un script de shell senzill. Això converteix el teu tancament en una única comanda repetible.

#!/usr/bin/env bash
# Example close script
beancount -f myfile.beancount
# ... rest of the script unchanged ...

Why This Works​

Aquest procés és ràpid i fiable perquè es basa en alguns principis bàsics:

• Assegurances, no inspecció visual: La directiva balance converteix la conciliació en una comprovació precisa i automatitzada.
• Entrades deterministes: Els importadors automàtics i les metadades normalitzades fan que el teu llibre major sigui reproduïble i coherent.
• Dades explorables: Fava i BQL ofereixen eines potents per validar resultats i aprofundir en valors atípics instantàniament.
• Canvis auditables: Els ajustos són entrades de diari en text pla, cosa que els fa fàcils de revisar i entendre mesos o anys després.

Un bon tancament de final de mes és principalment logística. Amb Beancount, pots convertir-lo en un ritual curt i scriptable: importar, assegurar, preus, consultar i confirmar. Mantén el flux de treball estable i el teu tancament seguirà sent ràpid, fins i tot quan la teva vida financera es torni més complexa.

Escollir un sistema de comptabilitat personal implica compromisos entre el rendiment, l'arquitectura de dades i l'extensibilitat. Per als enginyers i altres usuaris tècnics, l'elecció sovint es redueix a quin sistema proporciona la base més robusta, predictible i programable.

A partir d'un informe comparatiu detallat, analitzem les especificacions tècniques de Beancount enfront dels seus homòlegs de codi obert populars: Ledger-CLI, hledger i GnuCash.

Velocitat i rendiment: Benchmarks quantitatius 🚀​

Per a qualsevol conjunt de dades seriós, el rendiment no és negociable. Beancount està dissenyat per gestionar dècades de dades transaccionals sense comprometre la velocitat. Tot i estar implementat en Python (v2), el seu analitzador sintàctic altament optimitzat és notablement eficient.

• Beancount: L'ús en el món real demostra que pot carregar i processar llibres majors amb cents de milers de transaccions en aproximadament 2 segons. L'ús de memòria és modest; l'anàlisi de ~100.000 transaccions converteix el text font en objectes a la memòria utilitzant només desenes de megabytes de RAM.
• La prova d'estrès d'1 milió de transaccions: Un punt de referència que utilitza un llibre major sintètic d'1 milió de transaccions, 1.000 comptes i 1 milió d'entrades de preus va revelar diferències arquitectòniques significatives:
  • hledger (Haskell): Va completar amb èxit una anàlisi i un informe complets en ~80,2 segons, processant ~12.465 transaccions/seg mentre utilitzava ~2,58 GB de RAM.
  • Ledger-CLI (C++): El procés es va finalitzar després de 40 minuts sense completar-se, probablement a causa d'una regressió coneguda que provoca un ús excessiu de memòria i CPU amb llibres majors molt complexos.
  • Beancount: Tot i que no s'inclou en aquesta prova específica d'1 milió, la seva corba de rendiment suggereix que gestionaria la tasca de manera eficient. A més, el proper Beancount v3, amb el seu nou nucli C++ i API Python, s'espera que ofereixi una altra millora d'ordre de magnitud en el rendiment.
• GnuCash (C/Scheme): Com a aplicació GUI que carrega tot el seu conjunt de dades a la memòria, el rendiment es degrada notablement amb la mida. Un fitxer XML de ~50 MB (que representa més de 100.000 transaccions) va trigar 77 segons a obrir-se. Canviar al backend SQLite només va millorar marginalment això a ~55 segons.

Conclusió: Beancount proporciona un rendiment excepcional que s'escala de manera predictible, una característica crucial per a la gestió de dades a llarg termini. Evita els penya-segats de rendiment que es veuen a Ledger i la latència lligada a la interfície d'usuari de GnuCash.

Arquitectura de dades: Text pla vs. Bases de dades opaques 📄​

La manera com un sistema emmagatzema les vostres dades dicta la seva transparència, portabilitat i durabilitat. Beancount utilitza un format de text pla net i llegible per humans que és superior per als usuaris tècnics.

• Compacte i eficient: Un fitxer Beancount de 100.000 transaccions només té ~8,8 MB. Això és més compacte que el fitxer Ledger equivalent (~10 MB) en part perquè la sintaxi de Beancount permet la inferència de l'import final de saldo en una transacció, reduint la redundància.
• Estructuralment aplicat: Beancount exigeix directives explícites YYYY-MM-DD\ open\ Account. Aquest enfocament disciplinat evita que els errors tipogràfics en el nom del compte creïn silenciosament comptes nous i incorrectes, un error comú en sistemes com Ledger i hledger que creen comptes sobre la marxa. Aquesta estructura fa que les dades siguin més fiables per a la manipulació programàtica.
• Preparat per al control de versions: Un llibre major de text pla és perfectament adequat per al control de versions amb Git. Obteniu un historial complet i auditable de cada canvi financer que feu.
• Contrast amb GnuCash: GnuCash utilitza per defecte un fitxer XML comprimit amb gzip, on les dades són detallades i embolicades en etiquetes amb GUID per a cada entitat. Tot i que ofereix backends SQLite, MySQL i PostgreSQL, això abstrau les dades de la manipulació i el control de versions de text simple i directe. L'edició del XML en brut és possible però molt més feixuga que l'edició d'un fitxer Beancount.

Conclusió: El format de dades de Beancount no és només text; és un llenguatge ben definit que maximitza la claredat, aplica la correcció i s'integra perfectament amb eines de desenvolupador com git i grep.

La característica estrella: Una API Python real i una arquitectura de complements 🐍​

Aquest és l'avantatge tècnic que defineix Beancount. No és una aplicació monolítica, sinó una biblioteca amb una API Python estable i de primera classe. Aquesta decisió de disseny obre possibilitats il·limitades d'automatització i integració.

• Accés programàtic directe: Podeu llegir, consultar i manipular les dades del vostre llibre major directament a Python. És per això que els desenvolupadors migren. Com va assenyalar un usuari, la frustració d'intentar crear scripts contra els enllaços interns mal documentats de Ledger s'evapora amb Beancount.
• Pipeline de complements: El carregador de Beancount us permet inserir funcions Python personalitzades directament a la canonada de processament. Això permet transformacions i validacions arbitràries al flux de dades a mesura que es carrega; per exemple, escriure un complement per fer complir que cada despesa d'un proveïdor específic ha de tenir una determinada etiqueta.
• Marc d'importació potent: Aneu més enllà dels assistents d'importació CSV maldestres. Amb Beancount, escriviu scripts Python per analitzar els estats financers de qualsevol font (OFX, QFX, CSV). Eines comunitàries com smart_importer fins i tot aprofiten els models d'aprenentatge automàtic per predir i assignar comptes de registre automàticament, convertint hores de categorització manual en un procés d'un segon i una sola ordre.
• Com es comparen els altres:
  • Ledger/hledger: L'extensibilitat és principalment externa. Canalitzeu dades cap a/des de l'executable. Tot i que poden generar JSON/CSV, no podeu injectar lògica al seu bucle de processament central sense modificar el codi font C++/Haskell.
  • GnuCash: L'extensibilitat es gestiona a través d'una corba d'aprenentatge pronunciada amb Guile (Scheme) per a informes personalitzats o a través d'enllaços Python (utilitzant SWIG i biblioteques com PieCash) que interactuen amb el motor GnuCash. És potent però menys directe i "pitònic" que l'enfocament de biblioteca nativa de Beancount.

Conclusió: Beancount està dissenyat per al programador. El seu disseny de biblioteca primer i la seva profunda integració amb Python el converteixen en el sistema més flexible i automatitzable dels quatre.

Filosofia: Un compilador estricte per a les vostres finances 🤓​

La corba d'aprenentatge de Beancount és un resultat directe de la seva filosofia bàsica: les vostres dades financeres són un llenguatge formal i han de ser correctes.

L'analitzador sintàctic de Beancount funciona com un compilador estricte. Realitza una validació sintàctica i lògica robusta. Si una transacció no quadra o no s'ha obert un compte, es negarà a processar el fitxer i retornarà un error descriptiu amb un número de línia. Això és una característica, no un error. Garanteix que si el vostre fitxer "es compila", les dades subjacents són estructuralment sòlides.

Aquest enfocament determinista garanteix un nivell d'integritat de dades que és invaluable per construir sistemes automatitzats fiables a sobre. Podeu escriure scripts que consumeixin la sortida de Beancount amb confiança, sabent que les dades ja han estat rigorosament validades.

Per a qui és Beancount?​

Basant-nos en aquesta anàlisi tècnica, Beancount és l'opció òptima per a:

• Desenvolupadors i enginyers que volen tractar les seves finances com un conjunt de dades programable i controlat per versions.
• Manipuladors de dades que volen escriure consultes personalitzades, crear visualitzacions úniques amb eines com Fava o alimentar les seves dades financeres a altres models analítics.
• Qualsevol persona que valori la correcció i l'automatització demostrables per sobre de la comoditat d'una GUI o la indulgència d'un format menys estructurat.

Si desitgeu un rendiment C++ en brut per a informes estàndard, Ledger és un competidor. Per a una escalabilitat excepcional en un paradigma de programació funcional, hledger és impressionant. Per a una GUI plena de funcions amb una configuració mínima, GnuCash destaca.

Però si voleu construir un sistema de gestió financera realment robust, automatitzat i profundament personalitzat, Beancount proporciona la base tècnica superior.