Klientský formát XML SEPA CT pro MultiCash (platný od 1.11. 2016)
Obsah: 1. Úvod 2. Použití formátu 3. Struktura zprávy při zadání/importu v SEPA modulu v aplikaci MultiCash 3.1. Záhlaví souboru 3.2. N Informace o dávce 3.3. N Informace o platbě 3.4. Detailní struktura vybraných polí 3.5. Příklad platby
1.
Úvod
MONETA Money Bank, a. s. (dále jen „Banka“) umožňuje klientům od 1.11.2016 zadání jednotlivé SEPA platby nebo import dávky SEPA plateb v příslušném XML formátu (dle ISO 20022) prostřednictvím SEPA modulu v aplikaci MultiCash nebo prostřednictvím funkce přímá komunikace. V kapitolách níže je uvedena definice formátu, jednotlivých tagů, použití znakové sady a další pravidla nutná pro přijetí XML souboru a správné zpracování plateb na straně Banky. 2. Použití formátu Standard Banka akceptuje z aplikace MultiCash formát SEPA XML ve standardu pain.001.001.03. Znaková sada Znaková sada všech textových polí SEPA plateb je omezena platnými znaky znakové sady SWIFT, musí být vždy dodržena swiftová sada znaků. Jedná se tedy o tyto znaky: a b c d e f g h i j kl m n o p q r st u vw x y z A B C D E F G H I J KL M N O P Q R ST U VW X Y Z 0123456789 /-?:().,´+ Space Toto se týká i datumových polí. Žádný z tagů nesmí obsahovat na záčátku nebo na konci samostatné „/“ (lomítko), nebo v textu dvě lomítka jdoucí za sebou.
3. Struktura zprávy při zadání/importu v SEPA modulu v aplikaci MultiCash Struktura zprávy vychází z tzv. Implementation Guidelines pro XML formát pain.001.001.03 zveřejněných European Payments Council (EPC) http://www.europeanpaymentscouncil.eu/index.cfm/knowledge-bank/epc-documents/sepacredit-transfer-scheme-customer-to-bank-implementation-guidelines-version-8/.
Povinná pole mají tagy v tabulkách na šedém pozadí 3.1
Záhlaví souboru Index
Úroveň
Prvek zprávy
<XML Tag>
Mult.
1.0
+
Group Header (Záhlaví souboru)
[1..1]
1.1
++
Message Identification (Identifikace / Jméno souboru)
<MsgId>
[1..1]
Presentace
Využito v Bance
Max35Text
Jednoznačné ID souboru. (Generuje MC)
1.2
++
Creation Date Time (Datum a čas vytvoření)
[1..1]
Datum a čas
(Generuje MC)
1.4
++
Number of Transactions (Počet transakcí)
[1..1]
Max15NumericText
Počet plateb v souboru.
1.5
++
Control Sum (Kontrolní součet)
[0..1]
Decimal-Number
Součet částek v souboru.
1.6
++
Inititating Party (Iniciující strana)
[1..1]
+
1.7
+++
Name (Jméno)
[0..1]
Max70Text
Jméno (Generuje MC)
N Informace o dávce (jeden soubor může obsahovat 1 až n dávek)
3.2
Index
Úroveň
Prvek zprávy
<XML Tag>
Mult.
Presentace
2.0
+
Payment Information (Informace o dávce příkazů k SEPA platbě)
[1..n]
+
2.1
++
Payment Information Identificatio n (ID dávky / batch)
[1..1]
Max35Text
Využito v Bance
Obsahuje identifikaci dávky plateb, které mají být zpracovány. (Generuje MC)
2.2
++
Payment Method (Platební metoda)
[1..1]
Kód
„TRF“
2.3
++
Batch Booking (Příznak dávkového zpracování)
[0..1]
Indikátor
„true“ = dávkové zpracování nebo „false“ = zpracování jednotlivých plateb
2.4
++
Number of Transaction s (Počet transakcí)
[0..1]
Max15NumericText
Počet plateb
Control Sum (Kontrolní součet)
[0..1]
Payment Type Information (Informace o typu platby)
[0..1]
2.5
2.6
++
++
v dávce.
Decimal-Number
Součet částek v dávce.
+
2.8
2.15
2.17
+++
++
++
[0..1]
Service Level
<SvcLvl>
Requested Execution Date (Požadovan é datum provedení)
[1..1]
Debtor (Plátce)
[1..1]
+
MMB akceptuje pouze hodnotu „SEPA“
Datum
Vyplňte požadované datum splatnosti.
+
Jméno, adresa (nestrukturovaně), identifikace. Detailní struktura adresy a identifikace v kapitole 3.4.
2.18
+++
Name (Jméno)
[1..1]
Max70Text
2.35
++
Debtor Account (Účet plátce)
[1..1]
+
Ve formátu IBAN
2.40
++
Debtor Agent (Banka plátce)
[1..1]
+
Ve formátu BIC / SWIFT kódu.
2.52
++
Ultimate Debtor (Původní plátce)
[0..1]
+
Jméno, adresa (nestrukturovaně), identifikace. Detailní struktura adresy a identifikace v kapitole 3.4.
2.53
+++
Name (Jméno)
[0..1]
Max70Text
Jméno a příjmení
2.60
++
Charge Bearer (Plátce poplatků)
[0..1]
Kód
Pouze kód „SLEV“
3.3. N Informace o platbě (jedna dávka může obsahovat 1 až n plateb) Index
Úroveň
Prvek zprávy
<XML Tag>
Mult .
Presentace
Využito v Bance
2.63
++
Credit Transfer Transaction Information (Informace o kreditním převodu
[1..n]
+
Obsahuje detailní
Payment Identification (Identifikace platby)
[1..1]
2.64
+++
informace k platbě.
+
Obsahuje identifikaci platby. (Generuje zpravidla MC)
2.65
++++
Instruction Identification (Identifikace instrukce)
[0..1]
Max35Text
Identifikace platby
2.66
++++
End to End Identification (Koncová Identifikace)
<EndToEndId>
[1..1]
Max35Text
Identifikace platby
2.76
+++
Amount (Částka)
[1..1]
+
Částka platby v měně EUR.
2.96
+++
Creditor Agent (Banka příjemce)
[0..1]
+
Ve formátu BIC/SWIFT kódu.
2.98
+++
Creditor (Příjemce)
[1..1]
+
Jméno, adresa (nestrukturovaně), identifikace. Detailní struktura adresy a identifikace v kapitole 3.4.
2.99
++++
Name (Jméno)
[1..1]
Max70Text
Jméno a příjmení
2.116
+++
Creditor Account (Účet příjemce)
[1..1]
+
Ve formátu IBAN.
2.117
+++
Ultimate Creditor (Konečný příjemce)
[0..1]
+
Jméno, adresa (nestrukturovaně), identifikace. Detailní struktura adresy a identifikace v kapitole 3.4.
2.118
++++
Name (Jméno)
[1..1]
Max70Text
2.133
+++
Remittance Information (Informace o platbě)
[0..1]
+
2.134
++++
Unstructured (Nestrukturo vané)
<Ustrd>
[0..1]
Max140Text
Jméno a příjmení
Doplňující informace k SEPA platbě.
3.4. Detailní struktura vybraných polí Adresa Tag: Prvek zprávy
<XML Tag>
Mult.
Presentace
Využito v Bance
Postal Address (Adresa)
[0..1]
+
Country (Země)
[0..1]
Kód
Kód země
Address Line (Řádek adresy)
[0..2]
Max70Text
Ulice a Město
<XML Tag>
Mult.
Presentace
Využito v
Identification (Identifikace)
[0..1]
Organisation Identification (Identifikace organizace)
[1..1]
Private Identification (Osobní identifikace)
Identifikace Tag: Prvek zprávy
Bance + Hodnota z číselníku v MC. [1..1]
Hodnota z číselníku v MC
3.5 Příklad transakce <MsgId>MCCT16101447094271097 2016-10-14T08:49:27 2 203.00 Jaroslav Ledvina CZ 16101400001 TRF true 1 101.00 <SvcLvl> SEPA 2016-10-14 Jaroslav Ledvina CZ CZ3606000000000017353443 CZK
AGBACZPPXXX SLEV MCCT161014000002 <EndToEndId>E2EC161013000001 101.00 DEUTDEDBDUE jmeno DE adresa mesto ŠKODA AUTO MLADÁ BOLESLAV DE04300700240108232000 <Ustrd>PLATBA FAKTURY123
16101400002 TRF true 1 102.00 <SvcLvl> SEPA 2016-10-14 TST3 PRIKAZCE CZ5806000000000017353435 AGBACZPPXXX SLEV MCCT161014000001 <EndToEndId>E2EC161013000002 102.00 GIBAATWWXXX
FIRMAABC AT Salmgasse 21 Wien AT123456789012345678 Petra Novakova CZ ulice mesto 123456 <SchmeNm> DRLC <Ustrd>Platbafaktury123