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 Offers in Channable
- Erstellen Sie eine neue Fnac Darty Offers API
- Erstellen Sie Ihre Produktlistings in Channable
- Senden Sie Ihre Produkte zu Fnac Darty
- Überprüfen Sie Ihre Produktlistings auf Fehler
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 Produkt 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 Offers 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 bekannt sind. Wenn Ihre EANs/Produkte neu für Fnac Darty sind, lesen Sie bitte unseren Support-Artikel darüber, wie Sie unbekannte EAN-Codes/Produkte zu Fnac Darty hinzufügen. -
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 Offers in Channable
Um eine Verbindung zu Fnac Darty Offers herzustellen, gehen Sie wie folgt vor:
- Navigieren Sie zu "Verbindungen"
- Klicken Sie auf "+ Verbindung hinzufügen"
- Wählen Sie "FNAC Darty Offers" (nicht "FNAC Darty Products")
- Vergeben Sie ein Label, z.B. "Fnac Darty Offers"
Shop-ID eingeben
- Wenn Sie eine Fnac Darty Offers API erstellen, um Produkte nur auf Fnac zu verkaufen, geben Sie bitte die Fnac Shop-ID ein, die Sie erhalten haben.
- Wenn Sie eine Fnac Darty Offers API erstellen, um Produkte nur auf Darty zu verkaufen, geben Sie bitte die Darty Shop-ID ein, die Sie erhalten haben.
- Wenn Sie Ihre Produkte sowohl auf Fnac als auch auf Darty verkaufen möchten, müssen Sie zwei separate Verbindungen erstellen (eine mit der Fnac Shop-ID und die andere mit der Darty Shop-ID).
Klicken Sie auf die Schaltfläche "Erstellen", um Ihre Verbindung zu speichern.
Schritt 2: Erstellen Sie eine neue Fnac Darty Offers API
Als Nächstes können Sie Ihr Projekt aufrufen und zu APIs > Neue API hinzufügen gehen. Sie können dann die von Ihnen erstellte Verbindung zu Fnac Darty Offers auswählen.
Sie werden dann zu den API-Einstellungen weitergeleitet, wo Sie den Namen Ihrer API und die eigene ID pro Artikel auswählen können.
Optional können Sie eine Masterregel-Gruppe hinzufügen. Klicken Sie dann auf "Weiter", um die neue Fnac Darty Offers API zu erstellen.
Beachten Sie auch hier die zuvor erwähnten Szenarien:
- Um Ihre Produkte auf Fnac zu verkaufen, erstellen Sie bitte eine API unter Verwendung der Verbindung mit der Fnac Shop ID, die Sie in Schritt 1 erstellt haben.
- Um Ihre Produkte auf Darty zu verkaufen, erstellen Sie bitte eine API unter Verwendung der Verbindung mit der Darty Shop ID, die Sie in Schritt 1 erstellt haben.
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.
Schritt 4: Senden Sie Ihre Produkte zu Fnac Darty
Sobald alle Schritte durchgeführt wurden, können Sie Ihre Produktangebote versenden. Folgen Sie den nachstehenden Anweisungen, um Ihre Produktangebote zu versenden:
- Gehen Sie auf der linken Seite des Bildschirms zu Einstellungen > Projekteinstellungen.
- Klicken sie auf "Projekt aktivieren".
- Gehen Sie zurück zu der API Übersicht.
- Gehen Sie zu "Ihre API" > Einstellungen.
- Wählen Sie "API aktivieren" aus, um die API zu aktivieren.
- Navigieren Sie zurück zur API Übersicht und wählen die blaue Schaltfläche "Aktualisieren" aus, um Ihre Produkte zu Fnac Darty zu senden
Schritt 5: Überprüfen Sie Ihre Produktlistings auf Fehler
Wenn Sie Ihre Produktangebote an Fnac Darty gesendet haben, gehen Sie auf die Registerkarte "Resultat > Fehler" Ihrer API. Hier können Sie sehen, welche Produktlistings Fehler haben und noch nicht online sind.
Ein häufiger Fehler in der Fnac Darty Angebots-API ist der Fehler "ERR_026: Product not found". Das bedeutet, dass Ihre Produkte bei Fnac Darty nicht bekannt sind. Um diesen Fehler zu beheben, lesen Sie in diesem Support-Artikel, wie Sie unbekannte EAN-Codes zu Fnac Darty hinzufügen können.
Klicken Sie auf einen bestimmten Fehler, um weitere Informationen über die Fehlerursache zu erhalten.
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.