Kaufland Marketplace anbinden: So kommen Kaufland-Bestellungen ins ERP

Was Kaufland Marketplace von anderen Marktplätzen unterscheidet

Kaufland Marketplace betreibt eine eigene Verkäufer-Schnittstelle, die Kaufland Seller API v2. Sie deckt Bestellungen, Bestandseinheiten, Versandmeldung, Rechnungs-Upload, Retouren und Erstattung ab, also mehr Richtungen als die meisten Marktplätze. Jede Anfrage wird mit HMAC-SHA256 signiert, ohne OAuth und ohne Token-Erneuerung.

Zwei Besonderheiten prägen die Arbeit mit Kaufland. Erstens ist der Katalog EAN-basiert: Jede Variante braucht eine EAN, über sie werden Produkte zugeordnet und eingereicht. Zweitens gibt es keinen Auszahlungsbericht über die Schnittstelle; Auszahlungen müssen aus den Bestellfinanzen gespiegelt werden.

Nicht verwechseln: Der Marktplatz von Netto Marken-Discount läuft auf der Mirakl-Plattform und wird mit einem eigenen Modul angebunden. Beide Module setzen auf demselben Marktplatz-Kern auf und sehen in Odoo gleich aus.

Zugang: Client Key und Secret Key aus dem Seller Portal

Sie brauchen ein Kaufland-Marketplace-Verkäuferkonto mit freigeschalteter Seller-API. Die Schlüssel finden Sie im Seller Portal unter Einstellungen, Shop-API: ein Client Key und ein Secret Key. Dasselbe Paar gilt für alle Länder-Shops. Je Land legen Sie in Odoo einen Kanal an und wählen den Länder-Shop aus.

Weil der Zeitstempel in die Signatur eingeht, muss die Uhr des Odoo-Servers stimmen. Eine öffentliche Sandbox gibt es nicht; Kauflands Testumgebung bekommen Sie nur nach Absprache. Testen Sie deshalb am Live-Konto mit ausgeschalteten Sendeschaltern: Ab Werk sendet das Modul weder Bestand noch Preise noch Sendungsnummern noch Rechnungen.

Wie Kaufland-Bestellungen ins ERP kommen

Bestellungen werden alle 15 Minuten geholt, einstellbar von jeder Minute bis täglich, neue Bestellungen drei Tage rückblickend, der Statusabgleich 14 Tage. Eine Kaufland-Bestellung kommt mit allen Einheiten. Der Auftrag entsteht beim Status „need_to_be_sent“, also nach der Zahlung; Bestellungen im Status „open“ warten ohne Rechnung.

Produkte werden über die EAN zugeordnet, danach über die Angebots-ID. Ohne Zuordnung landet die Position auf dem Platzhalterprodukt des Kanals mit einem Vorschlag, kein Auftrag bleibt blockiert. Bruttopreise rechnet der Kern über Ihre Produktsteuern in Nettopreise um; Versandkosten und Rabatte werden so ausgeglichen, dass der Auftrag dem vom Käufer bezahlten Betrag entspricht.

Meldet Kaufland „cancelled“ oder „will_not_be_sent“, stoppt der Auftrag in Odoo: Lieferung und Entwurfsrechnung werden abgebrochen, reservierter Bestand ist wieder frei, eine Gutschrift entsteht nach Ihrer Regel, und eine Notiz am Beleg sagt, warum.

Bestand, Preise, Sendungsnummern und Rechnungen

Die Übersicht zeigt je Datenart, in welche Richtung sie fließt und wie das Modul sie bei Kaufland behandelt.

Versandmeldung und Rechnungs-Upload im Detail

Sendungsnummern gehen für alle Einheiten einer Bestellung in einem Aufruf an Kaufland, auch mit mehreren Paketnummern. Als Zusteller werden DPD, DHL, Hermes, GLS, UPS, FedEx, TNT, PostNL und Deutsche Post erkannt, andere gehen als „OTHER“. Versandmeldungen werden bei Fehlern nie blind wiederholt, damit nichts doppelt gemeldet wird; jeder Fehler steht im Protokoll.

Die gebuchte Rechnung geht einmal je Bestellung als PDF zu Kaufland, der Käufer sieht sie in seinem Konto. Je Kanal stellen Sie ein, ob Rechnungen als Entwurf, gebucht oder gebucht und bezahlt entstehen. Ein zweiter Upload zur selben Bestellung ist nicht möglich, prüfen Sie die Rechnung deshalb vor dem Buchen.

Retouren und Erstattungen direkt aus Odoo

Retouren holt das Modul nach Änderungsdatum. Angenommene, geschlossene und erstattete Retouren lösen Rücklieferung und Gutschrift nach Ihrer Regel aus; angekündigte, eingetroffene, in Reparatur oder in Klärung befindliche Retouren sind Information. Die Entscheidung treffen Sie mit dem Knopf „Kaufland-Retourenentscheidung“ auf der Bestellung: annehmen, ablehnen, klären oder reparieren. Jede Retoureneinheit wird genau einmal verarbeitet.

Erstattungen lösen Sie mit dem Knopf „Auf Marktplatz erstatten“ aus, mit Kauflands Gründen und je Einheit gedeckelt. Der Knopf ist auf Manager beschränkt, Erstattungen werden nie automatisch wiederholt. Kaufland erstattet dem Käufer; erstattete Retouren lösen in Odoo die Gutschrift nach Ihrer Regel aus.

Produkte per EAN anlegen und Auszahlungen spiegeln

Der Kaufland Product Launcher reicht Produktdaten je EAN in Kauflands moderierten Katalog ein und verfolgt die Freigabe als Einreichung. Das Angebot je Variante umfasst Preis, Mindestpreis, Menge, Zustand, Bearbeitungszeit, Versandgruppe, Lager, USt-Kennzeichen sowie Öko- und Batterie-Teilnahme. Kategorien, Versandgruppen, Lager und Kategorie-Attribute kommen als Auswahllisten, ein bestehendes Angebot lässt sich zurücklesen.

Weil Kaufland keinen Auszahlungsbericht über die Schnittstelle liefert, baut das Settlement-Modul je Kalendermonat einen Spiegel aus den Finanzen je Bestelleinheit: Umsatz brutto und netto, USt-Satz, Öko- und Verpackungsgebühr. Die Provision wird über die Provisionssatz-Abfrage geschätzt und ist als Schätzung markiert. Erstattungsbeträge fehlen, der Status „bezahlt“ wird nie gesetzt. Die tatsächliche Auszahlung prüfen Sie im Seller Portal.

Was kostet die Kaufland-Anbindung?

Alle Preise netto, einmalig je Odoo-Version, erstes Jahr Updates enthalten, danach Update-Plan 25 % des Kaufpreises im Jahr. Die Einrichtung mit einem Kanal, Versand, Druck und zwei Stunden Schulung gibt es ab 990 €.

• Marktplatz-Kern: 249 €, einmal je Odoo-Instanz, Voraussetzung für jeden Kanal.
• Kaufland Connector: 399 €, zusammen mit dem Kern 648 €.
• Kaufland Product Launcher: 149 € plus Launcher-Basis 199 €.
• Kaufland Settlements: 149 € plus Settlement-Basis 149 €; Settlement Accounting 199 €.
• Netto Marken-Discount Connector (Mirakl): 299 €, mit demselben Kern.
• Paket Start mit einem Kanal nach Wahl: 649 €. Paket Multichannel mit drei Kanälen, Launcher und Settlement: 2.190 €.

Dazu oft gefragt