- Feed einrichten (Produktdaten)
- Die API einrichten (Angebotsdaten)
- Häufige Fehler bei der Kaufland API
Dieser Artikel wird Ihnen helfen, Ihre Produkte auf Kaufland.de zu platzieren. Bitte stellen Sie sicher, dass die offiziellen EAN (GTIN) Codes für Ihre Produkte vorliegen. Ohne diese Codes können Ihre Produkte nicht bei Kaufland.de gelistet werden.
Kaufland unterscheidet zwischen Angebots- und Produktdaten:
- Produktdaten (Feed) : z. B. Titel, EAN, Bild, Beschreibung
- Angebotsdaten (API): z. B. Preis, Lieferzeit
In Channable werden die Produktdaten über einen Feed gesendet, während die Angebotsdaten direkt über eine API an Kaufland.de gesendet werden. Kaufland.de kann Angebotsdaten erst anlegen, wenn sie EAN-Codes erhalten haben. Wir empfehlen daher, zuerst die Inhaltsdaten (über den Channable-Feed) und dann die Angebotsdaten (über die Channable-API) zu senden.
1. Feed einrichten (Produktdaten)
1.1 Fügen Sie Kaufland als Feed in Channable hinzu
Klicken Sie hierzu in Channable in der linken Menüleiste auf Feeds. Klicken Sie anschließend auf Feed hinzufügen und wählen Sie Kaufland.de aus. Nachdem Sie auf Weiter geklickt haben, ist es notwendig, dass sie im Schritt Kategorien Ihre Produkte kategorisieren. Anschließend können Sie Ihre Produkte, wie gewohnt, mithilfe von Regeln optimieren.
1.2 Aufbau und Vorschau
Als nächstes mappen Sie mithilfe unseres Templates die internen Channable Felder mit den Feldern von Kaufland.de. Beispielsweise macht es Sinn, das Kaufland-Feld Title mit dem internen Channable Feld title zu mappen, welches den Titel Ihres Produktes wiedergibt usw. Achten Sie dabei auf das Fragezeichen hinter jedem Feld. Wenn Sie mit der Maus darüberfahren, erscheinen die Spezifikationen von Kaufland.de. Sobald Sie alles fertig eingerichtet haben, klicken Sie auf Speichern.
In der Feed-Qualitätsbewertung unter Vorschau werden noch vorhandene Fehler im Feed angezeigt. Angezeigte Fehler können Sie mithilfe von Regeln beheben.
1.3 GPSR- und DSA-Anforderungen
Die Europäische Union (EU) hat neue GPSR- und DSA-Anforderungen für Online-Plattformen, einschließlich Marktplätzen, eingeführt.
Stellen Sie im Aufbau-Schritt Ihrer Galaxus-Feed-Einrichtung in Channable sicher, dass Sie für jedes der folgenden Felder unter „Feldbezeichnung Exportkanal“ ein „Internes Feld“ zuordnen:
- product_safety_contact.name
- product_safety_contact.address
- product_safety_contact.email_address
- product_safety_contact.url
- product_safety_contact.phone_number
- ce_certificate
1.4 Aktivieren Sie den Feed
Um den Feed zu aktivieren, klicken Sie in der linken Leiste auf Einstellungen und dann auf Projekt aktivieren. Anschließend klicken Sie auf Feeds > Einstellungen >Feed aktivieren. Wenn Sie nun auf Vorschau klicken, finden Sie die URL, die Sie bei Kaufland.de hochladen müssen.
1.5 Laden Sie die Feed-URL bei Kaufland.de hoch
Sie können die Feed-URL unter folgendem Link bei Kaufland.de hochladen:
https://www.kaufland.de/seller/automatic-product-data-file-upload/
Navigieren Sie hierzu zunächst Zum neuen Händlerbereich > Meine Angebote > Produktdaten:
Hier wählen Sie dann 'Automatischer Produktdatenupload' und können die Feed-URL, die Sie im Schritt 'Vorschau' in Channable erhalten haben, in das Feld URL festlegen einfügen. Sie können wählen, wann Ihre Produkte hochgeladen werden sollen (Abrufzeitpunkt auswählen). Bitte beachten Sie, dass der Upload des Feeds vor dem Upload der Angebotsdaten (über die API in Channable) erfolgen sollte.
2. Die API einrichten (Angebotsdaten)
2.2 Client Key und Secret Key generieren
Generieren Sie Ihre persönlichen Kaufland.de API Zugangsdaten, indem sie in Ihrem Kaufland-Account unter Shopeinstellungen > API auswählen. Danach wählen Sie als Software Schnittstelle Channable aus und generieren die Zugangsdaten.
Kopieren Sie den Client Key und Secret Key. Diese benötigen Sie später um ihr Kaufland Verkäuferkonto mit Channable zu verbinden.
2.3 Fügen Sie die Kaufland API in Channable hinzu
Um eine neue API-Verbindung zu erstellen, klicken Sie in Channable in der linken Menüleiste auf APIs. Klicken Sie anschließend auf Neue API hinzufügen > Verbindung hinzufügen und wählen Kaufland aus. Nun geben Sie bei den entsprechenden Feldern den Client Key und den Secret Key an, die Sie zuvor kopiert haben und klicken anschließend auf Erstellen.
Anschließend können Sie beginnen, Regeln zu erstellen und die internen Channable Felder mit den Feldern von Kaufland.de im Aufbau zu mappen.
2.4 Aktivieren Sie die API
Nun sind Sie bereit, die Produkte zu Kaufland zu senden. Klicken Sie links in der Auswahlleiste auf Einstellungen und dann auf Projekt aktivieren. Danach gehen Sie zurück zu APIs, klicken auf Einstellungen und dann auf das Feld Aktiviere API. Klicken Sie anschließend auf Aktualisieren, sodass Ihre Produkte zu Kaufland.de gesendet werden.
2.5 Vorschau
Sobald Sie Ihre Produkte zu Kaufland.de gepusht haben, erscheinen Ihre Produkte in Channable unter Vorschau. Unter Fehler erscheinen fehlerhafte Anzeigen, die nicht ausgespielt werden können. Sie können versuchen die Fehler mithilfe von Regeln zu beheben oder den technischen Support von Kaufland bzw. Channable (je nach Error-Meldung) zu kontaktieren.
Häufige Fehler bei der Kaufland API
Da die Kaufland API nur Angebotsdaten sendet, zeigen wir in der Vorschau keine detaillierten Fehlerberichte an. Die zwei verschiedenen Fehlertypen, die wir anzeigen, sind Unknown EAN und Unknown Error.
Unknown EAN
Der Fehler "Unknown EAN" zeigt alle Fehler an, die wir aus dem Bericht "Eans-not-found" von Kaufland entnehmen. Es ist wichtig zu beachten, dass sich nicht alle Fehler tatsächlich auf unbekannte EANs beziehen, weshalb Sie immer die Spalte " Errors " innerhalb der Fehlermeldung überprüfen sollten.
Beispielsweise könnte in der "Errors"-Spalte die Fehlermeldung "not_enough_data" stehen.
Eine genauere Erklärung des Fehlers finden Sie in Ihrem Kaufland-Verkäuferkonto, wenn Sie unter Meine Angebote > Produktdaten > Produktdaten-Feedback nach dem jeweiligen EAN-Code suchen, wie im Bildschirmfoto unten dargestellt.
In diesem Beispiel fehlt dem Produkt ein Attribut, und zwar "KFZ-Leuchtmittel-Typ".
Unknown Error
Der Fehler "Unknown Error" wird von Channable erzeugt, wenn das Produkt nicht bei Kaufland online ist, aber auch nicht im Bericht "Eans-not-found" enthalten ist. Daher erscheint auch keine Meldung in der Spalte "Errors".
In diesem Fall können Sie in Ihrem Kaufland-Verkäuferkonto unter Meine Angebote> Produktdaten > Produktdaten-Reporte den Produktdatendatei-Import-Fehler-Report für weitere Informationen herunterladen.