Eine Home24 API einrichten

Home24 ist ein Online-Händler für Möbel und Wohnaccessoires, der hauptsächlich in Europa und Lateinamerika tätig ist. Das Unternehmen bietet eine breite Palette von Heimprodukten an, darunter Möbel, Wohnaccessoires und Gartenartikel. Dies ist eine Anleitung, wie Sie einen Home24-Marktplatz mit einer API in Channable einrichten können.

Vorbereitung

• Die Home24 API ist in der Lage, sich mit dem deutschen, österreichischen, schweizerischen und französischen Markt zu verbinden.
• Home24 ist eine Mirakl-basierte Plattform, d.h. Sie benötigen ein Mirakl-Konto, um Ihre Produkteinträge an Home24 zu senden.
• EAN-Codes sind für Home24 obligatorisch. Stellen Sie sicher, dass Sie gültige EAN-Codes für alle Ihre Produkte haben, sonst können keine Produkteinträge für Ihre Produkte erstellt werden.

Schritt 1: Erstellen Sie die Verbindung

1. Navigieren Sie zunächst zur API-Seite in Ihrem Projekt und klicken Sie auf die Schaltfläche " +Neue API hinzufügen". Diese Aktion leitet Sie auf die Seite mit den Verbindungen Ihres Unternehmens weiter.
2. Wählen Sie auf dieser Seite "+Verbindung hinzufügen".
3. Suchen Sie in der Suchleiste nach der Verbindung "Home24". Nachdem Sie die Verbindung "Home24" gefunden haben, geben Sie ein Label für diese neue Verbindung ein.
4. Klicken Sie auf "Verbinden mit Home24". Sie werden für den nächsten Schritt zu Home24/Mirakl weitergeleitet. Nach der Weiterleitung melden Sie sich mit Ihren Mirakl-Zugangsdaten an.

Nach erfolgreicher Anmeldung ist die Verbindung zu Home24 nun hergestellt und kann genutzt werden! Sie werden zurück zur API-Einrichtung geleitet.

Schritt 2: Erstellen Sie die API

Sobald Sie zurück sind, müssen Sie Ihre neue Verbindung mit Home24 auswählen und mit der Einrichtung Ihrer API fortfahren.

• Geben Sie Ihrer API einen Namen.
• Wählen Sie das Feld, das Sie für "Eigene ID pro Artikel" verwenden möchten (wir empfehlen das Feld "id") und die "Sprache", in der Sie verkaufen möchten.
• Wenn Sie möchten, können Sie hier auch eine Masterregelgruppe hinzufügen.

Klicken Sie auf "Weiter", um die Erstellung der neuen Home24-API abzuschließen.

Schritt 3: Richten Sie die API ein

Sobald Sie die Home24 API erstellt haben, können Sie Ihre Produktdaten einrichten, indem Sie den Schritten der API folgen.

1. Kategorien
   Damit Ihre Produktdaten erstellt werden können, benötigen Ihre Produkte eine Kategorie. Fügen Sie Ihren Produkten Kategorien hinzu, indem Sie die Funktion "Kategorien generieren" verwenden, oder erstellen Sie neue Kategorien manuell. Sie können auch die Smart Categorization-Funktion ausprobieren, um die Kategorisierung Ihrer Produkte noch einfacher zu machen.
   
   
2. Regeln
   Erstellen Sie verschiedene Regeln, um Ihre Produktdaten zu optimieren. Werfen Sie einen Blick auf unseren Artikel zu häufig benutzen Regeln für einige Beispiele hierzu.
   
   
3. Aufbau
   Hier finden Sie unsere voreingestellte Vorlage für die Produktangebote. Diese können Sie ausfüllen, indem Sie auf das Feld selbst klicken und auswählen, mit welchem internen Feld Sie es verknüpfen möchten. Zum Beispiel soll das Feld "Preis" den Preis Ihres Produkts anzeigen und so weiter. Wenn Sie mit dem Einrichten der Produktangebote fertig sind, klicken Sie einfach auf "Speichern" am unteren Rand des Bildschirms.
   
   
   Tipp! Beachten Sie das Fragezeichen hinter jedem Feld. Wenn Sie mit der Maus über das Fragezeichen fahren, sehen Sie die Beschreibung des Feldes und Vorschläge für mögliche Werte.
   
   Ökobeteiligung
   Frankreich hat eine Gesetzgebung zur Öko-Beteiligung eingeführt. Wenn Ihr Unternehmen in Frankreich tätig ist, sind Sie verpflichtet, Ihre Angebote auf dem Markt mit Umweltbeiträgen zu versehen. Ein Öko-Beitrag, auch Umweltbeitrag genannt, ist ein Betrag, der auf den Preis eines Produkts aufgeschlagen wird, um die mit der Herstellung, dem Vertrieb oder der Entsorgung verbundenen Umweltauswirkungen zu kompensieren.
   
   Ein Öko-Beitrag besteht aus drei Teilen: EPR-Kategorie-Code, Hersteller-ID und Betrag. In diesem Abschnitt finden Sie eine Liste der verfügbaren EPR-Kategorien.
   Hinweis: Befindet sich hinter dem Label des Feldes ein Stern (*), ist es obligatorisch und muss ausgefüllt werden.
   4. Attribute

   Fast fertig! Als nächstes müssen Sie die Felder im Schritt "Attribute" ausfüllen. Eine detaillierte Erklärung, was in diesem Schritt zu tun ist, finden Sie in unserem Artikel zu Attributen.

   Schritt 4: Aktivieren Sie die API und prüfen Sie Ihre Produktangebote auf Fehler

   Fast fertig! Ihre Produktangebote sind bereit zum Versenden. Wenn Sie Ihr Projekt noch nicht aktiviert haben, navigieren Sie auf der linken Seite des Bildschirms zu Setup > Projekteinstellungen und klicken Sie auf "Projekt aktivieren".

   Danach gehen Sie zurück zur API-Übersicht und navigieren zu "[Ihre Home24 API-Name] > Einstellungen", wo Sie die API aktivieren, indem Sie "API aktivieren" wählen.

   Nachdem Sie diesen Schritt abgeschlossen haben, navigieren Sie zurück zur API-Übersicht und wählen den blauen "Aktualisieren"-Button, um Ihre Produktangebote an Home24 zu senden.

   Nachdem Sie Ihre Produktangebote an Home24 gesendet haben, gehen Sie zum Reiter "Resultat" Ihrer Home24 API. Klicken Sie hier auf "Fehler". Nun können Sie sehen, welche Produktangebote Fehler haben und nicht platziert werden. Klicken Sie auf einen bestimmten Fehler, um weitere Informationen über die Fehlerursache zu erhalten. Weitere Informationen zu möglichen Fehlern finden Sie in diesem Artikel.

   Wenn Sie einige Fehler durch Ändern der Einstellungen oder Produktinformationen behoben haben, führen Sie die Home24 API erneut aus, um die neuen Ergebnisse zu sehen.

Best Practices

Hinzufügen mehrerer Attributwerte: Wenn Sie mehrere Werte in ein Attributfeld für Mirakl Marketplaces eingeben, trennen Sie jeden Wert mit dem Pipe-Zeichen "|", um eine korrekte Erkennung und Verarbeitung sicherzustellen. 

Weitere Informationen zu Mirakl Marketplace Fehlern, Anleitungen und Best Practices finden Sie in unserem entsprechenden Artikel. Klicken Sie hier, um mehr zu lesen.