Eine Carrefour Spain API einrichten – Help Center - Channable

Möchten Sie interaktiv lernen, wie man einen API-Export erstellt oder wie man ein fortgeschrittenes Setup für eine API in Channable aufsetzt? In diesem Helpcenter Artikel erfahren Sie, wie Sie ein Channacademy-Konto in der Channable-App erstellen und mit dem Kurs Basic APIs oder Expert APIs beginnen.

Hinweis I:EAN-Codes sind für Carrefour obligatorisch. Stellen Sie sicher, dass Sie für alle Ihre Produkte gültige EAN-Codes haben, sonst können für Ihre Produkte keine Produktlistings erstellt werden.

Hinweis II: Über Channable können Sie eine Verbindung mit Carrefour Spanien und Frankreich herstellen, nicht mit anderen Ländern. Weitere Informationen zum Einrichten einer Carrefour France API finden Sie in diesem Helpcenter-Artikel.

Schritt 1: Fügen Sie eine Carrefour Spain Verbindung hinzu

Die Carrefour Spain-API verwendet die Mirakl-Plattform, was bedeutet, dass Sie einen Mirakl-Account benötigen, um Ihre Produktlistings an Carrefour zu senden.

Wenn Sie ein Mirakl Carrefour Konto haben, loggen Sie sich ein und navigieren Sie zu "[Ihr Unternehmen] Einstellungen (oben rechts) > Verbindungen > Verbindung hinzufügen". Klicken Sie auf "+ Verbindung hinzufügen" und Sie gelangen zu einem Bildschirm, auf dem Sie Carrefour auswählen können. Geben Sie ein Label für Ihre Verbindung ein, zum Beispiel: "Carrefour". Klicken Sie dann auf "Verbinden mit Carrefour". 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: Fügen Sie eine neue Carrefour-API in Channable hinzu

Gehen Sie nun zur API-Übersicht in Ihrem Projekt. Klicken Sie auf "+ Neue API hinzufügen", wählen Sie die soeben erstellte Carrefour-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 das Land, in dem Sie verkaufen möchten. Sie können hier auch eine Masterregelgruppe hinzufügen, wenn Sie möchten. Klicken Sie auf "Weiter", um die Erstellung der neuen Carrefour-API abzuschließen.

Schritt 3: Erstellen Sie Ihre Produktlistings in Channable

Nachdem Sie die Carrefour-API erstellt haben, können Sie Ihre Produktdaten einrichten, indem Sie den Schritten der API folgen.

Kategorien
Damit Ihre Produktlistings 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 Kategorien von Grund auf neu erstellen.
Regeln
Erstellen Sie verschiedene Regeln, um Ihre Produktlistings zu optimieren. Beispiele finden Sie in unserem Artikel über häufig benutzte Regeln.
Aufbau
Hier finden Sie unsere voreingestellte Vorlage für die Produktlistings. Diese können Sie ausfüllen, indem Sie einen passenden Inhalt auswählen. Beispielsweise sollte das Feld "Preis" den Preis Ihres Produkts anzeigen und so weiter. Wenn Sie die Einrichtung der Produktlistings abgeschlossen haben, klicken Sie einfach auf "Speichern" am unteren Bildschirmrand.
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.

Hinweis:Carrefour fragt nach der Versandklasse (Logistikkategorie) der Produkte in Abhängigkeit von ihrem Gewicht. Sie können die Logistikkategorie zu Ihren Produkten hinzufügen, indem Sie die Angaben in dieser Tabelle befolgen:

Um sie hinzuzufügen, erstellen Sie ein neues Feld im Import-Mapping und verwenden eine Regel, um die Versandklasse hinzuzufügen, die Ihren Produkten in Abhängigkeit von ihrem Gewicht entspricht.

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.
Attribute
Fast geschafft! Als nächstes werden die Felder im Schritt Attribute ausgefüllt. Wählen Sie zunächst die Kategorie aus, die Sie optimieren möchten. Ein Beispiel dessen, was Sie jetzt vor sich haben sollten, können Sie dem Screenshot unten entnehmen. Eine genauere Erklärung, was im Schritt Attribute zu tun ist, finden Sie in unserem Attribute-Support-Artikel.

Schritt 4: Senden Sie Ihre Produktdaten an Carrefour

Fast fertig, Ihre Produktangebote sind zum Senden bereit. Wenn Sie Ihr Projekt nicht aktiviert haben, gehen Sie auf der linken Seite des Bildschirms in die Einstellungen und klicken Sie auf "Projekt aktivieren". Danach gehen Sie zurück zur API-Übersicht und zu "Ihr Carrefour API-Name" > Einstellungen. Hier aktivieren Sie die API, indem Sie "API aktivieren" wählen. Nachdem Sie diesen Schritt abgeschlossen haben, gehen Sie zurück zur API-Übersicht und wählen den blauen "Aktualisieren"-Button, um Ihre Produktangebote an Carrefour zu senden.

Hinweis: Verkäufer können jetzt ihre neuen Produkte über die Carrefour-API für Spanien übermitteln, ohne eine manuelle CSV-Vorlage an Carrefour senden zu müssen. Carrefour verlangt jedoch immer, dass jeder Verkäufer, der neue Produkte registrieren möchte, eine Kopie seines Feeds im Excel-Format zur Überprüfung sendet, da Carrefour alle neuen Artikel, die auf Carrefour.es eingestellt werden sollen, überprüfen und validieren muss.

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

Wenn Sie Ihre Produktangebote an Carrefour geschickt haben, gehen Sie zur Registerkarte Vorschau Ihrer Carrefour API. Klicken Sie beim Filter auf 'Fehler'. Jetzt können Sie sehen, welche Produktangebote fehlerhaft sind und nicht erstellt werden.

Hinweis: In Carrefour ist es nicht möglich Produkte in Ihrem Konto zu entfernen, sondern nur auf Lager 0 zu setzen (was das Produkt auf der Plattform deaktiviert). Wenn Sie also aus irgendeinem Grund Produkte von Carrefour entfernen möchten, müssen Sie diese einfach erneut senden, aber mit Lagerbestand 0.

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.

Die Produkt-ID des Verkäufers für einzelne/einfache Produkte: Bitte beachten Sie, dass es zwei Attribute mit den Bezeichnungen „SellerArticleId“ und „SellerProductId“ gibt. SellerProductId“ bezieht sich auf die übergeordnete ID, während sich ‚SellerArticleId‘ auf die Variantenartikel bezieht. Bei Einzelprodukten ohne Varianten müssen beide Attribute mit demselben Wert gefüllt werden.

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