Parent und Children gemeinsam anlegen — der Standard-Variations-Upload.

Der Standard-Workflow für eine brandneue Varianten-Familie ist ein einzelner Flat-File-Upload — eine Parent-Zeile und eine Zeile pro Child, gemeinsam übermittelt. Die drei Spalten, die entscheiden, ob es im ersten Anlauf klappt, sind parent_child, parent_sku und variation_theme. Alles andere kann nachträglich angepasst werden; diese drei nicht.

Das richtige Template wählen

Amazon liefert ein kategoriespezifisches Flat-File-Template (herunterladen aus Katalog → Produkte per Upload hinzufügen → Inventar-Dateien für Nicht-Medien-Kategorien). Immer eine frische Kopie für den genauen Browse-Node herunterladen — Spaltensätze unterscheiden sich zwischen Kategorien, und ein Schuhe-Template validiert keine Küchen-Familie. Das Template hat drei wichtige Sheets: Template (die Zeilen zum Befüllen), Data Definitions (die Spezifikation für jede Spalte) und Valid Values (die kontrollierten Vokabularien — Varianten-Themes, Farbnamen, Größennamen).

Die Parent-Zeile

• item_sku = eine eindeutige SKU, die dem Parent zugewiesen wird (z. B. MARKE-FAM-PARENT).
• parent_child = parent
• parent_sku = leer (der Parent hat keinen eigenen Parent)
• variation_theme = das gewählte Theme (z. B. Color, Size, ColorSize). Muss ein Wert aus dem Valid Values-Sheet für diese Kategorie sein.
• relationship_type = Variation
• Marke, Kategorie (item_type oder recommended_browse_nodes), Titel-Template, familienweite Bullets, familienweiter A+, familienweites Hero-Bild — alle ausgefüllt.
• Jedes child-spezifische Feld (Größe, Farbwert, Child-SKU, Child-GTIN, Child-Preis) — leer.

Die Child-Zeilen

• item_sku = jede eigene eindeutige Child-SKU (z. B. MARKE-FAM-ROT, MARKE-FAM-BLAU).
• parent_child = child
• parent_sku = die SKU der obigen Parent-Zeile — exakte Übereinstimmung, einschließlich Groß-/Kleinschreibung und Leerzeichen.
• variation_theme = dasselbe Theme wie der Parent. Anderes Theme = die Zeile wird als verwaist abgelehnt.
• color_name / size_name / usw. = der Attributwert, der dieses Child unterscheidet. Muss in der Valid Values-Liste stehen (Amazon erzwingt ein kontrolliertes Vokabular bei Farbnamen in einigen Kategorien).
• Die eigene GTIN des Childs (external_product_id + external_product_id_type).
• Preis, Bestand, Child-level-Hauptbild des Childs sowie alle per-Child-Überschreibungen für Titel, Bullets oder Beschreibung.

Das Einreichen

Hochladen aus Katalog → Produkte per Upload hinzufügen → Inventar-Datei hochladen. Das korrekte Browse-Node-Template und die Datei auswählen. Amazon stellt es in die Warteschlange (normalerweise Minuten, manchmal Stunden in der Q4) und gibt einen Processing-Report zurück. Der Report ist die Quelle der Wahrheit — Zeile für Zeile lesen.

Validierung — die acht Checks, die 90 % der Fehler abfangen

1. Der parent_sku jedes Childs stimmt exakt mit der item_sku der Parent-Zeile überein.
2. Jede Zeile hat dasselbe variation_theme.
3. Jede Zeile hat denselben relationship_type = Variation.
4. Jedes Child hat einen Attributwert für dieses Theme (keine Leerstellen bei color_name für eine Color-Familie).
5. Keine zwei Children teilen dieselbe Kombination von Theme-Werten (keine zwei Roten; bei ColorSize keine zwei „Rot / M“-Zeilen).
6. Jedes Child hat seine eigene GTIN, von Geschwistern unterschiedlich.
7. Die Kategorie der Parent-Zeile erlaubt das gewählte Theme.
8. Die Marke ist bei Parent und jedem Child identisch.

Den Processing-Report lesen

Fehler kommen mit einer Zeilenreferenz und einem Code zurück. Die häufigsten Codes:

• 8541 / 5461 — Varianten-Theme-Mismatch zwischen Child und Parent.
• 8542 — parent_sku einer Child-Zeile stimmt mit keiner item_sku in der Datei oder im live Katalog überein.
• 5665 — Doppelte Attributkombination bei zwei Children (zwei „Rot / M“-Zeilen).
• 8016 — Kategorie erlaubt dieses Varianten-Theme nicht; ein anderes Theme oder eine andere Kategorie wählen.

Das Recovery-Muster, wenn nur einige Zeilen erfolgreich sind

Amazon verarbeitet jede Zeile unabhängig. Wenn die Parent-Zeile erfolgreich ist, aber zwei Children scheitern, existiert ein live Parent mit drei angehängten Children und zwei fehlenden. Nicht die gesamte Datei erneut hochladen — das verarbeitet den live Parent erneut und riskiert eine Verunreinigung seines Contents. Stattdessen nur die fehlgeschlagenen Zeilen korrigieren und als Single-Row-Datei pro Child erneut hochladen. Die Korrektur ist gezielt und die live Familie bleibt intakt.