Einrichten einer Winkelstraat.nl-API

Dieser Artikel erklärt Schritt für Schritt, wie Sie eine Winkelstraat-API einrichten können. 

Schritt 1: Anfordern der Winkelstraat.nl-API-Anmeldeinformationen

Für Winkelstraat benötigen Sie eine Client-ID und einen Secret Key, um eine gültige API-Verbindung herzustellen. Um diese Anmeldeinformationen zu erhalten, müssen Sie sie per E-Mail an contentapi@winkelstraat.nl anfordern.

Wenn Sie die Anmeldeinformationen von Winkelstraat erhalten haben, können Sie die API-Verbindung in Channable erstellen.

Schritt 2: Erstellen einer Winkelstraat.nl-API-Verbindung in Channable

Um eine neue Winkelstraat-Verbindung zu erstellen, öffnen Sie das Projekt in Channable, in welchem Sie arbeiten, und navigieren Sie zur Registerkarte APIs. Klicken Sie auf "+ Neue API hinzufügen" und dann auf "+ Neue Verbindung hinzufügen". Sie können nun Winkelstraat auswählen:

Nachdem Sie Winkelstraat ausgewählt haben, geben Sie der Verbindung einen Namen und tragen Ihre Client-ID und Ihren Secret Key in den vorgesehenen Feldern ein:

Klicken Sie nun auf "Mit Winkelstraat.nl verbinden" und die Verbindung wird validiert und erstellt. Sie können nun mit dem Einrichten Ihrer Produktlistings beginnen.

Schritt 3: Erstellen Sie Ihre Produktlistings in Channable

Führen Sie die folgenden vier Schritte aus, um Ihre Produktlistings für Winkelstraat.nl zu konfigurieren.

1. Kategorien
   Richten Sie Winkelstraat-Kategorien für Ihre Produkte ein, indem Sie die Funktion "Kategorien generieren" verwenden oder neue Kategorien von Grund auf erstellen.
2. Regeln
   Erstellen Sie verschiedene Regeln, um Ihre Produktdaten zu optimieren. Beispiele finden Sie in unserem Artikel zur Unterstützung allgemeiner Regeln.
3. Aufbau
   Im Aufbau Schritt finden Sie unsere voreingestellte Vorlage für die Produktlistings. Sie müssen diese lediglich ausfüllen, indem Sie auf das Feld klicken und den entsprechenden Wert auswählen. Zum Beispiel soll das Feld "Name" den "Titel" Ihres Produkts anzeigen und so weiter. 
   
   Hinweis: Das Feld Item Group ID muss ausgefüllt werden. Normalerweise heißt das Feld, das Sie hier verwenden können, 'item_group_id' oder 'parent_id'.
   
4. Attribute
   Als Nächstes müssen Sie im Schritt "Attribute" die Attribute pro Kategorie ausfüllen. Hier müssen zumindest die obligatorischen Attribute ausgefüllt werden. Diese werden rot angezeigt, wenn sie leer oder mit einem ungültigen Wert gefüllt sind.

   Eine genauere Erklärung, was im Schritt "Attribute" zu tun ist, finden Sie in unserem Support-Artikel "Attribute".

   Hinweis: Im Moment ist das EAN-Feld nicht zwingend erforderlich, damit Ihre Artikel von Winkelstraat akzeptiert werden, es ist jedoch dringend empfohlen, es trotzdem hinzuzufügen.
   Hinweis II: Die Bilder und die Beschreibung müssen ebenfalls in den Attributen hinzugefügt werden. Auch wenn sie nicht als rote Felder angezeigt werden, wenn sie leer sind, sind sie jedoch trotzdem obligatorisch.

Schritt 4: Senden Sie Ihre Produktlistings an Winkelstraat.nl

Sobald Sie die Konfiguration Ihrer Produktlistings abgeschlossen haben, können Sie beginnen, Ihre Listings an Winkelstraat.nl zu senden. Wenn Sie das Projekt noch nicht aktiviert haben, navigieren Sie zu "Setup> Projekteinstellungen" und aktivieren Sie das Projekt. Gehen Sie dann zurück zur Registerkarte "APIs", gehen Sie zu den Einstellungen Ihrer Winkelstraat-API und aktivieren Sie hier die API. Wenn Sie in der API-Übersicht auf "Jetzt ausführen" klicken, werden Ihre Produkte an Winkelstraat.nl gesendet!

Hinweis: Bei Winkelstraat ist es nicht möglich, Produkte aus Ihrem Konto zu entfernen, sondern nur auf stock=0 zu setzen, wodurch das Produkt auf der Plattform inaktiviert wird. Wenn Sie also aus irgendeinem Grund Ihre Produkte von Winkelstraat eliminieren möchten, müssen Sie die Produkte einfach erneut senden, jedoch mit Bestand=0.

Schritt 5: Prüfen Sie Ihre Produkte in Resultate

Sobald die API aktualisiert wurde, können Sie die Ergebnisse im Schritt "Resultat" Ihrer Winkelstraat-API überprüfen. Sie sehen, wie viele Artikel erfolgreich versendet wurden und ob Fehler aufgetreten sind. Die Elemente mit einem Fehler wurden nicht an Winkelstraat übermittelt.  Klicken Sie auf einen Fehler, um zu sehen, was die Fehlermeldung ist und welche Produkte diesen Fehler haben.

Sie können versuchen, die Fehler zu beheben, indem Sie die Produktdaten, die Sie an Winkelstraat senden, in den Kategorien, Regeln, Aufbau und Attribute-Schritten weiter optimieren oder ändern. Führen Sie nach der Optimierung die API erneut aus und prüfen Sie die Ergebnisse.