home24 Marketplace und Lieferantenmodell
Du möchtest ein Möbel- oder Wohnsortiment auf home24 Marketplace anbieten und die Produktpflege mit deiner zentralen Datenbasis verbinden. Die shopvibes-Anbindung nutzt den Mirakl-basierten Partnerprozess. Vor dem ersten Test klärst du mit home24, welches Konto, welche Kategorien und welche Zielmärkte für dein Sortiment freigegeben sind.
Diese Seite beschreibt den Marketplace-Workflow. Für einen klassischen Lieferantenprozess gibt es eine eigene home24-Vendor-Seite. Die Anforderungen und Übertragungswege der beiden Modelle prüfst du jeweils separat.
Was du für die Anbindung vorbereitest
Für die Einrichtung benötigt das shopvibes-Team den API-Schlüssel des vorgesehenen Partnerkontos und die passende Kategorievorlage. Die Vorlage erzeugst du im jeweiligen Mirakl-Portal für die Kategorien, die du tatsächlich bedienen möchtest. Sie ist die Grundlage für Felder, erlaubte Werte und das Mapping deiner Produktdaten.
Halte gemeinsam fest, welche Vorlage und Sprache verwendet werden und wer Änderungen an den Kategorieanforderungen prüft. Die Mirakl-Vorlage eines anderen Händlers lässt sich nicht ohne Prüfung auf home24 übertragen.
| Grundlage | Was du vor dem Test klärst |
|---|---|
| Partnerkonto | Welcher home24-Zugang wird angebunden und welches Sortiment ist vorgesehen? |
| Kategorievorlage | Passt die aktuelle Vorlage zur konkreten Produktkategorie? |
| Produktidentität | Lassen sich Artikel und Ausführungen eindeutig deinen zentralen Datensätzen zuordnen? |
| Attribute und Werte | Welche Angaben stammen direkt aus dem PIM, welche benötigen eine Wertzuordnung? |
| Laufende Änderungen | Welche Inhalte, Preise und Bestände führt welches System und was umfasst die eingerichtete Anbindung? |
Möbeldaten für home24 eindeutig aufbereiten
Bei Wohnsortimenten reicht ein gemeinsames Feld für „Größe“ oft nicht aus. Ein Bett kann eine Liegefläche, ein anderes Außenmaß und mehrere Packstücke haben. Ein Set kann auf einem Bild mehr Gegenstände zeigen, als tatsächlich enthalten sind. Solche Informationen sollten bereits im Produktstamm getrennt gepflegt werden.
| Datenbereich | Praktischer Prüfpunkt |
|---|---|
| Maße | Liegefläche, Produktaußenmaß und Verpackungsmaß getrennt halten und Einheiten angeben |
| Material | Tatsächliche Materialien, Oberflächen und gegebenenfalls unterschiedliche Bestandteile beschreiben |
| Lieferumfang | Bettrahmen, Matratze, Lattenrost und abgebildete Dekoration eindeutig auseinanderhalten |
| Varianten | Je Ausführung passende Artikelnummern, Größenangaben und Bilder verwenden |
| Medien und Dokumente | Variantenbilder sowie zutreffende Montage- und Pflegeinformationen zuordnen |
Diese Tabelle ist eine Vorbereitungshilfe. Welche Angaben verbindlich erforderlich sind, ergibt sich aus deiner aktuellen Kategorievorlage und dem vereinbarten Partnerprozess.
So läuft der Start mit shopvibes ab
- Konto und Sortiment festlegen. Stimme Zugang, Kategorie und die zuerst zu testende Produktgruppe ab. Nutze die Zugangsdaten des dafür vorgesehenen Partnerkontos.
- Vorlage und Mapping einrichten. Ordne zentrale Attribute den Zielangaben zu. Prüfe Einheiten und Wertelisten mit einem repräsentativen Artikel.
- Varianten gemeinsam testen. Wähle beispielsweise ein Bett mit zwei Liegeflächen. Kontrolliere, ob jede Ausführung ihre eigenen Maße und Bilder erhält.
- Übertragen und Rückmeldungen bearbeiten. Starte die Listung über die eingerichtete Anbindung. Korrigiere fehlende Produktwerte im Datenstamm und unpassende Zuordnungen im Mapping.
- Ergebnis im Partnerprozess prüfen. Kontrolliere die verarbeiteten Inhalte und den Angebotszustand. Rolle das Sortiment anschließend mit den geprüften Regeln aus.
Beispiel: Ein Bett mit zwei Liegeflächen
Das folgende fiktive interne Datenmodell zeigt, warum Varianteninformationen getrennt bleiben. Es ist keine offizielle home24-Vorlage.
| Artikelnummer | Liegefläche (B × L) | Produktaußenmaß (B × L) | Lieferumfang |
|---|---|---|---|
| DEMO-BED-160-GREY | 160 × 200 cm | 170 × 210 cm | Bettrahmen, ohne Matratze und Lattenrost |
| DEMO-BED-180-GREY | 180 × 200 cm | 190 × 210 cm | Bettrahmen, ohne Matratze und Lattenrost |
Wenn beide Artikel aus einem gemeinsamen Serienfeld „180 cm“ erhalten, ist die Ausgabe für die kleinere Ausführung falsch. Die Korrektur beginnt bei der Quelle des jeweiligen Variantenmaßes. Der home24-Leitfaden zu Maßen und Lieferumfang führt diesen Testfall einschließlich Packstücken und Prüfliste weiter aus.
Wenn bei der Übertragung etwas nicht passt
| Beobachtung | Nächster Prüfpunkt | Wo du ansetzt |
|---|---|---|
| Eine Angabe fehlt | Ist der Wert für diese konkrete Ausführung gepflegt? | Produktstamm ergänzen und Ausgabe erneut prüfen |
| Ein vorhandener Wert wird nicht angenommen | Stimmen Kategorie, Werteliste und Zuordnung? | Aktuelle Vorlage und Mapping vergleichen |
| Bilder zeigen eine andere Größe oder Farbe | Gehört das Medium zum richtigen Artikel? | Variantenbezug und Medienzuordnung korrigieren |
| Technische Übermittlung abgeschlossen, Ergebnis noch unklar | Welche Rückmeldung und welcher Angebotszustand liegen beim Partner vor? | Partnerprozess kontrollieren; keine Veröffentlichung aus dem Übermittlungsstatus ableiten |
Das Vorgehen bei Vorlage, Werten und Mapping erklärt der Mirakl-Leitfaden zur Importdiagnose. Einen gemeinsamen Datenaufbau zeigt die Branchenlösung für Möbel.
Prüfliste vor dem Sortimentsausbau
- Sind Konto, Kategorie und Vorlagenstand eindeutig festgehalten?
- Stimmen Maße, Lieferumfang und Bilder für jede getestete Ausführung?
- Sind notwendige Wertzuordnungen für das Testsortiment geprüft?
- Wurden Rückmeldungen an der richtigen Quelle korrigiert?
- Wurden Inhalt und Angebotszustand beim Partner kontrolliert?
- Ist geklärt, welche späteren Änderungen die Anbindung umfasst?
Eine eingerichtete API-Übertragung ersetzt keine Sortimentsfreigabe. Vertragsbedingungen, Bearbeitungszeiten und kontospezifische Freigaben erhältst du von home24. Die allgemeine Aufbereitung für weitere Partner beschreibt unser Leitfaden zu Händler-Templates.
Quellen und Prüfstand
Stand: 3. November 2026.
