Möchten Sie interaktiv alle Grundlagen für die Erstellung eines API-Exports erlernen oder wie man ein fortgeschrittenes Setup für eine API in Channable vornimmt? Erfahren Sie in diesem Helpcenter-Artikel, wie Sie ein Channacademy-Konto in der Channable-App erstellen und beginnen Sie mit dem Kurs Basic APIs oder Expert APIs.
Fnac Darty, eine bekannte französische Einzelhandelsgruppe, die aus dem Zusammenschluss von Fnac und Darty hervorgegangen ist, ist auf eine breite Palette von Produkten spezialisiert. Fnac bietet kulturelle und elektronische Artikel wie Bücher, Musik, Filme, Videospiele und Unterhaltungselektronik an, während sich Darty auf Haushaltsgeräte und Unterhaltungselektronik konzentriert.
Inhaltsverzeichnis
- Erklärung zu den Fnac Darty API Verbindungen
- Vorbereitung
- Erstellen Sie eine neue Verbindung zu Fnac Darty Products in Channable
- Erstellen Sie eine neue Fnac Darty-Products API in Channable
- Erstellen Sie Ihre Produktlistings in Channable
- Senden Sie Ihre Produktdaten zu Fnac Darty
- Prüfen Sie Ihre Produktdaten auf Fehler
- Deaktivieren Sie die Fnac Darty Products API
Erklärung zu den Fnac Darty API Verbindungen
Für Fnac Darty gibt es zwei verschiedene Verbindungen und somit separate APIs, die zwischen Ihrem Produktangebot und Ihren Produktinformationen unterscheiden.
-
Die Fnac Darty Offers-Verbindung: Diese API (die eine Bestellsynchronisierung unterstützt) ermöglicht es Ihnen, Produkte zu verkaufen, die Fnac oder Darty bereits bekannt sind, basierend auf EAN-Codes. Wenn Ihre EAN-Codes/Produkte Fnac oder Darty unbekannt sind, zeigt die Fnac Darty Offers API im Schritt "Resultat" einen Fehler mit der Bezeichnung “ERR_026: Product not found” an.
-
Die Fnac Darty Products API Verbindung: Wenn Fnac Darty Ihre EANs/Produkte nicht kennt, müssen Sie deren Daten über die Fnac Darty Products API zur Fnac Darty Datenbank hinzufügen. Diese API ist für die erstmalige Übermittlung Ihrer EANs und für die Aktualisierung der Produktdaten unerlässlich, muss aber nicht regelmäßig aktiviert werden.
In diesem Artikel führen wir Sie durch die Einrichtung einer Products API für die Fnac Darty-Plattform mit Channable.
Vorbereitung
Um eine reibungslose Einrichtung zu gewährleisten und Probleme zu vermeiden, lesen und befolgen Sie bitte diese wichtigen Richtlinien:
-
Bekannte EANs für Fnac Darty:
Diese Anleitung geht davon aus, dass Ihre EANs Fnac Darty nicht bekannt sind. Wenn Ihre EANs/Produkte Fnac Darty bekannt sind, lesen Sie bitte diesen Support-Artikel darüber, wie Sie Ihre bekannten EAN-Codes/Produkte an Fnac Darty senden können. -
Obligatorische EANs:
EAN-Codes sind für Fnac und Darty obligatorisch. Vergewissern Sie sich, dass Sie für alle Ihre Produkte gültige EAN-Codes haben, sonst können keine Produktlistings für Ihre Produkte erstellt werden. -
API-Zugangsdaten:
Um Ihre Produkte auf Fnac Darty zu verkaufen, benötigen Sie ein professionelles Verkäuferkonto. Befolgen Sie die Richtlinien zur Einrichtung eines Kontos hier (auf Französisch unter "Inscription et paramètres de compte"). Sobald Sie sich angemeldet haben, kontaktieren Sie Fnac Darty, um die Shop-ID für Fnac und die Shop-ID für Darty zu erhalten. Speichern Sie diese IDs, da Sie sie im nächsten Schritt benötigen. -
Channable Verbindung:
Sie können über Channable nur eine Verbindung mit Fnac Darty Frankreich herstellen. Verbindungen zu anderen Fnac Darty Ländern werden derzeit nicht unterstützt.
Nachdem Sie alle Vorbereitungspunkte abgeschlossen und überprüft haben, können Sie mit dem ersten Schritt beginnen.
Schritt 1: Erstellen Sie eine neue Verbindung zu Fnac Darty Products in Channable
Die Fnac Darty Products API nutzt die Mirakl Plattform, was bedeutet, dass Sie ein Mirakl Konto benötigen, um Ihre Produktangebote an Fnac zu senden.
Um eine Verbindung zu Fnac Darty Products herzustellen, gehen Sie folgendermaßen vor:
- Navigieren Sie zu "Verbindungen".
- Klicken Sie auf " + Verbindung hinzufügen".
- Wählen Sie "FNAC Darty Products" (nicht "FNAC Darty Offers") aus.
- Geben Sie der Verbindung einen Namen, z.B., "Fnac Darty Products".
Klicken Sie dann auf "Verbinden mit Fnac". 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: Erstellen Sie eine neue Fnac Darty-Products API in Channable
Gehen Sie nun zur API-Übersicht in Ihrem Projekt. Klicken Sie auf "+ Neue API hinzufügen" und wählen Sie die soeben erstellte Fnac Darty Products Verbindung aus.
Sie werden zu den API-Einstellungen weitergeleitet, wo Sie den Namen Ihrer API und die Eigene ID pro Item (wir empfehlen das Feld "id") sowie das Land Frankreich auswählen können.
Wenn Sie möchten, können Sie hier auch eine Masterregel-Gruppe hinzufügen. Klicken Sie auf "Weiter", um die Erstellung der neuen Fnac Darty Products API abzuschließen.
Schritt 3: Erstellen Sie Ihre Produktlistings in Channable
Um Ihre API einzurichten, folgen Sie bitte den unten aufgeführten Schritten. Klicken Sie auf jeden Schritt, um die detaillierten Anweisungen anzuzeigen, die Sie durch den gesamten Prozess führen.
1. Kategorisierung
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 manuell neue Kategorien erstellen.
- Smart Categorization: Diese Funktion ordnet Ihren Produkten automatisch Kategorien auf der Grundlage vordefinierter Kriterien zu und vereinfacht so den Kategorisierungsprozess.
- Manuelle Kategorisierung: Weisen Sie Ihren Produkten manuell Kategorien zu, indem Sie bestimmte Regeln festlegen. Sie können detaillierte Filter erstellen, um jedes Produkt der richtigen Kategorie zuzuordnen.
- Nicht kategorisierte Items: Überprüfen und kategorisieren Sie alle Artikel, die nicht kategorisiert sind, um sicherzustellen, dass alle Produkte ordnungsgemäß kategorisiert sind.
Klicken Sie hier, um mehr über den Schritt "Kategorien" zu erfahren.
2. Regeln
Erstellen Sie verschiedene Regeln zur Optimierung Ihrer Produktdaten. Beispiele finden Sie in unserem Artikel zu häufig benutzten Regeln.
- Regeln einrichten: Richten Sie verschiedene Regeln ein, um Ihre Produktdaten zu verfeinern. Dazu kann das Filtern, Ändern oder Erweitern von Datenfeldern gehören, um den Anforderungen des Marktes gerecht zu werden.
3. Schritt "Aufbau"
Der Schritt "Aufbau" in Channable ermöglicht es Ihnen, alle notwendigen Attribute für Ihre Artikel zu konfigurieren, um sicherzustellen, dass Ihre Produktdaten mit den Anforderungen des Marktplatzes übereinstimmen. Dieser Schritt ist entscheidend für erfolgreiche Produktlistings und die Vermeidung von Fehlermeldungen.
3.1 Überblick
- Gehen Sie zum Aufbau-Schritt: Gehen Sie zunächst zur zentralen Benutzeroberfläche des Aufbau-Schrittes. Hier werden Sie alle Produktattribute verwalten und zuordnen.
- Identifizieren Sie obligatorische und optionale Felder: Obligatorische Felder sind pink markiert und zeigen an, dass sie für die Auflistung Ihrer Produkte zwingend erforderlich sind. Optionale Felder sind orange markiert und können je nach Bedarf ausgefüllt werden.
3.2 Gemeinsame Attribute
-
Füllen Sie die geminsamen Attribute aus: Geben Sie allgemeine Informationen ein, die für alle Produkte gelten, z. B. EAN, Preise und Titel. Dieser Schritt gewährleistet die Einheitlichkeit der grundlegenden Produktinformationen in Ihren Angeboten.
-
Benutzen Sie statische oder dynamische Werte:
- Statische Werte: Geben Sie Werte ein, die konstant bleiben, wie Markennamen oder Hersteller.
- Dynamische Werte: Verwenden Sie Felder, die automatisch auf der Grundlage verknüpfter Daten aktualisiert werden, ideal für Variablen wie Lagerbestände oder Preis.
-
Benutzen Sie statische oder dynamische Werte:
Nachdem Sie die gewünschten Werte für die gemeinsamen Attribute eingegeben haben, fahren Sie, wie unten beschrieben, mit den kategoriespezifischen Attributen fort.
3.3 Attribute pro Kategorie
- Wählen Sie eine Produktkategorie: Wählen Sie die entsprechende Kategorie für Ihr Produkt, z. B. Kleidung oder Möbel.
- Kategoriespezifische Attribute: Geben Sie Attribute ein, die für die ausgewählte Kategorie spezifisch sind, z. B. die Größe für Kleidung oder die Abmessungen für Möbel. Dieser Schritt hilft bei der Feinabstimmung Ihrer Angebote entsprechend den Anforderungen der Kategorie. Auch hier können Sie statische oder dynamische Werte verwenden.
Klicken Sie hier, um mehr über den Schritt "Aufbau" zu erfahren.
4. Schritt "Qualität"
Der Schritt "Qualität" liefert sofortige Rückmeldung über die Einrichtungsqualität und weist auf obligatorische und optionale Fehler hin, um sicherzustellen, dass Ihre Produktdaten den Standards der Marktplätze entsprechen.
Aktionen
- Artikel anzeigen: Sehen Sie sich die Produkte mit dem spezifischen Problem an.
- Im Aufbau-Schritt anzeigen: Leitet Sie zum Schritt "Aufbau" weiter, wo Sie ein Feld zuordnen können, um die fehlenden Informationen hinzuzufügen.
- Kategorien anlegen: Leitet Sie zum Schritt "Kategorien", wo Sie die fehlende Kategorie anlegen können.
- Quelle: Diese Option ist nur für das ID-Feld verfügbar und leitet Sie zum Schritt "Einstellungen" weiter.
Klicken Sie hier, um mehr über den Schritt "Qualität" zu erfahren.
5. Schritt "Vorschau"
Der Schritt "Vorschau" zeigt die zugeordneten Attribute für mehrere Artikel und Detailansichten für einzelne Artikel an und weist auf Fehler hin, bevor der Export auf den Marktplatz erfolgt.
Features
- Such- & Filterleiste: Suchen Sie nach bestimmten Produkten oder filtern Sie nach Fehlermeldung/Kategorie.
- Artikelübersicht: Zeigt alle zu exportierenden Artikel an; es kann gefiltert werden, um nur Artikel mit Fehlern anzuzeigen.
- Detaillierte Produktvorschau: Zeigt fehlende Informationen und dynamische Aktionen zur Fehlerbehebung an.
Checkliste zur Fertigstellung von Attributen
- Überprüfen Sie die gemeinsamen Attribute: Stellen Sie sicher, dass alle obligatorischen gemeinsamen Attribute korrekt ausgefüllt sind.
- Überprüfen Sie die kategoriespezifischen Attribute: Stellen Sie sicher, dass alle obligatorischen kategoriespezifischen Attribute korrekt ausgefüllt sind.
- Suchen Sie nach Fehlern: Suchen Sie nach rot markierten Feldern und korrigieren Sie diese.
Klicken Sie hier, um mehr über den Schritt "Vorschau" zu erfahren.
6. Schritt "Resultat"
Die Registerkarte "Resultat" bietet einen Überblick über die Ergebnisse Ihrer API-Einrichtung, einschließlich erfolgreicher Übertragungen, Fehler und eine Vorschau der Produkte, die gelistet werden sollen. Diese Registerkarte stellt sicher, dass Ihre Produktdaten korrekt verarbeitet werden und identifiziert alle Probleme, die gelöst werden müssen.
- Überblick: In diesem Schritt wird der Status Ihrer Produktangebote angezeigt, wobei Fehler und Probleme hervorgehoben werden, um detaillierte Einblicke zu erhalten.
- Vorschau der Produkte: Zeigt eine Übersicht der Produkte an, die an den Marktplatz gesendet werden sollen, so dass überprüft werden kann, ob die Attribute korrekt ausgefüllt wurden.
- Erfolgreich: Listet Produkte auf, die erfolgreich verarbeitet wurden und für eine Listung bereit sind, d.h. die den Anforderungen des Marktplatzes entsprechen.
- Fehler: Identifiziert Fehler während der Verarbeitung und liefert detaillierte Informationen zur Fehlerbehebung und Problemlösung.
Optionale Registerkarten, wie z. B. Fehler beim Repricer, Historie der Repricer-Ereignisse, Bestandsaktualisierungen und Fulfillment-Aktualisierungen werden nur angezeigt, wenn sie für die von Ihnen verwendete API relevant sind.
Klicken Sie hier, um mehr über den Schritt "Resultat" zu erfahren.
Zusätzliche Informationen für Fnac Darty Products
Für die Products API müssen Sie im Schritt "Aufbau" nur das EAN-Feld auswählen. Wenn Sie das richtige EAN-Feld ausgewählt haben, klicken Sie unten auf dem Bildschirm auf "Speichern".
Schritt 4: Senden Sie Ihre Produktdaten zu Fnac Darty
Sobald alle Schritte abgeschlossen sind, können Sie Ihre Produktangebote versenden. Folgen Sie den folgenden Anweisungen, um Ihre Produktangebote zu versenden:
- Gehen Sie zu Einstellungen > Projekteinstellungen auf der linken Seite des Bildschirms.
- Klicken Sie auf "Projekt aktivieren".
- Gehen Sie zurück zur API-Übersicht
- Gehen Sie zu “Ihre Fnac Darty API” > Einstellungen.
- Klicken Sie auf “API aktivieren”, um die API zu aktivieren.
- Gehen Sie zurück zur API-Übersicht und wählen Sie die blaue Schaltfläche "Aktualisieren", um Ihre Produktangebote an Fnac Darty zu senden.
Schritt 5: Prüfen Sie Ihre Produktdaten auf Fehler
Wenn Sie Ihre Produktdaten an Fnac Darty gesendet haben, gehen Sie auf die Registerkarte Vorschau Ihrer Fnac Darty-Products-API. Klicken Sie auf "Fehler". Jetzt können Sie sehen, welche Produktlistings Fehler aufweisen und nicht gelistet sind. Klicken Sie auf einen bestimmten Fehler, um weitere Informationen darüber zu erhalten, was den Fehler verursacht.
In manchen Fällen kann es vorkommen, dass die Produkt API keine Produkte auf Mirakl anlegt und wir keine Fehlermeldungen dazu erhalten. Wenn dies der Fall ist, gibt es zwei Möglichkeiten, einen detaillierten Fehlerbericht zu erhalten:
So laden Sie den Fehlerbericht über die Fnac-Plattform herunter
- Navigieren Sie zur Fnac-Plattform und gehen Sie zu "My Inventory> Import from File".
- Wählen Sie "Track Product Imports" aus.
- Laden Sie den/die Fehlerbericht(e) auf der rechten Seite des Bildschirms herunter.
So laden Sie den Fehlerreport in Fnac Darty Mirakl herunter:
- Loggen Sie sich in Ihr Mirakl-Konto ein und navigieren Sie zu "Catalog > Product Imports".
- Im Abschnitt "Product Imports" finden Sie eine Liste der von Channable durchgeführten Importe mit den entsprechenden Zeitstempeln.
- Klicken Sie auf die Schaltfläche "See details" für den neuesten Import, um die aktuellsten Fehlerdetails anzuzeigen.
- Wählen Sie aus den angezeigten Optionen "Non-integrated products report". Dadurch wird der Fehlerbericht automatisch heruntergeladen. In diesem Artikel wird noch genauer erklärt, wie Sie den Mirakl-Fehlerbericht abrufen können.
Wenn Sie diese Schritte befolgen, können Sie Probleme mit Ihren Produktangeboten auf der/den Fnac Darty-Plattform(en) effizient nachvollziehen und beheben.
Schritt 6: Deaktivieren Sie die Fnac Darty Products API
Wie bereits erwähnt, muss die Fnac Darty Products API nur für die erstmalige Übermittlung der EAN und für Aktualisierungen des Inhalts aktiv sein.
- Sehen Sie sich den Schritt "Resultat"der Fnac Darty Offers API an. Für weitere Informationen über die Fnac Darty Offers API lesen Sie diesen Artikel.
- Wenn Sie den Fehler “ERR_026: Product not found” sehen, aktivieren Sie die Fnac Darty Products API.
Wenn der Fehler im Schritt "Resultat" nicht auftritt, deaktivieren Sie die Fnac Darty Products API.
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.