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

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

FORMÁTY SOUBORŮ PRO IMPORT A EXPORT DAT PRO SLUŽBU HOMEBANKING PPF banky a.s. Obsah: Import dat – Dávka ..................................................................................................................................................................... 2

I.

Gemini 4.1 formát .................................................................................................................................................................. 2

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

B. 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 Export dat – transakční historie a dnešní obraty .................................................................................................................. 11

II. 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 ABO formát – export údajů o tuzemských Platebních transakcích...................................................................................... 20

C. 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 Formát Gemini ..................................................................................................................................................................... 22

D.

E.

1.

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

2.

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

Verse: 01032013

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

Struktura souboru pro Tuzemské hromadné příkazy

1.

!!! POZOR !!! V Tuzemské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 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 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 60 70

10 10 10

digits, lz digits, lz digits, lz

80

6

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“ TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 3 mezery Kód banky Příjemce TOTO POLE SE NEPOUŽÍVÁ, 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 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. Konstantní symbol Variabilní symbol kreditní Specifický symbol kreditní 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

digits, lz



Pozice

Délka

Formát

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 Čí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 – ve výpisu Plátce se tato informace nezobrazí. 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í“ 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

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

6 2

9

6

15 19 22 26

4 3 4 3

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

29

15

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“ TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 3 mezery Kód banky Plátce TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 3 mezery Částka v CZK, desetinná místa se neoddělují čárkou a musí být vždy uvedena

Verse: 01032013

digits, lz digits



Pozice

Délka

Formát

44

6

YYMMDD, opt, digits

50 60 70

10 10 10

digits, lz digits, lz digits, lz

80

6

digits, lz, opt

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 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. Konstantní symbol Variabilní symbol debetní Specifický symbol debetní 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 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 kreditní – uveďte pouze v případě, že se liší od pole „Variabilní symbol debetní“ Specifický symbol kreditní – uveďte pouze v případě, že se liší od pole „Specifický symbol debetní“ 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: abcdefghijklmnopqrstuvwxyzáäčďéěíľňóôöřŕšťúůüýž ABCDEFGHIJKLMNOPQRSTUVWXYZÁÄČĎÉĚÍĽŇÓÔÖŘŔŠŤÚŮÜÝŽ 0123456789 /-?:().,'+!"#$%&*;<=>@[\]^`{|}~§ 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



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

3 10

digits, lz

327

34

361

3

364

5

369

140

opt

509 529

20 2

opt

531

140

opt

671

11

682

6

digits, lz, opt

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 TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 140 mezer Název účtu Příjemce TOTO POLE SE NEPOUŽÍVÁ, 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 v národním formátu nebo ve formátu IBAN. Označení typu poplatků – uveďte vždy OUR (poplatek za Vnitrobankovní cizoměnový příkaz hradí vždy Plátce). TOTO POLE SE NEPOUŽÍVÁ, 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) TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 2 mezery 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). TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 11 mezer 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ř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.

OUR

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



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

4.

!!! 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 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 4

3 6

10

8

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

18

35

opt

53 88 123 158 193 228 263

35 35 35 35 35 35 35

opt opt opt

298

16

digits, lz, decpt

314 317

3 10

digits, lz

327

34

361

3

364

3

367

2

369

140

opt

509 529

20 2

opt

531

140

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 Název a adresa banky Příjemce, 1. část – povinné v případě, kdy není uveden BIC (SWIFT kód) 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 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 Čá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 – 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 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. TOTO POLE SE NEPOUŽÍVÁ, 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). 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ů. Název vlastního účtu (účtu Plátce) TOTO POLE SE NEPOUŽÍVÁ, uveďte zde 2 mezery 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

opt opt opt

OUR, SHA



Pozice

Délka

Formát

671

11

opt

682

6

digits, lz, opt

688

6

YYMMDD, opt, digits

Popis pole 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: abcdefghijklmnopqrstuvwxyzáäčďéěíľňóôöřŕšťúůüýž ABCDEFGHIJKLMNOPQRSTUVWXYZÁÄČĎÉĚÍĽŇÓÔÖŘŔŠŤÚŮÜÝŽ 0123456789 /-?:().,'+!"#$%&*;<=>@[\]^`{|}~§ 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



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

min. max.

Formát

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

1. 2.

1 1

1 1

1 mezera

3.

4

4

NNNN

4. 5. 6. 7.

1 6 1 4

1 6 1 4

mezera 111111 mezera 6000

Konec účetního souboru

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

3.

Délka

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

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



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; NNNNNNpokud 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ě. Pokud je uvedeno Datum splatnosti v minulosti nebo Datum splatnosti DDMMRR chybí, bude automaticky doplněno první možné Datum splatnosti v souladu s VOP.

Konec skupiny položek

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

Délka min. max. 1 1 1

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

Verse: 01032013

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. AV: AV1|AV2|AV3|AV4 Zde můžete zadat popis pro potřebu Příjemce – ve výpisu Plátce se tato informace nezobrazí.



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

5.

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. AV: AV1|AV2|AV3|AV4 Zde můžete zadat popis pro potřebu Plátce – ve výpisu Příjemce se tato informace nezobrazí.

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

Verse: 01032013



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. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34.

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

35.

Verse: 01032013



Pořadí

Obsah pole

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

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

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

Official BankID BankCode BankCountryID BankName AccNoID AccNoCC AccName AccCcy AccCcyText AccTypeID

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

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

Verse: 01032013

Poznámka Nepoužívá se



Jméno XML Elementu

Format

AccTypeCode AccTypeText Period StatemNo StatemDate StatemStartBalance StatemEndBalance StatemOpeningDate StatemClosingDate StatemDebitTotal StatemCreditTotal StatemTransactionCount StatemDebitCount StatemCreditCount StatemClosed ItemNo Amount

varchar(8) varchar(255) int int date double double date date double double int int int bool int double

Direction PostingDate MovementTypeID MovementTypeCode PartnerAccNo PartnerAccBank PartnerAccName ValueDate PartnerValueDate PayAmount PayCcy ExcRate ChargesAmount ChargesCcy Balance CancelIndicator GeminiRef BankRef ClientRef MovementTypeText Statistics1 Statistics2 Statistics3 Statistics4 Description1 Description2 Description3 Description4 Description5 Description6 Description7 Description8 Info01 Verse: 01032013

Popis

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, varchar(1) C – kredit na účtu, N – odmítnutá položky date Datum odeslání int Typ obratu varchar(8) Kód obratu varchar(35) Číslo účtu protistrany varchar(35) Banka protistrany varchar(35) Jméno účtu protistrany date Datum valuty date Datum valuty na účtu protistrany double Částka v měně položky varchar(3) Měna položky Kurs použitý pro přepočet měny položky na měnu double účtu double Částka poplatků varchar(3) Měna poplatků double Zůstatek na účtu po realizaci položky (je-li znám) bool Příznak, zda jde o storno varchar(32) Reference Gemini varchar(50) Reference Banky varchar(50) Reference Klienta varchar(255) Popis typu obratu varchar(10) Údaj pro statistiku (obvykle konstantní symbol) varchar(10) Údaj pro statistiku (obvykle variabilní symbol) varchar(10) Údaj pro statistiku (obvykle specifický symbol) varchar(10) Údaj pro statistiku (obvykle platební titul) varchar(35) Popis položky varchar(35) Popis položky varchar(35) Popis položky varchar(35) Popis položky varchar(35) Popis položky varchar(35) Popis položky varchar(35) Popis položky varchar(35) Popis položky varchar(60) Další doprovodné informace k položce 1 .. 20

Poznámka

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

Nepoužívá se



Jméno XML Elementu

Format

Info02 Info03 Info04 Info05 Info06 Info07 Info08 Info09 Info10 Info11 Info12 Info13 Info14 Info15 Info16 Info17 Info18 Info19 Info20 Extensions

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) Rozšířené informace k položce Číslo příchozího dokumentu v klientské databázi int Gemini

IncomingDocID

Popis

Poznámka 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

Nepoužívá se

Příklad: <Movement ItemNo='1' Amount='10,00' Verse: 01032013



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 <PartnerValueDate> <PayAmount> <PayCcy> <ExcRate> 200,00 CZK 20 051,72 0 20100618:0000003272:BO100618MN320423 <MovementTypeText>Domácí platba <Statistics1>0000000000 <Statistics2>0000000000 <Statistics3>0000000000 Verse: 01032013



<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> <Extensions>

Verse: 01032013



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 StatemNo StatemDate StatemStartBalance StatemEndBalance

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 int date double double

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 Číslo výpisu Datum vystavení výpisu Počáteční účetní zůstatek výpisu Konečný zůstatek výpisu

Verse: 01032013

Poznámka

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

Nepoužívá se

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

se se se se se



Jméno XML Elementu

Format

Popis

Poznámka

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

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)

IncomingDocID

int

Počáteční datum období, které výpis postihuje Nepoužívá se Konečné datum období, které výpis postihuje Nepoužívá se Ú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á se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Rozšířené informace k položce Číslo příchozího dokumentu v klientské Nepoužívá se databázi Gemini

Příklad: <Movement ItemNo='1' Amount='10,00' Direction='D' PostingDate='20100618' MovementTypeID='6' Verse: 01032013



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> <ExcRate> 200,00 CZK 20 051,72 Verse: 01032013



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

6.

1

+/-

Verse: 01032013

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. Znaménko starého zůstatku – vždy je uvedeno buď „+“ (plus = kladný zůstatek – kredit) nebo „-“ (mínus = záporný zůstatek – debet)



Poř. č.

Délka

Formát

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 Čá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

Verse: 01032013

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

Verse: 01032013

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

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

Verse: 01032013

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

Verse: 01032013

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) korespondenční banky Název a adresa korespondenční banky, 1. část Název a adresa korespondenční banky, 2. část Název a adresa korespondenční banky, 3. část Název a adresa korespondenční 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“; GE-FT, bude se od pozice 176 pokračovat tabulkou „Zahraniční Platební transakce“; PK-XXX – pole zůstane prázdné.

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 292

20 10 10

Verse: 01032013

Formát

opt

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 Nepoužívá se



c)

Pozice

Délka

Formát

302

140

opt

442 582 592 602

140 10 10 140

opt opt opt

Popis pole 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 1235

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

Verse: 01032013

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) korespondenční banky Název a adresa korespondenční banky, 1. část Název a adresa korespondenční banky, 2. část Název a adresa korespondenční banky, 3. část Název a adresa korespondenční banky, 4. část BIC (SWIFT kód) banky Plátce



Pozice

Délka

Formát

1270 1305 1340 1375

35 35 35 35

opt opt opt opt

d)

Popis pole Název Název Název Název

a a a a

adresa adresa adresa adresa

banky banky banky banky

Plátce, Plátce, Plátce, Plátce,

1. 2. 3. 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. 30.

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 ID typu účtu

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

Verse: 01032013

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 Vždy 1 – Běžný účet



Pořadí

Obsah pole

31. 32. 33. 34.

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

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í

Poznámka

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 Banka protiúčtu Verse: 01032013

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

0100



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í

Verse: 01032013

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 SLUŽBU HOMEBANKING PPF banky a.s

Recommend Documents