Handleiding voor Configureerbare Producten

Twee-dimensionale configureerbare producten instellen (zoals schoenen met Kleur EN Maat) in KatanaPIM Connect. Deze handleiding legt uit hoe u producten structureert in KatanaPIM met Parent en GrandParent relaties, en hoe u Magento configureert om ze correct te importeren als configureerbare producten met meerdere variatie-attributen.

De Producthiërarchie Begrijpen

KatanaPIM gebruikt een drie-niveau hiërarchie voor producten met meerdere variatie-dimensies:

Belangrijk: Parent producten verschijnen in het KatanaPIM grid maar er wordt geen Magento product voor aangemaakt. Parents dienen als datacontainers die de eerste variatie-attribuutwaarde bevatten (bijv. Kleur). Deze waarde wordt overgenomen door hun Child producten.

Visueel voorbeeld - Hardloopschoenen met Kleur en Maat:

KatanaPIM Structuur:
────────────────────
GrandParent: Running shoes (SKU: 000-RS)
├── Parent: Running shoes - Blue (SKU: 000-RS-B)      [Color: Blue]  
│   ├── Child: Running shoes - Blue - 42 (SKU: 000-RS-B-42)  [Size: 42]  
│   ├── Child: Running shoes - Blue - 43 (SKU: 000-RS-B-43)  [Size: 43]  
│   └── Child: Running shoes - Blue - 44 (SKU: 000-RS-B-44)  [Size: 44]  
├── Parent: Running shoes - Red (SKU: 000-RS-R)       [Color: Red]  
│   ├── Child: Running shoes - Red - 42 (SKU: 000-RS-R-42)   [Size: 42]  
│   ├── Child: Running shoes - Red - 43 (SKU: 000-RS-R-43)   [Size: 43]  
│   └── Child: Running shoes - Red - 44 (SKU: 000-RS-R-44)   [Size: 44]  
└── Parent: Running shoes - Yellow (SKU: 000-RS-Y)    [Color: Yellow]
    ├── Child: Running shoes - Yellow - 42 (SKU: 000-RS-Y-42) [Size: 42]
    ├── Child: Running shoes - Yellow - 43 (SKU: 000-RS-Y-43) [Size: 43]
    └── Child: Running shoes - Yellow - 44 (SKU: 000-RS-Y-44) [Size: 44]

In Magento wordt dit:

Magento Structuur:
──────────────────
Configurable: Running shoes (SKU: 000-RS)
├── Simple: Running shoes - Blue - 42 (Color: Blue, Size: 42)  
├── Simple: Running shoes - Blue - 43 (Color: Blue, Size: 43)  
├── Simple: Running shoes - Blue - 44 (Color: Blue, Size: 44)  
├── Simple: Running shoes - Red - 42 (Color: Red, Size: 42)  
├── Simple: Running shoes - Red - 43 (Color: Red, Size: 43)  
├── Simple: Running shoes - Red - 44 (Color: Red, Size: 44)  
├── Simple: Running shoes - Yellow - 42 (Color: Yellow, Size: 42)  
├── Simple: Running shoes - Yellow - 43 (Color: Yellow, Size: 43)  
└── Simple: Running shoes - Yellow - 44 (Color: Yellow, Size: 44)

De GrandParent wordt het configureerbare product, en alle Children worden de eenvoudige productvarianten. Parent producten worden overgeslagen - ze bestaan alleen om de hiërarchie te organiseren en Kleur waarden door te geven aan Children.

Vereisten in KatanaPIM

Zorg ervoor dat uw KatanaPIM producten correct zijn gestructureerd voordat u importeert:

1. Productstructuur

2. Variatie-attributen

3. Verifiëren in KatanaPIM

Stap 1: Attributen Importeren uit KatanaPIM

Importeer eerst alle attributen inclusief uw variatie-attributen.

1. Navigeer naar Katana PIM → Attributes
2. Klik op Import Attributes
3. Wacht tot de import is voltooid
4. Zoek uw variatie-attributen (bijv. "Color", "Size")

Stap 2: Attributen Markeren als Configurable

Dit is de cruciale stap. Attributen die worden gebruikt voor productvariaties MOETEN worden gemarkeerd als configurable.

1. In Katana PIM → Attributes grid
2. Zoek uw eerste variatie-attribuut (bijv. "Color")
3. Klik op de Magento Attribute Code cel
   • Selecteer bestaand Magento attribuut OF
   • Selecteer "Create New" om automatisch aan te maken
4. Klik op de Is Configurable cel
5. Zet op Yes
6. Herhaal voor alle variatie-attributen (bijv. "Size")

Voorbeeld configuratie:

Belangrijk: Als "Is Configurable" niet op Yes staat, kan de module geen configureerbare productrelaties aanmaken.

Stap 3: Magento Attributen Aanmaken

Na het mappen en instellen van "Is Configurable = Yes", maak de attributen aan in Magento:

1. Selecteer de gemapte variatie-attributen (checkboxes)
2. Gebruik mass action Update/Create Magento Attribute

De module doet automatisch:

• Maakt attributen aan met katanapim_ prefix als ze nieuw zijn
• Zet "Gebruik voor Configureerbare Producten" op Ja voor attributen gemarkeerd als configurable
• Stelt het juiste invoertype in (Dropdown)

Stap 4: Producten Importeren

Importeer nu de producten uit KatanaPIM.

1. Navigeer naar Katana PIM → Products
2. Klik op Sync Full om alle producten te importeren
3. Wacht tot de import is voltooid

Na de import ziet u producten met verschillende "Katana Type" waarden:

• GrandParent - Uw master configureerbare producten
• Parent - Tussenliggend niveau (kleurvarianten in ons voorbeeld) - verschijnt in grid maar geen Magento product wordt aangemaakt
• Child - De daadwerkelijke eenvoudige producten met alle variaties

Wat u ziet in het grid:

Merk op dat Parent rijen een lege "Type" kolom hebben - dit is verwacht gedrag. De module gebruikt Parents alleen voor data overerving (het Color attribuut), niet voor het aanmaken van producten.

Stap 5: Magento Producten Aanmaken

Maak producten aan in de juiste volgorde:

Automatisch Aanmaken

Handmatig Aanmaken

De Setup Verifiëren

Na het aanmaken, verifieer in Magento:

Controleer Configureerbaar Product

Controleer op Frontend

Veelvoorkomende Configuraties

Twee Variaties: Kleur + Maat (Kleding/Schoenen)

Twee Variaties: Materiaal + Lengte (Hardware)

Twee Variaties: Smaak + Verpakkingsgrootte (Voeding)

Probleemoplossing

Configureerbaar product koppelt geen children

Producten aangemaakt als Simple in plaats van Configurable

Ontbrekend variatie-attribuut in dropdown

Children tonen verkeerde GrandParent relatie

Products Grid Kolommen

Activeer deze verborgen kolommen voor het debuggen van configureerbare producten:

Om te activeren: Klik op Columns knop in grid toolbar → vink de kolommen aan die u nodig heeft.

Meer Hulp Nodig?

Documentatie:

• Alle Help Artikelen - Compleet documentatie overzicht

Support:

• Contact Opnemen - Hulp van ons team