MRI IN CSV FORMAAT

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

Download Report