Popis formátu pre SEPA inkasá - SDD

Transkript

1 Popis formátu pre SEPA inkasá - SDD Tento dokument je majetkom VÚB, a.s. Dokument bol vytvorený výhradne pre ú ely informovanosti klientov VÚB, a.s. používajúcich aplikácie elektronického bankovníctva Biznis Banking a ulticash. 1.1 Ú el dokumentu Ú elom tohto dokumentu je u ah i klientom VÚB,a.s. používajúcich aplikácie Biznis banking a ulticash orientáciu v popise štruktúry formátu pre SEPA inkasá vychádzajúceho z normy IS Všeobecne platí, že VÚB. a.s. používa pre spracovanie SEPA transakcií formát pod a štandardu IS2022 pod a posledne platbého EPC rulebooku pre inkasá pod a schémy pain Príslušná XSD schéma definuje štruktúru XL formátu, validuje ktoré elementy sú v rámci formátu povolené, kontroluje ich mandatórnos, obsah, d žku a povolené hodnoty. Samotná schéma je umiestnená na web stránke IS Popis polí (tagov) XL štruktúry je extraktom celej pain štruktúry. Tieto polia sú publikované vo formulároch pre zadávanie inkás v jednotlivých aplikáciách, VÚB banka ich následne na svojej strane spracováva.

2 1.2 Štruktúra XL formátu Samotný XL súbor pripravený pre import do aplikácií VÚB, a.s. musí obsahova jeden konkrétny Document (bálku) - ktorá predstavuje jeden XL súbor. XL TAG Document pakovate nos Iba jeden krát v rámci súboru V sú asnosti zadefinovaná schéma: * xmlns:xsi=" * xmlns="urn:iso:std:iso:20022:tech:xsd:pain " +CstmrDrctDbtInitn Iba jeden krát v rámci súboru ++GrpHdr Iba jeden krát v rámci Blok hlavi ky súboru (Group Header) CstmrDrctDbtInitn ++ PmtInf Jeden alebo viackrát v rámci Blok informácií o inkase (skupine inkás) PPIS CstmrDrctDbtInitn Predstavuje logické zoskupenie inkás, za ktorým nasledujú informácie o jednotlivých inkasách alej uvedených v bloku DrctDbtTxInf. Všetky konkrétne inkasá takto zoskupené musia ma : * Spolo ný ú et kreditora a Spolo ný požadovaný dátum splatnosti +++DrctDbtTxInf Jeden alebo vaickrát v rámci Blok informácií o konkrétnom inkase. PmtInf Popis inštrukcií súvisiaci s konnkrétnym inkasom. XL súbor je zostavený z 3 blokov: 1. Hlavi ka súboru - Group Header Block: Tento blok je povinný a vyskytuje sa iba jeden krát. Jeho úlohou je identifikácia celého XL súboru. bsahuje údaje ako ID súboru, Dátum a as vytvorenia. 2. Blok informácií o inkase (skupine ) - Payment Information Block: Tento blok je povinný a môže sa vyskytnú v rámci jedného XL súboru opakovane. Reprezentuje logické zoskupovanie skupiny inkás pod a spolo ných znakov (dátum splatnosti, ú et kreditora, ú el,...), ktoré sú platné pre celú skupinu inkás. 3. Blok informácií o transakciách - inkasách Transaction information block. Tento blok je povinný a môže sa vyskytnú v rámci jedného XL dokumentu opakovane. Sú v om uvedené jednotlivé transakcie, ktoré majú by uskuto nené. Reprezentujú hlavne údaje, viažúce sa k strane platite a každej konkrétnej transakcie - meno platite a, ú et platite a, banka paltite a - samozrejme suma úhrady a ostatné nepovinné informácie. brázok znázor uje, ako je tvorená štruktúra XL súboru - Document. 1.3 pakujúci sa výskyt dát Štruktúra XL súboru dovo uje, aby sa niektoré typy dát vyskytovali i už na úrovni Bloku informácií o inkase (skupine ) - Payment Information Block alebo na úrovni Bloku informácií o inkasách - Transaction information block. Informácie na úrovni Payment Information Block majú vždy prednos pred informáciami na úrovni Transaction information block (DrctDbtTxInf) a v prípade ich naplnenia aj na tejto úrovni budú pre spracovanie v banke ignorované - použijú sa informácie z úrovne Payment Information Block. 1.4 Detaily transakcií Pod a legislatívy EU je potrebné pre SEPA inkasá - SEPA Direct Debit (SDD) pre identifikáciu platite a uvádza BIC a IBAN formát ú tu, frekvenciu inkasa a jednozna ný identifikátor mandátu. 1.5 Poplatky Pre SEPA inkasá (SDD) je potrebné uvádza typ poplatku SLEV. V prípade ak nebude tento typ poplatku v platbe uvedený, banka ho doplní.

3 2. SDD Format descriptions 2. Popis formátu pre SEPA inkasa GRUP HEADER Hlavi ka správy / súboru XL Reference Name Type / AX Lenght and Notes ++<sgid> ++<CreDtTm> ++<NbfTxs> ++<CtrlSum> ++<InitgPty> +++<Nm> ++<InitgPty> essage Id Creation Date/Time Header No of Transations Header Control Sum Initiating party name Initiating party rganization Id VARCHAR2(35) DATE (IS) NUBER(15) NUBER(18,2) VARCHAR2(70) VARCHAR2(35) Identifikátor správy (súboru). Zadané na strane klienta Dátum a as vytvorenia súboru na strane klienta Po et transakcií v správe / súbore Celková hodnota transakcií v správe / súbore eno organizácie vytvárajúcej správu / súbor ID organizácie (pokia má pridelené) PAYENT INFRATIN BLCK Payment Information XL Tag Crediting information XL Reference Name Type / AX Lenght and Notes ++<PmtInfId> ++<PmtItd> Payment Information Id Payment method VARCHAR2(35) VARCHAR2(2) Jednozna ný identifikátor skupiny inkás priradený na strane klienta etóda platby - pre SEPA úhrady vždy "DD" ++<BtchBookg> ++<NbfTxs> ++<CtrlSum> Batch Booking VARCHAR2(35) Bu TRUE alebo FALSE - ozna uje i v rámci skupiny platieb je zaú tovaný kredit v celkovej hodnote alebo jednotlivé transakcie. Na strane VÚB nepoužívame - doporu ujeme FALSE. Block No of transactions NUBER(15) Po et transakcíí v bloku skupiny transakcií Payment Information Block Block Control Sum NUBER(18,2) Celková hodnota platieb v bloku skupiny transakcií Payment Information Block ++<PmtTpInf> Payment Type Information Definuje informácie o skupinetransakcií (DD) a jednotlivé atribúty platné pre uvedenú skupinu. Atribúty ozna ené * prislúchajúce bloku skupiny transakcií môžu by publikované aj na úrovni samotnej transakcie. Pod a doporu enia EPC je doporu ené uvádza tieto atribúty na úrovni bloku Payment Information a nie na úrovni Transaction information. V prípade, že nasledovné atribúty ozna ené * budú uvedené na oboch úrovniach, prednos majú atribúty na úrovni Payment Information a hodnoty na úrovni Transaction information nebudú spracované. ++<PmtTpInf> +++<SvcLvl> ++++<Cd> ++<PmtTpInf> +++<LclInstrm> ++++<Cd> Service level code - Scheme name* AT20 VARCHAR2(4) Local instrument Code AT20 VARCHAR2(4) Kód identifikácie schémy. V prípade naplnenia použi iba hodnotu SEPA. Kód identifikácie schémy. Zatia iba CRE. Po pristúpení SK bánk k B2B schéme inkasa bude môc by v tomto údaji uvedené aj B2B ++<PmtTpInf> Sequence Type* AT21 VARCHAR2(4) Typ frekvencie inkasa. Povolené hodnoty sú: FRST - pre prvé inkaso, RCUR - pre opakované inkaso, FF - jednorázové inkaso, FNAL - posledné inkaso. Korektné použitie typu frekvencie inkasa je pod a SEPA rulebook povinné. +++<SeqTp> ++<PmtTpInf> +++<CtgyPurp> ++++<Cd> ++<ReqdColltnDt> +++<Nm> <Ctry> AdrLine AdrLine <BICrBEI> ALEB <CdtrAcct> <IBAN> ++<CdtrAgt> +++<FinInstnId> ++++<BIC> Category Purpose Code* AT59 VARCHAR2(4) Kategória ú elu inkasa. Ak je hodnota uvedená - iba pod a íselníku IS VÚB túto hodnotu prenáša protistrane. Requested Collection Date AT11 DATE (IS) Požadovaný dátum zaú tovania transakcie. VÚB akceptuje transakcie s požadovaným dátumom zaú tovania max +30 dní vopred. Creditor Name AT03 VARCHAR2(70) eno príkazcu - kreditora Creditor Postal Adress Country AT05 VARCHAR2(2) Dva znaky kodu krajiny príkazcu - IS. Creditor Postal Adress Line1 VARCHAR2(70) Identifikácia adresy príkazcu 1 Creditor Postal Adress Line2 VARCHAR2(70) Identifikácia adresy príkazcu 2 ID identifikácia kreditora - nepovinné údaje. Creditor rganization Id VARCHAR(11) ID kreditora - v prípade že má takéto BIC or BEI pridelené Registra nou autoritou a medzinárodnou schémou. Creditor rganization Id VARCHAR(35) ID kreditora - ak má pridelené. Creditor Account IBAN AT04 VARCHAR2(34) íslo ú tu príkazcu - kreditora vedeného vo VÚB vo formáte IBAN Creditor Agent BIC AT12 VARCHAR2(11) BIC kód VÚB - SUBASKBX V tejto asti XL formátu platieb je možné uvies nepovinné informácie o Koncovom príjemcovi / Ultimate creditor. Detailný popis v kapitole 3.2 v bloku Koncový príjemca / Ultimate creditor. AT38 ++<ChrgBr> ++<CdtrSchmeId> <PrvtId> Charge bearer VARCHAR2(4) Creditor scheme identification AT02 VARCHAR2(35) Pre SEPA DD treba uvádza hodnotu SLEV. Pokia bude táto hodnota umiestnená na tejto úrovni, bude hodnota platná pre všetky jednotlivé transakcie viažúce sa k bloku PmtInf. CID kreditora pridelené príslušnou inštitúciou. V prípade že údaj bude uvedený na tejto úrovni - bude použitý pre všetky transakcie na úrovni DrctDbtTxInf.

4 TRANSACTIN INFRATIN BLCK Direct Debit Transaction Information XL Tag XL Reference Name Type / AX Lenght and Notes +++<PmtId> ++++<InstrId> Instruction ID VARCHAR2(35) Identifikátor konkrétnej transakcie. Informácia zadaná na tomto mieste bude spracovaná na strane banky a bude publikovaná v XL výpise.v prípade jej neuvedenia doplní VÚB. +++<PmtId> ++++<EndToEndId> End to End Identification AT10 VARCHAR2(35) End 2 End informácia od zákazníka k platite ovi. V prípade ak nebude uvedené, banka doplní "NT PRVIDED". Pri využití doteraz používaných symbolov v domácom platobnom styku je to miesto, kde budú uvedené v dohodnutej štruktúre napr. /VS123/SS456/KS0308. Jedná sa o jednozna ný identifikátor transakcie, ktorý bude prenesený banke protistrany. Nižšie vyzna ené tagy mohli by uvedené aj na úrovni bloku PmtInf. V prípade ak boli naplnené, tak rovnaké Tagy naplnené na úrovni DrctDbtTxInf nebudú brané pri spracovaní transakcie do úvahy. +++<InstrPrty> +++<PmtTpInf> ++++<SvcLvl> +++++<Cd> +++<PmtTpInf> Sequence Type AT21 VARCHAR2(4) ++++<SeqTp> +++<PmtTpInf> ++++<CtgyPurp> +++++<Cd> +++<Amt> ++++<InstdAmt> +++<ChrgBr> +++<DrctDbtTx> ++++<ndtrltdinf> +++++<ndtid> +++<DrctDbtTx> ++++<ndtrltdinf> +++++<DtfSgntr> +++<DrctDbtTx> ++++<CdtrSchmeId> <PrvtId> Instruction priority VARCHAR2(4) Hodnoty: NR alebo HIGH. Pre SEPA DD vždy NR. Service level code AT20 VARCHAR2(4) Kód identifikácie schémy. V prípade naplnenia použi iba hodnotu SEPA. Category Purpose Code AT59 VARCHAR2(4) Instructed Amount AT06 NUBER(18,2) Hodnota samotnej transakcie. ena uvedená v u uvedenom Tagu môže by výhradne EUR. Charge bearer VARCHAR2(4) andate Identification AT01 VARCHAR2(35) Date of signature AT25 DATE Typ frekvencie inkasa. Povolené hodnoty sú: FRST - pre prvé inkaso, RCUR - pre opakované inkaso, FF - jednorázové inkaso, FNAL - posledné inkaso. Korektné použitie typu frekvencie inkasa je pod a SEPA rulebook povinné. Kategória ú elu platby. Ak je hodnota uvedená - iba povolená hodnota z platného íselníka IS Pre SEPA DD treba uvádza hodnotu SLEV. Pokia bude bola táto hodnota uvedená už úrovni PmtInf tak na tejto úrovni bude ignorovaná. Jednozna ný identifikátor mandátu pre vykonanie SDD. Dohodnutý identifikátor medzi kreditorom a platite om. V prípade inkás vzniknutých pred dohodnutý symbol (hodnota VS alebo ŠS). Dátum podpisu mandátu. V prípade inkás vzniknutých pred doporu ujeme nap a hodnotou Creditor scheme identification AT02 VARCHAR2(35) CID kreditora pridelené príslušnou inštitúciou. Tento údaj je možné uvies aj na úrovni PmtInf. +++<DbtrAgt> ++++<FinInstnId> +++++<BIC> ++++<Nm> +++++<Ctry> <BICrBEI> <IBAN> V tejto asti XL formátu platieb je možné uvies nepovinné informácie o Koncovom príjemcovi / Ultimate creditor. Detailný popis v kapitole 3.2 v bloku Koncový príjemca / Ultimate creditor. AT38 Debtor Agent BIC AT13 VARCHAR2(11) BIC kód banky protistrany (platite a). Debtor Name AT14 VARCHAR2(70) eno príjemcu. Debtor Postal Address Country VARCHAR2(2) Dvojznakový IS kód krajiny príjemcu Debtor Postal Address Line 1 VARCHAR2(70) Prvý riadok adresy príjemcu. Debtor Postal Address Line 2 VARCHAR2(70) Druhý riadok adresy príjemcu. ID identifikácia platiete a - nepovinné údaje. Debtor rganization Id VARCHAR2(11) ID platite a - v prípade že má takéto BIC or BEI pridelené pod a medzinárodnej schémy. ALEB Debtor rganization Id VARCHAR2(35) ID platite a - ak má pridelené. Debtor Account AT07 VARCHAR2(34) íslo ú tu platite a. Pre SEPA inkasá musí by uvedené v tvare IBAN. V tejto asti XL formátu platieb je možné uvies nepovinné informácie o Koncovom platite ovi / Ultimate debtor. V prípade, že informácie boli uvedené v asti PmtInf, v prípade ich výskytu aj na tejto úrovni budú ignorované. +++<Purp> ++++<Cd> +++<RmtInf> ++++<Ustrd> Purpose Code AT58 VARCHAR2(4) Remitance Information Unstructured AT22 VARCHAR(140) zna enie hlavného ú elu SDD. Je to íselníková hodnota z platného íselníka IS VÚB banka túto informáciu nespracúva - posiela a ej banke protistrany. Dodato né informácie o SDD. Tieto údaje budú prenesené aj banke protistrany. VÚB pre SEPA úhrady bude používa výhradne USTRD formu.

5 3.1 Ultimate Debtor Koncový platite V tejto asti je možné publikova nepovinné detailné informácie do príkazu na inkaso, v prípade že chcete uvies dodato né informácie pre príjemcu. Je možné identifikova i koncovým platite om je P alebo F. XL Reference Name Type / AX Lenght and Notes ++++<Nm> +++++<Ctry> Ultimate Debtor Name VARCHAR2(70) eno koncového platite a Ultimate Debtor Postal Address Country code VARCHAR2(2) Dvojznakový IS kód krajiny koncového platite a Ultimate Debtor Postal Address Line 1 VARCHAR2(70) Prvý riadok adresy koncového platite a <PrvtId> Ultimate Debtor Postal Address Line 2 VARCHAR2(70) Druhý riadok adresy koncového platite a Ultimate Debtor rganization Id VARCHAR(35) ID koncového platite a v prípade P. V prípade jeho uvedenia do platby bude prenesené banke protistrany. ALEB Ultimate Debtor Private Id VARCHAR(35) ID koncového platite a v prípade F. V prípade jeho uvedenia do platby bude prenesené banke protistrany. 3.2 Ultimate Creditor Koncový príjemca V tejto asti je možné publikova nepovinné detailné informácie do príkazu na inkaso, v prípade že chcete uvies dodato né informácie pre príjemcu. Je možné identifikova i koncovým príjemcom je P alebo F. XL Reference Name Type / AX Lenght and Notes ++++<Nm> +++++<Ctry> Ultimate Creditor Name VARCHAR2(70) eno koncového príjemcu. Ultimate Creditor Postal Address Country code VARCHAR2(2) Dvojznakový IS kód krajiny koncového príjemcu <PrvtId> Ultimate Creditor Postal Address Line 1 VARCHAR2(70) Prvý riadok adresy koncového príjemcu. Ultimate Creditor Postal Address Line 2 VARCHAR2(70) Druhý riadok adresy koncového príjemcu. Ultimate Creditor rganization Id VARCHAR(35) ID koncového príjemcu v prípade P. V prípade jeho uvedenia do platby bude prenesené banke protistrany. ALEB Ultimate Creditor Private Id VARCHAR(35) ID koncového príjemcu v prípade F. V prípade jeho uvedenia do platby bude prenesené banke protistrany.

6 Príklad súboru SDD: <?xml version="1.0" encoding="utf-8"?> <Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain " xmlns:xsi=" xsi:schemalocation="urn:iso:std:iso:20022:tech:xsd:pain pain xsd"> <CstmrDrctDbtInitn> <GrpHdr> <sgid>dd </sgid> <CreDtTm> T09:57:51</CreDtTm> <NbfTxs>2</NbfTxs> <CtrlSum>36.00</CtrlSum> <InitgPty> <Nm>EN PRIKAZCU AX 70 CHAR</Nm> <AdrLine>ADR LINE 01 XXXXXX</AdrLine> <AdrLine>ADR LINE 02 XXXXXX</AdrLine> </InitgPty> </GrpHdr> <PmtInf> <PmtInfId> </PmtInfId> <Pmttd>DD</Pmttd> <BtchBookg>true</BtchBookg> <NbfTxs>1</NbfTxs> <CtrlSum>12.00</CtrlSum> <PmtTpInf> <SvcLvl> <Cd>SEPA</Cd> </SvcLvl> <LclInstrm> <Cd>CRE</Cd> </LclInstrm> <SeqTp>FF</SeqTp> <CtgyPurp> <Cd>CASH</Cd> </CtgyPurp> </PmtTpInf> <ReqdColltnDt> </ReqdColltnDt> <Cdtr> <Nm>EN PRIKAZCU AX 70 CHAR</Nm> <AdrLine>ADR LINE 01 XXXXXX</AdrLine> <AdrLine>ADR LINE 02 XXXXXX</AdrLine>

7 </Cdtr> <CdtrAcct> <IBAN>SK </IBAN> </CdtrAcct> <CdtrAgt> <FinInstnId> <BIC>SUBASKBX</BIC> </FinInstnId> </CdtrAgt> <UltmtCdtr> <Nm>ULTIATE PRIKAZCA 1</Nm> <AdrLine>ADR LINE 01 XXXXXX</AdrLine> <AdrLine>ADR LINE 02 XXXXXX</AdrLine> </UltmtCdtr> <ChrgBr>SLEV</ChrgBr> <CdtrSchmeId> <PrvtId> SK34ZZZ <SchmeNm> <Prtry>SEPA</Prtry> </SchmeNm> </PrvtId> </CdtrSchmeId> <DrctDbtTxInf> <PmtId> <InstrId>ABC/123/CDF</InstrId> <EndToEndId>/VS123/SS456/KS0308</EndToEndId> </PmtId> <InstdAmt Ccy="EUR">12.00</InstdAmt> <DrctDbtTx> <ndtrltdinf> <ndtid>1234</ndtid> <DtfSgntr> </DtfSgntr> <AmdmntInd>false</AmdmntInd> </ndtrltdinf> </DrctDbtTx> <DbtrAgt> <FinInstnId> <BIC>CEKSKBXXXX</BIC> </FinInstnId> </DbtrAgt> <Dbtr> <Nm>PARTNER</Nm> <AdrLine>UL</AdrLine> <AdrLine>EST</AdrLine>

8 76543 </Dbtr> <DbtrAcct> <IBAN>SK </IBAN> </DbtrAcct> <UltmtDbtr> <Nm>ULTIATE PARTNER</Nm> <AdrLine>UC ULICA</AdrLine> <AdrLine>UC EST</AdrLine> 123 </UltmtDbtr> <Purp> <Cd>CASH</Cd> </Purp> <RmtInf> <Ustrd>DETAILS </Ustrd> </RmtInf> </DrctDbtTxInf> </PmtInf> <PmtInf> <PmtInfId> </PmtInfId> <Pmttd>DD</Pmttd> <BtchBookg>true</BtchBookg> <NbfTxs>1</NbfTxs> <CtrlSum>24.00</CtrlSum> <PmtTpInf> <SvcLvl> <Cd>SEPA</Cd> </SvcLvl> <LclInstrm> <Cd>CRE</Cd> </LclInstrm> <SeqTp>RCUR</SeqTp> <CtgyPurp> <Cd>DIVI</Cd> </CtgyPurp> </PmtTpInf> <ReqdColltnDt> </ReqdColltnDt> <Cdtr> <Nm>EN PRIKAZCU AX 70 CHAR</Nm> <AdrLine>ADR LINE 01 XXXXXX</AdrLine> <AdrLine>ADR LINE 02 XXXXXX</AdrLine>

9 </Cdtr> <CdtrAcct> <IBAN>SK </IBAN> </CdtrAcct> <CdtrAgt> <FinInstnId> <BIC>SUBASKBX</BIC> </FinInstnId> </CdtrAgt> <UltmtCdtr> <Nm>ULTIATE PRIKAZCA</Nm> <AdrLine>ADR LINE 01 XXXXXX</AdrLine> <AdrLine>ADR LINE 02 XXXXXX</AdrLine> </UltmtCdtr> <ChrgBr>SLEV</ChrgBr> <CdtrSchmeId> <PrvtId> SK45ZZZ <SchmeNm> <Prtry>SEPA</Prtry> </SchmeNm> </PrvtId> </CdtrSchmeId> <DrctDbtTxInf> <PmtId> <InstrId>ABC/1234/CDF</InstrId> <EndToEndId>E2E 01 DD</EndToEndId> </PmtId> <InstdAmt Ccy="EUR">24.00</InstdAmt> <DrctDbtTx> <ndtrltdinf> <ndtid>1234</ndtid> <DtfSgntr> </DtfSgntr> <AmdmntInd>false</AmdmntInd> </ndtrltdinf> </DrctDbtTx> <DbtrAgt> <FinInstnId> <BIC>CEKSKBXXXX</BIC> </FinInstnId>

10 </DbtrAgt> <Dbtr> <Nm>PARTNER</Nm> <AdrLine>UL</AdrLine> <AdrLine>EST</AdrLine> </Dbtr> <DbtrAcct> <IBAN>SK </IBAN> </DbtrAcct> <UltmtDbtr> <Nm>ULTIATE PARTNER</Nm> <AdrLine>UC ULICA</AdrLine> <AdrLine>UC EST</AdrLine> 123 </UltmtDbtr> <Purp> <Cd>DIVD</Cd> </Purp> <RmtInf> <Ustrd>DETAILS </Ustrd> </RmtInf> </DrctDbtTxInf> </PmtInf> </CstmrDrctDbtInitn> </Document>