Bankové výpisy je možné do ABRA Flexi načítať cez REST API dvomi spôsobmi — nahraním stiahnutého súboru s výpisom, alebo spustením online načítania priamo z banky.
Načítanie stiahnutých výpisov
Súbor s výpisom je potrebné poslať metódou PUT alebo POST na URL:
PUT /c/{firma}/bankovni-ucet/{id}/nacteni-vypisu
Pri bankovom účte musia byť nastavené príslušné vlastnosti týkajúce sa elektronického bankovníctva (formát výpisu atď.). Pre viac informácií ohľadom nastavenia nahliadnite do dokumentácie pre desktopovú a webovú aplikáciu.
Úspešné načítanie
Ak sa výpis načíta správne, odpoveďou je 200. Telo odpovede môže obsahovať informáciu, že niektoré doklady už boli načítané:
<winstrom version="1.0">
<success>true</success>
<stats>
<created>4</created>
<updated>0</updated>
<deleted>0</deleted>
<skipped>2</skipped>
<failed>0</failed>
</stats>
<results>
<result>
<code>Výpis 223 pro účet 0000001000 - Počet položek 6</code>
<infos>
<info>položka s popisem POPLATEK - Tento doklad byl již načten.</info>
<info>položka s popisem VYBER HOTOVOSTI - Tento doklad byl již načten.</info>
</infos>
</result>
</results>
</winstrom>
Chybové odpovede
V prípade chyby je odpoveďou 400 a telo obsahuje popis problému — napríklad keď k výpisu nie je možné dohľadať bankový účet:
<winstrom version="1.0">
<success>false</success>
<stats>
<created>0</created>
<updated>0</updated>
<deleted>0</deleted>
<skipped>0</skipped>
<failed>1</failed>
</stats>
<results>
<result>
<code>Výpis 223 pro účet 0000001000 - Počet položek 6</code>
<errors>
<error>Pro tento výpis nebyl nalezen bankovní účet.</error>
</errors>
</result>
</results>
</winstrom>
Nesprávne nastavený bankový účet vo formáte JSON:
{
"winstrom": {
"@version": 1,
"success": false,
"message": "U bankovního účtu není definován formát elektronického výpisu."
}
}⚠️ Telo odpovede, ak je uvedené, je momentálne vždy textové, aj keď požadujete XML alebo JSON. Tento problém bude v budúcnosti opravený.
Načítanie výpisov online
Pomocou REST API je možné tiež spustiť načítanie online výpisov. Online načítaním sa rozumie načítanie výpisov pomocou tokenu z FIO banky alebo z Finbricks. Pre spustenie je nutné odoslať požiadavku metódou PUT alebo POST na URL:
PUT /c/{firma}/banka/nacteni-vypisu-online
Bankový účet, pre ktorý sa majú výpisy sťahovať, musí byť správne nastavený a banka musí online výpisy podporovať.
📝 Formáty výpisov majú predpísanú štruktúru — napríklad 20 znakov v položke popis pri formáte ABO je s touto štruktúrou v súlade.