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.
Seznam bank a jejich podpora stahování transakcí
V seznamu uvádíme nejčastěji používané banky našimi klienty.
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 |
| Creditas | NE (bookingDate, status) | NE |
| Česká spořitelna | ANO | ANO |
| ČSOB | ANO | NE (schází instructedAmount, cizí měna je uvedena nestandardně v jiném klíči) |
| Fio banka | ANO | NE (instructedAmount neuvádí cizí měnu) |
| Hello bank | Neotestováno | Neotestováno |
| Komerční banka | ANO | ANO |
| mBank | ANO | NE (schází instructedAmount) |
| MONETA Money Bank | ANO | Neotestováno |
| Raiffeisenbank | ANO | Neotestováno |
| Trinity Bank | Neotestováno | Neotestováno |
| UniCredit | Neotestováno | Neotestováno |
Tabulka uvádí podporu transakcí v tuzemské a zahraniční měně pro SK banky.
| Banka | Stahování transakcí | Cizoměnové transakce |
|---|---|---|
| Fio banka | Neotestováno | Neotestováno |
| nBank | Neotestováno | Neotestováno |
| Slovenská spořitelna | Neotestováno | Neotestováno |
| ČSOB | Neotestováno | Neotestováno |
| Prima banka | Neotestováno | Neotestováno |
| Tatra banka | Neotestováno | Neotestováno |
| Komerční banka | Neotestováno | Neotestováno |
| Raiffeisenbank | Neotestováno | Neotestováno |
| VÚB banka | Neotestováno | Neotestováno |
| UniCredit | Neotestováno | Neotestováno |
Seznam přenášených položek v jednotlivých transakcích
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 | |
| Čí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í. |
Verze ABRA Gen
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.
Banky - známé problémy
Komerční banka
Aktuální chyba u Komerční banky může působit duplicitu importu transakcí. Aktuálně čekáme na opravu ze strany dodavatele (Finbricks).
ČSOB
Není uvedeno instructedAmount (údaje o cizí měně se objevují v counterValueAmount). Z tohoto důvodu nyní nepodporujeme stažení transakce v cizí měně.
Creditas
Banka Creditas byla vyjmuta z podporovaných, protože transakce nemají bookingDate ani status, že jsou zaúčtované
FIO a M-bank
prozatím nemají transakce v cizí měně.
Česká spořitelna
- Nemá u všech transakcí EntryReferenceID – unikátní identifikátor, bez nějž transakce nelze importovat.
- Nelze aktivovat import z dalšího účtu, pokud již byl dříve import nakonfigurován.