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 k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 / -? : ( )., + 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 1.0 + Group Header (Záhlaví souboru) 1.1 ++ Message (Identifikace / Jméno souboru) 1.2 ++ Creation Date Time (Datum a čas vytvoření) 1.4 ++ Number of Transactions (Počet transakcí) 1.5 ++ Control Sum (Kontrolní součet) 1.6 ++ Inititating Party (Iniciující strana) 1.7 +++ Name (Jméno) <XML Tag> Mult. Presentace Využito v Bance <GrpHdr> [1..1] <MsgId> [1..1] Max35Text Jednoznačné ID souboru. (Generuje MC) <CreDtTm> [1..1] Datum a čas (Generuje MC) <NbOfTxs> [1..1] Max15NumericText Počet plateb v souboru. <CtrlSum> [0..1] Decimal-Number Součet částek v souboru. <InitgPty> [1..1] + <Nm> [0..1] Max70Text Jméno (Generuje MC)
3.2 N Informace o dávce (jeden soubor může obsahovat 1 až n dávek) Index Úroveň Prvek <XML Tag> Mult. Presentace Využito v Bance zprávy 2.0 + Payment <PmtInf> [1..n] + Information (Informace o dávce příkazů k SEPA platbě) 2.1 ++ Payment Information Identificatio n (ID dávky / batch) <PmtInfId> [1..1] Max35Text Obsahuje identifikaci dávky plateb, které mají být zpracovány. (Generuje MC) 2.2 ++ Payment Method (Platební metoda) <PmtMtd> [1..1] Kód TRF 2.3 ++ Batch Booking (Příznak dávkového zpracování) 2.4 ++ Number of Transaction s (Počet transakcí) 2.5 ++ Control Sum (Kontrolní součet) 2.6 ++ Payment Type Information (Informace o typu platby) <BtchBookg> [0..1] Indikátor true = dávkové zpracování nebo false = zpracování jednotlivých plateb <NbOfTxs> [0..1] Max15NumericText Počet plateb v dávce. <CtrlSum> [0..1] Decimal-Number Součet částek v dávce. <PmtTpInf> [0..1] +
2.8 +++ Service Level <SvcLvl> [0..1] + MMB akceptuje pouze hodnotu SEPA 2.15 ++ Requested Execution Date (Požadovan é datum provedení) 2.17 ++ Debtor (Plátce) <ReqExctnDt > [1..1] Datum Vyplňte požadované datum splatnosti. <Dbtr> [1..1] + Jméno, adresa (nestrukturovaně), identifikace. Detailní struktura adresy a identifikace v kapitole 3.4. 2.18 +++ Name (Jméno) 2.35 ++ Debtor Account (Účet plátce) 2.40 ++ Debtor Agent (Banka plátce) 2.52 ++ Ultimate Debtor (Původní plátce) 2.53 +++ Name (Jméno) <Nm> [1..1] Max70Text <DbtrAcct> [1..1] + Ve formátu IBAN <DbtrAgt> [1..1] + Ve formátu BIC / SWIFT kódu. <UltmtDbtr> [0..1] + Jméno, adresa (nestrukturovaně), identifikace. Detailní struktura adresy a identifikace v kapitole 3.4. <Nm> [0..1] Max70Text Jméno a příjmení
2.60 ++ Charge Bearer (Plátce poplatků) <ChrgBr> [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 <XML Tag> Mult Presentace Využito v Bance zprávy. 2.63 ++ Credit Transfer Transaction Information (Informace o kreditním převodu <CdtTrfTxInf> [1..n] + Obsahuje detailní informace k platbě. 2.64 +++ Payment (Identifikace platby) 2.65 ++++ Instruction (Identifikace instrukce) 2.66 ++++ End to End (Koncová Identifikace) 2.76 +++ Amount (Částka) <PmtId> [1..1] + Obsahuje identifikaci platby. (Generuje zpravidla MC) <InstrId> [0..1] Max35Text Identifikace platby <EndToEndId> [1..1] Max35Text Identifikace platby <Amt> [1..1] + Částka platby v měně EUR. 2.96 +++ Creditor Agent (Banka příjemce) <CdtrAgt> [0..1] + Ve formátu BIC/SWIFT kódu.
2.98 +++ Creditor (Příjemce) <Cdtr> [1..1] + Jméno, adresa (nestrukturovaně), identifikace. Detailní struktura adresy a identifikace v kapitole 3.4. 2.99 ++++ Name (Jméno) <Nm> [1..1] Max70Text Jméno a příjmení 2.116 +++ Creditor Account (Účet příjemce) <CdtrAcct> [1..1] + Ve formátu IBAN. 2.117 +++ Ultimate Creditor (Konečný příjemce) 2.118 ++++ Name (Jméno) 2.133 +++ Remittance Information (Informace o platbě) 2.134 ++++ Unstructured (Nestrukturo vané) <UltmtCdtr> [0..1] + Jméno, adresa (nestrukturovaně), identifikace. Detailní struktura adresy a identifikace v kapitole 3.4. <Nm> [1..1] Max70Text Jméno a příjmení <RmtInf> [0..1] + <Ustrd> [0..1] Max140Text Doplňující informace k SEPA platbě.
3.4. Detailní struktura vybraných polí Adresa Tag: <PstlAdr> Prvek zprávy <XML Tag> Mult. Presentace Využito v Bance Postal Address (Adresa) Country (Země) Address Line (Řádek adresy) <PstlAdr> [0..1] + <Ctry> [0..1] Kód Kód země <AdrLine> [0..2] Max70Text Ulice a Město Identifikace Tag: <Id> Prvek zprávy <XML Tag> Mult. Presentace Využito v Bance (Identifikace) Organisation (Identifikace organizace) Private (Osobní identifikace) <Id> [0..1] + <OrgId> [1..1] Hodnota z číselníku v MC. <PrvtId> [1..1] Hodnota z číselníku v MC
3.5 Příklad transakce <?xml version="1.0" encoding="utf-8"?> <Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03 pain.001.001.03.xsd"> <CstmrCdtTrfInitn> <GrpHdr> <MsgId>MCCT16101447094271097</MsgId> <CreDtTm>2016-10-14T08:49:27</CreDtTm> <NbOfTxs>2</NbOfTxs> <CtrlSum>203.00</CtrlSum> <InitgPty> <Nm>Jaroslav Ledvina</Nm> <PstlAdr> <Ctry>CZ</Ctry> </PstlAdr> </InitgPty> </GrpHdr> <PmtInf> <PmtInfId>16101400001</PmtInfId> <PmtMtd>TRF</PmtMtd> <BtchBookg>true</BtchBookg> <NbOfTxs>1</NbOfTxs> <CtrlSum>101.00</CtrlSum> <PmtTpInf> <SvcLvl> <Cd>SEPA</Cd> </SvcLvl> </PmtTpInf> <ReqdExctnDt>2016-10-14</ReqdExctnDt> <Dbtr> <Nm>Jaroslav Ledvina</Nm> <PstlAdr> <Ctry>CZ</Ctry> </PstlAdr> </Dbtr> <DbtrAcct> <Id> <IBAN>CZ3606000000000017353443</IBAN> </Id> <Ccy>CZK</Ccy>
</DbtrAcct> <DbtrAgt> <FinInstnId> <BIC>AGBACZPPXXX</BIC> </FinInstnId> </DbtrAgt> <ChrgBr>SLEV</ChrgBr> <CdtTrfTxInf> <PmtId> <InstrId>MCCT161014000002</InstrId> <EndToEndId>E2EC161013000001</EndToEndId> </PmtId> <Amt> <InstdAmt Ccy="EUR">101.00</InstdAmt> </Amt> <CdtrAgt> <FinInstnId> <BIC>DEUTDEDBDUE</BIC> </FinInstnId> </CdtrAgt> <Cdtr> <Nm>jmeno</Nm> <PstlAdr> <Ctry>DE</Ctry> <AdrLine>adresa</AdrLine> <AdrLine>mesto</AdrLine> </PstlAdr> <Id> <OrgId> <Othr> <Id>ŠKODA AUTO MLADÁ BOLESLAV</Id> </Othr> </OrgId> </Id> </Cdtr> <CdtrAcct> <Id> <IBAN>DE04300700240108232000</IBAN> </Id> </CdtrAcct> <RmtInf> <Ustrd>PLATBA FAKTURY123</Ustrd>
</RmtInf> </CdtTrfTxInf> </PmtInf> <PmtInf> <PmtInfId>16101400002</PmtInfId> <PmtMtd>TRF</PmtMtd> <BtchBookg>true</BtchBookg> <NbOfTxs>1</NbOfTxs> <CtrlSum>102.00</CtrlSum> <PmtTpInf> <SvcLvl> <Cd>SEPA</Cd> </SvcLvl> </PmtTpInf> <ReqdExctnDt>2016-10-14</ReqdExctnDt> <Dbtr> <Nm>TST3 PRIKAZCE</Nm> </Dbtr> <DbtrAcct> <Id> <IBAN>CZ5806000000000017353435</IBAN> </Id> </DbtrAcct> <DbtrAgt> <FinInstnId> <BIC>AGBACZPPXXX</BIC> </FinInstnId> </DbtrAgt> <ChrgBr>SLEV</ChrgBr> <CdtTrfTxInf> <PmtId> <InstrId>MCCT161014000001</InstrId> <EndToEndId>E2EC161013000002</EndToEndId> </PmtId> <Amt> <InstdAmt Ccy="EUR">102.00</InstdAmt> </Amt> <CdtrAgt> <FinInstnId> <BIC>GIBAATWWXXX</BIC> </FinInstnId> </CdtrAgt>
<Cdtr> <Nm>FIRMAABC</Nm> <PstlAdr> <Ctry>AT</Ctry> <AdrLine>Salmgasse 21</AdrLine> <AdrLine>Wien </AdrLine> </PstlAdr> </Cdtr> <CdtrAcct> <Id> <IBAN>AT123456789012345678</IBAN> </Id> </CdtrAcct> <UltmtCdtr> <Nm>Petra Novakova</Nm> <PstlAdr> <Ctry>CZ</Ctry> <AdrLine>ulice</AdrLine> <AdrLine>mesto</AdrLine> </PstlAdr> <Id> <PrvtId> <Othr> <Id>123456</Id> <SchmeNm> <Cd>DRLC</Cd> </SchmeNm> </Othr> </PrvtId> </Id> </UltmtCdtr> <RmtInf> <Ustrd>Platbafaktury123</Ustrd> </RmtInf> </CdtTrfTxInf> </PmtInf> </CstmrCdtTrfInitn> </Document>