Bankovní API

Tato kapitola obsahuje informace k bankovnímu API, momentálně realizováno přes službu Finbricks. Najdete zde seznam bank a jejich podporu stahování transakcí, dále výčet jednotlivých položek, které se stahují, seznam změn v bankovním API vztažených aktuálně ke službě Finbricks a k jednotlivým bankám. Podpora platebních příkazů zatím nebyla zavedena.

Konkrétní postup zprovoznění služby je popsán na partnerské stránce, případně se na nás obraťte prostřednictvím vašeho obchodního zástupce nebo kontaktního formuláře.

V seznamu uvádíme jen podporované banky.

Tabulka uvádí podporu transakcí v tuzemské a zahraniční měně pro CZ banky.

Banka Stahování transakcí Cizoměnové transakce
Air Bank ANO ANO
Česká spořitelna ANO ANO
Fio banka ANO NE (instructedAmount neuvádí cizí měnu)
Komerční banka ANO ANO
mBank ANO Připravuje se
MONETA Money Bank ANO NE
Raiffeisenbank ANO Připravuje se

Tabulka uvádí banky, u kterých se podpora připravuje v brzké době.

Banka
ČSOB
UniCredit

Níže v tabulce uvádíme seznamy, které se v bankovních transakcích přenášejí. Protože ne vždy je u všech bank chování stejné, je u každé položky poznámka, kde je případně uvedeno rozdílné chování.

Přenášená položka Poznámka
Unikátní hash vytvořený z bankovní transakce, ze které se importoval řádek BV Uživatelsky skrytá položka
Firma  
Firma (textový popis)  
Středisko, Zakázka, Projekt, Obchodní případ, Předkontace Položky se vyplňují z dialogového okna
Kredit  
Datum dokladu Pro banku Creditas platí, že pokud není vyplněno, tak se převezme z valueDate.date
Měna Pokud zdroj dat obsahuje informace o původní platbě v položce instructedAmount, je doplněna měna z této položky. V opačném případě se použije měna z položky amount. Například bude-li zaplaceno 5 EUR a bude-li vyplněno instructedAmount, pak se tato částka projeví na řádku. Pokud nebude, bude vyplněna částka v měně účtu.
Částka v měně řádku Pokud zdroj dat obsahuje informace o původní platbě v položce instructedAmount, je doplněna měna v měně řádku z této položky. V opačném případě se použije měna z položky amount. Například bude-li zaplaceno 5 EUR a bude-li vyplněno instructedAmount, pak se tato částka projeví na řádku. Pokud nebude, bude vyplněna částka v měně řádku.
Celková částka lokální Pokud zdroj dat obsahuje informace o původní platbě v položce instructedAmount, je doplněna měna z této položky. V opačném případě se použije měna z položky amount. Například bude-li zaplaceno 5 EUR a bude-li vyplněno instructedAmount, pak se tato částka projeví na řádku. Pokud nebude, bude vyplněna celková částka lokální.
Celková částka v měně bank.výpisu Tamount se nastaví na hodnotu amount.value, což znamená, že bude v měně účtu.
Variabilní symbol  
Specifický symbol  
Text Plní se hodnotou additionalTransactionInformation
Číslo účtu protistrany

Dále platí: Pokud existuje uživatelská položka X_BankAccount, Y_BankAccount, S_BankAccount nebo U_BankAccount vázaná k záznamu v tabulce BankStatements2, naplní se z tagu <BankAccount>. Naplní se první z existujících uživatelských položek. Existence položek se kontroluje v pořadí, jak jsou výše uvedeny. Např. pokud existuje položka X_BankAccount, naplní se a další výše uvedené uživatelské položky neplní.

  • Ve verzi 25.0 se při importu transakcí nově do textu řádku bankovního výpisu načítá také pole “additionalTransactionInformation”.

  • Ve verzi 25.0 byl původní endpoint /status/paymentProviders pro získání seznamu podporovaných bank nahrazen za nový /status/bankInfo. Původní endpoint přestane být podporován ze strany Finbrics k 13. 3. 2025.

  • Ve verzi 24.2 při importu bankovních transakcí přes Finbricks se nyní pole fbxReference bere do úvahy jen v případě, že je zadané a neprázdné. V ostatních případech se bankovní transakce dohledají podle pole entryReference.

  • Ve verzi 24.2 bylo odstraněno speciální zjištění původní měny a částky v případě Raiffeisenbank při importu transakcí pomocí bankovního API. Pokud transakce nebude mít standardní element InstuctedAmount, naimportuje se v měně účtu.

  • Verze 24.2. umožňuje ukládání dat z položky AdditionalRemittanceInformation do položky Text bankovního řádku (připojí se na konec informací, které se tam už ukládají). Dále, při importu bankovních transakcí pomocí open banking import nově položky variabilní a specifický symbol zkouší dohledat i v dalších částech zdrojového json souboru.

  • Pro verzi 24.1 byla rozšířena podpora ověření v externím prohlížeči, jelikož některé banky jako např. ČS vyžadují pro ověření certifikátem mít nainstalován v prohlížeči doplněk (rozšíření). Při ověření se nyní ABRA Gen ptá, zda má ověření proběhnout ve vestavěném nebo externím prohlížeči. Dále pak pro zjištění, zda již transakce byla načtena, se import transakcí přes bankovní API nově řídí polem fbxReference.

  • U certifikované verze 23.2.6 bez SP se může projevit chyba, kdy se nenaimportuje variabilní symbol. V takovémto případě je třeba aplikovat SP, který tuto chybu opravuje a je třeba smazat ručně všechny chybné řádky bankovních vpisů bez VS a provézt znovu import.

Obecné

Kvůli absenci unikátních identifikátorů ze strany bank v přípravě se mohou zákazníci nepodporovaných bank při případném využívání služby setkat s chybějícími nebo duplicitními transakcemi. Jak tento problém nejlépe vyřešit, popisujeme v dokumentu: Řešení problémů s bankovním API.

Česká spořitelna

  • Nelze aktivovat import z dalšího účtu, pokud již byl dříve import nakonfigurován.

Moneta

  • Od ledna 2025 nemusí fungovat stahování bankovních transakcí. Důvodem je přechod na novou verzi bankovní API u banky Moneta. Řešením je revokovat stávající přístup a vytvořit nový. Více informací zde.

Nezbytnou podmínkou pro provoz Finbricks je, aby byla tato část systému licencována. Finbricks je licencován samostatně (je třeba mít licenci na Bankovní API) - viz Licencované celky (licencované moduly a vlastnosti).