ČSOB je jedna z největších univerzálních bank v Česku, která poskytuje širokou škálu služeb pro firmy i jednotlivce – od běžných účtů a úvěrů až po moderní digitální bankovnictví. Díky propracovanému API umožňuje také automatizovaný přenos plateb a dat do účetních systémů, což výrazně zjednodušuje firemní procesy.
Dativery v rámci projektu Bankovní výpisy umožňuje automatické a průběžné stahování výpisů z ČSOB přímo do vaší instalace ABRA Gen – tedy bez nutnosti ručního stahování a nahrávání souborů. Celý proces tak probíhá zcela automaticky a bez opakované účasti uživatele.
Výhoda automatického načítání výpisů
Automatické stahování plateb přináší spolehlivost, úsporu času i aktuální přehled o pohybech na účtu. Díky pravidelnému načítání výpisů každou hodinu máte informace o úhradách k dispozici téměř okamžitě. Zároveň odpadá nutnost ručního přenosu výpisů – pokud byste této činnosti věnovali každý pracovní den pouhých 10 minut, jedná se o více než čtyři hodiny měsíčně, které můžete využít efektivněji. Automatizovaný přenos plateb je proto ideálním řešením pro všechny, kteří potřebují mít o svých platbách aktuální přehled častěji než jednou za několik týdnů.
Obsah
Abyste mohli snadno přenášet transakce na účtu vedeném u ČSOB do svého účetního systému ABRA Gen, budou potřeba následující kroky:
- Připravit bankovní účet v ABRA Gen.
- Zajistit uživatele pro připojení Dativery k ABRA Gen.
- Nainstalovat a nastavit Dativery Agent pro propojení ABRA Gen a Dativery.
- Připojit ABRA Gen k Dativery.
- Připravit přihlašovací údaje v ČSOB.
- Připojit ČSOB k Dativery.
- Aplikovat scénář propojení ČSOB a systému ABRA Gen.
V následujícím textu jsou tyto kroky podrobně vysvětleny. Předpokládáme, že již máte vytvořený svůj účet v aplikaci Dativery.
Bankovní účet v ABRA Gen
V systému ABRA Gen si nejprve založte nový bankovní účet, na který budou následně nahrávány výpisy plateb z ČSOB. Nový bankovní účet vytvoříte v hlavním menu Agendy → Banka → Bankovní účty. Následně v pravém menu klepněte na tlačítko Nový a vyplňte potřebné údaje účtu.
- Do pole Název banky zadejte název bankovního účtu, např. ČSOB CZK.
- Do pole Bankovní účet zadejte číslo bankovního účtu včetně kódu banky za lomítkem, např. 123123123/0300.
- Do pole Kód měny zadejte měnu, ve které je účet veden.
- Do pole Řada bankovních výpisů vyberte číselnou řadu, která se bude přiřazovat k importovaným bankovním výpisům.
- Do pole Zúčtovací středisko vyberte organizační jednotku firmy, která se bude přiřazovat k bankovním výpisům.
- Do pole První použité období zadejte rok, od kterého bude bankovní účet používán.
- Do pole Počátek zadejte počáteční zůstatek účtu k datu jeho zavedení.
- Dále můžete doplnit také specifický symbol, SWIFT, IBAN kód, země banky, řadu platebních příkazů nebo analytický účet.
Jednotlivé nahrávané transakce budou odkazovat na tento založený účet. Při aktivaci scénáře přenosu plateb v Dativery vyberete tento účet jako cílový.
Uživatel ABRA Gen pro přístupy Dativery
API je součástí všech verzí ABRA Gen a pro použití s Dativery jej stačí pouze aktivovat. API následně běží na serveru jako služba systému Windows.
Pro použití ABRA Gen s Dativery je potřeba mít zakoupenou samostatnou uživatelskou licenci. V ABRA Gen následně založte uživatele určeného pro Dativery a povolte mu možnost Umožnit přístup do API na spojení. Uživatelské jméno a heslo tohoto uživatele budete následně potřebovat při propojení ABRA Gen s platformou Dativery.
K vytvořenému uživateli je zároveň potřeba přiřadit roli, prostřednictvím které se v ABRA Gen nastavují jeho přístupová práva. Roli můžete uživateli přiřadit v agendě Uživatelé na záložce Role. Této roli následně nastavte oprávnění potřebná pro práci Dativery.
Pro přenos plateb je nutné roli povolit následující práva k objektům a funkcím:
- Práva k objektům:
- Bankovní účty → Zvolit konkrétní účet → Zobrazit
- Bankovní účty → Zvolit konkrétní účet → Použít
- Řady dokladů → Zvolit konkrétní řadu → Zobrazit
- Řady dokladů → Zvolit konkrétní řadu → Použít
- Střediska → Zvolit konkrétní středisko → Zobrazit
- Střediska → Zvolit konkrétní středisko → Použít
- Účetní řady → Zvolit konkrétní řadu → Zobrazit
- Účetní řady → Zvolit konkrétní řadu → Použít
- Zakázky → Zvolit konkrétní zakázku → Zobrazit
- Zakázky → Zvolit konkrétní zakázku → Použít
- Práva k funkcím:
- API funkce → Dávka → Vykonat
- Banka → Bankovní výpisy → Spustit
- Banka → Bankovní výpisy → Přidat
- Banka → Přehled plateb bankou → Spustit
- Nastavení → Období → Spustit
- Nastavení → Měny → Spustit
- Účetnictví → Účetní předkontace → Spustit
Dativery Agent
Dativery Agent představuje nejjednodušší a doporučený způsob propojení ABRA Gen s Dativery. Přístup k API je zajištěn prostřednictvím Dativery Agenta, takže není nutné řešit veřejné IP adresy, certifikáty, VPN ani další zabezpečení spojení – to zajišťuje samotný Dativery Agent.
Pro přístup k ABRA Gen navíc umí Dativery Agent provádět požadavky z pevné IP adresy, díky čemuž lze na firewallu nastavit další úroveň zabezpečení. Pokud chcete vědět více o bezpečnosti, přečtěte si článek ohledně bezpečnosti Dativery Agentu pro ABRA Gen.
Pro propojení postupujte následovně:
- Začněte stažením aktuální verze Dativery Agentu a nainstalujte jej na server, na kterém je dostupné API systému ABRA Gen.
- Je nutné mít aktivované ABRA Gen API. Dativery Agent se pokusí API aktivovat automaticky. Pokud se automatická aktivace nezdaří nebo ji nechcete využít, proveďte manuální aktivaci podle kompletního návodu ABRA Gen.
- Aktivujte ABRA Gen v Dativery Agentu. Po úspěšné aktivaci vygenerujte jednorázový kód, který následně použijete pro propojení ABRA Gen s platformou Dativery.
Pokud nechcete využít doporučené připojení prostřednictvím Dativery Agenta, jsou k dispozici také následující možnosti:
- ABRA Gen Online: Pokud využíváte ABRA Gen Online, kontaktujte přímo podporu ABRA Gen, která Vám poskytne údaje potřebné pro propojení s Dativery – konkrétně název serveru pro API nebo IP adresu Vaší instalace ABRA Gen serveru. Pokud omezujete přístup ke své instalaci ABRA Gen pouze na konkrétní IP adresy, je potřeba tuto skutečnost zohlednit také v nastavení připojení. Dativery bude následně k Vaší instalaci přistupovat pouze z IP adresy 46.101.177.29.
- Veřejná IP adresa a IIS: Připojení prostřednictvím veřejné IP adresy a IIS je technicky nejnáročnější variantou, proto doporučujeme, aby jeho nastavení prováděl zkušený IT administrátor. Postup naleznete v článku Instalace API pro ABRA Gen v sekci Veřejná IP adresa a IIS.
Připojení ABRA Gen v Dativery
V tomto kroku připojíte ABRA Gen k Dativery buď samostatně a nebo při aplikaci některého scénáře integrace. My si ukážeme samostatné připojení ABRA Gen:
- Ve webové aplikaci v pravém sloupci klepněte na položku Aplikace.
- Mezi aplikacemi najděte ABRA Gen a klepněte na něj.
- Na zobrazené stránce ABRA Gen klepněte na tlačítko +Propojit.
Zobrazí se Vám první krok přidání průvodce s formulářovými políčky:
- Zaškrtněte možnost Použít Dativery Agent a zadejte jednorázový kód/heslo vygenerované v Dativery Agentu.
Pozor, pokud využíváte ABRA Gen Online (nebo veřejnou IP adresu a IIS), možnost Použít Dativery Agent nezaškrtávejte a do pole Jméno serveru pro API zadejte adresu Vaší instalace, např. onlineapi.abra.eu/ZAKAZNIK. Pokud omezujete přístup ke své instalaci ABRA Gen pouze na konkrétní IP adresy, zaškrtněte možnost Přistupovat z pevné IP adresy. Dativery bude následně přistupovat pouze z IP adresy 46.101.177.29. Pokud přístup podle IP adres neomezujete, ponechte tuto možnost nezaškrtnutou. - Do polí Uživatel a Heslo zadejte přihlašovací údaje k ABRA Gen určeného pro Dativery. Přihlašovací údaje vždy považujeme za výjimečně citlivý údaj a ukládáme je v odděleném zabezpečeném úložišti s omezeným přístupem (viz též Zásady zpracování osobních údajů).
- V poli Domácí měna zvolte měnu, ve které je připojovaná firma účtována. V Česku obvykle česká koruna, na Slovensku euro.
- Klepněte na tlačítko Další pro přechod na druhý krok průvodce. Po odeslání se průvodce spojí s Vaší instalací ABRA Gen, aby ověřil zadané údaje. Pokud se spojení nezdaří, zobrazí se chybové hlášení s možností zobrazit provedený požadavek, získanou odpověď a obvykle i vysvětlení příčin chyby.
- Na druhém kroku průvodce vyberete z účtovaných firem tu, kterou chcete připojit.
- Stisknutím tlačítka Uložit nastavení je připojení aplikace ABRA Gen dokončené. Tu můžete zvolit při aplikaci libovolného scénáře integrace s ABRA Gen.
Na stránce propojené aplikace naleznete v pravém sloupci odkaz Nastavení připojení, pomocí kterého můžete průvodce připojením kdykoliv znovu otevřít – třeba v případě změny přihlašovacích údajů.
Integrace s ABRA Gen pro více firem
V případě, že potřebujete propojit integrace pro více účtovaných firem, připojte ABRA Gen pro každou účtovanou firmu samostatně.
Na stránce propojené aplikace naleznete v pravém sloupci odkaz Upravit vlastní název. Pomocí něj můžete každou propojenou aplikaci pojmenovat, a jednotlivá připojení tak mezi sebou snadno rozlišit.
Pokud připojujete více účtovaných firem, doporučujeme také zvážit založení samostatné organizace pro každou z nich. Více informací o správě více organizací naleznete v článku Fakturace.
Přihlašovací údaje a příprava ČSOB
Pro automatický přenos bankovních pohybů z ČSOB je potřeba nejprve aktivovat službu ČSOB Business Connector a připravit údaje a certifikát potřebné pro komunikaci Dativery s bankou.
Při připojení ČSOB v Dativery budete potřebovat:
- identifikační číslo kontraktu,
- číslo bankovního účtu,
- certifikát,
- privátní klíč k certifikátu,
- případně heslo privátního klíče.
Příprava ČSOB Business Connectoru a certifikátu
Pro nastavení účtu postupujte následovně:
- Ve svém internetovém bankovnictví ČSOB CEB aktivujte službu ČSOB Business Connector.
- Stáhněte si zazipovaný soubor obsahující privátní klíč (
.key) a žádost o vystavení certifikátu (.csr). - Soubor
.csrnahrajte v internetovém bankovnictví ČSOB a nechte si na jeho základě vygenerovat certifikát. Podrobný postup naleznete v návodu Automatické výpisy ČSOB – Nahrání Certificate Signing Request do ČSOB. - Ve službě ČSOB Business Connector nastavte potřebná oprávnění a zapněte vytváření bankovních výpisů ve formátu XML, ideálně s denní frekvencí. Výpisy se začnou vytvářet až od okamžiku aktivace, zpětně vytvořeny nebudou.
- Při připojení aplikace ČSOB v Dativery zadejte identifikační číslo kontraktu a číslo účtu a nahrajte certifikát
.cerzískaný od ČSOB společně s privátním klíčem.keyvytvořeným ve 2. kroku. Pokud je privátní klíč chráněn heslem, zadejte také toto heslo.
Podrobný postup vytvoření certifikátu naleznete v článku Automatické výpisy ČSOB. Součástí návodu je také postup pro nastavení XML výpisů a zjištění identifikačního čísla kontraktu.
Připojení ČSOB k Dativery
Posledním krokem přípravy je připojení ČSOB k Dativery. Přejděte na stránku přidání aplikace ČSOB Business Connector v Dativery, na níž vyplníte identifikační číslo kontraktu, číslo bankovního účtu bez kódu banky, nahrajete vytvořený certifikát i k němu příslušný klíč, popř. doplníte heslo tohoto klíče, máte-li klíč heslem zabezpečený. Po zadání klepněte na tlačítko Uložit.
Tip: Pokud ve webové aplikaci Dativery přidáváte další přenos z ČSOB pro další účet, zkontrolujte, zda má nahrávaný certifikát povolený přístup i k nově přidávanému účtu.
Scénář přenosu plateb z ČSOB
V této části aktivujeme samotnou integraci:
- Na stránce scénáře klepněte na tlačítko Použít scénář.
- Protože jste připojili ČSOB dříve, bude Vám nabídnutou použití již připojené aplikace, které potvrdíte tlačítkem Dále. Pokud byste chtěli nově připojit ČSOB, klepnete na odkaz připojit další ČSOB Business Connector.
- Následně zvolte existující propojení s ABRA Gen nebo přidejte zcela nové tím, že vyplníte:
- Vygenerované jednorázové heslo při použití Dativery Agenta nebo adresu serveru pro API v případě ABRA Gen Online nebo připojení přes veřejnou IP adresu a IIS.
- Jméno uživatele pro přístup Dativery.
- Heslo k tomuto účtu.
- Domácí měnu, ve které je firma účtována.
- Stiskněte tlačítko Další, načež se Dativery zkusí na server připojit.
- Pokud uspěje, nabídne vám na výběr účtovanou společnost.
- V posledním kroku nastavte parametry přenosu plateb, tj.:
- Zvolte cílový bankovní účet v ABRA Gen.
- Zvolte středisko v ABRA Gen.
- Zadejte datum, od kterého mají být platby přenášeny. Pozor, ČSOB připravuje výpisy až ode dne aktivace jejich vytváření, ke starším výpisům se takto dostat nelze. Zároveň jsou výpisy přístupné u ČSOB jen po dobu zhruba 14 dní.
- Vyplňte měnu transakcí bankovního účtu ČSOB.
- Nastavení uložte.
- Aktivace je dokončena, stahování začíná.
Jak propojení funguje?
Dativery se připojuje k bankovnictví ČSOB pravidelně každou hodinu po celý den. Navíc máte možnost kdykoliv ručně spustit okamžité stažení výpisu a jeho zpracování. ČSOB má však specifický přístup k poskytování přehledu transakcí: nejdříve musí v bance proběhnout uzávěrka dne, což se děje v průběhu noci, a až následně jsou aktualizovány výpisy transakcí. Aktualizace výpisů tedy probíhá jednou za 24 hodin a lze získat výpis transakcí za uplynulý a předešlé dny, nelze však získat dnešní transakce. Po získání bankovního výpisu se automaticky provádí import pohybů na účtu do účetnictví ABRA Gen.
Scénáře nepodporují přímé nastavení automatického párování plateb s fakturami. Protože tuto funkci neřešíme na straně Dativery, doporučujeme obrátit se pro podrobnější informace přímo na podporu účetního systému ABRA Gen.
Zkusíte propojení hned?
Můžete zkusit přenášet bankovní výpisy plateb z ČSOB do ABRA Gen okamžitě, nemusíte na nic čekat.
Když se zdá, že ČSOB nefunguje?
Při neúspěšném připojení k ČSOB může banka vracet číselný chybový kód. ČSOB uvádí pro jednotlivé kódy tyto významy:
| Kód | Popis |
| 1000 | Obecná chyba na straně serveru ČSOB. |
| 1002 | Kontrakt nemá povolený přístup přes Business Connector. |
| 1011 | Pravděpodobně je zadáno špatné číslo kontraktu (informujte se u banky). Certifikát není registrován pro použití v Business Connectoru, kontrakt neexistuje nebo není aktivní. |
| 1012 | Certifikát je blokován pro použití v Business Connectoru. |
| 1101 | Přístup je dočasně blokován kvůli nadměrnému počtu volání. |