Deze handleiding legt de stap Importstrategie uit in de Simple CSV Shopify app.
Wanneer je een CSV-, XLS-, XLSX- of XML-bestand uploadt, vraagt Simple CSV hoe je je producten wilt importeren. Deze stap bepaalt of je nieuwe producten toevoegt of bestaande producten bijwerkt, en hoe rijen in je bestand moeten worden behandeld. Excel-imports lezen alleen het eerste werkblad.
Als je bestand overeenkomt met een bekend formaat, selecteert Simple CSV meestal automatisch de juiste opties. Als je bestand is gematcht met Generic fields, moet je de instellingen misschien zelf controleren en aanpassen.
Installeer de Simple CSV Shopify app
Wat de stap Importstrategie doet
Deze stap bepaalt hoe nieuwe en bestaande producten worden behandeld. De stap bepaalt ook hoe variantrijen worden gegroepeerd:
- Nieuwe producten toevoegen of producten bijwerken die al in Shopify staan
- Of elke rij in je bron een apart product is, of een deel van een product met varianten dat meerdere rijen gebruikt
- Hoe Simple CSV rijen moet herkennen of groeperen wanneer dat nodig is
De juiste instellingen hier helpen voorkomen dat rijen worden overgeslagen, producten verkeerd worden gegroepeerd of het verkeerde product wordt bijgewerkt.
Gebruik een kopregel voor mappings die kolomwijzigingen overleven
Wanneer de eerste rij kopteksten bevat, slaat Simple CSV elk gemapt veld op onder de kolomnaam. Als een leverancier later kolommen toevoegt, verwijdert of in een andere volgorde zet, vindt een Pro- of Scale-automatisering de gemapte gegevens nog steeds via de koptekst.
Het matchen van kopteksten is hoofdlettergevoelig en negeert spaties aan het begin of einde. Als twee kolommen dezelfde koptekst hebben, nummert Simple CSV ze op volgorde. Twee kolommen met de naam Price worden Price en Price#2.
Sommige mappings gebruiken nog steeds kolomposities:
- Een bestand met de instelling First row is not a header
- Een kolom met een lege koptekst
- Een kolom waarvan de koptekst
|of*bevat
Het veranderen van de kolomvolgorde kan deze positiemappings breken. Gebruik een unieke, niet-lege koptekst voor elke gemapte kolom wanneer je zelf controle hebt over het bestand.
Als een gemapte koptekst ontbreekt, stopt Simple CSV dat product en schrijft een fout in het log, in plaats van onvolledige gegevens naar Shopify te sturen.
Bestaande geplande feeds gaan voorzichtig over op mappings op basis van kopteksten. De eerste geplande run legt de huidige kolommen vast zonder de mapping te veranderen. De volgende run werkt alleen velden bij waarvan de kolommen op hun plek zijn gebleven. Het importlog toont Upgraded legacy positional mapping to column name for field: … voor een bijgewerkt veld. Als gemapte kolommen tussen die runs zijn verplaatst, blijft de mapping op positie werken en toont het log Legacy positional mapping was not upgraded because mapped column positions changed. Controleer dan de mapping van die automatisering vóór de volgende run.
Eenmalige imports hebben deze upgrade niet nodig, omdat ze in één keer worden gemapt en uitgevoerd.
Voor CSV-bestanden is de koptekst de eerste regel die gegevens bevat. Simple CSV slaat lege regels daarboven over, in plaats van de echte koptekst als product te importeren.
Kies tussen nieuwe producten toevoegen en bestaande producten bijwerken
De eerste keuze is of je nieuwe producten wilt maken of producten wilt wijzigen die al in je Shopify-winkel staan.
Nieuwe producten toevoegen
Kies deze optie wanneer je bestand producten bevat die je in Shopify wilt maken.
Dit is de juiste keuze als:
- Je deze producten voor het eerst importeert
- Je geen producten wilt bijwerken die al bestaan
Wanneer je deze optie kiest, behandelt Simple CSV het bestand als een import van nieuwe producten.
Kies de status voor alle nieuwe producten
De previewpagina heeft een Status-rij die laat zien welke status Simple CSV gaat schrijven. Wil je dat elk nieuw product dezelfde status krijgt, open dan Override status for all new products en kies:
- Active
- Draft
- Unlisted
Unlisted producten zijn bereikbaar en te kopen via een directe link, maar ze blijven buiten Shopify-zoeken, collecties en aanbevelingen.
De override vervangt een gemapte Status-kolom en de standaardstatus. Kies Use mapped status (default: Active) om de override te wissen en terug te gaan naar de gemapte of standaardwaarde. Archived is geen optie voor de override.
Wanneer een override actief is, verandert de Status-rij direct. De rij toont ook Overridden for all new products. Mapped value: X, zodat je de override kunt vergelijken met de waarde uit je bestand voordat je opslaat.
Deze instelling geldt alleen voor nieuw gemaakte producten. Ze verandert nooit een bestaand product tijdens een update-import. De override is beschikbaar op elk plan. Wanneer een import wordt opgeslagen als Pro- of Scale-automatisering, wordt de opgeslagen statuskeuze gebruikt elke keer dat het geplande bestand wordt verwerkt.
Producten wijzigen die je al hebt
Kies deze optie wanneer je bestand bedoeld is om producten bij te werken die al in Shopify staan.
Dit is de juiste keuze als je velden zoals titel, prijs, voorraad of beschrijving wilt bijwerken voor producten die al in je winkel staan. Een gemapte barcodekolom werkt de eerste barcode van elke variant bij en laat andere barcodes staan. Wil je barcodes niet aanraken, verwijder dan de barcodekolom of map deze niet.
Om dit te doen heeft Simple CSV een manier nodig om elke rij in je bestand te koppelen aan een bestaand Shopify-product of een bestaande variant.
Belangrijk om te weten:
- Als er geen passend product of passende variant wordt gevonden, wordt de rij overgeslagen
- Als een exacte SKU of eerste barcode bij meer dan één product past, wordt de rij overgeslagen in plaats van aan één van die producten toegewezen
- Er wordt geen nieuw product gemaakt wanneer er geen match is
Het importlog vermeldt de identifier en het aantal passende producten wanneer een dubbelzinnige rij wordt overgeslagen. Zo is het resultaat voorspelbaar en wordt niet het verkeerde product bijgewerkt.
Kies hoe producten in je bestand zijn opgebouwd
De volgende keuze gaat over hoe je producten in het bestand staan.
Elke rij is een apart product
Kies dit wanneer elke rij in je bestand één compleet product is.
Dit is meestal juist wanneer:
- Je producten geen varianten hebben
- Elke rij op zichzelf staat
- Geen enkel product op meerdere rijen staat
Sommige producten gebruiken meerdere rijen (varianten)
Kies dit wanneer hetzelfde product op meerdere rijen staat, meestal omdat het varianten heeft zoals maat of kleur.
Bijvoorbeeld: één T-shirt kan op meerdere rijen staan:
- Eén rij voor maat S
- Eén rij voor maat M
- Eén rij voor maat L
In dit geval moet Simple CSV weten welke rijen bij hetzelfde product horen.
Hoe Simple CSV rijen combineert voor producten met varianten
Als je Some products use multiple rows (variants) kiest, moet je ook de kolom kiezen die de gedeelde waarde bevat.
Dit is de waarde die hetzelfde is op alle rijen van hetzelfde product.
Veelvoorkomende voorbeelden zijn:
- Handle
- Een productgroep-ID
- Een andere kolom die hetzelfde blijft voor elke variant van één product
Simple CSV groepeert rijen alleen met de kolom die je hier selecteert.
De app leidt variantgroepen niet automatisch af uit meerdere kolommen tegelijk.
Daarom is de groepeerkolom erg belangrijk.
Als de groepeerkolom correct is, worden alle passende rijen gecombineerd tot één product met varianten.
Als de groepeerkolom verkeerd of inconsistent is:
- Kunnen rijen die apart moeten blijven worden samengevoegd tot één product
- Kunnen rijen die bij elkaar horen worden gesplitst in aparte producten
- Kunnen lege waarden ervoor zorgen dat rijen als aparte items worden behandeld
Voor de meeste CSV-bestanden in Shopify-stijl is Handle meestal de juiste keuze.
Hoe Simple CSV bestaande producten matcht bij het bijwerken
Als je Change products you already have kiest, moet je Simple CSV ook vertellen hoe de app het juiste product of de juiste variant in Shopify vindt.
De meest gebruikte matchopties zijn:
- SKU
- Barcode / EAN / GTIN / ISBN
- Product handle
- Shopify Product GID
- Shopify Variant GID
Simple CSV vergelijkt SKU, handle en de eerste barcode exact, maar negeert daarbij hoofdletters en spaties aan het begin en einde. Dat betekent dat blue-shirt, Blue-Shirt en Blue-Shirt bij hetzelfde product passen. Een waarde zoals SF-2000-SET past niet bij SF-2000-SET-CP.
Shopify-varianten kunnen meerdere barcodes hebben, maar Simple CSV controleert alleen de eerste. Een tweede barcode in het bestand matcht niet. De rij wordt overgeslagen als niet gevonden, waardoor een product kan lijken te ontbreken in een update of in een geplande Pro- of Scale-feed. Gebruik waar mogelijk SKU of een Shopify GID.
Als de exacte SKU of eerste barcode op meer dan één product voorkomt, gaat Simple CSV niet gokken. De app slaat de rij over en noteert het aantal duplicaten in het importlog. Matchen op Shopify Product GID of Shopify Variant GID blijft ongewijzigd.
Duplicaten binnen het updatebestand volgen een andere regel. Als het bestand een SKU of eerste barcode herhaalt, verwerkt Simple CSV elke rij in de volgorde van het bestand. De laatste succesvolle rij voor die identifier bepaalt de eindwaarde. Als een update handle als matchsleutel gebruikt, wordt alleen de eerste rij voor die handle verwerkt. Latere rijen met dezelfde handle hebben geen effect, tellen niet mee bij de overgeslagen rijen en geven geen waarschuwing in het importlog.
Deze handle-regel geldt alleen voor het matchen bij updates. De regel heeft geen invloed op imports van nieuwe producten die meerdere variantrijen groeperen onder een gedeelde handle.
Dit werkt hetzelfde voor CSV-, XLS-, XLSX- en XML-uploads, URL-imports en gepubliceerde Google Sheets. Controleer het bestand zelf op herhaalde identifiers wanneer een update succes meldt maar een latere rij geen effect had.
Beste opties voor de meeste winkels
Voor de meeste merchants zijn de beste keuzes:
- SKU als elk product of elke variant een unieke SKU heeft
- Barcode / EAN / GTIN / ISBN als elke variant één betrouwbare barcode heeft
- Product handle voor updates op productniveau wanneer je handles correct en uniek zijn
Belangrijke beperking bij matchen op handle
Als je matcht op Product handle, werkt Simple CSV alleen gegevens op productniveau bij.
Gegevens op variantniveau worden in dat geval niet bijgewerkt.
Hetzelfde geldt voor Shopify Product GID. Dit zijn identifiers op productniveau.
Heb je exacte updates op variantniveau nodig, gebruik dan:
- SKU
- Barcode
- Shopify Variant GID
Geavanceerde matchopties
Shopify Product GID en Shopify Variant GID zijn vooral bedoeld voor gevorderde gebruikers, app-exports of bestanden die via een API zijn gemaakt.
Ze zijn handig wanneer je bestand al Shopify-ID’s bevat en je heel exact wilt matchen.
Voor normale handmatige spreadsheets is SKU meestal de beste keuze. Een eerste barcode werkt ook wanneer elke variant maar één barcode heeft. Een handle werkt voor updates op productniveau.
Controleer de recordselectie voor een XML-bestand
XML-bestanden gebruiken dezelfde veldmappingstap als CSV- en Excel-bestanden. Het mappingscherm toont een sectie XML records met het geselecteerde deel van de feed en het aantal gevonden records.
Als de sectie meer dan één optie biedt, kies dan in de dropdown Record element het deel dat de producten bevat die je wilt importeren, en selecteer daarna Use this record element. Het wijzigen hiervan ververst de preview en wist de huidige mapping. Je hoeft het bestand niet opnieuw te uploaden.
XML-bestanden met een DOCTYPE-declaratie worden geweigerd. Eén record mag niet groter zijn dan 10 MB. Een bestand zonder herhalend element met velden mislukt met No repeating XML record element containing fields could be detected. Bij ongeldige XML zie je de parserfout die voor het bestand is teruggegeven.
Wanneer je meestal niets hoeft te veranderen
Als Simple CSV je bestandsformaat herkent, zijn de juiste instellingen vaak al voor je geselecteerd.
Bijvoorbeeld: als je een CSV in Shopify-formaat of een ander bekend formaat uploadt, kiest de app mogelijk al de juiste structuur- en groepeeropties.
In dat geval hoef je meestal niets te veranderen, tenzij de detectie er verkeerd uitziet.
Als het bericht zegt dat je bestand is gematcht met Generic fields, bekijk dan elke optie zorgvuldiger voordat je verdergaat.
Best practices voor deze stap
- Kies Add new products wanneer je producten voor het eerst importeert
- Kies Change products you already have alleen wanneer je bestand een betrouwbare identifier voor het matchen bevat
- Gebruik Each row is a separate product wanneer producten niet over meerdere rijen zijn verdeeld
- Gebruik Some products use multiple rows alleen wanneer varianten over meerdere rijen zijn verdeeld
- Gebruik een groepeerkolom die exact hetzelfde blijft voor alle rijen van hetzelfde product
- Kies bij voorkeur SKU of Shopify Variant GID voor updates op variantniveau
- Controleer het importlog op identifiers die bij meer dan één product passen
- Gebruik een unieke, niet-lege koptekst voor elke gemapte kolom in een opgeslagen feed
Veelgemaakte fouten om te vermijden
- De updatemodus kiezen terwijl je bestand eigenlijk bedoeld is om nieuwe producten te maken
- Eén SKU of eerste barcode hergebruiken voor meerdere producten, waardoor dubbelzinnige rijen worden overgeslagen
- Handle gebruiken terwijl je updates op variantniveau verwacht
- De verkeerde groepeerkolom kiezen voor producten met meerdere rijen
- Kolommen verplaatsen in een bestand zonder kopregel, dat nog steeds kolomposities gebruikt
- Automatisch gedetecteerde instellingen veranderen terwijl het bestand correct werd herkend
Wat kies je als je het niet zeker weet
Twijfel je, begin dan met deze simpele regels:
- Als de producten nog niet in Shopify bestaan, kies Add new products
- Als elke rij één product is, kies Each row is a separate product
- Als één product op meerdere rijen staat vanwege varianten, kies Some products use multiple rows en selecteer de herhaalde gedeelde kolom, meestal Handle
- Wil je bestaande producten bijwerken, gebruik dan de meest betrouwbare unieke identifier in je bestand, meestal SKU
Als je bestand automatisch is gematcht met Shopify-velden, is het meestal het veiligst om de gedetecteerde instellingen zo te laten.
Kies je een importstrategie voor een terugkerende leveranciersfeed, lees dan onze handleiding voor het synchroniseren van leveranciersfeeds in Shopify. Geplande URL-imports zijn beschikbaar op Pro en Scale.