- Nápověda
- Banky a platby
Banky a platbyNávod krok za krokem
Fio banka: automatické stahování pohybů do Doruna
Propojte účet ve Fio bance s Doruna API tokenem. Pohyby se pak stahují samy každých 10 minut a Doruna k platbám navrhne, ke které faktuře patří.
Obsah návodu
Co propojení umí
- Stahuje pohyby z účtu ve Fio bance do Doruna: datum, částku, měnu, variabilní, konstantní a specifický symbol, název a číslo protiúčtu a zprávu pro příjemce.
- Hned po vložení tokenu stáhne pohyby za posledních 89 dní. Potom se každých 10 minut sama zeptá na nové.
- Při uložení tokenu i při každém stažení porovná číslo účtu, které Fio k tokenu uvádí, s účtem v Doruna — token jiného účtu odmítne a jeho pohyby nenahraje.
- U plateb navrhne fakturu, ke které nejspíš patří — podle částky, variabilního symbolu, účtu a jména protistrany. Návrh potvrdíte v detailu pohybu.
- Pohyb, který už v Doruna je, podruhé nezaloží — ani když stejný pohyb nahrajete z výpisu CSV z bankovnictví Fio.
- Funguje na každém tarifu Doruna, včetně Free.
Co propojení neumí
- Neplatí a nezadává příkazy — Doruna z Fio jen čte pohyby.
- Bez dalšího potvrzení v bankovnictví nestáhne pohyby starší než 90 dní (pravidlo Fio). Starší historii nahrajte z výpisu ručním importem.
- Nestahuje oficiální výpisy v PDF ani zůstatek z banky — zůstatek Doruna počítá z počátečního stavu a pohybů.
- Jeden token patří vždy k jednomu účtu. Máte-li u Fio víc účtů (třeba v CZK a v EUR), každý potřebuje vlastní token.
- Pohyby sama nezaúčtuje: zaúčtování a spárování s fakturou potvrzujete vy (pokud si nenastavíte pravidla automatizace).
Co k tomu potřebujete
- Účet ve Fio bance a přístup do internetového bankovnictví s právem zakládat API tokeny — má ho majitel účtu nebo osoba s příslušnými právy.
- Telefon k potvrzení tokenu (kód z SMS nebo potvrzení ve Smartbankingu). Podepisuje-li účet víc osob, token musí podepsat všechny.
- Tarif Doruna: kterýkoli, i Free. Free má jeden bankovní účet, Pro tři a Business neomezený počet.
- V Doruna roli s přístupem k bankovním účtům (menu Bankovnictví), která smí měnit data — s rolí Jen čtení token neuložíte.
Část 1: token v internetovém bankovnictví Fio
Token je klíč, kterým si Doruna u Fio vyžádá pohyby jednoho účtu. Vytvoříte ho jednou, trvá to asi tři minuty.
Část 2: token v Doruna
Token vložíte k bankovnímu účtu v Doruna, který odpovídá účtu ve Fio.
Založte účet Fio v Doruna
Otevřete synchronizaci účtu
Vložte token a uložte
Hotovo
Jak to funguje
- Token se uloží zašifrovaný k bankovnímu účtu v Doruna. Při uložení Doruna stáhne pohyby za posledních 89 dní — starší data Fio bez dalšího potvrzení v bankovnictví nevydá.
- Fio ke každé odpovědi uvádí účet, ke kterému token patří. Doruna ho porovná s číslem účtu (nebo IBAN) v Doruna: nesouhlasí-li, token při uložení odmítne a při stažení pohyby nenahraje — u účtu pak svítí Chyba synchronizace s textem, ke kterému účtu token patří.
- Potom se Doruna každých 10 minut zeptá Fio na pohyby od posledního stažení; co už jednou vydalo, si pamatuje Fio.
- Každý pohyb má u Fio jedinečné ID pohybu. Podle něj Doruna pozná pohyb, který už má, a nezaloží ho podruhé — ani z automatického stažení, ani z ručního importu výpisu CSV.
- Nové pohyby dostanou návrh kategorie a protistranu podle vašich kontaktů. Pokud máte pravidla automatizace pro banku, uplatní se na ně.
- Ručně stáhnete pohyby kdykoli: tlačítkem Synchronizovat v záložce Synchronizace (pohyby za posledních 89 dní) nebo ikonou obnovení v seznamu účtů (pohyby od posledního stažení). Mezi dvěma staženími musí být aspoň 30 sekund.
- Stahují se jen bankovní účty v limitu tarifu. Účet, který se po přechodu na nižší tarif zamkne, se nestahuje, dokud tarif nezvýšíte.
Jak ověřit, že vše funguje
- V Bankovnictví je u účtu ve sloupci Synchronizace zelený štítek Synchronizováno s datem poslední synchronizace.
- Otevřete účet: pohyby za poslední tři měsíce odpovídají internetovému bankovnictví Fio.
- Nová platba na účet se v Doruna objeví nejpozději asi za 10 minut po tom, co ji uvidíte v bankovnictví Fio.
Řešení problémů
| Co vidíte | Proč | Co udělat |
|---|---|---|
| U účtu svítí „Chyba synchronizace“ a po najetí myší: „Fio vrátilo chybu 500 — podle dokumentace Fio token neexistuje nebo není aktivní: vypršel (platí nejvýš 180 dní), byl zrušen, nebo je mladší než 5 minut. Zkontrolujte ho v internetovém bankovnictví Fio → Nastavení → API a případně uložte nový přes „Změnit token“. Je-li token platný, jde o výpadek u Fio — zkuste to později.“ | Chybou 500 Fio podle své dokumentace odmítá token, který neexistuje nebo není aktivní: je mladší než 5 minut, vypršela mu platnost (nejvýš 180 dní) nebo byl zrušen. Méně často jde o výpadek u Fio. | Je-li token čerstvý, počkejte 5 minut a klikněte na Synchronizovat. Jinak otevřete v bankovnictví Fio Nastavení → API a zkontrolujte, že je token aktivní a platný. Pokud ne, vytvořte nový a v Doruna ho vložte přes Změnit token. Je-li token v pořádku, zkuste synchronizaci později. |
| „Fio API neodpovědělo do 60 sekund. Zkuste synchronizaci prosím později; pokud se to opakuje, zkontrolujte i platnost tokenu v internetovém bankovnictví Fio → Nastavení → API.“ | Fio na dotaz neodpovědělo včas — obvykle přetížení nebo údržba u Fio, výjimečně i neplatný token. | Počkejte, automatická synchronizace to zkusí znovu za 10 minut. Opakuje-li se chyba celý den, zkontrolujte token v bankovnictví Fio (Nastavení → API). |
| „Fio API je dočasně nedostupné (chyba 503). Zkuste synchronizaci prosím později.“ (místo 503 může být 502 nebo 504) nebo „Spojení s Fio API se nepodařilo navázat. Zkuste synchronizaci prosím později.“ | Výpadek nebo údržba na straně Fio, případně dočasný problém se spojením. | Nic nedělejte, automatická synchronizace to zkusí znovu za 10 minut. Případně klikněte na Synchronizovat později. |
| „Fio API nenašlo účet k tomuto tokenu (404). Zkontrolujte token v Internetbankingu → Nastavení → API.“ | Fio dotazu nerozumí — token je nejčastěji zkopírovaný neúplně nebo s mezerou či jiným znakem navíc. | V bankovnictví Fio klikněte na Zobrazit celý token, zkopírujte všech 64 znaků a v Doruna ho vložte znovu přes Změnit token. |
| „Fio API: příliš mnoho požadavků. Mezi dvěma dotazy na jeden token musí být alespoň 30 sekund. Zkuste to prosím za chvíli.“ | Fio dovolí na jeden token nejvýš jeden dotaz za 30 sekund. Synchronizovali jste krátce po předchozím stažení (třeba těsně po automatickém), nebo stejný token používá i jiný program. | Počkejte aspoň 30 sekund a zkuste to znovu. Pro Doruna si vytvořte vlastní token a nesdílejte ho s jiným programem. |
| „Fio bez dodatečného potvrzení vydává jen pohyby z posledních 90 dní (chyba 422). Starší pohyby zpřístupníte v internetovém bankovnictví Fio → Nastavení → API kliknutím na ikonu zámku u tokenu a potvrzením — přístup platí 10 minut, během nich spusťte synchronizaci znovu. Nebo starší pohyby nahrajte ručním importem výpisu.“ | Doruna žádá pohyby starší než 90 dní (třeba po delší přestávce v synchronizaci) a přístup k celé historii není u tokenu odemčený. | Starší historii nahrajte z výpisu ručním importem na stránce účtu — pohyby se nezdvojí. Chcete-li ji stáhnout přes API, v bankovnictví Fio v Nastavení → API klikněte u tokenu na ikonu zámku, potvrďte a do 10 minut klikněte v Doruna v seznamu účtů na ikonu obnovení. |
| „Fio odmítlo vydat pohyby: na jeden dotaz vydá nejvýš 50 000 pohybů a v požadovaném období jich je víc (chyba 413). Starší pohyby nahrajte ručním importem výpisu; pokud chyba trvá, napište podpoře Doruna.“ | V požadovaném období je na účtu víc než 50 000 pohybů — tolik Fio na jeden dotaz nevydá. | Starší pohyby nahrajte z výpisu ručním importem na stránce účtu. Když chyba trvá, napište na podpora@doruna.cz. |
| „Fio API vrátilo neočekávanou chybu (kód …). Zkuste synchronizaci prosím později; pokud chyba trvá, zkontrolujte token v internetovém bankovnictví Fio → Nastavení → API.“ | Fio odpovědělo kódem, který jeho dokumentace mezi známými chybami neuvádí. | Zkuste synchronizaci později. Když chyba trvá, zkontrolujte token v bankovnictví Fio a napište podpoře s číslem kódu z hlášení. |
| „Pohyby z Fio se nepodařilo uložit. Zkuste synchronizaci prosím znovu; pokud chyba trvá, napište podpoře Doruna.“ | Fio pohyby vydalo, ale Doruna je nedokázala uložit — chyba na straně Doruna. | Klikněte na Synchronizovat znovu. Když chyba trvá, napište na podpora@doruna.cz. |
| „Fio API vrátilo prázdnou odpověď. Zkuste synchronizaci prosím později.“ | Fio odpovědělo bez dat — obvykle krátké přetížení nebo údržba u Fio. | Nic nedělejte, automatická synchronizace to zkusí znovu za 10 minut. Případně klikněte na Synchronizovat později. |
| Pohyby se po několika měsících přestaly stahovat. | Token Fio platí nejvýš 180 dní. Bez automatického prodlužování — nebo když se dlouho nepřihlásíte do bankovnictví ani Smartbankingu — vyprší. | V bankovnictví Fio vytvořte nový token se zapnutým automatickým prodlužováním a v Doruna ho vložte přes Změnit token. |
| V záložce Synchronizace chybí pole pro token a je tam „Zatím jen pro Fio banku. Pro ostatní banky použijte ruční import níže.“ | Účet v Doruna nemá jako banku zvolenou Fio banka. | V záložce Nastavení účtu vyberte banku Fio banka a klikněte na Uložit. Pak účet otevřete znovu a pokračujte záložkou Synchronizace. |
| Při přidání dalšího účtu se otevře okno tarifu: „V bezplatném plánu můžete mít jeden bankovní účet. Pro přidání dalších účtů přejděte na Pro.“ | Tarif Free má jeden bankovní účet, Pro tři a Business neomezený počet. | Přejděte na vyšší tarif v Nastavení → Fakturace, nebo používejte jen jeden účet. |
| „Máte k této firmě přístup jen pro čtení. Změny může provést vlastník nebo administrátor.“ | Máte ve firmě roli Jen čtení — token uložit ani synchronizaci spustit nemůžete. | Token vloží vlastník nebo administrátor firmy. |
| „Token Fio patří k účtu … ale tento účet v Doruna je …. Vložte token vytvořený pro tento účet (internetové bankovnictví Fio → Nastavení → API) — pohyby jiného účtu Doruna nenahraje.“ (při uložení tokenu, nebo u účtu jako Chyba synchronizace) | Token patří k jinému účtu ve Fio, než ke kterému jste ho v Doruna vložili — Fio u tokenu uvádí jiné číslo účtu. Token platí vždy pro jeden konkrétní účet. Případně je v Doruna u účtu zapsané jiné číslo účtu nebo IBAN. | V bankovnictví Fio v Nastavení → API vyberte v poli Účet správný účet, vytvořte pro něj token a v Doruna ho vložte přes Změnit token. Je-li špatně číslo účtu v Doruna, opravte IBAN a číslo účtu v záložce Nastavení účtu. |
| U účtu jsou pohyby, které patří k jinému účtu (stažené dřív, než Doruna začala účet tokenu kontrolovat). | Token jiného účtu Fio uložený před 23. 10. 2026 — tehdy Doruna účet tokenu nekontrolovala. | Vložte k účtu správný token (Změnit token) nebo ho odeberte (Odebrat token). S odstraněním chybně stažených pohybů pomůže podpora na podpora@doruna.cz. |
Odpojení
- V Doruna: Bankovnictví → u účtu Nastavení účtu → záložka Synchronizace → Odebrat token. V okně „Odebrat token Fio?“ potvrďte Odebrat token. Doruna token smaže a synchronizace s Fio se zastaví; ukáže „Token odebrán — synchronizace s Fio je vypnutá.“ Ve sloupci Synchronizace je pak znovu Nastavit synchronizaci.
- Token tím u Fio zrušený není — platí dál, dokud ho nezrušíte v bankovnictví Fio v Nastavení → API. Nechcete-li ho už používat, zrušte ho tam také.
- Zrušíte-li token jen u Fio a v Doruna ho necháte, bude u účtu svítit Chyba synchronizace s textem o chybě 500 (token neexistuje nebo není aktivní) — Doruna se dál ptá a Fio ji odmítá. Proto token v Doruna odeberte. Chcete-li stahování obnovit, vytvořte nový token a vložte ho přes Změnit token.
- Pohyby, které už Doruna stáhla, i jejich spárování a zaúčtování zůstávají.
- Bankovní účet v Doruna k odpojení nemažte. Účet se zaúčtovanými nebo spárovanými pohyby Doruna smazat nedovolí — dialog Smazat bankovní účet? místo smazání nabídne Archivovat účet: účet zmizí ze seznamů a výběrů, synchronizace se zastaví a pohyby, úhrady faktur i zápisy v účetním deníku zůstanou. Z archivu (dole v Bankovnictví, Archivované účty) ho vrátíte tlačítkem Obnovit. Smazat jde jen účet bez zaúčtovaných a spárovaných pohybů — i se všemi jeho pohyby.
Bezpečnost
- Stačí token s právem jen ke sledování účtu. Doruna z Fio pouze čte pohyby a nikdy nezadává platby; token s právem zadávat příkazy pro Doruna nevytvářejte.
- Token se ukládá zašifrovaný (AES-256) a po uložení se už nikomu neukáže, ani vám. V Doruna je vidět jen jeho maska — první a poslední dva znaky.
- Token je klíč k pohybům na účtu: neposílejte ho e-mailem ani do chatu. Když unikne, v bankovnictví Fio ho hned zrušte a vytvořte nový.
- Token uloží jen člen firmy s přístupem k bankovním účtům a rolí, která smí měnit data.
- Doruna se s Fio spojuje šifrovaně (HTTPS) přímo ze svého serveru a používá jen dotazy na čtení pohybů.
Časté otázky
Kolik propojení stojí?
Mám u Fio víc účtů. Stačí jeden token?
Proč se stáhly jen poslední tři měsíce?
Jak často se pohyby stahují?
Může Doruna z mého účtu poslat platbu?
Co se stane, když tokenu skončí platnost?
Související návody
NávodČeská spořitelna: propojení účtů s Doruna přes PSD2Otevřít návodNávodStripe: platby, poplatky a výplaty v účetnictví DorunaOtevřít návodNávodGoPay: výpis účtu GoPay v účetnictví DorunaOtevřít návodNávodComgate: výplaty a platby brány v účetnictví DorunaOtevřít návodNávodWise Business: pohyby z výpisu CSV nebo CAMT.053 do DorunaOtevřít návodNávodZásilkovna: výplata dobírek rozepsaná na úhrady fakturOtevřít návod
Články k tématu
ÚčetnictvíQR platba na faktuře: jak funguje a jak ji nastavitQR kód na faktuře ušetří odběrateli opisování čísla účtu a vám dohledávání plateb. Co přesně v kódu je, na čem se nejčastěji pokazí a jak ho mít na každé faktuře bez práce navíc.4 min čteníÚčetnictvíUpomínka nezaplacené faktury: kdy ji poslat a co napsatFaktura po splatnosti není důvod k rozpakům, ale k jasnému postupu. Kdy se ozvat, co napsat, na jaký úrok máte nárok a co musí proběhnout, než půjdete k soudu. Se třemi vzory, které stačí doplnit.6 min čteníBankaPárování plateb s fakturami bez ručního dohledáváníPárování plateb je nejnudnější část účetnictví a zároveň ta, na které stojí pořádek v pohledávkách. Podle čeho se pozná, která platba patří ke které faktuře, a co dělat s těmi, které nesedí.4 min čteníÚčetnictvíJak vybrat účetní program pro OSVČ a malou firmuÚčetní programy se na první pohled liší hlavně cenou a počtem funkcí. V běžném provozu ale rozhoduje něco jiného: kolik práce vám zbude. Devět kritérií a seznam otázek, které se vyplatí položit dřív, než se rozhodnete.6 min čtení