Je CSV-bestand opmaken voor een import

Dit artikel legt uit hoe je de waarden schrijft in een CSV-bestand dat je importeert via Data → Importeren: waar of onwaar, getallen, bedragen, datums, selectie opties en de standaardvelden van een contact. De regels voor het bestand gelden voor elk type import. De regels per data type gelden overal waar je een kolom aan een attribuut koppelt, en dat doe je bij het importeren van contacten en vouchers.

Een waarde die niet past bij wat een kolom verwacht, wordt niet altijd met een foutmelding geweigerd. Soms wordt hij als iets anders opgeslagen, vaak leeg of 0. Controleer je bestand daarom aan de hand van de regels hieronder voordat je importeert.

Voor de stappen van een contactimport, zie Hoe een lijst met contacten te importeren.

Het bestand zelf

Een kopregel is verplicht. Elke kolom heeft een naam nodig in de eerste regel. Ontbreekt er een, dan stopt het uploaden en word je gevraagd die toe te voegen.
Kolomnamen moeten uniek zijn. Komt een naam twee keer voor, dan nummert Leat de dubbele, zodat je ze bij het koppelen uit elkaar kunt houden.
Maximaal 100.000 regels per bestand. Splits een groter bestand en importeer de delen na elkaar.
Komma, puntkomma, tab of verticale streep als scheidingsteken. Leat herkent zelf welk teken je bestand gebruikt.
Sla het bestand op als UTF-8, zodat letters met accenten goed doorkomen.
Lege regels worden overgeslagen.

Een eenvoudig contactbestand ziet er zo uit:

email,firstname,lastname,newsletter_opt_in
anna@example.com,Anna,de Vries,true
ben@example.com,Ben,Janssen,false

Automatisch gegevenstypen instellen of Stel alle gegevenstypen in op tekst

Bij de stap Bestand upload kies je hoe je bestand wordt gelezen.

Automatisch gegevenstypen instellen (aanbevolen) maakt van alles wat op een getal lijkt een getal. Daardoor vallen voorloopnullen weg: het telefoonnummer 0612345678 wordt 612345678, en een postcode, lidnummer of code 00123 wordt 123.
Stel alle gegevenstypen in op tekst houdt elke waarde precies zoals hij geschreven is.

Staan er in een kolom waarden die met een nul beginnen, kies dan Stel alle gegevenstypen in op tekst. Getallen, datums en waar of onwaar worden dan nog steeds goed gelezen, omdat Leat elke waarde leest volgens de kolom waaraan je hem koppelt.

Datums en datumnotatie

De stap Controleer je gegevens heeft de instelling Datumnotatie:

Dag / Maand / Jaar, bijvoorbeeld 31-05-2025
Jaar / Maand / Dag, bijvoorbeeld 2025-05-31

Gebruik -, / of . tussen de delen van de datum. Een datum die niet past bij de notatie die je kiest, kan niet worden gelezen. Leat gaat niet gokken.

Welke datums de notatie volgen:

Activatie datum en Vervaldatum als je nieuwe vouchers importeert. Schrijf alleen de datum. Een cel met een tijd erin kan niet worden gelezen, en een datum die niet gelezen kan worden valt weg, dus de voucher wordt zonder die datum aangemaakt.
Vervaldatum als je bestaande vouchers bijwerkt, en als je cadeaukaarten importeert of bijwerkt. Een tijd is hier optioneel: 31-12-2025 18:00. Zonder tijd is het 23:59 op die dag.
Begint om, Eindigt om en Ingecheckt op als je boekingen importeert. Voeg de tijd toe: 31-05-2025 19:30.
Attributen van het type Datum Tijd bij het importeren van contacten en vouchers. Zie Datum Tijd hieronder.

Tijden schrijf je in 24-uursnotatie, en ze gelden in de tijdzone van je account.

Attributen van het type Datum en Geboortedatum volgen de Datumnotatie niet. Zie de secties hieronder.

Bedragen en getallen bij andere imports

Bedrag in centen (prepaid transacties en cadeaukaarttransacties) is een heel aantal centen. Voor € 25 schrijf je 2500. Een waarde met een komma, een punt, een valutateken of tekst erin, zoals 25,00 of €25, laat de regel mislukken.
Punten (punten met een vast aantal) is een aantal punten: 700. Een komma of punt wordt gelezen als decimaalteken en de decimalen vallen weg, dus 389,5 geeft 389 punten. Laat scheidingstekens voor duizendtallen weg.
Basisbedrag (punten op basis van een bedrag) is een bedrag met een komma of punt voor de decimalen: 12,50 en 12.50 worden allebei gelezen als 12,50. Laat scheidingstekens voor duizendtallen en valutatekens weg.

Een waarde bij Punten of Basisbedrag die geen getal is, laat de regel mislukken.

Waarden per data type

Deze regels gelden voor elke kolom die je koppelt aan een aangepast attribuut, bij het importeren van contacten en vouchers, en voor de standaardvelden van een contact.

(Boolean) Waar of onwaar

true en 1 worden geïmporteerd als waar.
false en 0 worden geïmporteerd als onwaar.
Hoofdletters maken niet uit: True, TRUE en FALSE werken ook.

email,newsletter_opt_in
anna@example.com,true
ben@example.com,false

Elke andere waarde, zoals ja, nee, yes of x, wordt niet gelezen als waar of onwaar. Hij telt als een lege cel, dus bij een contactimport bepaalt de schrijfmodus wat er gebeurt (zie "Lege cellen en de schrijfmodus" hieronder). Gebruikt je bestand ja en nee, vervang ze dan door true en false voordat je importeert.

Nummer en Decimaal getal

Schrijf alleen het getal: 12, -3, 12.5.
Gebruik een komma of een punt voor decimalen: 12,5 en 12.5 worden allebei gelezen als 12,5.
Laat scheidingstekens voor duizendtallen weg. 1.234 wordt gelezen als 1,234 en niet als 1234. 1.234,56 en 1,234.56 worden allebei gelezen als 1234,56.
Laat valutatekens en eenheden weg. Een waarde die niet met een getal begint, zoals € 12 of abc, wordt geïmporteerd als 0.
Gebruik hele getallen voor een attribuut van het type Nummer. Gebruik Decimaal getal voor waarden met decimalen.

Geboortedatum

Schrijf de dag of het jaar eerst: 31-05-1999, 31/05/1999, 31.05.1999 of 1999-05-31.
Datums met de maand eerst worden niet ondersteund. 12/25/1990 kan niet worden gelezen, en 03/04/2025 wordt gelezen als 3 april en niet als 4 maart.
De datum moet tussen 1 januari 1900 en vandaag liggen. Een geboortedatum daarbuiten wordt als leeg geïmporteerd.
De Datumnotatie geldt niet voor geboortedatums.

Datum

Hetzelfde als een geboortedatum, zonder de beperking in tijd: de dag of het jaar eerst, met -, / of . tussen de delen. 31-05-2025 en 2025-05-31 werken allebei. Datums met de maand eerst worden niet ondersteund, en de Datumnotatie geldt niet.

Datum Tijd

Een waarde van het type Datum Tijd wordt gelezen in de volgorde die je kiest bij Datumnotatie, bijvoorbeeld 31-05-2025 14:30 of 2025-05-31 14:30.

Schrijf de tijd in 24-uursnotatie, met of zonder seconden: 14:30 of 14:30:00. AM en PM worden niet ondersteund.
Een datum zonder tijd wordt opgeslagen als 23:59 op die dag.
De tijd wordt gelezen in de tijdzone van je account. Een waarde met een tijdzone aan het eind, zoals 2025-05-31T14:30:00Z of +02:00, kan niet worden gelezen.

Selecteren

Gebruik de interne waarde van de optie, niet het label. Die vind je onder Selectie opties op de pagina van het attribuut. Klik daarvoor rechtsboven in het dashboard op het tandwiel om Instellingen te openen, klik daarna onder Beheer op Kenmerken en open het attribuut.

De waarde moet precies overeenkomen, ook in hoofdletters. Een waarde die bij geen enkele optie past, wordt als leeg geïmporteerd.

Meerkeuze selectie

Gebruik de interne waarden van de opties en scheid ze met een puntkomma: wijn;bier;koffie. Waarden die bij geen optie passen, vallen weg, en de rest wordt geïmporteerd.

Gebruikt je bestand de puntkomma als scheidingsteken, zet de cel dan tussen dubbele aanhalingstekens: "wijn;bier".

Bij een contactimport bepaalt de schrijfmodus wat er gebeurt met de opties die het contact al heeft:

Overslaan indien leeg en Altijd overschrijven vervangen de opties van het contact door die in je bestand.
Toevoegen voegt de opties in je bestand toe aan die van het contact. Deze modus is er alleen voor attributen van het type Meerkeuze selectie.

Tekst, Lange tekst, E-mail, URL, Kleur en Identificatiecode

Worden geïmporteerd zoals ze geschreven zijn. Spaties aan het begin en eind worden verwijderd. Met Automatisch gegevenstypen instellen (aanbevolen) verliest een waarde die alleen uit cijfers bestaat zijn voorloopnullen, dus kies Stel alle gegevenstypen in op tekst voor codes zoals 00123.

Nummerplaat / Kenteken

Alles behalve letters en cijfers wordt verwijderd: AB-12-CD wordt opgeslagen als AB12CD.

Bestands- en media-uploads

Deze attributen kun je niet vullen vanuit een CSV-bestand, en ze worden niet aangeboden als je je kolommen koppelt.

Standaardvelden van een contact

E-mail is verplicht. Daaraan herkent Leat een contact: een regel met een e-mailadres dat al in je account staat, werkt dat contact bij, en elke andere regel maakt een nieuw contact aan. Een regel met een leeg of ongeldig e-mailadres mislukt.
Voornaam, Achternaam en Adres zijn tekst.
Telefoon werkt het best in internationaal formaat met een + ervoor, bijvoorbeeld +31612345678. Een nummer zonder landcode wordt gelezen als een nummer uit het land van je account. Een nummer dat een ander contact al heeft, of dat geen geldig telefoonnummer is, wordt niet ingesteld als telefoonnummer van het contact.
Geboortedatum volgt de regels voor Geboortedatum hierboven.
Voorkeurstaal is een taalcode van 2 letters: en (Engels), nl (Nederlands), fr (Frans), de (Duits), it (Italiaans), pl (Pools), pt (Portugees), es (Spaans) of sv (Zweeds). Gebruik de code in kleine letters, niet de naam van de taal. Elke andere waarde laat de taal van het contact ongewijzigd.
Contacttype wordt gekoppeld aan een van je contacttypes. Kies na het toewijzen van de kolom onder Relatie of die de ID of de Naam van het type bevat. Namen worden herkend ongeacht hoofdletters. Een waarde die bij geen enkel contacttype past, laat de regel mislukken, en een lege cel laat het type van het contact ongewijzigd.

Lege cellen en de schrijfmodus

Bij een contactimport bepaalt de Schrijfmodus die je kiest bij het toewijzen van een kolom wat een lege cel doet bij een contact dat al een waarde heeft:

Overslaan indien leeg (standaard): het contact houdt zijn huidige waarde.
Altijd overschrijven: de huidige waarde wordt verwijderd.

Bij een nieuw contact blijft het attribuut bij een lege cel gewoon leeg.

Als waarden niet goed doorkomen

Een attribuut van het type waar of onwaar bleef leeg of veranderde niet. Je bestand gebruikt een andere waarde dan true, false, 1 of 0, zoals ja. Vervang die en importeer opnieuw.
Een waarde bij een selectie, meerkeuze selectie, datum of geboortedatum is verdwenen. Een waarde die Leat in zo'n kolom niet kan lezen, wordt als leeg opgeslagen. Bij een contactimport verwijdert dat de waarde die het contact had, ook met Overslaan indien leeg. Controleer of je de interne waarde van de optie hebt gebruikt, of een datum met de dag of het jaar eerst.
Vouchers hebben geen activatie- of vervaldatum. De datum paste niet bij je Datumnotatie, of er stond een tijd in.
Voorloopnullen ontbreken. Importeer opnieuw met Stel alle gegevenstypen in op tekst.
Een attribuut van het type getal is 0. Er stond een valutateken, een eenheid of tekst voor het getal.
Sommige regels zijn mislukt. Open de import via Data → Importeren om te zien welke regels mislukten en waarom. Veelvoorkomende oorzaken zijn een ongeldig e-mailadres, een contacttype dat niet bestaat, een Bedrag in centen dat geen heel getal is en een vouchercode die een andere voucher al gebruikt. Een verwijderde voucher telt niet mee: zijn code is weer vrij.