Producten importeren en bijwerken met een spreadsheet#

Download een categoriesjabloon, vul je producten in en upload het bestand in de Catalogus. Hiervoor hoef je geen code te schrijven of API-toegangsgegevens te gebruiken.

Voordat je begint#

Selecteer de juiste winkel in het dashboard. Je hebt toestemming nodig om de catalogus te bewerken. Als de knop Productspreadsheet uploaden ontbreekt, controleer dan je winkelselectie, je schrijfrechten voor de catalogus en of je account alleen leestoegang heeft.

Het categoriesjabloon downloaden#

1. Open Dashboard → Catalogus.
2. Klik op Productspreadsheet uploaden om het dialoogvenster Producten importeren te openen.
3. Selecteer onder Kies productcategorie de categorie die je wilt importeren. De beschikbare opties hangen af van je winkelconfiguratie.
4. Klik op Excel-sjabloon downloaden. Gebruik voor elke categorie een afzonderlijk sjabloon en een afzonderlijke upload.

Download bij het voorbereiden van een nieuwe import een nieuw sjabloon, zodat de kolommen overeenkomen met de huidige vereisten van de categorie. De gedownloade werkmap is een sjabloon, geen export van je bestaande catalogus.

De werkmap invullen#

Gebruik de werkbladen in de werkmap als volgt:

Elke productrij moet sku, name, image_url en product_url bevatten, plus de verplichte afmetingen voor de categorie. Volg de aanduidingen voor verplichte velden en de instructies in het gedownloade sjabloon. Vertaal veldnamen niet en voeg geen onbekende of dubbele kolommen toe.

• Houd SKU-cellen opgemaakt als tekst, zodat spreadsheetsoftware geen voorloopnullen verwijdert of lange identificaties wijzigt. Gebruik één rij per SKU; dubbele waarden in hetzelfde bestand worden geweigerd, ook als ze alleen in hoofdletters en kleine letters verschillen.
• Gebruik voor image_url een direct, openbaar toegankelijk HTTP- of HTTPS-adres van een afbeelding; het moet werken zonder aanmelding, cookies of aangepaste aanvraagheaders. Zet het adres van de productdetailpagina in product_url.
• Geef afmetingen en eenheden op volgens de instructies van het sjabloon. Als noch bij een afmeting noch in dimension_unit een eenheid is opgegeven, geldt standaard in.
• Kies voor status een toegestane waarde uit Enums. Een leeg veld krijgt standaard active; vul de status bij het bijwerken van producten expliciet in.

Sla op als .xlsx (aanbevolen). .csv wordt ook geaccepteerd als het bestand alleen de productkopregel en de gegevens bevat. Oude .xls-bestanden worden niet ondersteund. Elk bestand mag maximaal 50,000 niet-lege productrijen bevatten en niet groter zijn dan 50 MB.

Uploaden en het resultaat controleren#

1. Ga terug naar het importdialoogvenster en selecteer dezelfde categorie als voor het sjabloon.
2. Kies onder Invullen en uploaden je opgeslagen bestand en klik op Import starten.
3. Controleer onder Recente imports de bestandsnaam, de verwerkingsstatus en het aantal geslaagde en mislukte rijen. Indienen bevestigt de acceptatie; de verwerking gaat op de achtergrond door.
4. Wacht tot de verwerking is voltooid en controleer op mislukte rijen, ook als de taak Voltooid aangeeft. Ga terug naar de Catalogus om de geïmporteerde productgegevens en de gereedheid te controleren.

Als rijen mislukken, klik dan op Foutenbestand, bekijk de foutmeldingen, corrigeer de productgegevens en upload het gecorrigeerde bestand met dezelfde categorie. Een gedownloade foutenwerkmap bevat de mislukte rijen en diagnostische kolommen; deze diagnostische kolommen worden bij opnieuw uploaden genegeerd.

Gebruik bij een tijdelijke verwerkingsfout Opnieuw proberen wanneer die optie beschikbaar is. Dezelfde taak opnieuw proberen corrigeert geen ongeldige productgegevens. Als de interface aangeeft dat ondersteuning bepaalde rijen moet beoordelen, gebruik dan Contact support; deze rijen worden niet automatisch opnieuw geprobeerd.

Bestaande producten bijwerken#

Gebruik voor updates hetzelfde categoriesjabloon en behoud de bestaande SKU van elk product. Vul alle verplichte velden in voor elke rij die je opneemt, wijzig de waarden die je wilt bijwerken en upload het bestand opnieuw.

• Dezelfde SKU in dezelfde winkel werkt het bestaande product bij. Een SKU die nog niet bestaat, maakt een nieuw product aan. Een SKU wijzigen in de spreadsheet hernoemt het oorspronkelijke product niet.
• Je kunt alleen de productrijen uploaden die je wilt bijwerken. Producten die niet in het bestand staan, worden niet verwijderd, uitgeschakeld of uit publicatie gehaald.
• Dit is geen gedeeltelijke veldupdate: verplichte velden moeten nog steeds waarden bevatten. Ga er niet van uit dat een lege optionele cel de vorige waarde behoudt. Een lege status krijgt met name standaard active, en ontbrekende eenheden voor afmetingen krijgen standaard in.
• Bewaar je ingevulde werkmap voor toekomstige updates. Het gedownloade sjabloon bevat je huidige productgegevens niet.

Controleer de betrokken producten in de Catalogus nadat de taak is voltooid. Een geslaagde import bevestigt op zichzelf geen zichtbaarheid in de webshop; controleer de gereedheid van de producten en de publicatiechecklist voor SDK.

Imports automatiseren#

Gebruik de Product Import API voor terugkerende synchronisatie op de server. De aanvraagvelden, limieten en het gedrag bij gedeeltelijke updates worden afzonderlijk van deze spreadsheetwerkwijze beschreven.