De KBC IBAN-convertor
Inhoudstabel
1. Het doel van de IBAN-convertor ................................................................................. 3 1.1. Functionele beschrijving........................................................................................ 3 1.1.1. Het tabblad Snelle conversie .......................................................................... 3 1.1.2. Het tabblad Converteer bestand...................................................................... 4 2. Installatie van de IBAN-convertor ............................................................................... 5 3. Updates voor de ‘IBAN-convertor’ ............................................................................... 9 3.1. Update BIC-referentiebestand................................................................................ 9 3.2. Detectie nieuwe versie van de ‘IBAN-convertor’...................................................... 10 4. Conversie van één enkel rekeningnummer ................................................................. 11 5. Omzetting van een bestand met een lijst van rekeningnummers ................................... 13 5.1. Stap 1: Het te importeren bestand selecteren ....................................................... 13 5.2. Stap 2: Controle vóór de conversie...................................................................... 13 5.3. Stap 3: Exporteer het bestand ............................................................................. 14 6. Compatibele bestanden voor import van tegenpartijgegevens....................................... 17 6.1. Wat is een bestand met extensie txt? ................................................................... 17 6.2. Wat is een XML-bestand? .................................................................................... 17 6.3. Compatibel bestand met extensie txt zonder koptekst voor importeren van tegenpartijgegevens ................................................................................................... 18 6.3.1. Wat is de lay-out van een bestand met extensie txt zonder koptekst? ................ 18 6.3.2. Definitie van de verschillende veldblokken...................................................... 18 6.3.2.1. Veldblok ‘Tegenpartij’ (verplicht) .............................................................. 18 6.3.2.2. Veldblok ‘BegunstigdeCirculaireChequeInfo’ (optioneel)................................ 19 6.3.2.3. Veldblok ‘BegunstigdeRekening’ (optioneel)............................................... 20 6.3.2.4. Veldblok ‘DebiteurDomiciliëringsnummer’ (optioneel)................................... 20 6.3.2.5. Voorbeelden .......................................................................................... 21 6.4. Compatibel bestand met extensie txt met koptekst voor importeren van tegenpartijgegevens ................................................................................................... 22 6.4.1. Wat is de lay-out van een bestand met extensie txt met koptekst? .................... 22 6.4.2. Voorbeelden: ............................................................................................. 22 6.5. Compatibel XML-bestand voor importeren van tegenpartijgegevens .......................... 23 6.5.1. Hoe is dit specifieke XML-bestand ingedeeld?.................................................. 23 6.5.2. Definitie van de verschillende veldblokken...................................................... 23 6.5.2.1. Veldblok 'Tegenpartij' (verplicht) .............................................................. 23 6.5.2.2. Veldblok ‘BegunstigdeCirculaireChequeInfo’ (optioneel)................................ 24 6.5.2.3. Veldblok ‘BegunstigdeRekening’ (optioneel)................................................ 25 6.5.2.4. Veldblok ‘DebiteurDomiciliëringsnummer’ (optioneel)................................... 26
Ver.1.0
page 2 van 26
1.
Het doel van de IBAN-convertor
SEPA schrijft het gebruik van een IBAN + BIC-code voor in plaats van de oude structuur van rekeningnummers in de BBAN-vorm (XXX-XXXXXXX-XX)). Dat betekent dus ook dat u een conversie van uw begunstigden zal moeten doen van BBAN naar IBAN + BIC. De IBAN-convertor voorziet in twee behoeften: •
ERP-pakketten bevatten veel oude rekeningnummers die moeten vervangen worden door de nieuwe IBAN-rekeningnummers + BIC-codes. De IBAN-convertor maakt een inen uitvoer mogelijk vanuit een ERP-pakket in gestructureerde XML of TXT bestanden. De omgezette bestanden bevatten zowel het oude als het nieuwe rekeningnummer.
•
Sommige gebruikers willen wellicht eenmalig een oud rekeningnummer omzetten in een IBAN-rekeningnummer + BIC-code.
Dit document beschrijft de tool die KBC gebruikt om bovenstaande behoeften te vervullen. Opgelet: hoewel aan sommige begunstigden gegevens over debiteuren en circulaire cheques kunnen zijn gekoppeld, worden uitsluitend de gegevens van Belgische begunstigde rekeningen omgezet. Aangezien domiciliëring in de SEPA-context nog niet beschikbaar is, worden deze gegevens niet omgezet bij de verwerking door de IBAN-convertor. 1.1. Functionele beschrijving De IBAN-convertor is een zelfstandige toepassing die offline kan opereren (zonder internetverbinding) en omvat twee mogelijke werkstromen die op het beginscherm worden weergegeven als tabs, zoals te zien in het bijgaande screenshot. Het gaat om de tabs ‘Snelle conversie’ en 'Converteer bestand'.
1.1.1. Het tabblad Snelle conversie In dit programma kan de gebruiker een Belgisch rekeningnummer (BBAN-code) invoeren en door vervolgens op de knop Converteer te drukken worden de IBAN en de BIC-code gegenereerd, samen met de gegevens van de bank.
Ver.1.0
page 3 van 26
1.1.2. Het tabblad Converteer bestand Bedrijven die hun begunstigden vanuit hun ERP- of boekhoudpakket willen converteren van het oude BBAN formaat naar het nieuwe IBAN- en BIC-formaat, kunnen deze tool gebruiken. Vervolgens kan het resulterende bestand terug worden geüpload in hun ERP- of boekhoudpakket. De IBAN-convertor kan drie verschillende bestandsindelingen verwerken: •
XML-bestand
•
TXT-bestand met koptekst (*)
•
TXT-bestand zonder koptekst
(*). Hou er rekening mee dat een TXT-bestand met koptekst niet in een XML-bestand kan worden geëxporteerd. De gebruiker doorloopt het omzettingsproces aan de hand van een gebruiksvriendelijke interface met heldere visuele feedback en stapsgewijze instructies. Na het uploaden wordt de gebruiker door een proces van drie stappen geleid: 1.
De gegevens van het geüploade bestand worden gevalideerd en als de validatie slaagt, vervolgens omgezet.
2.
De tabel wordt gepresenteerd om het resultaat van het proces zichtbaar te maken. Ook wordt aangegeven voor welke rekeningen fouten zijn gegenereerd. Deze fouten kunnen in dezelfde tabel worden hersteld.
3.
Nadat alle fouten zijn verholpen kan het bestand worden opgeslagen. De gebruiker kan tevens selecteren welke begunstigden moeten worden opgeslagen. Voor het exportbestand kunt u kiezen uit drie indelingen: • XML-bestand • TXT-bestand met koptekst • TXT-bestand zonder koptekst.
ERP
Ander boekhoud - pakket
Andere eBanking applicatie
STAP 1 Validatie & Conversie
TXT
Bekijk veranderingen Foutenoverzicht Correctie fouten
STAP 3 Export als XML of TXT
TXT
Met Hoofding
Met Hoofding
TXT
Zonder Hoofding
XML
Ver.1.0
STAP 2
TXT Zonder hoofding
XML
page 4 van 26
2.
Installatie van de IBAN-convertor 1. Surf naar http://www.kbc.be/ibanconvertor 2. Zoek het onderdeel KBC IBAN-convertor en start de download. 3. Navigeer naar de locatie waar u de IBAN-convertor hebt gedownload en dubbelklik op het bestand “Converter.msi”.
4. U komt terecht in het welkomvenster van de IBAN-convertor installatie wizard. Klik op de knop Volgende om de installatie te starten.
Ver.1.0
page 5 van 26
5. Het volgende venster dat verschijnt, is het venster met de licentieovereenkomst. Zorg ervoor dat u de optie Ik ga akkoord met de voorwaarden van de licentieovereenkomst hebt geselecteerd en klik op de knop Volgende om verder te gaan.
6. Het volgende venster dat verschijnt laat u toe om installatielocatie te wijzigen van de IBAN-convertor. Indien u deze wenst te installeren op een andere locatie, kan u dit doen door op de knop Wijzigen te klikken en dan uw installatielocatie te kiezen. Klik op de knop Volgende indien u deze niet wenst te wijzigen.
Ver.1.0
page 6 van 26
7. De setup wizard heeft de benodigde informatie verzameld om de installatie te voltooien. Klik op de knop Installeren om verder te gaan.
8. De setup wizard installeert de benodigde bestanden. Wacht tot deze gedaan heeft.
Ver.1.0
page 7 van 26
9. Als de installatie gedaan is, komt u in het volgende venster terecht. Klik op de knop Voltooien om de setup te beëindigen.
Ver.1.0
page 8 van 26
3.
Updates voor de ‘IBAN-convertor’
3.1. Update BIC-referentiebestand Het door de gebruiker gedownloade installatiepakket van de ‘IBAN-convertor’ bevat een BICreferentietabel. Deze tabel vervult twee functies: • •
Hij bevat de omzettingsregels voor de BIC-codes. Hij koppelt het protocolnummer van het lokale rekeningnummer (eerste 3 cijfers van het rekeningnummer) aan een BIC-code.
Het programma moet telkens als de toepassing wordt gestart verbinding leggen met de server om na te gaan of de achterliggende BIC-referentietabel up-to-date is. Ten behoeve van dit proces is deze tabel voorzien van een versienummer. Als de server over een recentere versie van de BIC-tabel beschikt, legt het programma verbinding met de server en wordt het bestand gedownload. Deze update verloopt op de achtergrond, zonder dat u ervan wordt verwittigd. Als geen verbinding kan worden gelegd (als gevolg van beperkte internettoegang, een firewall...) wordt een waarschuwing weergegeven.
Als de BIC-referentietabel zes maanden lang niet is bijgewerkt, wordt een pop-upvenster weergegeven met de waarschuwing ‘Uw database is ouder dan 180 dagen. Dit kan verkeerde resultaten opleveren. Voer een update uit voor deze toepassing.’ U moet dan op de knop Sluiten klikken, waarna de IBAN-convertor opent. Indien u dan beschikt over een vrije internetverbinding, gebeurt de update automatisch op de achtergrond.
Ver.1.0
page 9 van 26
3.2. Detectie nieuwe versie van de ‘IBAN-convertor’ Tijdens de controle of de BIC-referentietabel op de server is bijgewerkt gaat de toepassing tevens na of er een nieuwere versie van het programma beschikbaar is. Als er een nieuwere versie beschikbaar is, wordt dit in een waarschuwingsbericht gemeld voordat het programma wordt gestart.
De nieuwere versie wordt niet automatisch geüpdatet, maar u kan de laatste versie steeds terugvinden op de volgende website: http://www.kbc.be/ibanconvertor.
Ver.1.0
page 10 van 26
4.
Conversie van één enkel rekeningnummer
U kunt een enkel Belgisch rekeningnummer omzetten van BBAN naar IBAN + BIC-code. U krijgt dan eveneens ook de naam en het adres van de bank. Bij het starten van de ‘IBAN-convertor’ krijgt u twee tabs te zien. De tab ‘Snelle conversie’ en de tab ‘Converteer bestand’, waarover u in hoofdstuk 5 uitleg krijgt. U ziet dat het tabblad ‘Snelle conversie’ uit twee hoofdonderdelen bestaat, namelijk het onderdeel ‘Invoer basis rekeningnummer’ en het onderdeel ‘Gegenereerde IBAN-nummer en BIC-code’.
Voor het omzetten van een BBAN-rekeningnummer naar een IBAN-rekeningnummer, voert u het nummer in het veld Oorspronkelijk reknr. in, zoals te zien is in de onderstaande afbeelding. Als het rekeningnummer op de juiste wijze is ingetypt, wordt het herkend als een correct rekeningnummer en wordt het in het groen afgebeeld.
Als het rekeningnummer niet voldoet aan de vereisten van de BBAN-notatie, wordt een foutbericht weergegeven. Klik op de knop Sluiten en vervolgens op de knop Velden wissen en voer een geldig BBAN-rekeningnummer in.
Ver.1.0
page 11 van 26
Als het BBAN-rekeningnummer is gevalideerd klikt u op de knop Converteer. U ontvangt het IBAN-rekeningnummer en de bijbehorende BIC-code. Eveneens wordt het bijbehorende bankadres weergegeven.
Als u nog een rekeningnummer wilt omzetten, klikt u gewoon op de knop Velden wissen om opnieuw te beginnen.
Merk op:
Het maakt niet uit of u het BBAN-rekeningnummer zonder scheidingstekens intypt (bijv. 000000009797) of in een andere vorm (bijv.: 000-000009797). U kunt vrijwel alle scheidingstekens gebruiken (waaronder onderstreping, puntjes, slash, streepjes, ...).
Ver.1.0
page 12 van 26
5.
Omzetting van een bestand met een lijst van rekeningnummers
Zoals in het vorige hoofdstuk al werd gemeld zijn er twee mogelijkheden voor het omzetten van BBAN-rekeningnummers in IBAN-rekeningnummers: één rekeningnummer omzetten of een bestand omzetten dat een lijst met rekeningnummers bevat. Dit is de tweede keuzemogelijkheid. Hiermee kunt u een bestand dat aangemaakt werd door een andere toepassing (bijv. boekhoudpakketten, ERP, andere toepassingen voor e-banking, …) uploaden. Dit bestand, dat de extensie TXT of XML moet hebben, moet worden aangemaakt door de toepassing van een andere leverancier en moet zijn gestructureerd volgens de voorschriften in hoofdstuk 6. Dit bestand kan vervolgens in de ‘IBAN-convertor’ worden geïmporteerd via een venster voor openen van bestanden. 5.1. Stap 1: Het te importeren bestand selecteren Ga naar de locatie van het bestand dat de begunstigden bevat die u wilt importeren. Selecteer het bestand en klik op de knop Importeer >>.
5.2. Stap 2: Controle vóór de conversie Na het importeren van de begunstigden krijgt u de gelegenheid om de begunstigden te selecteren die u wilt omzetten, en ten tweede kunt u de gegevens corrigeren als er fouten worden aangetroffen. Standaard zijn alle begunstigden geselecteerd voor het importeren. Ook wordt in een apart onderdeel het totale aantal aangetroffen fouten weergegeven.
Onder het berichtgebied worden alle begunstigden weergegeven in een tabel met de volgende kolommen. Er zijn twee hoofdonderdelen, namelijk ‘Informatie begunstigde’ met de gegevens uit het geïmporteerde bestand, en ‘Conversie informatie’ met de conversiegevens die de ‘IBANconvertor’ aantreft in het geïmporteerde bestand.
Ver.1.0
page 13 van 26
De fouten worden in het rood weergegeven in de betreffende kolom. Als voor een rekening bijvoorbeeld geen BIC-gegevens zijn aangetroffen, wordt de BIC-cel in het rood weergegeven. In de kolom ‘Conversie commentaar’ wordt het bericht ‘Geen BIC gevonden’ weergegeven. Alle waarden die tijdens het omzettingsproces met goed gevolg zijn toegevoegd, worden groen gemarkeerd. De oorspronkelijke waarden blijven in het wit staan, zodat de oorspronkelijke waarden uit het begunstigdenbestand goed herkenbaar blijven. Als er begunstigden zijn met meerdere rekeningnummers, worden die elk in een eigen regel weergegeven. De volgende fouten kunnen zich voordoen: Geen BIC gevonden of BIC ongeldig: • Als het protocolnummer (eerste 3 cijfers van een rekeningnummer) niet kan worden opgehaald uit de databasetabel. Dit kan bijvoorbeeld gebeuren als België wordt gekozen als land van de rekening, terwijl een buitenlands rekeningnummer is ingevoerd. • Als een BIC-code al in het oorspronkelijke geïmporteerde bestand stond, maar niet voorkomt in de databasetabel. Lokaal rekeningnummer ongeldig of geen koppeling beschikbaar: • Als de controlegetallen onjuist zijn. • Zo kan een rekeningnummer niet binnen een officieel ondersteunde reeks vallen. Als dit zich voordoet, moet u uw bank om nadere inlichtingen vragen. IBAN niet geldig: Als de IBAN al in het oorspronkelijk geïmporteerde bestand stond en de check-digits zijn onjuist. Voor het corrigeren van fouten gaat u naar de rood gemarkeerde velden en wijzigt u de informatie. Als de gewijzigde informatie correct is, wordt de eerder rood gemarkeerde cel groen. 5.3. Stap 3: Exporteer het bestand Als u alle geïmporteerde begunstigden hebt nagelopen en alle aangetroffen fouten verholpen, kunt u de gegevens gaan exporteren. Als er begunstigden in de lijst staan die u niet wilt exporteren, kunt u de selectie ongedaan maken door het bijbehorende selectievakje met de titel ‘Exporteren’ uit te schakelen. In het onderstaande voorbeeld wordt de tweede begunstigde weggelaten.
Ver.1.0
page 14 van 26
Nu kunt u het bestand gaan exporteren. Klik op de knop Volgende >> in de rechter onderhoek van het programma.
In het volgende venster dat wordt weergegeven moet u eerst op de knop Browse klikken om te selecteren waar u het bestand wilt opslaan. Het programma biedt de mogelijkheid om een bestand met de extensie TXT of XML te exporteren. Wij zullen hier verder alleen de XML-optie bespreken.
In het bladervenster gaat u naar de bestandslocatie waar u het XML-bestand wilt opslaan. Typ de gewenste bestandsnaam. Als u klaar bent, klikt u ter bevestiging op de knop OK.
Ver.1.0
page 15 van 26
U gaat terug naar het voorgaande scherm, waar u ziet dat zowel de bestandslocatie als de bestandsnaam is ingevuld in de balk ‘Kies export bestandsnaam’. Klik op de knop Exporteren om verder te gaan.
Als u in het vorige scherm begunstigden hebt uitgesloten van de exportbewerking, krijgt u een bevestigingsvenster met een overzicht van de gegevens die geëxporteerd gaan worden. Als de tabel nog fouten bevat (rood gemarkeerd) krijgt u het bericht ‘X van de X zullen bewaard worden (aangevinkt). Sommige rekeningnummers bevatten nog fouten. Zie rode cellen. Wenst u verder te gaan en dit bestand te bewaren?’ en krijgt u de gelegenheid om terug te gaan door op de knop Nee te drukken. Anders klikt u op de knop Ja.
Hierna wordt een bevestigingsvenster weergegeven. U hoeft slechts op de knop Sluiten te drukken om te bevestigen.
Ver.1.0
page 16 van 26
6.
Compatibele bestanden voor import van begunstigdengegevens
Zoals eerder gemeld kunnen drie verschillende bestandsindelingen worden gebruikt om gegevens in de ‘IBAN-convertor’ te importeren: • bestand met extensie txt (in TXT-indeling) zonder koptekst • bestand met extensie txt met koptekst (in TXT-indeling) • sterker gestructureerd bestand (in XML-indeling) 6.1. Wat is een bestand met extensie txt? Een bestand met extensie txt is een computerbestand dat alleen op volgorde kan worden gelezen of geschreven. Het bestaat uit een of meer records. Elk record beslaat één regel en omvat een of meer velden. Elk veld kan een gegevenswaarde bevatten of leeg worden gelaten. Vaak heeft elk veld een vaste breedte. In het veel voorkomende geval waarbij alle velden en alle records een vaste breedte hebben, kan het platte bestand een bestand met vaste breedte worden genoemd. Bij een record met variabele breedte worden de velden van elkaar gescheiden door een speciaal teken zoals een tabteken, een komma of een puntkomma. De tool accepteert enkel de puntkomma. 6.2. Wat is een XML-bestand? Extensible Markup Language (XML) is een universele opmaaktaal. Het wordt geclassificeerd als een 'extensible language' omdat het gebruikers toelaat om eigen elementen te definiëren. Het primaire doel is om het delen van gestructureerde gegevens tussen verschillende informatiesystemen mogelijk te maken, in het bijzonder via internet. Het wordt zowel gebruikt voor het coderen van documenten als voor het serialiseren van gegevens. In deze laatste context is het vergelijkbaar met andere serialisatietalen op tekstbasis. Een XML-document kan op twee niveaus al dan niet correct zijn: •
•
Ver.1.0
Gestructureerd. Een gestructureerd document voldoet aan alle syntaxisregels van XML. Als bijvoorbeeld een startmarkering verschijnt zonder de bijbehorende eindmarkering, is het document niet gestructureerd. Een document dat niet gestructureerd is, wordt niet als XML beschouwd; het mag dan niet worden verwerkt door een conformerende parser. Geldig. Een geldig document voldoet hiernaast aan bepaalde semantische regels. Deze regels kunnen door de gebruiker gedefinieerd zijn, of zijn bijgesloten in de vorm van een XML-schema of DTD (documenttype-definitie). Als een document bijvoorbeeld een ongedefinieerd element bevat, is het niet geldig; het mag dan niet worden verwerkt door een validerende parser.
page 17 van 26
6.3. Compatibel bestand met extensie txt zonder koptekst voor importeren van tegenpartijgegevens 6.3.1. Wat is de lay-out van een bestand met extensie txt zonder koptekst? Een regel of record kan de volgende veldblokken bevatten:
tegenpartij + gegevens circulaire cheque (BeneficiaryCircularChequeInfo); OF tegenpartij + rekeningnummer (BenificiaryAccount); OF tegenpartij + domiciliëringsnummer (DebtorDirectDebitNumber).
Belangrijk: Aangezien het veldscheidingsteken een puntkomma is, mag dit teken absoluut niet binnen een veld worden gebruikt. 6.3.2. Definitie van de verschillende veldblokken 6.3.2.1. FIELD XC1
Veldblok ‘Tegenpartij’ (verplicht) NAME Land rekening
TYPE A
XC2
Alias
AN
XC3 XC4 XC5 XC6 XC7 XC8 XC9
Naam Adres Postcode Gemeente Land E-mailadres Telefoon
AN AN AN AN A AN AN
Y
Selectieveld
N
LENGTH CONTENT 2 Alfabetische ISO-landcode van de rekening van de tegenpartij 64 Korte naam of code voor intern gebruik in uw onderneming - optioneel 64 Volledige naam van de tegenpartij 64 Adres van de tegenpartij 64 Postcode van de tegenpartij 64 Gemeente van de tegenpartij 2 Alfabetische ISO-landcode van de tegenpartij 256 E-mailadres van de tegenpartij - optioneel 32 Telefoonnummer van de tegenpartij optioneel 1 Het selectieveld bepaalt of de regel een derde blok bevat en zo ja, wat voor een blok. Dit selectieveld heeft als waarde een geheel getal van 1 tot 3: 1: dit veld wordt gevolgd door een blok BeneficiaryCircularChequeInfo. 2: dit veld wordt gevolgd door een blok BenificiaryAccount. 3: dit veld wordt gevolgd door een blok DebtorDirectDebitNumber.
Notatie: XC1;XC2;XC3;XC4 ;XC5 ;XC6 ;XC7 ;XC8 ;XC9 ;Y
Ver.1.0
page 18 van 26
6.3.2.2.
Veldblok ‘BegunstigdeCirculaireChequeInfo’ (optioneel)
FIELD
NAME
TY PE AN
LENGTH
XCC1
Methode
XCC2
Taal
N
1
XCC3
Aanspreking
N
1
XCC4
Kosten
N
1
12
CONTENT 9900000000065: gewone cheque, te sturen naar de begunstigde klant; 9910000000044: circulaire cheque, te sturen naar en betalen aan de begunstigde klant zelf; 9940000000078: gewone circulaire cheque, over te maken naar de bestellende klant; 9950000000057: circulaire cheque, over te maken naar de bestellende klant en te betalen aan de geadresseerde zelf. 0: niet vermeld 1: Nederlands 2: Frans 3: Duits 0: geen aanspreektitel 1: Mr. 2: Mevr. 3: Mejuffrouw 4: Dhr. en Mevr. 5: Dhr. of Mevr. 6: Weduwe 0: SHA: gedeelde kosten (weggelaten bij implementatie) 1: BEN: alle kosten gedragen door begunstigde 2: OUR: alle kosten gedragen door bestellende klant
Notatie: XC1;XC2;XC3;XC4;XC5;XC6;XC7;XC8;XC9;1;XCC1;XCC2;XCC3;XCC4 NB: Per tegenpartij is slechts één blok BeneficiaryCircularChequeInfo toegestaan.
Ver.1.0
page 19 van 26
6.3.2.3.
Veldblok ‘BegunstigdeRekening’ (optioneel)
FIELD XCA1 XCA2 XCA3
NAME Rekening_IBAN Rekening_Lokaal Rekening_Vrij
XCA4
BankSwift
TYPE AN AN AN
LENGTH 64 64 64
AN
12
CONTENT Minimaal één van deze drie velden moet zijn ingevuld. De volgende combinaties zijn toegestaan: • Rekening_IBAN en Rekening_Vrij • Rekening_IBAN en Rekening_Lokaal De volgende combinaties zijn NIET toegestaan: • Rekening_Lokaal en Rekening_Vrij Als Rekening_Lokaal is ingevuld, zijn geen andere gegevens toegestaan. Anders zijn zowel Rekening_IBAN als Rekening_Lokaal toegestaan. Het veld BankSwift is optioneel (het is bijvoorbeeld niet geconfigureerd voor Belgische bankrekeningen gebruikt in binnenlandse Belgische transacties) en moet een geldige BIC-code zijn.
Notatie: XC1;XC2;XC3;XC4;XC5;XC6;XC7;XC8;XC9;2;XCA1;XCA2;XCA3;XCA4
6.3.2.4.
Veldblok ‘DebiteurDomiciliëringsnummer’ (optioneel).
FIELD XCD1 XCD2
NAME Identificatienummer Domiciliëringsnummer
TYPE N AN
LENGTH 6 32
XCD3
Einddatum
N
6
XCD4
Bedrag
N
XCD5 XCD6 XCD7
Munt Terugbetaling Mededeling
AN
XCD8
Referentie
AN
AN
3
CONTENT Intern serienummer Domiciliëringsnummer van de tegenpartij De notatie voor de Einddatum is: ‘ddMMjj’. Optioneel veld wanneer het een vast bedrag betreft dat moet worden overgeschreven. Munt (optioneel) Ja/nee (optioneel) De mededeling aan de begunstigde zoals deze in uw rekeningafschriften wordt vermeld (optioneel) Een gestructureerde mededeling voor de begunstigde (optioneel)
Notatie: XC1;XC2;XC3;XC4;XC5;XC6;XC7;XC8;XC9;3;XCD1;XCD2;XCD3;XCD4;XCD5;XCD6,XCD7;XCD8
Ver.1.0
page 20 van 26
6.3.2.5.
Voorbeelden
Twee begunstigden die beide een lokaal rekeningnummer hebben: De inhoud van het invoerbestand ziet er als volgt uit: BE;Alias01;Alias01;Adres01;1000;Brussel;BE;
[email protected];02/222.22.20;2;;000-0000097-97; BE;Alias02;Alias02;Adres02;1000;Brussel;BE;
[email protected];02/222.22.21;2;;199-0317601-15;
Na uitvoer naar een TXT-bestand ziet de inhoud van het uitgevoerde bestand er als volgt uit. BE;Alias01;Alias01;Adres01;1000;Brussel;BE;
[email protected];02/222.22.20;2;BE54000000009797;000-0000097-97;;BPOTBEB1 BE;Alias02;Alias02;Adres02;1000;Brussel;BE;
[email protected];03/222.22.21;2;BE83199031760115;199-0317601-15;;CREGBEBB
Zoals u ziet heeft de IBAN-convertor het IBAN-rekeningnummer en de BIC-code toegevoegd. Eén tegenpartij met een lokaal rekeningnummer en een circulaire cheque: De inhoud van het invoerbestand ziet er als volgt uit: BE;Mol;MOL;MOLDREEF;3724;VLIERMAAL;BE;;;2;;000-3180361-22;; BE;Mol;MOL;MOLDREEF;3724;VLIERMAAL;BE;;;1;991-0000000-44;1;1;1;
Na uitvoer naar een TXT-bestand ziet de inhoud van het uitgevoerde bestand er als volgt uit. BE;Mol;MOL;MOLDREEF;3724;VLIERMAAL;BE;;;2;BE06000318036122;000-3180361-22;;BPOTBEB1 BE;Mol;MOL;MOLDREEF;3724;VLIERMAAL;BE;;;1;991-0000000-44;1;1;1
Zoals u ziet heeft de IBAN-convertor het IBAN-rekeningnummer en de BIC-code toegevoegd. Ook is de informatie van de circulaire cheque weer meegenomen. Eén tegenpartij met een lokaal rekeningnummer en een domiciliëringsnummer: De inhoud van het invoerbestand ziet er als volgt uit: BE;Alias01;Alias01;Adres01;1000;Brussel;BE;
[email protected];02/222.22.20;2;;000-0000097-97; BE;Alias01;Alias01;Adres01;1000;Brussel;BE;
[email protected];02/222.22.20;3;2;000100000229;041205;1,05;EUR;YES;MESSAGE;* **000/0000/00505***;
Na uitvoer naar een TXT-bestand ziet de inhoud van het uitgevoerde bestand er als volgt uit. BE;Alias01;Alias01;Adres01;1000;Brussel;BE;
[email protected];02/222.22.20;2;BE54000000009797;000-0000097-97;;BPOTBEB1 BE;Alias01;Alias01;Adres01;1000;Brussel;BE;
[email protected];02/222.22.20;3;2;000100000229;041205;1,05;EUR;YES;MESSAGE;* **000/0000/00505***;
Zoals u ziet heeft de IBAN-convertor het IBAN-rekeningnummer en de BIC-code toegevoegd. Ook is de informatie van het domiciliëringsnummer weer meegenomen.
Ver.1.0
page 21 van 26
6.4. Compatibel bestand met extensie txt met koptekst voor importeren van tegenpartijgegevens 6.4.1. Wat is de lay-out van een bestand met extensie txt met koptekst? De IBAN-convertor kijkt of ergens in de eerste regel ‘ACCOUNTNUMBER’ (rekeningnummer) wordt aangetroffen. Als dat het geval is, wordt het platte bestand beschouwd als een bestand met extensie txt met koptekst. Anders is het een bestand met extensie txt zonder koptekst (zie paragraaf 6.3). Deze eerste regel heet de koptekst. Als in de eerste regel tevens ‘BICCODE’ voorkomt, dan wordt de bijbehorende BIC-code ook gecontroleerd. Voorbeeld: ;;;;;;ACCOUNTNUMBER;;;;;;;; 1;2;3;4;5;6;000-0000088-88;8;9;10;11;12;13;14; Zoals u ziet staat ‘REKENINGNUMMER’ in dit voorbeeld na de 6e puntkomma op de eerste regel. Dat betekent dat alle te migreren rekeningnummers in de onderstaande regels ook na de 6e moeten staan. Als in een importbestand ‘REKENINGNUMMER’ zich bijvoorbeeld na de eerste puntkomma bevindt, moet het rekeningnummer in alle volgende regels ook achter de eerste puntkomma staan. Belangrijk: •
Bij een bestand met extensie txt met koptekst worden alleen de rekeningnummers omgezet. Omzetting van circulaire cheques of domiciliëringsnummers is niet mogelijk bij een bestand met extensie txt met koptekst.
•
Een bestand met extensie txt met koptekst kan alleen naar een nieuw bestand met extensie txt (TXT) worden geëxporteerd. Het is dus niet mogelijk om naar een XMLbestand te exporteren.
6.4.2. Voorbeelden: Dit voorbeeld bevat verscheidene rekeningnummers die moeten worden omgezet. ;;;ACCOUNTNUMBER;;;; Alias01;Name01;Address01;000-0000088-88;4;5;6; Alias02;Name02;Address02;000-0000066-66;4;5;6; Alias03;Name03;Address03;000-0000033-33;4;5;6; Na de omzetting ziet het uitvoerbestand er als volgt uit: EXPIBANACCOUNTNUMBER;EXPBICCODE;;;;ACCOUNTNUMBER;;;; BE56000000008888;BPOTBEB1;Alias01;Name01;Address01;000-0000088-88;4;5;6; BE07000000006666;BPOTBEB1;Alias02;Name02;Address02;000-0000066-66;4;5;6; BE79000000003333;BPOTBEB1;Alias03;Name03;Address03;000-0000033-33;4;5;6; Zoals u in dit voorbeeld ziet heeft de IBAN-convertor twee velden ingevoegd voor alle records en tevens in de koptekst: • EXPIBANREKENINGNUMMER: met daarin het in IBAN-vorm omgezette rekeningnummer; • EXPBICCODE: met daarin de bijbehorende BIC-code
Ver.1.0
page 22 van 26
6.5. Compatibel XML-bestand voor importeren van tegenpartijgegevens 6.5.1. Hoe is dit specifieke XML-bestand ingedeeld? Een record kan de volgende veldblokken bevatten:
Tegenpartij (Counterparty); OF tegenpartij + gegevens circulaire cheque (BeneficiaryCircularChequeInfo); OF tegenpartij + rekeningnummer (BenificiaryAccount); OF tegenpartij + domiciliëringsnummer (DebtorDirectDebitNumber).
6.5.2. Definitie van de verschillende veldblokken 6.5.2.1.
Veldblok 'Tegenpartij' (verplicht)
Voorbeeld:
BE Alias 1 Jan Keizerinnelaan 1000 BRUSSEL BE <EMAilAddress>[email protected] 012345678
Toelichting op de velden: FIELD NAME AccountCountry Alias Name Address Postcode City Country EmailAddress Telephone Selection Field
Ver.1.0
TYPE LENGTH CONTENT A 2 Alfabetische ISO-landcode van de rekening van de tegenpartij AN 64 Korte naam of code voor intern gebruik in uw onderneming - optioneel AN 64 Volledige naam van de tegenpartij AN 64 Adres van de tegenpartij AN 64 Postcode van de tegenpartij AN 64 Gemeente van de tegenpartij A 2 Alfabetische ISO-landcode van de tegenpartij AN 256 E-mailadres van de tegenpartij - optioneel AN 32 Telefoonnummer van de tegenpartij - optioneel AN 64 Afhankelijk van de tegenpartijgegevens kan er (niet verplichte) onderliggende informatie aanwezig zijn zoals: • BegunstigdeCirculaireCheque • BegunstigdeRekening • DebiteurDomiciliëringsnummer
page 23 van 26
6.5.2.2.
Veldblok ‘BegunstigdeCirculaireChequeInfo’ (optioneel)
Voorbeeld:
BE Alias 1 Jan Keizerinnelaan 1000 BRUSSEL BE <EMAilAddress>[email protected] 0123456789 <Method>990-0000000-65 1 1 0
Toelichting op de velden: FIELD NAME Method
TYPE LENGTH AN
12
Language
N
1
Title
N
1
Charges
N
1
Ver.1.0
CONTENT Afhankelijk van het soort cheque kan het om de volgende informatie gaan: • 990-0000000-65: gewone circulaire cheque, te sturen naar de begunstigde klant; • 991-0000000-44: circulaire cheque, te sturen naar en betalen aan de begunstigde klant zelf; • 994-0000000-78: gewone circulaire cheque, over te maken naar de bestellende klant; • 995-0000000-75: circulaire cheque, over te maken naar de bestellende klant en te betalen aan de geadresseerde zelf. Mogelijke talen: • 0: Niet vermeld • 1: Nederlands • 2: Frans • 3: Duits Mogelijke aanspreektitels: • 0: geen aanspreektitel • 1: Mr. • 2: Mevr. • 3: Mejuffrouw • 4: Dhr. en Mevr. • 5: Dhr. of Mevr. • 6: Mevr. of Weduwe Mogelijke kostentypen: • 0: SHA => gedeelde kosten (weggelaten bij implementatie) • 1: BEN => alle kosten gedragen door begunstigde • 2: OUR => alle kosten gedragen door bestellende klant
page 24 van 26
6.5.2.3.
Veldblok ‘BegunstigdeRekening’ (optioneel)
Voorbeeld:
BE Alias 1 Jan Keizerinnelaan 1000 BRUSSEL BE <EMAilAddress>[email protected] 012345678 BE54000000009797 000-0000097-97 BPOTBEB1
Toelichting op de velden: FIELD NAME Account_IBAN Account_Local Account_Free BankSwift
TYPE AN AN AN AN
LENGTH CONTENT 64 64 64 12
Minimaal één van de drie velden (Rekening_IBAN, Rekening_Lokaal of Rekening_Vrij) moet zijn ingevuld. De volgende combinaties zijn toegestaan: • Rekening_IBAN en Rekening_Vrij; • Rekening_IBAN en Rekening_Lokaal. De volgende combinaties zijn NIET toegestaan: • Rekening_Lokaal en Rekening_Vrij. Als het veld Rekening_Lokaal is ingevuld, zijn geen andere gegevens toegestaan. Anders is zowel Rekening_IBAN als Rekening_Lokaal toegestaan. Het veld BankSwift is optioneel (het is bijvoorbeeld niet geconfigureerd voor Belgische bankrekeningen gebruikt in binnenlandse Belgische transacties) en moet een geldige BIC-code zijn.
Ver.1.0
page 25 van 26
6.5.2.4.
Veldblok ‘Domiciliëringsnummer’ (optioneel)
Voorbeeld:
BE Alias 1 Jan Keizerinnelaan 1000 BRUSSEL BE <EMAilAddress>[email protected] 012345678 0123456789 <EndDate>311208 <Message>
Toelichting op de velden: FIELD NAME Identifier DirectDebitNumber EndDate Amount
TYPE N AN N N
LENGTH 6 32 6
Currency Refund Message
AN
3
Reference
AN
Ver.1.0
AN
CONTENT Intern serienummer Domiciliëringsnummer van de tegenpartij De notatie voor de Einddatum is: ‘ddMMjj’. Optioneel veld wanneer het een vast bedrag betreft dat moet worden overgeschreven. Munt (optioneel) Ja/nee (optioneel) De mededeling aan de begunstigde zoals deze in uw rekeningafschriften wordt vermeld (optioneel). Een gestructureerde mededeling voor de begunstigde (optioneel).
page 26 van 26
