FORMÁTY SOUBORŮ PRO IMPORT A EXPORT DAT PRO HOMEBANKING PPF banky a.s

Formáty souborů pro import a export dat pro Homebanking PPF banky a.s.

FORMÁTY SOUBORŮ PRO IMPORT A EXPORT DAT PRO 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 a Tuzemské expresní hromadné příkazy .................. 2

2.

Struktura souboru pro Tuzemské hromadné příkazy k inkasu ..................................................................... 3

3.

Struktura souboru pro Vnitrobankovní hromadné cizoměnové příkazy ........................................................ 4

4.

Struktura souboru pro Zahraniční hromadné příkazy ................................................................................... 5

B. ABO formát – struktura souboru pro Tuzemské hromadné příkazy a Tuzemské hromadné příkazy k inkasu ............................................................................................................................................................................. 8 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 ........................................................................................................ 9

4.

Popis účetní položky ...................................................................................................................................... 10

5.

Příklad souboru v ABO formátu ................................................................................................................... 11

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 ............................................................................................................................... 13

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.

E.

Formát Gemini .................................................................................................................................................... 22

1.

Formát Gemini 4.1 ......................................................................................................................................... 22

2.

Formát Gemini 5 ............................................................................................................................................ 25 HTML formát ..................................................................................................................................................... 27

Verze: 27092014

Strana 1 (celkem 29) PPF banka a.s., Praha 6, Evropská 2690/17, PSČ 160 41 Česká republika, IČ 47116129, DIČ CZ47116129 Společnost zapsaná v Obchodním rejstříku vedeném městským soudem v Praze, oddíl B, vložka 1834 Tel.: (+420) 224 175 888, fax: (+420) 224 175 980


I.

Import dat – Dávka

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ýjimku tvoří: – pole obsahující alfabetické znaky, která se zarovnávají doleva – Zpráva pro Příjemce, Informace pro Banku, číslo účtu Příjemce ve formátu IBAN u Zahraničních hromadných příkazů atd., – pole BIC, které lze zarovnat doleva i doprava. 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.

Struktura souboru pro Tuzemské hromadné příkazy a Tuzemské expresní hromadné příkazy

1.

!!! POZOR !!! V Tuzemském hromadném příkazu a Tuzemském expresním hromadném příkazu (dále jen „Tuzemský hromadný příkaz“) lze zadat pouze znaky, které jsou povolené v systému CERTIS: abcdefghijklmnopqrstuvwxyzáäčďéěíľňóôöřŕšťúůüýž ABCDEFGHIJKLMNOPQRSTUVWXYZÁÄČĎÉĚÍĽŇÓÔÖŘŔŠŤÚŮÜÝŽ 0123456789 /-?:().,'+!"#$%&*;<=>@[\]^`{|}~§ mezera Pokud budou v importovaném souboru zadány nepovolené znaky, jednotlivé položky mohou být po nahrání do HB nebo po předání do ČNB odmítnuty z důvodu formálních chyb. Doporučujeme proto upravit software generující soubor s Tuzemským hromadným příkazem tak, aby nepovolené znaky vůbec neumožnil zadat nebo je při generování souboru zaměnil za vhodný znak – např. za tečku. Pozice

Délka

Formát

Popis pole

1 7

6 2

9

6

15 19 22 26

4 3 4 3

digits, lz, opt 11, opt YYMMDD, opt, digits digits, lz

29

15

digits

44

6

YYMMDD, opt, digits

50

10

digits, lz, opt

Pořadové číslo řádku. Typ zprávy – uveďte vždy hodnotu „11“. Datum vytvoření souboru – pokud je uvedeno, musí být shodné pro všechny položky v souboru. Kód Banky – uveďte vždy hodnotu „6000“. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 3 mezery. Kód banky Příjemce. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 3 mezery. Částka v CZK, desetinná místa se neoddělují čárkou a musí být vždy uvedena. Datum splatnosti. Jednotlivé položky mohou mít různá Data splatnosti. Pokud mají Datum splatnosti v minulosti nebo Datum splatnosti chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP. Konstantní symbol.

Verze: 27092014

digits, lz



Pozice

Délka

Formát

Popis pole

60 70

10 10

digits, lz, opt digits, lz, opt

80

6

digits, lz

86

10

digits, lz, opt

96 102

6 10

digits, lz digits, lz

112

140

opt

252 272

20 20

opt opt

292

10

digits, lz, opt

302

10

digits, lz, opt

312

140

opt

Variabilní symbol kreditní. Specifický symbol kreditní. Předčíslí vlastního účtu (účet Plátce) – pokud máte číslo účtu bez předčíslí, uveďte zde nuly. Číslo vlastního účtu (účet Plátce) – pokud nebude uvedeno, musí být účet vybrán při importu souboru do HB. Předčíslí účtu Příjemce. Číslo účtu Příjemce. Zpráva pro Příjemce – volný text. Zde můžete zadat popis pro potřebu Příjemce – zobrazí se rovněž ve výpisu Plátce. Název vlastního účtu (účet Plátce). Název účtu Příjemce. Variabilní symbol debetní – uveďte pouze v případě, že se liší od pole „Variabilní symbol kreditní“. Specifický symbol debetní – uveďte pouze v případě, že se liší od pole „Specifický symbol kreditní“. Informace 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 v detailu platby v HB a ve výpisu z účtu Plátce, Příjemci se nezobrazí.

Příklad (tečky v textu vyznačují mezery): 000001111410106000···6000···000000000015918······000000030800007802830000050000······285973123900000040 86318984fa 261/05 000002111410106000···6000···000000000244930······000000030800007802830000060000······285973123900000040 86318984fa 262/05 000003111410106000···6000···000000000634600······000000000830800000991380000000······285973123900000040 86318984fa 171/05 000004111410106000···6000···000000000634600······000000000830800000991380000000······285973123900000040 86318984fa 172/05

Struktura souboru pro Tuzemské hromadné příkazy k inkasu

2.

!!! POZOR !!! V Tuzemském hromadném příkazu k inkasu lze zadat pouze znaky, které jsou povolené v systému CERTIS: abcdefghijklmnopqrstuvwxyzáäčďéěíľňóôöřŕšťúůüýž ABCDEFGHIJKLMNOPQRSTUVWXYZÁÄČĎÉĚÍĽŇÓÔÖŘŔŠŤÚŮÜÝŽ 0123456789 /-?:().,'+!"#$%&*;<=>@[\]^`{|}~§ mezera Pokud budou v importovaném souboru zadány nepovolené znaky, jednotlivé položky mohou být po nahrání do IB nebo po předání do ČNB odmítnuty z důvodu formálních chyb. Doporučujeme proto upravit software generující soubor s Tuzemským hromadným příkazem k inkasu tak, aby nepovolené znaky vůbec neumožnil zadat nebo je při generování souboru zaměnil za vhodný znak – např. za tečku. Pozice

Délka

Formát

Popis pole

1 7

6 2

9

6

15 19 22 26

4 3 4 3

digits, lz, opt 32, opt YYMMDD, opt, digits digits, lz

Pořadové číslo řádku. Typ zprávy – uveďte vždy hodnotu „32“. Datum vytvoření souboru – pokud je uvedeno, musí být shodné pro všechny položky v souboru. Kód Banky – uveďte vždy hodnotu „6000“. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 3 mezery. Kód banky Plátce (inkasovaného účtu). TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 3 mezery.

Verze: 27092014

digits, lz



Pozice

Délka

Formát

29

15

digits

44

6

YYMMDD, opt, digits

50 60 70

10 10 10

digits, lz, opt digits, lz, opt digits, lz, opt

80

6

digits, lz

86

10

digits, lz, opt

96 102

6 10

digits, lz digits, lz

112

140

opt

252 272

20 20

opt opt

292

10

digits, lz, opt

302

10

digits, lz, opt

312

140

opt

Popis pole Částka v CZK, desetinná místa se neoddělují čárkou a musí být vždy uvedena. Datum splatnosti – datum, ke kterému má být odepsána (inkasována) platba z účtu Plátce. Jednotlivé položky mohou mít různá Data splatnosti, Datum splatnosti však nesmí být v minulosti. Konstantní symbol. Variabilní symbol kreditní. Specifický symbol kreditní. Předčíslí vlastního účtu (účet Příjemce) – pokud máte číslo účtu bez předčíslí, uveďte zde nuly. Číslo vlastního účtu (účet Příjemce) – pokud nebude uvedeno, musí být účet vybrán při importu souboru do HB. Předčíslí účtu Plátce (inkasovaného účtu). Číslo účtu Plátce (inkasovaného účtu). 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í. Název vlastního účtu (účet Příjemce). Název účtu Plátce (inkasovaného účtu). Variabilní symbol debetní – uveďte pouze v případě, že se liší od pole „Variabilní symbol kreditní“. Specifický symbol debetní – uveďte pouze v případě, že se liší od pole „Specifický symbol kreditní“. Informace 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 pouze v detailu platby v HB, Příjemci ani Plátci se do výpisu z účtu nepřenáší.

Příklad (tečky v textu vyznačují mezery): 000001321410106000···6000···000000000015918······000000030800007802830000050000······285973123900000040 86318984fa 261/05 000002321410106000···6000···000000000244930······000000030800007802830000060000······285973123900000040 86318984fa 262/05 000003321410106000···6000···000000000634600······000000000830800000991380000000······285973123900000040 86318984fa 171/05 000004321410106000···6000···000000000634600······000000000830800000991380000000······285973123900000040 86318984fa 172/05

3.

Struktura souboru pro Vnitrobankovní hromadné cizoměnové příkazy

!!! POZOR !!! Ve Vnitrobankovním cizoměnovém hromadném příkazu lze zadat pouze znaky, které jsou povolené v systému CERTIS: abcdefghijklmnopqrstuvwxyzáäčďéěíľňóôöřŕšťúůüýž ABCDEFGHIJKLMNOPQRSTUVWXYZÁÄČĎÉĚÍĽŇÓÔÖŘŔŠŤÚŮÜÝŽ 0123456789 /-?:().,'+!"#$%&*;<=>@[\]^`{|}~§ mezera Pokud budou v importovaném souboru zadány nepovolené znaky, jednotlivé položky budou po nahrání do HB odmítnuty z důvodu formálních chyb. Doporučujeme proto upravit software generující soubor s Vnitrobankovním hromadným cizoměnovým příkazem tak, aby nepovolené znaky vůbec neumožnil zadat nebo je při generování souboru zaměnil za vhodný znak – např. za tečku.

Verze: 27092014



Pozice

Délka

Formát

Popis pole

1 4

3 6

10

8

INT, opt digits, lz, opt YYYYMMDD, opt, digits

18 158 193

140 35 105

298

16

digits, lz, decpt

314 317 327

3 10 34

digits, lz

361

3

OUR

364

5

369

140

opt

509 529

20 2

opt

531

140

opt

671

11

682

6

digits, lz

688

6

YYMMDD, opt, digits

694

6

digit, lz, opt

Uveďte vždy hodnotu „INT“ označující zahraniční platbu. Pořadové číslo řádku. Datum vytvoření souboru – pokud je uvedeno, musí být shodné pro všechny položky v souboru. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 140 mezer. Název účtu Příjemce. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 105 mezer. Částka platby – pokud obsahuje desetinná místa, je nutné je oddělit desetinnou čárkou nebo tečkou. Měna – ISO kód. Číslo vlastního účtu (účet Plátce). Číslo účtu Příjemce – může být uvedeno pouze v národním formátu. Označení typu poplatků – uveďte vždy OUR (poplatek za Vnitrobankovní cizoměnový příkaz hradí vždy Plátce). TYTO PZICE SE NEPOUŽÍVAJÍ, uveďte zde 5 mezer. Zpráva pro Příjemce – volný text. Zde můžete zadat popis pro potřebu Příjemce. Název vlastního účtu (účtu Plátce). TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 2 mezery. Zpráva pro Banku – volný text. Zde lze zadat informace pro další zpracování jednotlivé položky Vnitrobankovního cizoměnového hromadného příkazu v Bance individuální podmínky sjednané s Bankou pro konkrétní Platební příkaz (např. individuální kurz). TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 11 mezer. Předčíslí čísla vlastního účtu (účet Plátce) – pokud máte číslo účtu bez předčíslí, uveďte zde nuly. Datum splatnosti. Jednotlivé položky mohou mít různá Data splatnosti. Pokud mají Datum splatnosti v minulosti nebo Datum splatnosti chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP. Předčíslí čísla účtu Příjemce

Příklad (tečky v textu vyznačují mezery): INT00000220141010············································································································································Janko·H rasko·U·namesti·20·Presov·250·00·Slovakia····························································································0000000000124, 65EUR2586740304··········SK3302000000000000012351SHA···SKfaktura·56/2014·z·5.10.2014······································ ···························································································································································································· ·················································PMBASKXXXXX······141013

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: abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 /-?:().,'+ mezera Jednotlivé části textových polí se do SWIFTové zprávy přenáší jako samostatný řádek, proto je nutné vyplňovat údaje postupně část po části (tj. není možné zadat údaje do první části a pak až do třetí části). Zároveň na vybraných pozicích nesmí být uvedena mezera, pomlčka nebo dvojtečka (tyto pozice se do řádků SWIFTové zprávy přenesou jako první znaky a dle standardů pro SWIFTové zprávy nemohou být tyto znaky na první pozici řádku uvedeny).

Verze: 27092014



Doporučujeme proto upravit software generující soubor se Zahraničním hromadným příkazem tak, aby nepovolené znaky (resp. vybrané znaky na určitých pozicích) vůbec neumožnil zadat nebo je při generování souboru zaměnil za vhodný znak – např. za tečku. Pokud budou v importovaném souboru zadány:  nepovolené znaky (tj. jiné znaky, než jsou uvedeny výše), budou nahrazeny tečkou;  mezera, pomlčka nebo dvojtečka na specifických pozicích (viz popis níže), jednotlivé položky budou po nahrání do HB odmítnuty z důvodu formálních chyb. Pozice

Délka

Formát

1 4

3 6

10

8

18

140

INT, opt digits, lz, opt YYYYMMDD, opt, digits opt

158

35

193

35

228

35

263

35

298

16

314 317

3 10

327

34

361

3

364

3

367

2

369

35

404

35

439

35

474

35

509

22

Verze: 27092014

Popis pole

Uveďte vždy hodnotu „INT“ označující zahraniční platbu. Pořadové číslo řádku. Datum vytvoření souboru – pokud je uvedeno, musí být shodné pro všechny položky v souboru. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 140 mezer. Název a adresa Příjemce, 1. část – volný text. Na pozici 158 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Název a adresa Příjemce, 2. část – volný text. opt Na pozici 193 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Název a adresa Příjemce, 3. část – volný text. opt Na pozici 228 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Název a adresa Příjemce, 4. část – volný text. opt Na pozici 263 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Částka platby – pokud obsahuje desetinná místa, je nutné je oddělit digits, lz, decpt desetinnou čárkou nebo tečkou. Měna – ISO kód. digits, lz Číslo vlastního účtu (účet Plátce). Číslo účtu Příjemce. Pokud se jedná o Platební transakci do zemí EU/EHP a o SEPA Platební lz transakce (včetně plateb do jiných bank v ČR), musí být uvedeno ve formátu IBAN. Označení typu poplatků (SHA, OUR). Pokud se jedná o Platební transakci do zemí EU/EHP v EUR a o SEPA OUR, SHA 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. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 3 mezery. 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). Musí být shodný s 5 a 6 pozicí z BIC (SWIFT) banky Příjemce (např. BIC: PMBPCZPP, kód země: CZ). Zpráva pro Příjemce, 1. část – volný text. opt Zde můžete zadat popis pro potřebu Příjemce. Na pozici 369 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Zpráva pro Příjemce, 2. část – volný text. opt Na pozici 404 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Zpráva pro Příjemce, 3. část – volný text. opt Na pozici 439 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Zpráva pro Příjemce, 4. část – volný text. opt Na pozici 474 nesmí být uvedena mezera, pomlčka nebo dvojtečka. opt TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 22 mezer.



Pozice

Délka

Formát

531

30

opt

561

33

opt

594

33

opt

627

33

opt

660 671

11 11

682

6

digits, lz

688

6

YYMMDD, opt, digits

694

33

opt

727

33

opt

760

11

opt

771

70

opt

Popis pole Informace pro Banku, 1. část – volný text. Zde lze zadat informace pro další zpracování jednotlivé položky Zahraniční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). Na pozici 531 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Informace pro Banku, 2. část – volný text. Na pozici 561 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Informace pro Banku, 3. část – volný text. Na pozici 594 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Informace pro Banku, 4. část – volný text. Na pozici 627 nesmí být uvedena mezera, pomlčka nebo dvojtečka. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 11 mezer. BIC (SWIFT kód) banky Příjemce. Předčíslí čísla vlastního účtu (účet Plátce) – pokud máte číslo účtu bez předčíslí, uveďte zde nuly. Datum splatnosti. Jednotlivé položky mohou mít různá Data splatnosti. Pokud mají Datum splatnosti v minulosti nebo Datum splatnosti chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP. Informace pro Banku, 5. část – volný text. Na pozici 694 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Informace pro Banku, 6. část – volný text. Na pozici 727 nesmí být uvedena mezera, pomlčka nebo dvojtečka. BIC (SWIFT kód) korespondentské banky. Tento údaj uvádějte pouze v případě, že požadujete Platební příkaz zaslat (trasovat) bance Příjemce prostřednictvím konkrétní banky. Informace pro Plátce – volný text. Toto pole můžete využít pro upřesňující údaje, které požadujete mít u platby uvedené pro svoji potřebu – údaj se zobrazí pouze v detailu platby v HB, Příjemci ani Plátci se do výpisu z účtu nepřenáší.

Příklad (tečky v textu vyznačují mezery): INT00000120141010············································································································································Firma·G MBH·Rathausplatz·15·Berlin·D·12345·Germany···························································································0000000000 251,24EUR2345678909············DE87478615189963590000SHA···DEInvoice·No.3658/2014········································ ·······································································································expresni·platba·s·dohodnutym·kurzem·26.542············· ·····················································································PMBADEXXXXX······141010······················································· ···········DEUTDEFF123 INT00000220141010············································································································································Janko·H rasko·U·namesti·20·Presov·250·00·Slovakia····························································································0000000000124, 65EUR2586740304··········SK3302000000000000012351SHA···SKfaktura·56/2014·z·5.10.2014······································ ···························································································································································································· ·················································PMBASKXXXXX······141013

Verze: 27092014



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: abcdefghijklmnopqrstuvwxyzáäčďéěíľňóôöřŕšťúůüýž ABCDEFGHIJKLMNOPQRSTUVWXYZÁÄČĎÉĚÍĽŇÓÔÖŘŔŠŤÚŮÜÝŽ 0123456789 /-?:().,'+!"#$%&*;<=>@[\]^`{|}~§ mezera Pokud budou v importovaném souboru zadány nepovolené znaky, jednotlivé položky mohou být po nahrání do HB nebo po předání do ČNB odmítnuty z důvodu formálních chyb. Doporučujeme proto upravit software generující soubor s Tuzemským hromadným příkazem a s Tuzemským hromadným příkazem k inkasu tak, aby nepovolené znaky vůbec neumožnil zadat nebo je při generování souboru zaměnil za vhodný znak – např. za tečku. Pokud není v popisu jednotlivých polí uvedeno jinak, jsou všechna pole povinná. Tuzemský hromadný příkaz a Tuzemský hromadný příkaz k inkasu musí být vždy importovány v samostatném souboru.

Popis záznamu UHL1

1. Poř. č.

Délka min. max.

1.

4

4

2.

6

6

3.

20

20

4. 5. 6. 7. 8.

10 3 3 6 6

10 3 3 6 6

Formát

Popis pole

UHL1

Typ zprávy – uveďte vždy hodnotu „UHL1“. Datum vytvoření účetního souboru – nemá žádný vztah ke DDMMRR splatnosti jednotlivých položek obsažených v datovém souboru, označuje jeho vytvoření. 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 @. 1234567890 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu „1234567890“. 001 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu „001“. 999 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu „999“. 111111 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu „111111“. 222222 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu „222222“.

Popis hlavičky a konce účetního souboru

2.

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.

Hlavička účetního souboru

a) Poř. č. 1. 2.

Délka min. max. 1 1

Verze: 27092014

1 1

Formát 1 mezera

Popis pole Typ zprávy – uveďte vždy hodnotu „1“. Oddělovač pole – zadejte vždy mezeru.



Poř. č.

Délka min. max.

Formát

3.

4

4

NNNN

4. 5. 6. 7.

1 6 1 4

1 6 1 4

mezera 111111 mezera 6000

Popis pole 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. Oddělovač pole – zadejte vždy mezeru. TOTO POLE SE NEPOUŽÍVÁ, uveďte zde hodnotu „111111“. Oddělovač pole – zadejte vždy mezeru. Kód PPF banky a.s.

Konec účetního souboru

b) Poř. č. 1. 2. 3.

Délka min. max. 1 1 1

1 1 1

Formát 5 mezera +

Popis pole Typ zprávy – uveďte vždy hodnotu „5“. Oddělovač pole – zadejte vždy mezeru. Uveďte vždy znak „+“.

Popis hlavičky a konce skupiny položek

3.

Úč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.

Hlavička skupiny položek

a) Poř. č.

Délka min. max.

1. 2.

1 1

1 1

3.

2

17

4.

1

1

5.

1

14

6.

1

1

7.

6

6

Formát

Popis pole

2 mezera

Typ zprávy – uveďte vždy hodnotu „2“. Oddělovač pole – zadejte vždy mezeru. Čí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; NNNNNN pokud je kratší než 16 znaků (6 znaků předčíslí a 10 znaků NNNNNNNNNN čí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. mezera Oddělovač pole – zadejte vždy mezeru. Celková částka položek ve skupině uvedená v CZK, musí se rovnat NNNNNNNNNNNNN součtu částek jednotlivých položek ve skupině. Desetinná místa se N neoddělují čárkou a musí být vždy uvedena. mezera Oddělovač pole – zadejte vždy mezeru. Datum splatnosti – je společné pro všechny položky ve skupině a DDMMRR nesmí být v minulosti.

Konec skupiny položek

b) Poř. č. 1. 2. 3.

Délka min. max. 1 1 1

Verze: 27092014

1 1 1

Formát 3 mezera +

Popis pole Typ zprávy – uveďte vždy hodnotu „3“. Oddělovač pole – zadejte vždy mezeru. 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

2.

1

1

3.

1

12

4. 5. 6. 7. 8. 9. 10. 11.

1 1 1 4 4 1 0 1

1 10 1 4 4 1 10 1

12.

0

146

Formát

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 NNNNNNoddělovačem předčíslí i za ním doplněno zleva nulami (např. NNNNNNNNNN· 000000-0123456789), minimálně musí být zadány dvě číslice zprava. mezera Oddělovač pole – zadejte vždy mezeru. Částka jednotlivé položky v CZK, desetinná místa se neoddělují NNNNNNNNNNNN čárkou a musí být vždy uvedena. mezera Oddělovač pole – zadejte vždy mezeru. NNNNNNNNNN Variabilní symbol – pokud není uveden, doplňte zde jednu nulu. mezera Oddělovač pole – zadejte vždy mezeru. NNNN Konstantní symbol – pokud není uveden, doplňte zde čtyři nuly. NNNN Kód banky Příjemce. mezera Oddělovač pole – zadejte vždy mezeru. NNNNNNNNNN Specifický symbol – nepovinný údaj. mezera Oddělovač pole – zadejte vždy mezeru. 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í. AV: AV1|AV2|AV3|AV4 AV pole se skládá ze 4 podpolí, každé po 35 znacích, jednotlivá podpole odděluje znak „|“. V případě použití jen části podpole není nutné další zbývající prázdná podpole uvádět.

Položka Tuzemského hromadného příkazu k inkasu

b) Poř. č.

Délka min. max.

1.

2

17

2.

1

1

3.

1

12

4. 5. 6. 7. 8. 9. 10. 11.

1 1 1 4 4 1 0 1

1 10 1 4 4 1 10 1

12.

0

146

Verze: 27092014

Formát

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 NNNNNNoddělovačem předčíslí i za ním doplněno zleva nulami (např. NNNNNNNNNN· 000000-0123456789), minimálně musí být zadány dvě číslice zprava. mezera Oddělovač pole – zadejte vždy mezeru. Částka jednotlivé položky v CZK, desetinná místa se neoddělují NNNNNNNNNNNN čárkou a musí být vždy uvedena. mezera Oddělovač pole – zadejte vždy mezeru. NNNNNNNNNN Variabilní symbol – pokud není uveden, doplňte zde jednu nulu. mezera Oddělovač pole – zadejte vždy mezeru. NNNN Konstantní symbol – pokud není uveden, doplňte zde čtyři nuly. NNNNNN Směrový kód banky Plátce. mezera Oddělovač pole – zadejte vždy mezeru. NNNNNNNNNN Specifický symbol – nepovinný údaj. mezera Oddělovač pole – zadejte vždy mezeru. 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í. AV: AV1|AV2|AV3|AV4 AV pole se skládá ze 4 podpolí, každé po 35 znacích, jednotlivá podpole odděluje znak „|“. V případě použití jen části podpole není nutné další zbývající prázdná podpole uvádět.



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·+

II.

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. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11 12 13 14 15 16 17. 18. 19. 20. 21. 22.

Nepoužívá se Jméno banky – PPF banka a.s. Alfabetický kód PPF banky a.s. – vždy „PMBA“ Variabilní symbol Popis položky 1 Specifický symbol Interní reference Banky Období – údaj o roku ve tvaru RRRR Popis položky 2 Platební titul, pokud je uveden Měna položky Reference položky z elektronických kanálů Popis položky 3 Měna poplatků Popis položky 4 Zůstatek po realizaci příslušné položky Kód typu položky ID textu typu účtu Název vlastního účtu Částka položky Číslo vlastního účtu Číslo vlastního účtu v clearingovém formátu

Verze: 27092014



Pořadí

Obsah pole

23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34.

Datum zúčtování Nepoužívá se Měna vlastního účtu Název účtu protistrany Banka účtu protistrany Nepoužívá se Nepoužívá se ID typu účtu – vždy 1 Běžný účet Kód země Číslo účtu protistrany Datum valuty Indikátor zrušení Indikátor typu položky: DR – debet na účtu CR – kredit na účtu Datum valuty protistrany Nepoužívá se Kurz položky Částka platby v měně položky Kód typu účtu Reference Klienta Text typu účtu Konstantní symbol Poplatky ID typu obratu Číslo položky v rámci dne zúčtování Číslo výpisu z HB, na kterém se položka vyskytuje Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Rozšířené informace k položce

35. 36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52.

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.

Verze: 27092014



1.

Formát oficiálního výpisu

Struktura souboru: Jméno XML Elementu

Format

Popis

Official BankID BankCode BankCountryID BankName AccNoID AccNoCC AccName AccCcy AccCcyText AccTypeID AccTypeCode AccTypeText Period StatemNo StatemDate StatemStartBalance StatemEndBalance StatemOpeningDate StatemClosingDate StatemDebitTotal StatemCreditTotal StatemTransactionCount StatemDebitCount StatemCreditCount StatemClosed ItemNo Amount

bool int varchar(8) varchar(2) varchar(50) varchar(34) varchar(34) varchar(50) char(3) varchar(255) int varchar(8) varchar(255) int int date double double date date double double int int int bool int double

Direction

varchar(1)

PostingDate MovementTypeID MovementTypeCode PartnerAccNo PartnerAccBank PartnerAccName ValueDate PartnerValueDate PayAmount PayCcy

date int varchar(8) varchar(35) varchar(35) varchar(35) date date double varchar(3)

ExcRate

double

ChargesAmount ChargesCcy Balance CancelIndicator GeminiRef BankRef ClientRef

double varchar(3) double bool varchar(32) varchar(50) varchar(50)

Vždy Y – oficiální výběr ID Banky v klientské databázi Gemini Alfa kód Banky (Gemini) Zkratka clearingu Banky Jméno Banky Číslo vlastního účtu ve tvaru klíče Číslo vlastního účtu v clearingovém formátu Jméno vlastního účtu Měna vlastního účtu Popis měny vlastního účtu Typ vlastního účtu Kód typu vlastního účtu Popis typu vlastního účtu Časové období, pro které byl vydán výpis Číslo výpisu Datum vystavení výpisu Počáteční účetní zůstatek výpisu Konečný zůstatek výpisu Počáteční datum období, které výpis postihuje Konečné datum období, které výpis postihuje Součet částek exportovaných debetních položek Součet částek exportovaných kreditních položek Počet exportovaných Platebních transakcí Počet exportovaných debetních položek Počet exportovaných kreditních položek Informace, zda je daný výpis uzavřený Číslo položky tak, jak je předáno z Banky Částka položky v měně účtu Směr obratu: D – debet na účtu, C – kredit na účtu, N – odmítnutá položky Datum odeslání Typ obratu Kód obratu Číslo účtu protistrany Banka protistrany Jméno účtu protistrany Datum valuty Datum valuty na účtu protistrany Částka v měně položky Měna položky Kurs použitý pro přepočet měny položky na měnu účtu Částka poplatků Měna poplatků Zůstatek na účtu po realizaci položky (je-li znám) Příznak, zda jde o storno Reference Gemini Reference Banky Reference Klienta

Verze: 27092014

Poznámka Nepoužívá se

Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá

se se se se se se se

Nepoužívá se Nepoužívá se



Jméno XML Elementu

Format

Popis

MovementTypeText Statistics1 Statistics2 Statistics3 Statistics4 Description1 Description2 Description3 Description4 Description5 Description6 Description7 Description8 Info01 Info02 Info03 Info04 Info05 Info06 Info07 Info08 Info09 Info10 Info11 Info12 Info13 Info14 Info15 Info16 Info17 Info18 Info19 Info20 Extensions

varchar(255) varchar(10) varchar(10) varchar(10) varchar(10) varchar(35) varchar(35) varchar(35) varchar(35) varchar(35) varchar(35) varchar(35) varchar(35) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(255)

Popis typu obratu Údaj pro statistiku (obvykle Údaj pro statistiku (obvykle Údaj pro statistiku (obvykle Údaj pro statistiku (obvykle Popis položky Popis položky Popis položky Popis položky Popis položky Popis položky Popis položky Popis položky Další doprovodné informace

IncomingDocID

int

Poznámka konstantní symbol) variabilní symbol) specifický symbol) platební titul)

k položce 1 .. 20

Rozšířené informace k položce Číslo příchozího dokumentu v klientské databázi Gemini

Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá

se se se se se se se se se se se se se se se se se se se se

Nepoužívá se

Příklad:


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' Direction='D' PostingDate='20100618' MovementTypeID='6' MovementTypeCode='DOM_OP11'> <PartnerAccNo>9999999999 <PartnerAccBank>6000 <PartnerAccName> 20100618 <PartnerValueDate> <PayAmount> <PayCcy> <ExcRate> 20 062,72 0 301.7.55851.1 20100618:0000003271:BO100618GE320438 <MovementTypeText>Odchozí domácí platba <Statistics1>0000000000 <Statistics2>0000000000 <Statistics3>0000000000 <Statistics4> ahoj priemcce. řádek čárka ahoj priemcce. řádek čárka <Extensions>DOM-AVIZO: ahoj priemcce. řádek čárka <Movement ItemNo='2' Amount='11,00' Direction='D' PostingDate='20100618' MovementTypeID='1' MovementTypeCode='DOM'> <PartnerAccNo>10328018 <PartnerAccBank>5500 <PartnerAccName> 20100618 Verze: 27092014



<PartnerValueDate> <PayAmount> <PayCcy> <ExcRate> 200,00 CZK 20 051,72 0 20100618:0000003272:BO100618MN320423 <MovementTypeText>Domácí platba <Statistics1>0000000000 <Statistics2>0000000000 <Statistics3>0000000000 <Statistics4> <Extensions> <Movement ItemNo='3' Amount='20,00' Direction='D' PostingDate='20100618' MovementTypeID='6' MovementTypeCode='DOM_OP11'> <PartnerAccNo>123123123 <PartnerAccBank>6000 <PartnerAccName> 20100618 <PartnerValueDate> <PayAmount> <PayCcy> <ExcRate> 2 035,30 0 301.7.55852.1 20100618:0000003274:BO100618GE320439 <MovementTypeText>Odchozí domácí platba <Statistics1>0000000000 <Statistics2>0000000000 <Statistics3>0000000000 <Statistics4> Verze: 27092014



<Extensions>

2.

Formát vlastního výběru položek

Struktura souboru: Jméno XML Elementu

Format

Popis

Official StatemDebitTotal StatemCreditTotal StatemTransactionCount StatemDebitCount StatemCreditCount StatemClosed ItemNo Amount

bool double double int int int bool int double

Direction

varchar(1)

PostingDate MovementTypeID MovementTypeCode PartnerAccNo PartnerAccBank PartnerAccName ValueDate PartnerValueDate PayAmount PayCcy

date int varchar(8) varchar(35) varchar(35) varchar(35) date date double varchar(3)

ExcRate

double

ChargesAmount ChargesCcy

double varchar(3)

Balance

double

CancelIndicator GeminiRef BankRef ClientRef MovementTypeText BankID BankCode BankCountryID BankName AccNoID AccNoCC AccName AccCcy AccCcyText AccTypeID AccTypeCode AccTypeText Period

bool varchar(32) varchar(50) varchar(50) varchar(255) int varchar(8) varchar(2) varchar(50) varchar(34) varchar(34) varchar(50) char(3) varchar(255) int varchar(8) varchar(255) int

Vždy N – vlastní výběr Součet částek exportovaných debetních položek Součet částek exportovaných kreditních položek Počet exportovaných Platebních transakcí Počet exportovaných debetních položek Počet exportovaných kreditních položek Informace, zda je daný výpis uzavřený Číslo položky tak, jak je předáno z banky Částka položky v měně účtu Směr obratu: D – debet na účtu, C – kredit na účtu, N – odmítnutá položka Datum odeslání Typ obratu Kód obratu Číslo účtu protistrany Banka protistrany Jméno účtu protistrany Datum valuty Datum valuty na účtu protistrany Částka v měně položky Měna položky Kurs použitý pro přepočet měny položky na měnu účtu Poplatky Měna poplatků Zůstatek na účtu po realizaci položky (je-li znám) Příznak, zda jde o storno Reference Gemini Reference Banky Reference Klienta Popis typu obratu ID Banky v klientské databázi Gemini Alfa kód Banky (Gemini) Zkratka clearingu Banky Jméno Banky Číslo vlastního účtu ve tvaru klíče Číslo vlastního účtu v clearingovém formátu Jméno vlastního účtu Měna vlastního účtu Popis měny vlastního účtu Typ vlastního účtu Kód typu vlastního účtu Popis typu vlastního účtu Časové období, pro které byl vydán výpis

Verze: 27092014

Poznámka

Nepoužívá se Nepoužívá se

Nepoužívá se

Nepoužívá se



Jméno XML Elementu

Format

Popis

Poznámka

StatemNo StatemDate StatemStartBalance StatemEndBalance StatemOpeningDate StatemClosingDate Statistics1 Statistics2 Statistics3 Statistics4 Description1 Description2 Description3 Description4 Description5 Description6 Description7 Description8 Info01 Info02 Info03 Info04 Info05 Info06 Info07 Info08 Info09 Info10 Info11 Info12 Info13 Info14 Info15 Info16 Info17 Info18 Info19 Info20 Extensions

Int date double double date date varchar(10) varchar(10) varchar(10) varchar(10) varchar(35) varchar(35) varchar(35) varchar(35) varchar(35) varchar(35) varchar(35) varchar(35) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(60) varchar(255)

Číslo výpisu Datum vystavení výpisu Počáteční účetní zůstatek výpisu Konečný zůstatek výpisu Počáteční datum období, které výpis postihuje Konečné datum období, které výpis postihuje Údaj pro statistiku (obvykle konstantní symbol) Údaj pro statistiku (obvykle variabilní symbol) Údaj pro statistiku (obvykle specifický symbol) Údaj pro statistiku (obvykle platební titul) Popis položky Popis položky Popis položky Popis položky Popis položky Popis položky Popis položky Popis položky Další doprovodné informace k položce 1 .. 20

Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá

se se se se se se

Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá Nepoužívá

se se se se se se se se se se se se se se se se se se se se

IncomingDocID

int

Rozšířené informace k položce Číslo příchozího dokumentu v klientské databázi Gemini

Nepoužívá se

Příklad: <Movement ItemNo='1' Verze: 27092014



Amount='10,00' Direction='D' PostingDate='20100618' MovementTypeID='6' MovementTypeCode='DOM_OP11'> <PartnerAccNo>9999999999 <PartnerAccBank>6000 <PartnerAccName> 20100618 <PartnerValueDate> <PayAmount> <PayCcy> <ExcRate> 20 062,72 0 301.7.55851.1 20100618:0000003271:BO100618GE320438 <MovementTypeText>Odchozí domácí platba 6000 CZ PPF banka a.s. 123123123 000000 0123123123/6000 BU Klient 1 CZK Koruna česká 1 001 Běžný účet <Statistics1>0000000000 <Statistics2>0000000000 <Statistics3>0000000000 <Statistics4> ahoj priemcce. řádek čárka ahoj priemcce. řádek čárka <Extensions>DOM-AVIZO: ahoj priemcce. řádek čárka <Movement ItemNo='2' Amount='11,00' Direction='D' PostingDate='20100618' MovementTypeID='1' MovementTypeCode='DOM'> <PartnerAccNo>10328018 <PartnerAccBank>5500 <PartnerAccName> 20100618 <PartnerValueDate> <PayAmount> <PayCcy> Verze: 27092014



<ExcRate> 200,00 CZK 20 051,72 0 20100618:0000003272:BO100618MN320423 <MovementTypeText>Domácí platba 6000 CZ PPF banka a.s. 123123123 000000 0123123123/6000 BU Klient 1 CZK Koruna česká 1 001 Běžný účet <Statistics1>0000000000 <Statistics2>0000000000 <Statistics3>0000000000 <Statistics4> <Extensions>

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.

Popis záznamu „Výpis z účtu“

1.

Poř. č.

Délka

Formát

1.

3

2.

16

3.

20

4.

6

074 NNNNNNNNNNNNNN NN NNNNNNNNNNNNNN NNNNNN DDMMRR

5.

14

NNNNNNNNNNNNNN

Verze: 27092014

Popis pole Typ záznamu – vždy „074“ Číslo vlastního účtu Zkrácený název Klienta Datum starého zůstatku Částka starého zůstatku – desetinná místa se neoddělují čárkou a jsou vždy uvedena.



Poř. č.

Délka

Formát

6.

1

+/-

7.

14

NNNNNNNNNNNNNN

8.

1

+/-

9.

14

NNNNNNNNNNNNNN

10.

1

0/-

11.

14

NNNNNNNNNNNNNN

12.

1

0/-

13. 14.

3 6

NNN DDMMRR

15.

14

mezera

Popis pole Znaménko starého zůstatku – vždy je uvedeno buď „+“ (plus = kladný zůstatek – kredit) nebo „-“ (mínus = záporný zůstatek – debet) Částka nového zůstatku – desetinná místa se neoddělují čárkou a jsou vždy uvedena. Znaménko nového zůstatku – vždy je uvedeno buď „+“ (plus = kladný zůstatek – kredit) nebo „-“ (mínus = záporný zůstatek – debet) Celková částka debetních obratů (MD) Znaménko debetních obratů (MD) – nula nebo v případě převážení storna znak „-„ (mínus) Celková částka kreditních obratů (D) Znaménko kreditních obratů (MD) – nula nebo v případě převážení storna znak „-„ (mínus) Pořadové číslo výpisu Datum vytvoření výpisu 14 znaků „mezera“ z důvodu sjednocení délky záznamů typu 074 a 075.

Popis záznamu „Platební transakce v CZK“

2.

Poř. č.

Délka

Formát

1.

3

2.

16

3.

16

4.

13

075 NNNNNNNNNNNNNN NN NNNNNNNNNNNNNN NN NNNNNNNNNNNNN

5.

12

NNNNNNNNNNNN

6.

1

N

7.

10

NNNNNNNNNN

8.

10

NNNNNNNNNN

9.

10

NNNNNNNNNN

10.

6

DDMMRR

11.

20

12.

1

NNNNNNNNNNNNNN NNNNNN N

13.

4

rmoo

14.

6

DDMMRR

Verze: 27092014

Popis pole Typ záznamu – vždy „075“ Číslo vlastního účtu Číslo účtu protistrany (účtu Příjemce u odchozí platby nebo účtu Plátce u příchozí platby) Nepoužívá se – uvedeny nuly Částka – desetinná místa se neoddělují čárkou a jsou vždy uvedena. 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 Variabilní symbol 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. Specifický symbol Datum valuty – datum, od kterého je položka zahrnuta do zůstatku účtu pro výpočet úroků Zkrácený název účtu protistrany, popř. doplňující údaj. Nepoužívá se – uvedena nula 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 Datum splatnosti/připsání



Popis záznamu „Podpole AV1 – AV2“

3.

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

1. 2. 3.

3 35 35

078 NNNNNNNNN…N NNNNNNNNN…N

Popis pole Typ záznamu – vždy „078“ Pole AV1 Pole AV2

Popis záznamu „Podpole AV3 – AV4“

4.

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

1. 2. 3.

3 35 35

079 NNNNNNNNN…N NNNNNNNNN…N

Popis pole Typ záznamu – vždy „079“ Pole AV3 Pole AV4

Příklad souboru v ABO formátu

5.

(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

1 36 39 44 49 57 65

35 3 5 5 8 8 8

YYYYMMDD YYYYMMDD YYYYMMDD

73

2

C,D

75

15

decpt

Verze: 27092014

Formát

Popis pole Číslo vlastního účtu ISO kód měny vlastního účtu Pořadové číslo položky ve výpisu Pořadové číslo elektronického výpisu Gemini Datum výpisu Datum zpracování Datum zúčtování Směr položky: C = kreditní položka, D = debetní položka Částka Platební transakce



Pozice

Délka

Formát

Popis pole

90 105 106 110

15 1 4 16

decpt

126

16

142

34

Zůstatek na účtu po realizaci této Platební transakci Nepoužívá se – uvedena mezera Typ položky – vždy „NMSC“ Nepoužívá se – uvedeno „NONREF“ 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.). Detaily 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 – bude se od pozice 176 pokračovat tabulkou „Tuzemská Platební transakce“ (viz bod b). 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.

NMSC NONREF

Delimited subfields

176

Tuzemská Platební transakce

b)

Pořadové Maximální číslo délka

Formát

1

1

2 3 4 5 6

2 7 7 7 10

7

16

8

20

9

16

10 11 12

20 10 10

opt opt

13

140

opt

14 15 16 17

140 10 10 140

opt opt opt opt

Verze: 27092014

Popis pole I = příchozí Platební transakce O = odchozí Platební transakce Nepoužívá se Kód banky Plátce Kód banky Příjemce Nepoužívá se Konstantní symbol Čí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 Název účtu Plátce Čí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 Název účtu Příjemce Specifický symbol kreditní Specifický symbol debetní Pokud pole „Detaily“ obsahuje hodnotu „//“, obsahuje toto pole detaily o Platební transakci provedené platební kartou, oddělené znakem“/“. Doplňující informace Variabilní symbol kreditní Variabilní symbol debetní AV pole



Zahraniční Platební transakce

c)

Pořadové Maximální číslo délka 1 2 3

15 6 14

4

3

5

17

6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47

3 15 15 15 15 15 15 15 15 15 15 16 15 15 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35

Verze: 27092014

Formát YYMMDD decpt

decpt

decpt decpt opt

opt opt opt opt opt opt opt opt opt opt opt opt opt Opt opt opt opt opt opt opt opt opt opt opt

Popis pole Interní reference Banky Datum provedení Platební transakce Použitý kurz Měna Platební transakce – pole obsahuje měnu uvedenou na Platebním příkazu, u Vnitrobankovního cizoměnového příkazu pole 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 Měna poplatků Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Ekvivalentní částka v měně účtu Klienta Celková částka poplatků Účet pro poplatky Nepoužívá se Nepoužívá se Název a adresa Plátce, 1. část (může obsahovat číslo účtu Plátce) Název a adresa Plátce, 2. část Název a adresa Plátce, 3. část Název a adresa Plátce, 4. část Informace pro Příjemce, 1. část Informace pro Příjemce, 2. část Informace pro Příjemce, 3. část Informace pro Příjemce, 4. část – kód poplatků (SHA, OUR) Číslo účtu Příjemce Název a adresa Příjemce, 1. část Název a adresa Příjemce, 2. část Název a adresa Příjemce, 3. část Název a adresa Příjemce, 4. část BIC (SWIFT kód) banky Příjemce Název a adresa banky Příjemce, 1. část Název a adresa banky Příjemce, 2. část Název a adresa banky Příjemce, 3. část Název a adresa banky Příjemce, 4. část BIC (SWIFT kód) korespondentské banky Název a adresa korespondentské banky, 1. část Název a adresa korespondentské banky, 2. část Název a adresa korespondentské banky, 3. část Název a adresa korespondentské banky, 4. část BIC (SWIFT kód) banky Plátce Název a adresa banky Plátce, 1. část Název a adresa banky Plátce, 2. část Název a adresa banky Plátce, 3. část Název a adresa banky Plátce, 4. část



Příklad

d)

123456789 CZK 5 5201302012013020120130201C 000000123456,00000001123456,00·NMSCNONREFI-GE-CC I 01006000 8123456789TESTOVACÍ KLIENT SRO123456789TESTOVACÍ KLIENT SRO659877faktury za leden 2013

2.

Formát Gemini 5

a)

Export Platebních transakcí z účtu

Pozice

Délka

1 36 39 44 49 57 65

35 3 5 5 8 8 8

YYYYMMDD YYYYMMDD YYYYMMDD

73

2

C,D

75 90 105 106 110

15 15 1 4 16

decpt decpt opt

126

16

142

34

Delimited subfields

176

b)

Formát

Popis pole Číslo vlastního účtu ISO kód vlastního měny účtu Nepoužívá se Pořadové číslo elektronického výpisu Gemini Datum výpisu Datum zpracování Datum zúčtování Směr položky: C = kreditní položka, D = debetní položka Částka Platební transakce Zůstatek na účtu po realizaci této Platební transakci Nepoužívá se – uvedena mezera Typ položky – vždy „NMSC“ Nepoužívá se – uvedeno „NONREF“ 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.). Detaily Informační pole, obsah závisí na typu transakce 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 – bude se od pozice 176 pokračovat tabulkou „Tuzemská Platební transakce“ (viz bod b).

Tuzemská platební transakce Pozice

Délka

176

1

177 179 186 193 200

2 7 7 7 10

210

16

226

20

246

16

262 282

20 10

Verze: 27092014

Formát

Popis pole

opt

I = příchozí Platební transakce O = odchozí Platební transakce Nepoužívá se Kód banky Plátce Kód banky Příjemce Nepoužívá se Konstantní symbol Čí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 Název účtu Plátce Čí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 Název účtu Příjemce Specifický symbol



c)

Pozice

Délka

Formát

292

10

302

140

opt

442 582 592 602

140 10 10 140

opt opt opt

Popis pole Nepoužívá se AV pole – informace pro Plátce/Příjemce; detaily Platební transakce v případě Platebních transakcí z platebních karet Nepoužívá se Variabilní symbol Nepoužívá se Nepoužívá se

Zahraniční platební transakce Pozice

Délka

Formát

176 191 197

15 6 14

opt YYMMDD decpt

211

3

214

17

231 234 249 264 279 294 309 324 339 354 369 384 400 415 430 465 500 535 570 605 640 675 710 745 780 815 850 885 920 955 990 1025 1060 1095 1130 1165 1200

3 15 15 15 15 15 15 15 15 15 15 16 15 15 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35 35

Verze: 27092014

decpt

decpt decpt opt

opt opt opt opt opt opt opt opt opt opt opt opt opt opt opt opt opt opt opt opt

Popis pole Interní reference Banky Datum provedení Platební transakce Použitý kurz Měna Platební transakce – pole obsahuje měnu uvedenou na Platebním příkazu, u Vnitrobankovního cizoměnového příkazu pole 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 Měna poplatků Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Ekvivalentní částka v měně účtu Klienta Celková částka poplatků Účet pro poplatky Nepoužívá se Nepoužívá se Název a adresa Plátce, 1. část (může obsahovat číslo účtu plátce) Název a adresa Plátce, 2. část Název a adresa Plátce, 3. část Název a adresa Plátce, 4. část Informace pro Příjemce, 1. část Informace pro Příjemce, 2. část Informace pro Příjemce, 3. část Informace pro Příjemce, 4. část – kód poplatků (SHA, OUR) Číslo účtu Příjemce Název a adresa Příjemce, 1. část Název a adresa Příjemce, 2. část Název a adresa Příjemce, 3. část Název a adresa Příjemce, 4. část BIC (SWIFT kód) banky Příjemce Název a adresa banky Příjemce, 1. část Název a adresa banky Příjemce, 2. část Název a adresa banky Příjemce, 3. část Název a adresa banky Příjemce, 4. část BIC (SWIFT kód) korespondentské banky Název a adresa korespondentské banky, 1. část Název a adresa korespondentské banky, 2. část Název a adresa korespondentské banky, 3. část Název a adresa korespondentské banky, 4. část



Pozice

Délka

Formát

1235 1270 1305 1340 1375

35 35 35 35 35

opt opt opt opt

d)

Popis pole BIC (SWIFT kód) banky Plátce Název a adresa banky Plátce, 1. Název a adresa banky Plátce, 2. Název a adresa banky Plátce, 3. Název a adresa banky Plátce, 4.

část část část část

Příklad

1234567890·························CZK····5····5201302012013020120130201C·000000123456,00000001123456,00·NMSC NONREFI-GE-CC ···············130201········26,495EUR··········1000,00CZK······································································································· ·························26495,00···········0,00······1234567890·······························TESTOVACI KLIENT S.R.O. ····················································································································INVOICE NO. 1/2013···················································································SHA······························TESTOVACI KLIENT S.R.O. ····················································································································PMBPCZPPXX························PPF BANKA A.S.····················PRAGUE, CZECH REPUBLIC········································································································································································· ···········································································DEUTDEFF

E.

HTML formát

Specifikace formátu:  Soubor ve formě tabulky  Jeden řádek = jedna položka z transakční historie  První řádek je hlavička Struktura souboru: Pořadí

Obsah pole

Poznámka

1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11 12 13 14 15 16 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29.

Rezervováno Jméno banky Kód banky Variabilní symbol Popis 1 Specifický symbol Reference banky Období (rok) Popis 2 Platební titul Měna platby Reference gemini Popis 3 Měna poplatků Popis 4 Zůstatek Kód typu obratu ID textu typu účtu Název účtu Částka Číslo účtu Číslo účtu a clearingu Datum splatnosti ID Banky v klientské stanici Měna účtu Název protiúčtu Banka protiúčtu Text typu pohybu ID textu typu pohybu

Nepoužívá se PPF banka a.s. Alfabetický kód PPF banky a.s. – vždy „PMBA“

Verze: 27092014

Popis položky Interní reference Banky Obsahuje údaj o roku ve tvaru RRRR Popis položky Platební titul, pokud je uveden Měna položky Reference položky z elektronických kanálů Popis položky Popis položky Zůstatek po realizaci příslušné položky Kód typu položky Název vlastního účtu Částka položky Číslo vlastního účtu Číslo vlastního účtu v clearingovém formátu Datum zúčtování Nepoužívá se Měna vlastního účtu Název účtu protistrany Banka účtu protistrany Nepoužívá se Nepoužívá se



Pořadí

Obsah pole

Poznámka

30. 31. 32. 33. 34.

ID typu účtu Kód země Číslo protiúčtu Datum valuty Cancel indikátor

Vždy 1 – Běžný účet

35.

Směr transakce

36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51.

Valuta partnera Export indikátor Kurz Částky platby Kód typu účtu Reference klienta Text typu účtu Konstantní symbol Poplatky ID typu pohybu Číslo položky Číslo výpisu Popis 5 Popis 6 Popis 7 Popis 8

52.

Rozšíření

Indikátor zrušení Indikátor typu položky: debet – debet na účtu, Kredit – kredit na účtu Datum valuty protistrany Nepoužívá se Kurz položky Částka v měně položky

Číslo položky v rámci dne zúčtování Číslo výpisu z HB, na kterém se položka vyskytuje Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Detaily k Platebním transakcím provedeným prostřednictvím platební karty

Příklad: Poznámka: Na rozdíl od příkladu jsou údaje v tabulce v reálném prostředí zobrazovány vedle sebe. Rezervováno Jméno banky Kód banky Variabilní symbol Popis 1 Specifický symbol Reference banky Období (rok) Popis 2 Platební titul Měna platby Reference gemini Popis 3 Měna poplatků Popis 4 Zůstatek Kód typu obratu ID textu typu účtu Název účtu Částka Číslo účtu Číslo účtu a clearingu Datum splatnosti ID Banky v klientské stanici Měna účtu Název protiúčtu Verze: 27092014

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



Banka protiúčtu Text typu pohybu ID textu typu pohybu ID typu účtu Kód země Číslo protiúčtu Datum valuty Cancel indikátor Směr transakce Valuta partnera Export indikátor Kurz Částky platby Kód typu účtu Reference klienta Text typu účtu Konstantní symbol Poplatky ID typu pohybu Číslo položky Číslo výpisu Popis 5 Popis 6 Popis 7 Popis 8 Rozšíření

Verze: 27092014

0100 Tuzemská transakce - odchozí standard 1013000004 1 CZ 0000002011680004 20120110 N D

0 0 001 Běžný účet 0000000000 0 6 1 3


FORMÁTY SOUBORŮ PRO IMPORT A EXPORT DAT PRO HOMEBANKING PPF banky a.s

Recommend Documents