5 berichten getagd met "open source"

Beancount versie 3, uitgebracht medio 2024, markeert een belangrijke architecturale evolutie voor de populaire platte-tekst boekhoudtool. Hoewel het achterwaartse compatibiliteit voor gebruikersgrootboekbestanden behoudt, hebben de onderliggende structuur en bijbehorende tools aanzienlijke veranderingen ondergaan. Hier is een overzicht van wat er nieuw is in Beancount v3.

Een Modulairdere en Gestroomlijndere Architectuur​

De meest significante verandering in Beancount v3 is de overgang naar een modulairder ecosysteem. Verschillende belangrijke functionaliteiten die voorheen gebundeld waren met de kern, zijn afgesplitst in afzonderlijke, onafhankelijke projecten. Dit maakt de kern van Beancount slanker en maakt een meer gerichte ontwikkeling van individuele componenten mogelijk.

De belangrijkste componenten die nu afzonderlijke pakketten zijn, omvatten:

• beanquery: De krachtige SQL-achtige querytool voor uw grootboekbestanden bevindt zich nu in een eigen pakket.
• beangulp: Dit is de nieuwe thuisbasis voor het data-importframework, ter vervanging van de voormalige beancount.ingest module.
• beanprice: Een speciale tool voor het ophalen van prijzen van grondstoffen en aandelen.

Deze scheiding betekent dat gebruikers deze pakketten naast beancount zelf moeten installeren om de volledige functionaliteit te behouden die ze gewend waren in versie 2.

Wijzigingen in Command-Line Tools en Workflows​

Als gevolg van de nieuwe modulaire architectuur zijn er enkele opmerkelijke wijzigingen in de command-line tools:

• bean-report is verdwenen: Deze tool is verwijderd. Gebruikers worden nu aangemoedigd om bean-query (uit het beanquery pakket) te gebruiken voor hun rapportagebehoeften.
• Nieuwe Importeer Workflow: De bean-extract en bean-identify commando's zijn verwijderd uit de kern. De nieuwe aanpak met beangulp is script-gebaseerd. Gebruikers zullen nu hun eigen Python-scripts maken om het importeren van gegevens uit externe bronnen zoals bankafschriften af te handelen.

Syntax en Functieverbeteringen​

Hoewel de kernboekhoudprincipes hetzelfde blijven, introduceert Beancount v3 enkele welkome flexibiliteit in de syntax:

• Flexibelere Valutacodes: De eerdere beperkingen op de lengte en tekens voor valutanamen zijn versoepeld. Valutasymbolen met één teken worden nu ondersteund.
• Uitgebreide Transactievlaggen: Gebruikers kunnen nu elke hoofdletter van A tot Z gebruiken als vlag voor transacties, wat een meer gedetailleerde categorisatie mogelijk maakt.

Belangrijk is dat deze wijzigingen achterwaarts compatibel zijn, dus uw bestaande Beancount v2 grootboekbestanden werken zonder enige aanpassingen.

De C++ Herimplementatie en Prestaties​

Een van de langetermijndoelen voor Beancount is een herimplementatie van de prestatiekritieke componenten in C++. Hoewel dit werk gaande is, bevat de initiële release van Beancount v3 niet de op C++ gebaseerde kern. Dit betekent dat de prestaties van v3 voorlopig vergelijkbaar zijn met v2. De C++-code blijft in een aparte ontwikkelingsbranch voor toekomstige integratie.

Migreren van v2 naar v3​

Voor de meeste gebruikers is de migratie van Beancount v2 naar v3 relatief eenvoudig:

1. Grootboekbestanden: Er zijn geen wijzigingen nodig voor uw .beancount bestanden.
2. Installatie: U moet de nieuwe, afzonderlijke pakketten zoals beanquery en beangulp installeren met pip.
3. Importeer Scripts: Als u aangepaste importeurs heeft, moet u deze bijwerken om de nieuwe beangulp API te gebruiken. Dit omvat voornamelijk het wijzigen van de basisklasse waarvan uw importeurs erven en het aanpassen van enkele methodesignaturen.
4. Fava: De populaire webinterface voor Beancount, Fava, is bijgewerkt om compatibel te zijn met v3. Zorg ervoor dat u de nieuwste versie van Fava heeft voor een naadloze ervaring.

In essentie is Beancount v3 een fundamentele release die de architectuur van het project stroomlijnt, waardoor het modulairder en gemakkelijker te onderhouden en uit te breiden is op de lange termijn. Hoewel het enkele aanpassingen aan gebruikersworkflows vereist, vooral rond data-import, legt het de basis voor de toekomstige ontwikkeling van deze krachtige boekhoudtool.

Kernfunctionaliteit en Filosofie van Beancount​

Beancount is een open-source dubbel boekhoudsysteem dat platte tekstbestanden gebruikt om transacties vast te leggen. In de kern behandelt Beancount uw grootboek als een dataset gedefinieerd door een eenvoudige, strikte grammatica. Elke financiële gebeurtenis (transacties, rekeningopeningen, grondstofprijzen, enz.) is een richtlijn in een tekstbestand, die Beancount parseert naar een in-memory database van boekingen. Dit ontwerp handhaaft het principe van dubbele boekhouding: elke transactie moet debets en credits over rekeningen in balans brengen. Het resultaat is een zeer transparant en controleerbaar grootboek dat u gemakkelijk kunt beheren met versiebeheer, inspecteren en opvragen.

Filosofie – correctheid en minimalisme: Het ontwerp van Beancount geeft prioriteit aan gegevensintegriteit en eenvoud. De maker, Martin Blais, beschrijft Beancount als "pessimistisch" in de veronderstelling dat de gebruiker fouten zal maken en legt daarom extra controles en beperkingen op. Beancount staat u bijvoorbeeld niet toe activa te verwijderen die nooit zijn toegevoegd (waardoor negatieve voorraadposities of kassaldi worden voorkomen) en kan afdwingen dat elke rekening geopend is voor gebruik. Het mist het concept van "virtuele" of automatisch gebalanceerde boekingen van Ledger – een bewuste keuze om volledig gebalanceerde boekingen af te dwingen. Beancount zet vol in op correctheid met meer kruiscontroles dan de basis dubbele boekhouding biedt. Deze voorzichtige benadering spreekt gebruikers aan die "zichzelf niet te veel vertrouwen" en willen dat de software hun fouten opvangt.

Minimale opties, maximale consistentie: In tegenstelling tot Ledgers talloze commandoregelvlaggen en afstemmingsopties, kiest Beancount voor minimalisme. Er zijn zeer weinig globale opties, en geen die de transactiesemantiek buiten het grootboekbestand wijzigen. Alle configuratie die de boekhouding beïnvloedt (zoals kostprijsmethoden voor grondstoffen of boekingsaannames) gebeurt in-bestand via richtlijnen of plugins, wat ervoor zorgt dat het laden van hetzelfde bestand altijd dezelfde resultaten oplevert, ongeacht hoe rapporten worden gegenereerd. Dit ontwerp vermijdt de complexiteit van Ledgers vele instellingen en de subtiele interacties daartussen. De filosofie van Beancount is dat een boekhoudtool een stabiele, deterministische pijplijn moet zijn van invoerbestand naar rapporten. Dit wordt bereikt door het grootboek te behandelen als een geordende stroom van richtlijnen die programmatisch opeenvolgend kunnen worden verwerkt. Zelfs zaken die Ledger als speciale syntaxis behandelt (zoals beginbalansen of prijsopgaven) zijn eersteklas richtlijnen in het gegevensmodel van Beancount, wat het systeem zeer uitbreidbaar maakt.

Uitbreidbaarheid via plugins en querytaal: Beancount is geïmplementeerd in Python en biedt hooks om aangepaste logica in de verwerkingspijplijn te injecteren. Gebruikers kunnen plugins in Python schrijven die werken op de stroom van transacties (bijvoorbeeld om een aangepaste regel af te dwingen of automatische boekingen te genereren). Deze plugins draaien terwijl het bestand wordt verwerkt, waardoor de kernfunctionaliteit van Beancount effectief wordt uitgebreid zonder de broncode te hoeven wijzigen. Beancount bevat ook een krachtige querytaal (geïnspireerd op SQL) om het grootboek te analyseren en te filteren. De bean-query tool behandelt het geparseerde grootboek als een database en stelt u in staat er analytische queries op uit te voeren – bijvoorbeeld uitgaven per categorie op te tellen of alle transacties voor een bepaalde begunstigde te extraheren. In Beancount 3.x is deze querymogelijkheid verplaatst naar een standalone beanquery pakket, maar vanuit gebruikersperspectief biedt het nog steeds flexibele rapportage via SQL-achtige queries.

Platte tekst en versiebeheer: Als een platte tekst boekhoudtool benadrukt Beancount gebruikerscontrole en de levensduur van gegevens. Het grootboek is simpelweg een .beancount tekstbestand dat u in elke teksteditor kunt bewerken. Dit betekent dat uw hele financiële geschiedenis in een menselijk leesbare vorm wordt opgeslagen, en u kunt het in Git of een ander VCS plaatsen om wijzigingen in de loop van de tijd bij te houden. Gebruikers houden hun Beancount-bestand vaak onder versiebeheer om een audit trail van elke bewerking bij te houden (met commit-berichten die wijzigingen beschrijven). Deze benadering komt overeen met de filosofie van Beancount dat boekhoudgegevens, vooral persoonlijke of kleine zakelijke financiën, transparant en "toekomstbestendig" moeten zijn – niet opgesloten in een eigen database. In de woorden van Martin Blais zelf is Beancount een "liefdeswerk" gebouwd om eenvoudig, duurzaam en gratis te zijn voor de gemeenschap. Het werd voor het eerst ontwikkeld rond 2007 en is geëvolueerd door grote herzieningen (v1 naar v2, en nu v3 in 2024) om het ontwerp te verfijnen terwijl de kernfilosofie van minimalisme en correctheid behouden bleef.

Hulpmiddelen, Plugins en Extensies in het Beancount Ecosysteem​

Het Beancount ecosysteem heeft een rijke verzameling aan hulpmiddelen, plugins en extensies ontwikkeld die de kernfunctionaliteit van het grootboek verbeteren. Deze omvatten het importeren van gegevens, het bewerken van grootboeken, het bekijken van rapporten en het toevoegen van gespecialiseerde boekhoudfuncties. Hieronder vindt u een overzicht van belangrijke componenten en add-ons in de Beancount wereld:

Hulpprogramma's voor gegevensimport (Importers)​

Een van de belangrijkste behoeften voor praktisch gebruik is het importeren van transacties van banken, creditcards en andere financiële instellingen. Beancount biedt hiervoor een importframework en door de community bijgedragen importscripts. In Beancount 2.x werd de ingebouwde module beancount.ingest (met commando's zoals bean-extract en bean-identify) gebruikt om importer-plugins in Python te definiëren en toe te passen op gedownloade afschriften. In Beancount 3.x is dit vervangen door een extern project genaamd Beangulp. Beangulp is een toegewijd importersframework dat is geëvolueerd uit beancount.ingest en is nu de aanbevolen manier om transactie-import voor Beancount 3.0 te automatiseren. Het maakt het mogelijk om Python-scripts of commandoregeltools te schrijven die externe bestanden (zoals CSV- of PDF-afschriften) lezen en Beancount-boekingen uitvoeren. Deze nieuwe aanpak ontkoppelt de importlogica van de Beancount-kern – zo is het oude bean-extract-commando verwijderd in v3, en produceren uw importscripts in plaats daarvan zelf transacties via de CLI-interface van Beangulp.

Tientallen kant-en-klare importers bestaan voor verschillende banken en formaten, bijgedragen door de community. Er zijn importscripts voor instellingen over de hele wereld – van Alipay en WeChat Pay in China, tot diverse Europese banken (Commerzbank, ING, ABN AMRO, etc.), tot Amerikaanse banken zoals Chase en Amex. Veel hiervan zijn verzameld in openbare repositories (vaak op GitHub) of in pakketten zoals beancount-importers. Zo biedt het project Tarioch Beancount Tools (tariochbctools) importers voor Zwitserse en Britse banken en verwerkt het zelfs crypto-transactie-imports. Een ander voorbeeld is Lazy Beancount, dat een reeks veelvoorkomende importers bundelt (voor Wise, Monzo, Revolut, IBKR, etc.) en een Docker-gebaseerde setup biedt voor eenvoudige automatisering. Welke bank of financiële dienst u ook gebruikt, de kans is groot dat iemand er al een Beancount-importer voor heeft geschreven – of u kunt uw eigen importer schrijven met behulp van het framework van Beangulp. De flexibiliteit van Python betekent dat importers CSV/Excel-bestanden, OFX/QIF-downloads of zelfs het scrapen van API's kunnen verwerken, en vervolgens transacties kunnen uitvoeren in gestandaardiseerd Beancount-formaat.

Bewerken en Integratie met Editors​

Omdat Beancount grootboeken gewoon tekstbestanden zijn, maken gebruikers vaak gebruik van hun favoriete teksteditors of IDE's om ze te onderhouden. Het ecosysteem biedt plugins voor editorondersteuning om deze ervaring soepeler te maken. Er zijn extensies voor veel populaire editors die syntaxiskleuring, automatische aanvulling van rekeningnamen en real-time foutcontrole toevoegen:

• Emacs Beancount-Modus: Een Emacs major mode (beancount-mode) is beschikbaar om .beancount-bestanden te bewerken, en biedt functies zoals syntaxiskleuring en integratie met de Beancount-controleur. Het kan zelfs bean-check op de achtergrond uitvoeren, zodat fouten in het grootboek (zoals een onuitgebalanceerde transactie) worden gemarkeerd terwijl u bewerkt.
• VS Code Extensie: Een Beancount-extensie op de VSCode Marketplace biedt vergelijkbare gemakken voor Visual Studio Code-gebruikers. Het ondersteunt syntaxiskleuring, uitlijning van bedragen, automatische aanvulling voor rekeningen/begunstigden, en zelfs on-the-fly saldocontroles wanneer u het bestand opslaat. Het kan ook integreren met Fava, waardoor u de Fava-webinterface vanuit VSCode kunt starten.
• Plugins of modi bestaan ook voor Vim, Atom en andere editors. Er is bijvoorbeeld een Tree-sitter grammatica voor Beancount, die syntaxiskleuring in moderne editors mogelijk maakt en zelfs is overgenomen in de webgebaseerde editorcomponent van Fava. Kortom, wat uw bewerkingsomgeving ook is, de community heeft waarschijnlijk een plugin geleverd om het bewerken van Beancount-bestanden gemakkelijk en foutloos te maken.

Voor snelle invoer van transacties buiten traditionele editors, zijn er ook tools zoals Bean-add en mobiele apps. Bean-add is een commandoregeltool die het toevoegen van een nieuwe transactie via een prompt of één-regelige opdracht mogelijk maakt, met ondersteuning voor datum- en rekeningsuggesties. Op mobiel biedt een project genaamd Beancount Mobile een eenvoudige interface om transacties onderweg in te voeren (bijvoorbeeld het vastleggen van een contante aankoop vanaf uw telefoon). Bovendien bestaat er een Beancount Telegram Bot om transacties vast te leggen via berichten – u kunt een bericht sturen met transactiedetails, en de bot formatteert het in uw grootboekbestand.

Webfrontends en Visualisatietools​

(Fava) Fava's webinterface biedt een interactief dashboard voor Beancount, met rapporten zoals een winst- en verliesrekening met visualisaties (hier weergegeven als een treemap van uitgaven per categorie) naast tabellen van rekeningen en saldi.

De belangrijkste frontend voor Beancount is Fava, een moderne webinterface. Fava draait als een lokale webapplicatie die uw Beancount-bestand leest en een rijke, interactieve ervaring in uw browser biedt. Het biedt een complete reeks rapporten: balans, winst- en verliesrekening, vermogen over tijd, portefeuilleposities, prestatiegrafieken, budgetten en meer – allemaal direct beschikbaar. Gebruikers noemen Fava vaak als een belangrijke reden om Beancount te verkiezen boven andere plain-text boekhoudtools. Met één enkel commando (fava ledger.beancount) kunt u uw financiën bekijken met grafieken en tabellen in plaats van tekst. Fava ondersteunt functies zoals: inzoomen op rekeningen, transacties filteren op begunstigde of tag, een query-editor (zodat u Beancount-queries kunt uitvoeren en de resultaten in de browser kunt zien), en zelfs een geïntegreerde webgebaseerde editor voor uw grootboek. Het is zeer gebruiksvriendelijk, waardoor plain-text boekhouden toegankelijk wordt voor degenen die visuele interfaces verkiezen.

Onder de motorkap is Fava geschreven in Python (Flask aan de backend) en JavaScript (Svelte aan de frontend). Het heeft een eigen releasecyclus en wordt actief onderhouden. Met name heeft Fava gelijke tred gehouden met de ontwikkeling van Beancount – zo heeft Fava 1.30 ondersteuning toegevoegd voor Beancount v3, waarbij intern is overgestapt op het gebruik van de nieuwe beanquery- en beangulp-pakketten. (Het ondersteunt nog steeds Beancount 2 voor oudere grootboeken.) Fava's focus op gebruiksvriendelijkheid omvat fijne details zoals auto-aanvullen in de webeditor, en een strakke gebruikersinterface met een donkere modus en responsieve grafieken. Er is ook een spin-off genaamd Fava-GTK, die Fava verpakt in een desktopapplicatie voor GNOME/Linux-gebruikers die de voorkeur geven aan het gevoel van een native app.

Naast Fava bestaan er andere visualisatie- en analyseopties. Omdat Beancount-gegevens kunnen worden geëxporteerd of opgevraagd als tabellen, maken gebruikers vaak gebruik van tools zoals Jupyter-notebooks of Pandas voor aangepaste analyse. Een gebruiker beschrijft bijvoorbeeld hoe gegevens uit Beancount via de query-interface in een Pandas DataFrame worden geladen om een aangepast rapport voor te bereiden. Er zijn ook door de community bijgedragen scripts voor specifieke rapporten – bijvoorbeeld een tool voor portefeuilleallocatieanalyse of een procesbeheersingsgrafiek voor uitgaven versus vermogen. Voor de meeste mensen biedt Fava echter meer dan voldoende rapportagemogelijkheden zonder dat er code geschreven hoeft te worden. Het ondersteunt zelfs extensies: u kunt Python-bestanden toevoegen die nieuwe rapportpagina's of grafieken aan Fava toevoegen. Een opmerkelijke extensie is fava-envelope voor envelopbudgettering binnen Fava. Over het algemeen dient Fava als de centrale visualisatiehub van het Beancount-ecosysteem.

Hulpprogramma's en scripts voor de opdrachtregel​

Beancount wordt geleverd met diverse CLI-hulpprogramma's (vooral in de oudere v2-branch, waarvan sommige zijn ingekort in v3). Deze hulpprogramma's werken op uw grootboekbestand om het te controleren of specifieke rapporten in tekst of HTML te genereren:

• bean-check: een validator die controleert op syntaxisfouten of boekhoudkundige fouten in het bestand. Het uitvoeren van bean-check myfile.beancount waarschuwt u voor elke onbalans, ontbrekende rekening of andere problemen, en geeft niets weer als het bestand foutloos is.
• bean-format: een formatter die uw grootboek netjes maakt door getallen uit te lijnen in overzichtelijke kolommen, vergelijkbaar met het uitvoeren van een code-formatter op broncode. Dit helpt het bestand schoon en leesbaar te houden.
• bean-query: een interactieve shell of batch-hulpprogramma om Beancounts querytaal op uw grootboek uit te voeren. U kunt het gebruiken om aangepaste tabelrapporten te produceren (bijv. bean-query myfile.beancount "SELECT account, sum(amount) WHERE ...").
• bean-report: een veelzijdige rapportgenerator (in v2) die vooraf gedefinieerde rapporten (balans, winst- en verliesrekening, proefbalans, enz.) kan uitvoeren naar de console of naar bestanden. Bijvoorbeeld, bean-report file.beancount balances zou rekeningsaldi afdrukken. (In de praktijk zijn veel van deze tekstrapporten vervangen door de mooiere presentatie van Fava.)
• bean-web / bean-bake: een oudere webinterface die de rapporten op localhost zou aanbieden of ze zou "bakken" als statische HTML-bestanden. Deze werden voornamelijk gebruikt voordat Fava populair werd; bean-web bood een basis webweergave van dezelfde rapporten die bean-report kon genereren. In Beancount 3 is bean-web verwijderd (aangezien Fava nu de aanbevolen web-frontend is, die een superieure ervaring biedt).
• bean-example: een hulpprogramma om een voorbeeld grootboekbestand te genereren (nuttig voor nieuwkomers om een sjabloon van Beancount-boekingen te zien).
• bean-doctor: een debug-hulpprogramma dat problemen in uw grootboek of omgeving kan diagnosticeren.

Het is vermeldenswaard dat met Beancount v3, veel van deze hulpprogramma's uit het kernproject zijn verplaatst. Het kernpakket van Beancount werd gestroomlijnd, en hulpprogramma's zoals de query-engine en importeurs werden opgesplitst in afzonderlijke pakketten (beanquery, beangulp, enz.) voor eenvoudiger onderhoud. De functionaliteit van bean-query wordt bijvoorbeeld nu geleverd door het beanquery-hulpprogramma dat afzonderlijk wordt geïnstalleerd. Vanuit het perspectief van de gebruiker blijft de functionaliteit beschikbaar; het is alleen gemodulariseerd. De Arch Linux-gemeenschap merkte deze verandering op bij het updaten van Fava: het Fava-pakket voegde afhankelijkheden toe aan beanquery en beangulp om Beancount 3.x te ondersteunen. Deze modulaire aanpak stelt ook anderen in de gemeenschap in staat om onafhankelijker van de releasecyclus van Beancount bij te dragen aan deze hulp-hulpprogramma's.

Beancount Plugins en Extensies​

Een opvallende kracht van het Beancount-ecosysteem is het plugin-systeem. Door een regel plugin "module.name" toe te voegen aan uw Beancount-bestand, kunt u aangepaste Python-logica opnemen die wordt uitgevoerd tijdens de verwerking van het grootboek. De community heeft veel plugins gemaakt om de mogelijkheden van Beancount uit te breiden:

• Gegevenskwaliteit en regels: Voorbeelden zijn beancount-balexpr waarmee u vergelijkingen met meerdere rekeningen kunt bevestigen (bijv. Activa A + Activa B = Passiva X), en beancount-checkclosed dat automatisch saldobevestigingen invoegt wanneer u een rekening afsluit om ervoor te zorgen dat deze op nul uitkomt. Er is zelfs een plugin om ervoor te zorgen dat transacties in het bestand op datum zijn gesorteerd (autobean.sorted) om ongesorteerde invoer te detecteren.
• Automatisering: De beancount-asset-transfer plugin kan in-natura overboekingen genereren tussen rekeningen (handig voor het verplaatsen van aandelen tussen makelaars met behoud van de kostprijs). Een andere, autobean.xcheck, controleert uw Beancount-grootboek aan de hand van externe afschriften op afwijkingen.
• Terugkerende transacties en budgetten: De “repeat” of interpolate plugin van Akuukis maakt het mogelijk om terugkerende transacties te definiëren of een jaarlijkse uitgave over maanden te spreiden. Voor budgettering ondersteunt de fava-envelope extensie (gebruikt via Fava) de envelopbudgetteringsmethode in platte tekst. Er is ook MiniBudget van Frank Davies – een kleine, op zichzelf staande tool geïnspireerd op Beancount om te helpen bij budgettering voor persoonlijk of klein zakelijk gebruik.
• Belasting en rapportage: Sommige plugins helpen bij belastingboekhouding, zoals een die vermogenswinsten automatisch classificeert in korte versus lange termijn. Een andere (fincen_114 van Justus Pendleton) genereert een FBAR-rapport voor Amerikaanse belastingbetalers met buitenlandse rekeningen, wat illustreert hoe Beancount-gegevens kunnen worden benut voor regelgevende rapportage.
• Community plugin repositories: Er zijn samengestelde plugin-sets zoals beancount-plugins (van Dave Stephens) gericht op zaken als afschrijvingsposten, en beancount-plugins-zack (van Stefano Zacchiroli) die diverse hulpmiddelen bevatten, zoals sorteerrichtlijnen.

Naast plugins pakken andere hulpprogramma's rondom Beancount specifieke behoeften aan. Zo is beancount-black een auto-formatter vergelijkbaar met de Black code formatter, maar dan voor Beancount grootboekbestanden. Er is een Beancount Bot (Telegram/Mattermost) voor het toevoegen van transacties via chat, zoals vermeld, en een Alfred workflow voor macOS om snel transacties aan uw bestand toe te voegen. Een tool genaamd Pinto biedt een "supercharged" CLI met interactieve invoer (zoals een verbeterde bean-add). Voor degenen die migreren van andere systemen, bestaan er converters (YNAB2Beancount, CSV2Beancount, GnuCash2Beancount, Ledger2Beancount) om gegevens van elders in te voeren.

Samenvattend is het Beancount-ecosysteem behoorlijk uitgebreid. Tabel 1 hieronder vermeldt enkele belangrijke tools en extensies met hun rollen:

| Converters (Migratietools) | Hulpprogramma's om gegevens van andere formaten naar Beancount te converteren, bijv. van GnuCash of Ledger CLI naar Beancount-formaat. Vergemakkelijken de adoptie van Beancount zonder helemaal opnieuw te beginnen. |

Vergelijking met Ledger, hledger en vergelijkbare systemen​

Beancount behoort tot de familie van platte-tekst dubbel boekhouden tools, waarvan Ledger CLI (John Wiegley’s Ledger) en hledger de meest prominente zijn. Hoewel al deze systemen het kernidee van platte-tekst grootboekbestanden en dubbel boekhouden delen, verschillen ze in syntaxis, filosofie en ecosysteemvolwassenheid. De volgende tabel belicht de belangrijkste verschillen tussen Beancount, Ledger en hledger:

Gebruiksscenario's voor Beancount​

Beancount is veelzijdig genoeg om te worden gebruikt voor het bijhouden van persoonlijke financiën, alsook (in sommige gevallen) voor de boekhouding van kleine bedrijven. De kern van de dubbelboekhoudkundige benadering is in beide scenario's hetzelfde, maar de schaal en specifieke praktijken kunnen verschillen.

Persoonlijke Financiën​

Veel Beancount-gebruikers zetten het in om hun persoonlijke of huishoudelijke financiën te beheren. Een typische persoonlijke financiële opzet in Beancount kan rekeningen omvatten voor betaal- en spaarrekeningen, creditcards, beleggingen, leningen, inkomstencategorieën (salaris, rente, etc.) en uitgavencategorieën (huur, boodschappen, entertainment, etc.). Gebruikers registreren dagelijkse transacties handmatig (door kwitanties, facturen, etc. in te voeren) of door ze te importeren vanuit bankafschriften met behulp van de eerder besproken importtools. De voordelen die Beancount biedt voor persoonlijke financiën zijn:

• Consolidatie en Analyse: Al uw transacties kunnen in één tekstbestand (of een set bestanden) staan dat jarenlange financiële geschiedenis vertegenwoordigt. Dit maakt het eenvoudig om langetermijntrends te analyseren. Met de querytaal van Beancount of met Fava kunt u binnen enkele seconden vragen beantwoorden als "Hoeveel heb ik de afgelopen 5 jaar aan reizen uitgegeven?" of "Wat is mijn gemiddelde maandelijkse boodschappenrekening?". Eén gebruiker merkte op dat na de overstap naar Beancount, "analyse van financiële gegevens (uitgaven, giften, belastingen, etc.) triviaal is" , zowel via Fava als door de gegevens op te vragen en tools zoals Pandas te gebruiken. In wezen wordt uw grootboek een persoonlijke financiële database die u naar believen kunt bevragen.
• Budgettering en Planning: Hoewel Beancount geen budgetteringssysteem afdwingt, kunt u er wel een implementeren. Sommige gebruikers doen aan envelopbudgettering door budgetrekeningen aan te maken of de fava-envelope plugin te gebruiken. Anderen gebruiken eenvoudigweg periodieke rapporten om uitgaven te vergelijken met doelen. Omdat het platte tekst is, is de integratie van Beancount met externe budgetteringstools of spreadsheets eenvoudig (gegevens exporteren of CSV-uitvoer van queries gebruiken).
• Beleggingen en Netto Waarde Tracking: Beancount blinkt uit in het bijhouden van beleggingen dankzij de robuuste afhandeling van kostprijzen en marktprijzen. U kunt aan- en verkopen van aandelen, crypto, etc. vastleggen met kostendetails, en vervolgens Prices-richtlijnen gebruiken om de marktwaarde bij te houden. Fava kan een grafiek van de netto waarde over tijd en een portefeuilleoverzicht per activaklasse tonen. Dit is enorm nuttig voor persoonlijk vermogensbeheer – u krijgt inzichten die vergelijkbaar zijn met wat commerciële tools zoals Mint of Personal Capital bieden, maar dan volledig onder uw controle. Valutabeheer is ook ingebouwd, dus als u buitenlandse valuta's of crypto aanhoudt, kan Beancount deze bijhouden en converteren voor rapportage.
• Afstemming en Nauwkeurigheid: Persoonlijke financiën omvatten vaak het afstemmen met bankafschriften. Met Beancount kan men rekeningen regelmatig afstemmen door gebruik te maken van saldo-asserties of de documentenfunctie. Zo kunt u bijvoorbeeld elke maand een balance Assets:Bank:Checking <datum> <saldo>-regel toevoegen om te bevestigen dat uw grootboek overeenkomt met het bankafschrift aan het einde van de maand. De bean-check tool (of Fava's foutweergave) zal u waarschuwen als dingen niet kloppen. Eén gebruiker noemt het maandelijks afstemmen van alle rekeningen, wat "helpt om ongebruikelijke activiteit te detecteren" – een goede persoonlijke financiële hygiënepraktijk die Beancount faciliteert.
• Automatisering: Technisch onderlegde individuen hebben grote delen van hun persoonlijke financiële workflow geautomatiseerd met Beancount. Met behulp van importtools, cron-taken en misschien een beetje Python, kunt u uw systeem zo instellen dat bijvoorbeeld elke dag uw banktransacties worden opgehaald (sommigen gebruiken OFX of API's) en aan uw Beancount-bestand worden toegevoegd, gecategoriseerd door regels. Na verloop van tijd wordt uw grootboek grotendeels automatisch bijgewerkt, en hoeft u alleen nog maar te controleren en aan te passen waar nodig. Een communitylid op Hacker News deelde dat na 3 jaar hun Beancount-boekhouding "95% automatisch" was. Dit niveau van automatisering is mogelijk dankzij de openheid van Beancount's platte tekst en de scriptmogelijkheden.

Gebruikers van persoonlijke financiën kiezen Beancount vaak boven spreadsheets of apps omdat het hen volledig eigendom van de gegevens geeft (geen afhankelijkheid van een cloudservice die mogelijk wordt stopgezet – een zorg nu Mint bijvoorbeeld is stopgezet) en omdat de diepte van het inzicht groter is wanneer u al uw gegevens geïntegreerd hebt. De leercuve is niet triviaal – men moet basisboekhouding en de Beancount-syntaxis leren – maar bronnen zoals de officiële documentatie en community-tutorials helpen nieuwkomers op weg. Eenmaal ingesteld, vinden velen dat het gemoedsrust geeft om te allen tijde een duidelijk, betrouwbaar beeld van hun financiën te hebben.

Boekhouding voor kleine bedrijven​

Het gebruik van Beancount voor een klein bedrijf (of non-profit, vereniging, etc.) is minder gebruikelijk dan voor persoonlijk gebruik, maar het is zeker mogelijk en sommigen hebben het met succes gedaan. Het dubbelboekhoudingskader van Beancount is in feite hetzelfde systeem dat ten grondslag ligt aan bedrijfsboekhouding, alleen zonder enkele van de geavanceerdere functies die gespecialiseerde boekhoudsoftware biedt (zoals facturatiemodules of salarisadministratie-integraties). Zo past Beancount in een kleine bedrijfscontext:

• Grootboek en financiële overzichten: Een klein bedrijf kan het Beancount-bestand behandelen als zijn grootboek. Je zou activarekeningen hebben voor bankrekeningen, debiteuren, misschien voorraad; passivarekeningen voor creditcards, leningen, crediteuren; eigen vermogen voor het kapitaal van de eigenaar; inkomstenrekeningen voor verkopen of diensten; en kostenrekeningen voor alle bedrijfsuitgaven. Door dit grootboek bij te houden, kun je op elk moment een winst- en verliesrekening (P&L) en een balans opstellen met behulp van de rapporten of zoekopdrachten van Beancount. Sterker nog, de ingebouwde rapporten van Beancount of Fava kunnen binnen enkele seconden een balans en P&L genereren die perfect in lijn zijn met boekhoudprincipes. Dit kan voldoende zijn voor een kleine onderneming om de winstgevendheid, financiële positie en kasstroom te beoordelen (met een beetje zoeken voor kasstroom, aangezien directe kasstroomoverzichten niet zijn ingebouwd, maar wel kunnen worden afgeleid).
• Facturen en debiteuren, crediteuren: Beancount heeft geen ingebouwd facturatiesysteem; gebruikers zouden de facturatie doorgaans extern afhandelen (bijv. facturen maken in Word of een factuur-app) en vervolgens de resultaten in Beancount vastleggen. Bijvoorbeeld, wanneer je een factuur uitreikt, boek je een post waarbij Debiteuren wordt gedebiteerd en Inkomsten wordt gecrediteerd. Wanneer de betaling binnenkomt, debiteer je Kas/Bank en crediteer je Debiteuren. Op deze manier kun je openstaande vorderingen bijhouden door naar het saldo van de debiteurenrekening te kijken. Hetzelfde geldt voor rekeningen (crediteuren). Hoewel het handmatiger is dan gespecialiseerde boekhoudsoftware (die mogelijk herinneringen stuurt of integreert met e-mails), is het perfect uitvoerbaar. Sommige gebruikers hebben sjablonen of workflows gedeeld over hoe zij facturen beheren met Beancount en ervoor zorgen dat ze geen openstaande facturen missen (bijvoorbeeld door metadata of aangepaste zoekopdrachten te gebruiken om onbetaalde facturen weer te geven).
• Voorraad of Kosten van Verkochte Goederen: Voor bedrijven die producten verkopen, kan Beancount voorraadaankopen en -verkopen bijhouden, maar dit vereist gedisciplineerde boekingen. Je zou de Inventory- en kostprijsboekhoudingsfuncties kunnen gebruiken: het inkopen van voorraad verhoogt een activarekening (met kosten gekoppeld aan de artikelen), het verkopen ervan verplaatst kosten naar een uitgave (KVGG) en registreert omzet. Omdat Beancount aandringt op het matchen van partijen, zal het een correcte afboeking van voorraad met de juiste kosten afdwingen, wat er feitelijk voor kan zorgen dat je brutowinstberekeningen nauwkeurig zijn als het correct wordt gedaan. Er is echter geen geautomatiseerde SKU-tracking of iets dergelijks – het is allemaal op financieel niveau (hoeveelheid en kosten).
• Salarisadministratie en complexe transacties: Beancount kan salarisadministratietransacties vastleggen (salariskosten, belastinginhoudingen, etc.), maar het berekenen van die cijfers kan extern of via een andere tool worden gedaan, en vervolgens gewoon in Beancount worden geboekt. Voor een zeer klein bedrijf (zeg één of twee werknemers) is dit beheersbaar. Je zou bijvoorbeeld per salarisperiode één journaalpost vastleggen die lonen, ingehouden belasting, werkgeversbelastingkosten, betaald contant geld, etc. uitsplitst. Dit handmatig doen is vergelijkbaar met hoe men het in QuickBooks-journaalposten zou doen – het vereist kennis van welke rekeningen moeten worden geraakt.
• Meerdere gebruikers en audit: Een uitdaging in een zakelijke omgeving is wanneer meerdere mensen toegang moeten hebben tot de boeken of wanneer een accountant deze moet controleren. Aangezien Beancount een tekstbestand is, is het niet multi-user in real-time. Het hosten van het bestand in een Git-repository kan echter samenwerking mogelijk maken: elke persoon kan bewerken en committen, en verschillen kunnen worden samengevoegd.
• Wettelijke naleving: Voor belastingaangifte of naleving kunnen de gegevens van Beancount worden gebruikt om de benodigde rapporten te genereren, maar dit kan aangepaste zoekopdrachten of plug-ins vereisen. We zagen een voorbeeld van een community-plug-in voor Indiase overheidsrapportage en één voor FinCEN FBAR-rapportage. Dit toont aan dat Beancount, met inspanning, kan worden aangepast om aan specifieke rapportagevereisten te voldoen. Kleine bedrijven in rechtsgebieden met eenvoudige vereisten (kasboekhouding of basis accrual) kunnen zeker boeken bijhouden in Beancount en financiële overzichten produceren voor belastingaangiften. Echter, functies zoals afschrijvingsschema's of amortisatie vereisen mogelijk dat je je eigen boekingen schrijft of een plug-in gebruikt (de afschrijvingsplug-ins van Dave Stephens helpen dat bijvoorbeeld te automatiseren). Er is geen GUI om op "afschrijven activa" te klikken zoals in sommige boekhoudsoftware; je zou de afschrijving coderen als transacties (wat het op een bepaalde manier demystificeert – alles is een boeking die je kunt inspecteren).

In de praktijk hebben veel technisch georiënteerde eigenaren van kleine bedrijven Beancount (of Ledger/hledger) gebruikt als ze de voorkeur geven aan controle en transparantie boven het gemak van QuickBooks. Een Reddit-discussie merkte op dat voor standaard boekhouding van kleine bedrijven met een beperkt transactievolume, Beancount prima werkt. De beperkende factor is meestal het comfortniveau – of de bedrijfseigenaar (of hun accountant) zich comfortabel voelt met een tekstgebaseerde tool. Een voordeel zijn de kosten: Beancount is gratis, terwijl boekhoudsoftware duur kan zijn voor een klein bedrijf. Aan de andere kant betekent het gebrek aan officiële ondersteuning en het doe-het-zelf-karakter dat het het meest geschikt is voor degenen die zowel de bedrijfseigenaar zijn als enigszins technisch onderlegd. Voor freelancers of eenmanszaken met programmeervaardigheden kan Beancount een aantrekkelijke keuze zijn om financiën te beheren zonder afhankelijk te zijn van cloudboekhoudingsdiensten.

Hybride benaderingen zijn ook mogelijk: sommige kleine bedrijven gebruiken een officieel systeem voor facturen of salarisadministratie, maar importeren de gegevens periodiek in Beancount voor analyse en archivering. Op deze manier krijgen ze het beste van twee werelden – naleving en gemak voor dagelijkse operaties, plus de kracht van Beancount voor geconsolideerd inzicht.

Samenvattend kan Beancount de boekhouding van kleine bedrijven aan, mits de gebruiker bereid is handmatig dingen te beheren die commerciële software automatiseert. Het zorgt voor een hoge mate van transparantie – je begrijpt je boeken diepgaand omdat je ze zelf schrijft – en voor een ijverige gebruiker kan het onberispelijke boeken produceren. Zowel persoonlijke als zakelijke gebruikers profiteren van de kernsterkten van Beancount: een betrouwbare boekhoudmotor, een complete audit trail en flexibiliteit om zich aan te passen aan unieke scenario's (via scripting en plug-ins). Of het nu gaat om het bijhouden van een huishoudbudget of de financiën van een startup, Beancount biedt een toolkit om dit met precisie en openheid te doen.

Gemeenschap en Ontwikkelingsactiviteit​

Beancount heeft een toegewijde gemeenschap en een ontwikkelingsgeschiedenis die de open-source, niche-maar-gepassioneerde aard weerspiegelt. Hieronder staan belangrijke punten over de gemeenschap, beheerders en gerelateerde projecten:

• Projectonderhoud: De primaire auteur van Beancount is Martin Blais, die het project rond 2007 begon en het door meerdere versies heeft geleid. De ontwikkeling was lange tijd grotendeels een eenmansinspanning (afgezien van gemeenschapsbijdragen van patches). Martins filosofie was om een boekhoudtool te bouwen die "eerst nuttig is voor mij, en ook voor anderen, op de eenvoudigste, meest duurzame manier". Deze persoonlijke motivatie hield het project gaande als een liefdeswerk. Vanaf 2025 is Martin Blais nog steeds de hoofdonderhouder (zijn naam verschijnt op commits en hij beantwoordt vragen op de mailinglijst/issue tracker), maar het ecosysteem rond Beancount heeft vele andere bijdragers in hun respectievelijke projecten.

• GitHub en Repositories: De broncode wordt gehost op GitHub onder de beancount/beancount repository. Het project is gelicentieerd onder GPL-2.0 en heeft in de loop der jaren een bescheiden aantal bijdragers aangetrokken. Halverwege 2024 werd Beancount Versie 3 officieel uitgebracht als de nieuwe stabiele tak. Deze release omvatte het opsplitsen van sommige componenten: zo zijn de beangulp repo (voor importeurs) en beanquery repo (voor de querytool) nu onderdeel van de beancount GitHub-organisatie, en worden ze enigszins onafhankelijk onderhouden. De hoofd-Beancount-repo richt zich op de kernboekhoudengine en bestandsparser. Vanaf 2025 toont Beancount's GitHub actieve discussies over issues en enige doorlopende ontwikkeling – hoewel niet met een hoog volume, druppelen issues en pull requests binnen, en worden er af en toe updates uitgevoerd om bugs te verhelpen of functies te verfijnen.

• Fava-ontwikkeling: Fava, de webinterface, begon als een afzonderlijk project (gecreëerd door Dominic Aumayr, die het in 2016 auteursrechtelijk beschermde). Het heeft zijn eigen gemeenschap van bijdragers en staat ook op GitHub onder beancount/fava. Fava's beheerders en bijdragers (bijv. Jakob Schnetz, Stefan Otte en anderen in de afgelopen jaren) hebben de interface actief verbeterd, met releases om de paar maanden. Fava's Gitter-chat (gekoppeld aan de Fava-documentatie) en GitHub issue tracker zijn plaatsen waar gebruikers en ontwikkelaars nieuwe functies of bugs bespreken. Het project verwelkomt bijdragen, wat blijkt uit een CHANGELOG-notitie waarin meerdere gemeenschapsleden worden bedankt voor hun PR's. Fava's nauwe afstemming met de ontwikkeling van Beancount (zoals het snel toevoegen van ondersteuning voor Beancount v3 en nieuwe beanquery-syntaxis) duidt op een goede samenwerking tussen de twee projecten.

• Mailinglijsten en Forums: Beancount heeft een officiële mailinglijst (voorheen op Google Groups, getiteld "Beancount" of soms besproken op de algemene Ledger-lijst). Deze mailinglijst is een schat aan kennis – gebruikers stellen vragen over hoe bepaalde scenario's te modelleren, rapporteren bugs en delen tips. Martin Blais staat erom bekend op de mailinglijst te reageren met gedetailleerde uitleg. Daarnaast is er een grote overlap met de bredere Plain Text Accounting-gemeenschap. De Ledger CLI-mailinglijst behandelt vaak ook vragen over Beancount, en er is een forum op plaintextaccounting.org en een subreddit r/plaintextaccounting waar Beancount-onderwerpen frequent aan bod komen. Gebruikers op deze platforms bespreken vergelijkingen, delen persoonlijke setups en helpen nieuwkomers. De algemene toon van de gemeenschap is zeer coöperatief – Beancount-gebruikers helpen vaak Ledger-gebruikers en vice versa, erkennend dat al deze tools vergelijkbare doelen hebben.

• Chatgroepen: Naast mailinglijsten zijn er chatkanalen zoals de Plaintext Accounting Slack/Discord (door de gemeenschap georganiseerd) en de Fava Gitter. Dit zijn minder formele, meer real-time manieren om hulp te krijgen of functies te bespreken. Men kan bijvoorbeeld op Slack springen om te vragen of iemand een importeur heeft voor een specifieke bank. Er is ook een Matrix/IRC-kanaal (historisch #ledger of #beancount op IRC) waar sommige langdurige gebruikers aanwezig zijn. Hoewel niet zo populair als gemeenschappen voor mainstream software, hebben deze kanalen deskundige mensen die vaak antwoord kunnen geven op obscure boekhoudvragen.

• Bijdragers en Belangrijke Gemeenschapsleden: Enkele namen vallen op in de Beancount-gemeenschap:

  • "Redstreet" (Red S): Een productieve bijdrager die veel plugins heeft geschreven (zoals beancount-balexpr, sellgains en andere) en vaak ondersteuning biedt. Zij onderhouden ook een set importeursscripts en een tool genaamd bean-download om afschriften op te halen.
  • Vasily M (Evernight): Auteur van enkele importeurframeworks en plugins zoals beancount-valuation, en bijdragen aan Fava met betrekking tot investeringen.
  • Stefano Zacchiroli (zack): Een Debian-ontwikkelaar die de beancount-mode voor Emacs en zijn eigen plugin-repo heeft gemaakt. Hij heeft ook gepleit voor plaintext accounting in academische settings.
  • Simon Michael: Hoewel hij voornamelijk de leider is van hledger, beheert hij plaintextaccounting.org, dat Beancount omvat. Deze kruisbestuiving heeft geholpen Beancount onder de aandacht te brengen van Ledger/hledger-gebruikers.
  • Frank hell (Tarioch): Bijdrager van de Tarioch Beancount Tools, een belangrijke set importeurs en prijsophalers, vooral voor Europese instellingen.
  • Siddhant Goel: Een gemeenschapslid dat blogt over Beancount (bijvoorbeeld zijn gids over migreren naar v3) en enkele importeurs onderhoudt. Zijn blogposts hebben veel nieuwe gebruikers geholpen.

  Deze en vele anderen dragen code, documentatie en hulp bij op forums, waardoor het ecosysteem levendig blijft ondanks de relatief kleine omvang.

• GitHub Statistieken en Forks: Beancount's GitHub-repo heeft enkele honderden sterren (wat interesse aangeeft) en forks verzameld. Opvallende forks van Beancount zelf zijn zeldzaam – er is geen bekende afwijkende fork die probeert "Beancount maar met functie X" te zijn. In plaats daarvan, wanneer gebruikers iets anders wilden, schreven ze ofwel een plugin of gebruikten ze een andere tool (zoals hledger) in plaats van Beancount te forken. Men zou hledger kunnen beschouwen als een soort fork van Ledger (niet Beancount) en Beancount zelf als een onafhankelijke herinterpretatie van Ledgers ideeën, maar binnen Beancount's repo zijn er geen grote afsplitsingsprojecten. De gemeenschap heeft zich over het algemeen verenigd rond de hoofd-repo en deze uitgebreid via de plugin-interface in plaats van de codebase te fragmenteren. Dit komt waarschijnlijk doordat Martin Blais openstond voor externe bijdragen (zijn documentatie heeft zelfs een sectie die externe bijdragen en modules erkent) en de plugin-architectuur het onnodig maakte om een fork te onderhouden voor de meeste nieuwe functies.

• Gemeenschapsbronnen: Er zijn verschillende hoogwaardige bronnen voor het leren en gebruiken van Beancount, gecreëerd door de gemeenschap:

  • De Beancount-documentatie op GitHub Pages (en de bron Google Docs die Martin onderhoudt) – zeer uitgebreid, inclusief theorie over boekhouding en hoe Beancount dit implementeert.

  • Talrijke blogposts en persoonlijke notities – bijv. LWN.net had een artikel "Counting beans… with Beancount", en veel persoonlijke blogs (zoals vermeld in de sectie "Blog Posts" van Awesome Beancount) delen ervaringen en tips. Deze helpen kennis op te bouwen en nieuwe gebruikers aan te trekken.

  • Lezingen en presentaties: Beancount is gepresenteerd op meetups en conferenties (bijvoorbeeld een PyMunich 2018-lezing over het beheren van financiën met Python

Recente Ontwikkelingen en Aankomende Functies​

Vanaf 2025 heeft het Beancount-ecosysteem de afgelopen paar jaar aanzienlijke ontwikkelingen doorgemaakt, en er zijn voortdurende discussies over toekomstige verbeteringen. Hier zijn enkele opmerkelijke recente ontwikkelingen en een vooruitblik op wat er mogelijk komen gaat:

• Beancount 3.0 Release (2024): Na een lange periode waarin Beancount 2.x de standaard was, werd versie 3 medio 2024 officieel uitgebracht. Dit was een belangrijke mijlpaal omdat v3 een vereenvoudiging en modernisering van de codebase vertegenwoordigt. Martin Blais had v3 voor ogen als een kans om het systeem verder te “herschikken en vereenvoudigen”. Hoewel oorspronkelijk werd gedacht dat het een grote herschrijving zou zijn, was de update voor gebruikers in de praktijk niet al te storend. De belangrijkste wijzigingen waren onder de motorkap: een nieuwe parser, enkele prestatieverbeteringen en de extractie van optionele componenten uit de kern. De release werd geleidelijk uitgerold (v3 was sinds 2022 in bèta, maar in juli 2024 werd het de aanbevolen stabiele versie). Gebruikers zoals Siddhant Goel meldden dat de migratie van 2.x naar 3.x “meestal zonder problemen” verliep, met slechts enkele wijzigingen in de workflow.

• Modularisatie – tools verplaatst naar afzonderlijke pakketten: Een van de grote veranderingen met Beancount 3 is dat veel tools die voorheen in de monolithische repository zaten, zijn afgesplitst. Zo wordt bean-query nu geleverd door het beanquery-pakket, en beancount.ingest is vervangen door het beangulp-pakket. Commando's zoals bean-extract en bean-identify (voor imports) zijn verwijderd uit de kern van Beancount. In plaats daarvan is de filosofie om standalone scripts te gebruiken voor importeren. Dit betekent dat als je upgrade naar v3, je beangulp installeert en importer-scripts uitvoert (elke importer is in feite een klein programma) in plaats van een centraal bean-extract configuratiebestand te hebben. Op dezelfde manier worden queries uitgevoerd via beanquery, dat onafhankelijk van de Beancount-kern kan worden geïnstalleerd en bijgewerkt. Deze modulaire aanpak is ontworpen om onderhoud te vergemakkelijken en bijdragen van de gemeenschap aan te moedigen. Het heeft ook de kern van Beancount afgeslankt, zodat de kern zich puur richt op parsing en boekhoudkundige logica, terwijl aanvullende functionaliteit afzonderlijk kan evolueren. Vanuit gebruikersperspectief moet men na het upgraden commando's aanpassen (bijv. bean-query gebruiken van beanquery, of Fava gebruiken dat dit sowieso abstraheert). Fava's changelog vermeldt deze wijzigingen expliciet: Fava is nu afhankelijk van beanquery en beangulp, en het behandelt importworkflows anders voor Beancount 3 versus 2.

• Prestatieverbeteringen: Prestaties waren een motivatie om het ontwerp van Beancount opnieuw te bekijken. Het v3-plan (zoals uiteengezet in Martins “V3 goals” document) omvatte het optimaliseren van de parser en mogelijk het sneller en minder geheugenintensief maken van het laadproces. Tegen 2025 zijn sommige van deze verbeteringen gerealiseerd. Anekdotisch hebben gebruikers met zeer grote grootboeken (tienduizenden transacties, of veel aandelenhandel) betere prestaties gemeld met de nieuwste versie. Een gebruiker die te maken had met “micro-investeringstransacties” en prestatieproblemen ondervond, merkte deze zorgen bijvoorbeeld op in de Google Group – dit soort feedback heeft waarschijnlijk v3 geïnformeerd. De nieuwe parser is efficiënter en duidelijker geschreven, wat in de toekomst kan worden uitgebreid. Bovendien is Fava 1.29 overgestapt op een efficiënter bestandsbewakingsmechanisme (met behulp van de watchfiles-bibliotheek) om de responsiviteit te verbeteren wanneer het grootboek verandert. Vooruitkijkend zou de gemeenschap incrementele parsing kunnen onderzoeken (alleen gewijzigde delen van het bestand opnieuw verwerken in plaats van alles) om grote grootboeken sneller te verwerken – dit werd in de documentatie gesuggereerd als het idee van een “Beancount server / incrementele boeking”.

• **Verbeteringen in Investering

We hebben de MIT-gelicentieerde open source software Fava geüpgraded naar versie 1.19. Hier zijn de wijzigingen sinds onze laatste update:

• v1.19 (2021-05-18)
  • migratie van de opties conversion en interval naar de default-page optie
  • optie invert-income-liabilities-equity toegevoegd
  • upgrade naar CodeMirror 6
  • voegt een Bulgaarse vertaling toe
  • andere kleine verbeteringen en bugfixes
• v1.18 (2021-01-16)
  • enkele kleine verbeteringen en diverse bugfixes.

Enthousiast geworden? Probeer het nu op https://beancount.io/ledger/

Vragen? We staan voor je klaar op https://t.me/beancount :)

Privacy is de kern van ons DNA, onze cultuur en onze waarden. We zetten ons in om uw gegevens te beschermen binnen al onze systemen.

En vandaag zijn we verheugd om Beancount mobile open source te maken. Dat betekent dat de code openbaar beschikbaar is en door mensen kan worden gecontroleerd. Dit niveau van transparantie waarborgt zowel de veiligheid van de app als uw gemoedsrust over wat we met uw gegevens doen.

Open source biedt onze klanten meer keuzes op de markt en op vele manieren betere oplossingen. We bouwen Beancount.io bovenop uitstekende open source projecten en hopen in de toekomst zoveel mogelijk modules van ons systeem open source te maken. En Beancount mobile is nog maar het begin van deze reis :)

Je kunt geen bedrijf sturen als je niet weet waar het geld naartoe gaat. Nauwkeurige boekhouding verandert giswerk in inzicht. (Investopedia)

Elke bedrijfseigenaar, freelancer of startup-oprichter krijgt uiteindelijk te maken met dezelfde realiteit: financiële chaos is een groei-killer. Zonder een duidelijk beeld van uw cashflow vliegt u blind. Maar wat als u uw financiën met dezelfde precisie en controle zou kunnen beheren als u uw code beheert? Maak kennis met Beancount, een krachtig, open-source boekhoudsysteem dat werkt met eenvoudige tekstbestanden.

Deze handleiding leidt u door de basisprincipes van boekhouden en laat u zien hoe u een robuuste, lichtgewicht en transparante financiële workflow kunt opbouwen met behulp van Beancount.

Wat is boekhouden?​

In de kern is boekhouden het systematisch en continu vastleggen van elke financiële transactie die een bedrijf doet. Het is de dagelijkse discipline van het bijhouden van inkomsten, uitgaven, activa (wat u bezit) en passiva (wat u verschuldigd bent).

In de wereld van Beancount zijn deze gegevens niet opgesloten in propriëtaire software. Ze bevinden zich in eenvoudige, leesbare tekstbestanden. Deze aanpak stelt u in staat om uw financiële geschiedenis te versiebeheren met tools zoals Git, net zoals u zou doen met een softwareproject. Elke invoer wordt beheerst door de regel van dubbel boekhouden, een elegant systeem dat uw werk automatisch controleert en ervoor zorgt dat uw boekhouding altijd correct is. (beancount)

Waarom is het belangrijk?​

Nauwgezet boekhouden gaat niet alleen over administratieve netheid; het is een strategisch voordeel.

• Vertrouwen bij belastingaangifte: Wanneer het tijd is voor de belastingaangifte, zijn overzichtelijke gegevens uw beste vriend. De Belastingdienst vereist duidelijke documentatie voor inkomsten en aftrekposten. Een goed bijgehouden grootboek betekent dat u met vertrouwen aangifte kunt doen en eventuele controles aanzienlijk kunt verkorten. (Belastingdienst)
• Scherpere beslissingen: Zijn uw prijzen hoog genoeg? Is een specifiek servicecontract daadwerkelijk winstgevend? Lopen de abonnementskosten uit de hand? Financiële overzichten zoals de winst-en-verliesrekening en de balans onthullen prijslekken, op hol geslagen kosten en cashflow-problemen, waardoor managers en investeerders de gegevens krijgen die ze nodig hebben om slimme keuzes te maken. (Investopedia)
• Gemakkelijkere financiering: Kredietverstrekkers en investeerders nemen geen beslissingen op basis van onderbuikgevoelens. Voordat ze geld overmaken, zullen ze vragen om financiële overzichten. Een goede boekhouding stelt u in staat om in enkele seconden een balans of winst-en-verliesrekening te genereren, waarmee u professionaliteit en financiële gezondheid aantoont. (Investopedia)
• Waarschuwingen voor fraude en fouten: Regelmatige afstemming van uw boekhouding met bankafschriften is uw eerste verdedigingslinie tegen fouten. Deze eenvoudige gewoonte helpt u om dubbele kosten, bankfouten of frauduleuze activiteiten snel op te sporen, voordat ze grote problemen worden. (Belastingdienst)

Een tekstueel stappenplan in zeven stappen​

Klaar om te beginnen? Hier leest u hoe u uw Beancount-aangedreven boekhoudsysteem vanaf de grond opbouwt.

1. Scheid zakelijke en persoonlijke rekeningen​

Dit is de ononderhandelbare eerste stap. Open een aparte zakelijke betaalrekening en, indien nodig, een zakelijke creditcard. Het vermengen van geldmiddelen creëert een nachtmerrie voor de boekhouding en kan de aansprakelijkheidsgrenzen tussen u en uw bedrijf vervagen. Een duidelijke scheiding is essentieel voor nauwkeurige aftrekposten en wettelijke bescherming. (Kamer van Koophandel)

In Beancount declareert u het bestaan van deze rekeningen met een open directive:

; Beginsaldi voor uw rekeningen
2025-07-22 open Assets:Bank:Zakelijk   EUR
2025-07-22 open Assets:Bank:Privé   EUR

2. Kies een boekhoudsysteem​

Beancount maakt gebruik van de dubbel boekhouden methode, al eeuwenlang de gouden standaard in de boekhouding. Het principe is eenvoudig: elke transactie beïnvloedt ten minste twee rekeningen. Voor elke debet van de ene rekening moet er een overeenkomstige credit op een andere rekening staan. De magie van dit systeem is dat de som van al uw rekeningen altijd nul moet zijn. Beancount handhaaft deze regel automatisch, wat betekent dat een typefout of logische fout onmiddellijk een vlag zal hijsen. U kunt letterlijk geen onevenwichtige boekhouding hebben. (beancount)

3. Kies een boekhoudmethode​

U hebt hier twee belangrijke keuzes:

• Kasbasis: U registreert inkomsten wanneer u het geld ontvangt en uitgaven wanneer u ze betaalt. Het is eenvoudiger en weerspiegelt uw cashflow direct.
• Transactiebasis: U registreert inkomsten wanneer u ze verdient (bijv. wanneer een factuur wordt verzonden) en uitgaven wanneer u ze maakt (bijv. wanneer u een rekening ontvangt). Deze methode geeft een getrouwer beeld van de financiële gezondheid en prestaties van een bedrijf, vooral voor groeiende bedrijven. (Investopedia)

Hier is een voorbeeld van een transactie op transactiebasis in Beancount. U boekt de inkomsten wanneer de factuur wordt verzonden, waarbij de waarde naar Assets:Debiteuren wordt verplaatst. Wanneer de klant betaalt, verplaatst u het geld van Debiteuren naar uw bankrekening.

; Voorbeeld transactiebasis: factuur verzonden, betaling later
2025-07-22 * "Ontwerp factuur #101"
  Assets:Debiteuren     3000.00 EUR
  Income:Ontwerp

2025-08-15 * "Klant betaalt factuur #101"
  Assets:Bank:Zakelijk          3000.00 EUR
  Assets:Debiteuren

4. Stel uw tools samen​

De schoonheid van Beancount ligt in zijn minimalistische, modulaire aard. Uw kernstack omvat:

• Editor + Git: Uw favoriete teksteditor voor het vastleggen van transacties en Git voor versiebeheer, waardoor u een complete, controleerbare geschiedenis van elke wijziging hebt.
• bean-report / bean-balance / Fava: Command-line tools zoals bean-report en de prachtige webinterface Fava geven u direct financiële overzichten, dashboards en krachtige filtermogelijkheden.
• Importeerders: Een rijk ecosysteem van door de community gebouwde importeerders kan verbinding maken met uw bankfeeds via CSV, Plaid of API's voor services zoals Stripe en PayPal, waardoor een groot deel van de gegevensinvoer wordt geautomatiseerd.

5. Categoriseer elke transactie​

Een goed georganiseerd "rekeningschema" is de ruggengraat van inzichtelijke rapportage. Definieer categorieën die zinvol zijn voor uw bedrijf, met behulp van hiërarchische rekeningen voor granulariteit. Categoriseer vervolgens elke transactie nauwkeurig wanneer u deze vastlegt.

2025-07-30 * "AWS maandelijkse factuur"
  Expenses:Hosting:AWS       124.50 EUR
  Assets:Bank:Zakelijk
  tag: "ops"

In dit voorbeeld wordt de uitgave duidelijk gecategoriseerd onder Expenses:Hosting:AWS. Het gebruik van tag: "ops" maakt ook cross-cutting rapporten mogelijk, zoals het bekijken van alle operationele uitgaven ongeacht hun primaire categorie. (Belastingdienst)

6. Bewaar brondocumenten veilig​

De Belastingdienst accepteert digitale kopieën van bonnen en facturen. Scan papieren bonnen of stuur e-mailfacturen door naar een speciale map in cloudopslag (zoals Google Drive of Dropbox). Koppel vervolgens direct naar het bestand in uw Beancount-invoer met behulp van metadata. Dit creëert een luchtdichte, zelfstandige registratie.

; Afbeelding van bon gekoppeld als metadata
2025-07-18 * "Teamlunch"
  Expenses:Maaltijden              85.10 EUR
  Assets:Bank:Zakelijk
  receipt: "bonnen/2025-07-18-teamlunch.jpg"

7. Maak van boekhouden een gewoonte​

Consistentie is de sleutel. Uitstelgedrag maakt van boekhouden een stressvolle, tijdrovende klus. Reserveer een terugkerend tijdsblok - een wekelijkse of maandelijkse "Bean-dag" - om transacties te importeren, rekeningen af te stemmen en uw financiële rapporten te bekijken. Deze eenvoudige routine verandert boekhouden van een kwartaalstrijd in een snelle, krachtige bedrijfsgezondheidscontrole. (Belastingdienst)

Zelf doen versus professionele hulp​

• Zelf doen: Voor freelancers of kleine bedrijven met een voorspelbaar transactievolume is een doe-het-zelf-aanpak met Beancount ongelooflijk effectief. Het is nog steeds verstandig om een kort, eenmalig consult te hebben met een accountant om uw rekeningschema te valideren en ervoor te zorgen dat u op de goede weg bent.
• Professionele beoordeling: Naarmate uw bedrijf schaalt, transacties complexer worden of het nalevingsrisico toeneemt, is het van onschatbare waarde om een professionele boekhouder of accountant in te schakelen voor periodieke beoordelingen. U kunt Beancount blijven gebruiken als uw primaire bron van waarheid en eenvoudig de rapporten exporteren die zij nodig hebben.

Snelstart-checklist​

• Open aparte zakelijke bankrekeningen.
• Kloon de Beancount starter repository en definieer uw rekeningen in accounts.bean.
• Kies kasbasis of transactiebasis en houd u daaraan.
• Stel importeerders in om gegevensinvoer van uw bank (CSV), Stripe, PayPal, enz. te automatiseren.
• Tag en schrijf duidelijke omschrijvingen voor elke transactie.
• Stem uw grootboek wekelijks of maandelijks af met bankafschriften.
• Genereer maandelijkse inkomsten-, balans- en cashflowrapporten met behulp van Fava of bean-report.
• Maak regelmatig een back-up van uw .bean bestanden (Git + off-site opslag).

Verder lezen​

• Belastingdienst - Ondernemen
• Beancount Documentatie - Taal & Command-Line Tools

Klaar om te starten? Installeer Beancount, voer uw eerste invoer uit en verruil spreadsheetmist voor de duidelijkheid van platte tekst. Veel plezier met bean-keeping!