Variabele WooCommerce-producten in CSV: hoofd- en variatierijen

Hoe WooCommerce variabele producten opbouwt

In WooCommerce is een variabel product een product met koopbare variaties, bijvoorbeeld een T-shirt in de maten S, M en L. In de CSV gebruik je daarvoor twee soorten rijen:

1. Hoofdrij: staat voor de productcontainer. Het Type is variable.
2. Variatierijen: elke rij staat voor één koopbare combinatie van opties. Het Type is variation.

Variaties worden aan het hoofdproduct gekoppeld via de SKU of ID daarvan.

Staat WordPress in het Nederlands, dan gebruikt de export Nederlandse kolomnamen (bijvoorbeeld "Artikelnummer" in plaats van SKU); de importer herkent beide. In deze handleiding staan de Engelse namen.

De hoofdrij

De hoofdrij legt de velden op productniveau vast en geeft aan welke attributen het product gebruikt.

Belangrijke kolommen voor hoofdrijen

| Kolom | Waarde | Opmerkingen | |---|---|---| | ID | (leeg of bestaande ID) | Leeg laten voor nieuwe producten | | Type | variable | Moet precies variable zijn | | SKU | SHIRT-BLUE | Unieke SKU van het hoofdproduct | | Name | Blue Cotton T-Shirt | Productnaam | | Published | 1 | 1 = gepubliceerd, 0 = concept | | Attribute 1 name | Size | Naam van de dimensie | | Attribute 1 value(s) | Small \| Medium \| Large | Alle beschikbare waarden, gescheiden door verticale streepjes | | Attribute 1 visible | 1 | Tonen op de productpagina | | Attribute 1 global | 1 | Globaal (gedeeld) attribuut gebruiken |

• Meerdere attributen gebruiken oplopend genummerde kolommen: Attribute 1 name, Attribute 2 name enzovoort.
• De Regular price van de hoofdrij mag leeg blijven of de laagste variatieprijs bevatten. De echte prijzen per variatie staan in de variatierijen.

Variatierijen

Elke variatierij staat voor één koopbare combinatie van opties en moet naar het hoofdproduct verwijzen.

Belangrijke kolommen voor variatierijen

| Kolom | Waarde | Opmerkingen | |---|---|---| | ID | (leeg of bestaande variatie-ID) | Leeg laten voor nieuwe variaties | | Type | variation | Moet precies variation zijn | | SKU | SHIRT-BLUE-SM | Uniek per variatie | | Name | Blue Cotton T-Shirt | Hoort gelijk te zijn aan de naam van het hoofdproduct | | Parent | id:123 of sku:SHIRT-BLUE | Koppelt via ID of SKU aan het hoofdproduct | | Regular price | 19.99 | Verplicht voor elke variatie | | Attribute 1 name | Size | Moet gelijk zijn aan de attribuutnaam van het hoofdproduct | | Attribute 1 value(s) | Small | Eén waarde voor precies deze variatie | | Stock | 50 | Voorraad per variatie | | Weight | 0.3 | In de eenheid die in de winkel is ingesteld |

Variaties aan het hoofdproduct koppelen

De kolom Parent accepteert twee notaties:

• Via database-ID: id:123 – als je de WooCommerce-product-ID kent.
• Via SKU: sku:SHIRT-BLUE – beter overdraagbaar; voor nieuwe producten die nog geen ID hebben.

Maak je nieuwe variabele producten vanaf nul aan, gebruik dan de notatie sku:PARENT_SKU. Importeer eerst de hoofdrij (of zet die in hetzelfde bestand boven de variaties).

Volledig voorbeeld: variabel T-shirt

ID,Type,SKU,Name,Published,Regular price,Attribute 1 name,Attribute 1 value(s),Attribute 1 visible,Stock
,variable,SHIRT-BLUE,Blue Cotton T-Shirt,1,,Size,Small | Medium | Large,1,
,variation,SHIRT-BLUE-SM,Blue Cotton T-Shirt,1,19.99,Size,Small,,30
,variation,SHIRT-BLUE-MD,Blue Cotton T-Shirt,1,19.99,Size,Medium,,25
,variation,SHIRT-BLUE-LG,Blue Cotton T-Shirt,1,21.99,Size,Large,,15

Let op: de kolom Parent is hier voor de beknoptheid weggelaten. In de praktijk horen de variatierijen Parent: sku:SHIRT-BLUE te bevatten.

Tweedimensionale variaties (maat EN kleur)

Voor een tweede attribuut (kleur) voeg je de kolommen van Attribute 2 toe aan de hoofdrij en vul je in elke variatie beide attribuutkolommen in:

Hoofdrij:

Attribute 1 name: Size
Attribute 1 value(s): Small | Medium
Attribute 2 name: Color
Attribute 2 value(s): Blue | Red

Variatie (Small, Blue):

Attribute 1 name: Size
Attribute 1 value(s): Small
Attribute 2 name: Color
Attribute 2 value(s): Blue

Voor 2 maten × 2 kleuren heb je 4 variatierijen nodig.

Veelgemaakte fouten

Fout 1: Type van de hoofdrij is simple in plaats van variable

Symptoom: de variaties worden aangemaakt, maar verschijnen niet op de productpagina. Het product wordt als eenvoudig product getoond.

Oplossing: de kolom Type van de hoofdrij moet variable (in kleine letters) zijn. Zonder het juiste type zet WooCommerce een eenvoudig product bij het importeren niet om naar een variabel product.

Fout 2: variatie niet gekoppeld aan het hoofdproduct

Symptoom: de variaties worden als losse eenvoudige producten aangemaakt in plaats van aan het hoofdproduct te worden gekoppeld.

Oplossing: zorg dat elke variatierij in de kolom Parent een waarde heeft in de notatie sku:PARENT_SKU of id:123. Ontbrekende of onjuiste verwijzingen leveren losse variaties op.

Fout 3: attribuutwaarden in de hoofdrij niet gescheiden door verticale streepjes

Symptoom: de productpagina toont maar één optie in de keuzelijst, of de knop "Toevoegen aan winkelwagen" ontbreekt.

Oplossing: zet in de hoofdrij alle mogelijke attribuutwaarden, gescheiden door | (spatie, verticaal streepje, spatie): Small | Medium | Large. WooCommerce vult met deze lijst de keuzelijst.

Fout 4: attribuutnaam verschilt tussen hoofdrij en variatie

Symptoom: de import slaagt, maar de variaties passen niet bij hun attributen, of er verschijnen verkeerde opties.

Oplossing: de waarde van Attribute 1 name moet in de hoofdrij en in elke variatierij identiek zijn. Size en Size (met een spatie) worden als verschillende attributen gezien.

Fout 5: Regular price ontbreekt in de variatierijen

Symptoom: de variaties worden zonder prijs aangemaakt, waardoor het product als niet te koop wordt getoond.

Oplossing: Regular price is verplicht in elke variatierij. De prijs wordt niet overgenomen van het hoofdproduct.

Fout 6: variaties geïmporteerd vóór het hoofdproduct

Symptoom: de variaties worden als losse producten aangemaakt, omdat de ID of SKU van het hoofdproduct nog niet bestaat.

Oplossing: zorg dat de hoofdrij in de CSV vóór de bijbehorende variatierijen staat. WooCommerce verwerkt de rijen van boven naar beneden.

Gedrag bij bijwerken

Wanneer je een variabel product dat al bestaat opnieuw importeert:

• Koppelen op ID: de veiligste methode. WooCommerce werkt het bestaande product bij als de ID overeenkomt.
• Koppelen op SKU: WooCommerce kan ook op SKU koppelen. Laat de ID leeg en vul de SKU in.
• Nieuwe variaties toevoegen: neem de bestaande variaties samen met de nieuwe op in het importbestand. Variaties die wel in de beheeromgeving staan maar niet in het importbestand, worden niet verwijderd, maar dit kan per WooCommerce-versie en instelling van de importplug-in verschillen.

Test updates altijd eerst in een testwinkel of met een back-up voordat je in de live winkel importeert.