Kaufland-Anbindung
Verkaufen Sie Ihre Shop-Produkte automatisch auf Kaufland.de, Kaufland.at und weiteren Storefronts: Artikel, Preise und Bestände werden mehrmals täglich übertragen, Bestellungen automatisch importiert. Ab Version 4.8.09 gleicht der Shop zusätzlich ab, welche Angebote bei Kaufland liegen, ab Version 4.10.0 auch, welche davon auf Kaufland sichtbar sind.
Wie richte ich die Kaufland-Anbindung ein?
Alle Einstellungen finden Sie unter Admin → Multichannel → Kaufland → Einstellungen.
Zugangsdaten & Storefront
ClientKey und ClientSecret erhalten Sie im Kaufland Seller-Portal unter Einstellungen → API. Bei Storefront (Land) wählen Sie das Land Ihres Verkäuferkontos (z. B. de oder at) – Kaufland verwaltet Versandgruppen und Kategorien getrennt je Land.
Nach Änderungen an Storefront oder Portal-Einstellungen den Button „Versandgruppen, Kategorien & Lager neu laden“ klicken.
Standard-Versandgruppe & Standard-Lager Lager ab V4.8.09
Die Standard-Versandgruppe gilt für alle Produkte ohne eigene Auswahl. Das Standard-Lager (Warehouse) bestimmt, aus welchem Kaufland-Lager Ihre Angebote bedient werden.
Beides lässt sich pro Produkt übersteuern: Registerkarte Marktplätze am Produkt → Felder Versandgruppe bzw. Lager (Warehouse).
Artikelnummer an Kaufland ab V4.8.09
Legt fest, was Kaufland als Artikelnummer Ihrer Angebote führt: ean (die EAN, bisheriges Verhalten) oder model (Ihre eigene Artikelnummer aus dem Shop, wie bei den anderen Marktplätzen).
Kaufland lässt die Artikelnummer bestehender Angebote nicht ändern. Führen Sie nach dem Umstellen deshalb „Artikelnummern bei Kaufland umstellen“ aus, zuerst mit „Nur prüfen (Trockenlauf)“. Der Shop legt jedes Angebot dann unter der neuen Nummer an und beendet erst danach das alte, der Artikel bleibt durchgehend online.

Wichtig: Ohne Lager kein Angebot
Kaufland verlangt für jedes Angebot ein Lager.
Symptom: „Die Angebotsdaten fehlen“
Erscheinen Ihre Artikel im Kaufland-Portal ohne Preis und Bestand („Die Angebotsdaten fehlen“), ist in Ihrem Kaufland-Konto kein Standardlager markiert. Kaufland lehnt dann jedes Angebot ab.
Zwei Lösungswege:
- Im Kaufland Seller-Portal unter Einstellungen → Versand & Lager ein Lager anlegen und als Standardlager markieren – die Übertragung zieht die Angebote danach automatisch nach.
- Ab Version 4.8.09: Alternativ direkt im Shop unter Standard-Lager (Warehouse) ein Lager wählen – der Shop sendet es dann mit jedem Angebot mit.
Abgleich: Marktplatz-Angebote ab V4.8.09
Sehen Sie jederzeit, welche Angebote wirklich bei Kaufland liegen – und was davon Ihr Shop kennt.
Jetzt abgleichen
Lädt alle Angebote Ihres Kaufland-Kontos in die Übersicht (Reiter Marktplatz-Angebote).
Filtern
Alle / Verknüpft / Nicht verknüpft – so sehen Sie sofort Angebote ohne zugehöriges Shop-Produkt.
Automatisch zuordnen
Ordnet Angebote per Artikelnummer oder EAN dem passenden Shop-Produkt zu.
Angebot beenden
Beendet ein nicht zugeordnetes Angebot direkt bei Kaufland – mit Sicherheitsabfrage.
Ist mein Angebot auf Kaufland sichtbar?
ab V4.10.0
Der Upload-Status „done“ bedeutet nur, dass Kaufland das Angebot angenommen hat. Ob es auf Kaufland sichtbar ist, zeigt die Spalte „Live“.
Die Spalte „Live“
Sie steht im Reiter Marktplatz-Angebote und im Reiter Kaufland (Artikelübersicht), dort bei jedem Artikel mit Kaufland-Angebot:
- Live (grün): Das Angebot ist auf Kaufland sichtbar.
- Nicht live (rot): Kaufland zeigt das Angebot nicht an.
- – (Strich): Zu diesem Angebot liegt noch kein Status vor.
Fahren Sie mit der Maus über die Anzeige, sehen Sie, wann der Status zuletzt geprüft wurde. Der Filter Nicht live im Reiter Marktplatz-Angebote listet nur die betroffenen Angebote.
Woher der Status kommt
Kaufland meldet den Status bei jedem Abgleich mit, also beim Klick auf „Jetzt abgleichen“ im Reiter Marktplatz-Angebote oder automatisch, wenn der Abgleich als Cronjob eingerichtet ist. Wann der Abgleich zuletzt lief, steht dort oben unter „Letzter Abgleich“.
Steht nach dem Update überall „–“, ist seitdem noch kein Abgleich gelaufen: Klicken Sie auf „Jetzt abgleichen“. Bleibt es danach überall bei „–“, wenden Sie sich an den XONIC-Support.
Kennt Kaufland ein Angebot gar nicht, obwohl der Shop es für übertragen hält, liefert der Abgleich dazu keinen Status. Das Angebot fehlt dann im Reiter Marktplatz-Angebote und damit auch unter dem Filter Nicht live, in der Artikelübersicht bleibt der Artikel auf „–“. Erst die Prüfung über die Lupe neben dem Status meldet „Der Marktplatz kennt kein Angebot mit der Nummer …“ und zeigt Nicht live, bis Sie die Seite neu laden. Übertragen Sie den Artikel in diesem Fall erneut.
Warum ist ein Angebot nicht live?
Steht ein Angebot auf Nicht live, finden Sie daneben den Knopf „Warum nicht live?“. In der Artikelübersicht zeigt der Knopf nur eine Lupe. Liegt noch kein Status vor, heißt derselbe Knopf „Live-Status prüfen“. Ein Klick fragt die Gründe direkt bei Kaufland ab: Der Dialog nennt jeden Grund mit einer Erklärung und dem Kaufland-Code, wo vorhanden auch einen Link zu weiteren Informationen bei Kaufland. Die Spalte zeigt danach den abgefragten Stand.
Kaufland begrenzt diese Abfrage. Der Shop stellt sie deshalb nur, wenn Sie den Knopf klicken, und nie automatisch.
Diese Gründe beheben Sie im Shop
- Bestand bei Kaufland ist 0: Hat der Artikel im Shop Bestand, übertragen Sie ihn erneut.
- Preis muss geprüft werden: Preis im Shop und die Preiseinstellungen für Kaufland kontrollieren (siehe „Welche Artikel und Preise gehen an Kaufland?“) und den Artikel erneut übertragen.
- Produktdaten unvollständig: Titel, Beschreibung, Bilder und Kategorie im Shop ergänzen und den Artikel erneut übertragen.
- Produktdaten passen nicht zum Artikel: Angaben im Shop prüfen, korrigieren und den Artikel erneut übertragen.
- Kontaktdaten für die GPSR fehlen: Angaben in der Herstellerverwaltung prüfen (siehe Herstellerangaben (GPSR)) und danach einen Artikel dieses Herstellers erneut übertragen.
Zum erneuten Übertragen markieren Sie den Artikel in der Artikelübersicht und wählen im Menü „Aktion für markierte Produkte“ den Eintrag „Produkt aktualisieren“. Die Spalte zeigt danach weiter den Stand der letzten Prüfung, den aktuellen Stand fragt die Lupe ab. Direkt nach der Übertragung kann Kaufland das Angebot noch kurz als nicht live melden.
Diese erledigen Sie bei Kaufland
- Angebot pausiert: im Kaufland Seller-Portal wieder aktivieren.
- Registrierungsnummern fehlen (WEEE, EPR und weitere): im Seller-Portal hinterlegen.
- Unterlagen im Kaufland-Konto, etwa die USt-IdNr.: im Seller-Portal aktualisieren.
- Marken-, Bild- oder Schutzrechte, Echtheit, Geschäftsbedingungen sowie Gründe ohne genaue Angabe: Klärung mit dem Kaufland Seller Support.
Welche Artikel und Preise gehen an Kaufland?
Die Abschnitte „Produkte“ und „Preise“ im Reiter „Einstellungen“ steuern Auswahl und Preisberechnung.
Artikelauswahl
- Nur Slaves und Einzelprodukte: lässt die Hauptartikel von Variantenfamilien weg und überträgt nur Varianten und Einzelartikel.
- Exportiere Produkte ohne GTIN und doppelte GTIN/MPN ausfiltern: legen fest, wie der Shop mit fehlenden oder mehrfach vergebenen Kennnummern umgeht.
- Ausschlussliste Hersteller/Marke: nimmt einzelne Hersteller oder Marken vom Export aus.
- Kategorie-Einschränkung für den Export: Eine Whitelist überträgt nur Artikel aus den gewählten Kategorien, eine Blacklist schließt sie aus. Bereits gelistete Artikel, die nicht mehr passen, beendet der nächste Update-Lauf.
- Zu berücksichtigende Lager: bestimmt, aus welchen Lagern der übertragene Bestand stammt. Ohne Auswahl zählen alle aktiven Lager.
Preise
- Kundengruppe für Preisberechnung: Preisbasis einschließlich aktiver Sonder- und Gruppenpreise. Hat die Gruppe für einen Artikel keinen Preis, gilt der Standardpreis.
- Sonderangebotspreise beachten: bezieht Sonderpreise ein.
- Automatischer Preisaufschlag: feste oder prozentuale Aufschläge bis zu einem Netto-Wert. Am Artikel eingetragene Marktplatzpreise haben Vorrang.
- Automatische Brutto-Preisrundung: Mit 0,99 rundet der Shop alle Bruttopreise auf x,99 auf.


Wie kommen die Herstellerangaben (GPSR) zu Kaufland?
Die EU-Produktsicherheitsverordnung (GPSR) verlangt Name und Anschrift des Herstellers, bei Herstellern außerhalb der EU zusätzlich eine verantwortliche Person in der EU.
Automatisch aus der Herstellerverwaltung ab V4.10.0
Der Shop überträgt die GPSR-Angaben aus der Herstellerverwaltung einmal je Hersteller an Kaufland; sie gelten dort für alle Artikel dieses Herstellers. Sitzt der Hersteller außerhalb der EU, geht die dort gepflegte Anschrift innerhalb der EU als verantwortliche Person mit.
Beim Hersteller wählt Kaufland aus den Angaben aller Händler eine aus. Ihre Angabe ist damit übermittelt, aber nicht zwingend die angezeigte.
Was Kaufland verlangt
- Name, Ort und Land, in der EU zusätzlich die Postleitzahl.
- Straße mit Hausnummer. Der Shop trennt beides automatisch, eine Anschrift ohne erkennbare Hausnummer überträgt er nicht.
- Eine E-Mail-Adresse oder eine Website.
Fehlt etwas, meldet der Shop das beim Übertragen mit dem Namen des Herstellers. Das Angebot bleibt davon unberührt online, Preise und Bestände laufen weiter.
Wie läuft der vollautomatische Betrieb?
Einmal eingerichtet, läuft die Anbindung von allein.
Übertragung per Cronjob
Neue Artikel, Preis- und Bestandsänderungen gehen mehrmals täglich automatisch an Kaufland. Bestellungen werden stündlich importiert und beim Versand an Kaufland zurückgemeldet.
Selbstheilung bei Fehlern ab V4.8.09
Wird ein Angebot von Kaufland vorübergehend abgelehnt (z. B. fehlendes Lager), versucht es der Shop automatisch täglich erneut – sobald die Ursache behoben ist, erscheint das Angebot ohne weiteres Zutun.
Wenn Kaufland nicht antwortet
ab V4.10.0
Bricht die Verbindung zu Kaufland ab oder ist Kaufland kurzzeitig nicht erreichbar, gilt die Übertragung von Artikeln, Preisen und Beständen nicht als erledigt: Der Artikel zeigt den Upload-Status error, und der Shop versucht es beim nächsten Lauf erneut, nicht erst am nächsten Tag. Starten Sie die Übertragung selbst im Backend, erscheint zusätzlich die Meldung „Kaufland hat keine gültige Antwort geliefert“.
Bestellungen legt der Shop erst an, wenn Kaufland die Bestelldaten vollständig übermittelt hat. Bricht der Abruf ab, holt der nächste Import die Bestellung nach.
Versandmeldung prüfen
ab V4.10.0
Hat der Shop den Versand erfolgreich an Kaufland gemeldet, steht im Verlauf der Bestellung der Eintrag „Versandübermittlung an Kaufland erfolgreich.“ Fehlt er, prüfen Sie zuerst die Sendungsnummer: Ohne Sendungsnummer meldet der Shop den Versand nicht an Kaufland und zeigt dazu keinen Hinweis. Tragen Sie die Sendungsnummer an der Bestellung nach und setzen Sie die Bestellung danach erneut auf den Versandstatus, etwa „versendet“.