Bankovní výpisy lze do ABRA Flexi načíst přes REST API dvěma způsoby — nahráním stáhnutého souboru s výpisem, nebo spuštěním online načtení přímo z banky.
Načítání stažených výpisů
Soubor s výpisem je třeba poslat metodou PUT nebo POST na URL:
PUT /c/{firma}/bankovni-ucet/{id}/nacteni-vypisu
U bankovního účtu musí být nastaveny příslušné vlastnosti týkající se elektronického bankovnictví (formát výpisu atd.). Pro více informací ohledně nastavení nahlédněte do dokumentace pro desktopovou a webovou aplikaci.
Úspěšné načtení
Pokud se výpis načte správně, odpověď je 200. Tělo odpovědi může obsahovat informaci, že některé doklady už byly načteny:
<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é odpovědi
V případě chyby je odpověď 400 a tělo obsahuje popis problému — například když k výpisu nelze dohledat bankovní úč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>
Chybně nastavený bankovní účet v JSON formátu:
{
"winstrom": {
"@version": 1,
"success": false,
"message": "U bankovního účtu není definován formát elektronického výpisu."
}
}⚠️ Tělo odpovědi, pokud je uvedeno, je momentálně vždy textové, ačkoliv požadujete XML nebo JSON. Tento problém bude v budoucnosti opraven.
Načítání výpisů online
Pomocí REST API je možné také spustit načítání online výpisů. Online načtením se rozumí načtení výpisů pomocí tokenu z FIO banky nebo z Finbricks. Pro spuštění je nutné odeslat požadavek metodou PUT nebo POST na URL:
PUT /c/{firma}/banka/nacteni-vypisu-online
Bankovní účet, pro který se mají výpisy stahovat, musí být správně nastaven a banka musí online výpisy podporovat.
📝 Formáty výpisů mají předepsanou strukturu — například 20 znaků v položce popis u formátu ABO je s touto strukturou v souladu.