Abstraktná minimalistická vizualizácia toku dát
Logo andrejkostal.sk

2. 11. 2025 · 4 min čítania

4 min čítania · aktualizované 1. 10. 2026

Ako mi bankové e-maily plnia rozpočet v Actual Budget

Osobné financie si vediem v Actual Budget. Funguje podobne ako YNAB a má rovnaký problém: transakcie sa do neho musia nejako dostať. Ručné zadávanie ma nebavilo a služby ako Plaid alebo Salt Edge regionálne európske banky väčšinou nepodporujú.

Actual vie pripojiť banky cez GoCardless, tak som to najprv skúsil. Synchronizácia však bežala len pár ráz denne a niektoré transakcie sa nenačítali vôbec. Keď v rozpočte chýbajú transakcie alebo prídu s 12-hodinovým oneskorením, prestanete mu veriť a celé to stráca zmysel.

Potom mi došlo, že banka mi tie dáta posiela aj tak. Po každej platbe mi do pár minút príde e-mail so sumou, dátumom, obchodníkom a väčšinou aj s ID transakcie. Tieto notifikácie chodia spoľahlivo, podľa mojej skúsenosti zhruba na 99 %, lebo banka má silný dôvod ich doručiť. Rozhodol som sa teda čítať e-maily, aj keď to znamenalo viac práce s nastavením.

Od začiatku roka 2024 mi tak beží import, ktorý sám spracuje asi 95 % transakcií. Prešli ním tisíce transakcií z viacerých bánk a v rôznych menách a údržba ma stojí asi dve hodiny za rok.

Ako to funguje

Skript sa podľa plánu pripojí do schránky cez IMAP a stiahne neprečítané e-maily od odosielateľa banky. Každý e-mail prejde parserom, ktorý z neho vytiahne sumu, menu, dátum, obchodníka a ID transakcie. Transakciu potom pošle cez API do Actual Budget a e-mail označí ako prečítaný, takže ho ďalší beh už nespracuje. Okamžitý import nepotrebujem, stačí raz za hodinu alebo raz denne.

Parser je pre každú banku iný, lebo každá banka má iný formát e-mailu. Ten prvý som napísal príliš rigidne. Hľadal presný text „Amount:“ a keď ho banka prepísala na „Transaction amount:“, import sa zastavil. Prepísať ho na voľnejšie vzory mi zabralo 20 minút a odvtedy s tým mám pokoj.

Pre platbu v kaviarni vyzerá extrakcia napríklad takto.

PoleV e-mailePole v API
Suma„Amount: 45.67 EUR“amount, currency
Dátum„2025-11-02 14:35“date
Obchodník„STARBUCKS #8234 SEATTLE WA“payee_name
ID transakcie„ID: 221025/131110-2“imported_id
Účet„Card ending **5633“smerovanie na účet

Najdôležitejšie pole je ID transakcie, lebo rieši duplicity. Banka občas pošle tú istú notifikáciu dvakrát alebo skript spadne po importe, ale ešte pred označením e-mailu. Actual podľa imported_id duplicitu odmietne, takže opakovaný import nič nepokazí a nemusím nič ručne čistiť. Bez ID by som musel párovať podľa sumy, dátumu a obchodníka a dve kávy v ten istý deň by sa pobili.

Skript si nedrží žiadny stav. Všetko, čo potrebuje, je v schránke a v Actual, preto ho môžem spustiť ručne, zmeniť plán alebo nejaký beh vynechať. Na prvé spustenie, keď sú v schránke stovky starých notifikácií, sa oplatí limit, napríklad 100 e-mailov na beh, aby skript nenarazil na limity API.

Ak máte v jednej banke viac účtov, pomôžu aliasy. Notifikácie z bežného účtu nechajte chodiť na vy+bezny@example.com a zo sporiaceho na vy+sporenie@example.com. Parser potom podľa adresy vie, na ktorý účet v rozpočte transakciu zaradiť. Nie každý poskytovateľ e-mailu a nie každá banka to však podporujú.

Bezpečnosť

Tretej strane nedávam prístup k účtu a nikde neukladám prihlasovacie údaje do banky. Skript číta e-maily, ktoré mi chodia aj tak, takže kto prelomí moju schránku, vidí notifikácie aj bez neho. Pre porovnanie, asi 75 % pripojení cez Plaid ide cez API bánk. Pri zvyšku mu dáte prihlasovacie údaje do banky a on sa za vás prihlasuje do internet bankingu.

Do schránky sa nepripájajte hlavným heslom. Použite heslo pre aplikácie alebo OAuth, lebo ich viete kedykoľvek zrušiť a hlavný prístup ostane nedotknutý. Spojenie má ísť cez TLS a skript má e-maily len čítať a označovať ako prečítané. Ak ho pustíte na stroji, ktorý máte pod kontrolou, napríklad na vlastnom serveri alebo Raspberry Pi, dáta ostanú u vás.

Keď banka zmení e-mail

Banky menia šablóny e-mailov zriedka, asi raz za rok. Parser sa vtedy rozbije a transakcie sa prestanú importovať, čo si všimnem hneď. Oprava mi trvá 15-30 minút. Pozriem sa na nový formát, upravím vzory a otestujem to.

Tieto dve hodiny ročne sú cena za to, že moja banka API nemá. Mne sa ten obchod oplatí, lebo chyba je vždy viditeľná a dáta v rozpočte sa potichu nepokazia.

Postavil som to s Claude Code

Celé som to postavil s Claude Code. Napísal implementáciu v TypeScripte, IMAP klienta, regexy na parsovanie aj napojenie na Actual Budget API, takže systém bežal za pár hodín. Najviac času som strávil testovaním rôznych formátov e-mailov a ladením okrajových prípadov.

Bez základov programovania by som to neodporúčal. Keď banka zmení formát, treba rozumieť, čo kód robí, a vedieť ho opraviť. Ak čítate TypeScript alebo JavaScript a zvládate príkazový riadok, AI spraví väčšinu práce. Ak nie, bude vás to len frustrovať.

Kedy by som to nerobil

Ak vašu banku podporuje rozpočtová aplikácia alebo Plaid, použite to, lebo natívna integrácia sa pri zmene e-mailu nerozbije. Nerobil by som to ani vtedy, keď banka posiela notifikácie len nad určitú sumu alebo len pri niektorých typoch platieb, lebo časť transakcií by v rozpočte chýbala. A niekomu ručné zadávanie pomáha všímať si, kam idú peniaze, čo by automatizácia oslabila.

Ak ste postavili niečo podobné, napíšte mi na hi@andrejkostal.sk. Zaujíma ma hlavne, čo sa vám pokazilo.