FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém internetového bankovnictví
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
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
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
Ú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:
[email protected] ).
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
FORMÁT SOUBORŮ Soubory s příkazy pro Citibank Europe plc, organizační složka 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é. Citibank Europe plc, organizační složka, ale nepožaduje, a také ani nekontroluje, nepřerušený vzestupný interval pořadových čísel souborů v rámci daného dne.
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
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 SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
FORMÁT TUZEMSKÝCH PLATEBNÍCH PŘÍKAZŮ Pole
Popis pole 1 2 3 4 5 6 7 8 9 10 11 12 13 1 2 3
1)
identifikátor transakce (1 pro LCY) pořadové číslo číslo debetního účtu naše reference datum splatnosti částka1) předčíslí čísla účtu číslo účtu příjemce kód banky konstantní symbol variabilní symbol specifický symbol zpráva pro příjemce Součtová věta identifikátor transakce (9 pro součtovou větu) pořadové číslo celková částka1)
Povinné Povinné Povinné Nepovinné Povinné Povinné Nepovinné Povinné Povinné Nepovinné Nepovinné Nepovinné Nepovinné
Formát číselný číselný číselný alfanumerický datum číselný číselný číselný číselný číselný číselný číselný alfanumerický
Maxim počet znaků. 1 3 10 10 8
Povinné Povinné Povinné
číselný číselný číselný
1 3
6 10 4 4 10 10 35
Tabulka povolených znaků 1 1 1 4 1 3 1 1 1 1 1 1 6 1 1 3
Částku uveďte vždy na dvě desetinná místa (např. 5000.00 nebo 500.45)
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
Poznámka
DDMMYYYY
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 SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
FORMÁT ZAHRANIČNÍCH PLATEBNÍCH PŘÍKAZŮ Pole
Popis pole 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 1 2 3 1) 2)
identifikátor transakce pořadové číslo číslo debetního účtu naše reference datum splatnosti částka1) kód měny číslo účtu příjemce jméno a adresa příjemce 1 jméno a adresa příjemce 2 jméno a adresa příjemce 3 jméno a adresa příjemce 4 banka příjemce 1 banka příjemce 2 banka příjemce 3 banka příjemce 4 detail platby 1 detail platby 2 detail platby 3 detail platby 4 poplatky kód avíza2) platební titul Součtová věta dentifikátor transakce (9 pro součtovou větu) pořadové číslo celková částka1)
Povinné Povinné Povinné Nepovinné Povinné Povinné Povinné Povinné Povinné Nepovinné Nepovinné Nepovinné Povinné Nepovinné Nepovinné Nepovinné Nepovinné Nepovinné Nepovinné Nepovinné Povinné Nepovinné Povinné
Formát číselný číselný číselný alfanumerický datum číselný Letters SWIFT SWIFT SWIFT SWIFT SWIFT SWIFT SWIFT SWIFT SWIFT SWIFT SWIFT SWIFT SWIFT Text alfanumerický alfanumerický
Maxim počet znaků. 1 3 10 10 8 3 3 35 35 35 35 35 35 35 35 35 35 35 35
Tabulka povolených znaků 1 1 1 4 1 3 5 6 6 6 6 6 6 6 6 6 6 6 6 6
3 1 7
5 1 7
Povinné Povinné Povinné
číselný číselný číselný
1 3
1 1 3
Částku uveďte vždy na dvě desetinná místa (např. 5000.00 nebo 500.45) 1 – bez aviza, 2 – telefonem, 3 – dálnopisem
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
Poznámka
DDMMYYYY
SHA/BEN/OUR
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
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
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
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
VSTUPNÍ KONTROLY ZÁZNAMŮ JEDNOTLIVÝCH POLÍ PROVÁDĚNÉ NA STRANĚ Citibank Europe plc, organizační složka 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) ______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007
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
______________________________________________________________________________________ FORMÁT SOUBORŮ S PLATEBNÍMI PŘÍKAZY PRO Citibank Europe plc, organizační složka Systém Internetové Bankovnictví Verze Prosinec 2007