Klientký formát XML SEPA V KB XML SEPA V KB (účinnot od 1.11.2009) 1/21
Klientký 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 kontrukci adrey v KB... 11 6. Detail ke kontrukci Identifikace Organizace nebo Fyzické ooby 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 e dvěma platbami... 16 1. Rámec Elektronické předání požadavku klienta KB na odelání zahraniční platby v EUR v rámci SEPA. KB zajití debet dle podmínek SEPA požadovaného účtu a odelání platby na definovanou banku a účet včetně předaných neúčetních informací partnerovi. (KB zatím nerealizuje zahraniční inkao) 2. Použití Standard definuje tři možnoti kontrukce XML : Single (jednoduché příkazy každá platba má vůj amotatný platební blok) Bulk (hromadné příkazy zde je jeden polečný Payment Information Block (Platební blok) a několik výkytů 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ýkyt PaymentInformation (Informace o platbě) uvádět právě jeden výkyt CreditTranferTranactionInformation (Informace o kreditním převodu). 2/21
Klientký formát XML SEPA V KB Sekupení: jednoduché Záhlaví kupiny Informace o platbě 1 Informace o tranakci 1 Informace o platbě 2 Informace o tranakci 2 Informace o platbě 3 Informace o tranakci 3 3. Struktura zprávy (prvky využívané v KB) Upozornění: KB využívá XSD validace, kde je vyžadováno pouze tandardní namepace urn:io:td:io:20022:tech:xd:pain.001.001.02. XML bez namepace či jiným namepace bude považováno za nevalidní formát. Tagy z nichž jou akceptovány hodnoty pro další zpracování v KB jou uvedeny v tomto dokumentu. Povinná pole mají tagy v tabulkách na šedém pozadí Vyvětlení ke loupcům použitých tabulek: Tabulky jou převzaty z UNIFI (ISO 20022) Meage Definition Report - Payment Standard Initiation Approved by UNIFI Payment SEG on 6 June 2006 Sloupec OR repreentuje možnot výběru z několika možnotí Sloupec Mult definuje tvarem [p..n] výkyt daného tagu, kde p má hodnoty 1 pro povinný výkyt a 0 pro nepovinný a n má hodnotu maximálního opakování. 1 Záhlaví kupiny Index OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 1.0 GroupHeader (Záhlaví <GrpHdr> [1..1] kupiny) 1.1 MeageIdentification <MgId> [1..1] Text (Identifikace zprávy) 1.2 CreationDateTime (Datum a ča vytvoření) <CreDtTm> [1..1] Datum a ča v KB povinné je použito pro detekci 1.5 NumberOfTranaction (Počet tranakcí) duplicit <NbOfTx> [1..1] Text validujeme pouze upozornění m 1.6 ControlSum (Kontrolní oučet) <CtrlSum> [0..1] Množtví validujeme v PCB pouze upozornění m 1.7 Grouping (Sekupení) <Grpg> [1..1] Kód SNGL pro KB 3/21
povinné 1.8 InitiatingParty (Iniciující trana) <InitgPty> [1..1] +- v KB nepřebíráme N Informace o platbě Klientký formát XML SEPA V KB Index OR Prvek zprávy <XML Tag> Mult. Preen Využito v KB tace 2.0 PaymentInformation <PmtInf> [1..n] (Informace o platbě) 2.2 PaymentMethod (Platební <PmtMtd> [1..1] Kód TRF - povinné metoda) 2.13 RequetedExecutionDate (Požadované datum <ReqdExctnDt> [1..1] Datum datum platnoti debetu povinné provedení) 2.15 Debtor (Plátce) <Dbtr> [1..1] + jméno, adrea, identifikace. KB přebírá pouze identifikaci, nepřebírá jméno a adreu, ale používá dle vé adminitrace - 2.16 DebtorAccount (Účet plátce) 2.17 DebtorAgent (Banka plátce) 2.19 UltimateDebtor (Konečný plátce) 2.20 ChargeBearer (Plátce poplatků) 2.21 ChargeAccount (Účet pro poplatky) 2.23 CreditTranferTranaction Information (Informace o kreditním převodu) 2.24 PaymentIdentification (Identifikace platby) 2.25 IntructionIdentification (Identifikace intrukce) povinné <DbtrAcct> [1..1] + IBAN (měna e nemuí uvádět, pokud je uvedena muí odpovídat adminitraci, jinak je odmítnuto) - povinné <DbtrAgt> [1..1] + KB nepřebírá a nevaliduje, banku kontroluje z IBANu <UltmtDbtr> [0..1] + KB bude předávat až bude oficielně chválen Rulebook 3.2. - klienti budou informováni na WEB KB <ChrgBr> [0..1] Kód pokud neuvedeno doazuje KB SLEV, pokud je uvedena mí být jen SLEV. <ChrgAcct> [0..1] + uvádět jen pokud požadujete pro poplatek jiný účet v KB (měna e nemuí uvádět, pokud je uvedena muí odpovídat adminitraci, jinak je odmítnuto) <CdtTrfTxInf> [1..n] povinné <PmtId> [1..1] povinné <IntrId> [0..1] Text jednoznačná identifikace pro KB (hlídání duplicit), pokud ji neuvedete využijeme info v EndToEnd poli 2.26 EndToEndIdentification <EndToEndId> [1..1] Text povinné 4/21
(Identifikace EndToEnd) Klientký formát XML SEPA V KB předáváme partnerovi a pokud neuvedete IntrId, tak pro KB účely považujeme i za tuto hodnotu, potom IntrId = EndToEndId 2.27 PaymentTypeInformation <PmtTpInf> [0..1] (Informace o typu platby) 2.28 IntructionPriority (Priorita <IntrPrty> [0..1] Kód intrukce) 2.29 ServiceLevel (Úroveň <SvcLvl> [0..1] lužeb) 2.30 Code (Kód) <Cd> [1..1] 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 2.37 Amount (Čátka) <Amt> [1..1] povinné 2.38 IntructedAmount (Čátka v intrukci) 2.46 ChargeBearer (Plátce poplatků) 2.55 CreditorAgent (Banka příjemce) <IntdAmt> [1..1] Čátka čátka v EUR (povinné) jiné než EUR měny jou v KB odmítány povinné <ChrgBr> [0..1] Kód SEPA platba mí mít jen SLEV. Není nutné předávaz KB doazuje defaultně. <CdtrAgt> [0..1] + BIC - banka muí být SEPA compliant povinné 2.57 Creditor (Příjemce) <Cdtr> [0..1] + Jméno + kód země povinné identifikace (volitelné) 2.58 CreditorAccount (Účet příjemce) 2.59 UltimateCreditor (Konečný příjemce) 2.84 RemittanceInformation (Informace o úhradě) 2.85 Untructured (Netrukturováno) <CdtrAcct> [0..1] + IBAN povinné <UltmtCdtr> [0..1] + KB bude předávat až bude oficielně chválen Rulebook 3.2. - klienti budou informováni na WEB KB <RmtInf> [0..1] <Utrd> [0..n] Text Důvod platby (volitelné) 4. Pravidla dle ISO 20022 na vybrané tagy používané v KB PRO záhlaví: 1.1 MeageIdentification <MgId> (Identifikace zprávy) Definice: Reference Point-to-Point přiřazená tranou vydávající intrukci a odelaná další traně v řetězci za účelem jednoznačné identifikace zprávy. 5/21
Použití: Strana vydávající intrukci muí zajitit jedinečnot identifikace zprávy MeageIdentification pro tranu přijímající intrukci na předem dohodnuté období. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1 1.2 CreationDateTime <CreDtTm> (Datum a ča vytvoření) Klientký formát XML SEPA V KB Definice: Datum a ča vytvoření platební intrukce (kupiny intrukcí) tranou vydávající intrukci. Typ dat: Datum a ča ISO 1.5 NumberOfTranaction <NbOfTx> (Počet tranakcí) Definice: Počet jednotlivých tranakcí obažených ve zprávě. Typ dat: Max. 15, čílice, text Formát: [0-9]{1,15} 1.6 ControlSum <CtrlSum> (Kontrolní oučet) Definice: Součet všech jednotlivých čátek obažených ve zprávě bez ohledu na měny. Typ dat: Číla v deítkové outavě Formát: deetinná míta: 17 celkový počet mít: 18 1.7 Grouping <Grpg> (Sekupení) Definice: Označuje, zda jou běžné účetní informace tranakce uvedeny jednou pro všechny tranakce nebo opakovaně pro každou jednotlivou tranakci. V KB platí pouze jedna možnot: ingle (jednotlivě) SNGL 1.8 InitiatingParty <InitgPty> (Iniciující trana) Definice: Strana, která iniciovala platbu. Z hledika platby může jít buďto o plátce (při kreditním převodu), příjemce (při přímém inkau) nebo tranu, která iniciovala platbu jménem plátce nebo příjemce. Typ: Tento prvek zprávy e kládá z náledujících prvků PartyIdentification8: Or Prvek zprávy <XML Tag> Mult. Reprezent./Typ Name (Jméno) <Nm> [0..1] Text PotalAddre (Poštovní adrea) <PtlAdr> [0..1] V KB není přebíráno ani validováno. Využívá e adrea adminitrovaná v DB DCS. Pokud budete poílat truktura popána v kapitole 5 adrea v KB PRO platby 2.0 PaymentInformation <PmtInf> (Informace o platbě) Prezentace: [1..n] Definice: Souhrn vlatnotí, které platí pro tranu plátce platebních tranakcí obažených v iniciovaném kreditním převodu. Typ: Blok Payment information (Informace o platbě) e kládá z náledujících prvků PartyIdentification8: 6/21
Index OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB Klientký formát XML SEPA V KB 2.1 PaymentInformationIdentification <PmtInfId> [0..1] Text (Identifikace informací o platbě) 2.2 PaymentMethod (Platební metoda) <PmtMtd> [1..1] Kód TRF 2.3 PaymentTypeInformation (Informace o <PmtTpInf> [0..1] typu platby) 2.13 RequetedExecutionDate <ReqdExctnDt> [1..1] Datum a ča DATUM (Požadované datum provedení) 2.15 Debtor (Plátce) <Dbtr> [1..1] + nepřebírá e adrea a jméno pouze identifikace, je-li uvedena 2.16 DebtorAccount (Účet plátce) <DbtrAcct> [1..1] + IBAN měnu není nutné uvádět. Pokud je uvedena validuje e na tav v DB 2.17 DebtorAgent (Zprotředkující banka plátce) <DbtrAgt> [1..1] + Nepřebírá a nevaliduje. Banku validuje již v IBANu. 2.19 UltimateDebtor (Konečný plátce) <UltmtDbtr> [0..1] + KB zatím nepředává 2.20 ChargeBearer (Plátce poplatků) <ChrgBr> [0..1] Code KB doazuje SLEV, ale pokud uvedete a bude jiná hodnota než SLEV bude odmítnuto 2.21 ChargeAccount (Účet pro poplatky) <ChrgAcct> [0..1] + čílo účtu uvádět jen, když je jiné než pro vlatní platbu (vždy jen v KB) 2.23 CreditTranferTranactionInformation (Informace o kreditním převodu) 2.2 PaymentMethod <PmtMtd> (Platební metoda) Definice: Uvádí způob platby, který e použije k převedení dané finanční čátky. Typ dat: kód - TRF 2.13 RequetedExecutionDate <ReqdExctnDt> (Požadované datum provedení) <CdtTrfTxInf> [1..n] blok popiu kreditora Definice: Datum, k němuž iniciující trana požaduje zpracování platby protředníkem zúčtování. Při platbě šekem jde o datum, kdy muí být bankou vygenerován šek. Použití: K tomuto datu dojde k odepání z účtu (účtů) plátce. Typ dat: Datum ISO 2.15 Debtor <Dbtr> (Plátce) Definice: Strana, která dluží peníze (konečnému) příjemci. Typ: Tento prvek zprávy e kládá z náledujících prvků PartyIdentification8: Or Prvek zprávy <XML Tag> Mult. Reprezent./Typ Name (Jméno) <Nm> [0..1] Text PotalAddre <PtlAdr> [0..1] Viz kapitola 5 (Poštovní adrea) Identification [0..1] Viz kapitola 6 (Identifikace) CountryOfReidence (Země trvalého <CtryOfRe> [0..1] Code (Kód) 7/21
bydliště) Klientký formát XML SEPA V KB 2.16 DebtorAccount <DbtrAcct> (Účet plátce) Definice: Jednoznačná identifikace účtu plátce, na němž bude jako výledek tranakce provedena debetní položka. Typ: Tento prvek zprávy e kládá z náledujících prvků CahAccount7: Or Prvek zprávy <XML Tag> Mult. Reprezent./Typ Identification [1..1] <IBAN> (Identifikace) Currency (Měna) <Ccy> [0..1] Code (Kód) 2.17 DebtorAgent <DbtrAgt> (Banka plátce) Definice: Finanční intituce vedoucí účet plátce. Typ: Tento prvek zprávy e kládá z náledujících prvků BranchAndFinancialIntitutionIdentification3: Or Prvek zprávy <XML Tag> Mult. Reprezent./Typ FinancialIntitutionId entification (Identifikace finanční intituce) <FinIntnId> [1..1] <BIC> KB nevaliduje 2.19 UltimateDebtor <UltmtDbtr> (Konečný plátce) Definice: Konečná trana, která dluží peníze (konečnému) příjemci. Typ: Tento prvek zprávy e kládá z náledujících prvků PartyIdentification8: Or Prvek zprávy <XML Tag> Mult. Reprezent./Typ Name (Jméno) <Nm> [0..1] Text PotalAddre <PtlAdr> [0..1] Viz kapitola 5 (Poštovní adrea) Identification [0..1] Viz kapitola 6 (Identifikace) CountryOfReidence (Země trvalého bydliště) <CtryOfRe> [0..1] Code (Kód) 2.20 ChargeBearer <ChrgBr> (Plátce poplatků) Definice: Uvádí tranu (trany), které budou platit poplatky pojené e zpracováním platební tranakce. Typ dat: Code (Kód) Pokud je uveden tento prvek zprávy, muí e použít některá z náledujících hodnot ChargeBearerType1Code: Definice názvu kódu (pro KB SEPA lze použít pouze SLEV) CRED BorneByCreditor - Všechny poplatky za tranakci platí příjemce. DEBT BorneByDebtor - Všechny poplatky za tranakci platí plátce. SHAR Sdíleno - Při kreditním převodu znamená, že poplatky za tranakci na traně odeílatele platí plátce, poplatky za tranakci na traně příjemce platí příjemce. Při inkaním převodu znamená, že poplatky za tranakci na traně odeílatele platí příjemce, poplatky za tranakci na traně příjemce platí plátce. SLEV FollowingServiceLevel - Poplatky e uplatňují podle pravidel dohodnutých úrovní lužeb - plánu lužeb. 8/21
2.21 ChargeAccount <ChrgAcct> (Účet pro poplatky) Klientký formát XML SEPA V KB Definice: Účet používaný pro zpracování poplatků za tranakci. Použití: Účet pro poplatky e 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 e kládá z náledujících prvků CahAccount7: Or Prvek zprávy <XML Tag> Mult. Reprezent./Typ Identification [1..1] <IBAN> (Identifikace) Currency (Měna) <Ccy> [0..1] Code 2.23 CreditTranferTranactionInformation <CdtTrfTxInf> (Informace o kreditním převodu) Prezentace: [1..n] Definice: Skupina prvků pokytujících pecifické informace o jednotlivých tranakcích obažených ve zprávě. Typ: Tento prvek zprávy e kládá z náledujících prvků CreditTranferTranactionInformation1: Index OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 2.24 PaymentIdentification <PmtId> [1..1] (Identifikace platby) 2.27 PaymentTypeInformation <PmtTpInf> [0..1] (Informace o typu platby) 2.37 Amount (Čátka) <Amt> [1..1] 2.55 CreditorAgent (Banka příjemce) <CdtrAgt> [0..1] + 2.57 Creditor (Příjemce) <Cdtr> [0..1] + 2.58 CreditorAccount (Účet příjemce) <CdtrAcct> [0..1] + 2.59 UltimateCreditor (Konečný <UltmtCdtr> [0..1] + příjemce) 2.84 RemittanceInformation (Informace o úhradě) <RmtInf> [0..1] 2.37 Amount <Amt> (Čátka) Definice: Čátka peněz, která e 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í tranou. Typ: Tento prvek zprávy e kládá z některého z náledujících prvků AmountType2Choice: Index OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 2.38 IntructedAmount (Čátka v intrukci) <IntdAmt> [1..1] Amount v KB pouze EUR měna povolena 2.38 IntructedAmount <IntdAmt> (Čátka v intrukci) Tento prvek zprávy je oučátí volby 2.37 Čátka. Definice: Čátka peněz, která e 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í tranou. Typ dat: CurrencyAndAmount (Měna a čátka) Tento typ dat muí být použit náledujícím atributem XML: Currency (Ccy) ; zapiuje e jako CurrencyCode (Kód měny). Formát: CurrencyAndAmount (Měna a čátka) deetinná míta: 5 nejméně, včetně: 0 celkový počet mít: 18 9/21
CurrencyCode (Kód měny) [A-Z]{3,3} Pravidla: CurrencyCode (Kód měny) Validace podle tabulky Klientký formát XML SEPA V KB 2.55 CreditorAgent <CdtrAgt> (Banka příjemce) Definice: Finanční intituce vedoucí účet příjemce. Typ: Tento prvek zprávy e kládá z náledujících prvků BranchAndFinancialIntitutionIdentification3: Or Prvek zprávy <XML Tag> Mult. Reprezent./Typ FinancialIntitutionIdentification <FinIntnId> [1..1] <BIC> - banka muí (Identifikace finanční intituce) být SEPA complayed 2.57 Creditor <Cdtr> (Příjemce) Definice: Strana, jíž je finanční čátka platná. Typ: Tento prvek zprávy e kládá z náledujících prvků PartyIdentification8: Or Prvek zprávy <XML Tag> Mult. Reprezent./Typ Name (Jméno) <Nm> [0..1] Text PotalAddre (Poštovní adrea) <PtlAdr> [0..1] Viz kapitola 5 Identification (Identifikace) [0..1] Viz kapitola 6 CountryOfReidence (Země trvalého bydliště) <CtryOfRe> [0..1] Code (Kód) 2.58 CreditorAccount <CdtrAcct> (Účet příjemce) Definice: Jednoznačná identifikace účtu příjemce, na nějž bude jako výledek tranakce převedena kreditní položka. Typ: Tento prvek zprávy e kládá z náledujících prvků CahAccount7: Or Prvek zprávy <XML Tag> Mult. Repreze KB nt./typ Identification (Identifikace) [1..1] <IBAN> 2.59 UltimateCreditor <UltmtCdtr> (Konečný příjemce) Definice: Konečná trana, jíž je finanční čátka platná. Typ: Tento prvek zprávy e kládá z náledujících prvků PartyIdentification8: Or Prvek zprávy <XML Tag> Mult. Repreze KB nt./typ Name (Jméno) <Nm> [0..1] Text PotalAddre (Poštovní adrea) <PtlAdr> [0..1] Chapter 5 Identification (Identifikace) [0..1] Chapter 6 CountryOfReidence (Země trvalého bydliště) <CtryOfRe> [0..1] Code (Kód) 2.84 RemittanceInformation <RmtInf> (Informace o úhradě) Definice: Informace, které umožňují hodu (tj. eouhlaení) platby položkami, které má tato platba vypořádat, např. obchodní faktury v ytému pohledávek. Typ: Tento prvek zprávy e kládá z náledujících prvků RemittanceInformation1: 10/21
Index OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 2.85 Untructured (Netrukturováno) <Utrd> [0..n] Text použita jen netrukturova ná informace 2.85 Untructured <Utrd> (Netrukturováno) Klientký formát XML SEPA V KB Prezentace: [0..n] Definice: Informace umožňující hodu položky položkami, které má převod vypořádat, např. obchodní faktury v ytému pohledávek v netrukturované formě. Typ dat: Max. 140, text Formát: max. délka: 140, min. délka: 5. Detail ke kontrukci adrey v KB V KB bude vyžadováno využít pro kontrukci adrey trukturovaný přítup a použít patřičné tagy pro jméno, měto, ulici, čílo, měrovací kód, zemi. Validace adre je dle platných pravidel zahraničních plateb předávaných protřednictvím DCS (tejné jako u formátu BEST a EDI_BEST. 5.1.1 PotalAddre <PtlAdr> (Poštovní adrea) Definice: Informace, které určují a identifikují konkrétní adreu tak, jak je definovaná poštovními lužbami. Typ: Tento prvek zprávy e kládá z náledujících prvků PotalAddre1: REF OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 5.1.4 StreetName (Ulice) <StrtNm> [0..1] Text Nepovinný údaj 5.1.5 BuildingNumber (Čílo popiné) <BldgNb> [0..1] Text Nepovinný údaj 5.1.6 PotCode (PSČ) <PtCd> [0..1] Text Nepovinný údaj 5.1.7 TownName (Měto) <TwnNm> [0..1] Text Nepovinný údaj 5.1.9 Country (Země) <Ctry> [1..1] Code (Kód) Povinný údaj 5.1.4 StreetName <StrtNm> (Ulice) 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 <BldgNb> (Čílo popiné) Definice: Čílo domu v ulici. Typ dat: Max. 16 text, Formát: max. délka: 16 min. délka: 1 5.1.6 PotCode <PtCd> (PSČ) Definice: Poštovní měrovací čílo, popřípadě poštovní třídící kód. 11/21
Typ dat: Max. 16, text Formát: max. délka: 16 min. délka: 1 Klientký formát XML SEPA V KB 5.1.7 TownName <TwnNm> (Měto) Definice: Jméno měta, nebo oblati definované v hranicích mítní amoprávou. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1 5.1.9 Country <Ctry> (Země) Definice: Stát, země. Typ dat: Kód země Formát: [A-Z]{2,2} Pravidla: Země Kód e kontroluje proti eznamu názvů zemí vydávaný Organizací pojených národů (ISO 3166, kód Alpha 2). 6. Detail ke kontrukci Identifikace Organizace nebo Fyzické ooby v KB U plátce, příjemce, původního plátce a konečného příjemce má možnot klient předat identifikaci podle toho, zda e jedná o identifikaci organizace nebo identifikace oukromé ooby. V této kapitole je preentováno jaké tagy definované v XML jou přebírány v rámci KB. Logické využití je náledovné: Výběr typu identifikace - zda organizace nebo fyzická ooba Použití pro Organizaci (<OrgId>) - tag <PrtryID> vnořenými tagy pro identifikační údaje a <Ir> pro výtavce dokumentu Použití pro Oobu (<PrvtId>) - tag <OthrId> vnořenými tagy pro identifikační údaje a <IdTp> pro Typ dokumentu a tagu <Ir> pro výtavce dokumentu 5.1.10 Identification (Identifikace) Definice: Jedinečná a jednoznačná identifikace právnické, nebo fyzické ooby. Typ: Tento prvek zprávy e kládá z některého z náledujících prvků Party2Choice: REF OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 5.1.1 {Or OrganiationIdentification <OrgId> [1..1] 1 (Identifikace organizace) 5.1.2 3 Or} PrivateIdentification (Identifikace oukromé ooby) <PrvtId> [1..4] 5.1.11 OrganiationIdentification <OrgId> (Identifikace organizace) Tento prvek zprávy je oučátí volby 5.1.10 Identifikace. Definice: Jedinečný způob identifikace organizace. Typ: Tento prvek zprávy e kládá z náledujících prvků OrganiationIdentification2: REF OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 5.1.20 ProprietaryIdentification <PrtryId> [0..1] KB umožňuje (Identifikace regitrace) jen tento tag 5.1.20 ProprietaryIdentification <PrtryId> (Identifikace regitrace) 12/21
Definice: Jedinečný identifikátor organizace přidělený odpovědnou intitucí. Typ: Tento prvek zprávy e kládá z náledujících prvků GenericIdentification3: Klientký formát XML SEPA V KB REF OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 5.1.21 Identification (Identifikace) [1..1] Text Identifikační údaje 5.1.22 Iuer (Výtavce) <Ir> [0..1] Text Výtavce dokumentu 5.1.21 Identification (Identifikace) Definice: Název nebo čílo přiřazené určitým ubjektem za účelem rozpoznání tímto ubjektem, např. identifikátor účtu. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1 5.1.22 Iuer <Ir> (Výtavce) 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 <PrvtId> (Identifikace fyzické ooby) Prezentace: [1..4] Tento prvek zprávy je oučátí volby 5.1.10 Identifikace. Definice: Jedinečná identifikace fyzické ooby, např. cetovní pa. Typ: Tento prvek zprávy e kládá z náledujících prvků PeronIdentification3: REF OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 5.1.37 OtherIdentification (Další informace) <OthrId> [1..1] KB umožnuje jen tento tag 5.1.40 Iuer (Výtavce) <Ir> [0..1] Text Výtavce dokumentu 5.1.37 OtherIdentification <OthrId> (Další informace) Tento prvek zprávy je oučátí volby 5.1.23 PrivateIdentification. Definice: Identifikátor vydaný oobě, pro kterou nebyl definován žádný konkrétní identifikátor. Typ: Tento prvek zprávy e kládá z náledujících prvků GenericIdentification4: REF OR Prvek zprávy <XML Tag> Mult. Preentace Využito v KB 5.1.38 Identification (Identifikace) [1..1] Text Identifikační údaje 5.1.39 IdentificationType (Typ identifikace) 5.1.38 Identification (Identifikace) <IdTp> [1..1] Text Typ dokumentu Definice: Identifikátor vydaný oobě, 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 13/21
5.1.39 IdentificationType <IdTp> (Typ identifikace) Klientký formát XML SEPA V KB Definice: Specifikace typu identifikátoru. Použití: Typ identifikace e používá k zadání druhu použitého identifikátoru. Používá e v případě, že e identifikátor liší od identifikátorů uvedených v eznamu předdefinovaných identifikátorů. Typ dat: Max. 35, text Formát: max. délka: 35 min. délka: 1 5.1.40 Iuer <Ir> (Výtavce) Definice: Výtavce 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 <!-- Identifikace platce --> <Dbtr> <OrgId> <PrtryId> Identifikacni udaje <Ir>Vytavce dokumentu</ir> </PrtryId> </OrgId> </Dbtr> <!-- Identifikace prijemce --> <Cdtr> <PrvtId> 14/21
<OthrId> Identifikacni udaje <IdTp>Typ dokumentu</idtp> </OthrId> <Ir>Vytavce dokumentu</ir> </PrvtId> </Cdtr> <!-- Identifikace puvodniho platce --> <UltmtDbtr> <Nm>Jmeno nebo Nazev puvodniho platce</nm> </UltmtDbtr> <!-- Identifikace konecneho platce --> <UltmtCdtr> <PrvtId> <OthrId> Identifikacni udaje <IdTp>Typ dokumentu</idtp> </OthrId> <Ir>Vytavce dokumentu</ir> </PrvtId> </UltmtCdtr> Klientký formát XML SEPA V KB 15/21
Klientký formát XML SEPA V KB 8. Příklad XML e dvěma platbami Příklad dvou plateb odeílaných v jednom ouboru. První platba je odeílaná pro organizaci a druhá pro privátní oobu. V obou platbách jou 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čnoti v rámci klienta (pokud by uvedena nebyla, přebíralo by e pro tyto účely položka EndToEnd a muela by vyhovovat validaci na jedinečnot. V obou platbách je uveden ervice level SEPA, toto pole je nepovinné a KB jiný ervice level pro XML předané platby neprovádí. Poplatky nejou pecifikovány a banka i doplní pro SEPA defaultně SLEV. Čilo účtu pro poplatky je v jedné platbě tejné jako pro vlatní platbu a pro druhou je vyžadováno jiné čílo účtu. 16/21
Klientký formát XML SEPA V KB <?xml verion="1.0" encoding="windows-1250"?> <!--TKT_NTI mockup 2008-01-17 RC4--> <Document xmln="urn:io:td:io:20022:tech:xd:pain.001.001.02"> <!--CutomerCreditTranferInitiationV02 pain.001.001.02 --> <pain.001.001.02> <GrpHdr> <!-- Neprebirano --> <MgId>20071218PAY1234</MgId> <!-- Datum vytvoreni --> <CreDtTm>2008-01-17T16:36:00</CreDtTm> <!-- Pocet prikazu --> <NbOfTx>2</NbOfTx> <!-- Kontrolni oucet catek--> <CtrlSum>300.88</CtrlSum> <!-- Pouze SNGL!!! --> <Grpg>SNGL</Grpg> <!-- Neprebirano (identifikace trany, jež vytvorila oubor) --> <InitgPty> <Nm>ABC Conulting.r.o.</Nm> <PtlAdr> <StrtNm>U žluťoučkého koně</strtnm> <BldgNb>1622/12</BldgNb> <PtCd>158 00</PtCd> <TwnNm>Praha 13</TwnNm> <Ctry>CZ</Ctry> </PtlAdr> </InitgPty> </GrpHdr> <!-- PAYMENT 1 [BEGIN] {Organiation}--> <PmtInf> <!-- Neprebirano --> <PmtMtd>TRF</PmtMtd> <!-- Pozadovane datum platnoti --> <ReqdExctnDt>2008-03-18</ReqdExctnDt> <!-- Identifikace prikazce --> <Dbtr> <Nm>TKT_NTI a..</nm> <PtlAdr> <StrtNm>Na Příkopě</StrtNm> <BldgNb>22</BldgNb> <PtCd>114 07</PtCd> <TwnNm>Praha 1, Staré Měto</TwnNm> <Ctry>CZ</Ctry> </PtlAdr> <OrgId> <PrtryId> DIC 026-123456789 <Ir>Výtavce dokumentu platba 1</Ir> 17/21
</PrtryId> </OrgId> </Dbtr> Klientký formát XML SEPA V KB <!-- Cilo uctu prikazce --> <DbtrAcct> <IBAN>CZ0801000000353105260267</IBAN> <Ccy>USD</Ccy> </DbtrAcct> <!-- Neprebirano --> <DbtrAgt> <FinIntnId> <BIC>KOBACZPX</BIC> </FinIntnId> </DbtrAgt> > <CdtTrfTxInf> <PmtId> <!-- Klientke ID (v KB validace duplicitnich plateb) -- <IntrId>KB00001 klientké ID</IntrId> <!-- Reference prikazce --> <EndToEndId>00001 ID dohodnuté partnerem</endtoendid> </PmtId> <!-- Neprebirano --> <PmtTpInf> <SvcLvl> <Cd>SEPA</Cd> </SvcLvl> </PmtTpInf> <!-- Catka a mena platby (V KB pouze EUR!!!) --> <Amt> <IntdAmt Ccy="EUR">100.67</IntdAmt> </Amt> <!-- Typ poplatku --> <ChrgBr>SLEV</ChrgBr> <!-- Identifikace banky prijemce --> <CdtrAgt> <FinIntnId> <BIC>SOGEFRPP</BIC> </FinIntnId> </CdtrAgt> <!-- Udaje prijemce --> <Cdtr> <Nm>COMM France Ltd.</Nm> <PtlAdr> <StrtNm>Veine Jugulaire</StrtNm> <BldgNb>58/125B</BldgNb> <PtCd>3PA00</PtCd> <TwnNm>Pari</TwnNm> <Ctry>FR</Ctry> 18/21
</PtlAdr> <OrgId> <PrtryId> PCA000011789B <Ir>Pari Central Authority</Ir> </PrtryId> </OrgId> </Cdtr> Klientký formát XML SEPA V KB <!-- Cilo uctu prijemce --> <CdtrAcct> <IBAN>FR1420041010050500013M02606</IBAN> </CdtrAcct> <!-- Duvod platby --> <RmtInf> <Utrd>Good-and-Service-Tax Pay-Off (max length 140 character)</utrd> </RmtInf> </CdtTrfTxInf> </PmtInf> <!-- PAYMENT 1 [END] --> <!-- PAYMENT 2 [BEGIN] {Private}--> <PmtInf> <!-- Neprebirano --> <PmtMtd>TRF</PmtMtd> <!-- Pozadovane datum platnoti --> <ReqdExctnDt>2008-02-26</ReqdExctnDt> <!-- Identifikace prikazce --> <Dbtr> <Nm>TKT_NTI a..</nm> <PtlAdr> <StrtNm>Na Příkopě</StrtNm> <BldgNb>22</BldgNb> <PtCd>114 07</PtCd> <TwnNm>Praha 1, Staré Měto</TwnNm> <Ctry>CZ</Ctry> </PtlAdr> <OrgId> <PrtryId> DIC 026-123456789 <Ir>Výtavce dokumentu platba 2</Ir> </PrtryId> </OrgId> </Dbtr> <!-- Cilo uctu prikazce --> <DbtrAcct> 19/21
<IBAN>CZ0801000000353105260267</IBAN> <Ccy>USD</Ccy> </DbtrAcct> <!-- Neprebirano --> <DbtrAgt> <FinIntnId> <BIC>KOBACZPX</BIC> </FinIntnId> </DbtrAgt> Klientký formát XML SEPA V KB <!-- Ucet pro poplatky (+prip. mena)--> <ChrgAcct> <IBAN>CZ0801000000353105270297</IBAN> <Ccy>CZK</Ccy> </ChrgAcct> > <CdtTrfTxInf> <PmtId> <!-- Klientke ID (v KB validace duplicitnich plateb) -- <IntrId>KB00002 klientké ID</IntrId> <!-- Reference prikazce --> <EndToEndId>00002 ID dohodnuté partnerem</endtoendid> </PmtId> <!-- Neprebirano --> <PmtTpInf> <SvcLvl> <Cd>SEPA</Cd> </SvcLvl> </PmtTpInf> <!-- Catka a mena platby (V KB pouze EUR!!!) --> <Amt> <IntdAmt Ccy="EUR">200.21</IntdAmt> </Amt> <!-- Typ poplatku --> <ChrgBr>SLEV</ChrgBr> <!-- Identifikace puvodniho platce (SEPA 2)--> <UltmtDbtr> <Nm>NTI a..</nm> </UltmtDbtr> <!-- Identifikace banky prijemce --> <CdtrAgt> <FinIntnId> <BIC>DEUTDEDB101</BIC> </FinIntnId> </CdtrAgt> <!-- Udaje prijemce --> <Cdtr> <Nm>Han Friedrich</Nm> 20/21
<PtlAdr> <StrtNm>Halchlagader Strae</StrtNm> <BldgNb>1</BldgNb> <PtCd>14165</PtCd> <TwnNm>Berlin - Zehlendorf</TwnNm> <Ctry>DE</Ctry> </PtlAdr> <PrvtId> <OthrId> FS123456 <IdTp>Fuhrerchein</IdTp> </OthrId> <Ir>Zemký úřad Berlin</Ir> </PrvtId> </Cdtr> Klientký formát XML SEPA V KB <!-- Cilo uctu prijemce --> <CdtrAcct> <IBAN>DE89370400440532013000</IBAN> </CdtrAcct> <!-- Identifikace konecneho prijemce (SEPA 2 - prebirame, KB vak zatim nepouziva)--> <UltmtCdtr> <PrvtId> <OthrId> DE012345678901 <IdTp>Paport No.</IdTp> </OthrId> <Ir>Zemký úřad Mnichov</Ir> </PrvtId> </UltmtCdtr> <!-- Duvod platby --> <RmtInf> <Utrd>platba za dodávku lužeb/ervice-upply payment /VS/9876543210 /KS/10 (max length 140 character)</utrd> </RmtInf> </CdtTrfTxInf> </PmtInf> <!-- PAYMENT 2 [END] --> </pain.001.001.02> </Document> 21/21