Financial S upp
ly C hai n
SEPA
Handleiding XML-formaat voor Europese overschrijvingen in België versie januari 2014
www.ing.be/sepa
Inleiding1 Vaak gestelde vragen
2
Hoe wordt ‘CreationDateTime’ correct gevormd?
2
Hoe wordt ‘InitiatingParty’ correct gevormd?
2
Hoe moet de bovenstaande tabel worden geïnterpreteerd en waarvoor staan de “+” en “[#..#]” -tekens?
3
Wat is BatchBooking?
4
Wat is ‘RequestedExecutionDate’?
5
ING-bijlage bij Febelfin XML-bericht voor Europese overschrijvingsopdrachten IG 6 Voorbeeld 9 CIRI01 tot XML (mapping)
16
Referentie-informatie 17 Nuttige links
18
Inleiding
Dit document is bestemd om u te helpen het "XML-formaat voor uw SEPAtransacties te begrijpen en te gebruiken. Febelfin heeft op hun website het document XML bericht voor overschrijvingsopdracht Implementatierichtlijnen" gepubliceerd dat gebaseerd is op de standaarden van de European Payments Council (EPC). De richtlijnen zouden alle nodige informatie moeten bevatten om een correct financieel bericht te creëren. We zijn echter van mening dat bijkomende uitleg nodig is om te komen tot een vlotte en efficiënte overschrijving met een bevredigend eindresultaat. Onze beschrijving baseert zich op het standaardbericht ISO 20022 CustomerCreditTransferInitiation <pain.001.001.03>, aangevuld met de Febelfinrichtlijnen voor XML-berichten en de ING-bijlage. De ISO 20022-standaard legt bepaalde regels en verplichtingen op met betrekking tot het gebruik van de standaard XML-berichten. In de bijlage van ING die moet worden beschouwd als een aanvulling op de richtlijnen van Febelfin, wordt meer informatie gegeven over wat al dan niet door ING wordt ondersteund. De bijlage van ING heeft voorrang op de XMLimplementatierichtlijnen van Febelfin. Zowel het document van Febelfin als de bijlage van ING moeten samen worden gelezen en vormen de sleutel om te komen tot een succesvolle migratie.
Een bijkomend element om te komen tot een correcte migratie naar SEPA is uw bestaande kennis. In dit document willen wij u ook informatie geven over hoe u XML-elementen kunt creëren op basis van uw CIRI01-protocol. Daarna laten we u weten hoe ING u kan helpen om dit te testen. We willen er wel op wijzen dat de uiterste tijdstippen van ING (cut-off times) moeten worden gerespecteerd met het oog op een vlotte verwerking van uw transacties.
Handleiding XML-formaat in België Europese overschrijvingen 1
Vaak gestelde vragen Hoe wordt ‘CreationDateTime’ correct gevormd? Definitie: Datum en tijdstip waarop het overschrijvingsbericht werd opgemaakt. XML Tag:
Aanwezigheid: [1..1] Formaat: YYYY-MM-DDThh:mm:ss Voorbeeld: 2011-08-24T09:40:30 Als dit formaat niet wordt gerespecteerd, zal de betaalinstructie worden verworpen.
Hoe wordt ‘InitiatingParty’ correct gevormd? Definitie: Afzender van de betalingsopdracht. Dit kan zowel de debiteur zijn als een partij die de betaling doorgeeft in naam van de debiteur. XML Tag: Aanwezigheid: [1..1] Formaat : Dit rubriek bestaat uit de volgende elementen:
1.8
[1..1]
++
InitiatingParty
[0..1]
+++
Name
70
[0..1]
+++
Identification
[1..1]
++++
OrganisationIdentification
[0..1]{Or
+++++
BICOrBEI
11
[0..1] Or}
+++++
Other
[1..1]
++++++
Identification
35
[1..1]
++++++
Issuer
35
Regels: • Ofwel “Name”, ofwel “Identification”, ofwel beide gebruiken (“Name” maximum 70 karakters). • Voor Belgische ondernemingen moet de “Identification” (in Other) het ondernemingsnummer (10 cijfers) bevatten, en moet als “Issuer” “KBO-BCE” worden ingevoerd. • Als “Identification” wordt gebruikt, dan moet “OrganisationIdentification” worden gebruikt, daar dit verplicht is. • Wanneer “OrganisationIdentification” wordt gebruikt, dan mag ofwel “BICOrBEI” worden gebruikt, ofwel “Other”. Als “Other” wordt gebruikt, dan moeten “Identification” en” Issuer” worden gebruikt, daar deze beiden verplicht zijn. Handleiding XML-formaat in België Europese overschrijvingen 2
Hoe moet de bovenstaande tabel worden geïnterpreteerd en waarvoor staan de “+” en “[#..#]” -tekens? Het “+”-teken verwijst naar het niveau binnen de structuur waarop het element voorkomt in de xml-structuur. De [#..#] geeft aan wanneer een onderdeel van het bericht verplicht is, en hoeveel keer hij mag voorkomen. • Optioneel als er [0..1] staat (=> minimum 0, maximum 1 keer voorkomen) • Verplicht als er [1..1] staat (=> minimum 1, maximum 1 keer voorkomen) • Verplicht als er [1..1] staat (=> minimum 1, maximum 1 keer voorkomen) ‘n’ wordt soms weergegeven door ‘∞’. Dit symbool staat voor een uitdrukking van oneindigheid. De interpretatie van de status van de gegevens wordt beïnvloed door de indicatie “Of”. In dat geval is het mogelijk om één van beide elementen te gebruiken. Beide elementen zijn juist, maar hebben een andere impact of gevolg. De twee verschillende elementen zullen op de volgende wijze getoond worden in de indicatie van de aanwezigheid: [0..1]{Of [0..1] Of}
Illustratie met Initiating Party:
2de niveau (++)
1ste niveau (+)
Initiating Party op niveau 2 (++) is verplicht [1..1].
3de niveau (+++)
Ofwel Name (+++) ofwel Identification (+++) of beide moeten worden gebruikt, en zijn optioneel [0..1]; omdat Initation Party verplicht is, moet er minstens één van beide voorkomen in de xml.
4de niveau (++++) Als Identification (+++) wordt gebruikt, dan moet OrganisationIdentification (++++) worden gebruikt, omdat het verplicht is [1..1]
Handleiding XML-formaat in België Europese overschrijvingen 3
Voor OrganisationIdentification (++++) is er de keuze tussen één van de twe optionele elementen: BICOrBEI (+++++), of Other (+++++). Er moet minstens één van deze twee voorkomen, maar niet allebei (er staat een {or} tussen; de tag OrganisationIdentification ++++ hierboven is verplicht, maar mag maximaal 1 keer voorkomen: [1..1]) 1ste Mogelijkheid: BICOrBEI (+++++) kan worden gebruikt ipv. Other (deze code wordt toegekend aan organisaties door de ISO 9362 Registration Authority, bvb. Voor niet-Belgische ondernemingen).
5de niveau (+++++)
2de mogelijkheid: Indien Other (+++++) wordt gebruikt, dan moeten Identification (++++++) en Issuer (++++++) worden gebruikt omdat deze verplicht zijn.
5de niveau (+++++)
6de niveau (++++++)
Voor Belgische ondernemingen, moet Identification (onder Other) het Belgisch Ondernemingsnummer bevatten (10 digits) en als Issuer “KBO-BCE”.
Wat is BatchBooking? Gebruik van de functie BatchBooking is facultatief, maar wordt door ING aangeraden. Dit laat de auteur van het bestand toe om voor elk bestand, of zelfs voor elke batch in een bestand, te definiëren of er globaal of individueel moet worden gedebiteerd van de opdrachtgevende rekening. Deze parameter zal worden toegepast op alle transacties (CreditTransferTransactionInformation) die deel uitmaken van de batch (PaymentInformation). Wanneer een globaal debet wordt gevraagd, betekent dit standaard dat er één totaalbedrag wordt gedebiteerd in de rekeninginformatie en CODA-rapportering. Op aanvraag kan ING gedetailleerde informatie bezorgen voor dergelijke batches (MECT – Multiple European Credit Transfers) in de CODA-rapportering. Wenst u gedetailleerde rapporteringsinformatie te ontvangen, neem dan minstens vier werkdagen voorafgaand aan de uitvoeringsdatum contact op met ons Electronic Banking Support (EBS) Help desk. Handleiding XML-formaat in België Europese overschrijvingen 4
Gebruiksregel: • Indien niet aanwezig, wordt het bestand standaard beschouwd als geboekt per batch. • Indien aanwezig en met vermelding “true”, true, wordt een boeking per batch gevraagd. • Indien aanwezig en met vermelding “false”, false, wordt een boeking per transactie gevraagd. De Batch Booking tag wordt aangeduid met in het PaymentInformation-blok (Febelfin index 2.3).
Belangrijke opmerkingen betreffende de blok PaymentInformation: Ongeacht de waarde ‘True’ of ‘False’ die wordt meegegeven voor BatchBooking, moet u steeds waar mogelijk alle transacties groeperen onder dezelfde PaymentInformation-blok. Dit vermijdt ongewenste impact op uw reporting: exponentiële toename van de omvang van uw reporting-files (want elke transactie wordt apart gerapporteerd) en het risico om fouten te genereren. Indien alle data van de crediet informatie onder PaymentInformation hetzelfde is voor een groep transacties, dan is het voldoende om deze één keer te gebruiken en kunnen al die transacties worden gegroepeerd onder één blok PaymentInformation. Wenst u een rapportering op transactieniveau in plaats van op betalingsinformatieniveau, dan kan dit geregeld worden via de instelling van het ING CODA-product, niet via het XML-formaat. Bijkomende informatie over CODA-rapportering is verkrijgbaar op aanvraag in ons brochure “Impact van SEPA op CODA2.3”.
Wat is ‘RequestedExecutionDate’? Definitie: Datum waarop de afzender de bank van de debiteur vraagt om de betaling uit te voeren. Dit is de datum waarop de rekening(en) van de debiteur gedebiteerd wordt (worden). XML Tag: Aanwezigheid: [1..1] Formaat: YYYY-MM-DD Voorbeeld: 2010-12-18 Regel bij ING : • Wanneer boeking per batch (2.3 – Batch Booking “true”) is gevraagd, is de datum beperkt tot zes maanden in de toekomst en 5 dagen in het verleden. • Wanneer boeking per transactie (2.3 – Batch Booking “false”) is gevraagd, is de datum beperkt tot één jaar in de toekomst en 5 dagen in het verleden. Bij gebruik van de “RequestedExecutionDate”-tag moet rekening worden gehouden met de uiterste tijdstippen bij ING (cut-off times). Als deze uiterste tijdstippen bij ING niet worden gerespecteerd, kan het uitvoeringstijdstip van de betaling worden gewijzigd.
Handleiding XML-formaat in België Europese overschrijvingen 5
ING-bijlage bij Febelfin XML-bericht voor Europese overschrijvingsopdrachten IG (Bijlage versie 2.1 – 30.08.2010)
ING ondersteunt het "XML-bericht voor Europese overschrijvingsopdrachten implementatierichtlijnen" – gepubliceerd door Febelfin, de Belgische Federatie van de financiële sector. Dit document vindt u terug via de volgende link: http://www.febelfin.be/nl/betaalverkeer/richtlijnen-en-protocollen-bankstandaarden Wij raden u aan steeds de laatst gepubliceerde versie te gebruiken. De beslissing of wijzigingen vereist zijn, wordt genomen door de European Payments Council (EPC). Deze bijlage bij het document van Febelfin werd opgesteld om informatie te verschaffen over de manier waarop deze richtlijnen door ING zijn geïnterpreteerd voor SEPA-betalingen (Europese overschrijvingen) uitgevoerd in België. De beschrijving baseert zich op het standaardbericht ISO20022 CustomerCreditTransferInitiation <pain.001.001.03>. Het aantal transacties is beperkt tot een maximum van 50.000 transacties per bestand.
Lijst van items met specifieke ING-instructie Hoe moet deze lijst gelezen worden De XML-implementatierichtlijnen van Febelfin en de bijlage van ING zijn twee nuttige documenten voor cliënten die gemakkelijk willen overstappen naar SEPAproducten. Deze documenten moeten naast elkaar worden gelezen, want in de bijlage van ING wordt verwezen naar de hoofdstukken en nummering (index) van de XML-implementatierichtlijnen van Febelfin. De bijlage van ING heeft voorrang op de XML-implementatierichtlijnen van Febelfin. De eerste twee cijfers die hieronder worden vermeld, staan voor de index. Dit nummer verwijst naar de overeenstemmende beschrijving in het ISO 20022 XML Message Definition Report for Payment Standards – Initiation. “Niet ondersteund” betekent dat het onderdeel genegeerd wordt door ING (geen blokkeringsfactor, maar genegeerd met het oog op uitvoering en rapportering).
2.4 NumberOfTransactions (Batchniveau ‘B’) Niet ondersteund
2.5 ControlSum (Batchniveau ‘B’) Niet ondersteund
2.17 RequestedExecutionDate (Batchniveau ‘B’) •
Wanneer boeking per batch (2.3) is gevraagd, is de datum beperkt tot zes maanden in de toekomst en 5 dagen in het verleden.
•
Wanneer boeking per transactie (2.3 vermeldt “false”) is gevraagd, is de datum beperkt tot één jaar in de toekomst en 5 dagen in het verleden.
Handleiding XML-formaat in België Europese overschrijvingen 6
2.19 Debtor (Batchniveau ‘B’) “Identification” wordt niet ondersteund.
2.20 DebtorAccount (Batchniveau ‘B’) “Currency of the account” wordt niet ondersteund.
2.23 UltimateDebtor (Batchniveau ‘B’) Niet ondersteund
2.70 UltimateDebtor (Transactieniveau ‘T’) Niet ondersteund
2.79 Creditor (Transactieniveau ‘T’) "Identification" wordt niet ondersteund.
2.81 UltimateCreditor (Transactieniveau ‘T’) Niet ondersteund
2.86 Purpose (Transactieniveau ‘T’) Niet ondersteund
Legenda
M B1 T1 T2 B2 T3 T4
Handleiding XML-formaat in België Europese overschrijvingen 7
Level (+)
CUSTOMERCREDITTRANSFERINITIATION
Message item
Occur.
1
GroupHeader
[1..1]
2
MessageIdentification
[1..1]
2
CreationdateTime
[1..1]
2
NumberOfTransactions
[1..1]
2
ControlSum
[0..1]
2
InitiatingParty
[1..1]
1
PaymentInformation
[1..n]
2
PaymentInformationIdentification
[1..1]
2
PaymentMethod
[1..1]
2
BatchBooking
[0..1]
2
NumberOfTransactions
[0..1]
2
PaymentTypeInformation
[0..1]
2
RequestedExecutionDate
[1..1]
2
Debtor
[1..1]
2
DebtorAccount
[1..1]
2
DebtorAgent
[1..1]
2
ChargeBearer
[0..1]
2
CreditTransferTransactionInformation
[1..n]
3
PaymentIdentification
[1..1]
3
Amount
[1..1]
3
UltimateDebtor
[0..1]
3
CreditorAgent
[0..1]
3
Creditor
[1..1]
3
CreditorAccount
[0..1]
3
UltimateCreditor
[0..1]
3
RemittanceInformation
[0..1]
Handleiding XML-formaat in België Europese overschrijvingen 8
MESSAGE LEVEL (‘M’)
BATCH LEVEL (‘B’)
TRANSACTION LEVEL (‘T’)
Europese overschrijving
Voorbeeld
3. Voorbeeld
Europese overschrijving met twee batches met elk twee transacties Europese overschrijving met twee batches met elk twee transacties
HetHet volgende voorbeeld betreft een Europese overschrijving bestaande uit twee verschillende batches volgende voorbeeld betreft een Europese overschrijving bestaande uit twee met twee transacties voor een totaalbedrag van 4.000,00 euro. verschillende batches met twee transacties voor een totaalbedrag van 4.000,00 euro.
De eerste batch omvat een transactie voor een bedrag van 1.000,00 euro en een tweede
De tweede batch omvat een transactie voor een bedrag van 500,00 euro en een tweede
De eerste batch omvat een transactie voor een bedrag van 1.000,00 euro en een transactie voor een bedrag van 500,00 euro. BatchBooking “false” wordt gevraagd, tweede transactie voor een bedrag van 500,00 euro. BatchBooking “false” wordt aangezien het hier gaat om leverancierstransacties (SUPP). gevraagd, aangezien het hier gaat om leverancierstransacties (SUPP).
De tweede batch omvat voor2.000,00 een bedrag vanBatchBooking 500,00 euro en“true” een wordt gevraagd, transactie voor een eentransactie bedrag van euro. tweede transactie voor een bedrag van 2.000,00 euro. BatchBooking “true” wordt aangezien het hier gaat om loonbetalingen (SALA). gevraagd, aangezien het hier gaat om loonbetalingen (SALA).
ING Belgium
Handleiding XML-formaat in België Europese overschrijvingen 9
Page 11 of 20
Referentiegids voor België XML-formaat Europese overschrijving
Handleiding XML-formaat in België Europese overschrijvingen 10
ING Belgium
Page 12 of 20
Referentiegids voor België XML-formaat Europese overschrijving
ING Belgium
Handleiding XML-formaat in België Europese overschrijvingen 11
Page 13 of 20
Referentiegids voor België XML-formaat Europese overschrijving
ING Belgium
Handleiding XML-formaat in België Europese overschrijvingen 12
Page 14 of 20
Referentiegids voor België XML-formaat Europese overschrijving
Referentiegids voor België XML-formaat Europese overschrijving
Handleiding XML-formaat in België Europese overschrijvingen 13
ING Belgium
Page 15 of 20
Referentiegids voor België XML-formaat Europese overschrijving
Handleiding XML-formaat in België Europese overschrijvingen 14
ING Belgium
Page 17 of 20
Referentiegids voor België XML-formaat Europese overschrijving
ING Belgium
Handleiding XML-formaat in België Europese overschrijvingen 15
Page 18 of 20
CIRI01 tot XML (mapping)
De onderstaande tabel omvat enkel de verplichte en aanbevolen elementen. Via deze informatie willen wij u de link aantonen tussen het XML-formaat en het CIRI01-formaat. Index
Berichtitem
<XML Tag>
Functioneel CIRI01equivalent
1.0
GroupHeader
Verplicht
1.1
MessageIdentification
<MsgId>
Verplicht
1.2
CreationDateTime
Verplicht
Rec 0 pos 6-11
1.6
Number of Transactions
Verplicht
1.8
InitiatingParty
Verplicht
2.0
PaymentInformation
Verplicht
2.1
PaymentInformationIdentification
Verplicht
Rec 0 pos 118-127
2.2
PaymentMethod
Verplicht
2.3
BatchBooking
Aanbevolen
2.17
RequestedExecutionDate
Verplicht
Rec 0 pos 17-22
2.19
Debtor
Verplicht
Rec 0 pos 39-116
2.20
Debtor Account
Verplicht
Rec 0 pos 27-38
2.21
Debtor Agent
Verplicht
2.27
CreditTransferTransactionInformation
Verplicht
2.28
PaymentIdentification
Verplicht
2.30
EndToEndIdentification
<EndToEndId>
Verplicht
2.42
Amount
Verplicht
2.43
InstructedAmount
Verplicht
Rec 1 pos 36-47
2.79
Creditor
Verplicht
Rec 1 pos 48-73
2.80
Creditor Account
Aanbevolen
Rec 1 pos 24-35
2.98
Remittance Information
Aanbevolen
Rec 1 pos 75-127
In het CIRI01-protocol was het niet mogelijk een globaal of individueel debet te vragen in het bestand zelf. Het uploaden van een bestand werd beschouwd als een globaal debet voor dat bestand. In het XML-protocol kunt u via de “BatchBooking”parameter kiezen tussen een globaal debet of een debet per transactie.
Handleiding XML-formaat in België Europese overschrijvingen 16
Referentie-informatie
In de onderstaande tabel wordt vermeld waar u informatie vindt over de referenties.
Index
Berichtitem
Beschrijving
1.1
MessageIdentification
Deze verplichte referentie wordt door u als afzender bepaald en naar uw bank gestuurd ter identificatie van het bericht. We raden aan om de lengte te beperken tot maximaal 30 karakters. Deze referentie komt niet voor in uw CODA-rapportering.
2.1
PaymentInformationIdentification
Deze verplichte referentie wordt door u als afzender bepaald om het “Payment Information”-blok in het bericht ondubbelzinnig te identificeren. We raden aan om de lengte te beperken tot maximaal 30 karakters. Deze referentie wordt gebruikt wanneer “true” wordt gevraagd (voor MECT). Ze komt voor in uw CODA-rapportering in het referentieveld van het totale bedrag.
2.29
InstructionIdentification
Deze facultatieve referentie wordt door u als afzender bepaald en naar uw bank gestuurd ter identificatie van de transactie. Aangezien deze identificatie slechts als referentie dient tussen de afzender en diens bank, wordt ze niet naar de bank van de crediteur gestuurd.
2.30
EndToEndIdentification
Deze verplichte referentie wordt door u als afzender bepaald om de transactie ondubbelzinnig te identificeren. Deze identificatie wordt ongewijzigd doorgestuurd doorheen de volledige “endto-end”-keten. Deze referentie komt voor in uw CODA-rapportering op detailniveau. Bij Europese overschrijvingen wordt deze unieke identificatie doorgestuurd naar de begunstigde.
Handleiding XML-formaat in België Europese overschrijvingen 17
5. Nuttige links Febelfin http://www.febelfin.be/nl/betaalverkeer/richtlijnen-en-protocollen-bankstandaarden ISO20022 – CustomerCreditTransferInitiation http://www.iso20022.org European Payments Council (EPC) http://www.europeanpaymentscouncil.eu/content.cfm?page=sepa_credit_transfer Formaatvalidatietool De gebruikershandleiding is beschikbaar op de website via deze link: http://www.ingsepa.com/formatvalidationtool/en
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 – 01/14 – © Editing Team & Graphic Studio – Marketing ING Belgium