ABO - Propojení modulu s Komerční bankou přes API

Z Wikipedie HA-SOFT
Skočit na navigaci Skočit na vyhledávání

Propojení modulu s Komerční bankou přes API

Propojení s API Komerční banky umožňuje:

  • stahovat bankovní výpisy přímo do modulu ABO,
  • předávat příkazy k úhradě do Komerční banky,
  • omezit práci s účty podle přístupových práv uživatele.

Propojení se nastavuje samostatně pro každého uživatele a závod.

Předpoklady

Tato funkcionalita je uživatelům dostupná po dohodě. Máte-li zájem o její spuštění, napište na e-mail podpora@ha-soft.cz.

Před nastavením propojení musí být splněny následující podmínky:

  • správce systému musí připravit systémové parametry pro komunikaci s KB,
  • bankovní účty musí být založeny v číselníku Bankovní účty,
  • u účtů používaných pro stahování výpisů musí být správně vyplněn IBAN,
  • účty Komerční banky musí mít kód banky 0100,
  • uživatel musí mít potřebná práva k bankovním výpisům, příkazům k úhradě a jednotlivým bankovním účtům,
  • pracovní stanice musí umožňovat otevření přihlašovací stránky KB v integrovaném webovém okně.

Vzhledem k tomu, že každý uživatel má svůj účet pro přístup do banky, tak i v SEIWINu si musí každý uživatel organizace, který chce API využívat, nastavit propojení sám.

Nastavení propojení

  • Otevřete modul ABO – Bankovní operace, v hlavním menu vyberte Servis.
  • V kontextovém menu zvolte Bankovní API → Nastavení KB API.

  • V okně Nastavení KB API klikněte na Nastavit propojení.

  • SEIWIN zahájí registraci propojení na KB.

  • Následně se v integrovaném webovém okně otevře přihlášení Komerční banky.

  • Přihlaste se svými přihlašovacími údaji ke KB. Přihlašovací údaje zadáváte v integrovaném webovém okně Komerční banky a aplikace SEIWIN k nim nemá přístup.

  • Přihlášení musíte potvrdit pomocí aplikace KB Klíč nebo KB+.

  • Potvrzením v mobilní aplikaci dokončíte první krok propojení SEIWINu s Komerční bankou.

  • V tomto kroku jste propojili úspěšně SEIWIN s Komerční bankou. Na tento krok navazuje povolení přístupu k vybraným účtům a banka po vás bude chtít opět provést přihlášení a potvrzení na KB Klíči/KB+.

  • V prostředí KB povolte aplikaci SEIWIN přístup k účtům a dávkovým platbám. Schválíte, že SEIWIN bude mít přístup k výpisům bankovním účtů a bude moci odesílat dávky bankovních příkazů.
  • Po návratu do aplikace SEIWIN se zobrazí zpráva:

    Propojení bylo úspěšně nastaveno

Kontrola úspěšnosti propojení a možnosti změn propojení

Kontrola úspěšnosti propojení

V horní části okna Nastavení KB API jsou zobrazeny dva stavy:

  • Registrace propojení SEIWIN
  • Povolení přístupu k účtům

Propojení je dokončeno, pokud jsou úspěšně splněny oba kroky.

Opakované přihlášení

Pokud již registrace existuje, tlačítko Nastavit propojení v dialogu Nastavení KB API otevře přímo nové přihlášení a povolení přístupu k účtům.

To může být potřeba například při vypršení nebo zneplatnění oprávnění.

Zrušení propojení

Propojení odstraníte tlačítkem Zrušit propojení v dialogu Nastavení KB API.

Po potvrzení SEIWIN odstraní lokálně uložené registrační údaje, oprávnění a datum poslední synchronizace. Pro další použití bude nutné propojení nastavit znovu.

Zrušení v SEIWIN nemusí samo o sobě zrušit souhlas evidovaný na straně KB. Ten se případně spravuje v prostředí banky.

Přihrání bankovních výpisů

  • Otevřete Výpisy → Bankovní výpisy.
  • Zvolte funkci Přihrát výpis.
  • V seznamu zdrojů bankovních dat vyberte: KB API – Načtení přes API Komerční banky

  • Zadejte období:
    • Datum od
    • Datum do
  • Klikněte na Načíst.

  • Po stažení pokračujte standardním postupem přihrání bankovních výpisů.

Předvyplnění období

Při prvním načtení je jako počáteční datum nabídnut dnešní den.

Po úspěšné synchronizaci se při příštím načtení nabídne den následující po poslední úspěšné synchronizaci. Datum do je předvyplněno dnešním dnem.

Platí následující kontroly:

  • obě data musí být vyplněna,
  • datum od nesmí být pozdější než datum do,
  • datum do nesmí být v budoucnosti.

Které účty se načtou

SEIWIN načte výpis pouze tehdy, když:

  • účet vrátí Komerční banka,
  • jeho IBAN odpovídá IBANu bankovního účtu založeného v SEIWIN,
  • uživatel má právo upravovat výpisy daného účtu.

Pokud se žádný účet nespáruje, zkontrolujte:

  1. zda je účet založen v číselníku Bankovní účty,
  2. zda je správně vyplněn IBAN,
  3. zda má uživatel právo pracovat s tímto účtem,
  4. zda byl účet povolen při nastavování propojení v KB.

Systém načítá výpisy za pracovní dny. Pokud KB výpis teprve připravuje, SEIWIN čeká nejvýše dvě minuty. Při částečné chybě oznámí, které výpisy se nepodařilo získat.

Datum poslední synchronizace se posune pouze po zcela úspěšném načtení a importu.

Předání příkazu k úhradě do KB

  • Otevřete Platby → Příkazy k úhradě.
  • Vyberte příkaz, který chcete předat do banky.
  • Zkontrolujte jeho obsah, účty, částky, měny a data splatnosti.
  • Klikněte na Odeslat přes API.

  • Počkejte na dokončení vytváření a odesílání platebních dávek.
  • Zkontrolujte zobrazený výsledek.

Po stisknutí tlačítka se odesílání rovnou zahájí. Aktuální implementace nezobrazuje další potvrzovací otázku.

Kdy je tlačítko dostupné

Funkci Odeslat přes API lze použít pouze tehdy, když:

  • je propojení s KB dokončeno,
  • příkaz je možné editovat,
  • příkaz není smazaný,
  • příkaz ještě nebyl označen jako odeslaný,
  • uživatel má právo upravovat příkazy k úhradě,
  • uživatel má přístup ke všem účtům plátce použitým v příkazu.

Smíšený příkaz pro více bank

Příkaz může obsahovat platby pro Komerční banku i jiné banky.

  • Platby z účtů KB s kódem banky 0100 se odešlou přes API.
  • Pro ostatní účty se vytvoří běžné bankovní soubory.
  • Po úspěšném odeslání KB plateb nabídne SEIWIN uložení zbývajících souborů do zvolené složky.

Kontroly před odesláním

SEIWIN před odesláním kontroluje zejména:

  • přítomnost plateb z účtu Komerční banky,
  • oprávnění uživatele,
  • správnost IBANů,
  • u EUR plateb také BIC příjemce,
  • podporovanou měnu,
  • správnost částek a povinných údajů,
  • datum splatnosti,
  • nepodporované znaky,
  • jednotnou měnu v jedné odesílané dávce.

Pro odesílání přes KB API jsou podporovány platby v CZK a EUR.

Výsledek odeslání

Po dokončení SEIWIN zobrazí přehled rozdělený do částí:

  • Odesláno přes API Komerční banky
  • Neodesláno přes API Komerční banky
  • Nevyřízeno přes API

U každého souboru se zobrazí účet plátce, měna, počet plateb, celková částka a případně identifikace přidělená bankou.

Po úspěšném uložení je příkaz v SEIWIN označen jako odeslaný.

Přijetí dávky přes API neznamená automaticky její provedení bankou. Následné schválení, podpis nebo zpracování platby se řídí nastavením oprávnění v Komerční bance. Stav dávky proto zkontrolujte také v prostředí KB.

Citováno z „https://wiki.seiwin.cz/w/index.php?title=ABO_-_Propojení_modulu_s_Komerční_bankou_přes_API&oldid=2605“