29. Bankovní účty a e-mailová avíza (IMAP)

Cesta: Peníze → Bankovní účty

Stránka sdružuje záložku Bankovní výpisy (import GPC a párování plateb — viz 28. Banka), dvě záložky účetní automatiky — K zaúčtování a Pravidla účtování (viz § 29.8, vidí je jen dodavatel s podvojným účetnictvím) — a tři administrátorské záložky: Měny a účty, Stavy na účtech a Bankovní avíza z e-mailu.

Tato kapitola popisuje správu bankovních účtů dodavatele (pro PDF faktury, QR platby a GPC výpisy) a bankovních e-mailových avíz přes IMAP. Bankovní avízo je e-mail od banky s údaji o platbě — MyÚčto ho umí pravidelně načítat, vytěžit z něj VS, částku, měnu, datum a cílový účet a vytvořit z něj bankovní transakci stejně jako z výpisu.

29.1 Bankovní účty

Sekce Měny + bankovní účty je čistý seznam účtů dodavatele. Účet zde nastavuješ stejně jako pro PDF faktury, QR platby a GPC výpisy:

• měna a označení účtu,
• české číslo účtu + kód banky,
• případně IBAN/BIC,
• výchozí účet pro danou měnu,
• aktivní/neaktivní stav.

Nastavení bankovních avíz je oddělené níže, aby se běžné bankovní údaje nemíchaly s parsery a IMAP účty.

29.1.1 Stavy na účtech

Záložka Stavy na účtech zobrazuje každý bankovní účet samostatně podle čísla účtu, kódu banky a měny. Aktuální stav vychází z posledního oficiálního GPC nebo PDF výpisu; pokud je dostupné novější e-mailové avízo s disponibilním zůstatkem, použije se novější údaj.

Pod tabulkou je pro každý účet samostatný graf měsíčních konečných zůstatků v jeho vlastní měně. Graf Celkový vývoj v CZK zobrazuje jednotlivé účty i řadu Celkem. Cizoměnové účty se pro tento graf přepočítávají kurzem ČNB ke konci příslušného měsíce.

Pokud mají dva účty stejné číslo před lomítkem, rozlišují se kódem banky. Starý výpis bez uloženého kódu banky se při více možných bankách do zůstatku nezapočte, protože jej nelze bezpečně přiřadit.

29.2 Mapování bankovních avíz

Sekce Mapování bankovních avíz určuje, jak se vytěžený e-mail napojí na konkrétní bankovní účet dodavatele.

Mapování se vyhodnocuje až po úspěšném vytěžení e-mailu. Pokud e-mail přijde z jiného IMAP účtu nebo ho zpracoval jiný parser, než je v mapování nastaveno, řádek se nepoužije.

Nové nebo nenastavené mapování začíná volbou Žádný IMAP účet. Takový řádek se při scanování nepoužije, dokud nezvolíš konkrétní IMAP účet nebo vědomě nepovolíš variantu Všechny IMAP účty.

29.3 IMAP účty pro bankovní avíza

Každý dodavatel může mít více IMAP účtů, typicky jeden pro každou banku.

Pokud do schránky chodí avíza přeposlaná (např. z firemní schránky na sběrnou adresu), zapni Přijímat přeposlaná (FW) avíza. U přímého avíza poznává banku podle odesílatele, ale přeposláním se odesílatelem stáváš ty — proto se pak banka hledá i z těla e-mailu. Volitelně omez E-mail přeposílatele, ať se zpracují jen avíza od tvé adresy. Přeposláním zaniká původní podpis banky (DKIM), takže ověření autenticity se vztahuje na přeposílatele, ne na banku.

Polling zprávy standardně neoznačuje jako přečtené. Systém si úspěšně zpracované e-maily pamatuje v databázi podle Message-ID / UID / fallback hashe, takže funguje i s účtem, kde aplikace nemůže zprávy přesouvat nebo označovat. Pokud má účet zápis povolený, můžeš zvolit doplňkovou akci po úspěchu: neměnit zprávu, přidat flag, přesunout do jiné složky nebo označit jako přečtené.

29.4 Parser provideri

Provider říká, jak poznat e-mail dané banky a jak z něj vytěžit platební údaje.

Typy providerů:

• Systémový provider — dodaný aplikací, např. Raiffeisenbank, UniCredit Bank, ČSOB, Česká spořitelna, Fio banka, Banka CREDITAS nebo MONETA Money Bank.
• Regex provider — vlastní provider dodavatele, konfigurovaný v UI.

Systémový provider se přímo needituje (je společný pro všechny). Když ho chceš upravit, použij u něj tlačítko Duplikovat — vytvoří se editovatelná kopie, ve které si dolaď vzory a otestuj ji přes Test parseru. V mapování účtu pak přepneš účet z původního providera na svou kopii. Duplikovat lze i vlastní regex provider.

Detekce e-mailu i vytěžení polí pracují tolerantně k diakritice: pokud avízo dorazí v jiném kódování nebo s rozbitou diakritikou (typicky u přeposlaných zpráv), vzory Směr platby a Smer platby se vyhodnotí stejně. Když přesto nějaký provider zlobí, můžeš si vzory napsat rovnou bez diakritiky.

U regex provideru nastavuješ:

Povinná vytěžená pole:

• variable_symbol
• amount
• currency
• posted_at
• recipient_account

Volitelná pole:

• counterparty_account
• counterparty_name
• constant_symbol
• message
• bank_ref
• balance (disponibilní zůstatek účtu z avíza — zobrazí se v detailu měsíčního avízo-výpisu a promítne se do přehledu Stavy na účtech)

Regex parser používá první zachycenou skupinu nebo pojmenovanou skupinu se stejným názvem jako pole. Pro částku umí formáty typu +1.234,56, datum např. 01. 06. 2026 10:15.

29.5 Příklad regex provideru pro Raiffeisenbank

Následující příklad je anonymizovaný. Čísla účtů, variabilní symbol, název protistrany i zpráva jsou fiktivní. Do manuálu nikdy nedávej reálné e-maily z banky s osobními údaji, zůstatky nebo skutečnými čísly účtů.

Testovací text e-mailu může vypadat např. takto:

Datum a čas
01. 06. 2026 10:15
Na účet
123456789/5500Firma Test s.r.o.
Částka v měně účtu
+1.234,56 CZK
Z účtu
987654321/5500Plátce Demo s.r.o.
Variabilní symbol
2606001
Konstantní symbol
308
Zpráva pro příjemce
Faktura 2606001
Disponibilní zůstatek po pohybu
+99.999,99 CZK

Základní nastavení provideru:

Regex předmětu:

Pohyb\s+na\s+účtě|Pohyb\s+na\s+ucte

Regexy pro vytěžená pole:

🛈 Do UI zadávej regex bez krajních oddělovačů (/.../). Parser je doplní sám.

29.6 Test parseru a zpracované e-maily

V sekci Parser provideri můžeš vložit testovací e-mail, odesílatele a předmět. Test ukáže, který provider se použil a jaká pole se vytěžila.

Sekce Zpracované e-maily je debug přehled:

• zobrazuje Message-ID / fallback hash,
• IMAP účet,
• datum a čas zpracování,
• stav zpracování,
• použitý provider,
• vytěžené platební údaje,
• navázanou transakci nebo fakturu.

Hlavní stav se průběžně odvozuje z aktuálního párování transakce. Pokud byla platba úspěšně spárovaná, případná chyba následného přesunu nebo označení e-mailu v IMAP už nezobrazuje párování jako neúspěšné; původní post-processing chyba zůstane viditelná jako upozornění.

Smazání záznamu zde nemaže transakci ani fakturu. Maže jen deduplikační záznam, takže je možné stejný e-mail znovu zpracovat při dalším scanu. Používej to jen jako emergency/debug akci.

29.7 Cron pro e-mailová avíza

Pro automatické zpracování nastav samostatný cron:

cmd/cron-bank-email-notices.sh   # každých 30 minut

Skript spustí php api/bin/cron-bank-email-notices.php, projde aktivní IMAP účty dodavatele, načte nejnovější zprávy podle limitu a zapíše heartbeat do plánovaných úloh.

29.8 Automatické zaúčtování bankovních transakcí (jen podvojné účetnictví)

Bankovní výpis (§ 24) i e-mailové avízo (§ 29.1–37.7) řeší jen párování na faktury. Transakce, které s fakturou nesouvisí — bankovní poplatky, úroky, odvody sociálního a zdravotního pojištění, splátky leasingu, převody mezi vlastními účty — potřebují vlastní účetní zápis (MD/D dle Předkontace). O to se stará PostingService a dvě záložky na téže stránce Peníze → Bankovní účty, viditelné jen dodavateli s podvojným účetnictvím:

• K zaúčtování — fronta návrhů zápisů čekajících na schválení.
• Pravidla účtování — naučená pravidla, podle kterých se opakující se platby (odvody, poplatky, úroky) rozpoznají a zaúčtují samy.

29.8.1 Pravidla účtování

Tlačítkem Nové pravidlo (nebo přímo z platby přes hint „Podobná platba se opakuje" — viz § 29.8.4) založíš pravidlo:

Pravidlo musí mít aspoň jedno kritérium (protiúčet, VS nebo fragment zprávy) — samotný rozsah částky nestačí. Kontace má dvě záměrná omezení:

• Bankovní strana musí být účet 221 (dle směru — příchozí = MD 221, odchozí = D 221). Pravidlo vždy účtuje proti bankovnímu účtu.
• Druhá strana nesmí být saldokontní účet (311, 321, 314, 324, 325) — platby faktur se párují (§ 24.4), ne účtují pravidlem.

29.8.2 Režim Návrh vs. Automaticky

Nové pravidlo je vždy v režimu Návrh — každá shoda jen vytvoří položku v záložce K zaúčtování, kterou musíš ručně Schválit nebo Odmítnout. Po pěti potvrzeních za sebou beze změny, bez odmítnutí a s vyplněným rozsahem částky se u pravidla objeví Povýšit na automatiku. Režim se nikdy nepřepne sám — povýšení vždy potvrdí člověk. V automatickém režimu se zápis do deníku vytvoří rovnou při shodě, bez čekání na schválení. Tlačítko Historie ukazuje potvrzení, korekce, povýšení i případný návrat pravidla na návrhy.

Pokud transakci odpovídá víc aktivních pravidel najednou, systém nikdy neúčtuje automaticky — vytvoří jen návrh podle pravidla s nejvyšší úspěšností a označí ho jako konfliktní. Když se u transakce nenajde žádné pravidlo, zkusí ještě rozpoznat vzor podle historie — pokud se stejný protiúčet a směr v minulosti opakovaně účtovaly na stejnou dvojici účtů, nabídne se návrh označený jako „naučeno", i bez existujícího pravidla.

Automatické zaúčtování se nikdy neprovede do uzavřeného účetního období — místo zápisu vznikne jen návrh s poznámkou o uzavřeném období, který doplníš ručně po otevření období.

29.8.3 Schvalování návrhů a záložka „K zaúčtování"

Záložka K zaúčtování má čtyři podzáložky — K zaúčtování (čekající), Zaúčtováno automaticky, Schválené a Odmítnuté. U čekajícího návrhu vidíš datum, částku, protistranu, navrhované pravidlo a kontaci (MD/D):

• Schválit — vytvoří zápis do deníku (viz Předkontace pro logiku sestavení zápisu) a návrh přejde do stavu Schváleno.
• Odmítnout — návrh se zahodí; ke stejné transakci a pravidlu se už znovu nenabídne. Tři odmítnutí stejného pravidla po sobě ho automaticky deaktivují (na to upozorní hláška) — pravidlo zjevně přestalo sedět.
• Ikonou ozubeného kola u řádku přepíšeš MD/D účty ještě před schválením, aniž bys musel(a) upravovat pravidlo.
• Upravená kontace se uloží jako učicí signál. Další naučený návrh u stejného protějšku ukáže, kdy a z jakých účtů byla kontace změněna.
• Víc řádků najednou vyřídíš přes hromadné Schválit vybrané.

Transakce v cizí měně se automaticky ani návrhem zatím neúčtují (chybí řešení kurzových rozdílů) — takové řádky nesou štítek Cizí měna a řeší se ručně v Předkontace.

U už zaúčtovaných položek (podzáložka Zaúčtováno automaticky) vidíš odkaz na zápis v deníku a tlačítko Stornovat — vytvoří opravný (storno) zápis a transakci vrátí mezi nezaúčtované, aniž by se mazala historie. Pokud zápis vytvořilo automatické pravidlo, storno ho zároveň vrátí do režimu Návrh. Nezvyšuje tím počet odmítnutí.

29.8.4 Založení pravidla přímo z platby

Když se v posledním roce objeví podobná platba víckrát (stejný protiúčet nebo VS) a ještě pro ni neexistuje pravidlo, nabídne se u transakce ve výpisu (§ 24) hláška „Podobná platba se opakuje (N× za poslední rok)" s tlačítkem Vytvořit pravidlo — otevře formulář pravidla předvyplněný podle dané transakce (protiúčet, VS, fragment zprávy, rozsah částky ±10 % okolo částky) i s vybranou kontací, kterou stačí zkontrolovat a uložit.