Hoe we banktransacties in de self-hosted Actual Budget-server automatisch categoriseren, payee-namen opschonen en verwerken tot 50-30-20 budgetrapportages direct in Telegram.
Het handmatig exporteren, importeren en categoriseren van transacties in budgetbeheersoftware is een taak die vaak wordt uitgesteld. Zonder real-time updates verlies je snel het overzicht over vaste lasten, variabele uitgaven en spaardoelen.
De uitdaging was om een 100% lokale, privacy-vriendelijke oplossing te bouwen die transacties automatisch ophaalt uit bank-exports, deze opruimt en indeelt op basis van specifieke regels, en het resultaat proactief presenteert in een wekelijks/maandelijks overzicht.
Het systeem maakt gebruik van de API van de self-hosted Actual Budget server (`actual.tom.cool`). Een cron-gebaseerde Python pipeline voert twee kritieke scripts uit:
Fuzzy matching reinigt payee-namen (bijv. "Lars Karsten Wilguetersloh" wordt "Lars Karsten") en koppelt de transactie direct aan de juiste categorie op basis van keywords.
Transacties worden verdeeld in Needs (vaste lasten), Wants (vrije tijd) en Savings (beleggingen en spaargelden) om de procentuele verhouding te controleren.
Rapporten worden maandelijks geformatteerd en via een Telegram bot direct naar Tom & Lien gestuurd, inclusief waarschuwingen bij budgetoverschrijdingen.
"Geen handmatige exports meer en direct een helder overzicht van onze financiële gezondheid per Telegram aan het einde van elke maand. Zo moet budgetteren zijn."
— Tom CoolVan custom API-koppelingen tot geautomatiseerde rapportages via Telegram of e-mail — ik bouw betrouwbare pipelines op maat.
Bespreek uw project Bekijk andere cases