Import platebních příkazů SEPA CT ve formátu XML
SBERBANK CZ
26.10.2016
Obsah
1.
Úvod ...................................................................................................................................................... 3
2.
Struktura XML........................................................................................................................................ 3
3.
Popis XML .............................................................................................................................................. 4 Hlavička ......................................................................................................................................... 5 Platební příkaz ............................................................................................................................... 5
2
1.
Úvod
Dokument obsahuje popis a specifika XML přenosového formátu pain.001.001.003 pro zpracování SEPA plateb prostřednictvím importu dávkové platby v aplikacích Gemini Homebanking a MultiCash ve Sberbank CZ. Zpracování dávkových XML souborů odpovídá standardu, který je definovaný v následující specifikaci: SEPA Credit Transfer Scheme Customer-to-Bank Implementation Guidelines Version 8.0 http://www.europeanpaymentscouncil.eu/index.cfm/knowledge-bank/epc-documents/sepacredit-transfer-scheme-customer-to-bank-implementation-guidelines-version-8/ Pro validaci je dostupné XSD schéma pain.001.001.03: https://www.iso20022.org/documents/messages/1_0_version/pain/schemas/pain.001.001.03.zip
2.
Struktura XML
Hlavička souboru (Group Header) Tento blok je povinný a vyskytuje se jenom jednou. Jeho úlohou je identifikace XML souboru.
Blok informací o platbě/skupině plateb (Payment Information) Tento blok je povinný a může se vyskytnout v rámci jednoho XML souboru opakovaně. Obsahuje informace společné pro celou skupinu transakcí.
Blok informací o transakcích (Credit Transfer Transaction Information) Tento blok je povinný a může se vyskytnout v rámci jednoho XML dokumentu opakovaně. Jsou v něm uvedeny jednotlivé transakce.
3
Obrázek znázorňuje strukturu XML souboru: PAIN.001
GroupHeader
Payment Information 1
Credit Transfer Transaction Information 1
Credit Transfer Transaction Information N
Payment Information N
Credit Transfer Transaction Information 1
Credit Transfer Transaction Information N
3.
Popis XML
Elementy, které jsou obsažené v dokumentu SEPA CREDIT TRANSFER SCHEME CUSTOMER-TO-BANK IMPLEMENTATION GUIDELINES a nejsou součástí tohoto dokumentu, Sberbank CZ nepodporuje. Vysvětlení ke sloupcům použitých tabulek: ID – Identifikátor elementu podle dokumentace SEPA. Mult. – Specifikuje povinný nebo volitelný stav elementu a jeho násobnost. Element – Název elementu. XML Tag – Název XML tagu.
4
Hlavička ID 1.0 1.1 1.2 1.4 1.5 1.6
Mult. [1..1] [1..1] [1..1] [1..1] [0..1] [1..1]
Element +Group Header ++Message Identification ++Creation Date Time ++Number Of Transactions ++Control Sum ++Initiating Party
XML Tag GrpHdr MsgId CreDtTm NbOfTxs CtrlSum InitgPty
Popis
Popis Informace o platbě. Pod tímto elementem jsou uvedeny jednotlivé platby, které mají společného plátce. Identifikace dávky plateb, které mají být zpracovány. Hodnota „TRF“ Sberbank CZ nepřebírá. Na této úrovní ignorován. Na této úrovní ignorován.
Identifikace zprávy. Datum a čas vytvoření. Počet transakcí v dávce. Kontrolní součet transakcí v dávce. Iniciující strana. Sberbank CZ nepřebírá.
Platební příkaz ID 2.0
Mult. [1..n]
Element +Payment Information
XML Tag PmtInf
2.1
[1..1]
PmtInfId
2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 2.11 2.12 2.13 2.14
[1..1] [0..1] [0..1] [0..1] [0..1] [0..1] [0..1] [1..1]
2.15 2.17
Buď Anebo [1..1] [1..1]
++Payment Information Identification ++Payment Method ++Batch Booking ++Number Of Transactions ++Control Sum ++Payment Type Information +++Instruction Priority +++Service Level ++++Code +++Local Instrument ++++Code ++++Proprietary +++Category Purpose ++++Code ++++Proprietary ++Requested Execution Date ++Debtor
2.18 2.19 2.28 2.29
[0..1] [0..1] [0..1] [0..7]
+++Name +++PostalAddress ++++Country ++++Addressline
Nm PstlAdr Ctry AdrLine
2.30 2.31 2.32 2.35 2.36
[0..1] Buď Anebo [1..1] [1..1]
+++ Identification ++++Organisation Identification ++++Private Identification ++Debtor Account +++Identification
Id OrgId PrvtId DbtrAcct Id
2.38
[0..1]
+++Currency
Ccy
2.40
[1..1]
++Debtor Agent
DbtrAgt
Buď Anebo
PmtMtd BtchBookg NbOfTxs CtrlSum PmtTpInf InstrPrty SvcLvl Cd LclInstrm Cd Prtry CtgyPurp Cd Prtry ReqdExctnDt Dbtr
Sberbank CZ nepřebírá. Hodnota “SEPA“. Zapsán do bankovního systému. Zapsán do bankovního systému. Zapsán do bankovního systému. Zapsán do bankovního systému. Požadované datum provedení. Sberbank CZ údaje nepřebírá, ale používá údaje z bankovního systému. Název plátce. Adresa plátce. Kód země plátce podle normy ISO 3166. Řádek adresy plátce. Povoleny jsou maximálně 2 výskyty tohoto elementu. Identifikace plátce. Zapsán do bankovního systému. Zapsán do bankovního systému. Element reprezentuje účet plátce. Musí obsahovat potomka Iban v kterém je uveden IBAN čísla účtu plátce. Sberbank CZ nepřebírá. Používá se měna účtu plátce.
5
2.41
[1..1]
+++Financial Institution Identification ++++BIC ++Ultimate Debtor +++Name +++Identification ++++Organisation Identification ++++Private Identification ++ChargeBearer ++Credit Transfer Transaction Information +++Payment Identification ++++Instruction Identification ++++End To End Identification +++Payment Type Information
FinInstnId
Banka plátce.
2.42 2.52 2.53 2.55 2.56 2.57 2.60 2.63
[1..1] [0..1] [0..1] [0..1] Buď Anebo [0..1] [1..n]
Bic UltmtDbtr Nm Id OrgId PrvtId ChrgBr CdtTrfTxInf
BIC kód banky plátce. Hodnota „VBOECZ2X“. Element reprezentuje účet původního plátce. Jméno koncového plátce.
2.64 2.65 2.66 2.67
[1..1] [0..1] [1..1] [0..1]
PmtId InstrId EndToEndId PmtTpInf
Identifikace platby.
2.69 2.70 2.72 2.73 2.74 2.75
[0..1] [1..1]
2.76 2.77
Buď Anebo [1..1] [1..1]
++++Service Level +++++Code ++++Local Instrument +++++Code +++++Proprietary ++++Category Purpose +++++Code +++++Proprietary +++Amount ++++Instructed Amount
SvcLvl Cd LclInstrm Cd Prtry CtgyPurp Cd Prtry Amt InstdAmt
2.80 2.82
[0..1] [0..1]
+++Charge Bearer +++Ultimate Debtor
ChrgBr UltmtDbtr
2.83 2.85 2.86 2.87 2.96
[0..1] [0..1] Buď Anebo [0..1] [1..1]
Nm Id OrgId PrvtId CdtrAgt FinInstId
[1..1] [1..1] [1..1] [0..1] [0..1] [0..7]
++++Name ++++Identification +++++Organisation Identification +++++Private Identification +++Creditor Agent ++++Financial Institution Identification +++++BIC +++Creditor ++++Name ++++Postal Address +++++Country +++++Address line
2.111 2.112 2.113 2.116
[0..1] Buď Anebo [1..1] [1..1]
++++Identification +++++Organisation Identification +++++Private Identification +++Creditor Account ++++Identification
Id OrgId PrvtId CdtrAcct Id
2.117 2.118 2.120 2.121
[0..1] [0..1] [0..1] Buď
+++Ultimate Creditor ++++Name ++++Identification +++++Organisation Identification
UltmtCdtr Nm Id OrgId
2.98 2.99 2.100 2.109 2.110
Buď Anebo
Bic Cdtr Nm PstlAdr Ctry AdrLine
Zapsán do bankovního systému. Zapsán do bankovního systému. V případě, že je uveden, obsahuje hodnotu “SLEV“. Element obsahuje jednotlivé platební příkazy.
Reference plátce. Element má prioritu před elementem na vyšší úrovni. Hodnota “SEPA“. Zapsán do bankovního systému. Zapsán do bankovního systému. Zapsán do bankovního systému. Zapsán do bankovního systému. Element reprezentuje sumu platebního příkazu. Element má povinný atribut ‘Ccy’, jehož hodnota musí být ‚EUR‘. Hodnotou elementu je suma v EUR. V případe, že je uveden, obsahuje hodnotu “SLEV“. Element má prioritu před stejným výše uvedeným elementem. Jméno koncového plátce. Identifikace koncového plátce. Zapsán do bankovního systému. Zapsán do bankovního systému. Banka příjemce. BIC kód banky příjemce. Element s údaji o příjemci platby. Název/jméno příjemce. Adresa příjemce. Kód země příjemce podle normy ISO 3166. Řádek adresy příjemce. Povoleny jsou maximálně 2 výskyty tohoto elementu. Identifikace příjemce. Zapsán do bankovního systému. Zapsán do bankovního systému. Element reprezentuje účet příjemce. Musí obsahovat potomka Iban v kterém je uveden IBAN čísla účtu plátce. Element reprezentuje účet původního příjemce. Název/Jméno koncového příjemce. Identifikace koncového příjemce. Zapsán do bankovního systému.
6
2.122 2.127 2.133 2.134
Anebo [0..1] [0..1] [0..1]
+++++Private Identification +++Purpose +++Remittance Information ++++Unstructured
PrvtId Purp RmtInf Ustrd
Zapsán do bankovního systému. Účel platby. Zpráva pro příjemce.
7