Diese Schnittstelle erlaubt es dir, über eine API Aufträge von Kaufland nach Xentral zu importieren, und bietet die folgenden Funktionalitäten:
-
Aufträge von Kaufland importieren
-
Automatische Änderung des Auftragsstatus bei Versand mit Sendungsverfolgung
-
Übertragung einzelner Artikel von Xentral nach Kaufland und umgekehrt
-
Meldung aktueller Lagerzahlen
-
Übertragung von Rechnungen zu Kaufland
Um die Schnittstelle anzubinden, benötigst du sowohl Zugang zu Kaufland als auch zu Xentral.
Führe die folgenden Schritte aus, um deine API-Zugangsdaten bei Kaufland zu erzeugen:
-
Logge dich im Händlerbereich von Kaufland ein (www.kaufland.de/seller).
-
Klicke im Hauptmenü auf Händlereinstellungen > Shopeinstellungen und öffne den Reiter API.
-
Wähle Xentral als Schnittstelle aus und speichere.
-
Klicke auf Zugangsdaten neu generieren.
-
Kopiere Client Key und Secret Key. Du benötigst diese, um die Schnittstelle in Xentral einzurichten.
Gehe wie folgt vor, um die Kaufland-Schnittstelle in Xentral anzulegen:
-
In Xentral, navigiere zu:
-
Im Classic Design: Administration > Shop Schnittstelle und klicke auf NEU.
-
In Xentral NextGen:
Einstellungen > Verkaufen > Shops/ Marktplätze und klicke auf Verbindung hinzufügen.
-
-
Wähle Kaufland. Ein Dialog erscheint.
-
Trage deinen Client Key und Secret Key in die entsprechenden Felder ein und klicke auf Weiter.
Du landest direkt im Reiter Details > Schnittstelle. Hier kannst du die API-Daten eintragen.
Du kannst die grundlegenden Einstellungen der Schnittstelle unter Reiter Details > Unterreiter Schnittstelle konfigurieren.
-
Gib eine aussagekräftige Bezeichnung ein, z.B. den Namen deines Shops und das dazugehörige Projekt.
-
Setze ein Häkchen bei Aktiv, um die Schnittstelle zu aktivieren. Du kannst das Häkchen auch wieder entfernen, um die Schnittstelle zu deaktivieren.
-
Wähle ein Projekt. Mit einem spezifischen Projekt für deinen Shop kannst du Logistik, Belege, Zahlweisen und andere Funktionalitäten bestmöglich an deinen Shop anpassen. Kaufland hat einige spezielle Anforderungen, die du mit einem Projekt lösen kannst - beispielsweise was den Upload von Rechnungen betrifft. Am Ende des Artikels findest du eine genauere Beschreibung, auf welche Besonderheiten du in deinem Projekt achten solltest.
-
Wähle den Abholmodus. In der Kaufland-Schnittstelle ist ab Datum die einzige Option.
-
Das Feld Datum von wird automatisch ausgefüllt, wenn du die Schnittstelle einrichtest und wird jedes Mal aktualisiert, wenn du auf Aufträge abholen klickst oder Aufträge vom Prozessstarter importiert werden.
Im Bereich Einstellungen für Shop oder Marktplatz kannst du einige optionale Einstellungen vornehmen:
-
Wähle Protokollierung im Logfile, wenn du Anfragen der Schnittstelle protokollieren möchtest. Dies kann bei der Fehlerbehebung hilfreich sein. Die Logs findest du am unteren Ende dieser Einstellungsseite.
-
Wähle Produktdaten immer übertragen, falls du deine Artikeldaten und Beschreibungen häufig wechselst. Standardmäßig werden Artikeldaten nur einmal übertragen. Mit dieser Option werden sie jedoch jedes Mal übertragen, sobald du einen Artikel exportierst.
-
Wähle Artikel ohne Lagerbestand automatisch bei Aktualisierung aus dem Shop entfernen, falls du nicht planst, den Lagerbestand deiner Artikel zu erneuern.
Du kannst aus drei Optionen für den Import-Modus auswählen:
-
Demo (zum Testen) - Nutze diese Option zu Testzwecken. Bei dieser Option wird der Auftragsstatus im Shop nicht aktualisiert. Artikel und Lagerzahlen werden nicht übertragen.
-
Manuell (mit Importzentrale) - Xentral importiert nur Aufträge, wenn du auf Aufträge abholen im Aktions-Menü auf der rechten Seite klickst.
Wählst du Aufträge in Zwischentabelle, werden die Aufträge in einer Zwischentabelle gespeichert, in der du sie auf Fehler überprüfen kannst, bevor du sie in dein System übernimmst.
Du kannst die Schnittstelle testen, indem du auf Nur 1 Auftrag pro Anfrage klickst und anschließend prüfst, ob der Importprozess für einen Auftrag funktioniert.
-
Automatisch (per Prozessstarter) - Xentral importiert Aufträge in regelmäßigen Abständen. Dieser Prozess wird vom Prozessstarter shopimport gesteuert.
Wählst du in diesem Import-Modus Aufträge in Zwischentabelle aus, so wird die Zwischentabelle als Fallback genutzt, d.h. sollte beim Importprozess ein Fehler auftreten, dann kannst du die Zwischentabelle auf Fehler und fehlende Aufträge prüfen.
Du kannst außerdem auf Shopimport Zwischentabelle im Aktions-Menü auf der rechten Seite klicken, um eine Zwischentabelle deiner letzten Aufträge zu importieren.
Es gibt mehrere zusätzliche Reiter, in denen du weitere Einstellungen konfigurieren kannst. Da die Schnittstellen aller Onlineshops auf dem selben Grundgerüst basieren, sind nicht alle Reiter für jeden Shop relevant.
Weitere Informationen zu den folgenden Reitern findest du im Online-Shops Artikel:
-
Einstellungen (Artikelimport, Lagerzahlensynchronisation)
Achtung
Ist die Artikelübertragung in den Einstellungen deaktiviert, werden weiterhin mit dem Shop verknüpfte Preise bei der Synchronisation der Lagerzahlen an Kaufland übertragen!
-
Zahlweisen
-
Versandarten
-
Sprache-/Lieferland
Klicke hier, um mehr über die Nutzung von Smarty in der Onlineshop-Schnittstelle zu erfahren.
Anmerkung
Die folgenden Reiter sind für die Kaufland-Schnittstelle nicht relevant:
-
Freifelder
-
Subshop
-
Gruppenmapping
Du musst deine Artikel aus Kaufland mit denen in Xentral verknüpfen. Auf diese Weise wird eine Synchronisierung der Artikel zwischen Kaufland und Xentral ermöglicht. Zusätzlich können so Aufträge aus Kaufland den verknüpften Artikeln in Xentral zugewiesen werden.
Gehe wie folgt vor, um Artikel aus Kaufland mit denen in Xentral zu verknüpfen:
-
Navigiere in der Kaufland-Shopschnittstelle in Xentral zu Details > Artikelmapping.
-
Klicke auf Artikelliste abholen.
Die Artikel aus Kaufland werden abgerufen und hier aufgelistet. Die Spalte Zuordenbar zeigt an, welche Artikel auf Basis identischer EANs automatisch mit ihrem Gegenstück in Xentral verknüpft werden können.
Xentral legt dabei automatisch über die Daten, die über die Shopschnittstelle importiert wurden, zwei Einträge für Fremdnummern des Artikels in Xentral an.
-
apiitemid - Die alte Bezeichnung, die von der veralteten API verwendet wurde. Diese wird automatisch angelegt, da sie durch die Kaufland-Shopschnittstelle übertragen wird. Diese Nummer kannst du ignorieren.
-
apiunitid - Die gültige Bezeichnung für die Kaufland-Fremdnummer.
-
-
Klicke auf Artikel zuordnen.
Die Artikel, die als Zuordenbar erkannt wurden, werden nun verknüpft. Das bedeutet Folgendes:
-
Die Spalte Zuordenbar zeigt an, dass sie verknüpft wurden.
-
Im Reiter Fremdnummern des entsprechenden Artikels werden die beiden Kaufland-Fremdnummern (apiitemid und apiunitid) auf Aktiv gesetzt.
-
Anmerkung
Wenn du auf Artikelliste abholen klickst, werden bereits bestehende Artikelverknüpfungen gelöst. Du musst alle Artikel mit einem erneuten Klick auf Artikel zuordnen neu verknüpfen.
Bei Bedarf kannst du die aktive Verknüpfung eines Artikels manuell lösen oder die Verknüpfung auf einen anderen Artikel in Xentral übertragen.
Um eine Artikelverknüpfung manuell zu lösen und eine neue Verknüpfung zu ermöglichen, gehst du wie folgt vor:
-
Navigiere in der Kaufland-Shopschnittstelle in Xentral zu Details > Artikelmapping.
-
Klicke in der Liste der Kaufland-Artikel auf
rechts neben dem Artikel, dessen Verknüpfung du lösen möchtest.
Die Verknüpfung wird gelöst. Das bedeutet Folgendes:
-
Die Spalte Zuordenbar zeigt an, dass keine Verknüpfung vorhanden ist.
-
Im Reiter Fremdnummern des entsprechenden Artikels werden die Häkchen im Feld Aktiv für die beiden Kaufland-Fremdnummern (apiitemid und apiunitid) entfernt.
Die beiden Fremdnummern werden nicht gelöscht, sondern nur deaktiviert. So kannst du sie jederzeit durch eine neue Verknüpfung im Reiter Artikelmapping reaktivieren - siehe nachfolgende Beschreibung.
-
Gehe wie folgt vor, um die Verknüpfung eines Kaufland-Artikels auf einen anderen Artikel in Xentral zu übertragen:
-
Navigiere in der Kaufland-Shopschnittstelle in Xentral zu Details > Artikelmapping.
-
Klicke in der Liste der Kaufland-Artikel auf
rechts neben dem Artikel, dessen Verknüpfung du ändern möchtest.
-
Der Dialog Artikel bearbeiten wird angezeigt. Gib den gewünschten Artikel aus Xentral ein. Alternativ kannst du im Eingabefeld auf
klicken, um nach dem gewünschten Artikel zu suchen.
-
Klicke auf Speichern.
Die Verknüpfung wird erstellt: Im Reiter Fremdnummern des entsprechenden Artikels werden die beiden Kaufland-Fremdnummern (apiitemid und apiunitid) auf Aktiv gesetzt.
Um einen Artikel bei Kaufland zu listen, ist es notwendig, einige besondere Einstellungen vorzunehmen. Allgemeinere Informationen zum Export von Artikeln zu einem Onlineshop findest du in diesem Artikel.
Gehe wie folgt vor, um einen Artikel zu Kaufland zu exportieren:
-
Navigiere zu
-
Im Classic Design: Stammdaten > Artikel > Wähle den Artikel > Reiter Details > Unterreiter Online-Shop Optionen.
-
In Xentral NextGen: Verkaufen > Artikel > Wähle den Artikel > Reiter Details > Unterreiter Online-Shop Optionen.
-
-
Klicke im Abschnitt Online-Shops auf Neuer Eintrag. Es öffnet sich ein neues Fenster.
-
Wähle deine Kaufland-Schnittstelle im Online-Shop Dropdown-Menü und klicke auf Speichern.
-
Klicke auf
in derselben Zeile wie Kaufland. Ein neues Fenster mit Kaufland-spezifischen Einstellungen öffnet sich.
-
Klicke auf Suchen im Feld Kategorie und wähle eine Kategorie für deinen Artikel. Kaufland schlägt dir Kategorien auf Grundlage der Artikelbeschreibung vor. Sollte der Vorschlag nicht zutreffen, kannst du eine Kategorie über die Manuelle Kategoriesuche auswählen.
-
Gib deine Artikeldaten in die Kategorie-spezifischen Felder ein. Einige der Felder sind verpflichtend und notwendig, um deinen Artikel bei Kaufland anzubieten. Sollte Xentral eine passende Information erkennen, wird das entsprechende Feld mit den Artikeldaten aus Xentral befüllt, z.B. mit dem Hersteller.
Anmerkung
Du kannst unterschiedliche Felder über Variablen ansprechen. Dabei kannst du entweder Variablen oder Text verwenden, aber nicht beide in einem Feld vermischen. Hast du z.B. "{Freifeld1} Liter" eingegeben, um eine Mengeneinheit anzugeben, würde die Variable nicht korrekt gelesen und du würdest "{Freifeld1} Liter" erhalten statt"10 Liter".
-
Wähle eine Versandgruppe. Bevor du eine Versandgruppe auswählen kannst, musst du sie im Kaufland Seller Portal anlegen.
-
Wähle einen Zustand. Ist der Zustand nicht Neu, solltest du im nächsten Feld eine Zustandsbeschreibung eintragen.
-
Gib eine Minimale Lieferzeit und Maximale Lieferzeit in Tagen ein.
-
Klicke auf Speichern.
Anmerkung
Ist ein Artikel nicht verfügbar, obwohl alle Felder befüllt wurden, liegt der Fehler womöglich bei Kaufland. Bearbeitest du einen Artikel direkt bei Kaufland, werden Pflichtfelder in roter Schrift angezeigt.
Beachte darüber hinaus, dass Kaufland Artikelbeschreibungen nicht direkt übernimmt, sondern erst auf Inhalt prüft. Die Artikelbeschreibung aus Xentral wird also nicht direkt auf dem Marktplatz angezeigt, sondern hilft nur, die bereits bestehende zu verbessern. Sollte ein Artikel nicht verfügbar sein, obwohl alle Felder eingegeben worden sind, bietet es sich an, direkt auf Kaufland nach der Ursache des Problems zu suchen. Wenn der Artikel direkt editiert wird, werden zwingend erforderliche Felder mit fetter roter Schrift angezeigt.
-
Kaufland nutzt die aus Xentral übertragene Artikelbeschreibung nicht direkt, sondern prüft die Beschreibung und integriert passende Inhalte in die bestehende Beschreibung.
-
Bilder müssen auf einen FTP-Server oder ähnliches hochgeladen werden. Die URL deines Artikels kannst du dann unter Artikel > Wähle den Artikel > Reiter Details > Unterreiter Online-Shop Optionen > Klicke auf
Es gibt einige Besonderheiten bezüglich des Uploads von Rechnungen und dem Versand von E-Mails, die du beim Einrichten eines Kaufland-Projektes beachten solltest. Die Gründe dafür sind folgende:
-
Rechnungen müssen, sobald sie abgeschlossen sind, zu Kaufland übertragen werden. Dies bedeutet, dass die Rechnung vor dem Versandprozess erzeugt werden muss.
-
Kaufland verbietet Drittanbietern, wie Xentral, E-Mails in ihrem Namen zu versenden.
Richte dein Projekt folgendermaßen ein:
-
Navigiere zu
-
Im Classic Design: Stammdaten > Projekt > Öffne dein Kaufland-Projekt > Reiter Einstellungen > Unterreiter Logistik/ Versand.
-
In Xentral NextGen:
-
-
Stelle im Bereich Stufe 1 (Pick/ Kommissionierung) sicher, dass kein Häkchen bei Rechnung erst im Versandprozess erzeugen gesetzt ist.
-
Stelle sicher, dass keine Häkchen bei E-Mail gesetzt sind. Dies gilt für Stufe 1 (Pick/ Kommissionierung) und Stufe 2 (Pack) an Versandstation.