Popis ovladače CZ_KBBest.hbd

Nahrazuje plně oba dřívější drivery KBBest.hbd a KBDirect.hbd.

Driver lze využít i pro přímý přístup do Komerční banky (tzv. přímý kanál).

Služba přímýkanál je další službou Přímého bankovnictví Komerční banky, která umožňuje rozšířit možnosti systémů mojebanka (popřípadě profibanka) a nabízí možnost velmi jednoduše a rychle odeslat přímo z účetního systému příkazy přímo do KB a získat výpisy v elektronické podobě. Služba přímýkanál je určena těm, kteří chtějí automatizovat komunikaci s bankou, popřípadě potřebují přenášet velké množství plateb a výpisů.

Parametry tohoto ovladače jsou uspořádány do následujících záložek - ty se liší podle toho, pro jakou banku se bude ovladač používat (volí se na záložce Obecné, viz dále):

  • Pro MONETA Money Bank:
    Obsažené záložky:ObecnéPlatební příkazy zahraniční

    Pro MONETA Money Bank ovladač podporuje pouze tvorbu zahraničních platebních příkazů s tím, že v souboru platebního příkazu je kód banky 0600. Pro tvorbu tuzemských plat.příkazů a pro import BV je doporučeno použít pro banku MONETA Money Bank ovladač CZ_ABO.

Přípony příkazů pro tento ovladač:

  • Přípona příkazů - *.IKM (definovatelná)
  • Přípona výpisů - *.KMO (definovatelná)

Obecné

Název Doplňující popis
Banka

Možno zvolit, pro jakou banku se bude ovladač používat. Podle toho se změní nabídka záložek i položek v nich.

Pokud jste zatím v parametrech driveru nezvolili banku (jelikož jste driver začali používat např. ještě před jeho rozšířením pro více bank), pak se defaultně bere, že je nastavená Komerční banka.

Přímý kanál

K dispozici jen pro banku KB (volí se na záložce Obecné, viz dále).

Je-li zatrženo, bude možno driver použít i pro vstup do banky přes přímý kanál. Pak se zpřístupní i následující volby:

Název Popis
Výkonný program KB - přímý kanál Speciální program určený pro provoz přímého kanálu dodávaný Komerční bankou, viz popis driveru KBDirect.
Vyčistit adresář pro export resp. import Je-li zatrženo, pak před exportem pl. příkazů resp. importem bankovních výpisů nejdříve vyčistí adresář, kam se tyto exportují resp. importují.

Princip funkce driveru pro přímý kanál viz popis driveru KBDirect.

Platební příkazy/ Platební příkazy - zahraniční

Název Doplňující popis
Cesta pro ukládání vygenerovaného platebního příkazu Zde je třeba zadat platné jméno adresáře včetně disku a koncového zpětného lomítka. Adresář musí být vytvořen.
Po exportu spustit

K dispozici jedině tehdy, že není zvolen vstup přes Přímý kanál, tj. v záložce Parametry není zatržena stejnojmenná položka.

Pak je po vlastním exportu možné spustit externí program, například program, který rovnou umožní vytvořený el. platební příkaz odeslat do banky (odpovídající stránka WWW). Ve volání programu lze využívat parametry - viz popis u funkce Parametry.

Přípona souboru domácího nebo zahraničního platebního příkazu Výchozí hodnota je IKM. Vygenerované soubory budou mít zde zadanou příponu. Jaké soubory vzniknou, ovlivňuje též nastavení režimu SEPA, viz dále.
Přípona souboru příkazu SEPA Výchozí hodnota je XML. Vygenerované soubory budou mít zde zadanou příponu.
Režim SEPA

Slouží pro realizaci SEPA plateb přímo v rámci tohoto ovladače. Zde jsou k dispozici následující možnosti:

  • Nepoužívat SEPA ISO XML - formát SEPA ISO XML nebude používán.
  • Používat jen SEPA ISO XML - formát SEPA ISO XML bude používán pro všechny příkazy.
  • SEPA ISO XML jen pro příkazy do oblasti SEPA - formát SEPA ISO XML bude používán pouze pro příkazy, které jsou vystaveny na firmu, jež má v adrese sídla uvedenu zemi náležející do oblasti SEPA.
  • SEPA ISO XML pro všechny zahraniční příkazy - formát SEPA ISO XML bude používán pro všechny zahraniční příkazy.

U jiných režimů než Nepoužívat SEPA ISO XML se Lokální platba v EUR považuje také za SEPA platbu a vyexportuje se v XML.

V případě, že máte nastavenou poslední volbu "SEPA ISO XML pro všechny zahraniční příkazy", je nutné mít nastavenou v Adresáři firem na subzáložce Bank. účty u daného bankovního účtu položku Země banky nebo při generování Žádosti o platební příkaz ručně zvolit u Typu platby, že se jedná o Zahraniční platbu (nenechat nastavenou volbu na hodnotu “Určí ovladač“).

Podle tohoto nastavení se pak vytváří výstupní soubory: pokud se v příkaze najdou řádky, které podle výše uvedeného nastavení nastavení spadají do zpracování pomocí SEPA XML, tak se pro ně vytvoří adekvátní soubor. V důsledku tudíž mohou pro platby vzniknout až tři soubory (domácí/zahraniční a SEPA XML).

Pokud nastavíte formát výpisů na SEPA, je třeba zkontrolovat, že jsou vyplněny následující položky v Adresáři firem: Název firmy, IBAN, Ulice, Město a Kód země.

Kódování SEPA XML

Vzhledem k tomu, že jednotlivé banky podporující komunikaci dle ISO 20022 mohou vyžadovat různé způsoby kódování znaků v platebních příkazech, je třeba dle informací z konkrétní banky vybrat v této položce odpovídající znakovou sadu, ve které bude platební příkaz vytvořen. K dispozici jsou tyto možnosti:

  • WINDOWS_1250
  • UTF_8
  • ISO_8859_2
  • CP_852
  • CP_895
  • UTF_16

Výchozí hodnota je UTF_8.

Formát příkazu SEPA

Verze formátu zprávy (rovněž dle ISO 20022). K dispozici jsou tyto možnosti:

  • pain.001.001.02 (CustomerCreditTransferInitiationV02)
  • pain.001.001.03 (CustomerCreditTransferInitiationV03)

Je zapotřebí zvolit formát podporovaný konkrétní bankou. Výchozí hodnota je pain.001.001.03.

Odstraňovat diakritiku v ISO XML souboru

Parametr, který určuje, zda vygenerovaném platebním příkaze budou znaky bez diakritiky. Výchozí hodnota je Ano.

Platební příkazy bez diakritiky vyžadují např. banky Tatrabanka, Unicredit aj.

Nevyplněné kódy zemí nahrazovat kódem lokální země v ISO XML souboru Primárně systém ABRA Gen do platebního příkazu ISO XML přebírá kód země z položky Kód země na firmě, která je zadána na platebním příkazu. Pokud země na firmě není vyplněna, je možné pomocí tohoto parametru zvolit, aby se do platebního příkazu převzala lokální země z agendy Firemní údaje.
V tuzemském příkazu v poli "Popis pro mě" exportovat firmu protistrany

Pokud je zatrženo, pak se v poli 17 Popis pro mě exportuje název firmy protistrany (v opačném případě se exportuje Popis).

Položka je k dispozici pouze na záložce Platební příkazy (tedy pro Komerční banku), nikoli na záložce Platební příkazy - zahraniční.

Název souboru se sekvenčními čísly

Tento soubor slouží k ukládání sekvenčních čísel platebních příkazů v rámci dne pro jeden bankovní účet. Každý řádek platebního příkazu pro daný bankovní účet v průběhu jednoho dne musí mít své unikátní sekvenční číslo. V souboru jsou uložena nejvyšší použitá sekvenční čísla pro jednotlivé dny.

Název souboru je třeba zadat včetně absolutní cesty k souboru. Pokud soubor zadaného názvu neexistuje, sám se založí. Doporučujeme nazvat soubor tak, aby bylo zřejmé, ke kterému bankovnímu účtu patří, např. C:\AbraGen\KB_123456_0100.dat, kde 123456/0100 je číslo příslušného bankovního účtu. Každý bankovní účet musí mít svůj vlastní soubor se sekvenčními čísly.

Pokud není parametr vyplněn, pak se sekvenční čísla ukládají do registrů, viz popis níže.

Sekvenční čísla

Jestliže podáte do Komerční banky (dále jen KB) elektronický platební příkaz, každý jeho řádek dostane sekvenční číslo, přičemž při příjmu v KB se hlídá, aby za jednu firmu a den nepřišla stejná sekvenční čísla.

V případě, že byl v daném dni vygenerován platební příkaz (odeslán e-bankingem), pak se zapamatuje informace o posledním použitém sekvenčním čísle v rámci daného dne. Pro tento ovladač platí, že se pamatuje v registrech daného počítače na daného uživatele (na rozdíl od předchozích driverů KBBest.hbd a KBDirect.hbd).

Při generování platebního příkazu se tato čísla načítají a pokud nejsou nulová (tj. ve stejném dni tvoříte a odesíláte daným ovladačem další příkaz), na začátku jeho tvorby se nabídne číslo o jedna vyšší, než poslední použité pamatované v registrech. Toto číslo lze editovat. Případná mezera v řadě sekvenčních čísel není na závadu - KB kontroluje pouze duplicitu.

Síťový provoz nebo více účtů u KB

KB kontroluje číslo sekvenční položky za klienta a nikoliv za způsob komunikace apod. Proto pokud používáte driver CZ_KBBest, nelze jej v daný den kombinovat s KBBest.hbd či KBDirect.hbd.

Z výše uvedeného plyne omezení pro použití tohoto ovladače síťově: Pokud by více uživatelů mělo tvořit platební příkazy, mohou vystavovat více platebních příkazů v jeden den, pouze za předpokladu, že všichni sdílí Soubor se sekvenčními čísly. Jinak nemohou informaci o posledním sekvenčním čísle v daný den uloženou v registrech na uživatele navzájem sdílet. V případě, že máte více účtů u KB, je situace obdobná. Tj. pokud má vzniknout více souborů s platebními příkazy v jeden den, je třeba, aby je vytvořil jeden uživatel z jednoho PC nebo všichni sdíleli Soubor se sekvenčními čísly.

Zahraniční platby s příznakem SEPA (Single European Payment Area) - přímý kanál

Ovladač CZ_KBBest umožňuje v režimu přímý kanál pro KB vytvářet i zahraniční platby s příznakem SEPA. (Tyto platby mívají výhodnější bankovní poplatky). SEPA platby jsou v systému ABRA Gen řešeny pomocí definovatelných položek dohodnutého jména SEPAPayment vytvořených k řádku plat. příkazu. Pokud taková položka existuje a je naplněna pomocí uživatelského formuláře na platebním příkazu, ovladač na ni reaguje. Dále viz realizace plateb s příznakem SEPA.

Bankovní výpisy

Název Doplňující popis
Cesta k datům bankovního výpisu Zde je třeba zadat platné jméno adresáře včetně disku a koncového zpětného lomítka. Adresář musí být vytvořen.
Přípona souboru

Zde lze definovat, jakou koncovku mají bank.výpisy, které tento driver načítá. Důvodem je to, že tento driver lze použít pro spolupráci s více bankovními klienty, u nichž ale může být koncovka rozdílná.

  • Pro komunikaci s Komerční bankou lze využít několik bankovních klientů:

    • starší BEST-KB (který umí načítat i starší formát dat určený pro ještě staršího klienta KB DATA)
    • novější internetový klient Mojebanka
    • novější klient Profibanka

    Všechny tři umí zpracovat formát dat z driveru KBBest, jsou však rozdíly v příponách. Klient BEST-KB tvoří soubor výpisů s příponou KMO. Klient Mojebanka tvoří soubor výpisů bez přípony, přičemž uživatel si ji ručně doplňuje. Klient Profibanka tvoří soubor výpisů s příponu OKM.

    V parametru driveru KBBest si nastavte příponu podle toho, jakého klienta používáte.

Jaké soubory budou načítány, ovlivňuje též nastavení režimu SEPA, viz dále.
Přípona souboru výpisu SEPA ISO XML

Výchozí hodnota je XML. Exportované výpisy musí mít příponu shodnou se zde zadanou příponou.

Ořezávat nuly zleva u VS pokud zatrhnete tuto předvolbu, bude ovladač ořezávat všechny nuly zleva u variabilních symbolů na výpisech z účtů. Nastavení nemá žádný vliv na vytvářené platební příkazy.
Před importem spustit

K dispozici jedině tehdy, že není zvolen vstup přes Přímý kanál , tj. v záložce Parametry není zatržena stejnojmenná položka.

Před vlastním importem je možné spustit libovolný externí program. Zadaný program se spustí ještě před vyhledáním importních souborů. Tuto vlastnost je tedy možné využít pro spuštění programu, který stahuje výpisy z banky.

Jméno defaultního souboru Více viz Defaultní importní soubor.
Režim SEPA

Možnost nastavit zda má být využíván režim SEPA. Lze zvolit následující hodnoty:

  • Nepoužívat výpis SEPA ISO XML - pokud je nastavena tato hodnota, režim SEPA pro výpisy nebude používán.
  • Používat pouze výpis SEPA ISO XML - pokud je nastavena tato hodnota, budou se importovat výpisy pouze ve formátu SEPA ISO XML.
  • Používat oba formáty naráz - v tomto módu jsou v adresáři očekávány oba formáty. Pokud systém ABRA Gen najde pouze jeden z nich, výpis se nenačte.

Ovladač pro KB BEST umí na řádek bankovního výpisu ukládat kromě variabilního symbolu a částky jako další údaj o příchozí platbě i číslo účtu "druhé strany" do definovatelné položky.

HB driver CZ_KBBest.hbd umí načíst číslo účtu protistrany do komunikačního XML. Při zpracování komunikačního XML se číslo účtu protistrany ('BankAccount') zapíše do uživatelsky definovatelné položky typu string 'U_BankAccount' (pokud taková položka bude existovat). Pokud taková položka neexistuje, neprovede se nic.

Export variabilního symbolu:

KB požaduje u tuzemských plateb v cizí měně Var. symbol ve specifické formě s pevně danými identifikátory. (např. 52198, kde 5 - resident, 2 - operace klientů, 198 - platební titul). Z toho plyne, že var. symbol dokladu je třeba exportovat v rámci jiné položky. Jelikož není záruka, jaká položka bude předána příjemci při platbě mezi různými bankami, plní se var. symbol do všech následujících položek ve tvaru čísla dokladu + var. symb. (např. v.s. 1234567890 (FV-2/2006)):

  • "Poznámka příkazce" offset pozice 239 (jedná se text, který dostane příkazce zpět ve svém výpisu)
  • "Zpráva AV - zpráva pro partnera" offset 56
  • "Poznámka partnera" offset 312 (jedná se o text, který dostane příjemce platby na papírovém výpisu)

Tuzemský/zahraniční příkaz:

Za cizí měnu je považována měna, která není CZK. KB rozděluje platby na "domácí" a "zahraniční" takto:

  • Domácí platby:
    • Vlastní účet u KB v CZK--→ účet partnera u KB platba v CZK = domácí platba
    • Vlastní účet u KB v CZK--→ účet partnera u KB platba v cizí měně = domácí platba
    • Vlastní účet u KB v cizí měně (např. EUR)--→ účet partnera u KB platba v CZK = domácí platba
    • Vlastní účet u KB v cizí měně (např. EUR)--→ účet partnera u KB platba v jiné cizí měně (např. USD) = domácí platba
    • Vlastní účet u KB v cizí měně (např. EUR)--→ účet partnera u KB platba ve stejné cizí měně (např. EUR) = domácí platba
    • Vlastní účet u KB v CZK--→ účet partnera mimo KB platba v CZK na účet v ČR = domácí platba
  • Zahraniční platby:
    • Vlastní účet u KB v CZK--→ účet partnera mimo KB platba v cizí měně na účet v ČR = zahraniční platba
    • Vlastní účet u KB v CZK--→ účet partnera mimo KB platba v CZK na účet mimo ČR = zahraniční platba
    • Vlastní účet u KB v CZK--→ účet partnera mimo KB platba v cizí měně na účet mimo ČR = zahraniční platba
    • Vlastní účet u KB v cizí měně (např. EUR)--→ účet partnera mimo KB platba ve stejné cizí měně (např. EUR) na účet v ČR = zahraniční platba
    • Vlastní účet u KB v cizí měně (např. EUR)--→ účet partnera mimo KB platba v jiné cizí měně (např. USD) na účet v ČR = zahraniční platba

Tudíž rozhodnutí, zda se má tvořit tuzemský nebo zahraniční příkaz, se negeneruje jen na základě položky Země, jak je tomu typicky u jiných driverů, ale současně se kontroluje, zda příjemce platby má stejný kód banky jako příkazce.

Pokud přijde na účet platba v cizí měně, do bankovního výpisu v ABRA Gen se naimportuje částka v měně účtu (offset 51). Částku v měně transakce (offset 68), tj. originální částku, která přišla do banky, importovat nelze, protože je k dispozici pouze včetně poplatků, které si banka za transakci strhává.