FORMÁTY SOUBORŮ PRO IMPORT A EXPORT DAT PRO SLUŽBU HOMEBANKING PPF banky a.s. Obsah: I. Import dat Dávka... 2 A. Gemini 4.1 formát... 2 1. Struktura souboru pro Tuzemské hromadné příkazy... 2 2. Struktura souboru pro Tuzemské hromadné příkazy k inkasu... 3 3. Struktura souboru pro Vnitrobankovní cizoměnové hromadné příkazy... 4 4. Struktura souboru pro Zahraniční hromadné příkazy... 6 B. ABO formát struktura souboru pro Tuzemské hromadné příkazy a Tuzemské hromadné příkazy k inkasu... 7 1. Popis záznamu UHL1... 8 2. Popis hlavičky a konce účetního souboru... 8 3. Popis hlavičky a konce skupiny položek... 8 4. Popis účetní položky... 9 5. Příklad souboru v ABO formátu... 10 II. Export dat transakční historie a dnešní obraty... 11 A. CSV formát... 11 B. XML formát pro Gemini 5... 12 1. Formát oficiálního výpisu... 12 2. Formát vlastního výběru položek... 17 C. ABO formát export údajů o tuzemských Platebních transakcích... 20 1. Popis záznamu Výpis z účtu... 20 2. Popis záznamu Platební transakce v CZK... 21 3. Popis záznamu Podpole AV1 AV2... 22 4. Popis záznamu Podpole AV3 AV4... 22 5. Příklad souboru v ABO formátu... 22 D. Formát Gemini... 22 1. Formát Gemini 4.1... 22 2. Formát Gemini 5... 25 E. HTML formát... 27 Verse: 01032013 Strana 1 (celkem 29)
I. Import dat Dávka Formáty souborů pro import a export dat pro službu Homebanking PPF banky a.s. Pro Dávky (tj. import hromadných Platebních příkazů) je možné použít dva formáty souborů: a) Gemini 4.1 formát, nebo b) ABO formát. Importované soubory mohou obsahovat pouze alfanumerické znaky, jiné znaky pouze v případě, že jsou v popisu formátu výslovně uvedené. A. Gemini 4.1 formát Specifikace formátu Gemini 4.1: Textový soubor, Formát ASCII Pevná délka pozic jednotlivých záznamů Jeden řádek = jeden Platební příkaz Řádky jsou odděleny znakem CR/LF Pole se standardně zarovnávají doprava (včetně pole pro uvedení BIC), výjimku tvoří texty typu zpráva pro příjemce, informace pro banku atd., která se zarovnávají doleva. Legenda: digits: lz: decpt: opt: pouze čísla nuly doplněné zleva jsou povinné pro oddělení desetinných míst musí být v záznamu použita desetinná tečka/čárka nepovinný údaj, může zůstat vyplněný mezerami, nebo prázdný, pokud je na konci řádku 1. Struktura souboru pro Tuzemské hromadné příkazy!!! POZOR!!! V Tuzemském hromadném příkazu lze zadat pouze znaky, které jsou povolené v systému CERTIS: a b c d e f g h i j k l m n o p q r s t u v w x y z á ä č ď é ě í ľ ň ó ô ö ř ŕ š ť ú ů ü ý ž A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Á Ä Č Ď É Ě Í Ľ Ň Ó Ô Ö Ř Ŕ Š Ť Ú Ů Ü Ý Ž 0 1 2 3 4 5 6 7 8 9 / -? : ( )., ' +! " # $ % & * ; < = > @ [ \ ] ^ ` { } ~ mezera Pokud budou v importovaném souboru zadány jiné znaky, jednotlivé položky z Dávky mohou být po nahrání do HB nebo po předání do ČNB odmítnuty z důvodu formálních chyb. Pozice Délka Formát Popis pole 1 6 digits, lz, opt Pořadové číslo řádku 7 2 11, opt Typ zprávy uveďte vždy hodnotu 11 9 6 YYMMDD, opt, Datum vytvoření souboru pokud je uvedeno, musí být shodné pro digits všechny položky v souboru 15 4 digits, lz Kód Banky uveďte vždy hodnotu 6000 19 3 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 3 mezery 22 4 digits, lz Kód banky Příjemce 26 3 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 3 mezery 29 15 digits Částka v CZK, desetinná místa se neoddělují čárkou a musí být 44 6 YYMMDD, opt, digits 50 10 digits, lz Konstantní symbol 60 10 digits, lz Variabilní symbol kreditní 70 10 digits, lz Specifický symbol kreditní 80 6 digits, lz, opt vždy uvedena Datum splatnosti Jednotlivé položky v jedné Dávce mohou mít různá Data splatnosti. Pokud jsou v Dávce položky s Datem splatnosti v minulosti nebo Datum splatnosti chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP. Předčíslí vlastního účtu (účet Plátce) pokud nebude uvedeno, musí být účet vybrán při importu souboru do HB Verse: 01032013 Strana 2 (celkem 29)
Pozice Délka Formát Popis pole 86 10 digits, lz, opt Číslo vlastního účtu (účet Plátce) pokud nebude uvedeno, musí být účet vybrán při importu souboru do HB 96 6 digits, lz Předčíslí účtu Příjemce 102 10 digits, lz Číslo účtu Příjemce 112 140 opt Zpráva pro Příjemce volný text. Zde můžete zadat popis pro potřebu Příjemce ve výpisu Plátce se tato informace nezobrazí. 252 20 opt Název vlastního účtu (účet Plátce) 272 20 opt Název účtu Příjemce 292 10 digits, lz, opt Variabilní symbol debetní uveďte pouze v případě, že se liší od pole Variabilní symbol kreditní 302 10 digits, lz, opt Specifický symbol debetní uveďte pouze v případě, že se liší od pole Specifický symbol kreditní 312 140 opt Zpráva pro Plátce volný text. Zde si můžete zadat popis položky Tuzemského hromadného příkazu pro svoji potřebu zobrazí se ve výpisu z účtu Plátce, Příjemci se nezobrazí. Příklad (tečky v textu vyznačují mezery): 000001111208026000 6000 000000000015918 000000030800007802830000050000 285973123900000040 86318984fa 261/05 000002111208026000 6000 000000000244930 000000030800007802830000060000 285973123900000040 86318984fa 262/05 000003111208026000 6000 000000000634600 000000000830800000991380000000 285973123900000040 86318984fa 171/05 000004111208026000 6000 000000000634600 000000000830800000991380000000 2859731239000000408 6318984fa 172/05 2. Struktura souboru pro Tuzemské hromadné příkazy k inkasu!!! POZOR!!! V Tuzemském hromadném příkazu k inkasu lze zadat pouze znaky, které jsou povolené v systému CERTIS: a b c d e f g h i j k l m n o p q r s t u v w x y z á ä č ď é ě í ľ ň ó ô ö ř ŕ š ť ú ů ü ý ž A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Á Ä Č Ď É Ě Í Ľ Ň Ó Ô Ö Ř Ŕ Š Ť Ú Ů Ü Ý Ž 0 1 2 3 4 5 6 7 8 9 / -? : ( )., ' +! " # $ % & * ; < = > @ [ \ ] ^ ` { } ~ mezera Pokud budou v importovaném souboru zadány jiné znaky, jednotlivé položky z Dávky mohou být po nahrání do IB nebo po předání do ČNB odmítnuty z důvodu formálních chyb. Pozice Délka Formát Popis pole 1 6 digits, lz, opt Pořadové číslo řádku 7 2 32, opt Typ zprávy uveďte vždy hodnotu 32 9 6 YYMMDD, opt, Datum vytvoření souboru pokud je uvedeno, musí být shodné pro digits všechny položky v souboru 15 4 digits, lz Kód Banky uveďte vždy hodnotu 6000 19 3 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 3 mezery 22 4 digits, lz Kód banky Plátce 26 3 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 3 mezery 29 15 digits Částka v CZK, desetinná místa se neoddělují čárkou a musí být vždy uvedena Verse: 01032013 Strana 3 (celkem 29)
Pozice Délka Formát Popis pole 44 6 YYMMDD, opt, digits 50 10 digits, lz Konstantní symbol 60 10 digits, lz Variabilní symbol debetní 70 10 digits, lz Specifický symbol debetní 80 6 digits, lz, opt 86 10 digits, lz, opt Datum splatnosti datum, ke kterému má být odepsána (inkasována) platba z účtu Plátce. Jednotlivé položky v jedné Dávce mohou mít různá Data splatnosti. Pokud jsou v Dávce položky s Datem splatnosti v minulosti nebo Datum splatnosti chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP. Předčíslí vlastního účtu (účet Příjemce) pokud nebude uvedeno, musí být účet vybrán při importu souboru do HB Číslo vlastního účtu (účet Příjemce) pokud nebude uvedeno, musí být účet vybrán při importu souboru do HB 96 6 digits, lz Předčíslí účtu Plátce (inkasovaného účtu) 102 10 digits, lz Číslo účtu Plátce (inkasovaného účtu) 112 140 opt Zpráva pro Plátce volný text. Zde můžete zadat popis pro potřebu Plátce ve výpisu Příjemce se tato informace nezobrazí. 252 20 opt Název vlastního účtu (účet Příjemce) 272 20 opt Název účtu Plátce (inkasovaného účtu) 292 10 digits, lz, opt Variabilní symbol kreditní uveďte pouze v případě, že se liší od pole Variabilní symbol debetní 302 10 digits, lz, opt Specifický symbol kreditní uveďte pouze v případě, že se liší od pole Specifický symbol debetní 312 140 opt Zpráva pro Příjemce volný text. Zde si můžete zadat popis položky Tuzemského hromadného příkazu k inkasu pro svoji potřebu zobrazí se ve výpisu z účtu Příjemce, Plátci se nezobrazí. Příklad (tečky v textu vyznačují mezery): 000001321208026000 6000 000000000015918 000000030800007802830000050000 285973123900000040 86318984fa 261/05 000002321208026000 6000 000000000244930 000000030800007802830000060000 285973123900000040 86318984fa 262/05 000003321208026000 6000 000000000634600 000000000830800000991380000000 285973123900000040 86318984fa 171/05 000004321208026000 6000 000000000634600 000000000830800000991380000000 2859731239000000408 6318984fa 172/05 3. Struktura souboru pro Vnitrobankovní cizoměnové hromadné příkazy!!! POZOR!!! Ve Vnitrobankovním cizoměnovém hromadném příkazu lze zadat pouze znaky, které jsou povolené v systému CERTIS: a b c d e f g h i j k l m n o p q r s t u v w x y z á ä č ď é ě í ľ ň ó ô ö ř ŕ š ť ú ů ü ý ž A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Á Ä Č Ď É Ě Í Ľ Ň Ó Ô Ö Ř Ŕ Š Ť Ú Ů Ü Ý Ž 0 1 2 3 4 5 6 7 8 9 / -? : ( )., ' +! " # $ % & * ; < = > @ [ \ ] ^ ` { } ~ mezera Pokud budou v importovaném souboru zadány jiné znaky, jednotlivé položky z Dávky budou po nahrání do HB odmítnuty z důvodu formálních chyb. Verse: 01032013 Strana 4 (celkem 29)
Pozice Délka Formát Popis pole 1 3 INT, opt Uveďte vždy hodnotu INT označující zahraniční platbu 4 6 digits, lz, opt Pořadové číslo řádku 10 8 YYYYMMDD, Datum vytvoření souboru pokud je uvedeno, musí být shodné pro opt, digits všechny položky v souboru 18 140 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 140 mezer 158 35 Název účtu Příjemce 193 105 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 105 mezer 298 16 digits, lz, decpt Částka platby pokud obsahuje desetinná místa, je nutné je oddělit desetinnou čárkou nebo tečkou 314 3 Měna ISO kód 317 10 digits, lz Číslo vlastního účtu (účet Plátce) 327 34 Číslo účtu Příjemce může být uvedeno v národním formátu nebo ve formátu IBAN. 361 3 OUR Označení typu poplatků uveďte vždy OUR (poplatek za Vnitrobankovní cizoměnový příkaz hradí vždy Plátce). 364 5 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 5 mezer 369 140 opt Zpráva pro Příjemce volný text. Zde můžete zadat popis pro potřebu Příjemce. 509 20 opt Název vlastního účtu (účtu Plátce) 529 2 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 2 mezery 531 140 opt Zpráva pro Banku zde lze zadat informace pro další zpracování jednotlivé položky Vnitrobankovního cizoměnového hromadného příkazu v Bance: 1) individuální podmínky sjednané s Bankou pro konkrétní Platební příkaz (např. individuální kurz, dohodnutá valuta, expresní zaslání platby atd.), nebo 2) dodatečné informace k platební instrukci, nebo 3) nepovinné údaje pro SEPA Platební transakci dohodnuté mezi Plátcem a Příjemcem (reference plátce, identifikace plátce, identifikace příjemce, kód účelu úhrady a kategorie účelu úhrady purpose code a category purpose code). 671 11 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 11 mezer 682 6 digits, lz, opt Předčíslí čísla vlastního účtu (účet Plátce) pokud nebude uvedeno, musí být účet vybrán při importu souboru do HB Datum splatnosti 688 6 Jednotlivé položky v jedné Dávce mohou mít různá Data splatnosti. Pokud YYMMDD, opt, jsou v Dávce položky s Datem splatnosti v minulosti nebo Datum digits splatnosti chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP. 694 6 digit, lz, opt Předčíslí čísla účtu Příjemce lze vyplnit pouze v případě, kdy je číslo účtu uváděno v národním formátu. Příklad (tečky v textu vyznačují mezery): INT00000320120802 Janko Hrasko 0000000000125,65EUR4123 951762 4873956218OUR faktura 56/2012 z 15.1.2012 120803 Verse: 01032013 Strana 5 (celkem 29)
4. Struktura souboru pro Zahraniční hromadné příkazy!!! POZOR!!! V Zahraničním hromadném příkazu lze zadat pouze znaky, které jsou povolené ve SWIFTových zprávách: a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 / -? : ( )., ' + mezera Pokud budou v importovaném souboru zadány jiné znaky, jednotlivé položky z Dávky budou po nahrání do HB odmítnuty z důvodu formálních chyb. Pozice Délka Formát Popis pole 1 3 INT, opt Uveďte vždy hodnotu INT označující zahraniční platbu 4 6 digits, lz, opt Pořadové číslo řádku 10 8 YYYYMMDD, Datum vytvoření souboru pokud je uvedeno, musí být shodné pro opt, digits všechny položky v souboru 18 35 opt Název a adresa banky Příjemce, 1. část povinné v případě, kdy není uveden BIC (SWIFT kód) 53 35 opt Název a adresa banky Příjemce, 2. část 88 35 opt Název a adresa banky Příjemce, 3. část 123 35 opt Název a adresa banky Příjemce, 4. část 158 35 Název a adresa Příjemce, 1. část 193 35 opt Název a adresa Příjemce, 2. část 228 35 opt Název a adresa Příjemce, 3. část 263 35 opt Název a adresa Příjemce, 4. část 298 16 digits, lz, decpt Částka platby pokud obsahuje desetinná místa, je nutné je oddělit desetinnou čárkou nebo tečkou 314 3 Měna ISO kód 317 10 digits, lz Číslo vlastního účtu (účet Plátce) 327 34 Číslo účtu Příjemce pokud se jedná o Platební transakci do zemí EU/EHP a o SEPA Platební transakce (včetně plateb do jiných bank v ČR), musí být uvedeno ve formátu IBAN 361 3 OUR, SHA Označení typu poplatků (SHA, OUR). Pokud se jedná o Platební transakci do zemí EU/EHP v EUR a o SEPA Platební transakci, je přípustný pouze typ poplatku SHA. U ostatních Platebních transakcí může být uveden typ poplatku SHA nebo OUR. 364 3 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 3 mezery 367 2 ISO kód země banky Příjemce (nikoli země Příjemce země Příjemce může být odlišná od země banky Příjemce). 369 140 opt Zpráva pro Příjemce volný text. Zde můžete zadat popis pro potřebu Příjemce. Přenáší se do SWIFTové zprávy jako 4 řádky po 35 znacích, doporučujeme toto zohlednit při vyplňování údajů. 509 20 opt Název vlastního účtu (účtu Plátce) 529 2 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 2 mezery 531 140 opt Zpráva pro Banku zde lze zadat informace pro další zpracování jednotlivé položky Zahraničního hromadného příkazu v Bance: 4) individuální podmínky sjednané s Bankou pro konkrétní Platební příkaz (např. individuální kurz, dohodnutá valuta, expresní zaslání platby atd.), nebo 5) dodatečné informace k platební instrukci (např. požadovaná korespondenční banka apod.), nebo 6) nepovinné údaje pro SEPA Platební transakci dohodnuté mezi Plátcem a Příjemcem (reference plátce, identifikace plátce, identifikace příjemce, kód účelu úhrady a kategorie účelu úhrady purpose code a category purpose code). Verse: 01032013 Strana 6 (celkem 29)
Pozice Délka Formát Popis pole 671 11 opt 682 6 digits, lz, opt 688 6 YYMMDD, opt, digits BIC (SWIFT kód) banky Příjemce pokud se jedná o Platební transakci do zemí EU/EHP a SEPA Platební transakci (včetně plateb do jiných bank v ČR), je toto pole povinné. Předčíslí čísla vlastního účtu (účet Plátce) pokud nebude uvedeno, musí být účet vybrán při importu souboru do HB. Datum splatnosti Jednotlivé položky v jedné Dávce mohou mít různá Data splatnosti. Pokud jsou v Dávce položky s Datem splatnosti v minulosti nebo Datum splatnosti chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP. Příklad (tečky v textu vyznačují mezery): INT00000120120802Deutsche Bank Firma GMBH Rathausplatz 15 Berlin D-12345 Germany 0000000000251,24EUR2345678909 DE874 78615189963590000SHA DEInvoice No. 3658/2012 expresni platba s dohodnutym kurzem 26.542 PMBADEXXXXX 120803 INT00000220120802Slovenska banka Janko Hrasko U namesti 20 Presov 250 00 Slovakia 0000000000124,65EUR2586740304 SK3302 000000000000012351SHA SKfaktura 56/2012 z 15.1.2012 PMBASKXXXXX 120803 B. ABO formát struktura souboru pro Tuzemské hromadné příkazy a Tuzemské hromadné příkazy k inkasu Datový soubor musí obsahovat následující typy záznamů: a) záznam UHL1, b) hlavičku účetního souboru, c) hlavičku skupiny, d) účetní položku v CZK, e) konec skupiny, f) konec účetního souboru. Každý jednotlivý záznam datového souboru (tzn. řádek) musí být ukončen koncovým znakem záznamu CR + LF.!!! POZOR!!! V Tuzemském hromadném příkazu a Tuzemském hromadném příkazu k inkasu lze zadat pouze znaky, které jsou povolené v systému CERTIS: a b c d e f g h i j k l m n o p q r s t u v w x y z á ä č ď é ě í ľ ň ó ô ö ř ŕ š ť ú ů ü ý ž A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Á Ä Č Ď É Ě Í Ľ Ň Ó Ô Ö Ř Ŕ Š Ť Ú Ů Ü Ý Ž 0 1 2 3 4 5 6 7 8 9 / -? : ( )., ' +! " # $ % & * ; < = > @ [ \ ] ^ ` { } ~ mezera Pokud budou v importovaném souboru zadány jiné znaky, jednotlivé položky z Dávky mohou být po nahrání do HB nebo po předání do ČNB odmítnuty z důvodu formálních chyb. Pokud není v popisu jednotlivých polí uvedeno jinak, jsou všechna pole v Dávce povinná. Tuzemský hromadný příkaz a Tuzemský hromadný příkaz k inkasu musí být vždy importovány v samostatné Dávce. Verse: 01032013 Strana 7 (celkem 29)
1. Popis záznamu UHL1 Poř. č. Délka min. max. Formáty souborů pro import a export dat pro službu Homebanking PPF banky a.s. Formát Popis pole 1. 4 4 UHL1 Typ zprávy uveďte vždy hodnotu UHL1 2. 6 6 DDMMRR Datum vytvoření účetního souboru nemá žádný vztah ke splatnosti jednotlivých položek obsažených v datovém souboru, označuje jeho vytvoření. 3. 20 20 NNNNNNNNNNNNN Zkrácený název Klienta alfanumerické znaky s případným NNNNNNN doplněním mezerami, nepřípustná jsou malá písmena a znak @ 4. 10 10 1234567890 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu 1234567890 5. 3 3 001 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu 001 6. 3 3 999 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu 999 7. 6 6 111111 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu 111111 8. 6 6 222222 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu 222222 2. Popis hlavičky a konce účetního souboru Vstupní data datového souboru jsou podle svého charakteru sdružována do účetních souborů, které jsou ohraničené hlavičkou a koncem účetního souboru. Charakter vstupních dat sdružených do účetních souborů určuje druh dat, kterým může být Tuzemský hromadný příkaz nebo Tuzemský hromadný příkaz k inkasu. a) Hlavička účetního souboru Poř. č. Délka min. max. Formát Popis pole 1. 1 1 1 Typ zprávy uveďte vždy hodnotu 1 2. 1 1 mezera Oddělovač pole zadejte vždy mezeru 3. 4 4 NNNN Druh dat uveďte: 1501 pro účetní soubor s Tuzemským hromadným příkazem, 1502 pro účetní soubor s Tuzemským hromadným příkazem k inkasu. 4. 1 1 mezera Oddělovač pole zadejte vždy mezeru 5. 6 6 111111 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu 111111 6. 1 1 mezera Oddělovač pole zadejte vždy mezeru 7. 4 4 6000 Kód PPF banky a.s. b) Konec účetního souboru Poř. č. Délka min. max. Formát Popis pole 1. 1 1 5 Typ zprávy uveďte vždy hodnotu 5 2. 1 1 mezera Oddělovač pole zadejte vždy mezeru 3. 1 1 + Uveďte vždy znak + 3. Popis hlavičky a konce skupiny položek Účetní soubory jsou dále členěny do menších celků skupin. Každá skupina v účetním souboru je ohraničena hlavičkou a koncem skupiny. Jeden účetní soubor může obsahovat skupiny s různými Daty splatnosti, Datum splatnosti však nesmí být starší než datum dne, kdy je Dávka odesílána do Banky. Verse: 01032013 Strana 8 (celkem 29)
a) Hlavička skupiny položek Poř. č. Délka min. max. Formáty souborů pro import a export dat pro službu Homebanking PPF banky a.s. Formát Popis pole 1. 1 1 2 Typ zprávy uveďte vždy hodnotu 2 2. 1 1 mezera Oddělovač pole zadejte vždy mezeru 3. 2 17 NNNNNN- NNNNNNNNNN Číslo vlastního účtu: uvádí se účet Plátce u Tuzemského hromadného příkazu nebo účet Příjemce u Tuzemského hromadného příkazu k inkasu; pokud je kratší než 16 znaků (6 znaků předčíslí a 10 znaků číslo účtu), může ale nemusí být před oddělovačem předčíslí i za ním doplněno zleva nulami (např. 000000-0123456789), minimálně musí být zadány dvě číslice zprava. 4. 1 1 mezera Oddělovač pole zadejte vždy mezeru 5. 1 14 NNNNNNNNNNNNN N Celková částka položek ve skupině uvedená v CZK, musí se rovnat součtu částek jednotlivých položek ve skupině. Desetinná místa se neoddělují čárkou a musí být vždy uvedena. 6. 1 1 mezera Oddělovač pole zadejte vždy mezeru 7. 6 6 DDMMRR b) Konec skupiny položek Poř. č. Délka min. max. Formát Datum splatnosti je společné pro všechny položky ve skupině. Pokud je uvedeno Datum splatnosti v minulosti nebo Datum splatnosti chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP. Popis pole 1. 1 1 3 Typ zprávy uveďte vždy hodnotu 3 2. 1 1 mezera Oddělovač pole zadejte vždy mezeru 3. 1 1 + Uveďte vždy znak + 4. Popis účetní položky a) Položka Tuzemského hromadného příkazu Poř. č. Délka min. max. 1. 2 17 Formát NNNNNN- NNNNNNNNNN Popis pole Číslo účtu Příjemce pokud je kratší než 16 znaků (6 znaků předčíslí a 10 znaků číslo účtu), může ale nemusí být před oddělovačem předčíslí i za ním doplněno zleva nulami (např. 000000-0123456789), minimálně musí být zadány dvě číslice zprava. 2. 1 1 mezera Oddělovač pole zadejte vždy mezeru 3. 1 12 NNNNNNNNNNNN Částka jednotlivé položky v CZK, desetinná místa se neoddělují čárkou a musí být vždy uvedena. 4. 1 1 mezera Oddělovač pole zadejte vždy mezeru 5. 1 10 NNNNNNNNNN Variabilní symbol pokud není uveden, doplňte zde jednu nulu 6. 1 1 mezera Oddělovač pole zadejte vždy mezeru 7. 4 4 NNNN Konstantní symbol pokud není uveden, doplňte zde čtyři nuly 8. 4 4 NNNN Kód banky Příjemce 9. 1 1 mezera Oddělovač pole zadejte vždy mezeru 10. 0 10 NNNNNNNNNN Specifický symbol nepovinný údaj 11. 1 1 mezera Oddělovač pole zadejte vždy mezeru 12. 0 146 AV: AV1 AV2 AV3 AV4 Zpráva pro Příjemce (AV pole) nepovinný údaj, volný text. Zde můžete zadat popis pro potřebu Příjemce ve výpisu Plátce se tato informace nezobrazí. Verse: 01032013 Strana 9 (celkem 29)
b) Položka Tuzemského hromadného příkazu k inkasu Poř. č. Délka min. max. 1. 2 17 Formát NNNNNN- NNNNNNNNNN Popis pole Číslo účtu Plátce pokud je kratší než 16 znaků (6 znaků předčíslí a 10 znaků číslo účtu), může ale nemusí být před oddělovačem předčíslí i za ním doplněno zleva nulami (např. 000000-0123456789), minimálně musí být zadány dvě číslice zprava. 2. 1 1 mezera Oddělovač pole zadejte vždy mezeru 3. 1 12 NNNNNNNNNNNN Částka jednotlivé položky v CZK, desetinná místa se neoddělují čárkou a musí být vždy uvedena. 4. 1 1 mezera Oddělovač pole zadejte vždy mezeru 5. 1 10 NNNNNNNNNN Variabilní symbol pokud není uveden, doplňte zde jednu nulu 6. 1 1 mezera Oddělovač pole zadejte vždy mezeru 7. 4 4 NNNN Konstantní symbol pokud není uveden, doplňte zde čtyři nuly 8. 4 4 NNNNNN Směrový kód banky Plátce 9. 1 1 mezera Oddělovač pole zadejte vždy mezeru 10. 0 10 NNNNNNNNNN Specifický symbol nepovinný údaj 11. 1 1 mezera Oddělovač pole zadejte vždy mezeru 12. 0 146 AV: AV1 AV2 AV3 AV4 5. Příklad souboru v ABO formátu (tečky v textu vyznačují mezery) UHL1010212PRVNÍ ÚČETNÍ S.R.O. 1234567890001999111111222222 1 1501 111111 6000 2 123456789 1456232 140113 123456789 150000 5236 00086000 faktura 125444/2013 19-123123 193487100 2725653700 01000558 27-123123123 650500 27256537 01003558 4220422 21958000 27256537 08003558 713-123123 366262800 27256537 07108148 7720-123 1212300 27256537 07108148 3 + 5 + Zpráva pro Plátce (AV pole) nepovinný údaj, volný text. Zde můžete zadat popis pro potřebu Plátce ve výpisu Příjemce se tato informace nezobrazí. Verse: 01032013 Strana 10 (celkem 29)
II. Formáty souborů pro import a export dat pro službu Homebanking PPF banky a.s. Export dat transakční historie a dnešní obraty Export Platebních transakcí je možný v šesti formátech: a) CSV formát viz odstavec A., b) XML formát viz odstavec B., c) ABO formát (pouze pro export položek tuzemského platebního styku) viz odstavec C., d) formát Gemini 4.1 viz odstavec D., bod 1., e) formát Gemini 5 viz odstavec D., bod 2., f) HTML formát viz odstavec E. A. CSV formát Specifikace formátu: Textový soubor, Formát ASCII Jeden řádek = jeden záznam z transakční historie Oddělovač "," (čárka); pokud je pole prázdné, následují po sově dva oddělovače "," bez mezery Řádky jsou odděleny znakem CRLF Struktura souboru: Pořadí Obsah pole 1. Nepoužívá se 2. Jméno banky PPF banka a.s. 3. Alfabetický kód PPF banky a.s. vždy PMBA 4. Variabilní symbol 5. Popis položky 1 6. Specifický symbol 7. Interní reference Banky 8. Období údaj o roku ve tvaru RRRR 9. Popis položky 2 10. Platební titul, pokud je uveden 11 Měna položky 12 Reference položky z elektronických kanálů 13 Popis položky 3 14 Měna poplatků 15 Popis položky 4 16 Zůstatek po realizaci příslušné položky 17. Kód typu položky 18. ID textu typu účtu 19. Název vlastního účtu 20. Částka položky 21. Číslo vlastního účtu 22. Číslo vlastního účtu v clearingovém formátu 23. Datum zúčtování 24. Nepoužívá se 25. Měna vlastního účtu 26. Název účtu protistrany 27. Banka účtu protistrany 28. Nepoužívá se 29. Nepoužívá se 30. ID typu účtu vždy 1 Běžný účet 31. Kód země 32. Číslo účtu protistrany 33. Datum valuty 34. Indikátor zrušení Indikátor typu položky: 35. DR debet na účtu CR kredit na účtu Verse: 01032013 Strana 11 (celkem 29)
Pořadí Obsah pole Formáty souborů pro import a export dat pro službu Homebanking PPF banky a.s. 36. Datum valuty protistrany 37. Nepoužívá se 38. Kurz položky 39. Částka platby v měně položky 40. Kód typu účtu 41. Reference Klienta 42. Text typu účtu 43. Konstantní symbol 44. Poplatky 45. ID typu obratu 46. Číslo položky v rámci dne zúčtování 47. Číslo výpisu z HB, na kterém se položka vyskytuje 48. Nepoužívá se 49. Nepoužívá se 50. Nepoužívá se 51. Nepoužívá se 52. Rozšířené informace k položce Příklad:,PPF banka a.s.,pmba,0000000000,,0000000000,20120110:0000026012:bo120110ge889929,2012,,,,301.7.404067.1,,,,85349. 68,DOM_OP11,1007000000,Testovací klient s.r.o.,375,000000 0123123123,,20120110,1,CZK,,6000,Tuzemská transakce - odchozí standard,1013000004,1,cz,0000002011680004,20120110,n,d,,,0,0,001,,běžný účet,0000000000,0,6,1,3 B. XML formát pro Gemini 5 Specifikace formátu: Použité datové typy: numerické typy jsou zapsány běžným způsobem bool Y nebo N datum: o YYYYMMDD, nebo o YYYYMMDDhhmmss (v případě, že čas není nulový), nebo o YYYYMMDDhhmmssfffffffff (v případě, že čas není nulový a zlomky sekund nejsou nula) záznamy s hodnotou NULL nejsou exportovány Tento formát má dvě rozdílné formy: - formu "oficiálního" výpisu viz bod 1., - formu "neoficiální", vzniklou vlastním výběrem skupiny pohybů viz bod 2. 1. Formát oficiálního výpisu Struktura souboru: Jméno XML Elementu Format Popis Poznámka Official bool Vždy Y oficiální výběr BankID int ID Banky v klientské databázi Gemini Nepoužívá se BankCode varchar(8) Alfa kód Banky (Gemini) BankCountryID varchar(2) Zkratka clearingu Banky BankName varchar(50) Jméno Banky AccNoID varchar(34) Číslo vlastního účtu ve tvaru klíče AccNoCC varchar(34) Číslo vlastního účtu v clearingovém formátu AccName varchar(50) Jméno vlastního účtu AccCcy char(3) Měna vlastního účtu AccCcyText varchar(255) Popis měny vlastního účtu AccTypeID int Typ vlastního účtu Verse: 01032013 Strana 12 (celkem 29)
Jméno XML Elementu Format Popis Poznámka AccTypeCode varchar(8) Kód typu vlastního účtu AccTypeText varchar(255) Popis typu vlastního účtu Period int Časové období, pro které byl vydán výpis Nepoužívá se StatemNo int Číslo výpisu Nepoužívá se StatemDate date Datum vystavení výpisu Nepoužívá se StatemStartBalance double Počáteční účetní zůstatek výpisu Nepoužívá se StatemEndBalance double Konečný zůstatek výpisu Nepoužívá se StatemOpeningDate date Počáteční datum období, které výpis postihuje Nepoužívá se StatemClosingDate date Konečné datum období, které výpis postihuje Nepoužívá se StatemDebitTotal double Součet částek exportovaných debetních položek StatemCreditTotal double Součet částek exportovaných kreditních položek StatemTransactionCount int Počet exportovaných Platebních transakcí StatemDebitCount int Počet exportovaných debetních položek StatemCreditCount int Počet exportovaných kreditních položek StatemClosed bool Informace, zda je daný výpis uzavřený Nepoužívá se ItemNo int Číslo položky tak, jak je předáno z Banky Nepoužívá se Amount double Částka položky v měně účtu Direction varchar(1) Směr obratu: D debet na účtu, C kredit na účtu, N odmítnutá položky PostingDate date Datum odeslání MovementTypeID int Typ obratu MovementTypeCode varchar(8) Kód obratu PartnerAccNo varchar(35) Číslo účtu protistrany PartnerAccBank varchar(35) Banka protistrany PartnerAccName varchar(35) Jméno účtu protistrany ValueDate date Datum valuty PartnerValueDate date Datum valuty na účtu protistrany PayAmount double Částka v měně položky PayCcy varchar(3) Měna položky ExcRate double Kurs použitý pro přepočet měny položky na měnu účtu ChargesAmount double Částka poplatků ChargesCcy varchar(3) Měna poplatků Balance double Zůstatek na účtu po realizaci položky (je-li znám) CancelIndicator bool Příznak, zda jde o storno GeminiRef varchar(32) Reference Gemini BankRef varchar(50) Reference Banky ClientRef varchar(50) Reference Klienta MovementTypeText varchar(255) Popis typu obratu Statistics1 varchar(10) Údaj pro statistiku (obvykle konstantní symbol) Statistics2 varchar(10) Údaj pro statistiku (obvykle variabilní symbol) Statistics3 varchar(10) Údaj pro statistiku (obvykle specifický symbol) Statistics4 varchar(10) Údaj pro statistiku (obvykle platební titul) Description1 varchar(35) Popis položky Description2 varchar(35) Popis položky Description3 varchar(35) Popis položky Description4 varchar(35) Popis položky Description5 varchar(35) Popis položky Description6 varchar(35) Popis položky Description7 varchar(35) Popis položky Description8 varchar(35) Popis položky Info01 varchar(60) Další doprovodné informace k položce 1.. 20 Nepoužívá se Verse: 01032013 Strana 13 (celkem 29)
Jméno XML Elementu Format Popis Poznámka Info02 varchar(60) Nepoužívá se Info03 varchar(60) Nepoužívá se Info04 varchar(60) Nepoužívá se Info05 varchar(60) Nepoužívá se Info06 varchar(60) Nepoužívá se Info07 varchar(60) Nepoužívá se Info08 varchar(60) Nepoužívá se Info09 varchar(60) Nepoužívá se Info10 varchar(60) Nepoužívá se Info11 varchar(60) Nepoužívá se Info12 varchar(60) Nepoužívá se Info13 varchar(60) Nepoužívá se Info14 varchar(60) Nepoužívá se Info15 varchar(60) Nepoužívá se Info16 varchar(60) Nepoužívá se Info17 varchar(60) Nepoužívá se Info18 varchar(60) Nepoužívá se Info19 varchar(60) Nepoužívá se Info20 varchar(60) Nepoužívá se Extensions varchar(255) Rozšířené informace k položce IncomingDocID int Číslo příchozího dokumentu v klientské databázi Gemini Nepoužívá se Příklad: <?xml version="1.0" encoding="utf-8"?> <!-- This file stores exported account movements from Gemini/CS 5 application. --> <AccountMovements version='1.0' xmlns='urn:schemas-bscpraha-cz:gemini5:export:movements' Official='Y' BankID='' BankCode='' BankCountryID='' BankName='' AccNoID='' AccNoCC='' AccName='' AccCcy='' AccCcyText='' AccTypeID='' AccTypeCode='' AccTypeText='' Period='' StatemNo='' StatemDate='' StatemStartBalance='' StatemEndBalance='' StatemOpeningDate= StatemClosingDate='' StatemDebitTotal='41,00' StatemCreditTotal='0,00' StatemTransactionCount='3' StatemDebitCount='3' StatemCreditCount='0' > <Movement ItemNo='1' Amount='10,00' Verse: 01032013 Strana 14 (celkem 29)
Direction='D' PostingDate='20100618' MovementTypeID='6' MovementTypeCode='DOM_OP11'> <PartnerAccNo>9999999999</PartnerAccNo> <PartnerAccBank>6000</PartnerAccBank> <PartnerAccName></PartnerAccName> <ValueDate>20100618</ValueDate> <PartnerValueDate></PartnerValueDate> <PayAmount></PayAmount> <PayCcy></PayCcy> <ExcRate></ExcRate> <ChargesAmount></ChargesAmount> <ChargesCcy></ChargesCcy> <Balance>20 062,72</Balance> <CancelIndicator>0</CancelIndicator> <GeminiRef>301.7.55851.1</GeminiRef> <BankRef>20100618:0000003271:BO100618GE320438</BankRef> <ClientRef></ClientRef> <MovementTypeText>Odchozí domácí platba</movementtypetext> <Statistics1>0000000000</Statistics1> <Statistics2>0000000000</Statistics2> <Statistics3>0000000000</Statistics3> <Statistics4></Statistics4> <Description1>ahoj priemcce. řádek čárka</description1> <Description2></Description2> <Description3></Description3> <Description4></Description4> <Description5>ahoj priemcce. řádek čárka</description5> <Description6></Description6> <Description7></Description7> <Description8></Description8> <Extensions>DOM-AVIZO: ahoj priemcce. řádek čárka</extensions> </Movement> <Movement ItemNo='2' Amount='11,00' Direction='D' PostingDate='20100618' MovementTypeID='1' MovementTypeCode='DOM'> <PartnerAccNo>10328018</PartnerAccNo> <PartnerAccBank>5500</PartnerAccBank> <PartnerAccName></PartnerAccName> <ValueDate>20100618</ValueDate> <PartnerValueDate></PartnerValueDate> <PayAmount></PayAmount> <PayCcy></PayCcy> <ExcRate></ExcRate> <ChargesAmount>200,00</ChargesAmount> <ChargesCcy>CZK</ChargesCcy> <Balance>20 051,72</Balance> <CancelIndicator>0</CancelIndicator> <GeminiRef></GeminiRef> <BankRef>20100618:0000003272:BO100618MN320423</BankRef> <ClientRef></ClientRef> <MovementTypeText>Domácí platba</movementtypetext> <Statistics1>0000000000</Statistics1> <Statistics2>0000000000</Statistics2> <Statistics3>0000000000</Statistics3> Verse: 01032013 Strana 15 (celkem 29)
<Statistics4></Statistics4> <Description1></Description1> <Description2></Description2> <Description3></Description3> <Description4></Description4> <Description5></Description5> <Description6></Description6> <Description7></Description7> <Description8></Description8> <Extensions></Extensions> </Movement> <Movement ItemNo='3' Amount='20,00' Direction='D' PostingDate='20100618' MovementTypeID='6' MovementTypeCode='DOM_OP11'> <PartnerAccNo>123123123</PartnerAccNo> <PartnerAccBank>6000</PartnerAccBank> <PartnerAccName></PartnerAccName> <ValueDate>20100618</ValueDate> <PartnerValueDate></PartnerValueDate> <PayAmount></PayAmount> <PayCcy></PayCcy> <ExcRate></ExcRate> <ChargesAmount></ChargesAmount> <ChargesCcy></ChargesCcy> <Balance>2 035,30</Balance> <CancelIndicator>0</CancelIndicator> <GeminiRef>301.7.55852.1</GeminiRef> <BankRef>20100618:0000003274:BO100618GE320439</BankRef> <ClientRef></ClientRef> <MovementTypeText>Odchozí domácí platba</movementtypetext> <Statistics1>0000000000</Statistics1> <Statistics2>0000000000</Statistics2> <Statistics3>0000000000</Statistics3> <Statistics4></Statistics4> <Description1></Description1> <Description2></Description2> <Description3></Description3> <Description4></Description4> <Description5></Description5> <Description6></Description6> <Description7></Description7> <Description8></Description8> <Extensions></Extensions> </Movement> </AccountMovements> Verse: 01032013 Strana 16 (celkem 29)
2. Formát vlastního výběru položek Struktura souboru: Formáty souborů pro import a export dat pro službu Homebanking PPF banky a.s. Jméno XML Elementu Format Popis Poznámka Official bool Vždy N vlastní výběr StatemDebitTotal double Součet částek exportovaných debetních položek StatemCreditTotal double Součet částek exportovaných kreditních položek StatemTransactionCount int Počet exportovaných Platebních transakcí StatemDebitCount int Počet exportovaných debetních položek StatemCreditCount int Počet exportovaných kreditních položek StatemClosed bool Informace, zda je daný výpis uzavřený Nepoužívá se ItemNo int Číslo položky tak, jak je předáno z banky Nepoužívá se Amount double Částka položky v měně účtu Direction varchar(1) Směr obratu: D debet na účtu, C kredit na účtu, N odmítnutá položka PostingDate date Datum odeslání MovementTypeID int Typ obratu MovementTypeCode varchar(8) Kód obratu PartnerAccNo varchar(35) Číslo účtu protistrany PartnerAccBank varchar(35) Banka protistrany PartnerAccName varchar(35) Jméno účtu protistrany ValueDate date Datum valuty PartnerValueDate date Datum valuty na účtu protistrany PayAmount double Částka v měně položky PayCcy varchar(3) Měna položky ExcRate double Kurs použitý pro přepočet měny položky na měnu účtu ChargesAmount double Poplatky ChargesCcy varchar(3) Měna poplatků Balance double Zůstatek na účtu po realizaci položky (je-li znám) CancelIndicator bool Příznak, zda jde o storno GeminiRef varchar(32) Reference Gemini BankRef varchar(50) Reference Banky ClientRef varchar(50) Reference Klienta MovementTypeText varchar(255) Popis typu obratu BankID int ID Banky v klientské databázi Gemini Nepoužívá se BankCode varchar(8) Alfa kód Banky (Gemini) BankCountryID varchar(2) Zkratka clearingu Banky BankName varchar(50) Jméno Banky AccNoID varchar(34) Číslo vlastního účtu ve tvaru klíče AccNoCC varchar(34) Číslo vlastního účtu v clearingovém formátu AccName varchar(50) Jméno vlastního účtu AccCcy char(3) Měna vlastního účtu AccCcyText varchar(255) Popis měny vlastního účtu AccTypeID int Typ vlastního účtu AccTypeCode varchar(8) Kód typu vlastního účtu AccTypeText varchar(255) Popis typu vlastního účtu Period int Časové období, pro které byl vydán výpis Nepoužívá se StatemNo int Číslo výpisu Nepoužívá se StatemDate date Datum vystavení výpisu Nepoužívá se StatemStartBalance double Počáteční účetní zůstatek výpisu Nepoužívá se StatemEndBalance double Konečný zůstatek výpisu Nepoužívá se Verse: 01032013 Strana 17 (celkem 29)
Jméno XML Elementu Format Popis Poznámka StatemOpeningDate date Počáteční datum období, které výpis postihuje Nepoužívá se StatemClosingDate date Konečné datum období, které výpis postihuje Nepoužívá se Statistics1 varchar(10) Údaj pro statistiku (obvykle konstantní symbol) Statistics2 varchar(10) Údaj pro statistiku (obvykle variabilní symbol) Statistics3 varchar(10) Údaj pro statistiku (obvykle specifický symbol) Statistics4 varchar(10) Údaj pro statistiku (obvykle platební titul) Description1 varchar(35) Popis položky Description2 varchar(35) Popis položky Description3 varchar(35) Popis položky Description4 varchar(35) Popis položky Description5 varchar(35) Popis položky Description6 varchar(35) Popis položky Description7 varchar(35) Popis položky Description8 varchar(35) Popis položky Info01 varchar(60) Další doprovodné informace k položce 1.. 20 Nepoužívá se Info02 varchar(60) Nepoužívá se Info03 varchar(60) Nepoužívá se Info04 varchar(60) Nepoužívá se Info05 varchar(60) Nepoužívá se Info06 varchar(60) Nepoužívá se Info07 varchar(60) Nepoužívá se Info08 varchar(60) Nepoužívá se Info09 varchar(60) Nepoužívá se Info10 varchar(60) Nepoužívá se Info11 varchar(60) Nepoužívá se Info12 varchar(60) Nepoužívá se Info13 varchar(60) Nepoužívá se Info14 varchar(60) Nepoužívá se Info15 varchar(60) Nepoužívá se Info16 varchar(60) Nepoužívá se Info17 varchar(60) Nepoužívá se Info18 varchar(60) Nepoužívá se Info19 varchar(60) Nepoužívá se Info20 varchar(60) Nepoužívá se Extensions varchar(255) Rozšířené informace k položce IncomingDocID int Číslo příchozího dokumentu v klientské databázi Gemini Nepoužívá se Příklad: <?xml version="1.0" encoding="utf-8"?> <!-- This file stores exported account movements from Gemini/CS 5 application. --> <AccountMovements version='1.0' xmlns='urn:schemas-bscpraha-cz:gemini5:export:movements' Official='N' StatemDebitTotal='21,00' StatemCreditTotal='0,00' StatemTransactionCount='2' StatemDebitCount='2' StatemCreditCount='0' > <Movement ItemNo='1' Amount='10,00' Direction='D' PostingDate='20100618' MovementTypeID='6' Verse: 01032013 Strana 18 (celkem 29)
MovementTypeCode='DOM_OP11'> <PartnerAccNo>9999999999</PartnerAccNo> <PartnerAccBank>6000</PartnerAccBank> <PartnerAccName></PartnerAccName> <ValueDate>20100618</ValueDate> <PartnerValueDate></PartnerValueDate> <PayAmount></PayAmount> <PayCcy></PayCcy> <ExcRate></ExcRate> <ChargesAmount></ChargesAmount> <ChargesCcy></ChargesCcy> <Balance>20 062,72</Balance> <CancelIndicator>0</CancelIndicator> <GeminiRef>301.7.55851.1</GeminiRef> <BankRef>20100618:0000003271:BO100618GE320438</BankRef> <ClientRef></ClientRef> <MovementTypeText>Odchozí domácí platba</movementtypetext> <BankCode>6000</BankCode> <BankCountryID>CZ</BankCountryID> <BankName>PPF banka a.s.</bankname> <AccNoID>123123123</AccNoID> <AccNoCC>000000 0123123123/6000</AccNoCC> <AccName>BU Klient 1</AccName> <AccCcy>CZK</AccCcy> <AccCcyText>Koruna česká</accccytext> <AccTypeID>1</AccTypeID> <AccTypeCode>001</AccTypeCode> <AccTypeText>Běžný účet</acctypetext> <Statistics1>0000000000</Statistics1> <Statistics2>0000000000</Statistics2> <Statistics3>0000000000</Statistics3> <Statistics4></Statistics4> <Description1>ahoj priemcce. řádek čárka</description1> <Description2></Description2> <Description3></Description3> <Description4></Description4> <Description5>ahoj priemcce. řádek čárka</description5> <Description6></Description6> <Description7></Description7> <Description8></Description8> <Extensions>DOM-AVIZO: ahoj priemcce. řádek čárka</extensions> </Movement> <Movement ItemNo='2' Amount='11,00' Direction='D' PostingDate='20100618' MovementTypeID='1' MovementTypeCode='DOM'> <PartnerAccNo>10328018</PartnerAccNo> <PartnerAccBank>5500</PartnerAccBank> <PartnerAccName></PartnerAccName> <ValueDate>20100618</ValueDate> <PartnerValueDate></PartnerValueDate> <PayAmount></PayAmount> <PayCcy></PayCcy> <ExcRate></ExcRate> <ChargesAmount>200,00</ChargesAmount> <ChargesCcy>CZK</ChargesCcy> <Balance>20 051,72</Balance> Verse: 01032013 Strana 19 (celkem 29)
<CancelIndicator>0</CancelIndicator> <GeminiRef></GeminiRef> <BankRef>20100618:0000003272:BO100618MN320423</BankRef> <ClientRef></ClientRef> <MovementTypeText>Domácí platba</movementtypetext> <BankCode>6000</BankCode> <BankCountryID>CZ</BankCountryID> <BankName>PPF banka a.s.</bankname> <AccNoID>123123123</AccNoID> <AccNoCC>000000 0123123123/6000</AccNoCC> <AccName>BU Klient 1</AccName> <AccCcy>CZK</AccCcy> <AccCcyText>Koruna česká</accccytext> <AccTypeID>1</AccTypeID> <AccTypeCode>001</AccTypeCode> <AccTypeText>Běžný účet</acctypetext> <Statistics1>0000000000</Statistics1> <Statistics2>0000000000</Statistics2> <Statistics3>0000000000</Statistics3> <Statistics4></Statistics4> <Description1></Description1> <Description2></Description2> <Description3></Description3> <Description4></Description4> <Description5></Description5> <Description6></Description6> <Description7></Description7> <Description8></Description8> <Extensions></Extensions> </Movement> </AccountMovements> C. ABO formát export údajů o tuzemských Platebních transakcích Export údajů o tuzemských Platebních transakcích v ABO formátu může obsahovat až čtyři typy záznamů: a) výpis z účtu, b) Platební transakce, c) pole AV1 AV2, d) pole AV3 AV4. Export údajů o tuzemských Platebních transakcích je prostý datový soubor v textovém formátu s použitým kódováním ASCII. Každý jednotlivý záznam datového souboru (tzn. řádek) je vždy ukončen koncovým znakem záznamu CR + LF. 1. Popis záznamu Výpis z účtu Poř. č. Délka Formát Popis pole 1. 3 074 Typ záznamu vždy 074 2. 16 NNNNNNNNNNNNNN NN Číslo vlastního účtu 3. 20 NNNNNNNNNNNNNN NNNNNN Zkrácený název Klienta 4. 6 DDMMRR Datum starého zůstatku 5. 14 Částka starého zůstatku desetinná místa se neoddělují čárkou a NNNNNNNNNNNNNN jsou vždy uvedena. Znaménko starého zůstatku vždy je uvedeno buď + (plus = 6. 1 +/- kladný zůstatek kredit) nebo - (mínus = záporný zůstatek debet) Verse: 01032013 Strana 20 (celkem 29)
Poř. č. Délka Formát Popis pole 7. 14 Částka nového zůstatku desetinná místa se neoddělují čárkou a NNNNNNNNNNNNNN jsou vždy uvedena. Znaménko nového zůstatku vždy je uvedeno buď + (plus = 8. 1 +/- kladný zůstatek kredit) nebo - (mínus = záporný zůstatek debet) 9. 14 NNNNNNNNNNNNNN Celková částka debetních obratů (MD) 10. 1 0/- Znaménko debetních obratů (MD) nula nebo v případě převážení storna znak - (mínus) 11. 14 NNNNNNNNNNNNNN Celková částka kreditních obratů (D) 12. 1 0/- Znaménko kreditních obratů (MD) nula nebo v případě převážení storna znak - (mínus) 13. 3 NNN Pořadové číslo výpisu 14. 6 DDMMRR Datum vytvoření výpisu 15. 14 mezera 14 znaků mezera z důvodu sjednocení délky záznamů typu 074 a 075. 2. Popis záznamu Platební transakce v CZK Poř. č. Délka Formát Popis pole 1. 3 075 Typ záznamu vždy 075 2. 16 NNNNNNNNNNNNNN NN Číslo vlastního účtu 3. 16 NNNNNNNNNNNNNN Číslo účtu protistrany (účtu Příjemce u odchozí platby nebo účtu NN Plátce u příchozí platby) 4. 13 NNNNNNNNNNNNN Nepoužívá se uvedeny nuly 5. 12 NNNNNNNNNNNN Částka desetinná místa se neoddělují čárkou a jsou vždy uvedena. 6. 1 N Kód účtování vztahuje se k údaji pod pořadovým číslem 2. (číslo vlastního účtu). Možné hodnoty jsou: 1 = položka debet 2 = položka kredit 4 = storno položky debet 5 = storno položky kredit 7. 10 NNNNNNNNNN Variabilní symbol 8. 10 NNNNNNNNNN Konstantní symbol na 1. až 4. místě zprava je uveden konstantní symbol, na 5. až 8. místě zprava je uveden směrový kód banky, která vede účet uvedený v poli 3. 9. 10 NNNNNNNNNN Specifický symbol 10. 6 DDMMRR Datum valuty datum, od kterého je položka zahrnuta do zůstatku účtu pro výpočet úroků 11. 20 NNNNNNNNNNNNNN NNNNNN Zkrácený název účtu protistrany, popř. doplňující údaj. 12. 1 N Nepoužívá se uvedena nula 13. 4 rmoo Druh dat: r = kód pro měnu obratové položky a výpisu vždy 1, moo = kód pro typ obratové položky podle číselníku banky numerická hodnota o délce 3 znaky: o m 1 pro položky v CZK, 0 pro položky v jiné měně, o oo 01 pro debetní položku, 02 pro kreditní položku 14. 6 DDMMRR Datum splatnosti/připsání Verse: 01032013 Strana 21 (celkem 29)
3. Popis záznamu Podpole AV1 AV2 Formáty souborů pro import a export dat pro službu Homebanking PPF banky a.s. Záznam následuje ihned za Platební transakcí v CZK, které se tento záznam týká. Pokud Platební transakce tato AV pole neobsahuje, tento řádek se nezobrazí. Poř. č. Délka Formát Popis pole 1. 3 078 Typ záznamu vždy 078 2. 35 NNNNNNNNN N Pole AV1 3. 35 NNNNNNNNN N Pole AV2 4. Popis záznamu Podpole AV3 AV4 Záznam následuje ihned za Platební transakcí v CZK, které se tento záznam týká. Pokud Platební transakce tato AV pole neobsahuje, tento řádek se nezobrazí. Poř. č. Délka Formát Popis pole 1. 3 079 Typ záznamu vždy 079 2. 35 NNNNNNNNN N Pole AV3 3. 35 NNNNNNNNN N Pole AV4 5. Příklad souboru v ABO formátu (tečky v textu vyznačují mezery) 074000000123456789TESTOVACI KLIENT SRO31011300000000566544+00000000666544+00000000001000000 015010213 0750000001234567890000009876543210000000000000000000015544165987452360000000008000000000001021 3TESTOVACI KLIENT SRO01102010213 078faktura za leden 2013 D. Formát Gemini Specifikace formátu Gemini: Textový soubor, Formát ASCII Pevná délka pozic jednotlivých záznamů Jeden řádek = jedna Platební transakce Řádky jsou odděleny znakem CR/LF Pole se standardně zarovnávají doprava (včetně pole pro uvedení BIC), výjimku tvoří texty typu zpráva pro příjemce, informace pro banku atd., která se zarovnávají doleva. Legenda: digits: lz: decpt: opt: pouze čísla nuly doplněné zleva jsou povinné pro oddělení desetinných míst musí být v záznamu použita desetinná tečka/čárka nepovinný údaj, může zůstat prázdný, nebo nebýt vyplněn, pokud je na konci řádku 1. Formát Gemini 4.1 a) Export Platebních transakcí z účtu Pozice Délka Formát Popis pole 1 35 Číslo vlastního účtu 36 3 ISO kód měny vlastního účtu 39 5 Pořadové číslo položky ve výpisu 44 5 Pořadové číslo elektronického výpisu Gemini 49 8 YYYYMMDD Datum výpisu 57 8 YYYYMMDD Datum zpracování 65 8 YYYYMMDD Datum zúčtování 73 2 C,D Směr položky: C = kreditní položka, D = debetní položka 75 15 decpt Částka Platební transakce Verse: 01032013 Strana 22 (celkem 29)
Pozice Délka Formát Popis pole 90 15 decpt Zůstatek na účtu po realizaci této Platební transakci 105 1 Nepoužívá se uvedena mezera 106 4 NMSC Typ položky vždy NMSC 110 16 NONREF Nepoužívá se uvedeno NONREF 126 16 Reference Banky: I-GE-CC pro kreditní tuzemské Platební transakce, O-GE-CC pro debetní tuzemské Platební transakce, GE-FT pro zahraniční Platební transakce, PK-XXX pro Platební transakce provedené platební kartou (XXX označuje způsob použití platební karty ATM, POS atd.). 142 34 Detaily 176 Delimited subfields b) Tuzemská Platební transakce Pořadové číslo Maximální délka Formát 1 1 I = příchozí Platební transakce O = odchozí Platební transakce 2 2 Nepoužívá se 3 7 Kód banky Plátce 4 7 Kód banky Příjemce 5 7 Nepoužívá se 6 10 Konstantní symbol 7 16 8 20 Název účtu Plátce Informační pole, obsah závisí na typu položky a odvíjí se od hodnoty na pozici 126 (Reference Banky): I-GE-CC nebo O-GE-CC bude se od pozice 176 pokračovat tabulkou Tuzemská Platební transakce (viz bod b); GE-FT bude se od pozice 176 pokračovat tabulkou Zahraniční Platební transakce (viz bod c); PK-XXX pole zůstane prázdné. Obecně obsahuje položky od sebe oddělované znakem s ASCII hodnotou 4. Položky mohou mít proměnnou délku a některé mohou být prázdné v takovém případě za sebou následují dva oddělovací znaky, aby pořadová čísla položek zůstala zachována. Popis pole Číslo účtu Plátce prvních 6 číslic je předčíslí (6 nul pro prázdné předčíslí), dalších 10 je vlastní číslo účtu 9 16 Číslo účtu Příjemce prvních 6 číslic je předčíslí (6 nul pro prázdné předčíslí), dalších 10 je vlastní číslo účtu 10 20 Název účtu Příjemce 11 10 opt Specifický symbol kreditní 12 10 opt Specifický symbol debetní 13 140 opt Pokud pole Detaily obsahuje hodnotu //, obsahuje toto pole detaily o Platební transakci provedené platební kartou, oddělené znakem /. 14 140 opt Doplňující informace 15 10 opt Variabilní symbol kreditní 16 10 opt Variabilní symbol debetní 17 140 opt AV pole Verse: 01032013 Strana 23 (celkem 29)
c) Zahraniční Platební transakce Pořadové číslo Maximální délka Formáty souborů pro import a export dat pro službu Homebanking PPF banky a.s. Formát Popis pole 1 15 Interní reference Banky 2 6 YYMMDD Datum provedení Platební transakce 3 14 decpt Použitý kurz 4 3 Měna Platební transakce pole obsahuje měnu uvedenou na Platebním příkazu, u Vnitrobankovního cizoměnového příkazu pole 5 17 decpt obsahuje měnu protiúčtu Převáděná částka pole obsahuje částku uvedenou na Platebním příkazu, u Vnitrobankovního cizoměnového příkazu pole obsahuje částku v měně protiúčtu 6 3 Měna poplatků 7 15 Nepoužívá se 8 15 Nepoužívá se 9 15 Nepoužívá se 10 15 Nepoužívá se 11 15 Nepoužívá se 12 15 Nepoužívá se 13 15 Nepoužívá se 14 15 Nepoužívá se 15 15 decpt Ekvivalentní částka v měně účtu Klienta 16 15 decpt Celková částka poplatků 17 16 opt Účet pro poplatky 18 15 Nepoužívá se 19 15 Nepoužívá se 20 35 Název a adresa Plátce, 1. část (může obsahovat číslo účtu Plátce) 21 35 opt Název a adresa Plátce, 2. část 22 35 opt Název a adresa Plátce, 3. část 23 35 opt Název a adresa Plátce, 4. část 24 35 opt Informace pro Příjemce, 1. část 25 35 opt Informace pro Příjemce, 2. část 26 35 opt Informace pro Příjemce, 3. část 27 35 opt Informace pro Příjemce, 4. část kód poplatků (SHA, OUR) 28 35 Číslo účtu Příjemce 29 35 opt Název a adresa Příjemce, 1. část 30 35 opt Název a adresa Příjemce, 2. část 31 35 opt Název a adresa Příjemce, 3. část 32 35 opt Název a adresa Příjemce, 4. část 33 35 BIC (SWIFT kód) banky Příjemce 34 35 opt Název a adresa banky Příjemce, 1. část 35 35 opt Název a adresa banky Příjemce, 2. část 36 35 opt Název a adresa banky Příjemce, 3. část 37 35 opt Název a adresa banky Příjemce, 4. část 38 35 opt BIC (SWIFT kód) korespondenční banky 39 35 opt Název a adresa korespondenční banky, 1. část 40 35 opt Název a adresa korespondenční banky, 2. část 41 35 opt Název a adresa korespondenční banky, 3. část 42 35 opt Název a adresa korespondenční banky, 4. část 43 35 BIC (SWIFT kód) banky Plátce 44 35 opt Název a adresa banky Plátce, 1. část 45 35 opt Název a adresa banky Plátce, 2. část 46 35 opt Název a adresa banky Plátce, 3. část 47 35 opt Název a adresa banky Plátce, 4. část Verse: 01032013 Strana 24 (celkem 29)