Factorify umí stahovat pohyby na bankovním účtu přímo z banky, bez ručního nahrávání výpisů. U Komerční banky umí navíc odeslat platební příkaz rovnou do internetového bankovnictví, kde ho už jen podepíšeme. Dnes jsou podporované dvě banky, a to Fio banka a Komerční banka. Ruční import výpisů a jejich formáty popisuje stránka Bankovní výpisy.
Stažené pohyby se zpracují stejně jako ručně nahraný výpis. Do agendy Bankovní výpisy přibude výpis s přílohou, jednotlivé pohyby se objeví v agendě Platby a zaúčtují se podle předpisů zaúčtování. Pohyb, který už v systému je, se znovu nenaimportuje.
Pokud máme jeden bankovní účet ve více měnách, musíme ho mít ve Factorify založený pro každou měnu zvlášť. Platí to pro obě banky stejně jako u ručního importu.
¶ Fio banka
¶ Nastavení
V internetovém bankovnictví Fio banky si zřídíme token pro přístup přes API. Postup popisuje nápověda Fio banky k API. Pro stahování pohybů stačí token, který umí jen sledovat účet. Každý účet má vlastní token.
Před prvním stažením nastavíme tokenu zarážku. Zarážka určuje, od kterého dne se mají pohyby načíst. Nastavíme ji jednorázově otevřením adresy https://fioapi.fio.cz/v1/rest/set-last-date/{token}/{RRRR-MM-DD}/ v prohlížeči, kde místo {token} doplníme token a místo {RRRR-MM-DD} datum.
V agendě Banky otevřeme Fio banku a v poli Bankovní API vybereme FIO.
V agendě Bankovní účty otevřeme účet u Fio banky a do pole Token vložíme token. Pole vidí jen uživatel s oprávněním ACCOUNTING_CONFIGURATION.
¶ Jak stahování probíhá
Každé čtyři hodiny si systém stáhne pohyby, které přibyly od posledního stažení. První stažení proběhne hodinu po spuštění systému.
Každou noc v 1:00 se navíc stáhnou pohyby za posledních sedm dní. Tím se doplní případné pohyby, které by při průběžném stahování chyběly. Pohyby, které už v systému jsou, se přeskočí.
Každé stažení uloží do agendy Bankovní výpisy výpis ve formátu FioXML. Soubor od banky je u výpisu jako příloha.
¶ Komerční banka
Komerční banka zpřístupňuje účty přes službu Přímý přístup k účtům (Account Direct Access API) a dávkové platby přes službu Dávkové platby (Batch Payment Direct API). Obě služby jsou určené pro klienty, kteří používají MojeBanku Business.
¶ Kontaktování podpory Factorify
Napojení na Komerční banku nejdřív nastavíme na straně Factorify. Kontaktujeme podporu Factorify a požádáme o zapnutí napojení na Komerční banku. Podpora pro naši instanci vystaví u Komerční banky přístupové údaje aplikace (software statement) a nastaví je spolu s API klíči do konfigurace systému. Teprve potom můžeme banku propojit.
¶ Co musí mít klient v bance
Klient má MojeBanku Business a uživatele, který má práva k účtům, které chceme připojit. Tento uživatel bude propojení potvrzovat přes KB Klíč.
U účtů vedených v KB+ musí mít klient aktivovanou službu API Business. Rozsah služby a její cenu určuje Komerční banka.
Komerční banka může volání svých služeb účtovat majiteli účtu. Zdarma je jen omezený počet využití za měsíc a po jeho překročení banka účtuje poplatek podle svého ceníku. Podmínky si klient ověří ve své bance.
¶ Nastavení banky a účtů
V agendě Banky otevřeme Komerční banku. V poli Bankovní API vybereme KB.
V agendě Bankovní účty zkontrolujeme každý účet u Komerční banky, který chceme připojit. Musí mít vyplněný IBAN a správnou Měnu. Podle IBANu a měny systém při propojení pozná, který účet v bance odpovídá kterému účtu ve Factorify.
Pole Externí ID nevyplňujeme. Doplní ho systém sám při autorizaci a obsahuje identifikátor účtu, pod kterým ho zná Komerční banka.
¶ Propojení banky
Propojení má dva kroky. Nejdřív se Factorify u banky zaregistruje jako aplikace klienta, potom klient aplikaci povolí přístup k vybraným účtům. Oba kroky dělá uživatel, který se umí přihlásit do MojeBanky Business.
¶ Registrace
Otevřeme agendu Propojit banku. V poli Bankovní API vybereme KB a klikneme na Propojit banku.
Pokud už je Komerční banka v této účetní jednotce propojená, systém se zeptá, jestli stávající propojení nahradit. Nahrazením se zruší i dosavadní autorizace.
Systém nás přesměruje na stránku Komerční banky. Přihlásíme se do MojeBanky Business a registraci aplikace potvrdíme KB Klíčem.
Obrázky ze stránek Komerční banky pocházejí z ukázkové aplikace Komerční banky. Skutečné stránky se mohou v detailech lišit.
Banka nás vrátí zpět do Factorify na detail propojení v agendě Bankovní spojení. Propojení je ve stavu Neautorizováno.
¶ Autorizace
Na detailu propojení v agendě Bankovní spojení klikneme na Autorizovat spojení.
Systém nás znovu přesměruje do Komerční banky. Přihlásíme se, potvrdíme oprávnění aplikace a vybereme účty, ke kterým má Factorify přistupovat.
Po návratu do Factorify se zobrazí hláška se seznamem bankovních účtů, které se propojily. Propojení přejde do stavu Aktivní.
Pokud se žádný účet nepropojí, autorizace se přesto dokončí a hláška nás upozorní, že žádný z účtů vybraných v bance neodpovídá bankovnímu účtu ve Factorify. Doplníme u účtů IBAN a měnu a klikneme na Znovu autorizovat.
Propojení platí pro jednu účetní jednotku. Před propojením se přepneme do účetní jednotky, ke které účty patří.
¶ Stav propojení
Detail propojení v agendě Bankovní spojení ukazuje stav propojení a datum, do kterého platí autorizace.
Neautorizováno znamená, že registrace proběhla, ale klient zatím nepovolil přístup k účtům. Pohyby se nestahují.
Aktivní znamená, že propojení funguje a pohyby se stahují.
Vyžaduje novou autorizaci znamená, že autorizace vypršela nebo ji banka zrušila. Pohyby se nestahují, dokud propojení znovu neautorizujeme.
Údaje na detailu propojení vyplňuje systém a ručně se nemění.
¶ Obnovení autorizace
Autorizace platí dvanáct měsíců. Třicet dní před koncem platnosti začne systém posílat upozornění Brzy vyprší autorizace bankovního spojení. Na detailu propojení pak klikneme na Znovu autorizovat a v bance autorizaci potvrdíme stejně jako poprvé. Registraci znovu dělat nemusíme.
Pokud autorizace vyprší, nebo ji klient zruší v MojeBance Business, propojení přejde do stavu Vyžaduje novou autorizaci a přijde upozornění Neplatná autorizace bankovního spojení. Stačí znovu autorizovat.
Výběr účtů je součástí autorizace. Když chceme připojit další účet, založíme ho ve Factorify s IBANem a měnou a propojení znovu autorizujeme. Výběr účtů jde změnit i přímo v MojeBance Business v nastavení přímého přístupu k účtům.
¶ Stahování pohybů
Každý všední den v 1:00 si systém stáhne pohyby za posledních sedm dní, bez dnešního dne. O víkendu se nestahuje, pondělní stažení pokryje i víkend.
Stahují se jen zaúčtované pohyby. Blokace a pohyby, které banka teprve zpracovává, se přeskočí a stáhnou se, až je banka zaúčtuje. Pohyby, které už v systému jsou, se přeskočí.
Každé stažení uloží do agendy Bankovní výpisy výpis ve formátu KBADAA. Stažené pohyby jsou u výpisu jako příloha ve formátu JSON. Formát KBADAA se v nabídce ručního importu nenabízí, protože takový soubor banka neposkytuje.
U každého pohybu se uloží číslo účtu, kód banky, IBAN i BIC protistrany, pokud je banka pošle. Číslo tuzemského účtu systém upraví do tvaru předčíslí-číslo, stejného jako u ručně nahraných výpisů. Do Poznámky se uloží popis platby, zpráva pro příjemce a název protistrany, každý na samostatném řádku, stejně jako u formátu BEST. Do Dalších informací se uloží popis transakce od banky, například u poplatků „POPL.ZA VEDENÍ ÚČTU/BALÍČKU“.
Pokud banka vrátí pohyb v jiné měně, než je měna bankovního účtu, nebo pohyb bez identifikace od banky, systém ho přeskočí. Výpis bude mít výsledek Varování, ve zprávě o výsledku uvidíme, který pohyb se přeskočil, a přijde upozornění Import bankovních výpisů přeskočil transakce.
Výpisy Komerční banky ručně nahráváme jen ve formátu BEST. Pohyby v něm mají stejnou identifikaci jako pohyby stažené přes API, takže se už stažené pohyby přeskočí. Výpis ve formátu KBGPC nebo CBAXML označuje pohyby jinak a pohyby by se naimportovaly podruhé.
¶ Odeslání platebního příkazu do banky
Platební příkaz z účtu u Komerční banky můžeme místo exportu do souboru odeslat přímo do banky. Na detailu platebního příkazu klikneme na Odeslat do banky.
Bankovní účet platebního příkazu musí patřit bance s Bankovním API KB a propojení musí být ve stavu Aktivní.
Odeslat jde tuzemské a SEPA platby. Zahraniční platby mimo SEPA banka touto cestou nepřijímá, pro ně platební příkaz exportujeme do souboru.
Banka přijímá nejvýš sto plateb v jedné dávce. Větší platební příkaz systém sám rozdělí do více dávek.
Banka u každé platby vyžaduje IBAN příjemce. Pokud položka platebního příkazu IBAN nemá, systém ho složí z čísla účtu a kódu banky.
Před odesláním se systém vždy zeptá, jestli platební příkaz opravdu chceme odeslat do banky. Pokud byl příkaz už exportovaný nebo odeslaný, upozorní nás na to v tomtéž dotazu i s datem a časem. Stejné upozornění se ukáže i při exportu příkazu, který už byl odeslaný do banky, aby platby neodešly dvakrát.
Po odeslání se zobrazí hláška s počtem plateb a s označením dávky, pod kterým ji najdeme v bance. Systém vyplní pole Odesláno do banky.
Odesláním se platby neprovedou. Dávku musíme podepsat v MojeBance Business, Profibance nebo Mobilní bance Business ve složce Dávkové příkazy a Dávky k autorizaci. Do té doby ji můžeme v bance zkontrolovat, upravit nebo zamítnout.
V KB+ zatím dávky podepsat nejde. Pro účty vedené v KB+ proto odeslání do banky zatím nepoužíváme.
¶ Upozornění
Systém hlásí problémy s bankovními API těmito upozorněními.
Import bankovních výpisů selhal přijde, když se stažení pohybů pro některý účet nepovede. Ve zprávě je důvod chyby a odkaz na bankovní účet. Platí pro Fio banku i Komerční banku.
Import bankovních výpisů přeskočil transakce přijde, když se stažení u Komerční banky povede, ale některé pohyby systém nenaimportoval. Ve zprávě je odkaz na bankovní účet a důvod u každého přeskočeného pohybu. Stejné důvody najdeme i ve zprávě o výsledku u staženého výpisu.
Brzy vyprší autorizace bankovního spojení přichází denně od třiceti dní před koncem platnosti autorizace u Komerční banky.
Neplatná autorizace bankovního spojení přijde, když banka autorizaci odmítne. Propojení se zároveň přepne do stavu Vyžaduje novou autorizaci.
Upozornění se posílají, jen když mají v agendě Nastavení upozornění vyplněnou Zodpovědnou roli. Bez ní systém upozornění vůbec nezaloží a o chybě se nedozvíme.
¶ FAQ
¶ Proč se nestáhly dnešní pohyby z Komerční banky?
Systém stahuje pohyby z Komerční banky jednou denně v noci a vždy jen do včerejška. Dnešní pohyby se stáhnou v noci po nejbližším všedním dni.
¶ Proč se pohyby z Komerční banky přestaly stahovat?
Na detailu propojení v agendě Bankovní spojení zkontrolujeme stav. Pokud je Vyžaduje novou autorizaci, klikneme na Znovu autorizovat. Pokud je propojení aktivní, ale pohyby pro některý účet chybí, zkontrolujeme, jestli má účet vyplněné Externí ID. Bez něj účet při autorizaci nebyl propojený a stačí doplnit IBAN a měnu a znovu autorizovat.
¶ Můžeme připojit účty Komerční banky ve více účetních jednotkách?
Ano. Propojení se zakládá pro každou účetní jednotku zvlášť. V každé účetní jednotce projdeme registraci i autorizaci a vybereme účty, které k ní patří.