Ga naar hoofdinhoud

5 berichten getagd met "plain-text accounting"

Bekijk alle tags

De Complete Gids voor Cryptocurrency Boekhouding met Beancount.io

· 11 minuten leestijd
Mike Thrift
Mike Thrift
Marketing Manager

Verdrinkt u in cryptotransacties over meerdere beurzen, worstelt u met de complexiteit van DeFi, of raakt u in paniek over het belastingseizoen? U bent niet de enige. Het cryptovaluta-landschap is geëxplodeerd van eenvoudige Bitcoin-aankopen naar een geavanceerd ecosysteem van DeFi-protocollen, staking-beloningen, yield farming en cross-chain activiteiten die traditionele boekhoudmethoden uitdagen.

Hier is de harde realiteit: elke cryptotransactie is potentieel belastbaar, en de belastingdienst kijkt mee. Of u nu een informele Bitcoin-houder bent of een DeFi-poweruser die posities beheert over tientallen protocollen, het bijhouden van nauwkeurige financiële gegevens is niet optioneel – het is essentieel voor compliance en financiële duidelijkheid.

Het probleem? Traditionele boekhoudsoftware heeft beperkte native ondersteuning voor de complexiteit van crypto. Hoewel tools zoals QuickBooks crypto kunnen verwerken met extra plugins, en Excel blockchain-gegevens kan importeren met scripts, vereisen de meeste oplossingen aanzienlijke aanpassingen voor een uitgebreide crypto-boekhouding.

De oplossing? Beancount.io's plain-text boekhoudsysteem gebouwd op de krachtige open-source Beancount-taal. Belangrijke opmerking: Beancount is een open-source dubbel boekhoudsysteemtaal gecreëerd door Martin Blais, terwijl Beancount.io een commerciële hostingdienst is die een gebruiksvriendelijke interface en cloud-infrastructuur voor Beancount biedt. Deze gids behandelt zowel de onderliggende Beancount-principes als hoe u deze effectief kunt gebruiken via het Beancount.io-platform.

Complete Gids voor Cryptocurrency Boekhouding

De nachtmerrie van cryptovaluta-boekhouding (en waarom het erger wordt)

Je cryptoportfolio is overal verspreid

Laten we eerlijk zijn over je setup. Je hebt waarschijnlijk:

  • 3-5 verschillende exchanges (Coinbase voor gemakkelijke aankopen, Binance voor altcoins, Kraken voor die ene token...)
  • Meerdere wallets (MetaMask voor DeFi, Ledger voor lange termijn holdings, die oude wallet die je vergeten bent...)
  • DeFi posities verspreid over meer dan 10 protocollen (Uniswap, Compound, Aave, en welke nieuwe yield farm je aandacht ook trok)
  • Staking beloningen die binnendruppelen van diverse validators
  • Willekeurige airdrops die in je wallet verschijnen als crypto kerstcadeaus

Elk platform spreekt een andere taal. Coinbase geeft je een CSV die totaal niet lijkt op de export van Binance. Uniswap heeft zelfs geen exportmogelijkheden. En laten we het niet eens hebben over het bijhouden van je DeFi posities over Layer 2 netwerken.

Transactietypen die de traditionele boekhouding uitdagen

Uw crypto-activiteiten omvatten transactietypen waarvoor traditionele boekhoudsystemen oorspronkelijk niet zijn ontworpen:

  • Impermanent loss door het verschaffen van liquiditeit (probeer dat maar eens uit te leggen aan QuickBooks)
  • Flash loans die miljoenen lenen en terugbetalen in één enkele transactie
  • Yield farming waarbij u 5 verschillende tokens verdient voor het verschaffen van liquiditeit
  • Cross-chain bruggen die activa laten verdwijnen op het ene netwerk en verschijnen op een ander
  • Staking-derivaten zoals stETH die waarde anders opbouwen dan het onderliggende activum
  • DAO-bestuurstokens die u heeft ontvangen voor het gebruik van protocollen

Het Fiscale Nalevingsmijnveld

Dit is wat crypto-investeerders 's nachts wakker houdt:

  • Elke afzonderlijke transactie is belastbaar (ja, zelfs die ETH-naar-USDC-ruil)
  • Kostprijsbepaling wordt onmogelijk met honderden microtransacties
  • Stakingbeloningen zijn inkomen op het moment dat u ze ontvangt (tegen reële marktwaarde)
  • DeFi-beloningen zijn inkomen zelfs als u ze nog niet kunt verkopen
  • De IRS wil Formulier 8949 met elke afzonderlijke transactie vermeld
  • Boetes zijn zwaar als u het verkeerd doet

Traditionele boekhoudsoftware vereist aanzienlijk maatwerk voor deze complexiteit. Hoewel er oplossingen bestaan, vereisen ze vaak extra plug-ins, scripts of handmatige processen om de volledige omvang van cryptocurrency-activiteiten te verwerken.

Maak kennis met Beancount.io: De Crypto Boekhoudoplossing Waar Je Op Hebt Gewacht

Wat als ik je zou vertellen dat er een boekhoudsysteem is ontworpen voor precies deze chaos? Beancount.io is niet zomaar een boekhoudtool—het is een plain-text boekhoudrevolutie die de complexiteit van cryptocurrency afhandelt alsof het ervoor gemaakt is.

Waarom Beancount.io toonaangevend is in crypto-boekhouding

🔍 Volledige Transparantie: Elke berekening is zichtbaar. Geen black boxes, geen 'vertrouw ons'-algoritmes. U ziet precies hoe uw kostprijs wordt berekend, hoe winsten worden vastgesteld en waar elke satoshi naartoe is gegaan.

📊 Onbeperkte Flexibiliteit: Creëer elke gewenste accountstructuur. Volg DeFi-posities, staking-derivaten, cross-chain activa, of die vreemde token die u via een DAO-stemming heeft verkregen. Als u het kunt bedenken, kunt u het volgen.

🎯 Nauwkeurige Kostprijsbepaling: Lot-gebaseerde tracking met specifieke identificatie. Kies precies welke Bitcoin u verkoopt voor optimale belastingresultaten. FIFO, LIFO, of selecteer uw specifieke lots – uw keuze.

🔗 Toekomstbestendig: Plain-text formaat betekent dat uw gegevens voor altijd van u zijn. Geen vendor lock-in, geen propriëtaire formaten, geen 'sorry, we stoppen ermee'-e-mails.

⚡ Kracht door Scripting: Automatiseer importprocessen, genereer aangepaste rapporten en integreer met elke tool. Omdat uw cryptoportfolio uniek is, zou uw boekhouding dat ook moeten zijn.

Je Crypto Commando Centrum Opzetten

Je rekeningstructuur opbouwen

Zie dit als het ontwerpen van de blauwdruk voor je crypto-imperium. We creëren een structuur die alles aankan, van je eerste Bitcoin-aankoop tot complexe multi-protocol DeFi-strategieën:

Let op: De voorbeelden gebruiken 1970-01-01 als plaatsaanduiding voor de openingsdatum. Vervang voor daadwerkelijk gebruik door je echte rekeningopeningsdata, vooral als je geautomatiseerde importtools gebruikt die transacties filteren op datum.

; Beursrekeningen
1970-01-01 open Assets:Crypto:Coinbase:USD
1970-01-01 open Assets:Crypto:Coinbase:BTC
1970-01-01 open Assets:Crypto:Coinbase:ETH
1970-01-01 open Assets:Crypto:Binance:USD
1970-01-01 open Assets:Crypto:Binance:BTC
1970-01-01 open Assets:Crypto:Binance:ETH
1970-01-01 open Assets:Crypto:Binance:ADA

; Wallet Rekeningen
1970-01-01 open Assets:Crypto:Wallet:MetaMask:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:USDC
1970-01-01 open Assets:Crypto:Wallet:MetaMask:UNI
1970-01-01 open Assets:Crypto:Wallet:Ledger:BTC
1970-01-01 open Assets:Crypto:Wallet:Ledger:ETH

; DeFi Protocol Rekeningen
1970-01-01 open Assets:DeFi:Compound:cUSDC
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:Staking:Ethereum:ETH
1970-01-01 open Assets:Crypto:Mining:BTC

; Inkomstenrekeningen
1970-01-01 open Income:Crypto:Staking:ETH
1970-01-01 open Income:Crypto:Mining:BTC
1970-01-01 open Income:Crypto:Airdrops
1970-01-01 open Income:Crypto:DeFi:Yield
1970-01-01 open Income:CapitalGains:Crypto
1970-01-01 open Income:Crypto:Trading:Margin

; Uitgavenrekeningen
1970-01-01 open Expenses:Crypto:Fees:Trading
1970-01-01 open Expenses:Crypto:Fees:Network
1970-01-01 open Expenses:Crypto:Fees:Withdrawal

; Aanvullende rekeningen voor geavanceerde scenario's
1970-01-01 open Assets:Crypto:Binance:BTC-Margin
1970-01-01 open Liabilities:Crypto:Binance:Borrowed
1970-01-01 open Liabilities:Crypto:Binance:BTC
1970-01-01 open Assets:Checking
1970-01-01 open Expenses:Crypto:Mining:Electricity

Activadefinities

Definieer uw cryptocurrencies als activa met de juiste metadata:

1970-01-01 commodity BTC
name: "Bitcoin"
asset-class: "cryptocurrency"
price-source: "coinbase"

1970-01-01 commodity ETH
name: "Ethereum"
asset-class: "cryptocurrency"
price-source: "coinbase"

1970-01-01 commodity ADA
name: "Cardano"
asset-class: "cryptocurrency"
price-source: "binance"

1970-01-01 commodity USDC
name: "USD Coin"
asset-class: "stablecoin"
price-source: "coinbase"

1970-01-01 commodity UNI
name: "Uniswap"
asset-class: "cryptocurrency"
price-source: "coinbase"

1970-01-01 commodity UNI-V2-ETH-USDC
name: "Uniswap V2 ETH-USDC LP Token"
asset-class: "liquidity-pool"

Cryptotransacties Beheersen: Van Eenvoudig tot Geavanceerd

Klaar om Beancount.io in actie te zien? Laten we eens kijken naar praktijkscenario's die andere boekhoudsystemen zouden ontwrichten, maar hier elegant worden afgehandeld.

1. Je Eerste Bitcoin Aankoop (De Instapdrug)

Elke cryptoreis begint ergens. Zo leg je dat levensveranderende moment vast waarop je je eerste Bitcoin kocht:

2024-01-15 * "Buy 0.5 BTC on Coinbase"
Assets:Crypto:Coinbase:BTC 0.5 BTC {30000.00 USD}
Assets:Crypto:Coinbase:USD -15025.00 USD
Expenses:Crypto:Fees:Trading 25.00 USD

2. Winst nemen (of verliezen beperken) als een professional

Het moment van de waarheid: het verkopen van je crypto. Dit is waar de meeste boekhoudsystemen tekortschieten, maar Beancount.io blinkt uit met nauwkeurige kostprijsregistratie:

2024-03-20 * "Sell 0.3 BTC on Coinbase"
Assets:Crypto:Coinbase:BTC -0.3 BTC {30000.00 USD}
Assets:Crypto:Coinbase:USD 10470.00 USD
Expenses:Crypto:Fees:Trading 30.00 USD
Income:CapitalGains:Crypto 1440.00 USD ; 10470 - (0.3 × 30000) - 30 = 1440

3. Staking Beloningen: Verdienen Terwijl U Slaapt

Passief inkomen op zijn best. Maar onthoud, de IRS vereist dat staking beloningen gerapporteerd worden als belastbaar inkomen bij ontvangst, gebaseerd op de reële marktwaarde op het moment van ontvangst (volgens de IRS-richtlijnen voor digitale activa, 2024). Hoewel er lopende rechtszaken zijn (Jarrett v. Verenigde Staten), vereist de huidige officiële positie onmiddellijke rapportage. Zo kunt u ze correct bijhouden:

2024-02-01 * "ETH Staking Rewards"
Assets:Staking:Ethereum:ETH 0.05 ETH {2500.00 USD}
Income:Crypto:Staking:ETH 125.00 USD

4. DeFi Yield Farming: Waar het pittig wordt 🌶️

Welkom bij geavanceerde DeFi-boekhouding. DeFi yield farming omvat complexe multi-token transacties die geavanceerde tracking vereisen. Zo boek je een Uniswap liquiditeitspositie correct:

; Initiële liquiditeitsvoorziening
2024-01-10 * "Add liquidity to ETH-USDC pool"
Assets:Crypto:Wallet:MetaMask:ETH -10 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:USDC -25000 USDC {1.00 USD}
Assets:DeFi:Uniswap:ETH-USDC-LP 100 UNI-V2-ETH-USDC {500.00 USD}

; Beloningen claimen
2024-02-10 * "Claim Uniswap LP rewards"
Assets:Crypto:Wallet:MetaMask:UNI 50 UNI {8.00 USD}
Income:Crypto:DeFi:Yield 400.00 USD

5. Overboekingen tussen Beurzen

Bitcoin verplaatsen van Coinbase naar een Ledger wallet:

2024-01-20 * "Transfer BTC from Coinbase to Ledger"
Assets:Crypto:Coinbase:BTC -1.0 BTC {30000.00 USD}
Assets:Crypto:Wallet:Ledger:BTC 0.9995 BTC {30000.00 USD}
Expenses:Crypto:Fees:Withdrawal 0.0005 BTC {30000.00 USD}

Geavanceerde Cryptovaluta Scenario's

Margehandel

Hefboomposities vastleggen:

; Een hefboom longpositie openen (BTC lenen)
2024-02-15 * "Open 2x leveraged BTC position"
Assets:Crypto:Binance:BTC-Margin 1.0 BTC {35000.00 USD}
Liabilities:Crypto:Binance:BTC -1.0 BTC {35000.00 USD}
Expenses:Crypto:Fees:Trading 50.00 USD
Assets:Crypto:Binance:USD -50.00 USD

; De positie sluiten met winst
2024-02-20 * "Close leveraged BTC position"
Assets:Crypto:Binance:BTC-Margin -1.0 BTC {35000.00 USD}
Assets:Crypto:Binance:USD 37950.00 USD
Liabilities:Crypto:Binance:BTC 1.0 BTC {35000.00 USD}
Income:Crypto:Trading:Margin -2900.00 USD
Expenses:Crypto:Fees:Trading 50.00 USD

Airdrops en Forks

Vastleggen van gratis token distributies:

2024-03-01 * "Received UNI airdrop"
Assets:Crypto:Wallet:MetaMask:UNI 400 UNI {8.00 USD}
Income:Crypto:Airdrops 3200.00 USD

Mijnbouwactiviteiten

Voor cryptovaluta-miners:

2024-01-01 * "Bitcoin mining beloning"
Assets:Crypto:Mining:BTC 0.1 BTC {45000.00 USD}
Income:Crypto:Mining:BTC 4500.00 USD

; Miningkosten
2024-01-31 * "Mining elektriciteitskosten"
Expenses:Crypto:Mining:Electricity 800.00 USD
Assets:Checking -800.00 USD

Belastingrapportage en Naleving

Kostprijsadministratie

Beancount.io houdt automatisch de kostprijs bij met behulp van het lot-gebaseerde systeem:

; Meerdere aankopen tegen verschillende prijzen
2024-01-01 * "Koop BTC batch 1"
Assets:Crypto:Coinbase:BTC 1.0 BTC {40000.00 USD}
Assets:Crypto:Coinbase:USD -40000.00 USD

2024-02-01 * "Koop BTC batch 2"
Assets:Crypto:Coinbase:BTC 1.0 BTC {45000.00 USD}
Assets:Crypto:Coinbase:USD -45000.00 USD

; Verkoop van specifieke lots (FIFO, LIFO, of specifieke identificatie)
2024-03-01 * "Verkoop BTC via FIFO"
Assets:Crypto:Coinbase:BTC -0.5 BTC {40000.00 USD}
Assets:Crypto:Coinbase:USD 22470.00 USD
Expenses:Crypto:Fees:Trading 30.00 USD
Income:CapitalGains:Crypto 2440.00 USD ; 22470 - 20000 - 30 = 2440

Belastingrapporten Genereren

Gebruik Beancount's querysysteem en plugins om belastingrapporten te genereren:

  • Form 8949: Vermogenswinsten en -verliezen (via bean-query of plugins van derden)
  • Schedule D: Overzicht van vermogenswinsten (vereist aanvullende scripting)
  • Form 1040: Inkomsten uit staking, mining, airdrops (via aangepaste rapporten)
  • Gedetailleerde transactielogboeken: Voor auditdoeleinden

Let op: Het genereren van belastingrapporten vereist aanvullende plugins, scripts of integratie met gespecialiseerde belastingsoftware. Beancount biedt de databasis, maar specifieke belastingformulieren vereisen doorgaans maatwerkontwikkeling of tools van derden.

Beste praktijken voor crypto boekhouding

1. Regelmatige Reconciliatie

  • Importeer wekelijks transactiegegevens van exchanges
  • Controleer maandelijks walletsaldi
  • Kruiscontroleer met blockchain-explorers

2. Juiste Documentatie

  • Bewaar alle transactiebevestigingen
  • Documenteer het doel van elke transactie
  • Houd gegevens bij van marktprijzen op het moment van de transactie

3. Scheid Zakelijk en Persoonlijk

; Persoonlijke crypto-investeringen
Assets:Personal:Crypto:Coinbase:BTC

; Zakelijke crypto-activiteiten
Assets:Business:Crypto:Treasury:BTC

4. Volg Alle Inkomstenbronnen

  • Staking beloningen (belastbaar als inkomen)
  • Mining beloningen (belastbaar als inkomen)
  • Airdrops (belastbaar tegen reële marktwaarde)
  • DeFi rendement (belastbaar als inkomen)

5. Kostenbeheer

Houd alle kosten afzonderlijk bij voor een correcte belastingaftrek:

Expenses:Crypto:Fees:Trading     ; Beurs transactiekosten
Expenses:Crypto:Fees:Network ; Blockchain netwerkkosten
Expenses:Crypto:Fees:Withdrawal ; Opnamekosten

Integratie met Populaire Crypto Tools

Integratie met Exchange API's

Beancount.io kan integreren met grote exchanges:

  • Coinbase Pro API: Automatische transactie-import
  • Binance API: Realtime balansupdates
  • Kraken API: Synchronisatie van historische gegevens

Blockchain Analyse

Verbind met blockchain verkenners:

  • Etherscan: Ethereum transactieverificatie
  • Blockchain.info: Bitcoin transactie volgen
  • BscScan: Binance Smart Chain monitoring

Portfoliotracking

Synchroniseren met portfoliomanagementtools:

  • CoinTracker: Genereren van belastingrapporten
  • Koinly: Aggregatie van meerdere beurzen
  • Blockfolio: Mobiele portfoliotracking

Belangrijke vrijwaringen

Fiscale en Juridische Kennisgeving: Deze gids biedt algemene informatie over cryptocurrency boekhouding met Beancount en vormt geen professioneel fiscaal, juridisch of financieel advies. De fiscale behandeling van cryptocurrency transacties varieert per jurisdictie en individuele omstandigheden. Complexe scenario's zoals cross-chain bridges, impermanent loss en flash loans kunnen onduidelijke fiscale implicaties hebben onder de huidige regelgeving. Voor specifieke richtlijnen over de vraag of transacties belastbare vervreemdingen vormen, raadpleeg IRS FAQ Q-15 t/m Q-18 (2024) of raadpleeg lokale belastingregelgeving. Raadpleeg altijd een gekwalificeerde belastingadviseur of CPA die bekend is met cryptocurrency belastingheffing in uw jurisdictie voordat u belastinggerelateerde beslissingen neemt.

Softwaretoelichting: Voorbeelden in deze gids gebruiken standaard Beancount-syntaxis. Hoewel Beancount.io een gebruiksvriendelijke interface voor Beancount biedt, zijn de onderliggende boekhoudprincipes van toepassing op elke Beancount-implementatie.

Conclusie

Cryptocurrency boekhouding hoeft niet overweldigend te zijn. Met Beancounts krachtige platte-tekst boekhoudsysteem, toegankelijk via het platform van Beancount.io, kunt u:

  • Volledige Transparantie Behouden: Elke transactie is zichtbaar en controleerbaar
  • Fiscale Naleving Garanderen: Correcte kostprijsbepaling en inkomstenrapportage
  • Schaalbaar met Uw Portfolio: Van eenvoudige transacties tot complexe DeFi-strategieën
  • Naadloos Integreren: Verbinden met exchanges, wallets en belastingtools
  • Uw Records Toekomstbestendig Maken: Platte-tekst formaat garandeert toegankelijkheid op lange termijn

Of u nu een casual Bitcoin-houder bent of een geavanceerde DeFi yield farmer, Beancount biedt de basis en flexibiliteit die nodig zijn om cryptocurrency boekhouding onder de knie te krijgen. Begin met basistransacties en integreer geleidelijk complexere scenario's naarmate uw crypto-reis zich ontwikkelt.

De voorbeelden in deze gids bieden een solide basis, maar onthoud dat cryptocurrency boekhouding een evoluerend vakgebied is. Blijf op de hoogte van wijzigingen in de regelgeving, raadpleeg belastingprofessionals en pas uw boekhoudpraktijken aan waar nodig.

Klaar om de controle over uw cryptocurrency financiën te nemen? Meld u aan voor Beancount.io en ervaar de kracht van transparante, scriptbare crypto boekhouding, gebouwd op de robuuste Beancount-basis.

DeFi Boekhouding Eenvoudig Gemaakt: Het bijhouden van Yield Farming, Liquiditeitspools en Staking Beloningen met Plain-Text Boekhouding

· 7 minuten leestijd
Mike Thrift
Mike Thrift
Marketing Manager

Gedecentraliseerde Financiën (DeFi) heeft een revolutie teweeggebracht in de manier waarop we omgaan met financiële diensten, en biedt ongekende mogelijkheden voor het genereren van rendement, het verschaffen van liquiditeit en gedecentraliseerde handel. Echter, met deze mogelijkheden komt de uitdaging om complexe transacties nauwkeurig bij te houden voor belastingnaleving en portfoliomanagement.

Traditionele boekhoudmethoden worstelen met de unieke kenmerken van DeFi: geautomatiseerde market makers, liquiditeitsmining, impermanent verlies en multi-token beloningen. Deze uitgebreide gids laat zien hoe u DeFi-boekhouding onder de knie krijgt met behulp van Beancount.io's krachtige plain-text boekhoudsysteem.

DeFi Boekhouding Eenvoudig Gemaakt

Inzicht in DeFi Boekhoudkundige Uitdagingen

De Complexiteit van DeFi-Transacties

DeFi-protocollen creëren boekhoudkundige uitdagingen die niet bestaan in traditionele financiën:

  • Multi-token transacties: Enkele operaties waarbij meerdere cryptocurrencies betrokken zijn
  • Geautomatiseerde compounding: Beloningen die automatisch worden herbelegd
  • Impermanente verlies: Waardeveranderingen als gevolg van prijsverschillen in liquiditeitspools
  • Optimalisatie van gasvergoedingen: Complexe kostenstructuren over verschillende netwerken
  • Protocolbestuur: Stemrechten en distributies van governance-tokens
  • Cross-protocol interacties: Transacties die meerdere DeFi-platforms omvatten

Fiscale Gevolgen van DeFi-activiteiten

De IRS behandelt DeFi-activiteiten als belastbare gebeurtenissen:

  • Liquiditeitsverschaffing: Kan belastbare gebeurtenissen teweegbrengen bij het storten van activa
  • Yield farming beloningen: Belastbaar als gewoon inkomen tegen reële marktwaarde
  • Impermanent verlies: Potentiële fiscale gevolgen bij het opnemen uit pools
  • Governance-tokens: Airdrops en beloningen belastbaar als inkomen
  • Staking beloningen: Belastbaar als inkomen bij ontvangst

Instellen van DeFi-rekeningen in Beancount.io

Uitgebreide Rekeningstructuur

Creëer een gedetailleerde rekeninghiërarchie die alle DeFi-activiteiten vastlegt:

; Portefeuille Rekeningen
1970-01-01 open Assets:Crypto:Wallet:MetaMask:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:USDC
1970-01-01 open Assets:Crypto:Wallet:MetaMask:DAI
1970-01-01 open Assets:Crypto:Wallet:MetaMask:WBTC

; Uniswap V3 Liquiditeitspools
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:DeFi:Uniswap:DAI-USDC-LP
1970-01-01 open Assets:DeFi:Uniswap:WBTC-ETH-LP

; Compound Protocol
1970-01-01 open Assets:DeFi:Compound:cUSDC
1970-01-01 open Assets:DeFi:Compound:cETH
1970-01-01 open Assets:DeFi:Compound:cDAI

; Aave Protocol
1970-01-01 open Assets:DeFi:Aave:aUSDC
1970-01-01 open Assets:DeFi:Aave:aETH
1970-01-01 open Assets:DeFi:Aave:DebtETH

; Staking Protocollen
1970-01-01 open Assets:Staking:Ethereum:ETH
1970-01-01 open Assets:Staking:Lido:stETH
1970-01-01 open Assets:Staking:RocketPool:rETH

; Inkomstenrekeningen
1970-01-01 open Income:DeFi:Rendement:Uniswap
1970-01-01 open Income:DeFi:Rendement:Compound
1970-01-01 open Income:DeFi:Rendement:Aave
1970-01-01 open Income:DeFi:Staking:Ethereum
1970-01-01 open Income:DeFi:Governance:Tokens
1970-01-01 open Income:DeFi:Airdrops

; Kostenrekeningen
1970-01-01 open Expenses:DeFi:Gas:Ethereum
1970-01-01 open Expenses:DeFi:Gas:Polygon
1970-01-01 open Expenses:DeFi:Gas:Arbitrum
1970-01-01 open Expenses:DeFi:ImpermanentVerlies

DeFi-specifieke Activa

Definieer tokens en LP-tokens met de juiste metadata:

1970-01-01 commodity UNI-V3-ETH-USDC
name: "Uniswap V3 ETH-USDC LP Token"
asset-class: "liquidity-pool"
protocol: "uniswap-v3"

1970-01-01 commodity cUSDC
name: "Compound USDC"
asset-class: "lending-token"
protocol: "compound"

1970-01-01 commodity stETH
name: "Lido Staked Ethereum"
asset-class: "staking-derivative"
protocol: "lido"

Gangbare DeFi-activiteiten Bijhouden

1. Uniswap Liquiditeitsverschaffing

Liquiditeit Toevoegen aan een Pool

2024-01-15 * "Liquiditeit toevoegen aan ETH-USDC Uniswap V3 pool"
Assets:Crypto:Wallet:MetaMask:ETH -5.0 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:USDC -12500 USDC
Assets:DeFi:Uniswap:ETH-USDC-LP 100 UNI-V3-ETH-USDC {250.00 USD}
Expenses:DeFi:Gas:Ethereum 0.01 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.01 ETH {2500.00 USD}

Claimen van LP-vergoedingen

2024-02-15 * "Uniswap LP-vergoedingen claimen"
Assets:Crypto:Wallet:MetaMask:ETH 0.2 ETH {2600.00 USD}
Assets:Crypto:Wallet:MetaMask:USDC 300 USDC
Income:DeFi:Yield:Uniswap 820.00 USD
Expenses:DeFi:Gas:Ethereum 0.005 ETH {2600.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.005 ETH {2600.00 USD}

Liquiditeit verwijderen met Impermanent Verlies

2024-03-15 * "Remove liquidity from ETH-USDC pool"
Assets:DeFi:Uniswap:ETH-USDC-LP -100 UNI-V3-ETH-USDC {250.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH 4.8 ETH {2800.00 USD}
Assets:Crypto:Wallet:MetaMask:USDC 12800 USDC
Expenses:DeFi:ImpermanentLoss 240.00 USD ; IL berekening
Expenses:DeFi:Gas:Ethereum 0.008 ETH {2800.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.008 ETH {2800.00 USD}

2. Compound Protocol Uitleen

Activa Leveren aan Compound

2024-01-20 * "Supply USDC to Compound"
Assets:Crypto:Wallet:MetaMask:USDC -10000 USDC
Assets:DeFi:Compound:cUSDC 500 cUSDC {20.00 USD}
Expenses:DeFi:Gas:Ethereum 0.008 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.008 ETH {2500.00 USD}

Samengestelde rente verdienen

2024-02-20 * "Opbouw van samengestelde rente"
Assets:DeFi:Compound:cUSDC 5.2 cUSDC {20.50 USD}
Income:DeFi:Yield:Compound 106.60 USD

COMP-beloningen claimen

2024-02-20 * "COMP governance-tokens claimen"
Assets:Crypto:Wallet:MetaMask:COMP 12 COMP {85.00 USD}
Income:DeFi:Governance:Tokens 1020.00 USD
Expenses:DeFi:Gas:Ethereum 0.006 ETH {2600.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.006 ETH {2600.00 USD}

3. Aave Protocol Operaties

Storten en Lenen

; ETH storten als onderpand
2024-01-25 * "Deposit ETH to Aave"
Assets:Crypto:Wallet:MetaMask:ETH -10 ETH {2500.00 USD}
Assets:DeFi:Aave:aETH 10 aETH {2500.00 USD}
Expenses:DeFi:Gas:Ethereum 0.01 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.01 ETH {2500.00 USD}

; USDC lenen met ETH als onderpand
2024-01-25 * "Borrow USDC from Aave"
Assets:Crypto:Wallet:MetaMask:USDC 15000 USDC
Liabilities:DeFi:Aave:DebtUSDC -15000 USDC
Expenses:DeFi:Gas:Ethereum 0.008 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.008 ETH {2500.00 USD}

Leningen terugbetalen met rente

2024-03-25 * "USDC-lening terugbetalen aan Aave"
Liabilities:DeFi:Aave:DebtUSDC 15000 USDC
Expenses:DeFi:Interest:Aave 450 USDC ; Opgebouwde rente
Assets:Crypto:Wallet:MetaMask:USDC -15450 USDC
Expenses:DeFi:Gas:Ethereum 0.008 ETH {2700.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.008 ETH {2700.00 USD}

4. Ethereum Staking

Directe Ethereum Staking

2024-01-10 * "ETH staken op Ethereum 2.0"
Assets:Crypto:Wallet:MetaMask:ETH -32 ETH {2500.00 USD}
Assets:Staking:Ethereum:ETH 32 ETH {2500.00 USD}
Expenses:DeFi:Gas:Ethereum 0.01 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.01 ETH {2500.00 USD}

Staking Beloningen

2024-02-10 * "ETH staking beloningen"
Assets:Staking:Ethereum:ETH 0.15 ETH {2600.00 USD}
Income:DeFi:Staking:Ethereum 390.00 USD

Liquid Staking met Lido

2024-01-12 * "Stake ETH with Lido"
Assets:Crypto:Wallet:MetaMask:ETH -10 ETH {2500.00 USD}
Assets:Staking:Lido:stETH 10 stETH {2500.00 USD}
Expenses:DeFi:Gas:Ethereum 0.008 ETH {2500.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.008 ETH {2500.00 USD}

Geavanceerde DeFi Scenario's

Yield Farming Strategieën

Multi-protocol Yield Farming

; Stap 1: Stort USDC op Compound
2024-01-30 * "Stort USDC op Compound voor yield farming"
Activa:Crypto:Portemonnee:MetaMask:USDC -20000 USDC
Activa:DeFi:Compound:cUSDC 1000 cUSDC {20.00 USD}

; Stap 2: Leen DAI met cUSDC als onderpand
2024-01-30 * "Leen DAI van Compound"
Activa:Crypto:Portemonnee:MetaMask:DAI 15000 DAI
Passiva:DeFi:Compound:SchuldDAI -15000 DAI

; Stap 3: Voorzie DAI-USDC liquiditeit aan Uniswap
2024-01-30 * "Voeg DAI-USDC liquiditeit toe voor farming"
Activa:Crypto:Portemonnee:MetaMask:DAI -15000 DAI
Activa:Crypto:Portemonnee:MetaMask:USDC -5000 USDC ; Extra USDC
Activa:DeFi:Uniswap:DAI-USDC-LP 200 UNI-V3-DAI-USDC {100.00 USD}

Cross-chain DeFi Operaties

Activa Overbruggen

2024-02-05 * "ETH overbruggen naar Polygon"
Assets:Crypto:Wallet:MetaMask:ETH -5 ETH {2600.00 USD}
Assets:Crypto:Wallet:Polygon:ETH 5 ETH {2600.00 USD}
Expenses:DeFi:Bridge:Fees 0.01 ETH {2600.00 USD}
Assets:Crypto:Wallet:MetaMask:ETH -0.01 ETH {2600.00 USD}

Flitsleningen en Arbitrage

2024-02-10 * "Arbitragemogelijkheid met flitslening"
; Flitslening
Assets:Crypto:Temp:FlashLoan 100000 USDC
Liabilities:DeFi:Aave:FlashLoan -100000 USDC

; Arbitragehandel
Assets:Crypto:Temp:FlashLoan -100000 USDC
Assets:Crypto:Temp:Arbitrage 101500 USDC

; Terugbetaling flitslening
Liabilities:DeFi:Aave:FlashLoan 100000 USDC
Assets:Crypto:Temp:Arbitrage -100090 USDC ; Inclusief kosten

; Winst
Assets:Crypto:Wallet:MetaMask:USDC 1410 USDC
Income:DeFi:Arbitrage:Profit 1410.00 USD

DeFi Belastingrapportage Overwegingen

Inkomstenherkenning

Alle DeFi beloningen zijn belastbaar als gewoon inkomen:

; Houd alle inkomstenbronnen afzonderlijk bij
Income:DeFi:Yield:Uniswap ; LP-kosten
Income:DeFi:Yield:Compound ; Verdiende rente
Income:DeFi:Staking:Ethereum ; Staking beloningen
Income:DeFi:Governance:Tokens ; Airdrops van governance-tokens
Income:DeFi:Airdrops ; Airdrops van protocollen

Aftrekbare Uitgaven

Volg aftrekbare uitgaven:

Expenses:DeFi:Gas:Ethereum          ; Gaskosten
Expenses:DeFi:Gas:Polygon ; Layer 2 kosten
Expenses:DeFi:Interest:Aave ; Leenkosten
Expenses:DeFi:ImpermanentLoss ; IL van LP-posities

Bijhouden van Vermogenswinsten

Gebruik lot-gebaseerde boekhouding voor nauwkeurige vermogenswinsten:

; Verschillende kostprijs voor hetzelfde token
Assets:DeFi:Compound:cUSDC 100 cUSDC {20.00 USD} ; Partij 1
Assets:DeFi:Compound:cUSDC 100 cUSDC {21.00 USD} ; Partij 2

Beste Praktijken voor DeFi Boekhouding

1. Realtime Transactieregistratie

  • Registreer transacties onmiddellijk na uitvoering
  • Gebruik transactiehashes voor verificatie
  • Monitor mempool voor lopende transacties

2. Gaskostenoptimalisatie Bijhouden

; Strategieën voor gaskostenoptimalisatie bijhouden
Expenses:DeFi:Gas:Ethereum:Standard ; Standaard gasprijs
Expenses:DeFi:Gas:Ethereum:Fast ; Snelle gasprijs
Expenses:DeFi:Gas:Ethereum:Instant ; Directe gasprijs

3. Protocol Risicobeheer

; Volg protocol-specifieke risico's
Expenses:DeFi:Risk:SmartContract ; Smart contract storingen
Expenses:DeFi:Risk:Liquidation ; Liquidatiegebeurtenissen
Expenses:DeFi:Risk:Slippage ; Slippage kosten

4. Geautomatiseerde Afstemming

  • Stel geautomatiseerde prijzenfeeds in
  • Gebruik protocol-API's voor saldoverificatie
  • Implementeer geautomatiseerde transactie-imports

5. Documentatienormen

  • Gedetailleerde transactienotities bijhouden
  • De rationale achter de strategie documenteren
  • Vastleggingen van protocolinteracties bijhouden

Integratie met DeFi Tools

Portfoliotracking

  • DeBank: DeFi-portfolio overzicht
  • Zapper: Multi-protocol dashboard
  • Zerion: DeFi-wallet en -tracker

Belastingrapportage

  • Koinly: DeFi belastingberekeningen
  • CoinTracker: Ondersteuning voor meerdere protocollen
  • TokenTax: Gespecialiseerde DeFi rapportage

Analyseplatformen

  • DeFi Pulse: Protocolanalyse
  • DeFiLlama: TVL en rendementsregistratie
  • APY.vision: Registratie van impermanent verlies

Conclusie

De complexiteit van DeFi-boekhouding mag u er niet van weerhouden deel te nemen aan de gedecentraliseerde financiële revolutie. Met het krachtige plain-text boekhoudsysteem van Beancount.io kunt u:

  • Complexe Transacties Volgen: Naadloos omgaan met interacties tussen meerdere protocollen
  • Fiscale Naleving Garanderen: Correcte inkomstenherkenning en uitgavenregistratie
  • Portefeuilleprestaties Monitoren: Realtime inzichten in DeFi-posities
  • Risico Beheren: Impermanent verlies en protocolrisico's volgen
  • Activiteiten Schalen: Van eenvoudig staken tot complexe yield farming-strategieën

De sleutel tot succesvolle DeFi-boekhouding is consistentie, nauwkeurigheid en correcte categorisatie. Begin met basisprotocollen en breid geleidelijk uit naar complexere strategieën naarmate u vertrouwd raakt met de boekhoudpatronen.

Klaar om de DeFi-boekhouding te beheersen? Begin uw Beancount.io-reis en neem vandaag nog de controle over uw gedecentraliseerde financiële portefeuille.

De Plattekst Revolutie: Hoe Moderne Financeteams Hun Technologische ROI Vertienvoudigen met Code-Gebaseerde Boekhouding

· 4 minuten leestijd
Mike Thrift
Mike Thrift
Marketing Manager

In een recente McKinsey-enquête rapporteerde 78% van de CFO's dat hun verouderde financiële systemen hen belemmerden bij digitale transformatie. In plaats van meer complexe softwareoplossingen toe te voegen, boeken vooruitstrevende financeteams succes door hun boekhouding als code te behandelen via plattekstboekhouding.

Organisaties, variërend van wendbare startups tot gevestigde ondernemingen, ontdekken dat tekstgebaseerd financieel beheer de technologiekosten drastisch kan verlagen, terwijl de nauwkeurigheid en automatiseringsmogelijkheden worden verbeterd. Door versiebeheerde, programmeerbare financiële records te omarmen, bouwen deze teams veerkrachtige systemen die effectief schalen.

2025-05-19-maximizing-technology-roi-in-financial-management-a-plain-text-accounting-approach

De Verborgen Kosten van Traditionele Financiële Software: Een Analyse van de TCO

Naast de voor de hand liggende licentiekosten brengt traditionele financiële software aanzienlijke verborgen kosten met zich mee. Updates en onderhoud gaan vaak gepaard met onverwachte uitgaven - een enquête van Fintech Magazine uit 2022 wees uit dat 64% van de financeteams hogere dan verwachte kosten op deze gebieden tegenkwam.

De inflexibiliteit van conventionele systemen creëert zijn eigen kosten. Eenvoudige aanpassingen kunnen weken of maanden duren, wat leidt tot productiviteitsverlies omdat teams om softwarebeperkingen heen werken in plaats van dat de software voor hen werkt. Trainingsvereisten voegen een extra kostenlaag toe, waarbij bedrijven doorgaans tot 20% van de initiële software-investering alleen al aan de onboarding van medewerkers besteden.

Beveiliging vormt extra uitdagingen. Naarmate cyberdreigingen evolueren, moeten organisaties voortdurend investeren in nieuwe beschermende maatregelen. Uit onze eigen ervaring blijkt dat verouderde financiële software bedrijven vaak blootstelt aan grotere beveiligingsrisico's.

Plattekstboekhouding: Waar Versiebeheer en Financiële Precisie Samenkomen

Plattekstboekhouding combineert de transparantie van tekstbestanden met de nauwkeurigheid van dubbel boekhouden. Met behulp van versiebeheerhulpmiddelen zoals Git kunnen financeteams wijzigingen volgen met dezelfde precisie als softwareontwikkelaars code-wijzigingen volgen.

Deze aanpak transformeert auditing van een gevreesde taak in een eenvoudige controle. Teams kunnen direct zien wanneer en waarom specifieke transacties zijn gewijzigd. Een recente casestudy toonde aan hoe een startup Beancount gebruikte om een langlopende factureringsfout te identificeren, deze tot de bron te herleiden en preventieve maatregelen te implementeren.

De flexibiliteit maakt experimenten met verschillende rapportagestructuren mogelijk zonder de gegevensintegriteit in gevaar te brengen. In ons eigen werk hebben startups de maandelijkse afsluitingstijd met ongeveer 40% verkort door gestroomlijnd gegevensbeheer en verbeterde samenwerking.

De Geldstroom Automatiseren: Schaalbare Financiële Workflows Bouwen met Code

Code-gebaseerde automatisering transformeert routinematige financiële taken in gestroomlijnde workflows. In plaats van late avonden spreadsheets te controleren, kunnen teams reconciliaties automatiseren en zich richten op strategische analyse.

We hebben gezien dat middelgrote technologiebedrijven aangepaste scripts maken voor onkostenrapporten en factuurverwerking, waardoor de afsluitingstijd met ongeveer 40% wordt verkort. Dit versnelt niet alleen de rapportage, maar verbetert ook het teammoreel door de focus op waardevolle activiteiten zoals prognoses mogelijk te maken.

De schaalbaarheid van code-gebaseerde systemen biedt een cruciaal voordeel naarmate organisaties groeien. Terwijl traditionele spreadsheets onhandelbaar worden met schaal, kunnen programmatische workflows elegant omgaan met toenemende complexiteit door doordachte automatisering.

Integratie-intelligentie: Uw Financiële Stack Verbinden via Plattekstsystemen

De ware kracht van plattekstboekhouding ligt in het vermogen om verschillende financiële systemen te verbinden. Door mens- en machineleesbare formaten te gebruiken, dient het als een universele vertaler tussen verschillende tools en platforms.

We hebben waargenomen dat het verenigen van systemen via plattekstboekhouding handmatige invoerfouten met ongeveer 25% kan verminderen. De programmeerbare aard maakt aangepaste integraties mogelijk die precies aansluiten bij de behoeften van de organisatie.

Succesvolle integratie vereist echter zorgvuldige planning. Teams moeten automatiseringsmogelijkheden in evenwicht brengen met het handhaven van passende controles en toezicht. Het doel is om een responsief financieel ecosysteem te creëren en tegelijkertijd nauwkeurigheid en compliance te waarborgen.

Succes Meten: Real-World ROI-Statistieken van Teams die Plattekstboekhouding Gebruiken

Vroege adopters rapporteren overtuigende resultaten over meerdere statistieken. Naast directe kostenbesparingen zien teams verbeteringen in nauwkeurigheid, efficiëntie en strategisch vermogen.

We hebben gezien dat organisaties de kwartaalrapportagetijd aanzienlijk verkorten – soms met ongeveer 50% – door geautomatiseerde gegevensverwerking. We hebben ook waargenomen dat de voorbereidingstijd voor audits met ongeveer 25% is verkort dankzij betere transactietracking en versiebeheer.

De meest significante winsten komen vaak voort uit vrijgekomen capaciteit voor strategisch werk. Teams besteden minder tijd aan handmatige reconciliatie en meer tijd aan het analyseren van gegevens om zakelijke beslissingen te stimuleren.

Conclusie

De verschuiving naar plattekstboekhouding vertegenwoordigt een fundamentele evolutie in financieel beheer. Uit onze eigen ervaring kan dit leiden tot 40-60% reductie in verwerkingstijd en drastisch minder reconciliatiefouten.

Succes vereist echter meer dan alleen het implementeren van nieuwe tools. Organisaties moeten investeren in training, workflows zorgvuldig ontwerpen en robuuste controles handhaven. Wanneer doordacht uitgevoerd, kan de transitie financiën transformeren van een kostenpost naar een strategische drijfveer van bedrijfswaarde.

De vraag is niet of plattekstboekhouding standaardpraktijk zal worden, maar eerder wie de early-mover voordelen in hun branche zal behalen. De tools en praktijken zijn volwassen genoeg voor praktische implementatie, terwijl ze nog steeds aanzienlijke concurrentievoordelen bieden aan organisaties die bereid zijn het voortouw te nemen.

Het Beancount Ecosysteem: Een Uitgebreide Analyse

· 33 minuten leestijd
Mike Thrift
Mike Thrift
Marketing Manager

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.

2025-04-15-beancount-ecosystem

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:

Tool/ExtensieBeschrijving
Fava (webinterface)Volledige webapplicatie voor het bekijken en bewerken van Beancount-boeken. Biedt interactieve rapporten (balans, winst- en verliesrekening, etc.), grafieken en zoekmogelijkheden. Een belangrijke gebruiksvriendelijkheidsbooster voor Beancount.
Beangulp (importframework)Op zichzelf staand importframework voor Beancount v3, ter vervanging van de oudere ingest-module. Helpt bij het converteren van bankafschriften (CSV, PDF, etc.) naar Beancount-posten met behulp van plugin-scripts.
Beanquery (query-tool)Op zichzelf staande SQL-achtige query-engine voor Beancount-gegevens. Vervangt bean-query in v3, waardoor geavanceerde zoekopdrachten naar transacties en saldi mogelijk zijn via een bekende SELECT-FROM-WHERE-syntaxis.
Bean-check / Bean-formatKern-CLI-tools om een Beancount-bestand te valideren (controleren op fouten) en automatisch te formatteren voor consistentie. Handig voor het onderhouden van een correct en schoon grootboek.
Editor Plugins (Emacs, VSCode, Vim, etc.)Plugins/modi die Beancount-syntaxis ondersteuning en linting toevoegen in teksteditors. Verbeteren de ervaring van het handmatig bewerken van .beancount-bestanden met functies zoals auto-aanvulling en live foutmarkering.
Community ImportersVerzamelingen van bankimportscripts (veel op GitHub) die banken in de VS, EU, Azië en daarbuiten bestrijken. Staan gebruikers toe om transacties van hun financiële instellingen automatisch in Beancount in te voeren.
Plugins (Grootboekextensies)Optionele in-bestand plugins om regels af te dwingen of functionaliteit toe te voegen (bijv. kosten delen, terugkerende posten, aangepaste saldobevestigingen). Geschreven in Python en uitgevoerd tijdens de bestandsverwerking voor aanpassing.

| 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:

AspectBeancount (Python)Ledger CLI (C++)hledger (Haskell)
Syntaxis & BestandsstructuurStrikte, gestructureerde syntaxis gedefinieerd door een formele grammatica (BNF). Transacties hebben expliciete datum vlag "Begunstigde" "Omschrijving" reg

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

De Magie van Plain Text Boekhouden met Beancount

· 5 minuten leestijd
Mike Thrift
Mike Thrift
Marketing Manager

Ontdek de Magie van Plain Text Boekhouden met Beancount

Beancount.io banner

Introductie

2023-04-18-introductie-tot-beancount

Welkom in een wereld waar boekhouden geen ontmoedigende taak meer is. Vandaag introduceren we u Beancount, een krachtige, flexibele en intuïtieve plain text boekhoudtool. Beancount stelt u in staat om controle te krijgen over uw financiën door een transparante en eenvoudige benadering te bieden voor het beheren van uw geld.

In deze uitgebreide gids duiken we in de basisprincipes van Beancount, leggen we de kernconcepten uit en leiden we u door de eenvoudige doch krachtige functies. Aan het einde van deze blog heeft u een gedegen begrip van Beancount en bent u klaar om het te gebruiken om uw financiële leven te organiseren en te analyseren.

Wat is Beancount?

Beancount is een open-source, plain text boekhoudsysteem, gecreëerd door Martin Blais. Geïnspireerd door John Wiegley's Ledger-systeem, streeft Beancount ernaar een robuuste en betrouwbare methode te bieden voor het beheren van persoonlijke en kleine bedrijfsfinanciën met behulp van plain text bestanden. Met Beancount kunt u eenvoudig uw inkomsten, uitgaven, investeringen en nog veel meer bijhouden.

Waarom Beancount?

Plain text boekhouden biedt verschillende voordelen ten opzichte van traditionele spreadsheet-gebaseerde of software-gebaseerde boekhoudsystemen:

  • Transparantie: Beancount-bestanden zijn menselijk leesbaar, waardoor het eenvoudig is om uw financiële gegevens te begrijpen en te controleren.
  • Flexibiliteit: Beancount kan eenvoudig worden aangepast aan uw specifieke behoeften, en u kunt uw favoriete teksteditor en versiebeheersysteem gebruiken om uw financiële gegevens te beheren.
  • Portabiliteit: Uw financiële gegevens zijn toegankelijk op elk apparaat, en het is eenvoudig om ze over te dragen tussen systemen of te delen met anderen.
  • Toekomstbestendig: Plain text bestanden zijn universeel compatibel, wat garandeert dat uw financiële gegevens toegankelijk blijven, zelfs naarmate technologie evolueert.

Kernconcepten van Beancount

Om Beancount effectief te gebruiken, is het cruciaal om de kernconcepten te begrijpen:

  • Transacties: Financiële gebeurtenissen, zoals inkomsten, uitgaven of overboekingen tussen rekeningen, worden vastgelegd als transacties.
  • Rekeningen: Transacties omvatten één of meer rekeningen, zoals activa, passiva, inkomsten of uitgaven.
  • Dubbele boekhouding: Beancount handhaaft dubbele boekhouding, wat garandeert dat elke transactie gebalanceerde debets en credits heeft.
  • Directieven: Beancount gebruikt een set directieven om transacties, rekeningopeningen en andere financiële gebeurtenissen te definiëren.

Aan de slag met Beancount

Volg deze eenvoudige stappen om Beancount te gaan gebruiken:

  • Installeer Beancount: Installeer Beancount op uw systeem met behulp van de meegeleverde installatie-instructies voor uw besturingssysteem.
  • Maak uw Beancount-bestand: Maak een nieuw plain text bestand met de .beancount extensie (bijv. mijn_financiën.beancount).
  • Definieer uw rekeningen: Gebruik de "open" directive om de rekeningen te definiëren die u in uw transacties zult gebruiken.
  • Registreer transacties: Gebruik de "txn" directive om uw financiële transacties vast te leggen.

Of meld u eenvoudig aan op https://beancount.io. Hier zijn enkele plain text boekhoudvoorbeelden -

Voorbeeld 1: Basis Transactie

2023-04-01 open Assets:Checking
2023-04-01 open Expenses:Groceries

2023-04-10 txn "Grocery Store" "Buying groceries"
Assets:Checking -50.00 USD
Expenses:Groceries 50.00 USD

In dit voorbeeld openen we twee rekeningen, Activa:Betaalrekening en Uitgaven:Boodschappen. Op 10 april 2023 registreren we een transactie voor het kopen van boodschappen ter waarde van $50. De transactie vermindert het saldo van Activa:Betaalrekening met $50 (debet) en verhoogt het saldo van Uitgaven:Boodschappen met $50 (credit).

Voorbeeld 2: Inkomsten- en Uitgavetransactie

2023-04-01 open Assets:Checking
2023-04-01 open Income:Salary
2023-04-01 open Expenses:Rent

2023-04-05 txn "Employer" "Salary payment"
Assets:Checking 2000.00 USD
Income:Salary -2000.00 USD

2023-04-06 txn "Landlord" "Monthly rent payment"
Assets:Checking -1000.00 USD
Expenses:Rent 1000.00 USD

In dit voorbeeld openen we drie rekeningen: Activa:Betaalrekening, Inkomsten:Salaris en Uitgaven:Huur. Op 5 april 2023 registreren we een salarisbetalingstransactie van $2000. De transactie verhoogt het saldo van Activa:Betaalrekening met $2000 (credit) en verlaagt het saldo van Inkomsten:Salaris met $2000 (debet). Op 6 april 2023 registreren we een huurbetalingstransactie van $1000. De transactie vermindert het saldo van Activa:Betaalrekening met $1000 (debet) en verhoogt het saldo van Uitgaven:Huur met $1000 (credit).

Voorbeeld 3: Overboeking Tussen Rekeningen

2023-04-01 open Assets:Checking
2023-04-01 open Assets:Savings

2023-04-15 txn "Bank" "Transfer from Checking to Savings"
Assets:Checking -500.00 USD
Assets:Savings 500.00 USD

In dit voorbeeld openen we twee rekeningen: Activa:Betaalrekening en Activa:Spaarrekening. Op 15 april 2023 registreren we een transactie om $500 over te boeken van de betaalrekening naar de spaarrekening. De transactie vermindert het saldo van Activa:Betaalrekening met $500 (debet) en verhoogt het saldo van Activa:Spaarrekening met $500 (credit).

Deze voorbeelden illustreren de basisconcepten van Beancount's dubbele boekhoudsysteem. Door transacties correct vast te leggen, kunnen gebruikers nauwkeurige overzichten van hun financiële activiteiten bijhouden en rapporten genereren om inzicht te krijgen in hun financiële situatie.

Rapporten Genereren en Gegevens Analyseren

Beancount wordt geleverd met een reeks krachtige tools voor het genereren van financiële rapporten, waaronder balansen, winst- en verliesrekeningen en meer. U kunt ook Fava gebruiken, een webgebaseerde gebruikersinterface voor Beancount, om uw financiële gegevens te visualiseren en ermee te interacteren. https://beancount.io is gebouwd op Fava met MIT-licentie.

Conclusie

Omarm de kracht en eenvoud van plain text boekhouden met Beancount. Door de kernconcepten te begrijpen en de stappen in deze gids te volgen, bent u goed op weg om uw persoonlijke of kleine bedrijfsfinanciën met gemak en precisie te beheren. Naarmate u meer vertrouwd raakt met Beancount, kunt u geavanceerde functies en aanpassingen verkennen om het systeem af te stemmen op uw unieke behoeften.

Of u nu uw uitgaven wilt bijhouden, wilt plannen voor de toekomst, of inzicht wilt krijgen in uw financiële gewoonten, Beancount biedt de flexibiliteit en transparantie die nodig zijn om uw doelen te bereiken. Met zijn gebruiksvriendelijke benadering heeft Beancount het potentieel om de manier waarop u uw financiën beheert te revolutioneren en u in staat te stellen de controle over uw financiële toekomst te nemen.

Nu u een solide basis in Beancount heeft, is het tijd om aan uw plain text boekhoudreis te beginnen. Zeg vaarwel tegen omslachtige spreadsheets en ingewikkelde software, en verwelkom de wereld van Beancount. Veel plezier met boekhouden!