MRI IN CSV FORMAAT Beschrijving bestandsindeling Definitieve versie
Equens SE 25 juli 2014 Classificatie: Versie 1.7
Openbaar
Versie geschiedenis Versie no.
Versie datum
Status
Auteur
Belangrijkste wijzigingen
0.1
11-07-2013
Draft
Equens SE
Eerste opzet
1.0
17-07-2013
Finaal
Equens SE
Definitieve versie
1.1
19-08-2013
Finaal
Equens SE
Creditor Name is verplicht veld, tekstuele correctie voorbeelden
1.2
12-11-2013
Finaal
Equens SE
Creditor Account is verplicht, Creditor Name niet. No Of Transaction kan op nul worden gezet voor Mandate Request Types „E‟ en „A‟. Alle komma‟s in het CSV bestand zijn verplicht; ook bij ontbrekende rubrieken
1.3
29-11-2013
Finaal
Equens SE
Kleine foutjes in het voorbeeld (§ 2.3) verbeterd
1.4
17-01-2014
Finaal
Equens SE
Enkele integriteitsregels toegevoegd.
1.5
23-01-2014
Finaal
Equens SE
Set van toegestane tekens toegevoegd aan integriteitsregels.
1.6
31-1-2014
Finaal
Equens SE
Typefoutjes + voorbeeld aangepast
1.7
25-7-2014
Finaal
Equens SE
Velden „Last Transaction Date‟ en „Number of Transactions‟ verplicht bij Mandate request type „E‟.
Copyright © Equens SE and/or its subsidiaries. All rights reserved. No part of this publication may be copied or reproduced, sold or transferred to any person, in whole or in part, in any manner or form or on any media, without the prior written permission of Equens. The recipient is, however, authorised to copy or reproduce this publication within its own organisation as may be reasonably necessary for the purpose for which it is supplied. Any such copy or reproduction will include the following: acknowledgement of the source, reference and date of the publication, and all notices set out on this page.
MRI in CSV formaat | Beschrijving bestandsindeling
OPENBAAR
Inhoud 1
Inleiding
4
2 2.1 2.2 2.3 2.4
Mandaat gerelateerde gegevens in CSV formaat Algemeen Indeling van de Mandaatregel Enkele integriteitsregels Voorbeeld
5 5 5 7 8
DEFINITIEVE versie | Versie 1.7 | 25 juli 2014 | Page 3 of 8
MRI in CSV formaat | Beschrijving bestandsindeling
1
OPENBAAR
Inleiding
Bedrijven en servicebureaus die de dienst “Formaat Conversie - SDD”, onderdeel van Zakelijk Betalen en Ontvangen, van Equens afnemen, kunnen hun Mandaat gerelateerde gegevens (MRI) aanleveren in CSV formaat. Dit document geeft een beschrijving van deze bestandsindeling. Dit is een Comma Separated Variable (CSV) formaat: een tekstbestand met een vaste indeling, waarbij de velden van elkaar zijn gescheiden door een vast teken (komma).
DEFINITIEVE versie | Versie 1.7 | 25 juli 2014 | Page 4 of 8
MRI in CSV formaat | Beschrijving bestandsindeling
2
OPENBAAR
Mandaat gerelateerde gegevens in CSV formaat
2.1 Algemeen Een MRI bestand in CSV formaat is een tekstbestand met de volgende kenmerken: Elke regel bestaat uit een aantal rubrieken van elkaar gescheiden door middel van een komma De regels worden van elkaar gescheiden door een “Enter” Het bestand bevat slechts één type regel, de zogenaamde Mandaatregel. – Elke mandaatregel bevat de gegevens van één mandaat (machtiging). – De mandaatregel bevat verplichte en optionele rubrieken. – Elke regel in het CSV bestand telt altijd evenveel komma‟s (nl. één minder dan het totaal aantal rubrieken. Als een optionele rubriek niet is ingevuld staat er niets tussen de beide komma‟s die die rubriek van de vorige resp. van de volgende rubriek scheidt. Voorbeelden 1) Rubriek-3 ontbreekt in een regel van vijf rubrieken: rubriek-1,rubriek-2,,rubriek-4,rubriek-5 2) Rubriek-5 ontbreekt in een regel van vijf rubrieken: rubriek-1,rubriek-2,rubriek-3,rubriek-4,
2.2 Indeling van de Mandaatregel
Rubrieknaam
Verplicht / Optioneel / Reservering
Opmaak & (maximale) lengte
Mogelijke waarden
Mandate ID
O
35 tekens
Een unieke identificatie van het mandaat; indien niet ingevuld kent Formaat Conversie een waarde toe.
Mandate Request Id
R
35 tekens
Gereserveerd voor toekomstig gebruik. Niet gebruiken.
Previous Mandate ID
O
35 tekens
De Mandate ID van het te wijzigen mandaat (alleen in geval van een wijziging waarbij het Mandate ID wijzigt)
Mandate Request Type
V
1 teken
N = new A = amended C = cancelled E = existing1
Local Instrument Code
O
4 tekens
CORE = normale incasso B2B = zakelijke incasso
1
Mogelijke waarden en betekenis van Mandate Request Types: N = nieuw mandaat: nieuw voor Equens en – indien doorlopend – de eerste opdracht krijgt Sequence Type FRST; A = amended mandaat: wijziging op een bestaand mandaat; C = cancelled mandaat: vervallen van een bestaand mandaat; E = existing mandaat: het mandaat is nieuw voor Equens, maar de eerstvolgende opdracht krijgt Sequence Type RCUR. Er is dus een bestaande machtiging naar de machtigingenregistratie van Equens verhuisd.
DEFINITIEVE versie | Versie 1.7 | 25 juli 2014 | Page 5 of 8
MRI in CSV formaat | Beschrijving bestandsindeling
OPENBAAR
Sequence Type
O
4 tekens
OOFF = eenmalige machtiging RCUR = doorlopende machtiging
Creditor Scheme ID
V
35 tekens
Een verwijzing naar de incasso-overeenkomst (zoals geregistreerd bij Equens) waarop dit mandaat betrekking heeft
Creditor Name
O
70 tekens
De naam de van crediteur, zoals gebruikt in de incasso-opdrachten voor dit mandaat
Creditor Account Number
V
35 tekens
Het 10-cijferig rekeningnummer of de IBAN van de incasso-opdrachtgever. Indien niet opgegeven wordt dit gegeven bijgezocht uit de registratie bij Equens.
Creditor Agent BIC
O
11 tekens
De BIC van de bank van het Creditor Account Number. Indien niet opgegeven zoekt Equens dit gegeven bij aan de hand van het Creditor Account Number.
Debtor Name
V
70 tekens
De naam van degene die de machtiging heeft afgegeven.
Debtor Address
O
140 tekens
Het adres van degene die de machtiging heeft afgegeven.
Debtor Account Number
V
35 tekens
De bankrekening van degene die de machtiging heeft afgegeven (10-cijferig rekeningnummer of IBAN)
Debtor Agent BIC
O
11 tekens
De BIC van de bank van het Debtor Account Number. Indien niet opgegeven zoekt Equens dit gegeven bij aan de hand van het Debtor Account Number
Mandate Signature Date
O
8 cijfers (EEJJMMDD)
De datum waarop de machtiging is ondertekend. Equens gebruikt 20091101 indien dit gegeven ontbreekt.
Last Transaction Date
O (V bij Mandate Request type „E‟)
8 cijfers (EEJJMMDD)
De datum van de laatste incasso-opdracht die op grond van deze machtiging is uitgevoerd (Verplicht indien Mandate Request Type = „E‟)
Number of Transactions
O (V bij Mandate Request type „E‟)
numeriek
Het aantal reeds uitgevoerde incassoopdrachten op grond van deze machtiging. Dit is alleen relevant indien Mandate Request Type = „E‟ of „A‟. Bij „E‟ is het verplicht
Status
R
35 tekens
Gereserveerd voor toekomstig gebruik. Niet gebruiken.
DEFINITIEVE versie | Versie 1.7 | 25 juli 2014 | Page 6 of 8
MRI in CSV formaat | Beschrijving bestandsindeling
OPENBAAR
2.3 Enkele integriteitsregels Onderstaande overzicht beschrijft aan welke voorwaarden de mandaten in een MRI bestand in CSV formaat dienen te voldoen en wat er gebeurt indien niet aan de regel is voldaan. Integriteitsregel
Gevolg indien de regel wordt overtreden
Het Debtor Account Number dient numeriek te zijn (mag geen andere tekens dan 0 … 9 bevatten)
De rij in het CSV bestand wordt geweigerd; het nieuwe mandaat wordt niet geregistreerd in de mandaten database (of een wijziging of een beëindiging wordt niet doorgevoerd)
Het Debtor Account Number dient uniek te zijn over alle mandaten van de klant
Dit wordt door de CSV inleesfunctie niet gedetecteerd. Daarna kan evenwel op dit “dubbel” geregistreerde rekeningnummer niet meer worden geïncasseerd!
Als Mandate Request Type = „N‟ of „E‟, dan mag het Mandate ID niet reeds in de mandaten database voorkomen
De rij in het CSV bestand wordt geweigerd; het nieuwe mandaat wordt niet geregistreerd in de mandaten database
Als Mandate Request Type = „A‟ of „C‟, dan moet het Mandate ID in de mandaten database voorkomen
De rij in het CSV bestand wordt geweigerd; er wordt geen mandaat gewijzigd of op vervallen gezet.
In tekstrubrieken (zoals bijvoorbeeld Debtor Name) mogen slechts die tekens worden gebruikt die in SEPA berichten zijn toegestaan. Dat zijn:
De CSV inleesfunctie voert hierop geen controle uit. Niet toegestane tekens worden in het SEPA bericht vervangen door vraagtekens.
abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789 /-?:().,„+ Spatie In tekstrubrieken (zoals bijvoorbeeld Debtor Name) mogen de tekens komma, puntkomma, enkele of dubbele quote‟s niet voorkomen. Indien een tekstveld toch een komma moet bevatten dan kan dat mits de gehele tekst in dat veld tussen dubbele quotes wordt aangeleverd.
De CSV inleesfunctie vat het verboden teken als een veldscheidingsteken op, waardoor rubrieken niet op de juiste positie in de mandaten database terecht komen.
Enkele voorbeelden van deze laatste regel: Fout is een komma in een tekstveld (al dan niet tussen quote‟s geplaatst) Debtor Name = Hr. X.Y.Z. de Graaf, erfgenamen van Debtor Name = Hr. X.Y.Z. de Graaf”,” erfgenamen van Debtor Name = Hr. X.Y.Z. de Graaf‟,‟ erfgenamen van Goed is de komma verwijderen of het geheel tussen dubbele quote‟s plaatsen Debtor Name = Erfgenamen van Hr. X.Y.Z. de Graaf Debtor Name = “Hr. X.Y.Z. de Graaf, erfgenamen van”
DEFINITIEVE versie | Versie 1.7 | 25 juli 2014 | Page 7 of 8
MRI in CSV formaat | Beschrijving bestandsindeling
OPENBAAR
2.4 Voorbeeld 01600001,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,A. Janssen,,0392433729,,,,, 01600002,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,B. de Vries,,NL51INGB0000123456,INGBNL2AXXX,,,,, 01600003,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,C. van Zeggelen,,NL74ABNA0439894034,ABNANL2AXXX,,,,, 01600004,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,D. Draaijer,,NL29BOFA0266597882,BOFANLNXXXX,,,,, 01600005,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,E. Wit,,NL65INGB0499201493,INGBNL2AXXX,,,,, 01600006,,,N,B2B,RCUR,NL58ZZZ268538010002,Het Bruine Monster,NL73INGB0987654321,,Zwaan B.V.,,NL33INGB0149283784,INGBNL2AXXX,,,,, 01600007,,,N,B2B,RCUR,NL58ZZZ268538010002,Het Bruine Monster,NL73INGB0987654321,,Gemeentepolitie Den Hoorn,,NL39INGB0001956002,INGBNL2AXXX,,,,, 01600008,,,N,B2B,RCUR,NL58ZZZ268538010002,Het Bruine Monster,NL73INGB0987654321,,Dik Hout B.V.,,NL12RABO0002256059,RABONL2UXXX,,,,, 01600009,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,F. Monsingh,,NL95RABO0285008110,RABONL2UXXX,,,,, 01600010,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,G. de Graaff,,NL91RABO0450306755,RABONL2UXXX,,,,, 01600012,,,N,B2B,RCUR,NL58ZZZ268538010002,Het Bruine Monster,NL73INGB0987654321,,De Vliegende Hollander,,NL06ABNA0100915469,ABNANL2AXXX,,,,, 01600013,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,I. Isaac,,NL51INGB0000123456,INGBNL2AXXX,,,,, 01600014,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,R. Federer,,NL65INGB0499201493,INGBNL2AXXX,,,,, 01600015,,,N,B2B,RCUR,NL58ZZZ268538010002,Het Bruine Monster,NL73INGB0987654321,,Boekhandel Grijs,,NL95RABO0285008110,RABONL2UXXX,,,,, 01600016,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,R. Nadal,,NL12ABNA0392433729,ABNANL2AXXX,,,,, 01600017,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,A. Murray,,NL65INGB0499201493,INGBNL2AXXX,,,,, 01600018,,,N,CORE,OOFF,NL58ZZZ268538010001,Het Bruine Monster,NL24RABO0123456789,,N. Djokovic,,NL06ABNA0100915469,ABNANL2AXXX,,,,,
DEFINITIEVE versie | Versie 1.7 | 25 juli 2014 | Page 8 of 8
