Richtlijnen voor het opmaken van CSV-bestanden
Om CSV-bestanden in uw winkel te importeren, moet u ervoor zorgen dat ze voldoen aan bepaalde opmaakvereisten zoals beschreven in dit artikel.
Algemene regels
Dit zijn enkele algemene richtlijnen voor het samenstellen van een CSV-bestand:
- Elk bestand moet een kopregel met kolomnamen hebben. Zie de Lijst van ondersteunde kolommen →
- De volgorde van de kolommen doet er niet toe zolang u de juiste kolomnamen gebruikt.
- Voeg alle kolommen toe die nodig zijn om uw gegevens te importeren en laat de overige kolommen gerust weg.
Bij het bijwerken van bestaande producten kunt u bijvoorbeeld alleen de kolommen waarin u wijzigingen aanbrengt plus de kolommen met ID's houden. - Let op verplichte kolommen. Deze zijn afhankelijk van het type artikel en van het doel van uw import (nieuwe artikelen maken of bestaande bijwerken). Zie het referentiedocument voor CSV-bestandskolommen voor meer informatie.
- Sla de CSV-bestanden op in UTF-8 (dit is de aanbevolen codering).
Kopregel
Het belangrijkste deel van uw CSV-bestand is de kopregel. Het is de eerste rij die alle kolomnamen bevat. Deze kolomnamen geven aan welk soort gegevens in een bepaalde kolom staan.
U kunt een bestand niet importeren als er geen kopregel is.
Gegevenstypen
Elke rij in het bestand - behalve de kopregel - is gewijd aan een specifieke reeks gegevens. Om aan te geven waar de informatie in de rij over gaat, gebruikt u de kolom “type”:
Op basis van het type kunnen rijen gegevens bevatten over:
- een product (type = ”product”)
- een productoptie of -invoerveld (type = ”product_option”)
- een productvariatie (type = ”product_variation”)
- een productbestand (type = ”product_file”)
- een winkelcategorie (type = "categorie")
- een Instant Site-omleiding (type ="site_redirect")
Kolommen
Alle kolommen in uw importbestand, behalve de kolom "type", zijn gewijd aan specifieke informatie zoals productnaam, artikelnummer, prijs, enz:
De informatie kan verwijzen naar een product, productoptie (of invoerveld), productvariatie, productbestand, winkelcategorie of Instant Site-omleiding, afhankelijk van op een bepaalde rij.
Zie de volledige Lijst van ondersteunde kolommen. Je kunt de kolommen in elke gewenste volgorde plaatsen, maar zorg ervoor dat u de kolomnamen exact opgeeft zoals aangegeven in het referentiedocument.
ID's
Om de gegevens uit een bepaalde rij te koppelen aan specifieke producten of categorieën gebruikt u ID's. Bijvoorbeeld wanneer u moet aangeven bij welk product de optie hoort:
- Wanneer u bestaande producten bijwerkt, geeft u een product-ID of unieke product-SKU op.
- Wanneer u opties, invoervelden, variaties of bestanden toevoegt, geeft u een uniek artikelnummer of unieke ID op van het product waaraan ze moeten worden toegewezen.
- Wanneer u bestaande winkelcategorieën bijwerkt, geeft u de categorie-ID of het volledige categoriepad op.
- Wanneer u bestaande Instant Site-omleidingen bijwerkt of verwijdert, geeft u de omleiding-ID op.
Zie de Lijst van ondersteunde CSV-kolommen voor de kolomnamen.
Reeks voorbeelden van CSV-bestanden
Bekijk onze reeks met voorbeelden van kant-en-klare CSV-bestanden voor verschillende gebruikstoepassingen:
- Een nieuw product toevoegen →
- Een nieuw product met opties toevoegen →
- Een nieuw product met opties en variaties toevoegen →
- Een nieuw product met bestanden toevoegen →
- Nieuwe winkelcategorieën toevoegen →
- Attributen toevoegen aan bestaande producten →
- Vertalingen toevoegen aan een bestaand product →
- Voorraad bijhouden inschakelen voor een bestaand product →
- Voorraad bijwerken voor een bestaand product →
- Instant Site-omleidingen maken →
U kunt deze bestanden als sjabloon gebruiken en zien hoe rijen en kolommen samenwerken. Vervang de voorbeeldproducten door uw eigen producten of categorieën en voeg meer kolommen voor eigenschappen toe als u die nodig heeft.