Prenosový formát pain v štruktúre XML

Transcription

1 Prenosový formát pain v štruktúre XML Dokument obsahuje popis prenosového formátu pain pre spracovanie SEPA príkazov na úhradu v aplikácii Internet banking prostredníctvom importu dávkovej platby. Obsah Úvod... 1 Notácie, poznámky... 2 Základné elementy v koreňovom elemente CstmrCdtTrfInitn GroupHeader PaymentInformation... 3 Úvod Spracovanie dávkových súborov v štruktúre prenosového formátu pain , ktorý je definovaný v nasledovnom dokumente: SEPA CREDIT TRANSFER SCHEME CUSTOMER-TO-BANK IMPLEMENTATION GUIDELINES Tento dokument popisuje primárne špecifiká pre spracovanie SEPA platobných príkazov v aplikácii Internet banking Tatra banky. 1

2 Notácie, poznámky XML štruktúra je popísaná v tabuľkách s nasledovnými stĺpcami: ISO číslo elementu v podľa ISO Message Definition Report, PDF version názov elementu XML tag názov XML tagu Mult. násobnosť použitia elementu v štruktúre Type dátový typ Rule pravidlo používania Pre kódovanie znakov (diakritika) v textovom súbore je použitá kódová stránka uvedená v hlavičke súboru. Pokiaľ nie je uvedená, použije sa UTF-8. y, ktoré sú obsiahnuté v dokumente SEPA CREDIT TRANSFER SCHEME CUSTOMER-TO-BANK IMPLEMENTATION GUIDELINES a nie sú súčasťou tohto dokumentu import dávkovej platby aplikácia Internet banking Tatra banky nepodporuje. Základné elementy v koreňovom elemente CstmrCdtTrfInitn Správa pain pozostáva z 2 základných blokov/elementov: ISO XML tag Mult. 1.0 GroupHeader GrpHdr [1..1] 2.0 PaymentInformation PmtInf [1..n] GroupHeader ISO 1.0 GroupHeader GrpHdr [1..1] 1.1 +Message MsgId [0..1] Max35text 1.2 +CreationDateTime CreDtTm [0..1] DateTime 1.3 +Authorisation Authstn [0..2] Max3text or Proprietary Prtry [0..1] pattern [0-9]{3,3}/ [0-9]{3,3}/ [a-za-z0-9]{1,10} 1.6 +NumberOfTransactions NbOfTxs [0..1] 1.7 +ControlSum CtrlSum [0..1] 1.8 +InitiatingParty InitgPty [0..1] Party Name Nm [0..1] Text, pattern: [A-Za-z0-9]{1,10}/[A-Z]{2} 2

3 PaymentInformation ISO 2.0 PaymentInformation PmtInf [1..500] Max. 500 transakcií v súbore 2.1 +PaymentInformation PmtInfId [0..1] Max35text 2.2 +PaymentMethod PmtMtd [1..1] Musí byť TRF PaymentTypeInformation PmtTpInf [1..1] InstructionPriority InstrPrty [0..1] Musí byť NORM ServiceLevel SvcLvl [0..1] Nepovinné Code Cd [1..1] Musí byť SEPA LocalInstrument LclInstrm [0..1] Nepovinné Proprietary Prtry [0..1] Max35text Nesmie byť NO_FNDS_CHK Category Purpose CtgyPurp [0..1] Code Cd [0..1] Max4text RequestedExecution Date ReqdExctnD t [1..1] DateTime Povinné. Dátum musí byť rovnaký pre všetky platby. Nesmie byť spätný datum a dopredný dátum viac ako 31 dní Debtor Dbtr [1..1] Party Name Nm [1..1] Max70text Povinné PostalAddress PstlAdr [0..1] Postal Address AddressLine AdrLine [1..2] Max70text Povinné Country Ctry [0..1] Country Code Musí byť max. 70 znakov. Musí byť max. 70 znakov. Kód krajiny podľa normy ISO Id [0..1] Musí byť BIC kód alebo BEI hodnoty Other. Ak nie je pole vyplnené podľa SEPA, bude ignorované. 3

4 Organisation OrgId {or Musí byť BIC kód alebo BEI hodnoty Other Private PrvtId or} Povolená hodnota je Dátum jeden výskyt hodnoty Other Debtor Account DbtrAcct [1..1] Id [1..1] IBAN IBAN [1..1] IBAN2007 Identifier Platný IBAN debetného účtu transakcie. Povinné DebtorAgent DbtrAgt [1..1] FinancialInstitution FinInstnId [0..1] BIC BIC {or Musí byť iba TATRSKBX Other Othr or} Id UltimateDebtor UltmtDbtr [0..1] Name Nm [1..1] Max70text Povinné. Musí byť max. 70 znakov Id [0..1] Nadbytočné elementy budú Organisation OrgId {or Musí byť BIC kód alebo BEI hodnoty Other Private PrvtId or} Povolená hodnota je Dátum jeden výskyt hodnoty Other ChargeBearer ChrgBr [0..1] ChargeBearerType1Code Musí byť SLEV CreditTransfer TransactionInformation CdtTrfTxInf [1..n] Payment PmtId [1..1] Instruction InstrId [0..1] Max35text EndToEnd EndToEndId [1..1] 4

5 Detto ako element PaymentTypeInformation PmtTpInf [0..1] Vyplnený môže byť element 2.6 (vrátane zhodných vnorených elementov) alebo element 2.31 pre každú transakciu, nie oba elementy súčasne LocalInstrument LclInstrm [0..1] Proprietary Prtry [1..1] Max35text CategoryPurpose CtgyPurp [0..1] Code Cd [1..1] Max4text Amount Amt [1..1] Povinné Povinné InstructedAmount InstdAmt [1..1] Hodnota je použitá s atribútom currency, ktorý musí mať hodnotu EUR UltimateDebtor UltmtDbtr [0..1] Name [1..1] Max70text Id [0..1] Povinné. Musí byť max. 70 znakov. Nadbytočné elementy budú Organisation OrgId {or Musí byť BIC kód alebo BEI hodnoty Other Private PrvtId or} Povolená hodnota je Dátum jeden výskyt hodnoty Other CreditorAgent CdtrAgt [1..1] BranchAndFinancialInstituti on FinancialInstitution FinInstnId [1..1] BIC BIC [1..1] Ak je zadaný platný IBAN kreditného účtu a IBAN patrí účtu banky zo SEPA priestoru, nie je potrebné 5

6 BIC kód uvádzať, t.z., že element Document/CstmrCdtTrfInitn/ PmtInf/CdtTrfTxInf/CdtrAgt môže byť vynechaný. AK BIC kód, ktorý bol špecifikovaný z platného IBANu nepatrí do SEPA priestoru, platba bude zamietnutá. Ak je špecifikovaný BIC kód, bude kontrolovaný voči vypočítanému BIC kódu z IBANu. Prvých 6 znakov pôvodného a vypočítaného BIC kódu musí byť zhodných Creditor Cdtr [0..1] Do elementu je potrebné vyplniť názov účtu príjemcu. Ak názov nie je známy, uvedieme: NOTPROVIDED Name Nm [0..1] Max70text Musí mať max. 70 znakov PostalAddress PstlAdr [0..1] Postal Address AddressLine AdrLine [1..2] Max70text Na spracovanie budú poslané iba prvé dva riadky, ostatné budú ignorované Country Ctry [0..1] code. Country Kód krajiny podľa normy Code ISO 3166, Alpha Id [0..1] Nadbytočné elementy budú 2.79 Musí byť BIC kód alebo BEI ++++Organisation OrgId {or hodnoty Other Other Private PrvtId or} Povolená hodnota je Dátum jeden výskyt hodnoty Other CreditorAccount CdtrAcct [1..1] Povinné. 6

7 Id [1..1] IBAN IBAN [1..1] UltimateCreditor UltmtCdtr [0..1] IBAN2007 Identifier Platný IBAN kreditného účtu transakcie. Ak je IBAN kreditného účtu zo slovenskej banky, kontrola je vykonávaná aj na časť BBAN z čísla IBANu (t.z. posledných 10 miest čísla IBAN musí vyhovovať algoritmu modulo11) Name Nm [0..1] Musí byť max. 70 znakov Id [0..1] Nadbytočné elementy budú Organisation OrgId {or Musí byť BIC kód alebo BEI hodnoty Other Private PrvtId or} Povolená hodnota je Dátum jeden výskyt hodnoty Other Purpose Purp [0..1] Code Cd [1..1] Max4text Regulatory Reporting RgltryRptg [0..1] Details Dtls [1..1] Code Cd [1..1] Numeric text RemittanceInformation RmtInf [0..1] Platobný titul ak je uvedený musí byť platnou hodnotou z číselníka platobných titulov. Defaultna hodnota je 000 pre platby do EUR, 120 pre platby nad EUR. Vyplnený je element Ustrd alebo Strd Unstructured Ustrd {or Max140 Text Unstructured môže obsahovať štrukturovanú doplňujúcu informáciu, aká bola dohodnutá medzi platiteľom a príjemcom platby. Povolená je iba jedna inštancia Ustrd. Nadbytočné elementy budú Structured Strd or} Môže sa použiť ak nepresahuje 140 znakov. 7

8 Creditor Reference Information CdtrRefInf [0..1] Type Tp [0..1] Code or Proprietary CdOrPrtry [1..1] Code Cd [1..1] Max4text Musí byť SCOR Issuer Issr [0..1] Max35Text Reference Ref [0..1] Max35Text 8