Kaufland-Marktplatz-Integration

Verbinde dein Kaufland-Verkäuferkonto direkt mit Flowkom — für Bestellimport, Versandbestätigung, Bestandsübertragung und das Listen deiner Artikel auf allen Kaufland-Marktplätzen (kaufland.de, .at, .cz, .sk, .pl, .fr, .it).

Gut zu wissen: Ein Kaufland-Verkäuferkonto deckt alle Länder-Marktplätze mit einem Schlüsselpaar ab. In Flowkom wählst du nach dem Verbinden aus, welche Marktplätze synchronisiert werden sollen.

Was die Integration kann

Jeder Bereich ist standardmäßig aus und wird pro Verbindung einzeln aktiviert — du behältst die Kontrolle, was direkt über Kaufland läuft.

• Verbindung & Marktplätze — Kaufland-Konto per API-Schlüssel verbinden, Länder-Auswahl (verfügbar)
• Artikelzuordnung — deine Kaufland-Angebote werden automatisch über die SKU mit Flowkom-Artikeln verknüpft
• Bestellimport — Kaufland-Bestellungen aller aktivierten Marktplätze direkt in Flowkom
• Versandbestätigung — versendete Bestellungen werden mit Trackingnummer automatisch an Kaufland gemeldet
• Bestandsübertragung — der verfügbare Lagerbestand geht automatisch an Kaufland
• Storno & Erstattung — Stornos und Erstattungen aus Flowkom an Kaufland melden
• Produktlister — Artikel per EAN direkt aus Flowkom bei Kaufland listen
• Retouren & Tickets — eingehende Rücksendungen direkt in Flowkom annehmen (löst die Kundenerstattung durch Kaufland aus) oder ablehnen; Kundenanfragen-Tickets beantworten
• Belegabgleich — Erstattungen, die Kaufland-seitig ausgelöst werden (Seller-Portal/Kundenservice), werden automatisch am Auftrag verbucht — inkl. Gutschrift
• Rechnungsupload — finalisierte Flowkom-Rechnungen und Gutschriften werden automatisch als PDF zur Kaufland-Bestellung hochgeladen

Voraussetzungen

• Ein aktives Kaufland-Verkäuferkonto (Kaufland Global Marketplace)
• Zugang zum Kaufland-Seller-Portal
• Admin-Rechte in Flowkom

Schritt 1: API-Schlüssel im Seller-Portal erzeugen

1. Melde dich im Kaufland-Seller-Portal an.
2. Öffne Einstellungen → API (Bereich „API-Zugangsdaten“).
3. Erzeuge ein Schlüsselpaar. Du erhältst:
   • Client Key (32 Zeichen)
   • Secret Key (64 Zeichen)
4. Kopiere beide Schlüssel — der Secret Key wird dir nur hier angezeigt.

Wichtig: Der Secret Key ist wie ein Passwort. Flowkom speichert ihn verschlüsselt und zeigt ihn nie wieder an.

Schritt 2: In Flowkom verbinden

1. Öffne in Flowkom Einstellungen → Integrationen, klicke Integration hinzufügen und wähle unter Marktplätze die Karte Kaufland.
2. Öffne die Integration und trage Client Key und Secret Key ein.
3. Klicke Verbinden. Flowkom prüft die Schlüssel direkt gegen die Kaufland-API — bei einem Tippfehler bekommst du sofort eine klare Meldung.

Schritt 3: Marktplätze auswählen

Nach dem Verbinden erscheint die Karte Marktplätze. Wähle die Kaufland-Länder aus, die diese Verbindung bespielen soll (Standard: Deutschland).

Währungen: Tschechien (CZK) und Polen (PLN) rechnen in Landeswährung. Flowkom rechnet Bestellungen automatisch mit Tageskurs in EUR um. Erstattungen auf diese Marktplätze erfolgen vorerst über das Seller-Portal.

Artikel listen: Vorschau prüfen, einmal bestätigen

„Bei Kaufland listen” öffnet eine Vorschau — die Katalogprüfung läuft automatisch, du musst nichts anstoßen:

1. Öffne den Artikel (oder Eltern-Artikel) → Reiter Plattformen → „Bei Kaufland listen”.
2. Die Vorschau zeigt eine Zeile je Variante: Preis (vorbelegt, die Herkunft steht daneben — Angebotspreis, UVP plus Preisregel oder UVP) und Menge (vorbelegt aus dem verfügbaren Bestand). Beides kannst du direkt in der Zeile ändern.
3. Das Zellenraster daneben zeigt den Katalogstand je Marktplatz: grün = Katalog-Treffer, gelb = „Produktdaten nötig”. Nichts ist gesperrt — auch Varianten ohne Katalog-Treffer laufen mit.
4. Jetzt listen ist die einzige Bestätigung. Je Variante und Marktplatz entsteht ein Listing-Auftrag, der automatisch bis zum aktiven Angebot läuft.

Danach zeigt der Dialog den Fortschritt — er aktualisiert sich von selbst und darf geschlossen werden, die Aufträge laufen im Hintergrund weiter. Jeder Auftrag sagt in einem Satz, was gerade ist und was als Nächstes passiert. Aktiv heißt dabei: Kaufland meldet das Angebot als kaufbar — nicht nur „angelegt”.

Menge 0: Das Angebot wird trotzdem angelegt — es ist erst kaufbar, sobald Bestand vorhanden ist. Die Bestandsübertragung schaltet es dann automatisch scharf.

Währungen: Der Auftrags-Lister bedient die EUR-Marktplätze. Für kaufland.cz und kaufland.pl braucht es einen eigenen Preis in Landeswährung — Preisänderungen laufen dort über die Kaufland-Karte am Artikel.

Preisregeln je Marktplatz

In der Kaufland-Integration (Karte Preisregeln) legst du je Marktplatz fest, wie der Angebotspreis aus der UVP vorbelegt wird — zum Beispiel Deutschland plus 2 Euro, Österreich plus 5 Euro, jeweils auf ,99 aufgerundet:

• Zuschlag in Euro oder Prozent (auch negativ möglich)
• Rundung: keine, auf ,99, auf ,95 oder auf den vollen Euro — wahlweise auf- oder abgerundet
• Die Vorschau rechnet das Ergebnis an einem echten Artikel vor, bevor du speicherst.

Ein bestehendes Angebot behält immer seinen Preis; ein von Hand getippter Preis schlägt jede Regel.

Wenn Kaufland die EAN noch nicht kennt

Kaufland listet über die EAN: ein Angebot hängt sich an ein bestehendes Katalogprodukt. Kennt Kaufland deine EAN nicht (typisch bei eigenen EANs), braucht es einmal Produktdaten — der Auftrag wartet solange und läuft danach von selbst weiter:

1. Der Auftrag steht auf „Produktdaten nötig” — der Fortschritt führt dich mit einem Klick in den Reiter Produktdaten.
2. Dort füllst du Kategorie und die Pflicht-Merkmale aus. Titel, Beschreibung, Bild, EAN und Hersteller kommen aus Flowkom — sie werden nicht doppelt abgefragt. Den Produktsicherheits-Kontakt (GPSR) pflegst du im Reiter Compliance; er ist bei vielen Kategorien Pflicht.
3. Produktdaten einreichen schickt sie an Kaufland. Die Prüfung dauert in der Regel mehrere Tage.
4. Flowkom fragt den Prüfstand automatisch ab. Nach der Freigabe legt der Auftrag das Angebot ohne weiteres Zutun an; bei einer Ablehnung nennt der Auftrag den Grund und führt zurück in den Reiter.

Gemischte Familien: Kennt Kaufland einen Teil der EANs bereits, gehen diese Varianten sofort Richtung aktives Angebot — die übrigen warten parallel auf ihre Produktdaten. Eine fehlende slowakische Katalogzeile blockiert nicht mehr Deutschland und Österreich.

Rechnungsupload

Kaufland erwartet in der Regel, dass Verkäufer die Rechnung zur Bestellung im Marktplatz hinterlegen. Mit dem Schalter Billkom-Belege hochladen (Karte Rechnungsupload) übernimmt Flowkom das automatisch:

• Sobald eine Rechnung oder Gutschrift zu einer direkt importierten Kaufland-Bestellung finalisiert wird, stellt Flowkom sie in eine Warteschlange und lädt das PDF innerhalb weniger Minuten zu Kaufland hoch.
• Gutschriften werden erst übertragen, nachdem die zugehörige Rechnung erfolgreich hochgeladen wurde.
• Schlägt ein Upload fehl, siehst du den Grund direkt in der Karte und in den Benachrichtigungen — mit einem Klick lässt sich der Upload erneut anstoßen.
• Über Nachreichen kannst du Belege bereits importierter Bestellungen der letzten Tage nachträglich hochladen.

Hinweis: Der Upload gilt für Bestellungen, die über die Kaufland-Direktanbindung importiert wurden. Der Verlauf jeder Bestellung zeigt, wann welcher Beleg übertragen wurde.

Häufige Fragen

„Zugangsdaten ungültig“ beim Verbinden — woran liegt’s? Meist ein Kopierfehler (Leerzeichen am Anfang/Ende) oder es wurde der Client Key mit dem Secret Key vertauscht. Der Client Key hat 32 Zeichen, der Secret Key 64. Erzeuge im Zweifel ein frisches Schlüsselpaar im Seller-Portal.

Kann ich mehrere Kaufland-Konten verbinden? Ja — lege dafür einfach eine zweite Kaufland-Integration an. Jede hat eigene Schlüssel, eigene Angebote, Bestellungen und Aufträge, und im Artikel erscheint je Konto eine eigene Kaufland-Karte. Für weitere Länder brauchst du das nicht: ein Kaufland-Konto deckt alle Länder-Marktplätze bereits ab. Ein zweites Konto ist also für eine zweite Firma gedacht.

Was passiert beim Trennen? Die gespeicherten Schlüssel werden gelöscht und die Synchronisierung stoppt. Bereits importierte Bestellungen und Zuordnungen bleiben erhalten. Du kannst dich jederzeit mit denselben (oder neuen) Schlüsseln wieder verbinden.