Inhaltsverzeichnis
Mit dieser Schnittstelle kannst du xentral mit kaufland.de verbinden, um Bestellungen von dort in xentral zu importieren und deine im Shop verkauften Artikel in xentral zu verwalten. Die Anbindung geschieht über eine API-Schnittstelle (Shopimporter).
Features der Schnittstelle
Die Kaufland-Schnittstelle bietet folgende Features:
- Aufträge aus kaufland.de abholen
- Auftragsstatus bei Versand umstellen inkl. Meldung Trackingnummer
- Artikel einzeln von xentral nach kaufland.de oder von kaufland.de nach xentral übertragen
- Meldung aktueller Lagerzahlen bei Bestandsänderungen
- Übertragung von Rechnungen zu kaufland.de
Anbindung
API Daten bei kaufland.de generieren
Befolge die folgenden Schritte, um deine API Daten bie kaufland.de zu generieren:
- Logge dich im Händler Bereich ein (www.kaufland.de/seller)
- Klicke im Hauptmenü auf "Händlereinstellungen"
- Klicke hier auf "Shopeinstellungen" (Untermenü zu "Händlereinstellungen")
- Klicke auf "API" (Menüleiste oben)
- Wähle xentral als Schnittstelle aus und speichere
- Klicke auf "Zugangsdaten neu generieren"
Schnittstelle in xentral anlegen
Unter Administration → Shop Schnittstelle → Übersicht → NEU kannst du den Kaufland Shop auswählen.
Hinweis: Bis Version 21.1 unter Administration → Online-Shops / Marktplätze→ NEU.
Du landest direkt im Tab Details → Schnittstelle. Hier kannst du die API Daten eintragen.
Klicke nun auf die Schaltfläche Verbindung prüfen auf der rechten Seite. Bei erfolgreicher Verbindung wird "Success" als Meldung erscheinen.
Schnellstart
Um schnellstmöglich loszulegen sind nur ein paar Einstellungen und Aktionen erforderlich. Was für einen Quickstart mit Auftragsimport, Lagerzahlenabgleich und Rückmeldung von Trackingnummern notwendig ist erfährst du hier.
Shop Einstellungen
In diesem Abschnitt werden dir die möglichen Einstellungen in der Shop-Schnittstelle erklärt.
Schnittstelle
Wenn du die Einstellungen der Kaufland Schnittstelle öffnest, landest du zunächst im Tab Details → Schnittstelle.
Einstellungen:
- Bezeichnung → Name frei wählbar für den Shop (wird z.B. im Artikel und im Import-Menü angezeigt)
- Aktiv → Haken setzen, damit die Schnittstelle aktiv ist. Nicht mehr benötigte Schnittstellen kannst du auf inaktiv setzen
- Projekt → Verknüpfung des Shops auf ein Projekt. Im Projekt kannst du die Logistikeinstellungen vornehmen
- Abholmodus → Bei Kaufland kannst du hier ab einem bestimmten Datum abholen
- Datum von → Ab diesem Zeitpunkt werden Aufträge abgeholt, aktualisiert sich wenn du die Funktion Aufträge abholen benutzt
- Import-Modus → Legt fest, ob die Aufträge aus dem Shop manuell (per Knopfdruck) oder automatisch importiert werden sollen
- Demo (zum Testen) → Der Auftragsstatus im Shop nicht umgestellt, keine Artikel oder Lagerzahlen übertragen
- Manuell (mit Importzentrale) → Die Aufträge werden erst abgeholt, wenn der Button Aufträge abholen geklickt wird
- Automatisch (per Prozessstarter) → Die Aufträge werden regelmäßig automatisch vom Shop abgeholt. Hierfür wird der Prozessstarter Shopimporter benötigt
- Nur 1 Auftrag pro Anfrage → Es wird nur 1 Auftrag pro Anfrage vom Shop übertragen
- Aufträge in Zwischentabelle → Beim Abholen der Aufträge werden die Aufträge nicht direkt angelegt, sondern erstmal zum Durchschauen in einer Zwischentabelle gespeichert. Hier kannst du entscheiden, welche Aufträge angelegt und welche erst später importiert werden sollen
- Protokollierung im Logfile → Durch Setzen des Hakens aktivierst du den Logfile und die Informationen werden in diesem protokolliert
- Client Key → Der Client Key der API-Daten, die du bei kaufland.de generiert hast
- Secret Key → Der Secret Key der API-Daten, die du bei kaufland.de generiert hast
- Produktdaten immer übertragen → Bei Kaufland werden die Produktdaten normalerweise einmal übertragen und Kaufland urteilt dann darüber, ob diese übernommen werden. Eine Produktbeschreibung wird dann zum Beispiel bei der ersten Übertragung als Vorschlag gesendet und anschließend nicht mehr. Wenn du diesen Haken setzt werden die Produktdaten bei jedem Artikelexport übertragen
- Artikel ohne Lagerbestand automatisch bei
Aktualisierung aus dem Shop entfernen → Wenn ein Artikel nicht mehr auf Lager ist, wird dieser bei der nächsten Aktualisierung automatisch aus dem Shop entfernt
Aktion:
- Verbindung prüfen → Prüft die Verbindung zwischen beiden Systemen
- Aufträge abholen → Holt die Aufträge aus deinem Shop ab. Hinweis: Außerdem solltest du darauf achten, dass die Statusmeldungen für „Bestellung offen“, „Bestellung in Bearbeitung“ und „Bestellung fertig“ eindeutig sind. Es darf nicht der selbe Status an mehreren Stellen verwendet werden.
- Shopimport Zwischentabelle → Springt zur Zwischentabelle der Aufträge vom Shop. Die Zwischentabelle wird nur im manuellen Importmodus befüllt und wenn die Option 'Aufträge in Zwischentabelle' aktiviert ist.
In der Zwischentabelle wählst du in der linken Spalte zwischen "Import", "Müll" und "Später" aus.
- Import: Auftrag wird direkt importiert
- Müll: Auftrag landet im Müll und kann kein zweites Mal importiert werden
- Später: Auftrag kann zu einem späteren Zeitpunkt importiert werden
- Alte Aufträge importieren → Alte Aufträge werden in die Zwischentabelle geladen, wo du wieder entscheiden
Einstellungen
Informationen zu diesem Tab findest du hier.
Zahlweisen
Informationen zu diesem Tab findest du hier.
Versandarten
Informationen zu diesem Tab findest du hier.
Freifelder
Freifelder sind für Kaufland.de derzeit nicht verfügbar.
Subshop
Subshopmapping ist für Kaufland.de derzeit nicht verfügbar.
Sprache-/Lieferland
Informationen zu diesem Tab findest du hier.
Gruppenmapping
Gruppenmapping ist für Kaufland.de derzeit nicht verfügbar.
Smarty
Über die Verwendung von Smarty erfährst du mehr in diesem Helpdesk Artikel: Smarty im Shopimporter.
Artikelmapping
Über den Reiter Artikelmapping im Modul (Shop Schnittstelle → *Kaufland auswählen* → Details → Artikelmapping, bis Version 21.1: Online-Shops / Marktplätze → *Kaufland auswählen* → Details → Artikelmapping) kannst du die vorhandenen Artikel aus Kaufland Shops mit den Artikeln in xentral verknüpfen.
Im ersten Schritt solltest du die Aktion Artikelliste abholen ausführen, welche die vorhandenen Artikel aus Kaufland lädt. 
In der geladenen Liste kannst du einzelne Artikel durch Klicken auf die Editor-Schaltfläche und Eingabe des Artikelnamens zum xentral Artikel zuordnen.
Mit der Aktion Artikel zuordnen finalisierst du das Ganze.
Workflows
Artikel importieren
Wie du Artikel von kaufland.de zu xentral importierst, erfährst du hier.
Artikel exportieren
Um einen Artikel bei kaufland.de listen zu können, musst du beim jeweiligen Artikel einen Verweis auf den Webshop, in diesem Fall Kaufland, setzen (Stammdaten → Artikel → *Artikel auswählen* → Online-Shop Optionen). Falls der Shop noch nicht verknüpft wurde, musst du auf Neuer Eintrag klicken und dort Kaufland eingeben:
Sollte die "Zahnrad"-Schaltfläche nicht auftauchen, nachdem du den Importer ausgewählt hast, musst du den Artikel neu laden.
Mit einem Klick auf die Kaufland Einstellungen-Schaltfläche gelangst du in das Menü für die Kaufland-spezifischen Einstellungen. Zunächst musst du eine Kategorie für den Artikel auswählen. Die angezeigten Kategorien setzen sich aus Vorschlägen zusammen, die Kaufland anhand der Produktbeschreibung bestimmt hat. Sollten die Vorschläge nicht passen, kannst du über die manuelle Suche explizit nach einer bestimmten Kategorie suchen:
Nachdem du eine Kategorie ausgewählt hast, werden die kategoriespeziefischen Felder geladen. Felder, die anhand ihres Namens eindeutig zugeordnet werden können, werden mit der entsprechenden Wildcard versehen. Diese Werte werden mit denen aus den Artikeleigenschaften befüllt, sodass zum Beispiel die Herstellernummer nicht noch ein mal eingegeben werden muss.
Beachte, dass alle Pflichtwerte ausgefüllt sein müssen, damit ein Artikel erfolgreich zum Verkauf angeboten werden kann.
Die Übertragung von Bildern ist leider nicht direkt möglich. Damit ein Bild übertragen werden kann, musst du die URL des Bildes als externen Link in den Artikeloptionen angeben. Dabei genügt der Link zum Bild aus dem Dateibrowser nicht, sondern das Bild muss auf einen FTP-Server o.Ä. hochgeladen werden, damit es funktioniert. Du findest die Artikeloptionen über das Zahnrad Symbol unter Artikel > Online-Shop Optionen > Kaufland-Schnittstelle im Feld Bild.
Beachte darüber hinaus, dass kaufland.de 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.de nach der Ursache des Problems zu suchen. Wenn der Artikel direkt editiert wird, werden zwingend erforderliche Felder mit fetter roter Schrift angezeigt.
Lagerzahlen synchronisieren
Wie du die Lagerzahlen synchronisieren kannst, erfährst du hier.
Aufträge importieren
Das Importieren von Bestellungen aus Online Shops wird in diesem Artikel beschrieben.
Sonderfälle / Sonstige Informationen
Übertragung der Rechnung
Bei Auftragsabschluss wird das Rechnungs-PDF automatisch mit an kaufland.de übertragen, sofern die Rechnung bei Versand des Auftrags bereits vorhanden ist.
Daher musst du die Rechnung im Projekt, welches zum Kaufland-Shopimporter gehört, schon in Stufe 1 der Kommissionierung erstellen lassen. Die Option, um die Rechnung erst in der Versandstation zu erstellen, darf daher nicht gesetzt sein.
Verknüpfung der Artikel von xentral zu Kaufland
Um eine Verbindung zwischen den beiden Artikeln zu gewährleisten, sind zwei Dinge notwendig:
- Hinzufügen der SKU im Tab des Artikels „Fremdnummer“
- Aufbauen des Mapping über den Kaufland-Shopimporter im Tab „Artikelmapping“.
Hierzu musst du erst die Artikel abholen und anschließend zuordnen. Die Zuordnung erfolgt aufgrund der zuvor hinterlegten SKU im Artikel.