PrestaShop CSV import van producten: veelvoorkomende fouten en wanneer je een andere route kiest

Wanneer gebruik je CSV en wanneer een gesprek?

Dat hangt af van het aantal producten en hoeveel werk elk product nodig heeft. Een bestand wint op schaal. Een gesprek wint waar de lijst van de leverancier onvolledig is en elk product moet worden aangevuld: beschrijving, categorie, prijs met een opslag.

Stuurt een groothandel je elke week een bestand met tweeduizend artikelen, blijf dan bij import of een integratiemodule. Een gesprek met de chat vervangt geen doorlopende synchronisatie met een groothandel.

Waarom mislukt een CSV import?

Omdat het bestandsformaat tot op het teken moet overeenkomen met wat PrestaShop verwacht. De meest voorkomende symptomen en hun oorzaken:

• Onleesbare tekens in plaats van letters met accenten. Het bestand is niet in UTF-8 opgeslagen.
• Alles in één kolom. Het scheidingsteken in het bestand verschilt van dat in de importinstellingen, bijvoorbeeld een komma in plaats van een puntkomma.
• Geen afbeeldingen na de import. De server van de webshop kan de bestanden niet downloaden vanaf de opgegeven adressen, of de tijd raakt op.
• Overschreven producten. De import koppelt rijen op ID of op referentie en raakt een ander product dan bedoeld. Een issue van PrestaShop op GitHub beschrijft zo’n geval.
• Fouten bij combinaties. Combinaties hebben een apart bestand nodig, en zelfs het voorbeeldbestand is al eens op fouten uitgelopen, zoals een ander issue laat zien.

De PrestaShop-documentatie over importeren beschrijft het kolomformaat en de stappen. HelpGuru bespreekt typische problemen, waaronder time-outs van de server.

Zo importeer je een CSV-bestand veilig

Eerst een kleine test, dan de rest.

1. Maak een databaseback-up. Een import wijzigt veel producten tegelijk en heeft geen knop om ongedaan te maken.
2. Sla het bestand op als CSV UTF-8 en controleer het scheidingsteken in de importinstellingen.
3. Importeer vijf rijen. Ga in de backoffice naar Geavanceerde parameters > Importeren, kies het type Producten en upload het testbestand.
4. Controleer die vijf producten in de webshop. Naam, prijs exclusief en inclusief btw, categorie, afbeeldingen.
5. Importeer de rest. Splits een groot bestand in delen, zodat je de tijdslimiet van de server niet overschrijdt.
6. Bouw de filterindex opnieuw op als de webshop filters gebruikt. De import doet dat meestal niet. Meer in het bericht over waarom PrestaShop-filters niet werken.
7. Maak een lijst van de gaten. Producten zonder afbeeldingen, EAN of beschrijving na een import komen pas boven op een lijst met gaten.

Wat je doet als de import geen afbeeldingen uploadt

Controleer één afbeeldingsadres uit het bestand voordat je in PrestaShop naar een fout gaat zoeken. Open het in een privévenster van de browser. Zie je in plaats van de afbeelding zelf een voorbeeldpagina, een inlogverzoek of een fout, dan downloadt de server van de webshop hem ook niet.

Er zijn vier typische oorzaken:

• het adres leidt naar een pagina van een cloudgalerij, niet naar een JPG- of PNG-bestand,
• de server van de leverancier laat alleen ingelogde klanten afbeeldingen downloaden,
• het adres begint met http en de server van de leverancier verwijst het op een ongebruikelijke manier door,
• er zijn zoveel afbeeldingen dat de import stopt bij de tijdslimiet van de server.

Het laatste geval los je op door het bestand in kleinere delen te splitsen of met een hogere tijdslimiet van je host. De ontwikkelaarsdocumentatie beschrijft de servereisen van PrestaShop. Zijn de afbeeldingen belangrijker dan de rest van de gegevens, importeer de producten dan zonder en voeg de afbeeldingen in een tweede stap toe.

Zo voeg je producten uit een lijst van de leverancier toe in een gesprek

Je plakt de lijst, beschrijft de regels, en je chat (Claude of ChatGPT) voegt de producten een voor een toe als uitgeschakelde concepten. Eerst toont hij het plan en een voorbeeld van elk product.