Marktplätze

Kaufland mit easySales verbinden: die vollständige Anleitung

Kaufland mit easySales verbinden: die vollständige Anleitung

Verbinden Sie einen der sieben Kaufland-Shops mit easySales: das zweistufige Schlüsselformular, alle Standardwerte für Angebote, die EU-verantwortliche Person, die Kategorie-Zuordnung und die Bedeutung jedes Fehlers.

Was die Kaufland-Anbindung bringt

Der Kaufland-Marktplatz besteht aus sieben eigenständigen Shops. Sobald Sie einen in easySales verbinden, werden Ihre Produkte dort zu Angeboten, Bestellungen laufen in dieselbe Liste wie die aller anderen Kanäle, und die Sendungsnummer, die Sie erzeugen, geht automatisch an Kaufland.

Diese Anleitung führt durch eine Verbindung von Anfang bis Ende. Die meiste Aufmerksamkeit gilt den beiden Dingen, die darüber entscheiden, ob Ihre Angebote überhaupt live gehen: der EAN, an der Kaufland erkennt, was Sie verkaufen, und der Kategorie-Zuordnung, die geprüft wird, bevor irgendetwas easySales verlässt.

Bevor Sie beginnen

Ein Kaufland-Verkäuferkonto

Eines je Land, in dem Sie verkaufen möchten. Der Marktplatz betreibt sieben Shops, jeder mit eigenem Konto.

Einen Client Key und einen Secret Key

Im Kaufland Seller Portal im API-Bereich der Shop-Einstellungen erzeugt. Damit signiert easySales jede Anfrage.

EANs an Ihren Produkten

Kaufland verbindet Angebote über den Barcode mit seinem Katalog. Produkte ohne echte EAN lassen sich nicht listen.

Zugeordnete Kategorien

Jede Ihrer Kategorien muss auf eine Kaufland-Kategorie zeigen, bevor daraus erzeugte Angebote gesendet werden können.

Schritt 1 — Die richtige Kaufland-Kachel finden

Gehen Sie zu Integrationen → Marktplätze und suchen Sie nach kaufland.

Die Marktplatz-Seite in easySales, gefiltert auf Kaufland: eine verbundene Kachel Kaufland Deutschland und nicht verbundene Kacheln für Österreich, Tschechien, Polen, Frankreich und Italien.
Integrationen → Marktplätze, gefiltert auf `kaufland`: eine Kachel je Shop.

Klicken Sie auf Verbinden bei der Kachel des Landes, in dem Sie verkaufen, oder auf Bearbeiten, wenn Sie den Shop bereits verbunden haben.

Schritt 2 — Client Key und Secret Key

Der erste Schritt des Kaufland-Verbindungsformulars in easySales mit Verbindungsname, benutzerdefiniertem Status für neue Bestellungen, Client Key und Secret Key.
Schritt eins: der Verbindungsname und das Schlüsselpaar aus dem Kaufland Seller Portal.

Kaufland authentifiziert jede Anfrage mit einem Schlüsselpaar: Client Key und Secret Key erzeugen Sie im Kaufland Seller Portal im API-Bereich Ihrer Shop-Einstellungen. Sie gehören zu genau einem Shop — ein Paar für den deutschen Shop öffnet den tschechischen nicht.

Verbindungsname ist der Name, den Sie überall in easySales sehen — im Angebots-Tab, auf der Bestellung, in der Verbindungsliste. Nehmen Sie das Land hinein.

Benutzerdefinierter Status für neue Bestellungen ist optional. Wenn Sie eigene Bestellstatus führen, können neue Kaufland-Bestellungen direkt auf einem davon landen.

Schritt 3 — Die Standardwerte für Angebote

Sobald die Schlüssel akzeptiert sind, erscheint der Rest des Formulars. Alles darin sind Standardwerte, die Angebote auf dieser Verbindung mitbekommen.

Die zweite Hälfte des Kaufland-Formulars mit Rechnungsserie, Preisaufschlag, Standard-Versandsteuer, Standard-Steuersatz, Zustand, Versandgruppe, Lager und Standard-Telefonnummer.
Die Standardwerte, die jedes neue Angebot auf dieser Verbindung erbt.
Feld Wirkung
Rechnungsserie Die Serie für Rechnungen zu Bestellungen aus diesem Shop.
Preisaufschlag Ein Prozentsatz, der beim Anlegen des Angebots auf Ihren Produktpreis aufgeschlagen wird. 10% auf ein Produkt zu 100 EUR senden 110 EUR. Das ist ein Ausgangspunkt — Angebotspreise lassen sich danach einzeln oder per Regel ändern.
Standard-Versandsteuer Der Steuersatz für die Versandposition auf der Rechnung.
Standard-Steuersatz Der Satz, der mit einem Angebot ohne eigenen Satz gesendet wird. Die Liste kommt von Kaufland, für das jeweilige Land.
Zustand Neu oder eine von vier Gebrauchtstufen. Gilt für jedes auf der Verbindung angelegte Angebot; wer Gebrauchtware verkauft, stellt es hier einmal ein.
Versandgruppe Unter welcher Kaufland-Versandgruppe das Angebot verkauft wird. Die Liste wird aus Ihrem Kaufland-Konto gelesen, ein einzelnes Angebot kann eine andere nutzen.
Lager Das Kaufland-Lager, auf dem der Bestand geführt wird. Ebenfalls aus Ihrem Konto.
Standard-Telefonnummer Wird bei einer Bestellung ohne Telefonnummer eingesetzt, damit die Adresse für ein Versandlabel vollständig genug bleibt.
Die Standardwerte der Verbindung und was sie bewirken

Schritt 4 — Die EU-verantwortliche Person

Der Block der EU-verantwortlichen Person im Kaufland-Formular, auf Ja gestellt, mit Name, Adresse, E-Mail-Adresse, Telefonnummer und URL.
Name und Adresse sind mit einem Sternchen markiert — bei aktivem Block sind sie an jedem Angebot Pflicht.

Dieser Block ist der Produktsicherheitskontakt — die Person oder das Unternehmen in der Europäischen Union, die für die gelistete Ware verantwortlich ist. Kaufland verlangt ihn, und easySales überträgt Ihre Eingaben auf jedes danach erzeugte Angebot.

Schritt 5 — Zusätzliche Einstellungen

Der zweite Reiter oben im Formular, Zusätzliche Einstellungen, enthält drei Schalter. Sie entscheiden, wie viel von Ihren Daten easySales weiterhin überträgt, nachdem ein Angebot existiert.

Der Reiter Zusätzliche Einstellungen der Kaufland-Verbindung mit dem Senden von Angebotspreisen und -beständen an den Marktplatz sowie der automatischen Aktivierung bei Bestand.
Drei Schalter dafür, was easySales weiter überträgt, wenn ein Angebot existiert.
Einstellung Wirkung
Angebotspreise an den Marktplatz senden Standardmäßig an. Schalten Sie es aus, wenn Sie Ihre Kaufland-Preise im Seller Portal pflegen und nicht möchten, dass easySales sie überschreibt. Ein ganz neues Angebot trägt seinen Preis immer mit, unabhängig von dieser Einstellung.
Angebotsbestand an den Marktplatz senden Standardmäßig an. Schalten Sie es aus, wenn ein anderes System den Kaufland-Bestand führt. Wie oben: Ein neues Angebot trägt seinen Bestand immer mit.
Angebote automatisch aktivieren, wenn Produkte Bestand haben Standardmäßig aus. Eingeschaltet kehrt ein wegen Bestandsmangel deaktiviertes Angebot von selbst zurück, sobald das Produkt wieder Bestand hat.
Zusätzliche Einstellungen

Schritt 6 — Kategorien zuordnen

Kaufland nimmt kein Angebot an, das nicht in einer seiner eigenen Kategorien liegt. Ordnen Sie deshalb jede Ihrer Kategorien einer Kaufland-Kategorie zu, bevor Sie Angebote anlegen.

Gehen Sie zu Produkte → Kategorien. Die Spalte Zugeordnet zeigt, mit welchen Marktplätzen jede Ihrer Kategorien bereits verbunden ist.

Die Kategorien-Seite in easySales mit einer Spalte Zugeordnet, die bei mehreren Kategorien KauflandDE zeigt, und einer Schaltfläche zum Zuordnen in jeder Zeile.
Produkte → Kategorien. Die Spalte Zugeordnet zeigt, mit welchen Marktplätzen eine Kategorie verbunden ist.

Klicken Sie in der Zeile auf Kategorien zuordnen und wählen Sie Kaufland aus der Liste der Marktplätze. Tippen Sie ein paar Buchstaben, um den Kategoriebaum von Kaufland zu durchsuchen, und wählen Sie die Endkategorie, in die Ihre Produkte gehören.

Der Dialog zur Kategorie-Zuordnung für Kaufland mit der Kategorie Bürostühle | Office chairs und drei Merkmalen, von denen Materialzusammensetzung Pflicht und einem Shop-Merkmal zugeordnet ist.
Erst die Kaufland-Endkategorie wählen, dann die verlangten Merkmale zuordnen. Das Sternchen markiert die Pflichtmerkmale.

Darunter stehen die Merkmale, die Kaufland in dieser Kategorie verlangt; Sie ordnen ihnen Ihre eigenen Produktmerkmale zu. Die mit einem Sternchen gekennzeichneten sind für Kaufland Pflicht.

Schritt 7 — Angebote anlegen

Gehen Sie zu Produkte, schalten Sie den Filter Ohne Angebote auf ein und wählen Sie Ihre Kaufland-Verbindung: Übrig bleibt alles, was Sie verkaufen und was noch nicht bei Kaufland liegt.

Die Produktseite in easySales mit aktiviertem Filter Ohne Angebote auf, die Produkte ohne Kaufland-Angebot zeigt.
Produkte → Ohne Angebote auf: alles, was Sie verkaufen und was noch nicht bei Kaufland liegt.

Nutzen Sie Angebot hinzufügen bei einem Produkt oder markieren Sie mehrere und legen Sie sie gemeinsam an. Jedes neue Angebot erbt die Standardwerte der Verbindung — Zustand, Versandgruppe, Lager, Preisaufschlag, Steuersatz und die EU-verantwortliche Person — und jeden davon können Sie am Angebot selbst ändern.

Was Kaufland ablehnt, und warum

Die Seite Angebote hat pro Marktplatz einen Reiter. Öffnen Sie den von Kaufland, und die Spalte Fehler sagt Ihnen genau, warum ein Angebot nicht live ist.

Der Kaufland-Reiter der Angebotsseite mit sechs Angeboten und einer Fehlerspalte, die 2911 und 2912 zur Produktsicherheit, 2910 Missing category, 2909 Missing EAN und eine Marktplatz-Ablehnung wegen ungültiger EAN zeigt.
In der Fehlerspalte sagt ein Kaufland-Angebot, warum es nicht live ist.

Ein Teil der Prüfungen läuft in easySales, bevor etwas gesendet wird. Diese beheben Sie selbst:

Code Bedeutung Was zu tun ist
2910 Missing category Die Kategorie des Produkts ist keiner Kaufland-Kategorie zugeordnet. Produkte → Kategorien → Kategorien zuordnen, danach das Angebot erneut senden.
2911 Product safety contact name is missing Der Block zur EU-verantwortlichen Person ist aktiv, das Angebot hat keinen Namen. Tragen Sie den Namen auf der Verbindung und auf den zuvor angelegten Angeboten nach.
2912 Product safety contact address is missing Dasselbe für die Adresse. Wie oben — die beiden treten immer zusammen auf.
2909 Missing EAN Das Produkt hat keine EAN. Barcode am Produkt ergänzen, danach erneut senden.
Fehler, die easySales meldet, bevor etwas gesendet wird

Der Rest kommt von Kaufland mit dessen eigener Meldung zurück, unter Code 5:

Meldung Bedeutung
EAN "…" is not valid Die Nummer ist kein Barcode, den Kaufland akzeptiert. Meist ein interner Code aus der eigenen Warenwirtschaft.
A unit with the id_offer … already exists. Diese Artikelnummer ist in Ihrem Kaufland-Shop bereits vergeben. Zwei Produkte können sich keine Artikelnummer teilen.
Max 20 pictures is allowed. Das Angebot trägt mehr als zwanzig Bilder.
Parameter [listing_price] is missing or has wrong value Der Preis erreichte Kaufland nicht in akzeptierter Form — meist ein leerer oder Null-Preis am Angebot.
Validation Failed mit einem Feldnamen Kaufland hat ein einzelnes Feld abgelehnt und benennt es, etwa eine Bild-URL, die nicht gelesen werden konnte.
Code 5 — die Antworten von Kaufland und ihre Bedeutung

Bestellungen, Rechnungen und Sendungsverfolgung

Bestellungen aus dem Shop landen wie bei jedem anderen Kanal in Bestellungen, mit der Rechnungsserie, die Sie auf der Verbindung gewählt haben.

Wenn Sie ein Versanddokument erzeugen, sendet easySales die Sendungsnummer zusammen mit einem Versanddienstleister-Code an Kaufland, damit der Käufer das Paket aus seinem Kaufland-Konto verfolgen kann. Der Code ergibt sich aus dem eingesetzten Versanddienstleister.

Mehr als ein Shop

Jedes Kaufland-Land ist eine eigene Kachel, ein eigenes Seller-Portal-Konto und eine eigene Verbindung in easySales — mit eigener Kategorie-Zuordnung und eigenen Angeboten. Wer in mehreren Ländern listet, verbindet mehrere Kacheln und gibt jeder einen klaren Verbindungsnamen.

Gemeinsam Pro Shop
Kaufland-Konto und Schlüssel Jedes Land hat ein eigenes Konto und ein eigenes Schlüsselpaar.
Produkte Ihr Produktstamm in easySales ist einer.
Kategorie-Zuordnung Jedes Kaufland-Land hat einen eigenen Kategoriebaum und eine eigene Zuordnung.
Angebote Ein Angebot gehört zu genau einem Shop, mit eigenem Preis, Bestand und Status.
Bestellungen und Rechnungen Eine Bestellliste. Die Rechnungsserie wird je Verbindung gesetzt.
Was Shops teilen und was nicht

Häufig gestellte Fragen

Deutschland, Österreich, Tschechien, die Slowakei, Polen, Frankreich und Italien. Jedes ist in easySales eine eigene Kachel mit eigenem Kaufland-Konto und eigenem Schlüsselpaar, und das Verbindungsformular ist für alle sieben identisch.

Aus Ihrem Kaufland Seller Portal, im API-Bereich der Shop-Einstellungen, wo Sie ein Schlüsselpaar für den Shop erzeugen. Fügen Sie beide in das Verbindungsformular ein. Sie gehören zu genau einem Shop — ein deutsches Paar verbindet den tschechischen Shop nicht.

Das Formular hat zwei Schritte. **Weiter** prüft die Schlüssel bei Kaufland, und erst nach deren Annahme liest easySales Ihre Versandgruppen, Lager und Steuersätze und zeigt die weiteren Felder. Erscheinen sie nicht, wird das Schlüsselpaar abgelehnt — prüfen Sie, ob Sie beide vollständig kopiert haben und ob sie für den Shop erzeugt wurden, den Sie verbinden.

Weil hinter der Kategorie des Produkts keine Kaufland-Kategorie steht. Diese Prüfung läuft innerhalb von easySales, das Angebot geht also nirgendwohin. Öffnen Sie **Produkte → Kategorien**, klicken Sie in der Zeile auf **Kategorien zuordnen**, wählen Sie Kaufland, dann die Kaufland-Kategorie, und ordnen Sie die verlangten Merkmale zu. Danach senden Sie das Angebot erneut.

Kaufland akzeptiert nur echte Barcodes — die vom Hersteller vergebene GTIN. Nummern, die im Shop oder im ERP für den internen Gebrauch erzeugt wurden, sehen aus wie EANs, sind aber nicht registriert, und Kaufland lehnt sie mit `EAN "…" is not valid` ab. Produkte ohne echten Barcode lassen sich bei Kaufland nicht listen.

easySales sendet die Artikelnummer des Angebots als dessen Kennung an Kaufland, und Kaufland verlangt, dass sie innerhalb Ihres Shops eindeutig ist. Die Meldung sagt, dass die Nummer dort bereits von einem anderen Angebot verwendet wird. Geben Sie dem Produkt eine eigene Artikelnummer und senden Sie erneut.

Im Formular ist sie optional, aber wenn Sie sie einschalten, werden Name und Adresse an jedem Angebot Pflicht. easySales überträgt die Werte beim Anlegen, deshalb melden Angebote, die es vorher schon gab, `2911` und `2912`, bis auch sie den Kontakt tragen.

Ja. Die Gruppe an der Verbindung ist der Wert, mit dem neue Angebote starten; der Angebotseditor hat ein eigenes Feld für die Versandgruppe, und gesendet wird, was am Angebot steht.

Nur wenn Sie es zulassen. **Angebotspreise an den Marktplatz senden** ist standardmäßig an und hält Kaufland mit easySales im Gleichklang; ausgeschaltet behalten bestehende Angebote die bei Kaufland gesetzten Preise. Ein neu angelegtes Angebot trägt seinen Preis immer mit, weil Kaufland es sonst nicht listen kann.

Ja. Jeder Shop ist eine eigene Kachel, ein eigenes Konto und eine eigene Verbindung, mit eigenen Angeboten und eigener Kategorie-Zuordnung. Ihre Produkte bleiben in einem Stamm in easySales und Ihre Bestellungen laufen in eine Liste, es vervielfacht sich also nur die Verbindung.

War dieser Leitfaden hilfreich?