Lekérdező HypEx bankterminál

Lekérdező HypEx bankterminál Autmatikus HypEx bankterminál a Raiffeisen ügyfél adatk letöltésére Verzió: 1.1 2016. 09. 30. Cardinal Kft. 2016.

Tartalmjegyzék: 1. Bevezetés... 3 2. A Lekérdező HypEx prgram... 3 2.1 A HypEx prgram... 3 2.2 Hardver, szftver környezet... 3 3. HypEx prgram kezelése... 4 3.1 A HypEx prgram regisztrálása... 5 3.2 A HypEx prgram frissítése... 5 4. A HypEx bankterminál prgram működése... 5 4.1 Jgsultságk az Electra rendszerben... 5 4.2 Több ügyfél kezelése a HypExben... 6 4.3 Knfigurálás a leíró tábla... 6 4.4 Az exprt könyvtárak megadása... 10 2 / 13

1. Bevezetés Ez a dkumentáció a Raiffeisen Bank lekérdező banki kapcslatát megvalósító HypEx bankterminál prgram leírását tartalmazza. 2. A Lekérdező HypEx prgram 2.1 A HypEx prgram A HypEx prgram egy Micrsft Windws platfrmn működő, 32 bites alkalmazás, amelynek feladata a banki kapcslat autmatikus megvalósítása. A HypEx prgram a bankban működő Electra rendszer része, amely az Electra szerverhez kapcslódik. Az Electra ügyfélprgrammal megegyező kmmunikációs, biztnsági, imprt és exprt mdulkat tartalmazza. A HypEx prgramk is rendelkeznek egyedi aznsítóval, ügyfelekhez vannak hzzárendelve, a bank közpntjából is frissíthetők. A bankkal való szerződéskötéskr minden ügyfélnek meg kell neveznie azkat a felhasználókat, akik az Electra rendszert használhatják. Ezeknek a felhasználóknak saját bejelentkezési jelszavuk, aláírói jgsultság esetén saját elektrnikus aláírási jelszavuk, és minden számlára és levelezésre külön-külön meghatárztt jgsultságuk van. Mindezeket a banki rendszer tartja nyilván és ellenőrzi, valamint biznys adatkat (jelszavakat és jgsultsági táblákat) letölt a prgramba, hgy a lekérdezési jgkat a helyi használat srán is ellenőrizni lehessen. A HypEx prgram használata előtt egy felhasználónak mindenképpen aznsítania kell magát. Az aznsítás a bejelentkezési jelszó megadásával valósul meg. A HypEx prgram képes egyszerre több ügyfél kezelésére is. Az ügyfelek HypEx prgramhz való hzzárendelését a banki rendszer végzi és tartja nyilván, a HypEx rendszer ezeket az infrmációkat letölti a prgramba, hgy a jgkat a helyi használat srán is ellenőrizni lehessen. A HypEx prgram nem hálózats működésű, tehát egyszerre egy időben csak egy példánya futhat. A prgram a működése srán naplófájlt készít, amelyben megtekinthető, hgy a prgram használata srán ki, mikr, milyen műveletet hajttt végre, milyen események történtek. A napló havi bntásban készül. Minden egyes esemény külön-külön srban látható, amely tartalmazza a pnts dátumt és időpntt, a felhasználó aznsítóját és az esemény szöveges leírását. 2.2 Hardver, szftver környezet Az adtt perációs rendszer futtatására alkalmas számítógép Operációs rendszerek: Windws XP*, Windws 7, Windws 8 Banki kapcslathz széles sávú Internet elérés *A Micrsft 2014. április 8-án megszüntette a Windws XP és az Internet Explrer 8 böngésző támgatását. Javasljuk a cserét egy újabb, támgattt perációs rendszerre, illetve mindig a legfrissebb böngésző verzió használatát. 3 / 13

3. HypEx prgram kezelése A HypEx prgram elindítása után az Electra prgramhz hasnlóan egy nyitókép fgadja a felhasználót. Ezen a nyitóképernyőn lehetőség van a bankba való kézi bejelentkezésre, ill. a fő funkciók elérésére. A fő funkciók közé tartzik a HypEx közpnti magja, a paraméterek beállítása, és a napló megnézése. A prgram használata előtt egy felhasználónak mindenképpen aznsítania kell magát a HypEx prgramban. Az aznsítás a bejelentkezési jelszó megadásával történik. Sikeres aznsítás után a prgram már átjárható, tehát a különböző funkciók között külön jelszómegadás nélkül is lehet mzgni. A HypEx prgram üzemszerű működése srán a sikeres aznsítást követően be kell lépni a HypEx kezelése funkcióba, majd egy gmbnymással el kell indítani a végrehajtást (HypEx újraindítása funkció). Ekkr a prgram belvassa a műveleteket leíró táblázatt, és végignézi, hgy az időpnt leírásk alapján van-e elvégzendő művelete. Ha nincs mit csinálnia, akkr vár az első időpnt bekövetkeztéig, vagy addig, amíg le nem állítják az autmata működést. A leíró táblázat karbantartását csak úgy lehet elvégezni, ha az autmata működés ki van kapcslva (HypEx megállítása funkció). A karbantartást segítő ablakt az autmata működés ablakából kiindulva lehet elérni a HypEx knfigurálás funkció kiválasztásával. A leíró táblázat karbantartó ablaka megmutatja, hgy pillanatnyilag mikr és milyen műveleteket hajtana végre a HypEx az autmata üzemmódjában. Itt lehetőség van új műveletek felvételére, meglévő műveletek időpntjának, ill. frmátumának módsítására és természetesen műveletek törlésére. A karbantartás végeztével az újnnan előállt leíró táblázatt a kilépés előtt még el kell menteni. Amennyiben a felhasználó úgy dönt, kiléphet a módsításk érvényesítése nélkül is. A paraméterbeállítás menüpnt alatt lehet a bejelentkezési és aláírási jelszót módsítani, a HypEx naplóját megnézni, a prgramt regisztrálni. A HypEx prgram főképernyőjén az alábbi funkció érhetők el: HypEx kezelése az autmatikus beküldő-lekérdező flyamat kezelőfelületének elérése Paraméterbeállítás a prgram általáns működésével kapcslats paraméterek beállításának felülete Manuális kapcslódás a banki rendszerhez Bejelentkezés gmb a képernyő jbb felső sarkában Kilépés a prgramból Prgram bezárása gmb a képernyő bal felső sarkában Help Súgó felirat a képernyő jbb felső sarkában A HypEx kezelése menüpntba lépve az alábbi funkciók közül választhatunk: HypEx újraindítása ha ez a menüpnt aktív, akkr az autmatikus lekérdezőbeküldő üzemmód éppen nem fut, itt lehet újra elindítani az imprt könyvtár flyamats figyelését és az érkező fájlk feldlgzását. HypEx megállítása ha ez a menüpnt aktív, akkr az autmatikus lekérdezőbeküldő üzemmód éppen fut, és itt lehet a futását felfüggeszteni. HypEx knfigurálás itt kell a prgram autmata működését leíró táblát kitölteni. Napló megnézése napló a prgram által végrehajttt fnts műveletekről havnkénti bntásban 4 / 13

A Paraméterbeállítás menüpntba lépve az alábbi funkciók közül választhatunk: Biztnság Jelszóbeállításk Regisztrációs megbízás készítése/megnézése Mentés/visszaállítás Napló megnézése Beállításk Nyelv kiválasztása Futtatási környezet megnézése Prgramfrissítés Ügyféladatk Ügyfél neve, címe Számlaszámk listája Kezdeti számlaszámk Felhasználók listája Aktív helyi felhasználók Beküldési határidők 3.1 A HypEx prgram regisztrálása A bank és az ügyfél között a HypEx rendszer használatára vnatkzó szerződés aláírása után, a telepítést megelőzően a banki rendszerben engedélyezik a kiadtt új prgram regisztrálását. A prgram telepítése alkalmával elektrnikus útn be kell jelenteni az új prgrampéldányt a banki rendszernek, vagyis a prgramt regisztráltatni kell. Válassza ki a főképernyőn a Paraméterbeállítás funkciót, majd a megjelenő képernyőn a Regisztrációs megbízás menüpntt. A prgram létrehz egy regisztrációs megbízást, amit cégszerű aláírással ellátva be kell küldenie a banki rendszernek. A banki rendszer csak a regisztrációs megbízás megérkezése után fgad el ettől a HypEx prgramtól megbízáskat. 3.2 A HypEx prgram frissítése A HypEx prgram frissítését a bank közpntjából kezdeményezik. Manuálisan be kell jelentkezni a bankba, ekkr letöltődnek a módsításk, majd a prgramból kilépve és újra belépve végrehajtódik a prgram frissítése. A frissítés alatt az autmatikus működést le kell állítani! 4. A HypEx bankterminál prgram működése 4.1 Jgsultságk az Electra rendszerben Az Electra rendszer egymástól függetlenül, külön-külön halmazként kezeli az ügyfélkódk (azaz a cégek), a személyek (vagyis a felhasználók) és az ügyfélprgramk halmazát. Az ezek közötti kapcslatkat a jgsultságk adják, amiket szerződéskötéskr a cégek (a bank ügyfelei) határzzák meg. Ezek alapján az Electra rendszerben bármilyen kapcslat felépíthető: lehet egy cégnek több 5 / 13

ügyfélprgramja, tartzhat egy ügyfélprgram több céghez, lehet egy cégnek több felhasználója, egy személy lehet több cég alkalmazttja. Egy személy bármely lyan ügyfélprgrammal bejelentkezhet, amelyet egy lyan cég használ, amelynek számláihz a személy jgkkal rendelkezik. Bármely ilyen prgrammal lekérdezhet vagy aláírhat megbízást (mindenütt ugyanazkat a saját jelszavakat használja), ha a személy a szükséges jgsultságkkal rendelkezik, a parancst a banki rendszer végrehajtja. Az ügyfél csak akkr használhatja az Electra rendszert, ha birtkában van a bankkal való kapcslattartásra szlgáló ügyfélprgram. Az ügyfélprgramk srszámzttak és ügyfélhez illetve ügyfelekhez rendeltek. Minden ügyfél csak a saját prgramjával tud bejelentkezni a banki rendszerbe. Szerződéskötéskr minden ügyfélnek meg kell neveznie azkat a felhasználókat, akik az Electra rendszert használhatják. Ezeknek a felhasználóknak saját bejelentkezési jelszavuk, aláírói jgsultság esetén saját elektrnikus aláírási jelszavuk, és minden számlára és levelezésre külön-külön meghatárztt jgsultságuk van. Mindezeket a banki rendszer tartja nyilván és ellenőrzi, valamint biznys adatkat (jelszavakat és jgsultsági táblákat) letölt az ügyfélprgramba, hgy a lekérdezési jgkat a helyi használat srán is ellenőrizni lehessen. A bejelentkezési jelszót csak maga a felhasználó ismeri, és bármikr önállóan megváltztathatja, ha tart attól, hgy azt illetéktelenek megtudták (az ügyfélprgram a megváltztt jelszót aznnal tvábbítja a banki rendszernek, s tt titksítva kerül tárlásra, azaz a banki alkalmazttak sem férhetnek hzzá). Alapvetően fnts, hgy az aznsítót és a hzzá tartzó jelszót csak az arra jgsultak ismerjék meg. Az ügyfélprgrammal a banki rendszerbe való bejelentkezéshez szükség van a bejelentkezési jelszóra, de ez egyben elegendő is. Minden felhasználónak minden egyes számlára külön megadható az aláírási jga: aláírhat-e egy a számlára vnatkzó megbízást, ill. "mennyit ér" az aláírása (pl. szükség van-e még másk aláírására is). A megbízáskat beküldés előtt megfelelő jgkkal rendelkező felhasználónak elektrnikus aláírással alá kell írni. 4.2 Több ügyfél kezelése a HypExben A HypEx prgram képes egyszerre több ügyfél kezelésére is. Az ügyfelek HypEx prgramhz való hzzárendelését a banki rendszer végzi és tartja nyilván, a HypEx rendszer ezeket az infrmációkat letölti a prgramba, hgy a jgkat a helyi használat srán is ellenőrizni lehessen. A HypEx prgram annak az ügyfélnek a nevében jelentkezik be a bankba, akit a knfigurációs leíró táblában meghatárztak. A különböző műveletek aznban képesek arra, hgy ügyfelet váltsanak, ha szükséges. A több ügyfeles működés szükséges feltétele, hgy ugyanaz a felhasználó hzzá legyen rendelve az összes ügyfélhez. 4.3 Knfigurálás a leíró tábla A HypEx prgram közpnti eleme az autmata működést biztsító mag, ami egy leíró tábla alapján dlgzik. A leíró tábla művelet bejegyzéseket tartalmaz, ahl egy bejegyzéshez meg kell adni egy időpnt leírást és egy elvégzendő műveletet. Az autmata működés nymn követéséhez tartzik egy képernyő, ahl látható, hgy a HypEx éppen milyen állaptban van, ill. milyen műveletet végez. Ezen a mnitrzó ablakn kell az autmata működést elindítani, és megállítani, ill. innen lehet belépni a leíró tábla karbantartását végző ablakra is. 6 / 13

A leíró táblázat karbantartását csak úgy lehet elvégezni, ha az autmata működés ki van kapcslva. A leíró tábla karbantartásánál lehetőség van új művelet felvételére, meglévő bejegyzések módsítására, illetve törlésére. Az egyes bejegyzésekhez tartzó adatkat is itt kell megadni. A Lekérdező HypEx prgramban feladatkat és műveleteket adhatunk meg. Egy feladat több műveletet is tartalmazhat, ilyenkr azk srban egymás után hajtódnak végre és a bejelentkezés is csak egyszer történik meg. Feladatk jellemzői: Kezdő időpnt: A feladat indulási időpntja, ismétlődő feladat esetén az első végrehajtás ideje. A feladatkat a prgram percenként vizsgálja. Nem indít el egy feladatt, ha az indítási időpntjában egy másik feladat éppen fut. Periódus: Ismétlődő feladatk milyen gyakrisággal induljn. A mértékegysége perc. Nem ismétlődő feladatnál üresen kell hagyni. Végső időpnt: Ismétlődő feladat utlsó indítási ideje. Bejelentkezés szükséges: Be kell-e jelentkezni az adtt feladathz. Ha meg van adva, akkr a prgram autmatikusan bejelentkezik a megadtt adatk alapján, különben egy adminisztrátrnak kell a HypEx-be bejelentkezni a feladat indulása előtt. Ügyfélaznsító: Az autmata bejelentkezéshez használt ügyfélkód Csprt: Az autmata bejelentkezéshez használt csprtkód Felhasználó neve: Kinek a nevében jelentkezzen be Jelszó: Bejelentkezési jelszó Műveletek jellemzői: Művelet: A végrehajtandó műveletet kell kiválasztani egy listából. Az alábbi letöltések választhatók: Napi tranzakciók Számlakivnat Számlaegyenleg CS-STATUS üzenet DETSTA napi jelentés DETSTA összesítő jelentés FELHKI üzenet FELHNA üzenet Pstai csekkek értesítője Pstai kifizetési utalványk értesítője Kijelentkezés 7 / 13

Exprt frmátum: A lekért adatt milyen frmátumban exprtáljuk. Egy elnyílóból választható ki a kívánt frmátum. Lehetséges frmátumk: Napi tranzakciók Számlakivnat Számlaegyenleg CS-STATUS üzenet DETSTA napi jelentés DETSTA összesítő jelentés FELHKI üzenet FELHNA üzenet Pstai csekkek értesítője Pstai kifizetési utalvány T napi Számlatörténet exprt frmátuma T napi Számlatörténet exprt frmátuma - számlánként MT940 frmátum MT940 frmátum - számlánként Multicash frmátum Multicash frmátum - számlánként Eredeti frmátum Eredeti frmátum - számlánként Számlatörténet frmátuma Számlatörténet frmátuma - számlánként RBH frmátum RBH frmátum - számlánként Ugir frmátum Ugir frmátum Ugir frmátum Ugir frmátum Ugir frmátum Pstai frmátum Pstai frmátum (tételek+képek) RBH frmátuma Pstai frmátum Exprt kódlap: Választható a Windws vagy a CdePage 852 érték. Exprt könyvtár/file-név: Egy minta, amely meghatárzza, hgy milyen útvnaln és milyen néven mentse el a lekért adatkat. Az alábbi kisbetűknek speciális jelentése van, kicserélődnek az alábbi értékekre (amennyiben az adtt esetben értelmezhetők): - y a lekért adat dátumából az évszám számjegyei (max. 4 db) pl. D:\RBH_HypEx\EXPORT\KIVyyyy.TXT minta esetén D:\RBH_HypEx\EXPORT\KIV2016.TXT lesz a fájl neve 2016.12.31-i adat esetén - m a lekért adat dátumából a hónap számjegyei (max. 2 db) pl. D:\RBH_HypEx\EXPORT\KIVyyyymm.TXT minta esetén D:\RBH_HypEx\EXPORT\KIV201612.TXT lesz a fájl neve 2016.12.31- i adat esetén - d a lekért adat dátumából a napk számjegyei (max. 2 db) pl. D:\RBH_HypEx\EXPORT\KIVyyyymmdd.TXT minta esetén D:\RBH_HypEx\EXPORT\KIV20161231.TXT lesz a fájl neve 2016.12.31-i adat esetén 8 / 13

- h a lekért adat dátumából az órák számjegyei (max. 2 db) - i a lekért adat dátumából az percek számjegyei (max. 2 db) - s a lekért adat dátumából a másdpercek számjegyei (max. 2 db) - # srszám számjegyei (a feladat végrehajtásainak száma, 1-től indulva egyesével nő, max. 8 db ) pl. D:\RBH_HypEx\EXPORT\yyyymmdd_###.TXT minta esetén D:\RBH_HypEx\EXPORT\20161231_005.TXT lesz a fájl neve 2016.12.31-i adat esetén az 5. alkalmmal - a a számlaszám jegyei (max. 24 db) pl. D:\RBH_HypEx\EXPORT\aaaaaaaa_aaaaaaaa_aaaaaaaa.KIV minta esetén D:\RBH_HypEx\EXPORT\10300002_22222222_33333333.KIV lesz a fájl neve 10300002_22222222_33333333 számlaszám esetén - c az ügyfélkód jegyei (max. 8 db) pl. D:\RBH_HypEx\EXPORT\cccccccc_yyyymmdd.KIV minta esetén D:\RBH_HypEx\EXPORT\EL100026_20161231.KIV lesz a fájl neve EL100026 ügyfél és 2016.12.31-i adat esetén - u az ugir kód jegyei (max. 13 db) pl. D:\RBH_HypEx\EXPORT\uuuuuuuuuuuuu_yyyymmdd.CSS minta esetén D:\RBH_HypEx\EXPORT\A123456789000_20161231.CSS lesz a fájl neve A123456789000 ugirkód és 2016.12.31-i adat esetén Az útvnalban a nagybetűvel megadtt karaktereket nem cseréli le, váltzatlanul hagyja. A számlánkénti exprtfrmátumk esetén csak az exprt könyvtár adható meg, a fájlnév az adat dátuma és a számlaszám lesz: <számlaszám 24 jegye>_<adat dátumának 8 jegye>.<kiterjesztés> Meg lehet adni a művelet paramétereit is, erre egy táblázat szlgál. A táblázatban megadtt minták szűrő feltételként szlgálnak, csak az ezekre illeszkedő értékű adatk kerülnek bele az exprt eredményébe. pl. Ha a számlaszám minta ********11111111********, akkr csak azk az adatsrk lesznek exprtálva, ahl a számlaszám másdik nylcasa 11111111 értékű. A paraméter értékét az adtt srra való dupla kattintással lehet módsítani. CLN: ügyfél aznsító minta, amely meghatárzza, hgy mely ügyfelek adatait kérjük le, nem kötelező. Ha üres, akkr a bejelentkező ügyfél nevében kérdezi le az adatt. Megadhatók * karakterek is, ilyenkr az összes illeszkedő aznsítóra lekérdez. ACC: számlaszám minta, amely meghatárzza, hgy milyen számlaszámk adatait kérjük le. Megadhatók * karakterek is, ilyenkr az összes illeszkedő számlaszám adatát exprtáljuk. Alapértelmezés a *, vagyis az összes számlaszám. 9 / 13

DATE: egy egész szám, ami az aktuális dátumhz képest egy eltlást jelent napkban (pl. 1 esetén az előző napt kéri le). Nem kötelező, alapértéke, ha üres, akkr az utlsó kéri le. A működést leíró táblát csak egyszer kell létrehzni, esetleges módsításk a későbbiekben elvégezhetők a Módsítás menüpnttal. 4.4 Az exprt könyvtárak megadása Az egyes műveletek definiálásánál a Művelet adatai ablakn a File-név mezőben kell megadni. Például: D:\RBH_HypEx\EXPORT\cccccccc\KIVyyyymmdd.TXT minta esetén D:\RBH_HypEx\EXPORT\EL100026\KIV20161231.TXT lesz a fájl neve EL100026 ügyfél és 2016.12.31-i adat esetén A számlánkénti exprtfrmátumk esetén csak az exprt könyvtár adható meg! Például: D:\RBH_HypEx\EXPORT\cccccccc ekkr D:\RBH_HypEx\EXPORT\EL100026 könyvtárba kerülnek <számlaszám 24 jegye>_<adat dátumának 8 jegye>.<kiterjesztés> néven. 10 / 13

Javaslatk a lekérdező HypEx terminál knfigurálására. Vannak állmányk, melyek reggel lekérdezhetőek és napközben már nem váltzik a tartalmuk ezeket a típuskat elég a napkezdéskr egyszer lekérdezni. Más típusú lekérdezés állmányk visznt napközben állítódnak elő vagy váltzik a tartalmuk a napi fizetésfrgalm flyamán A lekérdezhető állmányk Napi tranzakciók Az állmány tartalma váltzik, a számlatörténet tárgynapi adatait tartalmazza a napnyitástól a lekérdezés időpntjáig Számlakivnat Az állmány reggel napnyitáskr rendelkezésre áll, a bankszámlakivnat frgalmi adatait tartalmazza, tartalma nem váltzik Számlaegyenleg Az állmány tartalma váltzik, ahgyan a számla egyenlege módsul CS-STATUS üzenet A csprts utalásk beküldésekr keletkezik ilyen állmány, ez napnta többször is előállhat DETSTA napi jelentés Az állmány reggel napnyitáskr rendelkezésre áll, a csprts megbízásk jelentéseit tartalmazza DETSTA összesítő jelentés Az állmány reggel napnyitáskr rendelkezésre áll, a csprts megbízásk összesítő jelentéseit tartalmazza FELHKI üzenet Az állmány reggel napnyitáskr rendelkezésre áll, a csprts beszedéshez tartzó felhatalmazáskat tartalmazza FELHNA üzenet Az állmány reggel napnyitáskr rendelkezésre áll, a FELHKI üzenet válaszait tartalmazza Pstai csekkek értesítője Az állmány reggel napnyitáskr rendelkezésre áll, a csekkes befizetések részletezését tartalmazza Pstai kifizetési utalványk értesítője Az állmány reggel napnyitáskr rendelkezésre áll, a kifizetési utalvány csmag válaszait tartalmazza Kijelentkezés Minden művelet után a kijelentkezés használta erősen ajánltt 11 / 13

Napkezdéskr lekérdezhető állmányk: Számlakivnat DETSTA napi jelentés DETSTA összesítő jelentés FELHKI üzenet FELHNA üzenet Pstai csekkek értesítője Pstai kifizetési utalványk értesítője Példa egy feladat beállítására Végrehajtandó feladatk listája 12 / 13

Napközben előálló, vagy váltzó állmányk Napi tranzakciók Számlaegyenleg CS-STATUS üzenet Kijelentkezés A Hypex terminál autmatikusan bejelentkezik az ütemezések szerint. Ahhz, hgy ne maradjn bejelentkezve és esetleges vnalszakadás vagy egyéb technikai prblémák ne kzzanak nehézséget a kijelentkezés használata minden művelet végén ajánltt. 13 / 13