Producten importeren via een CSV

Laatst bijgewerkt op 13 juni 2026

Stap 1: Open de importtool

Klik op de pagina Paspoorten op CSV importeren. Dezelfde flow vindt u ook achter de optie Bulkimport bij het aanmaken van een nieuw paspoort. Importeren vereist de rol redacteur of hoger; lezers kunnen geen paspoorten aanmaken.

Stap 2: Kies een productcategorie

De importtool vraagt eerst om de Productcategorie — Textiel / kleding of Algemeen product. Eén import verwerkt één categorie, omdat de categorie bepaalt welke kolommen bestaan. Verkoopt u beide, voer dan twee imports uit.

Stap 3: Begin vanaf een sjabloon

Zodra een categorie is geselecteerd, klapt u "Een CSV-sjabloon nodig? Download er een om te beginnen." open. Er zijn drie downloads beschikbaar:

Het importscherm met Textiel / kleding geselecteerd, het uploadgebied voor de CSV en de uitgeklapte sjabloonhulp met drie downloadknoppen.
Sleep na het kiezen van een categorie uw CSV in het uploadgebied — of download een sjabloon om vanaf te beginnen.
  1. Sjabloon downloaden (Verplichte velden) — alleen de kolommen die nodig zijn voor een volledig paspoort. Verplichte velden zijn gemarkeerd met *.
  2. Sjabloon downloaden (Alle velden) — elke kolom die de categorie ondersteunt.
  3. Voorbeeld downloaden (5 producten) — een ingevuld voorbeeld, zodat u de verwachte formaten kunt zien.

Open de sjabloon in Excel of Google Sheets, vul uw productgegevens in en sla die op als CSV. Een paar velden gebruiken compacte formaten:

  • Materiaalsamenstelling — paren vezel:percentage, gescheiden door puntkomma's, bijvoorbeeld katoen:95;elastaan:5. Een optioneel derde getal is het aandeel gerecycled van die vezel: katoen:95:30 betekent 95% katoen, waarvan 30% gerecycled.
  • Lijstvelden (wassymbolen, conformiteitsnormen en andere kolommen met meerdere waarden) — scheid waarden met puntkomma's.
  • Keuzevelden — gebruik ofwel de opgeslagen waarde, ofwel het Engelse label; beide worden geaccepteerd.

U hoeft de exacte koppen van de sjabloon niet aan te houden, want er is geen handmatige koppelingsstap: de importtool koppelt uw kolomkoppen automatisch aan paspoortvelden, op basis van veldlabel of veldnaam. De koppeling is soepel — hoofdletters, omringende spaties en de afsluitende * van de sjabloon worden genegeerd. Kolommen die niet kunnen worden gekoppeld, worden overgeslagen, en u krijgt een waarschuwing met de naam van elke overgeslagen kolom, zodat hernoemde koppen niet stilletjes mislukken.

Dit betekent dat u ook vanuit uw eigen systemen kunt exporteren: zolang de koppen overeenkomen met de kolomnamen van de sjabloon, wordt het bestand geïmporteerd.

Bestandslimieten

Alleen CSV-bestanden, gecodeerd als UTF-8, tot 10.000 rijen en 50 MB per bestand. Grotere catalogi nemen gewoon meerdere bestanden in beslag.

Stap 4: Beoordeel de validatieresultaten

Na het uploaden wordt elke rij gevalideerd met dezelfde controles die de editor uitvoert. Een rij heeft de velden die in de sjabloon met * zijn gemarkeerd nodig om te importeren (de GTIN is de uitzondering: die is pas later vereist, bij het publiceren). Het scherm Importresultaten splitst uw bestand in tweeën:

  • "N producten klaar" — rijen die de validatie hebben doorstaan.
  • "N met fouten" — rijen die dat niet deden, getoond in een tabel met het rijnummer, het product en wat er mis is (een samenstelling die niet optelt tot 100%, een ongeldig land, een onjuist opgemaakte GTIN, enzovoort; zie Volledigheid en validatie voor de volledige set controles).
Het scherm Importresultaten met 5 producten gereed, 2 met fouten, de specifieke foutmeldingen en de knoppen Foutenrapport downloaden en Importeer 5 geldige paspoorten.
Het scherm Importresultaten scheidt geldige rijen van rijen met fouten en benoemt wat er met elke rij mis is.

Klik op Foutrapport downloaden om de falende rijen te krijgen als CSV met een foutkolom, corrigeer ze in uw spreadsheet en importeer dat bestand opnieuw. De geldige rijen nu importeren en de gecorrigeerde rijen later werkt prima; de twee batches worden gewoon concepten naast elkaar.

Wanneer u klaar bent, klikt u op N geldige paspoorten importeren. Grote bestanden worden automatisch in batches van 500 verzonden, met een voortgangsindicator.

Wat er na de import gebeurt

Elke geïmporteerde rij wordt een concept-paspoort: "Allemaal geïmporteerd als concept. Beoordeel ze in uw paspoortlijst en publiceer wanneer ze klaar zijn." Vanaf daar geldt de normale levenscyclus — concepten zijn privé en onbeperkt, en elk paspoort wordt afzonderlijk gepubliceerd zodra de verplichte velden volledig zijn. Zie Concepten versus gepubliceerde paspoorten voor hoe de twee statussen werken.

Het successcherm herinnert u er ook aan hoe u ervoor staat ten opzichte van uw abonnement: concepten tellen nooit mee voor uw publicatielimiet, dus 1.000 producten importeren op een Free-abonnement is prima; u kunt er tot 5 publiceren totdat u upgradet. Het publiceren zelf, inclusief de limieten per abonnement, wordt behandeld in Een paspoort publiceren.

Geïmporteerde concepten moeten nog steeds worden gecontroleerd

De importvalidatie controleert structuur, geen inhoud — ze kan niet vaststellen of de samenstelling in rij 14 bij het product in rij 14 hoort. Open een steekproef van uw geïmporteerde concepten en bevestig dat de gegevens in de juiste velden zijn beland voordat u op grote schaal begint te publiceren.

Veelgestelde vragen

Worden geïmporteerde producten automatisch gepubliceerd?

Nee. Elke geïmporteerde rij wordt een concept. Concepten zijn onbeperkt en privé — u beoordeelt ze in uw paspoortlijst en publiceert ze stuk voor stuk wanneer ze klaar zijn.

Wat gebeurt er met rijen met fouten?

Die worden tegengehouden. Het resultatenscherm toont wat er mis is in elke rij, en u kunt een CSV met een foutrapport downloaden, de rijen in uw spreadsheet corrigeren en alleen die rijen opnieuw importeren. Geldige rijen worden hoe dan ook gewoon geïmporteerd.

Heb ik een GTIN nodig in mijn CSV?

Niet voor de import zelf: rijen zonder GTIN worden prima als concept geïmporteerd. U hebt wel een GTIN nodig voordat u elk paspoort publiceert, dus een GTIN-kolom vooraf opnemen scheelt u later een stap.