Magento import error: configurable_variations format invalid

Je krijgt deze error tijdens import. Je deadline nadert. Hier is de directe oplossing, plus hoe je dit voor altijd voorkomt.

De error in detail

Wat Magento verwacht

sku,name,type,configurable_variations
SHIRT-001,"Basic Shirt",configurable,"sku=SHIRT-RED-S,color=Red,size=S|sku=SHIRT-RED-M,color=Red,size=M"

Wat jij waarschijnlijk hebt

sku,name,type,configurable_variations
SHIRT-001,"Basic Shirt",configurable,"SHIRT-RED-S,Red,S|SHIRT-RED-M,Red,M"

Het verschil? Magento wil expliciet sku=, color=, size= zien. Niet impliciet.

Quick fix (5 minuten)

Stap 1: Open je CSV in Excel

Zoek de configurable_variations kolom. Die ziet er nu waarschijnlijk zo uit:

SHIRT-RED-S,Red,S|SHIRT-RED-M,Red,M

Stap 2: Gebruik deze Excel formule

=CONCATENATE(
  "sku=",A2,",",
  "color=",B2,",",
  "size=",C2
)

Pas aan naar jouw kolomnamen.

Stap 3: Het juiste format

Correct format:

sku=SHIRT-RED-S,color=Red,size=S|sku=SHIRT-RED-M,color=Red,size=M

Veelvoorkomende varianten van deze error

Fouten die je vaak tegenkomt:

1. Missing attribute labels

• ❌ Je hebt: RED,S,M
• ✅ Moet zijn: color=Red,size=S

2. Verkeerde separator

• ❌ Je hebt: sku=123;color=Red
• Gebruik komma, niet semicolon

3. Spaties in values

• ❌ Je hebt: color = Red
• Geen spaties rond = teken

De structurele oplossing

Manual fixen werkt voor 10 producten. Bij 1000 producten niet meer. Hier zijn je opties:

Optie 1: Excel macro (beperkt)

Sub FixConfigurableVariations()
    Dim cell As Range
    For Each cell In Selection
        ' Parse en rebuild variations
        ' ... 50 regels VBA code
    Next cell
End Sub

Probleem: Werkt alleen voor exact jouw format. Volgende leverancier = nieuwe macro.

Optie 2: Import extensie ($299+)

Verschillende Magento extensies beloven dit op te lossen:

• Firebear Improved Import
• Magmi (gratis maar complex)
• Commerce Extensions

Probleem: Dure licenties, nog steeds manual mapping per leverancier.

Optie 3: Intelligente automatisering

Upload je leveranciers CSV. AI herkent het patroon. Genereert perfect Magento format. Elke keer.

Tijdsbesparing per methode

Waarom gebeurt deze error steeds?

Leveranciers denken niet in Magento format

Je leverancier stuurt dit:

SKU,Product,Kleur,Maat,Prijs
SHIRT-RED-S,"Basic Shirt Rood S",Rood,S,29.95
SHIRT-RED-M,"Basic Shirt Rood M",Rood,M,29.95

Magento wil dit:

sku,name,type,configurable_variations,visibility
SHIRT-001,"Basic Shirt",configurable,"sku=SHIRT-RED-S,color=Rood,size=S|sku=SHIRT-RED-M,color=Rood,size=M","Catalog, Search"
SHIRT-RED-S,"",simple,"","Not Visible Individually"
SHIRT-RED-M,"",simple,"","Not Visible Individually"

Totaal andere structuur. Totaal andere logica.

Het echte probleem: schaal

Bij deze aantallen is manual fixen geen optie meer.

Debug tips

Check 1: Attribute codes

# In Magento CLI
bin/magento eav:attribute:list --entity-type=catalog_product | grep color

Je variations moeten EXACT deze attribute codes gebruiken.

Check 2: Parent-child volgorde

FOUT: Parent eerst, dan children GOED: Children eerst, dan parent

Magento moet eerst de simple products kennen voordat het de configurable kan maken.

Check 3: Visibility settings

Simple products: "Not Visible Individually" Configurable product: "Catalog, Search"

Vergeet je dit? Dan zie je alle varianten los in je shop.

Preventie: nooit meer deze error

Stap 1: Template maken

Download een werkende export uit Magento:

bin/magento export:data:catalog_product --type=configurable

Gebruik dit als template voor nieuwe imports.

Stap 2: Validatie script

import pandas as pd

def validate_magento_csv(file):
    df = pd.read_csv(file)

    # Check configurable_variations format
    for index, row in df.iterrows():
        if row['type'] == 'configurable':
            variations = row['configurable_variations']
            if not all(['sku=' in v for v in variations.split('|')]):
                print(f"Error in row {index}: missing sku= prefix")

Stap 3: Automatiseer de transformatie

In plaats van elke keer manual fixen:

1. Upload leverancier CSV
2. AI herkent structuur
3. Automatische transformatie naar Magento format
4. Validatie voor import
5. Direct naar Magento API

Resultaat: Van 2 uur manual werk naar 2 minuten upload & klaar.

Specifieke scenario's

Meerdere attribute sets

# Shirts hebben color + size
# Shoes hebben color + size + width

Oplossing: Verschillende import templates per attribute set.

Dynamische opties

Leverancier voegt nieuwe kleur toe? Magento kent die nog niet.

Manual: Eerst attribute option aanmaken, dan import Geautomatiseerd: Nieuwe opties automatisch aanmaken tijdens import

Prijzen per variant

configurable_variations="sku=X,color=Red,size=S,price=29.95"  ❌

Magento wil prijzen NIET in variations. Die gaan in aparte kolommen voor de simple products.

TL;DR Checklist

Voor de snelle fix:

Werkt het nog niet? Check de Magento logs:

tail -f var/log/import.log

Conclusie

De "configurable_variations format invalid" error komt door het verschil tussen hoe leveranciers data aanleveren en wat Magento verwacht. Quick fixes werken voor kleine aantallen, maar bij schaal heb je automatisering nodig.

Stop met elke week dezelfde import errors fixen. Automatiseer het één keer, profiteer voor altijd.

Next steps:

1. Fix je huidige import met bovenstaande oplossing
2. Download een werkend template voor volgende keer
3. Overweeg automatisering voor structurele oplossing

Gemiddeld verspillen Magento shops 8 uur per week aan import errors. In 20 minuten kun je dit permanent oplossen.