CSV import troubleshooting

Gewijzigd op Do, 12 Mrt om 4:13 PM

In dit artikel bespreken we de volgende aspecten:

Veelvoorkomende foutmeldingen bij een CSV-import
Concrete voorbeelden van foutmeldingen
Controlepunten wanneer een import niet lukt
Tips & tricks voor een succesvolle import
Troubleshooting via de browserconsole

Veelvoorkomende foutmeldingen bij een CSV-import

Tijdens het importeren van een CSV bestand kunnen verschillende foutmeldingen optreden. Hieronder vind je een overzicht van veelvoorkomende meldingen en mogelijke oorzaken.

Bestand kan niet worden verwerkt

Dit betekent vaak dat de structuur van het CSV-bestand niet correct is.

Controleer het volgende:

Het bestand is opgeslagen als .csv
De kolommen zijn gescheiden door komma’s of puntkomma’s
De kolomnamen in de eerste rij zijn correct gespeld
Er staan geen lege kolommen of rijen in het bestand

Verplichte kolom ontbreekt

Sommige velden zijn verplicht voor een succesvolle import.

Controleer of:

Alle verplichte kolommen aanwezig zijn in het bestand
De kolomnamen exact overeenkomen met de vereiste structuur
De eerste rij alleen kolomnamen bevat

Onjuiste waarde of formaat

Deze melding verschijnt wanneer waarden niet voldoen aan het verwachte formaat.

Controleer bijvoorbeeld:

E-mailadressen hebben een geldig formaat
Datums staan in het juiste datumformaat
Numerieke velden bevatten alleen cijfers

Concrete voorbeelden van foutmeldingen

Hieronder staan voorbeelden van foutmeldingen die kunnen voorkomen bij een CSV-import.

"Invalid CSV format"

Mogelijke oorzaken:

Het bestand bevat verkeerde scheidingstekens
Het bestand is opgeslagen als Excel-bestand in plaats van CSV
De eerste rij bevat geen correcte kolomnamen

"Missing required field"

Dit betekent dat een verplicht veld ontbreekt in het CSV-bestand.

Controleer:

Of alle verplichte kolommen aanwezig zijn
Of de kolomnamen exact overeenkomen met de vereiste structuur
Of er geen typfouten in de kolomnamen staan

"Invalid value" of "Validation error"

Deze melding verschijnt wanneer een waarde niet voldoet aan de validatieregels.

Voorbeelden:

Een ongeldig e-mailadres
Een datum in een verkeerd formaat
Een veld met tekst waar een numerieke waarde verwacht wordt

"Duplicate entry"

Dit betekent dat een waarde die uniek moet zijn al bestaat.

Bijvoorbeeld:

Een e-mailadres dat al in het systeem aanwezig is
Een gebruikers-ID die al bestaat

Controlepunten wanneer een import niet lukt

Wanneer een CSV-import mislukt zonder duidelijke foutmelding, controleer dan de volgende punten:

Het CSV-bestand bevat geen verborgen tekens
Het bestand is opgeslagen in UTF-8 encoding
De kolomvolgorde komt overeen met de verwachte importstructuur
Er staan geen dubbele waarden in velden die uniek moeten zijn (bijvoorbeeld e-mailadressen)

Het kan ook helpen om:

Het CSV-bestand opnieuw op te slaan
De import te testen met een klein testbestand (bijvoorbeeld 1–2 regels)

Tips & tricks voor een succesvolle CSV-import

Om importproblemen te voorkomen, kun je de volgende best practices gebruiken:

Gebruik bij voorkeur Excel of Google Sheets om het CSV-bestand te maken
Controleer altijd of de kolomnamen exact overeenkomen met de vereiste structuur
Vermijd speciale tekens zoals extra aanhalingstekens of onnodige spaties
Controleer of er geen lege regels onderaan het bestand staan

Het kan ook helpen om een bestaand werkend CSV-bestand als template te gebruiken.

Troubleshooting via de browserconsole

Wanneer een import blijft mislukken zonder duidelijke foutmelding, kun je extra informatie vinden via de browserconsole.

Volg hiervoor deze stappen:

Open de pagina waar je de CSV-import uitvoert
Open de Developer Tools in je browser
- Windows: F12 of Ctrl + Shift + I
- Mac: Cmd + Option + I
Ga naar het tabblad Console
Voer de CSV-import opnieuw uit
Controleer of er foutmeldingen (errors) verschijnen in de console

Let vooral op meldingen zoals:

400 / 422 errors → probleem met de data in het CSV-bestand
Validation errors → een veld voldoet niet aan de vereiste regels
Network errors → probleem met het uploaden van het bestand

Wanneer je contact opneemt met support, helpt het om:

een screenshot van de consolefout mee te sturen
het CSV-bestand dat je gebruikt toe te voegen
te vermelden welke import je probeert uit te voeren

Zo kan sneller worden vastgesteld waar het probleem zich bevindt.