MRI IN CSV FORMAAT. Beschrijving bestandsindeling. Definitieve versie. Equens SE 25 juli Versie 1.7

Transcriptie

1 MRI IN CSV FORMAAT Beschrijving bestandsindeling Definitieve versie Equens SE 25 juli 2014 Classificatie: Versie 1.7 Openbaar

2 Versie geschiedenis Versie no. Versie datum Status Auteur Belangrijkste wijzigingen Draft Equens SE Eerste opzet Finaal Equens SE Definitieve versie Finaal Equens SE Creditor Name is verplicht veld, tekstuele correctie voorbeelden 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 Finaal Equens SE Kleine foutjes in het voorbeeld ( 2.3) verbeterd Finaal Equens SE Enkele integriteitsregels toegevoegd Finaal Equens SE Set van toegestane tekens toegevoegd aan integriteitsregels Finaal Equens SE Typefoutjes + voorbeeld aangepast 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.

3 Inhoud 1 Inleiding 4 2 Mandaat gerelateerde gegevens in CSV formaat Algemeen Indeling van de Mandaatregel Enkele integriteitsregels Voorbeeld 8 DEFINITIEVE versie Versie juli 2014 Page 3 of 8

4 1 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 juli 2014 Page 4 of 8

5 2 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 / Opmaak & Mogelijke waarden Optioneel / Reservering (maximale) lengte 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 = existing 1 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 juli 2014 Page 5 of 8

6 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 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 juli 2014 Page 6 of 8

7 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 Het Debtor Account Number dient numeriek te zijn (mag geen andere tekens dan 0 9 bevatten) Het Debtor Account Number dient uniek te zijn over alle mandaten van de klant Als Mandate Request Type = N of E, dan mag het Mandate ID niet reeds in de mandaten database voorkomen Als Mandate Request Type = A of C, dan moet het Mandate ID in de mandaten database voorkomen In tekstrubrieken (zoals bijvoorbeeld Debtor Name) mogen slechts die tekens worden gebruikt die in SEPA berichten zijn toegestaan. Dat zijn: 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 / -? : ( )., + 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. Gevolg indien de regel wordt overtreden 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) Dit wordt door de CSV inleesfunctie niet gedetecteerd. Daarna kan evenwel op dit dubbel geregistreerde rekeningnummer niet meer worden geïncasseerd! De rij in het CSV bestand wordt geweigerd; het nieuwe mandaat wordt niet geregistreerd in de mandaten database De rij in het CSV bestand wordt geweigerd; er wordt geen mandaat gewijzigd of op vervallen gezet. De CSV inleesfunctie voert hierop geen controle uit. Niet toegestane tekens worden in het SEPA bericht vervangen door vraagtekens. 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 juli 2014 Page 7 of 8

8 2.4 Voorbeeld ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,A. Janssen,, ,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,B. de Vries,,NL51INGB ,INGBNL2AXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,C. van Zeggelen,,NL74ABNA ,ABNANL2AXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,D. Draaijer,,NL29BOFA ,BOFANLNXXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,E. Wit,,NL65INGB ,INGBNL2AXXX,,,,, ,,,N,B2B,RCUR,NL58ZZZ ,Het Bruine Monster,NL73INGB ,,Zwaan B.V.,,NL33INGB ,INGBNL2AXXX,,,,, ,,,N,B2B,RCUR,NL58ZZZ ,Het Bruine Monster,NL73INGB ,,Gemeentepolitie Den Hoorn,,NL39INGB ,INGBNL2AXXX,,,,, ,,,N,B2B,RCUR,NL58ZZZ ,Het Bruine Monster,NL73INGB ,,Dik Hout B.V.,,NL12RABO ,RABONL2UXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,F. Monsingh,,NL95RABO ,RABONL2UXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,G. de Graaff,,NL91RABO ,RABONL2UXXX,,,,, ,,,N,B2B,RCUR,NL58ZZZ ,Het Bruine Monster,NL73INGB ,,De Vliegende Hollander,,NL06ABNA ,ABNANL2AXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,I. Isaac,,NL51INGB ,INGBNL2AXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,R. Federer,,NL65INGB ,INGBNL2AXXX,,,,, ,,,N,B2B,RCUR,NL58ZZZ ,Het Bruine Monster,NL73INGB ,,Boekhandel Grijs,,NL95RABO ,RABONL2UXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,R. Nadal,,NL12ABNA ,ABNANL2AXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,A. Murray,,NL65INGB ,INGBNL2AXXX,,,,, ,,,N,CORE,OOFF,NL58ZZZ ,Het Bruine Monster,NL24RABO ,,N. Djokovic,,NL06ABNA ,ABNANL2AXXX,,,,, DEFINITIEVE versie Versie juli 2014 Page 8 of 8