ABO štruktúra in/out súborov pre službu internet banking

Transkript

1 ABO štruktúra in/out súborov pre službu internet banking Prima banka Slovensko, a.s. (ďalej Prima banka ) Špecifikácia

2 Ú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

3 Ú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 ovú adresu, Heslo pre zakódovanie u.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 ovú 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

4 Š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) 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 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 , kde je predčíslie a 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

5 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 ,60 bude ) K - kurz - (13.8) (napr. kurz 33,317 bude ) 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 ) 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.) až podobné ako GE-GPI - bankové účtovanie - číslovanie je rôzne - generované bankovým systémom 5 / 8

6 Š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 C(7) Identifikátor debetnej banky C(7) Identifikátor kreditnej banky N(15.2) Čiastka D(6) Dátum splatnosti v tvare rrmmdd N(10.0) Konštantný symbol N(10.0) Variabilný symbol N(10.0) Špecifický symbol N(6.0) Prefix debetného účtu N(10.0) Debetný účet N(6.0) Prefix kreditného účtu N(10.0) Kreditný účet C(70) Kreditná identifikácia (informácie) A(70) Kreditná identifikácia (informácie), pokračovanie A(20) Názov účtu odosielateľa A(20) Názov účtu príjemcu N(10.0) Debetný variabilný symbol N(10.0) Debetný špecifický symbol A(140) Debetná informácia 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: 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

7 Š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 C(7) Identifikátor kreditnej banky C(7) Identifikátor debetnej banky N(15.2) Čiastka D(6) Dátum splatnosti v tvare rrmmdd N(10.0) Konštantný symbol N(10.0) Variabilný symbol N(10.0) Špecifický symbol N(6.0) Prefix kreditného účtu N(10.0) Kreditný účet N(6.0) Prefix debetného účtu N(10.0) Debetný účet 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: 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

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 D(8) Dátum splatnosti (valuta) v tvare rrrrmmdd C(35) Banka príjemcu C(35) Adresa banky C(35) Adresa banky C(35) Adresa banky C(35) Príjemca C(35) Adresa príjemcu C(35) Adresa príjemcu C(35) Adresa príjemcu N(16.2) Čiastka C(3) Mena N(10.0) Debetný účet C(34) Kreditný účet C(3) BEN, OUR alebo SHA platiteľ poplatkov N(3.0) Platobný titul C(2) Cieľová krajina C(35) Kreditná identifikácia (informácie) C(35) Kreditná identifikácia (informácie) C(35) Kreditná identifikácia (informácie) A(35) Kreditná identifikácia (informácie) A(20) Názov účtu odosielateľa A(2) Spôsob úhrady (priorita platby) 00 - normálna, 01 - prioritná A(140) Správa pre banku 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: 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