Overslaan en naar hoofdcontent gaan

CSV import troubleshooting

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.