Supportartikel

Shopify CSV-importfouten oplossen

Los mislukte Shopify CSV-imports op die worden veroorzaakt door koppen, varianten, afbeeldingen of spreadsheet-opmaak.

Werkt je Shopify CSV-import niet, dan komt dat meestal door een klein probleem in je CSV-bestand.

Deze gids helpt je de meest voorkomende problemen te vinden en op te lossen.

Begin met een eenvoudige controle

Controleer eerst de basis voordat je dieper zoekt:

  • Zijn alle verplichte kolommen aanwezig?
  • Komen de kolomnamen exact overeen met Shopify?
  • Is je bestand opgeslagen als CSV (UTF-8)?

Veel importproblemen ontstaan door kleine opmaakfouten.

Ontbrekende of onjuiste kolommen

Als een verplichte kolom ontbreekt, kan de import mislukken.

Zo los je het op:

  • Gebruik een Shopify-export als sjabloon
  • Zorg dat kolomnamen exact overeenkomen

Varianten worden niet goed geïmporteerd

Als varianten niet goed zijn opgezet, kunnen producten dubbel worden aangemaakt of opties missen.

Zo los je het op:

  • Gebruik dezelfde handle voor alle varianten van één product
  • Zorg dat elke variant een eigen rij heeft

Afbeeldingen worden niet geïmporteerd

Als afbeeldingen ontbreken, zijn de afbeeldings-URL’s mogelijk niet juist.

Zo los je het op:

  • Gebruik een volledige afbeeldings-URL die begint met https:// of //
  • Zorg dat de afbeeldingen openbaar toegankelijk zijn

Simple CSV slaat relatieve afbeeldingspaden zoals /image/catalog/photo.jpg over. Het product wordt alsnog zonder die afbeelding geïmporteerd, en het importlogboek meldt: Skipping image "…" because relative paths are not supported. Use a full URL. Dit betekent dat de afbeelding is overgeslagen omdat relatieve paden niet worden ondersteund. Gebruik een volledige URL.

Barcodes (EAN/ISBN) zijn onjuist

Spreadsheetprogramma’s kunnen lange getallen veranderen in wetenschappelijke notatie.

  • 8712345678901 → 8.71235E+12

Dit maakt de barcode onbruikbaar.

Zo los je het op:

  • Stel de kolom in als Text (tekst)
  • Of zet een apostrof voor het getal

Producten worden dubbel aangemaakt in plaats van bijgewerkt

Dit gebeurt meestal wanneer de handle niet overeenkomt met een bestaand product.

Zo los je het op:

  • Zorg dat de handle exact hetzelfde is
  • Controleer op extra spaties of verschillen in spelling

Wanneer gebruik je een CSV-import-app

Als je steeds tegen problemen aanloopt, kan een CSV-import-app kolomkoppen die niet van Shopify zijn koppelen voordat de import start.

De Simple CSV Shopify-app kan:

  • Je kolommen koppelen aan Shopify-velden
  • Vijf voorbeeldrijen tonen voordat de import start
  • Bestaande producten bijwerken met exacte matches op SKU, eerste barcode, handle of Shopify-ID

Simple CSV vergelijkt SKU, handle en de eerste barcode exact, waarbij hoofdletters en spaties rondom de waarde worden genegeerd. Een match op alleen het begin van een waarde werkt geen product bij. Heeft een Shopify-variant meerdere barcodes, dan controleert Simple CSV alleen de eerste. Een tweede barcode in het bestand geeft geen match, dus de rij wordt overgeslagen als niet gevonden. Komt een exacte SKU of eerste barcode overeen met meerdere producten, dan wordt de rij overgeslagen en meldt het importlogboek hoeveel producten die identifier gebruiken. Gebruik SKU of Shopify-ID als dat kan.

Geplande import voltooid met nul tellers

Een geplande Pro- of Scale-import kan als Completed (voltooid) in de importgeschiedenis staan, maar No changes in the file (geen wijzigingen in het bestand) tonen als je de import opent. Dit betekent dat Simple CSV hetzelfde bestand en dezelfde instellingen vond als bij de laatste volledig geslaagde geplande run. De app heeft het bestand overgeslagen zonder iets in Shopify aan te raken.

Open de automatisering en kies Run now als je hetzelfde bestand opnieuw wilt toepassen. Run now verwerkt het bestand altijd. Dit is handig wanneer Shopify is veranderd sinds de laatste run, bijvoorbeeld doordat verkopen de voorraad hebben verlaagd of iemand een product heeft verwijderd.

Meer hulp

Weet je niet zeker hoe je CSV eruit moet zien, bekijk dan Shopify CSV-indeling uitgelegd.

De gids Producten naar Shopify importeren met CSV behandelt de volledige workflow.

Voor uitgebreide probleemoplossing en de volledige CSV-veldreferentie van Shopify lees je de complete Shopify CSV-importgids.