ABO štruktúra in/out súborov pre službu internet banking Prima banka Slovensko, a.s. (ďalej Prima banka ) Špecifikácia
ÚVOD... 3 ŠTRUKTÚRA SÚBORU DENNÝCH VÝPISOV V ELEKTRONICKEJ FORME... 4 ŠTRUKTÚRA FORMÁTU DOMÁCICH PLATOBNÝCH PRÍKAZOV... 6 ŠTRUKTÚRA FORMÁTU DOMÁCICH INKASNÝCH PRÍKAZOV... 7 ŠTRUKTÚRA FORMÁTU ZAHRANIČNÝCH PREVODNÝCH PRÍKAZOV... 8 2 / 8
Úvod Pre automatizované generovanie údajov pre banku, ako aj pre spracovanie údajov z banky, je v nasledujúcom texte objasnená štruktúra a význam jednotlivých súborov. Banka je schopná klientom sluţieb internet banking a homebanking (na základe ţiadosti v internet bankingu - súčasne aj pre homebanking) začať zasielať výpisy obratov z účtov v elektronickej forme, v ktorej je moţné tieto výpisy importovať do finančných softvérov klientov. V jednom elektronickom výpise sa nachádzajú iba obraty za jeden bankový účet, pre daný konkrétny pracovný deň. 1. Postup pre zadanie ţiadosti v sluţbe internet banking: - Prihlásenie do sluţby internet banking - Zvoliť pole Ţiadosti - Zvoliť pole Denné zasielanie ABO výpisu - Vybrať príslušný účet a vyplniť poţadované polia ţiadosti ( Zadajte emailovú adresu, Heslo pre zakódovanie emailu.rar ) - Pre potvrdenie ţiadosti kliknúť na Odoslať 2. Postup pre zadanie ţiadosti v sluţbe homebanking: - Ţiadosť je moţné zadať iba v sluţbe internet banking (bod 1.) Klientom zasiela banka elektronické výpisy nasledovne: 1. Služba internet banking - elektronické výpisy sú zasielané na e-mailovú adresu, ktorú si zvolí klient v elektronickej ţiadosti pre zasielanie výpisov 2. Služba homebanking - elektronické výpisy sú zasielané priamo do sluţby homebanking Názov dátového súboru s elektronickým výpisom je nasledujúci: XXXXXXXXXX_DD_MM_PRIMABANKA.ABO - denný výpis v el. forme, kde XXXXXXXXXX - číslo účtu DD - deň MM - mesiac Doplňujúce informácie: - štandardne nie je moţné poţiadať o zasielanie výpisov so spätným dátumom - výpisy vymazané v homebankingu nie je moţné opätovne stiahnuť do aplikácie - generovanie ABO výpisov so spätným dátumom je spoplatňované a je obmedzené typom údajov 3 / 8
Štruktúra súboru denných výpisov v elektronickej forme Denný výpis z účtu (ABO Prima banky) obsahuje všetky debetné a kreditné transakcie uskutočnené na účte, vyvolané prevodným príkazom na ťarchu ako aj v prospech účtov klienta. Elektronický výpis pre klienta sa skladá z dvoch typov poloţiek. Prvý riadok v súbore je vţdy poloţka typu 074 (hlavička) a ďalšie sú poloţky typu 075 (obraty na účte). Kaţdý riadok typu 075 predstavuje jeden kreditný alebo debetný obrat na danom účte klienta. položka typu 74 (hlavička) - obsahuje identifikáciu klienta a sumárne údaje o klientovi. V podmienkach Prima banky to je: Názov poľa Typ Hodnota: Pozn. 1 Typ záznamu C(3) Hlavička súboru A 2 Číslo klienta C(16) predčíslie + retailové číslo klienta Prima banky B 3 Názov organizácie C(20) názov účtu klienta Prima banky 4 Dátum starého zostatku C(6) C 5 Starý zostatok C(14) opening balance z daného dňa D 6 Znamienko starého zostatku C(1) podľa opening balance +, - E 7 Nový zostatok C(14) closing balance D 8 Znamienko nového zostatku C(1) podľa closing balance +, - E 9 Obraty debet C(14) suma DR obratov z predošlého dňa D 10 Znamienko obratov debet C(1) vţdy 0 11 Obraty kredit C(14) suma CR obratov z predošlého dňa D 12 Znamienko obratov kredit C(1) vţdy 0 13 Poradové číslo výpisu C(3) poradové číslo papierového výpisu klienta 14 Dátum účtovania C(6) valuta ddmmrr 15 Znaky medzera C(61) F položka typu 75 ( detail ) - obsahuje identifikáciu jednotlivých platieb pre daného klienta. V podmienkach Prima banky to je: Názov poľa Typ Hodnota: Pozn. 1 Typ záznamu C(3) 075 - detail platby G 2 Účet príjemcu ABO výpisu C(16) číslo účtu v Prima banke B 3 Číslo účtu C(16) číslo účtu protistrany 4 Číslo dokladu C(13) číslo dokladu, len pre clearingové platby 5 Čiastka C(12) D 6 Kód účtovania C(1) hodnoty 1, 2 ( 1 - má dať, 2 - dal ) H 7 Variabilný symbol C(10) VS ak existuje pre daný typ transakcie 8 Konštantný symbol C(10) KS ak existuje pre daný typ transakcie 9 Špecifický symbol C(10) SS ak existuje pre daný typ transakcie 10 Valuta C(6) valuta - value date ddmmrr 11 Názov účtu opačnej strany C(20) skrátený názov partnerskej organizácie 12 Zmena poloţky v K1 a K2 C(1) vţdy 0 - poloţka nie je nikdy menená 13 Druh údajov C(4) vţdy 1501 14 Dátum splatnosti C(6) valuta - value date ddmmrr 15 Kód banky C(7) kód banky opačnej strany I 16 Doplň. údaj k zahr. platbám C(40) mena, čiastka, kurz, poplatky Prima banky, J 17 Kód transakcie C(7) upresňujúci kód účtovnej transakcie K Poznámky: A. obsahuje 074 B. predčíslie sa v Prima banke nepouţíva je vyplnené nulami (napr. 0000001234567890, kde 000000 je predčíslie a 1234567890 je retailové číslo účtu klienta) C. dátum je vo formáte ddmmrr, dátum pre opening balance = closing balance predošlého dňa D. suma (v centoch) formátovaná na pravý okraj, bez desatinnej čiarky a oddeľovačov 4 / 8
E. obsahuje + v prípade kladného zostatku alebo - v prípade záporného zostatku F. znaky na zjednotenie dĺţky záznamu s poloţkou typu 75 G. obsahuje 075 H. vzťahuje sa len k údaju s poradovým číslom 2 (číslo účtu v Prima banke) 1 - poloţka debet 2 - poloţka kredit I. číselný kód banky opačnej strany (napr. 0200, 5600,...) (zarovnané doľava, sprava doplnené medzerami) J. a) pri zahraničnej transakcii obsahuje: menu, čiastku, kurz a poplatky pri zahraničnej platbe Popis: MMMCCCCCCCCCCCCCKKKKKKKKKKKKKPPPPPPPPPPP M - mena, v ktorej bola realizovaná platba - (3) C - čiastka v mene, v ktorej bola realizovaná platba - (13.2), pričom posledné 2 znaky sú stotiny danej čiastky (napr. suma 12.548,60 bude 0000001254860) K - kurz - (13.8) (napr. kurz 33,317 bude 0003331700000) P - poplatky Prima banky za realizáciu cezhraničného prevodného príkazu - (11.2), pričom posledné 2 znaky sú stotiny čiastky daného poplatku (napr. suma 158,60 EUR bude 00000015860) b) pri tuzemskej transakcii obsahuje: bližšie doplňujúce údaje K. číselník kódov: O-GE-CC Odoslaný tuzemský prevodný príkaz I-GE-CC Prijatý tuzemský prevodný príkaz GE-LE Úverové transakcie (splátka úveru, splátka úroku...) GE-TT Hotovostné vklady a výbery Z8-GEFE Paušálne mesačné poplatky - poplatok za vedenie účtu, SMS - debetné obraty, SMS - platby PK, SMS - kreditné obraty, sluţby ako internet banking, Mobile Banking, vedenie úver. účtu, osobné preberanie výpisu a pod.) TR-FEE Poplatky za transakcie (napr. hotovostné vklady a výbery, prevody) GE-AA Úverové poplatky a pod. (napr. poplatok za vypracovanie úverovej dokumentácie) GE-CE Poplatky za zmenárenské operácie a konverzie (zmenárenské operácie: predaj valút, nákup valút), konverzie (výmena valút CM za inú CM) GE-DL Transakcie z treasury obchodov GE-FT Platba do/zo zahraničia GE-IC Systémové transakcie, úroky (pripisovanie CR kreditných úrokov a inkaso DR debetných úrokov, úprava úrokov, inkaso zráţkovej dane a pod.) GE-SF Poplatky (výpisy zasielané poštou a pod.) GE-SP Sweep transakcie (nulovanie účtu = prevod zostatku účtu na iný účet a pod.) GE-GPI Generic posting interface bankové transakcie, poplatky(napr. za poskytnutie povoleného prečerpania na účte, nevyčerpané kontokorenty, prémie, opravy úročenia a pod.) 001001 až 999999 podobné ako GE-GPI - bankové účtovanie - číslovanie je rôzne - generované bankovým systémom 5 / 8
Štruktúra formátu domácich platobných príkazov Štruktúra súboru určeného na import do sluţieb internet banking a homebanking Prima banky. Názov súboru je ľubovolný, ale importované súbory by nemali mať rovnaký názov. Príkazy sa zadajú v ASCII súbore s ďalej uvedenou pevnou štruktúrou záznamov. Od-do Formát Obsah 1-6 N(6.0) Poradové číslo záznamu 7-8 N(2.0) Typ záznamu pre clearing (11 - domáci ) 9-14 D(6) Dátum vytvorenia záznamu v tvare rrmmdd 15-21 C(7) Identifikátor debetnej banky 22-28 C(7) Identifikátor kreditnej banky 29-43 N(15.2) Čiastka 44-49 D(6) Dátum splatnosti v tvare rrmmdd 50-59 N(10.0) Konštantný symbol 60-69 N(10.0) Variabilný symbol 70-79 N(10.0) Špecifický symbol 80-85 N(6.0) Prefix debetného účtu 86-95 N(10.0) Debetný účet 96-101 N(6.0) Prefix kreditného účtu 102-111 N(10.0) Kreditný účet 112-181 C(70) Kreditná identifikácia (informácie) 182-251 A(70) Kreditná identifikácia (informácie), pokračovanie 252-271 A(20) Názov účtu odosielateľa 272-291 A(20) Názov účtu príjemcu 292-301 N(10.0) Debetný variabilný symbol 302-311 N(10.0) Debetný špecifický symbol 312-451 A(140) Debetná informácia 452-591 A(140) Avízo Poznámka: Šedo označené polia predstavujú rozšírenú štruktúru, nie sú povinné. Poloţky typu N sú numerické znaky s vedúcimi nulami (bez oddeľovača desatinných miest - bodka, čiarka). Vysvetlenie poloţky typu N: N(15.2) - 15 numerických znakov (s vedúcimi nulami), pričom posledné dva znaky sú stotiny danej numerickej hodnoty. N(10.0) - 10 numerických znakov (s vedúcimi nulami), bez stotinných hodnôt. Príklad poloţky typu N: Suma 10,50 EUR je zapísaná v tvare: 000000000001050. Poloţky typu D sú dátumy v tvare RRMMDD (RR = rok, MM = mesiac, DD = deň). Poloţky typu C sú znakové, iba znaky povolené clearingovým centrom NBS, t.j. písmená veľké i malé vrátane diakritiky, číslice, medzery a nasledujúcich špeciálnych znakov:! #$%& ()*+,-./:; { }~ Identifikátory bánk sú buď štyri číslice a tri medzery, ide o numerický identifikátor, alebo je to alfanumerický kód v zozname bánk v Clearingovom centre. 6 / 8
Štruktúra formátu domácich inkasných príkazov Štruktúra súboru určeného na import do sluţieb internet banking a homebanking Prima banky. Názov súboru je ľubovolný, ale importované súbory by nemali mať rovnaký názov. Príkazy sa zadajú v ASCII súbore s ďalej uvedenou pevnou štruktúrou záznamov. Od-do Formát Obsah 1-6 N(6.0) Poradové číslo záznamu 7-8 N(2.0) Typ záznamu pre clearing (32 inkasný) 9-14 D(6) Dátum vytvorenia záznamu v tvare rrmmdd 15-21 C(7) Identifikátor kreditnej banky 22-28 C(7) Identifikátor debetnej banky 29-43 N(15.2) Čiastka 44-49 D(6) Dátum splatnosti v tvare rrmmdd 50-59 N(10.0) Konštantný symbol 60-69 N(10.0) Variabilný symbol 70-79 N(10.0) Špecifický symbol 80-85 N(6.0) Prefix kreditného účtu 86-95 N(10.0) Kreditný účet 96-101 N(6.0) Prefix debetného účtu 102-111 N(10.0) Debetný účet 112-181 C(70) Debetná identifikácia (informácie) Poloţky typu N sú numerické znaky s vedúcimi nulami (bez oddeľovača desatinných miest - bodka, čiarka). Vysvetlenie poloţky typu N: N(15.2) - 15 numerických znakov (s vedúcimi nulami), pričom posledné dva znaky sú stotiny danej numerickej hodnoty. N(10.0) - 10 numerických znakov (s vedúcimi nulami), bez stotinných hodnôt. Príklad poloţky typu N: Suma 10,50 EUR je zapísaná v tvare: 000000000001050. Poloţky typu D sú dátumy v tvare RRMMDD (RR = rok, MM = mesiac, DD = deň). Poloţky typu C sú znakové, iba znaky povolené clearingovým centrom NBS, t.j. písmená veľké i malé vrátane diakritiky, číslice, medzery a nasledujúcich špeciálnych znakov:!"#$%&'()*+,-./:;<=>{ }~ Identifikátory bánk sú buď štyri číslice a tri medzery, ide o numerický identifikátor, alebo je to alfanumerický kód v zozname bánk v Clearingovom centre. 7 / 8
Štruktúra formátu zahraničných prevodných príkazov Štruktúra súboru určeného na import do sluţieb internet banking a homebanking Prima banky. Názov súboru je ľubovolný, ale importované súbory by nemali mať rovnaký názov. Príkazy sa zadajú v ASCII súbore s ďalej uvedenou pevnou štruktúrou záznamov. Od-do Formát Obsah 1-3 C(3) "INT"- identifikátor zahraničného platobného príkazu 4-9 N(6.0) Poradové číslo záznamu 10-17 D(8) Dátum splatnosti (valuta) v tvare rrrrmmdd 18-52 C(35) Banka príjemcu 53-87 C(35) Adresa banky 88-122 C(35) Adresa banky 123-157 C(35) Adresa banky 158-192 C(35) Príjemca 193-227 C(35) Adresa príjemcu 228-262 C(35) Adresa príjemcu 263-297 C(35) Adresa príjemcu 298-313 N(16.2) Čiastka 314-316 C(3) Mena 317-326 N(10.0) Debetný účet 327-360 C(34) Kreditný účet 361-363 C(3) BEN, OUR alebo SHA platiteľ poplatkov 364-366 N(3.0) Platobný titul 367-368 C(2) Cieľová krajina 369-403 C(35) Kreditná identifikácia (informácie) 404-438 C(35) Kreditná identifikácia (informácie) 439-473 C(35) Kreditná identifikácia (informácie) 474-508 A(35) Kreditná identifikácia (informácie) 509-528 A(20) Názov účtu odosielateľa 529-530 A(2) Spôsob úhrady (priorita platby) 00 - normálna, 01 - prioritná 531-670 A(140) Správa pre banku 671-681 A(11) S.W.I.F.T. kód banky príjemcu Poloţky typu N sú numerické znaky s vedúcimi nulami. Pri poloţke čiastka je povolený ako oddeľovač stotín danej numerickej hodnoty znak ".". Vysvetlenie poloţky typu N: N(16.2) - 16 numerických znakov (s vedúcimi nulami), pričom posledné dva znaky sú stotiny danej numerickej hodnoty. N(10.0) - 10 numerických znakov (s vedúcimi nulami), bez stotinných hodnôt. Príklad poloţky typu N: Suma 10,50 EUR je zapísaná v tvare: 0000000000001050 Poloţky typu D sú dátumy v tvare RRRRMMDD (RRRR = rok, MM = mesiac, DD = deň). Poloţky typu C sú znakové a to iba veľké písmena bez diakritiky. 8 / 8