Popis ovládača CZ_KBBest.hbd

Nahradzuje plne obidva predchádzajúce ovládače KBBest.hbd a KBDirect.hbd.

Driver je možné využiť aj pre priamy prístup do Komerční banky (tzv. priamy kanál).

Služba priamykanál je ďalšou službou Priameho bankovníctva Komerční banky, ktorá umožňuje rozšíriť možnosti systémov mojebanka (poprípade profibanka) a ponúka možnosť veľmi jednoducho a rýchlo odoslať priamo z účtovného systému príkazy priamo do KB a získať výpisy v elektronickej podobe. Služba priamykanál je určená tým, ktorí chcú automatizovať komunikáciu s bankou, poprípade potrebujú prenášať veľké množstvo platieb a výpisov.

Parametre tohto ovládača sú usporiadané do nasledujúcich záložiek - tie sa líšia podľa toho, pre akú banku sa bude ovládač používať (volí sa na záložke Obecné, viď ďalej):

  • Pre MONETA Money Bank:
    Obsiahnuté záložky:VšeobecnéPlatobné príkazy zahraničné

    Pre MONETA Money Bank ovládač podporuje len tvorbu zahraničných platobných príkazov s tým, že v súbore platobného príkazu je kód banky 0600. Pre tvorbu tuzemských plat.príkazov a pre import BV sa odporúča použiť pre banku MONETA Money Bank ovládač CZ_ABO.

Prípony príkazov pre tento ovládač:

  • Prípona príkazov - *.IKM (definovateľná)
  • Prípona výpisov - *.KMO (definovateľná)

Všeobecné

Názov Doplňujúci popis
Banka

Možno zvoliť, pre akú banku sa bude ovládač používať. Podľa toho sa zmení ponuka záložiek i položiek v nich.

Ak ste zatiaľ v parametroch drivera nezvolili banku (keďže ste driver začali používať napr. ešte pred jeho rozšírením pre viacero bánk), tak sa defaultne berie, že je nastavená Komerční banka.
Priamy kanál

K dispozícii len pre banku KB (volí sa na záložke Všeobecné, viď ďalej).

Ak je začiarknuté, bude možné driver použiť aj pre vstup do banky cez priamy kanál. Následne sa sprístupnia aj nasledujúce voľby:

Názov Popis
Výkonný program KB - priamy kanál Špeciálny program určený na prevádzku priameho kanálu dodávaný Komerční bankou, viď popis drivera KBDirect.
Vyčistiť adresár pre export resp. import Ak je začiarknuté, tak pred exportom pl. príkazov resp. importom bankových výpisov najprv vyčistí adresár, kam sa tieto exportujú resp. importujú.

Princíp funkcie drivera pre priamy kanál viď popis drivera KBDirect.

Platobné príkazy/ Platobné príkazy - zahraničné

Názov Doplňujúci popis
Cesta pre ukladanie vygenerovaného platobného príkazu Tu je potrebné zadať platné meno adresára vrátane disku a koncovej spätnej lomky. Adresár musí byť vytvorený.
Po exporte spustiť

K dispozícii len vtedy, že nie je zvolený vstup cez Priamy kanál, tzn. v záložke Parametre nie je začiarknutá rovnomenná položka.

Potom je po vlastnom exporte možné spustiť externý program, napríklad program, ktorý rovno umožní vytvorený el. platobný príkaz odoslať do banky (zodpovedajúca stránka WWW). Vo volaní programu možno využívať parametre - viď popis pri funkcii Parametre.
Prípona súboru domáceho alebo zahraničného platobného príkazu Východisková hodnota je IKM. Vygenerované súbory budú mať tu zadanú príponu. Aké súbory vzniknú, ovplyvňuje tiež nastavenie režimu SEPA, viď ďalej.
Prípona súboru príkazu SEPA Východisková hodnota je XML. Vygenerované súbory budú mať tu zadanú príponu.
Režim SEPA

Slúži na realizáciu SEPA platieb priamo v rámci tohto ovládača. Sú tu k dispozícii nasledujúce možnosti:

  • Nepoužívať SEPA ISO XML - formát SEPA ISO XML sa nebude používať.
  • Používať len SEPA ISO XML - formát SEPA ISO XML sa bude používať pre všetky príkazy.
  • SEPA ISO XML len pre príkazy do oblasti SEPA - formát SEPA ISO XML bude používaný len pre príkazy, ktoré sú vystavené na firmu, ktorá má v adrese sídla uvedenú krajinu patriacu do oblasti SEPA.
  • SEPA ISO XML pre všetky zahraničné príkazy - formát SEPA ISO XML sa bude používať pre všetky zahraničné príkazy.

V prípade iných režimov ako Nepoužívať SEPA ISO XML sa Lokálna platba v EUR považuje tiež za SEPA platbu a vyexportuje sa v XML.

V prípade, že máte nastavenú poslednú voľbu "SEPA ISO XML pre všetky zahraničné príkazy", je nutné mať v Adresári firiem na subzáložke Bank. účty pri danom bankovom účte nastavenú položku Krajina banky alebo pri generovaní Žiadosti o platobný príkaz ručne zvoliť pri Type platby, že ide o Zahraničnú platbu (nenechať nastavenú voľbu na hodnotu “Určí ovládač“).

Podľa tohto nastavenia sa potom vytvárajú výstupné súbory: pokiaľ sa v príkaze nájdu riadky, ktoré podľa vyššie uvedeného nastavenia spadajú do spracovania pomocou SEPA XML, tak sa pre ne vytvorí adekvátny súbor. V dôsledku tým pádom môžu pre platby vzniknúť až tri súbory (domáce/zahraničné a SEPA XML).

Pokiaľ nastavíte formát výpisov na SEPA, je potrebné skontrolovať, že sú vyplnené nasledujúce položky v Adresári firiem: Názov firmy, IBAN, Ulica, Mesto a Kód krajiny.
Kódovanie SEPA XML

Vzhľadom k tomu, že jednotlivé banky podporujúce komunikáciu podľa ISO 20022 môžu vyžadovať rôzne spôsoby kódovania znakov v platobných príkazoch, je potrebné podľa informácií z konkrétnej banky vybrať v tejto položke zodpovedajúcu znakovú sadu, v ktorej bude platobný príkaz vytvorený. K dispozícii sú tieto možnosti:

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

Východisková hodnota je UTF_8.
Formát príkazu SEPA

Verzia formátu správy (tiež podľa ISO 20022). K dispozícii sú tieto možnosti:

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

Je potrebné zvoliť formát podporovaný konkrétnou bankou. Východisková hodnota je pain.001.001.03.
Odstraňovať diakritiku v ISO XML súbore

Parameter, ktorý určuje, či vo vygenerovanom platobnom príkaze budú znaky bez diakritiky. Východisková hodnota je Áno.

Platobné príkazy bez diakritiky vyžadujú napr. banky Tatrabanka, Unicredit a i.
Nevyplnené kódy krajín nahradzovať kódom lokálnej krajiny v ISO XML súbore Primárne systém ABRA Gen do platobného príkazu ISO XML preberá kód krajiny z položky Kód krajinyô na firme, ktorá je zadaná na platobnom príkaze. 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 tuzemskom príkaze v poli "Popis pre mňa" exportovať firmu protistrany

Pokiaľ je začiarknuté, tak sa v poli 17 Popis pre mňa exportuje názov firmy protistrany (v opačnom prípade sa exportuje Popis).

Položka je k dispozícii len na záložke Platobné príkazy (teda pre Komerčnú banku), nie na záložke Platobné príkazy - zahraničné.
Názov súboru so sekvenčnými číslami

Tento súbor slúži na ukladanie sekvenčných čísel platobných príkazov v rámci dňa pre jeden bankový účet. Každý riadok platobného príkazu pre daný bankový účet v priebehu jedného dňa musí mať svoje unikátne sekvenčné číslo. V súbore sú uložené najvyššie použité sekvenčné čísla pre jednotlivé dni.

Názov súboru je potrebné zadať vrátane absolútnej cesty k súboru. Ak súbor zadaného názvu neexistuje, sám sa založí. Odporúčame nazvať súbor tak, aby bolo zrejmé, ku ktorému bankovému účtu patrí, napr. C:\AbraGen\KB_123456_0100.dat, kde 123456/0100 je číslo príslušného bankového účtu. Každý bankový účet musí mať svoj vlastný súbor so sekvenčnými číslami.

Ak nie je parameter vyplnený, tak sa sekvenčné čísla ukladajú do registrov, viď popis nižšie.

Sekvenčné čísla

Ak podáte do Komerční banky (ďalej len KB) elektronický platobný príkaz, každý jeho riadok dostane sekvenčné číslo, pričom pri príjme v KB sa sleduje, aby za jednu firmu a deň neprišli rovnaké sekvenčné čísla.

V prípade, že bol v danom dni vygenerovaný platobný príkaz (odoslaný e-bankingom), tak sa zapamätá informácia o poôslednom použitom sekvenčnom čísle v rámci daného dňa. Pre tento ovládač platí, že sa pamätá v registroch daného počítača na daného užívateľa (na rozdiel od predchádzajúcich driverov KBBest.hbd a KBDirect.hbd).

Pri generovaní platobného príkazu sa tieto čísla načítajú a ak nie sú nulové (tzn. v rovnakom dni tvoríte a odosielate daným ovládačom ďalší príkaz), na začiatku jeho tvorby sa ponúkne číslo o jedna vyššie, ako posledné použité pamätané v registroch. Toto číslo je možné editovať. Prípadná medzera v v rade sekvenčných čísel nie je na závadu - KB kontroluje len duplicitu.

Sieťová prevádzka alebo viacero účtov u KB

KB kontroluje číslo sekvenčnej položky za klienta a nie za spôsob komunikácie a pod. Preto, ak používate driver CZ_KBBest, nie je možné ho v daný deň kombinovať s KBBest.hbd či KBDirect.hbd.

Z vyššie uvedeného plynie obmedzenie pre použitie tohto ovládača sieťovo: Ak by viacero užívateľov malo tvoriť platobné príkazy, môžu vystavovať viac platobných príkazov v jeden deň, len za predpokladu, že všetci zdieľajú Súbor so sekvenčnými číslami. Inak nemôžu informáciu o poslednom sekvenčnom čísle v daný deň uloženú v registroch na užívateľa navzájom zdieľať. V prípade, že máte viac účtov u KB, je situácia podobná. Tzn. ak má vzniknúť viac súborov s platobnými príkazmi v jeden deň, je potrebné, aby ho vytvoril jeden užívateľ z jedného PC alebo všetci zdieľali Súbor so sekvenčnými číslami.

Zahraničné platby s príznakom SEPA (Single European Payment Area) - priamy kanál

Ovládač CZ_KBBest umožňuje v režime priamy kanál pre KB vytvárať i zahraničné platby s príznakom SEPA. (Tieto platby mávajú výhodnejšie bankové poplatky). SEPA platby sú v systéme ABRA Gen riešené pomocou definovateľných položiek dohodnutého mena SEPAPayment vytvorených k riadku plat. príkazu. Ak taká položka existuje a je naplnená pomocou užívateľského formulára na platobnom príkaze, ovládač na ňu reaguje. Ďalej viď realizácia platieb s príznakom SEPA.

Bankové výpisy

Názov Doplňujúci popis
Cesta k dátam bankového výpisu Tu je potrebné zadať platné meno adresára vrátane disku a koncovej spätnej lomky. Adresár musí byť vytvorený.
Prípona súboru

Tu je možné definovať, akú koncovku majú bank.výpisy, ktoré tento driver načítajú Dôvodom je to, že tento driver je možné použiť pre spoluprácu s viacerými bankovými klientmi, u ktorých ale môže byť koncovka rozdielna.

  • Pre komunikáciu s Komerční bankou je možné využiť niekoľko bankových klientov:

    • starší BEST-KB (ktorý vie načítať i starší formát dát určený pre ešte staršieho klienta KB DATA)
    • novší internetový klient Mojebanka
    • novší klient Profibanka

    Všetky tri vedia spracovať formát dát z drivera KBBest, sú však rozdiely v príponách. Klient BEST-KB tvorí súbor výpisov s príponou KMO. Klient Mojebanka tvorí súbor výpisov bez prípony, pričom užívateľ si ju ručne dopĺňa. Klient Profibanka tvorí súbor výpisov s príponu OKM.

    V parametre drivera KBBest si nastavte príponu podľa toho, akého klienta používate.

 Aké súbory budú načítané, ovplyvňuje tiež nastavenie režimu SEPA, viď ďalej.
Prípona súboru výpisu SEPA ISO XML

Východisková hodnota je XML. Exportované výpisy musia mať príponu zhodnú s tu zadanou príponou.
Orezávať nuly zľava na VS pokiaľ zatrhnete túto predvoľbu, bude ovládač orezávať všetky nuly zľava na variabilných symboloch na výpisoch z účtov. Nastavenie nemá žiadny vplyv na vytvárané platobné príkazy.
Pred importom spustiť

K dispozícii len vtedy, že nie je zvolený vstup cez Priamy kanál , tzn. v záložke Parametre nie je začiarknutá rovnomenná položka.

Pred vlastným importom je možné spustiť ľubovolný externý program. Zadaný program sa spustí ešte pred vyhľadaním importných súborov. Túto vlastnosť je teda možné využiť na spustenie programu, ktorý sťahuje výpisy z banky.
Meno defaultného súboru Viac viď Defaultný importný súbor.
Režim SEPA

Možnosť nastaviť, či má byť využívaný režim SEPA. Je možné zvoliť nasledujúce hodnoty:

  • Nepoužívať výpis SEPA ISO XML - pokiaľ je nastavená táto hodnota, režim SEPA pre výpisy nebude používaný.
  • Používať len výpis SEPA ISO XML - pokiaľ je nastavená táto hodnota, budú sa importovať výpisy len vo formáte SEPA ISO XML.
  • Používať oba formáty naraz - v tomto móde sú v adresári očakávané oba formáty. Pokiaľ systém ABRA Gen nájde len jeden z nich, výpis sa nenačíta.

Ovládač pre KB BEST vie na riadok bankového výpisu ukladať okrem variabilného symbolu a sumy ako ďalší údaj o prichádzajúcej platbe i číslo účtu "druhej strany" do definovateľnej položky.

HB driver CZ_KBBest.hbd vie načítať číslo účtu protistrany do komunikačného XML. Pri spracovaní komunikačného XML sa číslo účtu protistrany ('BankAccount') zapíše do užívateľsky definovateľnej položky typu string 'U_BankAccount' (ak taká položka bude existovať). Ak taká položka neexistuje, nevykoná sa nič.

Export variabilného symbolu:

KB požaduje v prípade tuzemských platieb v cudzej mene Var. symbol v špecifickej forme s pevne danými identifikátormi. (napr. 52198, kde 5 - rezident, 2 - operácia klientov, 198 - platobný titul). Z toho vyplýva, že var. symbol dokladu je potrebné exportovať v rámci inej položky. Keďže nie je záruka, aká položka bude odovzdaná príjemcovi pri platbe medzi rôznymi bankami, plní sa var. symbol do všetkých nasledujúcich položiek v tvare čísla dokladu + var. symb. (napr. v.s. 1234567890 (FV-2/2006)):

  • "Poznámka príkazcu" offset pozície 239 (ide o text, ktorý dostane príkazca späť vo svojom výpise)
  • "Správa AV - správa pre partnera" offset 56
  • "Poznámka partnera" offset 312 (ide o text, ktorý dostane príjemca platby na papierovom výpise)

Tuzemský/zahraničný príkaz:

Za cudziu menu je považovaná mena, ktorá nie je EUR. KB rozdeľuje platby na "domáce" a "zahraničné" takto:

  • Domáce platby:
    • Vlastný účet v KB v EUR--→ účet partnera v KB platba v EUR = domáca platba
    • Vlastný účet v KB v EUR--→ účet partnera v KB platba v cudzej mene = domáca platba
    • Vlastný účet v KB v cudzej mene (napr. USD) --→ účet partnera v KB platba v EUR = domáca platba
    • Vlastný účet v KB v cudzej mene (napr. USD) --→ účet partnera v KB platba v inej cudzej mene (napr. USD) = domáca platba
    • Vlastný účet v KB v cudzej mene (napr. USD) --→ účet partnera v KB platba v rovnakej cudzej mene (napr. USD) = domáca platba
    • Vlastný účet v KB v EUR --→ účet partnera mimo KB platba v EUR na účet v SR = domáca platba
  • Zahraničné platby:
    • Vlastný účet v KB v EUR --→ účet partnera mimo KB platba v cudzej mene na účet v SR = zahraničná platba
    • Vlastný účet v KB v EUR--→ účet partnera mimo KB platba v EUR na účet mimo SR = zahraničná platba
    • Vlastný účet v KB v EUR--→ účet partnera mimo KB platba v cudzej mene na účet mimo SR = zahraničná platba
    • Vlastný účet v KB v cudzej mene (napr. USD)--→ účet partnera mimo KB platba v rovnakej cudzej mene (napr. USD) na účet v SR = zahraničná platba
    • Vlastný účet v KB v cudzej mene (napr. USD)--→ účet partnera mimo KB platba v inej cudzej mene (napr. JPY) na účet v SR = zahraničná platba

Teda rozhodnutie, či sa má tvoriť tuzemský alebo zahraničný príkaz, sa negeneruje len na základe položky Krajiny, ako je tomu typicky v prípade iných driverov, ale súčasne sa kontroluje, či príjemca platby má rovnaký kód banky ako príkazca.

Ak príde na účet platba v cudzej mene, do bankového výpisu v ABRA Gen sa naimportuje suma v mene účtu (offset 51). Sumu v mene transakcie (offset 68), tzn. originálnu sumu, ktorá prišla do banky, importovať nie je možné, pretože je k dispozícii len vrátane poplatkov, ktoré si banka za transakciu strháva.