FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Systém internetového bankovnictví
OBSAH ÚVOD 3 FORMÁT SOUBORŮ. 4 FORMÁT TUZEMSKÝCH PLATEBNÍCH PŘÍKAZŮ... 6 FORMÁT ZAHRANIČNÍCH PLATEBNÍCH PŘÍKAZŮ.... 8 TABULKY POVOLENÝCH ZNAKŮ 10 VSTUPNÍ KONTROLY ZÁZNAMŮ JEDNOTLIVÝCH POLÍ PROVÁDĚNÉ NA STRANĚ Citibank Europe plc, organizační složka... 11
ÚVOD Vážený uživateli Internetového Bankovnictví (IB), právě se Vám dostává do rukou poslední verze IB umožňující rychlou a operativní komunikaci mezi Vámi a Citibank Europe plc, organizační složka. Mezi nejdůležitější způsob této komunikace patří bezesporu převod dat z Vašeho účetnictví formou souborů tuzemských nebo zahraničních platebních příkazů. Na následujících stránkách naleznete podrobný popis těchto datových souborů. Současně s tímto dokumentem je vhodné se seznámit s manuálem pro používání IB. Zde najdete mmj. návod k zasílání těchto souborů do Citibank Europe plc, organizační složka, a také vzor obrazovek s informacemi o stavu zpracování celých souborů a jednotlivých transakcí bankou. V případě jakýchkoli nejasností či dotazů kontaktujte oddělení Podpory el.bankovnictví na telefonním čísle +420 233 061 818 (e-mail: tbs.helpdesk@citi.com ).
FORMÁT SOUBORŮ Soubory s příkazy pro zpracovávané pomocí systému Internetového Bankovnictví (IB) jsou vytvořeny jako ASCII comma delimited (jednotlivá pole oddělená čárkami). Všechna pole, kromě identifikátoru transakce a částky, jsou navíc ohraničena uvozovkami. Každý příkaz tvoří jeden záznam (záznamová věta) v souboru. Jako poslední věta každého souboru je uvedena součtová věta. Maximální počet příkazů v jednom souboru je 999. Každý soubor může obsahovat pouze jeden druh příkazu z následujících dvou možností: - tuzemský platební příkaz - zahraniční platební příkaz TTT-XXXXXXXXXX-YYYYMMDD-SSS.txt TTT - je LCY - pro tuzemské platební příkazy FCY - pro zahraniční platební příkazy XXXXXXXXXX 10 znaků Vašeho čísla účtu YYYYMMDD datum vytvoření souboru ve tvaru yyyymmdd SSS pořadové číslo souboru v rámci datumu vytvoření Txt standartní přípona pro textové soubory Datum vytvoření souboru a pořadové číslo souboru tvoří klíč pro vyloučení duplicitních názvů souborů. To znamená, že pořadové číslo souboru v rámci datumu vytvoření musí být jednoznačné., ale nepožaduje, a také ani nekontroluje, nepřerušený vzestupný interval pořadových čísel souborů v rámci daného dne.
Příklady názvů souborů LCY-2599950318-20040802-001.txt - soubor vytvořený 2. srpna 2004 obsahuje tuzemské platební příkazy pro číslo účtu 2599950318. Jde o první soubor ze dne 2. srpna 2004 FCY-2599950406-20040812-005.txt - soubor vytvořený 12. srpna 2004 obsahuje zahraniční platební příkazy pro číslo účtu 2599950406. Jde o pátý soubor ze dne 12. srpna 2004
FORMÁT TUZEMSKÝCH PLATEBNÍCH PŘÍKAZŮ Pole Popis pole Formát Maxim počet znaků. Tabulka povolených znaků Poznámka 1 identifikátor transakce (1 pro LCY) Povinné číselný 1 1 2 pořadové číslo Povinné číselný 3 1 3 číslo debetního účtu Povinné číselný 10 1 4 naše reference Nepovinné alfanumerický 10 4 5 datum splatnosti Povinné datum 8 1 DDMMYYYY 6 částka 1) Povinné číselný 3 7 předčíslí čísla účtu Nepovinné číselný 6 1 8 číslo účtu příjemce Povinné číselný 10 1 9 kód banky Povinné číselný 4 1 10 konstantní symbol Nepovinné číselný 4 1 11 variabilní symbol Nepovinné číselný 10 1 12 specifický symbol Nepovinné číselný 10 1 13 zpráva pro příjemce Nepovinné alfanumerický 35 6 Součtová věta 1 identifikátor transakce (9 pro součtovou větu) Povinné číselný 1 1 2 pořadové číslo Povinné číselný 3 1 3 celková částka 1) Povinné číselný 3 1) Částku uveďte vždy na dvě desetinná místa (např. 5000.00 nebo 500.45)
Příklad importního souboru tuzemských platebních příkazů 1,"001","2501234567","2040000765","29112004",30000.00,"","2671500267","0100","0008","0020040676","","KRIZ LADISLAV" 1,"002","2501234567","2040000981","29112004",50000.00,"","0420923389","0800","0008","0002004129","","BRUNI CARLA" 1,"003","2501234567","2040000607","29112004",112368.50,"","0650445271","0100","0008","1000004564","","NOVAK JAN" 1,"004","2501234567","2340000889","29112004",13242.00,"","0047443191","0100","0308","0000013304","","DODAVATEL" 1,"005","2501234567","2440000201","29112004",46707.50,"","2500020103","2600","0308","0111067504","","SPOJE " 1,"006","2501234567","2340001009","29112004",11662.00,"","9391320247","0100","0308","0000131991","","KOMUNIKACE" 1,"007","2501234567","2340001020","29112004",3145.17,"","9391320247","0100","0308","0000132449","","KOMUNIKACE" 1,"008","2501234567","2340001030","29112004",2380.00,"","9391320247","0100","0308","0000132389","","KOMUNIKACE" 1,"009","2501234567","2340000988","29112004",2981.00,"","0391742561","0100","0308","0000533804","","VYLISKY" 9,"010",272486.17
FORMÁT ZAHRANIČNÍCH PLATEBNÍCH PŘÍKAZŮ Pole Popis pole Formát Maxim počet znaků. Tabulka povolených znaků Poznámka 1 identifikátor transakce Povinné číselný 1 1 2 pořadové číslo Povinné číselný 3 1 3 číslo debetního účtu Povinné číselný 10 1 4 naše reference Nepovinné alfanumerický 10 4 5 datum splatnosti Povinné datum 8 1 DDMMYYYY 6 částka 1) Povinné číselný 3 7 kód měny Povinné Letters 3 5 8 číslo účtu příjemce Povinné SWIFT 3 6 9 jméno a adresa příjemce 1 Povinné SWIFT 35 6 10 jméno a adresa příjemce 2 Nepovinné SWIFT 35 6 11 jméno a adresa příjemce 3 Nepovinné SWIFT 35 6 12 jméno a adresa příjemce 4 Nepovinné SWIFT 35 6 13 banka příjemce 1 Povinné SWIFT 35 6 14 banka příjemce 2 Nepovinné SWIFT 35 6 15 banka příjemce 3 Nepovinné SWIFT 35 6 16 banka příjemce 4 Nepovinné SWIFT 35 6 17 detail platby 1 Nepovinné SWIFT 35 6 18 detail platby 2 Nepovinné SWIFT 35 6 19 detail platby 3 Nepovinné SWIFT 35 6 20 detail platby 4 Nepovinné SWIFT 35 6 21 poplatky Povinné Text 3 5 SHA/BEN/OUR 22 kód avíza 2) Nepovinné alfanumerický 1 1 23 platební titul Povinné alfanumerický 7 7 Součtová věta 1 dentifikátor transakce (9 pro součtovou větu) Povinné číselný 1 1 2 pořadové číslo Povinné číselný 3 1 3 celková částka 1) Povinné číselný 3 1) Částku uveďte vždy na dvě desetinná místa (např. 5000.00 nebo 500.45) 2) 1 bez aviza, 2 telefonem, 3 dálnopisem
Příklad importního souboru zahraničních platebních příkazů 3,"001","2501234576","","09112004",1930.00,"EUR","LONG","994404-940233015/0800","SPOLECNOST","ULICE 1","MESTO","CESKA SPORITELNA","MESTO","","","40304009","","","","OUR","1","122RCZ5" 3,"002","2501234576","","09112004",1354.00,"EUR","1014030387/5500","SPOLECNOST","ULICE 2","MESTO","","RAIFFEISENBANK", "MESTO","","","30204009","","","","OUR","1","122RCZ5" 3,"003","2501234576","","09112004",2547.00,"EUR","1014030387/5500","SPOLECNOST","ULICE 3","MESTO","","RAIFFEISENBANK A.S.","MESTO","","","20204009","","","","OUR","1","122RCZ5" 3,"004","2501234576","","09112004",71.00,"EUR","1920810/2700","LEASINGOVA SPOL.","NAMESTI 1","PRAHA","","HVB BANK CZECH REPUBLIC", "PRAHA","","","1102168600","","","","OUR","1","122RCZ5" 3,"005","2501234576","","09112004",3620.00,"EUR","1920810/2700","LEASINGOVA SPOL.","NAMESTI 1,"PRAHA,"","HVB BANK CZECH REPUBLIC", "PRAHA","","","1102168327","","","","OUR","1","122RCZ5" 9,"006",9522.00
TABULKY POVOLENÝCH ZNAKŮ Tabulka č. 1 - pouze číslice (0-9) Tabulka č. 2 - číslice a abeceda (0-9, a - z, A - Z) bez znaků české diakritiky Tabulka č. 3 - číslice a desetinná tečka Tabulka č. 4 - číslice (0-9), abeceda (a - z, A - Z) bez znaků české diakritiky Tabulka č. 5 - pouze abeceda, velká písmena (A - Z) bez znaků české diakritiky Tabulka č. 6 - povolené znaky pro SWIFT: ABCDEFGHIJKLMNOPQRSTUVWXYZ.0123456789?-()+:/ <mezera> bez znaků české diakritiky Tabulka č. 7 - číslice (0-9), velká písmena (A - Z) bez znaků české diakritiky
VSTUPNÍ KONTROLY ZÁZNAMŮ JEDNOTLIVÝCH POLÍ PROVÁDĚNÉ NA STRANĚ Kontroly prováděné na datech souboru jsou dvojího druhu: 1. Formátové kontroly Veškeré chyby při kontrole formátu způsobí, že celý vstupní soubor je jako celek vyřazen ze zpracování. Jednotlivé formátové kontroly jsou: 1.1 Jednoznačné jméno souboru 1.2 Soubor obsahuje data pro daný typ položky 1.3 Vstupní posloupnost pořadových čísel příkazů v souboru je nepřerušená 1.4 Všechna povinná pole jsou uvedena 1.5 Všechna uvedená pole nepřesahují maximální délku pole 1.6 Kontrola debetního/kreditního čísla účtu proti číslu Citicard karty 1.7 Údaj v poslední součtové větě (součet částek za všechny příkazy souboru) odpovídá vypočtené hodnotě 1.8 Kontrola rozdělení souboru na jednotlivé záznamy a jednotlivá pole Kontrola maximálního počtu položek v souboru 2. Logické kontroly Chyby zjištěné na úrovni logické kontroly vyřadí ze zpracování pouze daný příkaz. Jednotlivé logické kontroly jsou: 2.1 Kontrola modulo 11 u tuzemského čísla účtu (předčíslí a základní číslo účtu) 2.2 Platný číselný kód banky (tuzemské platební a inkasní příkazy)
2.3 Datum splatnosti musí být logicky správné a musí být - pro tuzemský, zahraniční platební a inkasní příkaz stejné nebo vyšší (max.o 21dní) než datum běžného dne 2.4 Částka příkazu musí být vyšší než nula (pozor - oddělovač desetinných míst je tečka) 2.5 Všechna pole musí obsahovat pouze povolené znaky z tabulek povolených znaků 2.6 Částka příkazu musí být nižší nebo rovná momentálnímu stavu na účtě 2.7 Číslo účtu plátce nesmí být stejné jako číslo účtu příjemce 2.8 Platný SWIFT kód měny u zahraniční platby