Čo prepojenie robí
Fio banka má verejné API na sťahovanie výpisov. Keď doň vložíte token, Monivio:
- stahuje nové pohyby každé 2 minúty - bez vášho zásahu, bez nahrávania výpisov
- páruje ich s dokladmi - každá nová transakcia prejde párovaním rovnako, ako keby ste ju importovali ručne
- aktualizuje zostatok účtu - zostatok berie priamo z výpisu
- preskočí duplicity - pohyb, ktorý už v Monivio je, sa druhýkrát nezaloží
Prepojenie je len na čítanie. Cez API sa nedá zadať ani odoslať platba.
Predpoklady
- Máte rolu Admin (bežný člen prepojenie nastaviť nemôže)
- V Monivio máte pridaný bankový účet s Fio IBAN-om - slovenský s kódom banky
8330alebo český s kódom2010. Ak ho ešte nemáte, pozrite Pridanie bankových účtov. - Máte prístup do Fio Internetbankingu s právom vytvárať API tokeny
Prepojenie funguje len pre Fio banku. Iné banky sa zatiaľ importujú z výpisu - postup je v článku Prehľad transakcií.
Krok 1: Vytvorenie tokenu vo Fio Internetbankingu
Token sa nevytvára v Monivio, ale vo vašom internetbankingu:
- Prihláste sa do Fio Internetbankingu
- Otvorte Nastavenie → API
- Vytvorte nový token pre ten účet, ktorý chcete prepojiť
- Nastavte mu práva len na čítanie (na sťahovanie výpisov viac netreba)
- Token si skopírujte
Token je prístup k výpisom vášho účtu - správajte sa k nemu ako k heslu. Fio vám ho zobrazí pri vytvorení; ak ho stratíte, vytvorte nový a starý zrušte.
Obrazovky Fio Internetbankingu v tomto návode nenájdete - je to aplikácia banky a jej vzhľad sa môže meniť nezávisle od Monivio.
Krok 2: Otvorenie Fio prepojenia
V ľavom menu otvorte Financie → Bankové účty. Pri účte s Fio IBAN-om sa zobrazí odznak Fio API - kliknutím naň otvoríte dialóg prepojenia. Rovnaká položka je aj v menu s tromi bodkami pri účte.
Krok 3: Vloženie tokenu a prvý import
Token vložte do poľa API token a kliknite Prepojiť a stiahnuť.
Pri uložení sa stanú tri veci:
- Monivio si tokenom vyžiada výpis z Fio a overí, že patrí k tomu istému IBAN-u a mene, aké má účet v Monivio. Ak token patrí inému účtu, prepojenie sa neuloží a dozviete sa to hneď.
- Token sa uloží zašifrovaný. Späť sa už nikdy nezobrazí ani nevypíše do logov.
- Okamžite sa naimportuje posledných 30 dní transakcií. Koľko ich bolo, vám povie potvrdzovacia správa.
Ak sa prepojenie neuloží kvôli nezhode IBAN-u, nemeňte účet v Monivio - skontrolujte najprv, či ste token vo Fio vytvorili pre správny účet. Firmy s viacerými Fio účtami si ich vedia takto ľahko pomýliť.
Krok 4: Ako beží synchronizácia
Po prepojení dialóg ukazuje stav: Aktívne, čas poslednej synchronizácie a prípadnú chybu.
| Čo | Ako to funguje |
|---|---|
| Automaticky | Každé 2 minúty. Sťahuje sa od dátumu poslednej transakcie s dvojdňovým prekryvom, aby neušli pohyby, ktoré banka zapísala so spätným dátumom. |
| Ručne | Tlačidlo Stiahnuť teraz. Na jeden účet je povolené jedno stiahnutie za 30 sekúnd - je to limit Fio API, nie náš. |
| Stav Čiastočne spracované | Časť riadkov z výpisu sa nepodarilo prečítať. Ostatné sa naimportovali. |
| Stav Chyba | Posledný pokus zlyhal celý. Dôvod je vypísaný priamo v dialógu. |
Stiahnutie historických transakcií
Prvý import berie 30 dní. Ak potrebujete aj staršie pohyby - napríklad celý rok kvôli spätnému spárovaniu nákladov - použite Stiahnuť históriu.
Postup:
- Vo poli Stiahnuť históriu od vyberte dátum, od ktorého chcete pohyby
- Kliknite Stiahnuť históriu
- Potvrdzovacia správa povie, koľko nových transakcií pribudlo
Transakcie, ktoré už v Monivio sú, sa nezduplikujú - históriu si viete pokojne vyžiadať aj opakovane.
Keď je história starší ako 90 dní
Fio pri dátach starších ako 90 dní vyžaduje silnú autorizáciu. Bez nej vráti chybu a nič sa nestiahne. Odomknutie sa robí vo Fio, nie v Monivio:
- Vo Fio Internetbankingu otvorte Nastavenie → API
- Kliknite na zámok pri tomto tokene a autorizujte ho
- Vráťte sa do Monivio a do 10 minút spustite Stiahnuť históriu
Odomknutie platí 10 minút a pre konkrétny token. Ak okno prešvihnete, Monivio vypíše, že je historický prístup zamknutý - vtedy stačí zámok autorizovať znova.
Ak ste práve token vložili alebo stiahli pohyby, počkajte pred stiahnutím histórie 30 sekúnd. Inak narazíte na limit jedného stiahnutia za 30 sekúnd a budete musieť klikať druhýkrát - čo vám môže zjesť časť desaťminútového okna.
Čo sa stane s naimportovanými transakciami
Naimportované pohyby sa chovajú presne ako tie z výpisu:
- prejdú automatickým párovaním s faktúrami a nákladmi
- nespárované nájdete vo Financie → Transakcie → Nepárované a priradíte ručne - postup je v článku Párovanie platieb z banky
- zostatok účtu sa aktualizuje podľa výpisu
Odpojenie
V dialógu kliknite Odpojiť a potvrďte.
Odpojenie zastaví automatické sťahovanie a zmaže uložený token. Transakcie, doklady ani párovania sa nemažú. Prepojiť účet znova môžete kedykoľvek - potrebujete naň nový alebo pôvodný token.
Riešenie problémov
| Správa | Čo s tým |
|---|---|
| Tento IBAN nepatrí podporovanému účtu vo Fio banke | Účet nie je vedený vo Fio. Odznak Fio API sa zobrazuje len pri IBAN-e s kódom banky 8330 (SK) alebo 2010 (CZ). |
| Token patrí k inému IBAN-u | Token bol vo Fio vytvorený pre iný účet. Vytvorte token pre ten účet, ktorý prepájate. |
| Token patrí k účtu s inou menou | Účet v Monivio má nastavenú inú menu ako skutočný Fio účet. Opravte menu na účte. |
| Pred ďalším stiahnutím počkajte aspoň 30 sekúnd | Limit Fio API. Počkajte a kliknite znova. |
| Historický prístup je zamknutý | Odomknite zámok pri tokene vo Fio Internetbankingu a do 10 minút to zopakujte. |
| Fio synchronizácia zlyhala | Prechodná chyba na strane Fio alebo siete. Automatický cyklus to skúsi znova do 2 minút. Ak stav Chyba pretrváva, napíšte nám na support@monivio.sk. |
Čo ďalej?
- Párovanie platieb z banky - ako sa transakcie priraďujú k faktúram a nákladom
- Prehľad transakcií - filtre, stavy a import z výpisu pre ostatné banky
- Pridanie bankových účtov - pridanie ďalšieho účtu a nastavenie predvoleného