Financial Supply Chain SEPA SEPA formaten - inleiding tot XML versie maart 2014 ing.be/sepa
INLEIDING 1 INLEIDING TOT XML 2 Wat is XML? 2 Wat is een root element? 2 Wat zijn de specificaties van een element (tag)? 2 Hoe worden tags goed geformatteerd? 2 Hoe worden gegevensvelden correct samengesteld? 3 HET VERPLICHT OF OPTIONEEL KARAKTERS VAN EEN TAG (ELEMENT) 4 Wanneer is een tag verplicht of niet? 4 Wat is een occurrence? 4 Wat is een index? 4 BERICHTSTRUCTUUR 5 Wat is de algemene structuur van een XML-document? 5 Wat is het GroupHeader-blok? 6 Wat is het PaymentInformation-blok? 6 Wat is het CreditTransferTransactionInformation-blok? 6 Wat is het DirectDebitTransactionInformation-blok? 6 Voorbeeld voor Europese overschrijvingen SEPA 7 Voorbeeld voor Europese domiciliëringen SEPA 8 FORMAATVALIDATIETOOL 9 Wat is een formaatvalidatietool? 9 Hoe krijg ik toegang tot deze tool? 9 NUTTIGE LINKS 10
Inleiding Dit document heeft tot doel om je migratieproces naar Europese overschrijvingen SEPA (SCT) en Europese domiciliëringen SEPA (SDD) te vergemakkelijken. Dit document tracht je te helpen om het XML-formaat te begrijpen en voor al je SEPA-transacties te gebruiken. De EPC (European Payments Council) heeft diverse documenten op het gebied van SEPA gepubliceerd, waaronder een Data Model Reference, Rulebooks en implementatierichtlijnen voor zowel overschrijvingen SEPA als domiciliëringen SEPA. waarmee een correct financieel bericht opgesteld kan worden, menen wij dat er meer informatie noodzakelijk is om tot een efficiëntere en soepelere overgang met een bevredigend eindresultaat te komen. De land- en bankspecifieke gegevens hebben geenszins invloed op de XML-structuur zoals die door ISO20022 en EPC gepresenteerd is. De Rulebooks van het EPC bevatten eisen voor de bedrijfsvoering en regels voor het gebruik van de SEPAschema s. De Implementation Guides specificeren de kerneisen van SEPA die van toepassing zijn op UNIFI (ISO20022) XML-standaarden. Zij hebben betrekking op verplichte berichtgeving tussen banken en optionele, aanbevolen berichtgeving van de klant naar de bank. UNIFI ISO20022 vormt voor de European Payments Council de facto de basis voor het opstellen van de richtlijnen voor de Europese overschrijving SEPA (SCT) en de Europese domiciliëring SEPA (SDD). Alle nationale bankorganisaties hebben het EPC Rulebook verwerkt in een landspecifieke implementatierichtlijn en hebben landspecifieke elementen aan het document toegevoegd om dit voor de lokale markt geschikt te maken. Iedere lokale bank vult de implementatierichtlijnen aan door een kleine bijlage met bankspecifieke gegevens toe te voegen. Een aanvullende succesfactor vormt het gebruik van uw actuele kennis om een correcte SEPA-migratie te kunnen realiseren. In dit document willen wij u informatie geven over hoe u XML-elementen kunt creëren. We sluiten dit document af met informatie over de hulp die ING u bij het testen kan bieden. Wij vestigen graag uw aandacht op het feit dat voor een soepele verwerking van transacties het uiterste aanlevertijdstip van ING (ING cut-off times) in acht genomen dient te worden. Alhoewel de richtlijnen alle informatie dienen te bevatten 1 Een Rulebook is een verzameling van regels of voorgeschreven standaarden op basis waarvan besluiten worden genomen. 2 Een schema is een verzameling regels, gebruiken en standaarden die door aanbieders van betaaldiensten zijn overeengekomen (SEPA-schema voor overschrijvingen en SEPA-schema voor incasso/domiciliëring) SEPA formaten - Inleiding tot XML 1
Inleiding tot XML Wat is XML? XML staat voor extensible Markup Language: het is een verzameling regels voor het modelleren van documenten in een vorm die machines kunnen lezen. XML verschaft een uniforme methode voor het beschrijven en uitwisselen van gestructureerde gegevens. XML is gebaseerd op een mark up 3. Het is een taal die gemakkelijker gelezen kan worden dan bestanden met een vaste bestandsveldlengte. Specificaties: Een XML-document bestaat uit een karakterstring. De elementen dienen op de juiste wijze genest te zijn Ieder document moet één uniek root element bevatten De volgorde is van belang Waarden van attributen moeten tussen haakjes geplaatst worden Geen herhaling van attributen in een element Voor financiële berichtgeving is het van het allergrootste belang dat beide partijen het bericht perfect begrijpen. De verzender en de ontvanger moeten het eens zijn hoe een bericht geïnterpreteerd dient te worden. De ISO20022- standaard verbindt aanvullende regels en restricties aan het gebruik van XML-berichtgeving. Om met ISO20022 te kunnen werken, is basiskennis van XML vereist. Wat is een root element? XML-documenten moeten één element bevatten dat de parent is van alle andere elementen. Dit element noemen we het root element. Ieder XML-bericht moet en kan slechts één root element bevatten. Wat zijn de specificaties van een element (tag)? XML-tags maken onderscheid tussen hoofdletters en kleine letters. Tags zijn er in drie soorten : > Start-tags: Een start-tag begint met het < -karakter en eindigt met het > -karakter. > bijv. <sectie>. > eind-tags: In XML moeten alle elementen een eindtag hebben. Iedere start-tag moet verplicht worden afgesloten met een eind-tag </. > bijv. </sectie>. > empty-element tags: Deze tags stellen een programmeur in staat om een vast XML-schema te maken waarin bepaalde velden geen waarde hebben als er geen waarde beschikbaar is. Dit soort tags is in de ISO20022-structuur echter niet toegestaan. Als er een tag wordt gebruikt, mag het corresponderende gegevensveld niet leeg gelaten worden. Er moet minstens één karakter ingevuld worden. > bijv. <sectie/>. Tags mogen elkaar niet overlappen Corresponderende start-/eind-tags > <Adres> is een start-tag en </Adres> is een eind- tag. > bijv.<postcode>75002</postcode> Hoe worden tags goed samengesteld? XML is een taal waarin alleen de gegevens tussen een start-tag en een eind-tag als informatie geaccepteerd worden. Dat betekent dat er zonder probleem spaties of blanco s tussen tags kunnen zijn, zonder overigens rekening te houden met het feit dat dit niet aan het algemene idee van een leesbare tekst voldoet. Daarom wordt aanbevolen om geen spaties of blanco s tussen tags te plaatsen. Anderzijds is het niet toegestaan om spaties in de tag zelf te plaatsen. Dat leidt zeker tot een fout XML-bestand. Bijv. <Naam straat> 3 Tekst die wordt toegevoegd aan de gegevens van een document om informatie daarover mede te delen SEPA formaten - Inleiding tot XML 2
Hoe worden gegevensvelden correct samengesteld? Een gegevensveld is de ruimte tussen een start-tag en een eind-tag als er geen child element is. De karakters in deze ruimte worden als de waarde van het element beschouwd. Deze waarde vormt het feitelijke gegeven dat voor je financiële bericht essentieel is. Bijv. <PostCode>75002</PostCode> Voor deze gegevens gelden twee belangrijke voorwaarden: Karakterset In het begin van een XML-document wordt de karakterset gedefinieerd. Deze karakterset bepaalt welke karakters in datavelden gebruikt worden. De karakterset die wordt gedefinieerd in de ISO20022- standaard is de welbekende UTF-8 set. Dit is een vrij kleine karakterset, waarbinnen de volgende karakters gebruikt mogen worden. 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 / -?: ( )., + Spatie Lengte: Ieder gegevensveld heeft een specifieke lengte. Dit kan een vaste lengte zijn, zodat een specifieke code ingevuld kan worden. Maar het kan ook een variabele lengte zijn, waarbij een maximale lengte wordt gedefinieerd. De minimale lengte voor gegevensvelden is altijd 1. Lege velden worden niet aanbevolen. Opmerking: Een spatie is een geldig karakter. Er wordt ten zeerste aanbevolen om te controleren dat de inhoud van een gegevensveld direct volgt na de start-tag en direct wordt gevolgd door een eind-tag. Bijv. <PostCode>75002</PostCode> SEPA formaten - Inleiding tot XML 3
Het verplicht of optioneel karakters van een tag (element) Wanneer is een tag verplicht of niet? Sommige elementen in de lay-out van het financiële bericht zijn verplicht. Andere zijn optioneel en kunnen naar wens gebruikt worden. Het is nuttig om deze optionele elementen na te gaan. Zij kunnen bij het Payment en Cash Management voordelen bieden. Of een element verplicht of optioneel is, zie je bij het volgende punt. In het hoofdstuk Berichtstructuur hebben we de vrijheid genomen om wat optionele velden als aanbevolen aan te duiden, omdat we er sterk van overtuigd zijn dat die voordelen kunnen bieden bij uw betalingsverwerking. Wat is een occurrence? Die geeft aan hoe vaak een element herhaald kan worden. Het aantal aanwezigheden occurrences wordt tussen rechte haken weergegeven. [0..1] geeft aan dat het element 0 of 1 keer kan voorkomen. > Het element is optioneel. [1..1] geeft aan dat het element slechts 1 keer kan voorkomen. > Het element is verplicht. [1..n] geeft aan dat het element 1 tot n keer kan voorkomen. > Het element is verplicht. De indicatie Or is van invloed op de interpretatie van de status van gegevens. In dat geval kunnen er twee verschillende subchildren gebruikt worden voor één child. Beide zijn correct, maar hebben een andere impact en gevolgen. De twee verschillende subchildren worden in de occurrence als volgt aangegeven: [0..1] {Or [0..1] Or} Wat is een index? Elk element in de ISO20022-standaard wordt met behulp van een nummer geïndexeerd. Dat nummer wordt chronologisch toegewezen op basis van twee niveaus. Het eerste niveau geeft aan of het gekoppeld is aan de header of aan de betalingsinformatie. Het tweede niveau van het nummer geeft de volgorde aan waarin elk element aangeboden dient te worden. Hoewel diverse elementen optioneel zijn, dient het element in het geval het wordt toegevoegd wel in de juiste volgorde toegevoegd te worden. n wordt soms aangeduid met, wat staat voor oneindigheid. SEPA formaten - Inleiding tot XML 4
Berichtstructuur Wat is de algemene structuur van een XML-document? De algemene structuur van een Europese overschrijving SEPA kan bijvoorbeeld als volgt weergegeven worden: Het XML-document kan in 3 onderdelen worden onderverdeeld: Het eerste deel wordt de proloog genoemd en is van zeer groot belang. Het stelt diegene die de file aanmaakt in staat om aan te geven welke XML-versie en karakterset gebruikt worden. ISO20022 ondersteunt uitsluitend de versie 1.0 van XML en de karakterset UTF-8. De proloog van een ISO20022-bestand dient er altijd als volgt uit te zien: <?xml version= 1.0 encoding= UTF-8?> Het tweede gedeelte wordt voor de documentdeclaratie gebruikt. De documentdeclaratie geeft aan welk soort document gebruikt wordt en definieert de regels waarmee het document gevalideerd kan worden. De ISO-organisatie heeft een XSD-schema verstrekt waarin de regels voor een specifieke documentsoort gedefinieerd zijn. Indien er een namespace (xmlns) wordt gegeven, kan die in een validator gebruikt worden om te kijken of het document qua structuur valide is. De gebruikte xmlns hangt af van de versie van de ISO20022- lay-out die gebruikt wordt. De volgende documentdeclaratie wordt voor de Europese overschrijving SEPA gebruikt: <Document xmlns= urn:iso:std:iso:20022:tech:xsd: pa in.001.001.03 > De volgende documentdeclaratie wordt voor de Europese domiciliëring SEPA gebruikt: <Document xmlns= urn:iso:std:iso:20022:tech:xsd: pa in.008.001.02 > Het derde gedeelte is het hoofdgedeelte en bevat de volledige boomstructuur van een XML-document. Hieronder bespreken we deze structuur in meer detail voor de Europese overschrijving SEPA en de Europese domiciliëring SEPA. SEPA formaten - Inleiding tot XML 5
Wat is het GroupHeader-blok? Het groupheader-blok is het eerste blok informatie dat in het document genest is. Dit blok is verplicht en geeft informatie die voor alle daarna volgende informatie geldt. Dit blok geeft de opdrachtgevende financiële instelling de mogelijkheid om bepaalde standaard beveiligingscontroles uit te voeren. Dergelijke informatie is bijvoorbeeld de datum en het tijdstip waarop het bestand is aangemaakt. De indicatie van het totale aantal transacties dat volgt vormt eveneens een belangrijke factor. Wat is het PaymentInformation-blok? Dat heeft betrekking op het batchniveau. Deze bouwsteen is verplicht en wordt steeds herhaald. Dit blok stelt diegene die het bestand aanmaakt in staat om zijn transacties in een logische volgorde te organiseren. Alle transacties binnen één <PmtInf> worden met dezelfde opdrachtgevende rekening en op dezelfde uitvoerdatum verwerkt. Dit blok geeft ook aan of een transactie in het <PmtInf> globaal of individueel op de rekening geboekt wordt (BtchBookg). Indien per <PmtInf> slechts één transactie aangeleverd wordt, heeft het geen zin om de batchboekingsparameter te gebruiken. Het PaymentInformation-blok kan diverse transacties bevatten en dient alle transacties binnen de XML met dezelfde betalingsinstructies te groeperen. Dit voorkomt dat dezelfde informatie onnodig herhaald wordt (grotere bestanden, kans op fouten ). Wat is het CreditTransferTransaction- Information-blok? Dat heeft betrekking op het transactieniveau van een XML voor een Europese overschrijving SEPA (pain.001.001.03). Deze bouwsteen is verplicht en wordt steeds herhaald. Het blok bevat onder meer elementen die op de creditkant van de transactie betrekking hebben, zoals de Creditor en de Remittance Information. Terwijl de informatie over de debetkant voor alle transacties in een batch hetzelfde zal zijn, wordt de informatie over de begunstigden voor iedere transactie afzonderlijk aangegeven. Wat is het DirectDebitTransaction- Information-blok? Dat heeft betrekking op het transactieniveau van een XML voor een Europese domiciliëring SEPA (pain.008.001.02). Deze bouwsteen is verplicht en wordt steeds herhaald. Het blok bevat onder meer elementen die op de debetkant van de transactie betrekking hebben, zoals de Debtor, de Mandate Related Information en de Remittance Information. Terwijl de informatie over de creditkant voor alle transacties in een batch hetzelfde zal zijn, wordt de informatie over de schuldenaarkant voor iedere invordering afzonderlijk aangegeven. SEPA formaten - Inleiding tot XML 6
Example for European credit transfers Voorbeeld voor Europese overschrijvingen SEPA The GroupHeader Block 1 per xml-file The PaymentInformation Block (= batch-level) [1 ] batches per xml-file Transaction 1 Transaction Level [1 ] per batch Transaction 2 Transaction 3 SEPA formaten - Inleiding tot XML 7
Example for European direct debits Voorbeeld voor Europese domiciliëringen SEPA The GroupHeader Block 1 per xml-file The PaymentInformation Block (= batch-level) [1 ] batches per xml-file Transaction 1 Transaction Level [1 ] per batch Transaction 2 Transaction 3 SEPA formaten - Inleiding tot XML 8
Formaatvalidatietool ING biedt u de mogelijkheid om online een test uit te voeren met een formaatvalidatietool. Wat is een formaatvalidatietool? De formaatvalidatietool (FVT) is een onlinedienst die gebruikt kan worden voor het valideren van specifieke, voor ING bestemde betaalformaatbestanden. Deze bestanden vormen de enveloppen waarin u uw transactie-instructies stopt die door ING verwerkt dienen te worden. Het biedt u een hulpmiddel dat u kan gebruiken om veranderingen in uw huidige formaten door te voeren of testbestanden tijdens de implementatie te valideren. FVT biedt een snelle, geautomatiseerde validatie van bestandsformaten. Met deze tool kunt u het implementatieproces aanzienlijk versnellen en daarmee een snellere time-to-market behalen. Deze dienst vormt een aanvulling op het huidige bestaande implementatieproces, maar vormt geen vervanging van een stap in dat proces. De gebruikershandleiding is op de website beschikbaar via de volgende link: http://www.ingsepa.com/formatvalidationtool/en (click op HELP). Hoe krijg ik toegang tot deze tool? Adress: http://www.ingsepa.com/formatvalidationtool/en Username: ING10 Password: Format10 SEPA formaten - Inleiding tot XML 9
Nuttige links The official document on character set conversion (EPC) http://www.europeanpaymentscouncil.eu/documents/epc217-08%20best%20practices%20-sepa%20 Requirements%20for%20Character%20Set.pdf European Payments Council (EPC) Europese domiciliëringen SEPA http://www.europeanpaymentscouncil.eu/content.cfm?page=sepa_direct_debit_(sdd) European Payments Council (EPC) Europese overschrijvingen SEPA http://www.europeanpaymentscouncil.eu/content.cfm?page=sepa_credit_transfer ING België nv Bank Vennootschapszetel: Marnixlaan 24, B-1000 Brussel RPR Brussel Btw: BE 0403.200.393 BIC: BBRUBEBB IBAN: BE45 3109 1560 2789. Verantwoordelijke uitgever: Inge Ampe Sint-Michielswarande 60, B-1040 Brussel 705117N 03/14 Editing Team & Graphic Studio Marketing ING Belgium