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:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Názov poľa Typ záznamu Číslo klienta Názov organizácie Dátum starého zostatku Starý zostatok Znamienko starého zostatku Nový zostatok Znamienko nového zostatku Obraty debet Znamienko obratov debet Obraty kredit Znamienko obratov kredit Poradové číslo výpisu Dátum účtovania Znaky medzera
Typ C(3) C(16) C(20) C(6) C(14) C(1) C(14) C(1) C(14) C(1) C(14) C(1) C(3) C(6) C(61)
Hodnota: Hlavička súboru predčíslie + retailové číslo klienta Prima banky názov účtu klienta Prima banky opening balance z daného dňa podľa opening balance ‘+‘, ‘-‘ closing balance podľa closing balance ‘+‘,‘-‘ suma DR obratov z predošlého dňa vţdy ‘0‘ suma CR obratov z predošlého dňa vţdy ‘0‘ poradové číslo papierového výpisu klienta valuta ddmmrr
Pozn. A B C D E D E D D
F
položka typu 75 ( detail ) - obsahuje identifikáciu jednotlivých platieb pre daného klienta. V podmienkach Prima banky to je:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
Názov poľa Typ záznamu Účet príjemcu ABO výpisu Číslo účtu Číslo dokladu Čiastka Kód účtovania Variabilný symbol Konštantný symbol Špecifický symbol Valuta Názov účtu opačnej strany Zmena poloţky v K1 a K2 Druh údajov Dátum splatnosti Kód banky Doplň. údaj k zahr. platbám Kód transakcie
Typ C(3) C(16) C(16) C(13) C(12) C(1) C(10) C(10) C(10) C(6) C(20) C(1) C(4) C(6) C(7) C(40) C(7)
Hodnota: 075 - detail platby číslo účtu v Prima banke číslo účtu protistrany číslo dokladu, len pre clearingové platby hodnoty 1, 2 ( 1 - má dať, 2 - dal ) VS ak existuje pre daný typ transakcie KS ak existuje pre daný typ transakcie SS ak existuje pre daný typ transakcie valuta - value date ddmmrr skrátený názov partnerskej organizácie vţdy 0 - poloţka nie je nikdy menená vţdy 1501 valuta - value date ddmmrr kód banky opačnej strany mena, čiastka, kurz, poplatky Prima banky, upresňujúci kód účtovnej transakcie
Pozn. G B
D H
I J 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 I-GE-CC GE-LE GE-TT Z8-GEFE
TR-FEE GE-AA GE-CE GE-DL GE-FT GE-IC GE-SF GE-SP GE-GPI 001001 až 999999
Odoslaný tuzemský prevodný príkaz Prijatý tuzemský prevodný príkaz Úverové transakcie (splátka úveru, splátka úroku ...) Hotovostné vklady a výbery 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.) Poplatky za transakcie (napr. hotovostné vklady a výbery, prevody) Úverové poplatky a pod. (napr. poplatok za vypracovanie úverovej dokumentácie) 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) Transakcie z treasury obchodov Platba do/zo zahraničia Systémové transakcie, úroky (pripisovanie CR – kreditných úrokov a inkaso DR – debetných úrokov, úprava úrokov, inkaso zráţkovej dane a pod.) Poplatky (výpisy zasielané poštou a pod.) Sweep transakcie (nulovanie účtu = prevod zostatku účtu na iný účet a pod.) 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.) 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 1-6 7-8 9-14 15-21 22-28 29-43 44-49 50-59 60-69 70-79 80-85 86-95 96-101 102-111 112-181 182-251 252-271 272-291 292-301 302-311 312-451 452-591
Formát N(6.0) N(2.0) D(6) C(7) C(7) N(15.2) D(6) N(10.0) N(10.0) N(10.0) N(6.0) N(10.0) N(6.0) N(10.0) C(70) A(70) A(20) A(20) N(10.0) N(10.0) A(140) A(140)
Obsah Poradové číslo záznamu Typ záznamu pre clearing (11 - domáci ) Dátum vytvorenia záznamu v tvare rrmmdd Identifikátor debetnej banky Identifikátor kreditnej banky Čiastka Dátum splatnosti v tvare rrmmdd Konštantný symbol Variabilný symbol Špecifický symbol Prefix debetného účtu Debetný účet Prefix kreditného účtu Kreditný účet Kreditná identifikácia (informácie) Kreditná identifikácia (informácie), pokračovanie Názov účtu odosielateľa Názov účtu príjemcu Debetný variabilný symbol Debetný špecifický symbol Debetná informácia 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 1-6 7-8 9-14 15-21 22-28 29-43 44-49 50-59 60-69 70-79 80-85 86-95 96-101 102-111 112-181
Formát N(6.0) N(2.0) D(6) C(7) C(7) N(15.2) D(6) N(10.0) N(10.0) N(10.0) N(6.0) N(10.0) N(6.0) N(10.0) C(70)
Obsah Poradové číslo záznamu Typ záznamu pre clearing (32 – inkasný) Dátum vytvorenia záznamu v tvare rrmmdd Identifikátor kreditnej banky Identifikátor debetnej banky Čiastka Dátum splatnosti v tvare rrmmdd Konštantný symbol Variabilný symbol Špecifický symbol Prefix kreditného účtu Kreditný účet Prefix debetného účtu Debetný účet 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 1-3 4-9 10-17 18-52 53-87 88-122 123-157 158-192 193-227 228-262 263-297 298-313 314-316 317-326 327-360 361-363 364-366 367-368 369-403 404-438 439-473 474-508 509-528 529-530
Formát C(3) N(6.0) D(8) C(35) C(35) C(35) C(35) C(35) C(35) C(35) C(35) N(16.2) C(3) N(10.0) C(34) C(3) N(3.0) C(2) C(35) C(35) C(35) A(35) A(20) A(2)
531-670 671-681
A(140) A(11)
Obsah "INT"- identifikátor zahraničného platobného príkazu Poradové číslo záznamu Dátum splatnosti (valuta) v tvare rrrrmmdd Banka príjemcu Adresa banky Adresa banky Adresa banky Príjemca Adresa príjemcu Adresa príjemcu Adresa príjemcu Čiastka Mena Debetný účet Kreditný účet BEN, OUR alebo SHA platiteľ poplatkov Platobný titul Cieľová krajina Kreditná identifikácia (informácie) Kreditná identifikácia (informácie) Kreditná identifikácia (informácie) Kreditná identifikácia (informácie) Názov účtu odosielateľa Spôsob úhrady (priorita platby) 00 - normálna, 01 - prioritná Správa pre banku 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
