Import príkazov na inkaso vo formáte XML

Transcription

1 Import príkazov na inkaso vo formáte XML Internet banking podporuje import príkazov na inkaso vo formáte XML, ktorého štruktúra je definovaná normou ISO Táto norma definuje viacero typov správ pre rôzne účely (inak povedané viacero typov XML súborov). Typ, ktorý je podporovaný internet bankingom pre import hromadných pain príkazov na inkaso má názov Štruktúra a definícia jednotlivých tagov tohoto xml súboru je popísaná v dokumente SEPA CORE DIRECT DEBIT SCHEME CUSTOMER-TO-BANK IMPLEMENTATION GUIDELINES Pri importe do internet bankingu sa v prvom rade vykonáva validácia súboru voči XSD schéme. XSD schéma popisuje štruktúru,poradie, početnosť a možné hodnoty jednotlivých elementov. XSD schéma pain sa nachádza na URL Súbor, ktorý nie je validný voči tejto schéme nebude v internet bankingu akceptovaný. Kontrolu validity možno vykonať pomocou rôznych voľne dostupných nástrojov ako napr. XML notepad Po úspešnej validácii voči xsd schéme systém ďalej validuje a zapisuje údaje jednotlivých transakcií. Popis ktorý xml element je ako používaný a prípadne validovaný je zobrazený v nasledujúcej tabuľke. Tam kde je v popise uvedené, že element je povinný, znamená to, že je nevyhnutný pre vytvorenie platobného príkazu. Ak v popise nie je informácia o povinnosti elementu, tento môže byť napriek tomu povinný z dôvodu definície štruktúry xml súboru popísanej v xsd schéme. Ak je niektorý element, ktorý nie je listom (t.j. má potomkov) v EB ignorovaný v tabuľke bude uvedený len tento hlavný element bez potomkov. Početnos ť Názov elementu XML tag Použitie/validácia +GroupHeader GrpHdr ++Messageentification Msg ++CreationDateTime CreDtTm [0..2] ++Authorisation Authstn ++NumberOfTransactions ++ControlSum NbOfTxs CtrlSum ++InitiatingParty InitgPty +PaymentInformation PmtInf ++PaymentInformation entification PmtInf ++PaymentMethod PmtMtd Musí byť DD Hlavička dávky. Pod týmto elementom sú informácie spoločné pre celú dávku, ako napr. kontrolné súčty, dátum, čas,... Dátum vytvorenie príkazu (pre všetky príkazy v dávke) Počet transakcií v dávke. Zapisovaný do bankového systému, ale nevalidovaný Kontrolný súčet trans. v dávke. Zapisovaný do bankového systému, ale nevalidovaný. Dávka príkazov na inkaso. Pod týmto elementom sú uvedené jednotlivé príkazy, ktoré majú spoločného inkasanta. Teoreticky môže byť takýchto dávok v súbore viac. ++Batch Booking BtchBookg Zapisovaný do bankového systému

2 ++NumberOfTransactions NbOfTxs Na tejto úrovní ignorovaný v EB ++ControlSum CtrlSum Na tejto úrovní ignorovaný v EB [0..7] ++PaymentTypeInformation PmtTpInf Povinný element. Ak je uvedené určuje spôsob realizácie príkazov uvedených v elemente. +++InstructionPriority +++ServiceLevel InstrPrty SvcLvl ++++Code Cd Musí byť SEPA ++++Proprietary +++LocalInstrument ++++Code Prtry LclInstrm Cd Ak je hodnota Norm príkazu budú spracované s normálnou prioritou, ak je hodnota High príkazy budú spracované zrýchlene. Ak už je uvedený element ServiceLevel, musí mať potomka typu Code a nie Proprietary Povinný element, zapisovaný do bankového systému.musí byť CORE alebo COR Proprietary Prtry Zapisovaný do bankového systému +++ Sequence Type SeqTp +++Category Purpose CtgyPurp Povinný element.ak je vyplený element Amendment Indicator a má hodnotu true a zároveň je vyplnený element Original debtor agent s hodnotou SMNDA tak tento element musí mať hodnotu FRST ++++Code Cd Zapisovaný do bankového systému ++++Proprietary Prtry Zapisovaný do bankového systému Povinný údaj reprezentujúci dátum splatnosti príkazu. Zapisovaný do bankového systému ++Requested Collection Date ++Creditor +++Name +++Postal Address ReqdColltnDt Cdtr Nm ++++Address Type AdrTp ++++Department Dept ++++Sub-Department SubDept ++++Street name StrtNm ++++Building Number BldgNb ++++Post Code PstCd ++++Town Name TwnNm ++++Country Sub-Division CtrySubDvsn ++++Country ++++Address line Ctry Povinný element, v ktorom sú údaje o inkasantovi (príjemcovi platby) Povinný údaj reprezentujúci názov príjemcu. Môže mať max. 70 znakov. Kód krajiny príjemcu podľa normy ISO 3166, zapisovaný do bankového systému Riadok adresy príjemcu, povolené sú len 2 vyskýty tohto elementu.(zvyšné sú

3 +++ entification ignorované) Zapisovaný do bankového systému ++++Organisation entification Org Zapisované do bankového systému. Prvt ++++Private entification +++Country of residence CtryOfRes +++Contact Details CtctDtls ++Creditor Account CdtrAcct Element reprezentujúci účet príjemcu Povinný,musí obsahovať potomka Iban v ktorom je uvedené IBAN č. účtu príjemcu. K tomuto účtu musí mať v EB aktívny prístup používateľ, ktorý vykonáva import xml súboru +++entification +++Type Tp +++Currency +++Name ++Creditor Agent +++Financial Institution entification ++++BIC ++++Other Ccy Nm CdtrAgt FinInstn Bic Othr +++Branch identification Brnch ++ Debtor Agent Account CdtrAgtAcct ++Ultimate Creditor UltmtCdtr (používa sa mena účtu z EB databázy) (používa sa názov účtu z EB databázy) Banka príjemcu, povolený sú len potomkovia typu BIC alebo Other. BIC kód banky príjemcu. Musí byť LUBASKBX alebo LUBASKBXXXX Ak je uvedený musí mať potomka entification s hodnotou NOTPROVIDED Element reprezentujúci pôvodného príjemcu.ak je uvedený na nižšej úrovni použije sa element uvedený v nižšej úrovni +++Name Nm Zapisovaný do bankového systému +++Postal Address ++++Address Type AdrTp ++++Department Dept ++++Sub-Department SubDept ++++Street name StrtNm ++++Building Number BldgNb ++++Post Code PstCd ++++Town Name TwnNm

4 [0..7] ++++Country Sub-Division CtrySubDvsn ++++Country ++++Address line Ctry +++ entification ++++Organisation entification ++++Private entification Org Prvt +++Country of residence CtryOfRes +++Contact Details CtctDtls ++Charge Bearer ChrgBr ++Charges Account ChrgsAcct ++Charges Account Agent ChrgsAcctAgt Kód krajiny pôvodného platiteľa podľa normy ISO 3166 zapisovaný do bankového systému. Riadok adresy pôvodného príjemcu, povolené sú len 2 vyskýty tohto elementu(zvyšné sú ignorované). Zapisovaný do bankového systému Any Bic a niekoľko potomkov Other. Povolený je však buď BIC alebo BEI kód uvedený v elemente Any Bic alebo jeden Ak je uvedený, povolená je len hodnota SLEV ++Creditor Scheme entification CdtrSchme Povinné buď na tejto alebo na nižšej úrovni. +++Name Nm +++Postal Address +++entification Povinný element ++++Organisationentification Org Nepovolený potomok ++++Privateentification Prvt Povinný element Date and Place of Birth Other +++ Country of Residence +++ Contact Details [1..n] ++Direct Debit Transaction Information +++Payment entification OthrArray DrctDbtTxInfArray Pmt V ptomkovi id by mal byť uvedený CID identifikátor inkasanta a v potomkovi Scheme Name a jeho potomkovi Proprietary musí byť uvedené SEPA ak je tento potomok vyplnený Pod týmto elementom sú uvedené jednotlivé inkasné transakcie ++++Instruction entification Instr Zapisovaný do bankového systému

5 ++++End to End entification +++PaymentTypeInformation +++Amount ++++Instructed Amount EndToEnd PmtTpInf Amt InstdAmt ++++Equivalent Amount EqvtAmt Nepovolený element +++Exchange rate information XchgRateInf +++Charge Bearer ChrgBr +++Direct Debit Transaction DrctDbtTx Povinný element ++++Mandate Related Information MndtRltdInf Povinný element Mandate entification Mndt Date Of Signature DtOfSgntr Amendment Indicator Amendment Information Details Original Mandate entification Original Creditor Scheme entification AmdmntInd AmdmntInfDtls OrgnlMndt Name Nm Postal Address entification Povinný element referencia platiteľa zapisovaný do bankového systému Pri tomto type súboru tento element je podporovaný iba na vyššej úrovni. Povinný element reprezentujúci sumu inkasného príkazu. Musí byť uvedený tento element namiesto elementu Equivalent Amount. Tento element má povinný atribút Ccy, ktorého hodnota musí byť EUR. Hodnotou elementu je suma v EUR.Zapisovaný do bankového systemu Ak je uvedený, povolená je len hodnota SLEV Povinný element, jednoznačná identifikácia mandátu Povinný element, dátum podpisu mandátu Zapisovaný do bankového systému Ak AmdmntInd=true tak tento element je povinný Zapisovaný do bankového systému Organisationentification Org Nepovolený potomok Privateentification Prvt Date and Place of Birth Other Country of Residence Contact Details Original Creditor Agent OthrArray CtryOfRes CtctDtls Zapisovaný potomok ID V potomkovi Scheme Name a jeho potomkovi Proprietary musí byť uvedené SEPA ak je tento potomok vyplnený Original Creditor Agent

6 Account Original Debtor Original Debtor Account Original Debtor Agent Original Debtor Agent Account Original Final Collection Date Original Frequency Electronic Signature First Collection Date Final Collection Date OrgnlDbt OrgnlDbtrAcct OrgnlDbtrAgt Povolený len potomok IBAN. Ignorované v EB Zapisovaný do bankového systému. Ak je uvedený SeqType element musí byť FRST Frequency ++++Creditor Scheme entification CdtrSchme Povinné buď na tejto alebo na vyššej úrovni Name Nm +++++Postal Address +++++entification Povinný element Organisationentification Org Nepovolený potomok Privateentification Prvt Povinný element Date and Place of Birth Other Country of Residence Contact Details ++++ Pre Notification entification ++++ Pre Notification Date +++Ultimate Creditor OthrArray UltmtCdtr V ptomkovi id by mal byť uvedený CID identifikátor inkasanta a v potomkovi Scheme Name a jeho potomkovi Proprietary musí byť uvedené SEPA ak je tento potomok vyplnený Element má prioritu pred rovnakým vyššie uvedeným elementom ++++Name Nm Zapisovaný do bankového systému ++++Postal Address +++++Address Type AdrTp +++++Department Dept +++++Sub-Department SubDept +++++Street name StrtNm +++++Building Number BldgNb

7 [0..7] +++++Post Code PstCd +++++Town Name TwnNm +++++Country Sub-Division CtrySubDvsn +++++Country +++++Address line ++++entification +++++Organisation entification +++++Private entification Ctry Org Prvt ++++Country of residence CtryOfRes ++++Contact Details CtctDtls +++ Debtor Agent DbtrAgt ++++Financial Institution entification FinInst +++ Debtor Agent Account DbtrAgtAcct Kód krajiny pôv. príjemcu podľa normy ISO 3166Zapisovaný do bankového systému Riadok adresy pôvodného príjemcu, povolené sú len 2 vyskýty tohto elementu(zvyšné sú ignorované).. Zapisovaný do bankového systému Any Bic a niekoľko potomkov Other. Povolený je však buď BIC alebo BEI kód uvedený v elemente Any Bic alebo jeden Banka platiteľa, ak je uvedený element DbtrAgt, tak tento element je povinný. Povolený je len potomok BIC ktorého hodnota určuje BIC kód banky príjemcu. Zapisovaný do bankového systému Debtor Dbtr Povinný element s údajmi o platiteľovi Povinný element názov platiteľa zapisovaný do bankového systému. Max. dĺžka 70 Nm znakov Name ++++Postal Address +++++Address Type AdrTp +++++Department Dept +++++Sub-Department SubDept +++++Street name StrtNm +++++Building Number BldgNb +++++Post Code PstCd +++++Town Name TwnNm +++++Country Sub-Division CtrySubDvsn +++++Country Ctry Kód krajiny platiteľa podľa normy ISO 3166,

8 [0..7] [0..7] +++++Address line ++++entification +++++Organisation entification +++++Private entification Org Prvt ++++Country of residence CtryOfRes ++++Contact Details CtctDtls zapisovaný do bankového systému Riadok adresy platiteľa, povolené sú len 2 vyskýty tohto elementu(zvyšné sú ignorované).. Zapisovaný do bankového systému Any Bic a niekoľko potomkov Other. Povolený je však buď BIC alebo BEI kód uvedený v elemente Any Bic alebo jeden +++Debtor Account CdtrAcct Element reprezentujúci účet platiteľa Povinný,musí obsahovať potomka Iban v ktorom je uvedené IBAN č. účtu platiteľa. ++++entification ++++Type Tp ++++Currency Ccy ++++Name Nm +++ Ultimate Debtor UltmtCdtr Element reprezentujúci pôvodného príjemcu ++++Name Nm Zapisovaný do bankového systému ++++Postal Address +++++Address Type AdrTp +++++Department Dept +++++Sub-Department SubDept +++++Street name StrtNm +++++Building Number BldgNb +++++Post Code PstCd +++++Town Name TwnNm +++++Country Sub-Division CtrySubDvsn +++++Country +++++Address line ++++entification Ctry Kód krajiny pôv. platiteľa podľa normy ISO 3166Zapisovaný do bankového systému Riadok adresy pôvodného platiteľa, povolené sú len 2 vyskýty tohto elementu(zvyšné sú ignorované).. Zapisovaný do bankového systému +++++Organisation entification Org

9 [0..10] [0..10] +++++Private entification Prvt ++++Country of residence CtryOfRes ++++Contact Details CtctDtls +++Instruction for Creditor Agent InstrForCdtrAgt +++Instruction for Debtor Agent InstrForDbtrAgt +++ Purpose Purp +++Regulatory Reporting RgltryRptg +++Tax Tax +++Related Remittance Information RltdRmtInf +++Remittance Information RmtInf Any Bic a niekoľko potomkov Other. Povolený je však buď BIC alebo BEI kód uvedený v elemente Any Bic alebo jeden ++++ Unstructured Ustrd ++++ Structured Strd Spracovávaný je len 1. výskyt tohto element Referred Document Information RfrdDocInf Referred Document Amount RfrdDocAmt Creditor Reference Information CdtrRefInf Type Tp Code or Proprietary CdOrPrtry Code Cd Proprietary Prtry Ak je zadaný, musí mať aj zadaných potomkov Type a Reference Povolená iba hodnota SCOR. Zapisovaný do bankového systému Issuer Issr Zapisovaný do bankového systému Zapisovaný do bankového systému. Mala by Reference Ref byť použitá hodnota podľa normy ISO Invoicer Invoicer Invcr Invcee [0..3] Additional Remittance Information AddtlRmtInf