Produktmodellierung: Best Practices

Modellieren Sie Produkte so, dass Pflege, Suche, Produktdetailseite, Preise, Warenkorb und Snippet-Vorlagen dieselbe fachliche Struktur verwenden. Trennen Sie Varianten, Relationen, Inhalte, Attribute, Einheiten und Preise bewusst, statt alle Unterschiede in Freitext oder einzelne Shop-Templates zu schreiben.

Wenn Sie die Begriffe erst einordnen möchten, starten Sie mit PIM-Grundlagen. Das Glossar erklärt Produktfamilie, Produktvariante, Attribut, Preisliste, Verkaufspreis und Einkaufspreis.

Entscheidungsmodell

Starten Sie mit der Frage, was der Kunde kaufen oder auswählen soll.

Nutzen Sie eine neue Variante nur, wenn die Auswahl eine eigene kaufbare oder verwaltete Ausprägung braucht. Nutzen Sie eine Produktrelation, wenn ein anderes Produkt zusätzlich, ersatzweise oder als Empfehlung angezeigt werden soll. Nutzen Sie Mischgebinde nur, wenn die Mischung selbst verbindlich verkauft oder beschafft wird und der Kunde die enthaltenen Positionen nicht frei zusammenstellt.

Familien zuerst bewusst wählen

Eine Produktfamilie ist die gemeinsame fachliche Struktur. Sie hilft, ähnliche Varianten gleich zu pflegen. Legen Sie eine neue Familie an, wenn Produkte dieselben Merkmale, Variantenachsen, Inhaltsprofile oder Grundpreisregeln teilen.

Gute Familien sind zum Beispiel Akkus, Wartungspakete, Softwarelizenzen oder Ersatzfilter. Schlechte Familien sind Sammelgruppen wie Sonstiges, Shop-Produkte oder Alle Dienstleistungen, wenn die Produkte fachlich keine gemeinsame Struktur haben.

Prüfen Sie vor einer neuen Familie:

• Welche Varianten gehören dauerhaft dazu?
• Welche Attribute gelten für die meisten Varianten?
• Welche Texte oder Inhaltsfelder braucht diese Familie?
• Braucht die Familie eigene Grundpreisregeln?
• Wer ist fachlich für diese Familie verantwortlich?

Wenn diese Antworten je Produkt stark abweichen, trennen Sie die Familien. Wenn nur Kategorien, Marken oder Shop-Navigation anders sind, reicht oft dieselbe Familie mit anderen Kategorien oder Inhalten.

Varianten sauber schneiden

Eine Produktvariante ist die kaufbare Identität. Sie trägt SKU, Basiseinheit, Steuerklasse, Fähigkeiten, Tracking, Erfüllungsstrategie und Preise.

Legen Sie eigene Varianten an für:

• Größen, Farben, Packungen oder Ausführungen, die der Kunde direkt auswählt.
• unterschiedliche Basiseinheiten oder Verkaufseinheiten.
• Produkte mit eigenem Preis, eigener Verfügbarkeit oder eigener Steuerklasse.
• physische, digitale, Lizenz- oder Service-Ausprägungen mit unterschiedlicher Erfüllung.
• Varianten, die im Warenkorb oder in Folgeprozessen getrennt nachvollziehbar bleiben müssen.

Vermeiden Sie Varianten für reine Textunterschiede. Pflegen Sie kanal- oder sprachbezogene Texte als Produktinhalt. Vermeiden Sie auch Sammelvarianten wie VARIANT-MISC, wenn Preis, Lager, Versand oder Reporting später einzelne Ausprägungen unterscheiden müssen.

Aktive Varianten ändern

Prüfen Sie vor jeder Änderung an einer aktiven Variante, ob die Änderung nur Nachpflege ist oder die kaufbare Identität verändert. Nutzen Sie die Korrekturphase für begrenzte Stammdatenpflege, zum Beispiel Texte, Attribute oder andere fachlich freigegebene Felder.

Legen Sie eine neue Variante an, wenn Sie strukturprägende Angaben ändern müssen, die in der Korrekturphase nicht gepflegt werden dürfen. Dazu gehören insbesondere Produktfamilie, SKU, Basiseinheit, Tracking-Typ, Geschäftstyp, Workflow, Fähigkeiten oder Steuerklasse. Beenden oder beschränken Sie danach die alte Variante, damit Verkauf, Lager, Reporting und öffentliche Storefronts nicht zwei fachlich konkurrierende Varianten parallel verwenden.

Vergeben Sie für die neue Variante eine neue SKU. Die SKU ist die interne, eindeutige Variantenkennung und darf nicht einfach von der alten Variante übernommen werden. Eine EAN oder GTIN ist dagegen eine externe Handelskennung: Sie kann gleich bleiben, wenn der reale handelbare Artikel unverändert bleibt und die Änderung nur die interne Modellierung betrifft. Verwenden Sie eine neue EAN oder GTIN, wenn aus Handelssicht ein neuer Artikel entsteht.

Relationen verwenden

Produktrelationen verbinden eine Ausgangsvariante mit Zielvarianten. Nutzen Sie sie für Produktempfehlungen und fachliche Zusammenhänge auf Variantenebene.

Workspace verwendet diese Relationstypen:

Pflegen Sie Relationen gezielt und sortiert. Verknüpfen Sie nur Zielvarianten, die fachlich zur Ausgangsvariante passen. Die öffentliche Storefront zeigt aus diesen Relationen nur Ziele, die im aktuellen Storefront-Kontext veröffentlicht und gelistet sind. Eine Relation ersetzt deshalb keine Veröffentlichung, keinen Preis und keine Verfügbarkeit.

Inhalte und Attribute trennen

Nutzen Sie Attribute für strukturierte, vergleichbare Werte wie Farbe, Leistung, Material, Anschluss, Größe oder technische Merkmale. Nutzen Sie Produktinhalte für redaktionelle Darstellung, Vorteile, Detailtexte, SEO-Inhalte oder kanalbezogene Beschreibungen.

Als einfache Regel gilt: Ein Wert gehört als Attribut gepflegt, wenn jemand danach filtern, sortieren, vergleichen oder ihn einheitlich auswerten möchte. Ein Wert gehört eher in den Produktinhalt, wenn er erklären, verkaufen oder für einen bestimmten Kanal anders formuliert werden soll.

Planen Sie Inhaltsschemata nach Produktfamilie und Zweck. Eine Familie braucht ein eigenes Schema, wenn Redakteure dort andere Felder pflegen sollen. Eine technische Familie kann zum Beispiel technische Daten, Kompatibilität und Downloads brauchen; eine einfache Handelsware braucht vielleicht nur Name, Kurzbeschreibung und Vorteile.

Planen Sie Produkttexte modular. Der Zweck beschreibt die fachliche Inhaltsart, zum Beispiel Produktdetailtext, Sicherheitshinweise, technische Daten, SEO oder Marktplatzinhalt. Der Vertriebskanal beschreibt, wo der Inhalt verwendet wird. Vermischen Sie diese Ebenen nicht in Zwecknamen wie web_safety oder amazon_safety. Nutzen Sie stattdessen einen fachlichen Zweck wie safety_instructions und binden Sie abweichende Felder oder Texte über Inhaltsprofile an Webshop, Portal, Marktplatz oder Sprache.

Optional geltende Inhaltsbereiche gehören nicht in jedes Hauptschema. Wenn nur ein Teil des Sortiments Sicherheitshinweise, Downloads oder Kompatibilitätstexte braucht, planen Sie dafür eigene Zwecke und lassen Sie die Ausgabe diese Bereiche nur anzeigen, wenn freigegebene Inhalte vorhanden sind. So vermeiden Sie leere Pflichtfelder und halten Produktfamilien vergleichbar.

Halten Sie strukturierte Werte aus HTML-Feldern heraus, wenn die Storefront sie filtern, sortieren, vergleichen oder einzeln anzeigen soll.

Die konkrete Pflege von Attributsätzen, Gruppen, Attributen und Wertelisten steht in Attribute und Wertelisten pflegen. Die Planung von Inhaltszwecken, Inhaltsschemata und Profilen steht in PIM-Inhalte konfigurieren.

Einheiten und Preise festlegen

Pflegen Sie die Basiseinheit an der Variante und verwenden Sie dieselbe öffentliche Einheit für Pricing und Warenkorb. Die Storefront darf keine Default-Einheit raten.

Nutzen Sie Produktpreise für:

• Preise je Variante und Preisliste.
• Mengenstaffeln.
• abweichende Verkaufseinheiten, wenn der Preis nicht direkt auf der Basiseinheit liegt.
• Grundpreisanzeige, wenn der Shop eine Vergleichsbasis wie 100 g, 1 kg oder 1 l anzeigen muss.

Die Storefront berechnet Preise und Grundpreise nicht selbst. Sie rendert nur die Beträge, Staffelinformationen und Anzeigezustände, die der öffentliche Pricing-Vertrag liefert.

Verpackungen, Mischgebinde und Bundles abgrenzen

Verwenden Sie Verpackungen, Mischgebinde und Bundles nicht austauschbar. Die Modelle beantworten unterschiedliche fachliche Fragen.

Ein Mischgebinde gehört zu genau einer Trägervariante. Diese Trägervariante ist die kaufmännische Identität des Mischgebindes: Sie trägt Name, SKU, Steuerkontext, Lifecycle, Preisbezug und Veröffentlichung. Die Positionen des Mischgebindes verweisen auf die enthaltenen Varianten und enthalten die jeweilige Menge.

Nutzen Sie Mischgebinde für:

• Startersets mit mehreren Artikeln.
• Displays oder Prepacks mit festem Inhalt.
• Aktionspakete, die nur als komplette Mischung verkauft werden.
• Einkaufs- oder Verkaufsgebinde, deren Inhalt aus unterschiedlichen Varianten besteht.

Nutzen Sie keine Mischgebinde für:

• Zubehör, das der Kunde optional hinzufügen oder entfernen darf.
• Variantenachsen wie Größe, Farbe oder Laufzeit.
• reine Marketingabschnitte auf einer Produktdetailseite.
• physische Packstückverfolgung einzelner Kartons oder Paletten.

Mischgebinde pflegen

Pflegen Sie Mischgebinde erst, wenn die Trägervariante und alle enthaltenen Varianten fachlich angelegt sind.

Gehen Sie so vor:

1. Öffnen Sie die Trägervariante unter PIM > Varianten & Preise > Varianten.
2. Öffnen Sie den Tab Mischgebinde oder den zentralen Bereich PIM > Varianten & Preise > Mischgebinde.
3. Legen Sie das Mischgebinde mit einem klaren Namen an. Workspace leitet den Code aus dem Namen ab, wenn Sie keinen Code pflegen.
4. Ergänzen Sie die Positionen mit enthaltener Variante, Menge und Sortierung.
5. Aktivieren Sie Einkaufbar, wenn das Mischgebinde als Einkaufsziel verwendet werden soll.
6. Aktivieren Sie Verkaufbar, wenn das Mischgebinde als Verkaufsziel verwendet werden soll.
7. Pflegen Sie Preise für das Ziel Mischgebinde, wenn das Mischgebinde verkauft werden soll.

Ein einkaufbares oder verkaufbares Mischgebinde braucht mindestens eine Position. Workspace blockiert aktive Mischgebinde ohne Positionen, weil Einkauf, Verkauf, Preisfindung und Belege sonst nicht wissen, was das Mischgebinde enthält.

Beachten Sie diese Regeln:

• Eine Trägervariante hat höchstens ein Mischgebinde.
• Eine Position darf nicht auf dieselbe Variante zeigen wie die Trägervariante.
• Jede enthaltene Variante darf im selben Mischgebinde nur einmal vorkommen.
• Jede Positionsmenge muss größer als 0 sein.
• Alle Positionen müssen zum selben Arbeitsbereich gehören.

Preise und Folgeprozesse für Mischgebinde

Ein Mischgebinde ersetzt keine Einzelpreise der enthaltenen Varianten. Wenn Sie ein Mischgebinde verkaufen, pflegen Sie einen eigenen Preis für das Mischgebinde. Der Preis gehört zum Mischgebinde als kaufmännischem Ziel und nicht zu einer frei berechneten Summe aus den Positionen.

Für Verkauf gilt:

• Verkaufbar muss aktiv sein.
• Ein gültiger Preis für das Mischgebinde muss zur Preisliste und zum Kanal passen.
• Warenkorb, Angebot, Auftrag und Rechnung übernehmen Code und Name des Mischgebindes als Snapshot, damit spätere Stammdatenänderungen bestehende Belege nicht still verändern.
• Reservierung, Picking, Warenausgang und RMA-Komponenten arbeiten mit den enthaltenen Varianten. Die kaufmännische Position bleibt das Mischgebinde, der physische Lagerfluss kennt aber die Kindvarianten und deren Einheiten.
• Seriennummern und Chargen gehören im Versand und bei Rückgaben zur enthaltenen Variante, nicht zur Trägervariante.

Für Einkauf gilt:

• Einkaufbar muss aktiv sein.
• Einkaufspositionen verwenden das Mischgebinde als Ziel, wenn die feste Mischung beschafft werden soll.
• Wareneingang und Bestandslogik bleiben mengenbezogen bei den Varianten und ihrer Basiseinheit. Das Mischgebinde beschreibt die kaufmännische Mischung.

Wenn ein Mischgebinde in einer Storefront sichtbar sein soll, veröffentlichen Sie die Trägervariante wie jede andere kaufbare Variante. Produktinhalte, Medien, Route, Preis und Readiness müssen zum Vertriebskanal passen.

Bei Angeboten wählen Sie die Trägervariante und das Ziel Mischgebinde, wenn der Kunde die feste Mischung kaufen soll. Verwenden Sie keine freie Textposition und keine manuelle Summe aus Einzelvarianten, wenn Folgeprozesse Bestand, Picking, Seriennummern oder Rückgaben korrekt nachhalten müssen.

Snippet-Vorlagen planen

Snippet-Vorlagen erzeugen vorgerenderte HTML-Artefakte für wiederverwendbare Produktdarstellungen. Planen Sie Snippets nach Ausgabeort:

Snippet-Vorlagen sollen gepflegte Strukturen anzeigen, aber keine Preis-, Warenkorb- oder Checkout-Logik enthalten. Rendern Sie Preise, Verfügbarkeit und Checkout-Zustände aus den öffentlichen Storefront- und Pricing-Antworten oder aus dafür vorgesehenen, separat aktualisierten Darstellungsblöcken.

Wenn ein Snippet Produktrelationen zeigt, nutzen Sie die recommendation_groups aus dem Snippet-ViewModel. Übersetzen Sie die englischen Relationstypen im Template oder in der Storefront für sichtbare Überschriften, aber ändern Sie die technischen Keys nicht.

Storefront und API verwenden

Eine öffentliche Storefront nutzt nur öffentliche Verträge:

1. Laden Sie den Storefront-Kontext.
2. Suchen Sie Produkte über den Public Catalog.
3. Laden Sie Product Summary oder Produktdetaildaten.
4. Rendern Sie Detailseiten-Empfehlungen aus recommendationGroups, wenn der Produktdetail-Endpunkt Gruppen liefert.
5. Lösen Sie Preise und Verfügbarkeit über Pricing auf.
6. Fügen Sie die aktive variantId, Menge und öffentliche Einheit in den Warenkorb ein.
7. Binden Sie Snippet-Artefakte nur ein, wenn Tenant, Variante, Sprache und Vertriebskanal zum aktuellen Kontext passen.

Nutzen Sie keine internen PIM-, Admin-, Inventory- oder Commerce-Endpunkte als Fallback. Wenn eine Relation, ein Snippet oder ein Produkt im öffentlichen Kontext fehlt, prüfen Sie Veröffentlichung, Listung, Content, Readiness, Sales Channel, Locale und Snippet-Rebuild.

Typische Fallmuster

Größenraster: Modellieren Sie jede Größe als Variante, wenn Preis, Bestand oder Warenkorb die Größe konkret kennen müssen. Die Detailseite kann die Größen als Auswahl für dieselbe Produktroute anzeigen.

Farbe oder Ausführung: Modellieren Sie Farbe als Variante, wenn der Kunde sie auswählt und sie eine eigene SKU oder Verfügbarkeit hat. Nutzen Sie Attribute, damit Listen und Filter die Farbe strukturiert anzeigen können.

Zubehör: Pflegen Sie Zubehör als eigene Variante und verknüpfen Sie es mit accessory. Die Storefront rendert daraus Zubehörkarten oder einen passenden Detailabschnitt, wenn die Zielvarianten öffentlich sichtbar sind.

Ersatzteile: Pflegen Sie Ersatzteile als eigene Varianten und verknüpfen Sie sie mit spare_part. Nutzen Sie klare Inhalte, damit Kunden das passende Teil erkennen.

Alternative oder Upgrade: Nutzen Sie substitute für fachliche Alternativen und up_sell für höherwertige Optionen. Berechnen Sie Preisunterschiede nicht im Snippet, sondern laden Sie Pricing für die angezeigten Zielvarianten.

Service oder Zusatzleistung: Modellieren Sie eine Zusatzleistung als eigene Service-Variante, wenn sie separat verkauft, bepreist oder im Warenkorb stehen soll. Nutzen Sie eine Relation wie cross_sell, wenn sie als Empfehlung zum Hauptprodukt erscheinen soll.

Mischgebinde oder Starterset: Modellieren Sie ein Starterset als Trägervariante mit Mischgebinde, wenn der Kunde die enthaltenen Positionen nur gemeinsam kaufen soll. Pflegen Sie die enthaltenen Varianten als Mischgebindepositionen und bepreisen Sie das Mischgebinde als eigenes Verkaufsziel.

Prepack oder Display: Nutzen Sie ein Mischgebinde, wenn ein Lieferant oder Vertriebskanal ein festes Mischgebinde erwartet. Aktivieren Sie Einkaufbar für Beschaffung und Verkaufbar für Verkauf nur dann, wenn der jeweilige Prozess diese feste Mischung wirklich nutzen soll.

Prüfliste vor Veröffentlichung

• Die Produktfamilie beschreibt die gemeinsame Struktur.
• Varianten repräsentieren kaufbare oder verwaltete Ausprägungen.
• Aktive Varianten mit strukturprägenden Änderungen werden als neue Variante mit neuer SKU angelegt.
• Attribute enthalten vergleichbare technische Werte.
• Produktinhalte decken Sprache, Vertriebskanal und Zweck ab.
• Preise, Einheiten und Grundpreise passen zur Variante.
• Verkaufbare Mischgebinde haben vollständige Positionen und einen passenden Mischgebindepreis.
• Relationen nutzen einen erlaubten Typ und zeigen auf passende Zielvarianten.
• Veröffentlichungen und Readiness sind für den Sales Channel erfüllt.
• Snippet-Vorlagen rendern vorhandene Felder defensiv und ohne Checkout-Logik.
• Der Snippet-Rebuild lief nach relevanten Änderungen.
• Die Storefront nutzt recommendationGroups, Pricing und Cart aus öffentlichen Verträgen.

Häufige Fehler

• Varianten werden nur für abweichende Texte angelegt.
• Zubehör oder Ersatzteile stehen als HTML-Liste im Produkttext statt als Produktrelation.
• Relationstypen werden übersetzt und dadurch technisch inkonsistent.
• Snippets berechnen Preise, Verfügbarkeit oder Warenkorbzustände selbst.
• Die Storefront verwendet interne PIM-Endpunkte, weil ein öffentliches Produkt nicht sichtbar ist.
• Eine Relation zeigt auf eine Variante ohne Veröffentlichung im aktuellen Sales Channel.
• Ein Mischgebinde wird als Zubehör verwendet, obwohl der Kunde die Position einzeln hinzufügen oder entfernen können soll.
• Verkaufbar ist aktiv, aber es gibt keinen gültigen Mischgebindepreis für die relevante Preisliste.
• Eine neue Variante übernimmt die alte SKU, obwohl sie eine eigene interne Variantenidentität braucht.
• Ein Snippet wird nach Content-, Template- oder Scope-Änderungen nicht neu gebaut.

Nächste Schritte

• Ordnen Sie die PIM-Bausteine mit PIM-Fähigkeiten ein.
• Wählen Sie konkrete Modellmuster mit Produktmodellierung: Entscheidungshilfe.
• Pflegen Sie Produktinhalte und Medien mit Produktinhalte pflegen.
• Veröffentlichen Sie die modellierte Variante mit Produktdaten veröffentlichen.
• Konfigurieren Sie strukturierte Inhaltsschemata mit PIM-Inhalte konfigurieren, wenn Redakteure neue Felder brauchen.