Eine Kruidvat API einrichten

In diesem Artikel erklären wir, wie man die Kruidvat-API in Channable einrichtet. Kruidvat ist eine Drogeriemarktkette in den Niederlanden und Belgien. Sie richten die Kruidvat-API ein, indem Sie die folgenden Schritte in diesem Artikel befolgen:

Schritt 1: Eine neue Kruidvat Verbindung hinzufügen
Schritt 2: Eine neue Kruidvat-API in Channable hinzufügen
Schritt 3: Erstellen Sie Ihr Produktangebote in Channable
Schritt 4: Senden Sie Ihre Produkte zu Kruidvat
Schritt 5: Überprüfen Sie Ihre Produktangebote auf Fehler

Schritt 1: Eine neue Kruidvat Verbindung hinzufügen

Die Kruidvat API nutzt die Mirakl-Plattform, d.h. Sie benötigen ein Mirakl-Konto, um Ihre Produktangebote an Kruidvat zu senden.

Wenn Sie ein Mirakl Kruidvat Konto haben, loggen Sie sich ein und navigieren Sie zu "[Ihr Unternehmen] Einstellungen (oben rechts) > Verbindungen". Klicken Sie auf "+ Verbindung hinzufügen" und Sie gelangen zu einem Bildschirm, auf dem Sie Kruidvat auswählen können. Geben Sie ein Label für Ihre Verbindung ein, zum Beispiel: "Kruidvat". Klicken Sie dann auf "Verbinden mit Kruidvat". Sie werden zu einer Umgebung weitergeleitet, in der Sie sich mit Ihren Mirakl-Zugangsdaten anmelden können. Nach dem Einloggen werden Sie zurück zu Channable weitergeleitet, wo die Verbindung verfügbar sein wird.

Schritt 2: Eine neue Kruidvat-API in Channable hinzufügen

Gehen Sie nun zur API-Übersicht in Ihrem Projekt. Klicken Sie auf "Neue API hinzufügen", wählen Sie die gerade erstellte Kruidvat-Verbindung aus und geben Sie Ihrer neuen API einen Namen.

Wählen Sie das Feld, welches Sie als eigene ID pro Item verwenden möchten (wir empfehlen das Feld "id") und die Sprache, in der Sie Kategorisierungen vornehmen und Attribute einrichten. Sie können hier auch eine Masterregelgruppe hinzufügen, wenn Sie möchten. Klicken Sie auf "Weiter", um die Erstellung der neuen Kruidvat API abzuschließen.

Schritt 3: Erstellen Sie Ihr Produktangebote in Channable

Sobald Sie die Kruidvat 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 von Grund auf.
   
   
2. Regeln
   Erstellen Sie verschiedene Regeln zur Optimierung Ihrer Produktdaten. In unserem Artikel häufig genutzter Regeln finden Sie einige Beispiele.
   
   
3. Aufbau
   Hier finden Sie unsere voreingestellte Vorlage für die Produktangebote. Sie müssen sie nur noch ausfüllen, indem Sie auf das Feld selbst klicken und auswählen, was Sie dort eintragen möchten. Das Feld "Preis" sollte zum Beispiel 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 den Mauszeiger über das Fragezeichen bewegen, sehen Sie die Beschreibung des Feldes und Vorschläge für mögliche Werte.
   
4. Attribute
   Fast fertig! Als Nächstes müssen Sie die Felder im Schritt "Attribute" ausfüllen. Wählen Sie zunächst die Kategorie aus, die Sie optimieren möchten. Ein Beispiel dafür, was Sie jetzt vor sich haben sollten, sehen Sie auf dem folgenden Screenshot. Eine detailliertere Erklärung, was im Schritt "Attribute" zu tun ist, finden Sie in unserem Support-Artikel zu Attributen.

Schritt 4: Senden Sie Ihre Produkte zu Kruidvat

Sie haben es fast geschafft: Ihre Produktangebote sind bereit zum Senden. Wenn Sie Ihr Projekt noch nicht aktiviert haben, gehen Sie auf Setup > Projekteinstellungen auf der linken Seite des Bildschirms und klicken Sie auf "Projekt aktivieren". Danach gehen Sie zurück zur API-Übersicht und gehen Sie zu "Ihr Kruidvat API-Name" > Einstellungen, wo Sie die API aktivieren, indem Sie "API aktivieren" wählen. Nachdem Sie diesen Schritt abgeschlossen haben, gehen Sie zurück zur API-Übersicht und wählen Sie die blaue Schaltfläche "Aktualisieren", um Ihre Produktangebote an Kruidvat zu senden.

Schritt 5: Überprüfen Sie Ihre Produktangebote auf Fehler

Nachdem Sie Ihre Produktangebote an Kruidvat gesendet haben, gehen Sie auf die Registerkarte Resultat Ihrer Kruidvat API. Klicken Sie im Filter auf 'Fehler'. Jetzt können Sie sehen, welche Produktangebote Fehler aufweisen und nicht platziert werden. Klicken Sie auf einen bestimmten Fehler, um mehr Informationen über die Ursache des Fehlers zu erhalten. Wenn Sie einige Fehler durch Änderung der Einstellungen oder der Produktinformation behoben haben, führen Sie die Kruidvat API erneut aus, um die neuen Ergebnisse zu sehen.