k
Klientský formát XML SEPA V KB
XML SEPA V KB (účinnost od 1.11.2009)
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
1/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
1.
Rámec....................................................................................................................................................................... 2
2.
Použití....................................................................................................................................................................... 2
3.
Struktura zprávy (prvky využívané v KB) ............................................................................................................. 3
4.
Pravidla dle ISO 20022 na vybrané tagy používané v KB..................................................................................... 5
5.
Detail ke konstrukci adresy v KB ......................................................................................................................... 11
6.
Detail ke konstrukci Identifikace Organizace nebo Fyzické osoby v KB.......................................................... 12
7.
Příklady definice identifikace Plátce a Přijemce v XML a na obrazovkách kanálu DCS Mojebanka .............. 14
8.
Příklad XML se dvěma platbami ........................................................................................................................... 16
1. Rámec Elektronické předání požadavku klienta KB na odeslání zahraniční platby v EUR v rámci SEPA. KB zajistí debet dle podmínek SEPA požadovaného účtu a odeslání platby na definovanou banku a účet včetně předaných neúčetních informací partnerovi. (KB zatím nerealizuje zahraniční inkaso)
2. Použití Standard definuje tři možnosti konstrukce XML : • • •
Single (jednoduché příkazy – každá platba má svůj samostatný platební blok) Bulk (hromadné příkazy – zde je jeden společný Payment Information Block (Platební blok) a několik výskytů platebních bloků) Mixed (oba typy v rámci jedné zprávy)
V KB je zatím umožněno předávat pouze jednoduché příkazy - SNGL. V tomto případě je nutné pro každý výskyt PaymentInformation (Informace o platbě) uvádět právě jeden výskyt CreditTransferTransactionInformation (Informace o kreditním převodu).
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
2/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB Seskupení: jednoduché Záhlaví skupiny
Informace o platbě 1
Informace o transakci 1 Informace o platbě 2
Informace o transakci 2 Informace o platbě 3 Informace o transakci 3
3. Struktura zprávy (prvky využívané v KB) Upozornění:
KB využívá XSD validace, kde je vyžadováno pouze standardní namespace „urn:iso:std:iso:20022:tech:xsd:pain.001.001.02“.
XML bez namespace či s jiným namespace bude považováno za nevalidní formát. Tagy z nichž jsou akceptovány hodnoty pro další zpracování v KB jsou uvedeny v tomto dokumentu. Povinná pole mají tagy v tabulkách na šedém pozadí Vysvětlení ke sloupcům použitých tabulek: Tabulky jsou převzaty z UNIFI (ISO 20022) Message Definition Report - Payments Standards – Initiation Approved by UNIFI Payments SEG on 6 June 2006 • Sloupec OR representuje možnost výběru z několika možností • Sloupec Mult definuje tvarem [p..n] výskyt daného tagu, kde p má hodnoty 1 pro povinný výskyt a 0 pro nepovinný a n má hodnotu maximálního opakování.
1 Záhlaví skupiny Index 1.0
Prvek zprávy GroupHeader (Záhlaví skupiny) MessageIdentification (Identifikace zprávy) CreationDateTime (Datum a čas vytvoření)
<XML Tag>
Mult. [1..1]
Presentace
<MsgId>
[1..1]
Text
[1..1]
Datum a čas
1.5
NumberOfTransactions (Počet transakcí)
[1..1]
Text
1.6
ControlSum (Kontrolní součet)
[0..1]
Množství
1.7
Grouping (Seskupení)
[1..1]
Kód
1.1 1.2
s
OR
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
Využito v KB
v KB povinné je použito pro detekci duplicit validujeme pouze s upozornění m validujeme v PCB pouze s upozornění m SNGL pro KB 3/21 datum účinnosti 1.11.2009
k 1.8
Klientský formát XML SEPA V KB
InitiatingParty (Iniciující strana)
[1..1]
+-
povinné v KB nepřebíráme
N Informace o platbě Index
Prvek zprávy
<XML Tag>
Mult.
Presen tace
Využito v KB
PaymentInformation (Informace o platbě) PaymentMethod (Platební metoda) RequestedExecutionDate (Požadované datum provedení) Debtor (Plátce)
[1..n]
[1..1]
Kód
„TRF“ - povinné
[1..1]
Datum
datum splatnosti debetu –povinné
[1..1]
+
DebtorAccount (Účet plátce)
[1..1]
+
2.17
DebtorAgent (Banka plátce)
[1..1]
+
2.19
UltimateDebtor (Konečný plátce)
[0..1]
+
2.20
ChargeBearer (Plátce poplatků)
[0..1]
Kód
2.21
ChargesAccount (Účet pro poplatky)
[0..1]
+
2.23
CreditTransferTransaction Information (Informace o kreditním převodu) PaymentIdentification (Identifikace platby) InstructionIdentification (Identifikace instrukce)
[1..n]
jméno, adresa, identifikace. KB přebírá pouze identifikaci, nepřebírá jméno a adresu, ale používá dle své administrace povinné IBAN (měna se nemusí uvádět, pokud je uvedena musí odpovídat administraci, jinak je odmítnuto) povinné KB nepřebírá a nevaliduje, banku kontroluje z IBANu KB bude předávat až bude oficielně schválen Rulebook 3.2. - klienti budou informováni na WEB KB pokud neuvedeno dosazuje KB SLEV, pokud je uvedena smí být jen SLEV. uvádět jen pokud požadujete pro poplatek jiný účet v KB (měna se nemusí uvádět, pokud je uvedena musí odpovídat administraci, jinak je odmítnuto) povinné
2.16
[1..1]
povinné
[0..1]
Text
EndToEndIdentification
<EndToEndId>
[1..1]
Text
2.0 2.2 2.13 2.15
2.24 2.25
2.26
s
OR
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
jednoznačná identifikace pro KB (hlídání duplicit), pokud ji neuvedete využijeme info v EndToEnd poli povinné 4/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB předáváme partnerovi a pokud neuvedete InstrId, tak pro KB účely považujeme i za tuto hodnotu, potom InstrId = EndToEndId
(Identifikace EndToEnd)
2.27
PaymentTypeInformation (Informace o typu platby) InstructionPriority (Priorita instrukce) ServiceLevel (Úroveň služeb) Code (Kód)
2.28 2.29 2.30
[0..1]
[0..1]
<SvcLvl>
[0..1]
[1..1]
Kód
Kód
Vše předané XML je v KB pouze „SEPA“. Není nutno uvádět a při uvedení jiné hodnoty je odmítnuto povinné částka v EUR (povinné) jiné než EUR měny jsou v KB odmítány povinné SEPA platba smí mít jen „SLEV“. Není nutné předávaz KB dosazuje defaultně. BIC - banka musí být SEPA compliant povinné Jméno + kód země povinné identifikace (volitelné) IBAN povinné
2.37 2.38
Amount (Částka) InstructedAmount (Částka v instrukci)
[1..1] [1..1]
Částka
2.46
ChargeBearer (Plátce poplatků)
[0..1]
Kód
2.55
CreditorAgent (Banka příjemce)
[0..1]
+
2.57
Creditor (Příjemce)
[0..1]
+
2.58
CreditorAccount (Účet příjemce) UltimateCreditor (Konečný příjemce)
[0..1]
+
[0..1]
+
KB bude předávat až bude oficielně schválen Rulebook 3.2. - klienti budou informováni na WEB KB
RemittanceInformation (Informace o úhradě) Unstructured (Nestrukturováno)
[0..1]
<Ustrd>
[0..n]
Text
Důvod platby (volitelné)
2.59
2.84 2.85
4. Pravidla dle ISO 20022 na vybrané tagy používané v KB PRO záhlaví: 1.1 MessageIdentification <MsgId> (Identifikace zprávy) Prezentace: [1..1] Definice: Reference Point-to-Point přiřazená stranou vydávající instrukci a odeslaná další straně v řetězci za účelem jednoznačné identifikace zprávy.
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
5/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
Použití: Strana vydávající instrukci musí zajistit jedinečnost identifikace zprávy MessageIdentification pro stranu přijímající instrukci na předem dohodnuté období. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1
1.2 CreationDateTime (Datum a čas vytvoření) Prezentace: [1..1] Definice: Datum a čas vytvoření platební instrukce (skupiny instrukcí) stranou vydávající instrukci. Typ dat: Datum a čas ISO
1.5 NumberOfTransactions (Počet transakcí) Prezentace: [1..1] Definice: Počet jednotlivých transakcí obsažených ve zprávě. Typ dat: Max. 15, číslice, text Formát: [0-9]{1,15}
1.6 ControlSum (Kontrolní součet) Prezentace: [0..1] Definice: Součet všech jednotlivých částek obsažených ve zprávě bez ohledu na měny. Typ dat: Čísla v desítkové soustavě Formát: desetinná místa: 17 celkový počet míst: 18
1.7 Grouping (Seskupení) Prezentace: [1..1] Definice: Označuje, zda jsou běžné účetní informace transakce uvedeny jednou pro všechny transakce nebo opakovaně pro každou jednotlivou transakci. V KB platí pouze jedna možnost: single (jednotlivě) – „SNGL“
1.8 InitiatingParty (Iniciující strana) Prezentace: [1..1] Definice: Strana, která iniciovala platbu. Z hlediska platby může jít buďto o plátce (při kreditním převodu), příjemce (při přímém inkasu) nebo stranu, která iniciovala platbu jménem plátce nebo příjemce. Typ: Tento prvek zprávy se skládá z následujících prvků PartyIdentification8:
Or
Prvek zprávy Name (Jméno) PostalAddress (Poštovní adresa)
<XML Tag>
Mult. [0..1] [0..1]
Reprezent./Typ Text V KB není přebíráno ani validováno. Využívá se adresa administrovaná v DB DCS. Pokud budete posílat struktura popsána v kapitole 5 adresa v KB
PRO platby 2.0 PaymentInformation (Informace o platbě) Prezentace: [1..n] Definice: Souhrn vlastností, které platí pro stranu plátce platebních transakcí obsažených v iniciovaném kreditním převodu. Typ: Blok Payment information (Informace o platbě) se skládá z následujících prvků PartyIdentification8:
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
6/21 datum účinnosti 1.11.2009
k Index 2.1
OR
Klientský formát XML SEPA V KB <XML Tag>
Mult. [0..1]
Presentace Text
Využito v KB
[1..1] [0..1]
Kód
TRF
[1..1]
Datum a čas
DATUM
2.15
Prvek zprávy PaymentInformationIdentification (Identifikace informací o platbě) PaymentMethod (Platební metoda) PaymentTypeInformation (Informace o typu platby) RequestedExecutionDate (Požadované datum provedení) Debtor (Plátce)
[1..1]
+
2.16
DebtorAccount (Účet plátce)
[1..1]
+
2.17
DebtorAgent (Zprostředkující banka plátce)
[1..1]
+
2.19
UltimateDebtor (Konečný plátce)
[0..1]
+
2.20
ChargeBearer (Plátce poplatků)
[0..1]
Code
2.21
ChargesAccount (Účet pro poplatky)
[0..1]
+
2.23
CreditTransferTransactionInformation (Informace o kreditním převodu)
[1..n]
nepřebírá se adresa a jméno pouze identifikace, je-li uvedena IBAN měnu není nutné uvádět. Pokud je uvedena validuje se na stav v DB Nepřebírá a nevaliduje. Banku validuje již v IBANu. KB zatím nepředává KB dosazuje SLEV, ale pokud uvedete a bude jiná hodnota než SLEV bude odmítnuto číslo účtu uvádět jen, když je jiné než pro vlastní platbu (vždy jen v KB) blok popisu kreditora
2.2 2.3 2.13
2.2 PaymentMethod (Platební metoda) Prezentace: [1..1] Definice: Uvádí způsob platby, který se použije k převedení dané finanční částky. Typ dat: kód - „TRF“ 2.13 RequestedExecutionDate (Požadované datum provedení) Prezentace: [1..1] Definice: Datum, k němuž iniciující strana požaduje zpracování platby prostředníkem zúčtování. Při platbě šekem jde o datum, kdy musí být bankou vygenerován šek. Použití: K tomuto datu dojde k odepsání z účtu (účtů) plátce. Typ dat: Datum ISO
2.15 Debtor (Plátce) Prezentace: [1..1] Definice: Strana, která dluží peníze (konečnému) příjemci. Typ: Tento prvek zprávy se skládá z následujících prvků PartyIdentification8: Or
s
Prvek zprávy Name (Jméno) PostalAddress (Poštovní adresa) Identification (Identifikace) CountryOfResidence (Země trvalého
<XML Tag>
Mult. [0..1] [0..1]
Reprezent./Typ Text Viz kapitola 5
[0..1]
Viz kapitola 6
[0..1]
Code (Kód)
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
7/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
bydliště)
2.16 DebtorAccount (Účet plátce) Prezentace: [1..1] Definice: Jednoznačná identifikace účtu plátce, na němž bude jako výsledek transakce provedena debetní položka. Typ: Tento prvek zprávy se skládá z následujících prvků CashAccount7: Or
Prvek zprávy Identification (Identifikace) Currency (Měna)
<XML Tag>
Mult. [1..1]
Reprezent./Typ
[0..1]
Code (Kód)
2.17 DebtorAgent (Banka plátce) Prezentace: [1..1] Definice: Finanční instituce vedoucí účet plátce. Typ: Tento prvek zprávy se skládá z následujících prvků BranchAndFinancialInstitutionIdentification3: Or
Prvek zprávy FinancialInstitutionId entification (Identifikace finanční instituce)
<XML Tag>
Mult. [1..1]
Reprezent./Typ KB nevaliduje
2.19 UltimateDebtor (Konečný plátce) Prezentace: [0..1] Definice: Konečná strana, která dluží peníze (konečnému) příjemci. Typ: Tento prvek zprávy se skládá z následujících prvků PartyIdentification8:
Or
Prvek zprávy Name (Jméno) PostalAddress (Poštovní adresa) Identification (Identifikace) CountryOfResidence (Země trvalého bydliště)
<XML Tag>
Mult. [0..1] [0..1]
Reprezent./Typ Text Viz kapitola 5
[0..1]
Viz kapitola 6
[0..1]
Code (Kód)
2.20 ChargeBearer (Plátce poplatků) Prezentace: [0..1] Definice: Uvádí stranu (strany), které budou platit poplatky spojené se zpracováním platební transakce. Typ dat: Code (Kód) Pokud je uveden tento prvek zprávy, musí se použít některá z následujících hodnot ChargeBearerType1Code: Definice názvu kódu (pro KB SEPA lze použít pouze SLEV) CRED BorneByCreditor - Všechny poplatky za transakci platí příjemce. DEBT BorneByDebtor - Všechny poplatky za transakci platí plátce. SHAR Sdíleno - Při kreditním převodu znamená, že poplatky za transakci na straně odesílatele platí plátce, poplatky za transakci na straně příjemce platí příjemce. Při inkasním převodu znamená, že poplatky za transakci na straně odesílatele platí příjemce, poplatky za transakci na straně příjemce platí plátce. SLEV FollowingServiceLevel - Poplatky se uplatňují podle pravidel dohodnutých s úrovní služeb - plánu služeb.
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
8/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
2.21 ChargesAccount (Účet pro poplatky) Prezentace: [0..1] Definice: Účet používaný pro zpracování poplatků za transakci. Použití: Účet pro poplatky se používá, pokud je třeba zaúčtovat poplatky na jiný účet než na účet označený jako účet plátce. Typ: Tento prvek zprávy se skládá z následujících prvků CashAccount7: Or
Prvek zprávy Identification (Identifikace) Currency (Měna)
<XML Tag>
Mult. [1..1]
Reprezent./Typ
[0..1]
Code
2.23 CreditTransferTransactionInformation (Informace o kreditním převodu) Prezentace: [1..n] Definice: Skupina prvků poskytujících specifické informace o jednotlivých transakcích obsažených ve zprávě. Typ: Tento prvek zprávy se skládá z následujících prvků CreditTransferTransactionInformation1: Index
OR
2.24 2.27 2.37 2.55 2.57 2.58 2.59 2.84
Prvek zprávy
<XML Tag>
Mult.
PaymentIdentification (Identifikace platby) PaymentTypeInformation (Informace o typu platby) Amount (Částka) CreditorAgent (Banka příjemce) Creditor (Příjemce) CreditorAccount (Účet příjemce) UltimateCreditor (Konečný příjemce) RemittanceInformation (Informace o úhradě)
[1..1]
[0..1]
[1..1] [0..1] [0..1] [0..1] [0..1]
[0..1]
Presentace
Využito v KB
+ + + +
2.37 Amount (Částka) Prezentace: [1..1] Definice: Částka peněz, která se má převádět mezi plátcem a příjemcem, před odečtením poplatků, vyjádřená v měně určené iniciující stranou. Typ: Tento prvek zprávy se skládá z některého z následujících prvků AmountType2Choice: Index 2.38
OR
Prvek zprávy InstructedAmount (Částka v instrukci)
<XML Tag>
Mult. [1..1]
Presentace Amount
Využito v KB v KB pouze EUR měna povolena
2.38 InstructedAmount (Částka v instrukci) Prezentace: [1..1] Tento prvek zprávy je součástí volby 2.37 Částka. Definice: Částka peněz, která se má převádět mezi plátcem a příjemcem, před odečtením poplatků, vyjádřená v měně určené iniciující stranou. Typ dat: CurrencyAndAmount (Měna a částka) Tento typ dat musí být použit s následujícím atributem XML: Currency (Ccy) ; zapisuje se jako CurrencyCode (Kód měny). Formát: CurrencyAndAmount (Měna a částka) desetinná místa: 5 nejméně, včetně: 0 celkový počet míst: 18
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
9/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
CurrencyCode (Kód měny) [A-Z]{3,3} Pravidla: CurrencyCode (Kód měny) Validace podle tabulky
2.55 CreditorAgent (Banka příjemce) Prezentace: [0..1] Definice: Finanční instituce vedoucí účet příjemce. Typ: Tento prvek zprávy se skládá z následujících prvků BranchAndFinancialInstitutionIdentification3: Or
Prvek zprávy FinancialInstitutionIdentification (Identifikace finanční instituce)
<XML Tag>
Mult. [1..1]
Reprezent./Typ - banka musí být SEPA complayed
2.57 Creditor (Příjemce) Prezentace: [0..1] Definice: Strana, jíž je finanční částka splatná. Typ: Tento prvek zprávy se skládá z následujících prvků PartyIdentification8: Or
Prvek zprávy Name (Jméno) PostalAddress (Poštovní adresa) Identification (Identifikace) CountryOfResidence (Země trvalého bydliště)
<XML Tag>
Mult. [0..1] [0..1] [0..1] [0..1]
Reprezent./Typ Text Viz kapitola 5 Viz kapitola 6 Code (Kód)
2.58 CreditorAccount (Účet příjemce) Prezentace: [0..1] Definice: Jednoznačná identifikace účtu příjemce, na nějž bude jako výsledek transakce převedena kreditní položka. Typ: Tento prvek zprávy se skládá z následujících prvků CashAccount7: Or
Prvek zprávy
<XML Tag>
Mult.
Identification (Identifikace)
[1..1]
Repreze nt./Typ
KB
2.59 UltimateCreditor (Konečný příjemce) Prezentace: [0..1] Definice: Konečná strana, jíž je finanční částka splatná. Typ: Tento prvek zprávy se skládá z následujících prvků PartyIdentification8: Or
Prvek zprávy
<XML Tag>
Mult.
Name (Jméno) PostalAddress (Poštovní adresa)
[0..1] [0..1]
Identification (Identifikace)
[0..1]
CountryOfResidence (Země trvalého bydliště)
[0..1]
Repreze nt./Typ Text
KB
Chapter 5 Chapter 6 Code (Kód)
2.84 RemittanceInformation (Informace o úhradě) Prezentace: [0..1] Definice: Informace, které umožňují shodu (tj. sesouhlasení) platby s položkami, které má tato platba vypořádat, např. obchodní faktury v systému pohledávek. Typ: Tento prvek zprávy se skládá z následujících prvků RemittanceInformation1:
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
10/21 datum účinnosti 1.11.2009
k Index 2.85
OR
Prvek zprávy Unstructured (Nestrukturováno)
Klientský formát XML SEPA V KB <XML Tag> <Ustrd>
Mult. [0..n]
Presentace Text
Využito v KB použita jen nestrukturova ná informace
2.85 Unstructured <Ustrd> (Nestrukturováno) Prezentace: [0..n] Definice: Informace umožňující shodu položky s položkami, které má převod vypořádat, např. obchodní faktury v systému pohledávek v nestrukturované formě. Typ dat: Max. 140, text Formát: max. délka: 140, min. délka:
5. Detail ke konstrukci adresy v KB V KB bude vyžadováno využít pro konstrukci adresy strukturovaný přístup a použít patřičné tagy pro jméno, město, ulici, číslo, směrovací kód, zemi. Validace adres je dle platných pravidel zahraničních plateb předávaných prostřednictvím DCS (stejné jako u formátu BEST a EDI_BEST.
5.1.1 PostalAddress (Poštovní adresa) Prezentace: [0..1] Definice: Informace, které určují a identifikují konkrétní adresu tak, jak je definovaná poštovními službami. Typ: Tento prvek zprávy se skládá z následujících prvků PostalAddress1: REF 5.1.4 5.1.5 5.1.6 5.1.7 5.1.9
OR
Prvek zprávy StreetName (Ulice) BuildingNumber (Číslo popisné) PostCode (PSČ) TownName (Město) Country (Země)
<XML Tag> <StrtNm>
Mult. [0..1] [0..1] [0..1] [0..1] [1..1]
Presentace Text Text Text Text Code (Kód)
Využito v KB Nepovinný údaj Nepovinný údaj Nepovinný údaj Nepovinný údaj Povinný údaj
5.1.4 StreetName <StrtNm> (Ulice) Prezentace: [0..1] UNIFI (ISO 20022) - Normy pro platby - Zavedeno v říjnu 2006 Typy prvků zprávy Strana 343 Definice: Název ulice nebo třídy. Typ dat: Max. 70, text Formát: max. délka: 70 min. délka: 1
5.1.5 BuildingNumber (Číslo popisné) Prezentace: [0..1] Definice: Číslo domu v ulici. Typ dat: Max. 16 text, Formát: max. délka: 16 min. délka: 1
5.1.6 PostCode (PSČ) Prezentace: [0..1] Definice: Poštovní směrovací číslo, popřípadě poštovní třídící kód.
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
11/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
Typ dat: Max. 16, text Formát: max. délka: 16 min. délka: 1
5.1.7 TownName (Město) Prezentace: [0..1] Definice: Jméno města, nebo oblasti definované v hranicích s místní samosprávou. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1
5.1.9 Country (Země) Prezentace: [1..1] Definice: Stát, země. Typ dat: Kód země Formát: [A-Z]{2,2} Pravidla: Země Kód se kontroluje proti seznamu názvů zemí vydávaný Organizací spojených národů (ISO 3166, kód Alpha 2).
6. Detail ke konstrukci Identifikace Organizace nebo Fyzické osoby v KB U plátce, příjemce, původního plátce a konečného příjemce má možnost klient předat identifikaci podle toho, zda se jedná o identifikaci organizace nebo identifikace soukromé osoby. V této kapitole je presentováno jaké tagy definované v XML jsou přebírány v rámci KB. Logické využití je následovné: • • •
Výběr typu identifikace - zda organizace nebo fyzická osoba Použití pro Organizaci () - tag s vnořenými tagy pro identifikační údaje a pro výstavce dokumentu Použití pro Osobu () - tag s vnořenými tagy pro identifikační údaje a pro Typ dokumentu a tagu pro výstavce dokumentu
5.1.10 Identification (Identifikace) Prezentace: [0..1] Definice: Jedinečná a jednoznačná identifikace právnické, nebo fyzické osoby. Typ: Tento prvek zprávy se skládá z některého z následujících prvků Party2Choice: REF 5.1.1 1 5.1.2 3
OR {Or Or}
Prvek zprávy OrganisationIdentification (Identifikace organizace) PrivateIdentification (Identifikace soukromé osoby)
<XML Tag>
Mult. [1..1]
[1..4]
Presentace
Využito v KB
Presentace
Využito v KB KB umožňuje jen tento tag
5.1.11 OrganisationIdentification (Identifikace organizace) Prezentace: [1..1] Tento prvek zprávy je součástí volby 5.1.10 Identifikace. Definice: Jedinečný způsob identifikace organizace. Typ: Tento prvek zprávy se skládá z následujících prvků OrganisationIdentification2: REF 5.1.20
OR
Prvek zprávy ProprietaryIdentification (Identifikace registrace)
<XML Tag>
Mult. [0..1]
5.1.20 ProprietaryIdentification (Identifikace registrace)
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
12/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
Prezentace: [0..1] Definice: Jedinečný identifikátor organizace přidělený odpovědnou institucí. Typ: Tento prvek zprávy se skládá z následujících prvků GenericIdentification3: REF 5.1.21
OR
5.1.22
Prvek zprávy Identification (Identifikace)
<XML Tag>
Mult. [1..1]
Presentace Text
Issuer (Výstavce)
[0..1]
Text
Využito v KB Identifikační údaje Výstavce dokumentu
5.1.21 Identification (Identifikace) Prezentace: [1..1] Definice: Název nebo číslo přiřazené určitým subjektem za účelem rozpoznání tímto subjektem, např. identifikátor účtu. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1
5.1.22 Issuer (Výstavce) Prezentace: [0..1] Definice: Subjekt, který přiřazuje identifikaci. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1
5.1.23 PrivateIdentification (Identifikace fyzické osoby) Prezentace: [1..4] Tento prvek zprávy je součástí volby 5.1.10 Identifikace. Definice: Jedinečná identifikace fyzické osoby, např. cestovní pas. Typ: Tento prvek zprávy se skládá z následujících prvků PersonIdentification3: REF 5.1.37
OR
5.1.40
Prvek zprávy OtherIdentification (Další informace) Issuer (Výstavce)
<XML Tag>
Mult. [1..1]
Presentace
[0..1]
Text
Využito v KB KB umožnuje jen tento tag Výstavce dokumentu
5.1.37 OtherIdentification (Další informace) Prezentace: [1..1] Tento prvek zprávy je součástí volby 5.1.23 PrivateIdentification. Definice: Identifikátor vydaný osobě, pro kterou nebyl definován žádný konkrétní identifikátor. Typ: Tento prvek zprávy se skládá z následujících prvků GenericIdentification4: REF 5.1.38 5.1.39
OR
Prvek zprávy Identification (Identifikace)
<XML Tag>
Mult. [1..1]
Presentace Text
IdentificationType (Typ identifikace)
[1..1]
Text
Využito v KB Identifikační údaje Typ dokumentu
5.1.38 Identification (Identifikace) Prezentace: [1..1] Definice: Identifikátor vydaný osobě, pro kterou nebyl definován žádný konkrétní identifikátor. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
13/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
5.1.39 IdentificationType (Typ identifikace) Prezentace: [1..1] Definice: Specifikace typu identifikátoru. Použití: Typ identifikace se používá k zadání druhu použitého identifikátoru. Používá se v případě, že se identifikátor liší od identifikátorů uvedených v seznamu předdefinovaných identifikátorů. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1
5.1.40 Issuer (Výstavce) Prezentace: [0..1] Definice: Výstavce identifikačního dokladu. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1
7. Příklady definice identifikace Plátce a Přijemce v XML a na obrazovkách kanálu DCS Mojebanka Identifikacni udaje Vystavce dokumentu
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
14/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
Identifikacni udaje Typ dokumentu Vystavce dokumentu Jmeno nebo Nazev puvodniho platce Identifikacni udaje Typ dokumentu Vystavce dokumentu
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
15/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
8. Příklad XML se dvěma platbami Příklad dvou plateb odesílaných v jednom souboru. • • • • • • •
První platba je odesílaná pro organizaci a druhá pro privátní osobu. V obou platbách jsou předávány nepovinné údaje identifikace partnera. V první platbě je uveden nepovinný údaj měna účtu debet. V obou platbách je vyplněna nepovinná položka identifikace platby, která je pro zpracování v KB nutná pro udržení jedinečnosti v rámci klienta (pokud by uvedena nebyla, přebíralo by se pro tyto účely položka EndToEnd a musela by vyhovovat validaci na jedinečnost. V obou platbách je uveden service level SEPA, toto pole je nepovinné a KB jiný service level pro XML předané platby neprovádí. Poplatky nejsou specifikovány a banka si doplní pro SEPA defaultně SLEV. Čislo účtu pro poplatky je v jedné platbě stejné jako pro vlastní platbu a pro druhou je vyžadováno jiné číslo účtu.
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
16/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
<pain.001.001.02> <MsgId>20071218PAY1234 2008-01-17T16:36:00 2 300.88 SNGL ABC Consulting s.r.o. <StrtNm>U žluťoučkého koně 1622/12 158 00 Praha 13 CZ
TRF 2008-03-18 TKT_NTI a.s. <StrtNm>Na Příkopě 22 114 07 Praha 1, Staré Město CZ DIC 026-123456789 Výstavce dokumentu platba 1
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
17/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
CZ0801000000353105260267 USD KOBACZPX
>
<EndToEndId>00001 ID dohodnuté s partnerem <SvcLvl> SEPA 100.67 SLEV SOGEFRPP COMM France Ltd. <StrtNm>Veine Jugulaire 58/125B 3PA00 Paris FR
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
18/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
PCA000011789B Paris Central Authority FR1420041010050500013M02606
<Ustrd>Goods-and-Services-Tax Pay-Off (max length 140 characters)
TRF 2008-02-26 TKT_NTI a.s. <StrtNm>Na Příkopě 22 114 07 Praha 1, Staré Město CZ DIC 026-123456789 Výstavce dokumentu platba 2
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
19/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
CZ0801000000353105260267 USD KOBACZPX CZ0801000000353105270297 CZK
>
<EndToEndId>00002 ID dohodnuté s partnerem <SvcLvl> SEPA 200.21 SLEV NTI a.s. DEUTDEDB101 Hans Friedrich
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
20/21 datum účinnosti 1.11.2009
k
Klientský formát XML SEPA V KB
<StrtNm>Halsschlagader Strasse 1 14165 Berlin - Zehlendorf DE FS123456 Fuhrerschein Zemský úřad Berlin DE89370400440532013000
DE012345678901 Passport No. Zemský úřad Mnichov <Ustrd>platba za dodávku služeb/service-supply payment /VS/9876543210 /KS/10 (max length 140 characters)
s
Komerční banka, a. s., se sídlem: Praha 1, Na Příkopě 33 čp. 969, PSČ 114 07, IČ: 45317054 ZAPSANÁ V OBCHODNÍM REJSTŘÍKU VEDENÉM MĚSTSKÝM SOUDEM V PRAZE, ODDÍL B, VLOŽKA 1360
21/21 datum účinnosti 1.11.2009