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")
• een klant van de winkel (type ="customer")

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, Instant Site-omleiding of klant van de winkel, afhankelijk van de specifieke 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.
• Vul bij het bijwerken van bestaande klanten hun primaire e-mailadres of de klant-ID in (gebruikt om het primaire e-mailadres bij te werken).

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 →
• Lijst met klanten toevoegen →

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.