Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
FORMÁTY SOUBORŮ PRO IMPORT A EXPORT DAT PRO INTERNETBANKING PPF banky a.s.
Obsah: I.
Import dat – Dávka .................................................................................................................................................. 2 A.
CSV formát ........................................................................................................................................................... 2 1.
Struktura souboru pro Tuzemské hromadné příkazy ..................................................................................... 2
2.
Struktura souboru pro Zahraniční hromadné příkazy ................................................................................... 3
B.
II.
Gemini 4.1 formát ................................................................................................................................................ 6 1.
Struktura souboru pro Tuzemské hromadné příkazy ..................................................................................... 6
2.
Struktura souboru pro Zahraniční hromadné příkazy ................................................................................... 7 Export dat – transakční historie a dnešní obraty .............................................................................................. 9
A.
CSV formát ........................................................................................................................................................... 9
B.
XML formát ....................................................................................................................................................... 11
Verze: 27092014
Strana 1 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
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) CSV formát, nebo b) Gemini 4.1 formát. Importní soubory mohou obsahovat pouze alfanumerické znaky, jiné znaky pouze v případě, že jsou v popisu formátu výslovně uvedené.
A.
CSV formát
Specifikace formátu CSV: Textový soubor, Formát ASCII. Jeden řádek = jeden platební příkaz. První řádek je hlavička. Oddělovač "," (čárka); pokud je pole prázdné, následují po sobě dva oddělovače "," bez mezery. V souboru jsou povinná a nepovinná pole. Řádky jsou odděleny znakem LF.
1.
Struktura souboru pro Tuzemské hromadné příkazy
!!! POZOR !!! V Tuzemském hromadném příkazu lze zadat pouze znaky, které jsou povolené v systému CERTIS: abcdefghijklmnopqrstuvwxyzáäčďéěíľňóôöřŕšťúůüýž ABCDEFGHIJKLMNOPQRSTUVWXYZÁÄČĎÉĚÍĽŇÓÔÖŘŔŠŤÚŮÜÝŽ 0123456789 /-?:().,'+!"#$%&*;<=>@[\]^`{|}~§ mezera V textových polích zároveň nemůže být použita čárka (slouží jako oddělovač polí). 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. 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. Pole
DueDate
Datový typ
Povinné / Nepovinné
DD.MM.YYYY
Nepovinné
13,2N
Povinné
ClientPaymentDescription
140a
Nepovinné
CreditAccountPrefixNumber CreditAccountNumber CreditAccountBankCodeNumber
6n 10n 4n
Nepovinné Povinné Povinné
RecipientAccountName
20a
Nepovinné
ConstantSymbol VariableSymbol
4n 10n
Nepovinné Nepovinné
PaymentAmount
Verze: 27092014
Popis 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. Částka 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 ve výpisu z účtu Plátce, Příjemci se nezobrazí. V textu nesmí být použita čárka. Předčíslí čísla účtu Příjemce. Číslo účtu Příjemce. Kód banky Příjemce. Jméno účtu Příjemce – volný text. V textu nesmí být použita čárka. Konstantní symbol. Variabilní symbol.
Strana 2 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Datový typ
Povinné / Nepovinné
SpecificSymbol
10n
Nepovinné
MessageforRecipient
140a
Nepovinné
DebitAccountNumberPrefix
6n
Nepovinné
DebitAccountNumber
10n
Nepovinné
Pole
Popis Specifický symbol. Zpráva pro Příjemce – volný text. Zde můžete zadat popis platby pro potřebu Příjemce – ve výpisu Plátce se tato informace nezobrazí. V textu nesmí být použita čárka. Předčíslí čísla vlastního účtu (účet Plátce) – pokud nebude uvedeno, musí být účet vybrán při importu souboru do IB. Číslo vlastního účtu (účet Plátce) – pokud nebude uvedeno, musí být účet vybrán při importu souboru do IB.
Příklad: DueDate,PaymentAmount,ClientPaymentDescription,CreditAccountPrefixNumber,CreditAccountNumber,CreditAccou ntBankCodeNumber,RecipientAccountName,ConstantSymbol,VariableSymbol,SpecificSymbol,MessageForRecipient,De bitAccountNumberPrefix,DebitAccountNumber 10.10.2014,11111.12,uhlí,,112345678,0100,Uhelné doly s.r.o.,308,0000780283,0000000000,faktura 780283/2014,, 13.10.2014,22222.12,,,19999999,0100,,308,0098594267,,nájem,,
2.
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 V textových polích zároveň nemůže být použita čárka (slouží jako oddělovač polí) a 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). 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), soubor nebude možné importovat. Do souboru lze zadat i Vnitrobankovní cizoměnové příkazy, musí však splňovat podmínky pro Zahraniční příkazy v rámci EU/EHP, tj.: číslo účtu Příjemce musí být ve formátu IBAN, musí být uveden BIC Banky Příjemce, tj. PPF banky a.s. – PMBCZPP. Bez ohledu na zadaný typ poplatku (SHA nebo OUR) bude poplatek za Vnitrobankovní cizoměnový příkaz hradit vždy Plátce v souladu s Ceníkem Banky.
Verze: 27092014
Strana 3 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Datový typ
Povinné / Nepovinné
DebitAccountNumberPrefix
6n
Nepovinné
DebitAccountNumber
10n
Nepovinné
CreditAccountNumber
34s
Povinné
CreditCountry
2a
Povinné
RecipientSWIFTCode
11s
Povinné
140a
Povinné
140a 13.2N 3a
Nepovinné Povinné Povinné
DD.MM.YYYY
Nepovinné
MessageForRecipient
140a
Nepovinné
MessageForPayerBank
129a
Nepovinné
Pole
RecipientNameAndAddress
RecipientBankNameAndAddress PaymentAmount PaymentCurrency
PaymentDueDate
Verze: 27092014
Popis Předčíslí čísla vlastního účtu (účet Plátce) – pokud nebude uvedeno, musí být účet vybrán při importu souboru do IB. Číslo vlastního účtu (účet Plátce) – pokud nebude uvedeno, musí být účet vybrán při importu souboru do IB. Účet příjemce. Pokud se jedná o Platební transakci do zemí EU/EHP a o SEPA Platební transakci (včetně plateb do jiných bank v ČR a Vnitrobankovních cizoměnových převodů), musí být uvedeno ve formátu IBAN. 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). BIC (SWIFT kód) banky Příjemce. Název a adresa Příjemce – volný text. Přenáší se do SWIFTové zprávy jako 4 řádky po 35 znacích, doporučujeme toto zohlednit při vyplňování údajů. Na 1., 36., 71. a 106. pozici nesmí být uvedena mezera, pomlčka nebo dvojtečka a v celém textu nesmí být použita čárka. Toto pole se do IB nepřenáší – nevyplňujte jej. Částka Měna – ISO kód 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. 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ů. Na 1., 36., 71. a 106. pozici nesmí být uvedena mezera, pomlčka nebo dvojtečka a v celém textu nesmí být použita čárka. Informace pro Banku – 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).
Strana 4 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Pole
Datový typ
Povinné / Nepovinné
MessageForPayerBank
Fees
3a
Povinné
Description
70a
Nepovinné
RecipientAccountName
30a
Nepovinné
MessageForPayerBank2
66a
Nepovinné
CorrespondentSWIFTCode
11s
Nepovinné
Popis Přenáší se do SWIFTové zprávy jako 4 řádky – první řádek o 30 znacích, druhý až čtvrtý řádek po 33 znacích, doporučujeme toto zohlednit při vyplňování údajů. Na 1., 31., 64. a 97. pozici nesmí být uvedena mezera, pomlčka nebo dvojtečka a v celém textu nesmí být použita čárka. Pokud je velikost pole nedostačující, můžete pro zadání informací pro Banku využít i pole MessageForPayerBank2 (předposlední pole souboru). Označení typu poplatků (OUR, SHA). 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 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 IB, Příjemci ani do výpisu z účtu se nepřenáší. V celém textu nesmí být použita čárka. Toto pole se do IB nepřenáší – nevyplňujte jej. Pokračování pole MessageForPayerBank – volný text. Zde můžete uvést údaje, které se nevešly do prvního pole. Přenáší se do SWIFTové zprávy jako 2 řádky po 33 znacích, doporučujeme toto zohlednit při vyplňování údajů. Na 1. a 34. pozici nesmí být uvedena mezera, pomlčka nebo dvojtečka a v celém textu nesmí být použita čárka. 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.
Příklad: DebitAccountNumberPrefix,DebitAccountNumber,CreditAccountNumber,CreditCountry,RecipientSWIFTCode,Recipie ntNameAndAddress,RecipientBankNameAndAddress,PaymentAmount,PaymentCurrency,PaymentDueDate,MessageFo rRecipient,MessageForPayerBank,Fees,Description,RecipientAccountName,MessageForPayerBank2,CorrespondentSWI FTCode 19,123456789,DE87478615189963590000,DE,GENODEM1HWI,Firma GMBH Rathausplatz 15 Berlin D-12345 Germany,,25124.65,EUR,31.01.2012,Invoice No. 3658/2012,expresni platba s dohodnutym kurzem 26.542,SHA,,,, ,123456789,SK3302000000000000012351,SK,SUBASKBX,Janko Hrasko U namesti 20 Presov 250 00 Slovakia,,124.65,EUR,01.02.2012,faktura 56/2012 z 15.1.2012,,SHA,,,,
Verze: 27092014
Strana 5 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
B.
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 prázdný, nebo nebýt vyplněn, 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 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 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, 11 YYMMDD, opt, digits digits, lz
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, opt
86
10
digits, lz, opt
96 102
6 10
digits, lz digits, lz
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. 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. Pokud zde neuvedete předčíslí nebo nuly, musí být vybrán účet Plátce při importu souboru do IB. Číslo vlastního účtu (účet Plátce) – pokud nebude uvedeno, musí být účet vybrán při importu souboru do IB. Předčíslí účtu Příjemce. Číslo účtu Příjemce.
Verze: 27092014
digits, lz
Strana 6 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Pozice
Délka
Formát
112
140
opt
252 272
20 20
opt opt
292
10
digits, lz, opt
302
10
digits, lz, opt
312
140
opt
Popis pole 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 IB a 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······285973123900000040 86318984fa 172/05
2.
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). 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), soubor nebude možné importovat. Do souboru lze zadat i Vnitrobankovní cizoměnové příkazy, musí však splňovat podmínky pro Zahraniční příkazy v rámci EU/EHP, tj.: číslo účtu Příjemce musí být ve formátu IBAN, musí být uveden BIC Banky Příjemce, tj. PPF banky a.s. – PMBCZPP. Bez ohledu na zadaný typ poplatku (SHA nebo OUR) bude poplatek za Vnitrobankovní cizoměnový příkaz hradit vždy Plátce v souladu s Ceníkem Banky.
Verze: 27092014
Strana 7 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Pozice
Délka
Formát
1 4
3 6
10
8
INT digits, lz YYYYMMDD, opt, digits
18
140
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
531
30
561
33
594
33
Verze: 27092014
Popis pole
Typ zprávy – 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 – pokud obsahuje desetinná místa, je nutné je oddělit desetinnou digits, lz, decpt čá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 transakci (včetně plateb do jiných bank v ČR a Vnitrobankovních cizoměnových převodů v rámci Banky), 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. TYTO POZICE SE NEPOUŽÍVAJÍ, uveďte zde 22 mezer. 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 opt 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. opt Na pozici 561 nesmí být uvedena mezera, pomlčka nebo dvojtečka. Informace pro Banku, 3. část – volný text. opt Na pozici 594 nesmí být uvedena mezera, pomlčka nebo dvojtečka.
Strana 8 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Pozice
Délka
Formát
627
33
opt
660 671
11 11
682
6
digits, lz, opt
688
6
YYMMDD, opt, digits
694
33
opt
727
33
opt
760
11
opt
771
70
opt
Popis pole 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. Pokud zde neuvedete předčíslí nebo nuly, musí být vybrán účet Plátce při importu souboru do IB. Datum splatnosti. Jednotlivé položky mohou mít různá Data splatnosti. Pokud mají Datum splatnosti v minulosti nebo bez Data splatnosti, 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 IB, 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,24EUR2345678909DE87478615189963590000············SHA···DEInvoice·No.3658/2014········································ ·······································································································expresni·platba·s·dohodnutym·kurzem·26.542············· ····················································································PMBADEXXXXX000000141010·················································· ················DEUTDEFF123 INT00000220141010············································································································································Janko·H rasko·U·namesti·20·Presov·250·00·Slovakia····························································································0000000000124, 65EUR2586740304SK3302000000000000012351··········SHA···SKfaktura·56/2014·z·5.10.2014······································ ···························································································································································································· ··················································PMBASKXXXXX000000141013
II.
Export dat – transakční historie a dnešní obraty
Export Platebních transakcí je možný ve dvou formátech: c) CSV formát, nebo d) XML formát.
A.
CSV formát
Specifikace formátu: Textový soubor, Formát ASCII Jeden řádek = jeden záznam z transakční historie První řádek je hlavička Oddělovač "," (čárka); pokud je pole prázdné, následují po sově dva oddělovače "," bez mezery Řádky jsou odděleny znakem CRLF
Verze: 27092014
Strana 9 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
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. 31. 32. 33. 34.
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 zpracování 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 Kód země Číslo protiúčtu Datum valuty Cancel indikátor
Vždy 1 PPF banka a.s. Bankovní kód PPF banky a.s. – vždy „6000“
35.
Směr transakce
36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52.
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
Popis položky Interní reference Banky Nepoužívá se 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
Datum valuty Indikátor rušení Indikátor typu položky: DR – debet na účtu CR – 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í Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Nepoužívá se Rozšířené informace k položce
Strana 10 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Příklad: 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 zpracování,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,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í 0,PPF banka a.s.,6000,0000000000,,0000000000,20100505:0000003249:BO100505GE256837,,,,,302.1.55289.3,,CZK,,"5 042,16 ",DOM_OP11,,Jméno účtu.,"87,00",9999999999,000000 9999999999/6000,20100505,,CZK,,0100,,,1,CZ,123123,20100505,0,D,,,,,001,,,0000000000,"1,90",6,1,,,,,, 0,PPF banka a.s.,6000,0000000000,,0000000000,20100430:0000010284:BO100430GE254601,,,,,301.7.55200.1,,CZK,,"7 715,79 ",DOM_OP11,,BÚ PPF A.S.,"1,23",9999999999,000000 9999999999/6000,20100430,,CZK,,0100,,,1,CZ,19,20100430,0,D,,,,,001,,,0000000000,"1,90",6,1,,,,,,
B.
XML formát
Specifikace formátu: Použité datové typy: bool – Y nebo N datum- YYYYMMDD záznamy s hodnotou NULL nejsou exportovány 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)
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ý Nepoužívá se Číslo položky tak, jak je předáno z Banky Nepoužívá se Čá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 Částka poplatků Měna poplatků
Verze: 27092014
Poznámka
Strana 11 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Jméno XML Elementu
Format
Balance
double
CancelIndicator GeminiRef BankRef ClientRef MovementTypeText BankID BankCode BankCountryID BankName AccNoID AccNoCC AccName AccCcy AccCcyText AccTypeID AccTypeCode AccTypeText Period 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
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 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)
Verze: 27092014
Popis 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 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
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á 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
Strana 12 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
Jméno XML Elementu
Format
Info17 Info18 Info19 Info20 Extensions
varchar(60) varchar(60) varchar(60) varchar(60) varchar(255)
IncomingDocID
int
Popis
Poznámka Nepoužívá Nepoužívá Nepoužívá Nepoužívá
Rozšířené informace k položce Číslo příchozího dokumentu v klientské databázi Gemini
se se se se
Nepoužívá se
Příklad:
<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 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> Verze: 27092014
Strana 13 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
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 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> <StatemDebitTotal>21,00 Verze: 27092014
Strana 14 (celkem 15) 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
Formáty souborů pro import a export dat pro Internetbanking PPF banky a.s.
<StatemCreditTotal>0,00 <StatemTransactionCount>2 <StatemDebitCount>2 <StatemCreditCount>0
Verze: 27092014
Strana 15 (celkem 15) 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