Přeskočit na hlavní obsah

API Integrace

Modul Bankovnictví podporuje více metod integrace pro stahování transakcí.

1. Fio Banka (REST API)​

  • Metoda: Pull (Cron Job nebo Manuální spuštění).
  • Auth: API Token uložený přímo v BankAccount.apiToken.
  • Knihovna: Používá fioapi/fioapi.
  • Nástroj: Espo\Modules\Banking\Tools\Fio\Service.

Workflow​

  1. Stažení: Stáhne transakce za posledních X dní pomocí Downloader->downloadSince().
  2. Zpracování: Iteruje přes XML/JSON odpověď.
  3. Deduplikace: Kontroluje, zda ID transakce již existuje.
  4. Uložení: Vytvoří entity BankTransaction.

2. Import Souborů (CSV/GPC)​

Pro banky bez API (nebo starší systémy) modul podporuje parsování souborů.

  • ČSOB / UniCredit: Vlastní parsery umístěné v src/backend/Classes/EmailParsing/Parsers.
  • Vstupní bod: Soubory lze nahrát ručně nebo získat z příloh e-mailů pomocí funkce EmailParsing.

3. Bezpečnost​

  • Tokeny: Uloženy v databázi. Přístup k entitě BankAccount by měl být omezen pomocí Rolí.
  • Logy: Chyby API jsou zaznamenávány do standardního logu EspoCRM (data/logs/espo.log).