Zum Inhalt

Kaufland-Einrichtung

Kaufland hat eine Einrichtungsseite: die Marktplatzkarte von merchantCENTRAL (Marktplatzeinrichtung) auf der Zeile KAUFLAND. Auf ihr steht alles, was Kaufland betrifft: die Einstellungen des Hubs (Einschalten, Lizenz, Debitor, Preisprüfung, Stornierungen), der Bereich Kaufland-Einstellungen für Kaufland als Ganzes, die Liste Verkaufskanäle mit einer Zeile je Storefront und darunter die Einstellungen der Storefront, die in dieser Liste ausgewählt ist. Diese Seite beschreibt die Kaufland-Teile der Karte. Den ganzen Weg bis zum ersten Auftrag beschreibt Erste Schritte.

Die Verbindung zu Kaufland läuft über die Kaufland Seller API mit Client-Schlüssel und Geheimschlüssel. Für Tests gibt es den Playground: Er nimmt dieselben Schlüssel wie das Live-Konto, berührt aber keinen Auftrag, kein Angebot und keinen Preis im Live-Shop.

Seite öffnen

  • Über die merchantCENTRAL-Einrichtung (Rollencenter-Menü Einrichtung): Liste Marktplätze → Zeile KAUFLAND → Einrichten
  • Über die Suche: Marktplätze → Zeile KAUFLAND
  • Über die Kaufland-Aufträge → Aktion Einrichtung
  • Über das Kaufland-Dashboard: Klick auf den Verbindungsmodus
  • Aus einer Fehlermeldung: Kaufland-Einrichtung öffnen. Nennt die Meldung eine Storefront, ist sie in der Liste Verkaufskanäle ausgewählt.
  • Am Ende des Einrichtungsassistenten öffnet sich die Karte von selbst, mit der Standard-Storefront ausgewählt. Den Assistenten startet Unterstützte Einrichtung → Gruppe „AD merchantCENTRAL-Einrichtung“ → Einrichtung Kaufland-Connector oder auf der Karte die Aktion Einrichtungsassistent.

Aufbau der Seite

Bereich Inhalt
Allgemein Aktiviert schaltet Kaufland ein. Ohne Lizenz öffnet sich die Demo-Registrierung (Kostenlose Testversion starten).
Datenschutz Sammeldebitor oder ein Debitor je Käufer.
Kaufland-Einstellungen Verbindung, Schlüssel, Standard-Storefront, Auftragsimport, Angebotsvorgaben, Bestand, Fehlersuche – siehe Felder.
Verkaufskanäle Eine Zeile je Storefront, auch für ausgeschaltete. Hier schalten Sie eine Storefront mit Aktiviert ein oder aus und ordnen ihr die Verkaufspreisliste in ihrer Währung zu. Siehe Storefront und Verkaufskanal.
Einstellungen des Verkaufskanals Die Einstellungen des Hubs für die Storefront, die in der Liste ausgewählt ist.
Kaufland-Storefront Unter Verbindung des Verkaufskanals: Versandgruppe, Importstände und Statistiken der ausgewählten Storefront – siehe Kaufland-Storefront.
Preisprüfung, Bearbeitungszeit, Stornierungen, Auftragsimport, Auftragsautomatisierung Einstellungen des Hubs; sie gelten für jede Storefront, die in der Liste nicht abweicht.
Synchronisation, Letzter Fehler, Lizenz Wie bei jedem Marktplatz.

Die Abrechnungen und die Automatik für vom Marktplatz versendete Aufträge blendet die Karte für Kaufland aus: Der Connector importiert keine Kaufland-Auszahlungen, und kein Kaufland-Auftrag gilt als vom Marktplatz versendet.


Einrichtung Schritt für Schritt

  1. Im Kaufland Seller Portal unter Einstellungen → API-Schlüssel Client-Schlüssel und Geheimschlüssel erzeugen. Dort auch prüfen, auf welchen Storefronts (Ländern) das Konto verkauft, und unter Einstellungen ein Warenlager (Warenlager hinzufügen) und je Storefront eine Versandgruppe (Versand-Einstellungen) anlegen – ohne Versandgruppe nimmt Kaufland keine Angebote an. Im Playground legt Demo-Lager anlegen (Playground) ein Lager an.
  2. Bereich Allgemein: Aktiviert einschalten.
  3. Kaufland-Einstellungen: im Bereich Verbindung für Tests Playground verwenden einschalten, dann unter Authentifizierung Client-Schlüssel und Geheimschlüssel eintragen.
  4. Verbindung testen prüft, ob Kaufland die Schlüssel annimmt. Dann Standard-Lager-ID und Standard-Versandgruppen-ID aus den Auswahllisten wählen: Sie lesen Lager und Versandgruppen Ihres Kaufland-Kontos direkt bei Kaufland.
  5. Storefronts hinzufügen nimmt die Storefronts von Kaufland, die noch fehlen, ausgeschaltet in die Liste Verkaufskanäle auf. Schalten Sie dort mit Aktiviert jede Storefront ein, auf der Sie verkaufen. Die Standard-Storefront schaltet der Einrichtungsassistent beim Abschluss selbst ein.
  6. Verkaufskanäle: jeder eingeschalteten Storefront eine Verkaufspreisliste in ihrer Währung zuordnen (CZ in CZK, PL in PLN, sonst EUR).
  7. Versandgruppen der übrigen Storefronts: die Storefront in der Liste auswählen und darunter im Teil Kaufland-Storefront die Versandgruppen-ID wählen.
  8. Bereich Datenschutz: Sammeldebitor oder ein Debitor je Käufer.
  9. Die geplanten Aufgaben prüfen (Aktion Geplante Kaufland-Aufgaben). Der Preisabgleich SYNC-PRICES-BC ist ausgeschaltet angelegt – Sie entscheiden, wann die Preise aus den Preislisten die Preise bei Kaufland ersetzen. Die Rechnungen der Aufträge lädt UPLOAD-INVOICES von selbst hoch.

Storefront und Verkaufskanal

Kaufland verkauft auf neun Storefronts, je Land eine. Jede Storefront in der Liste ist ein Verkaufskanal von Kaufland, auch eine ausgeschaltete – die Liste Verkaufskanäle ist der Ort, an dem sie eingeschaltet wird.

  • Ein Schalter je Storefront: Aktiviert in der Liste Verkaufskanäle. Eingeschaltet werden ihre Aufträge, Retouren, Tickets und Angebote importiert, ihre Angebote bekommen Bestand und Preise. Ausgeschaltet wird für sie nichts importiert und nichts gesendet.
  • Neue Storefronts: Storefronts hinzufügen nimmt die Storefronts von Kaufland auf, die in der Liste noch fehlen – ausgeschaltet, denn Sie entscheiden, auf welchen Ländern Sie verkaufen. Jede steht sofort als Verkaufskanal in der Liste. Bei Kaufland wird dabei nichts angelegt und nichts gesendet.
  • Preisliste und Währung stehen je Storefront in derselben Liste. CZ verkauft in CZK, PL in PLN, alle übrigen in EUR. Die Preisliste muss in dieser Währung geführt sein, sonst wird kein Preis gesendet. Einen Rückfall auf den VK-Preis des Artikels gibt es nicht.
  • Sprache: Jeder Verkaufskanal bekommt die Sprache seiner Storefront vorgeschlagen – Polnisch für PL, Tschechisch für CZ; DE und AT bekommen die Sprache der Artikeltexte, sofern sie deutsch ist (auch Deutsch – Österreich) –, in der auch die Produktdaten an Kaufland gehen. Das gilt nur, solange seine Sprache in der Liste Verkaufskanäle leer ist; eine dort gesetzte Sprache bleibt. Verkaufskanäle aus früheren Versionen übernehmen die Sprache einmalig mit dem Update auf Version 1.15. Kennt der Mandant keine Sprache für die Storefront, bleibt das Feld leer. Sollen auf einer Storefront die Texte der Artikel unverändert gesendet werden, tragen Sie am Verkaufskanal die Sprache der Artikeltexte ein. Was die Sprache bewirkt, steht unter Beschreibung in der Sprache der Storefront.
  • Karte öffnen: Fehlt einer Storefront der Verkaufskanal, legt die Karte ihn beim Öffnen auf der Zeile KAUFLAND an; sonst ändert sich nichts.

Welche Storefronts die Läufe abarbeiten:

  • Aufträge, Retouren, Tickets, Angebote, Importdateien sowie der Bestands- und Preisabgleich laufen je eingeschalteter Storefront.
  • Die Standard-Storefront der Kaufland-Einstellungen springt nur ein, solange noch keine Storefront eingerichtet ist. Sind alle Storefronts ausgeschaltet, wird nichts importiert und nichts gesendet.
  • Ein Verkaufskanal von Kaufland, dessen Code keine Kaufland-Storefront ist, wird nicht abgeglichen; der Lauf gilt als fehlgeschlagen, und das Aktivitätsprotokoll nennt den Kanal. Der Teil Kaufland-Storefront bleibt für ihn leer. Entfernen Sie den Kanal aus der Liste oder schalten Sie die Storefront ein, für die er steht.

Felder

Die Felder stehen im Bereich Kaufland-Einstellungen.

Verbindung

Feld Beschreibung
Modus Zeigt, wohin die Anfragen des Connectors gehen: Simulation (nirgendwohin), Playground oder Live. Nur Anzeige.
Simulationsmodus Der Connector arbeitet ohne Kaufland: Keine Anfrage geht hinaus, auch nicht an den Playground. Versandbestätigungen, Rechnungen, Stornos, Erstattungen, Retourenentscheidungen, Ticketantworten, Angebote, Preise und Bestand bestätigt Business Central so, als hätte Kaufland sie angenommen. Für Vorführungen und Tests; braucht keine Schlüssel.
Playground verwenden Alle Aufrufe gehen an den Kaufland Playground (gelb markiert). Gleiche Schlüssel wie das Live-Konto, keine Auswirkung auf den Live-Shop.
Basis-URL Basis-URL der Seller API. Nicht änderbar: Playground verwenden setzt sie auf die Adresse der Live-API oder des Playgrounds. Eine andere Adresse nimmt der Connector nicht an, und an sie geht keine Anfrage.

Simulationsmodus

Den Simulationsmodus schalten nur Benutzer mit dem Berechtigungssatz ALN MCK Admin um, und erst nach einer Rückfrage, die standardmäßig Nein vorschlägt. Er gilt vor Playground verwenden: Sind beide an, geht auch an den Playground nichts. Wo Kaufland eine Kennung zurückgeben würde, vergibt der Connector eine mit dem Präfix SIM-. Aufträge, Retouren und Tickets kommen im Simulationsmodus nicht von Kaufland, sondern nur über die Demo-App AD merchantCENTRAL Demo Kaufland; die geplanten Importe laufen ohne Anfrage durch und melden das im Status. Der Einrichtungsassistent bietet den Modus nicht an, er fragt die Schlüssel ab – schalten Sie ihn hier ein.

User-Agent

Kaufland verlangt von Softwareanbietern den Namen ihrer Lösung im User-Agent-Header. merchantCENTRAL sendet deshalb fest merchantCENTRAL/<Version>; ein eigenes Feld dafür gibt es nicht.

Kopie in eine Sandbox

Wird eine Umgebung in eine Sandbox kopiert, schaltet der Connector in der Kopie Playground verwenden ein. Die Schlüssel bleiben erhalten, aber Bestand, Preise und Versandbestätigungen der Kopie erreichen den Live-Shop nicht. Soll die Sandbox doch mit dem Live-Konto arbeiten, schalten Sie den Playground dort bewusst aus.

Authentifizierung

Feld Beschreibung
Client-Schlüssel 32-stelliger Client-Schlüssel aus dem Kaufland Seller Portal (Einstellungen → API-Schlüssel).
Geheimschlüssel 64-stelliger Geheimschlüssel für die HMAC-Signierung der API-Aufrufe. Wird nicht angezeigt – das Feld zeigt nur Konfiguriert oder Nicht konfiguriert; Klick zum Eingeben oder Ändern.

Eingeben, ändern und löschen dürfen die Schlüssel nur Benutzer, die die Kaufland-Einstellungen ändern dürfen (Berechtigungssatz ALN MCK Admin).

API-Schlüssel

Der Geheimschlüssel wird verschlüsselt gespeichert. Bewahren Sie die Schlüssel sicher auf – bei Verlust muss ein neuer Schlüssel im Kaufland Seller Portal erzeugt werden.

Je Mandant

Client-Schlüssel und Geheimschlüssel gelten nur für den Mandanten, in dem Sie sie eintragen. So kann jeder Mandant mit einem eigenen Kaufland-Konto arbeiten, ohne die Schlüssel eines anderen Mandanten zu überschreiben. Arbeitet ein weiterer Mandant mit Kaufland, tragen Sie die Schlüssel dort erneut ein.

Technologiepartner

Mit den Technologiepartner-Zugangsdaten von merchantCENTRAL signiert der Connector jede Anfrage ein zweites Mal (Header Shop-Partner-Client-Key und Shop-Partner-Signature) und weist sich so gegenüber Kaufland als verwendete Software aus. Die Partner-Zugangsdaten gehören Altenbrand, nicht dem Verkäufer. Der Connector bezieht sie selbst aus dem Key Vault der App, in Produktiv- und Sandbox-Umgebungen gleichermaßen. Die Einrichtung hat dafür kein Feld, Sie müssen nichts eintragen.

Sind keine Partner-Zugangsdaten verfügbar, laufen alle Anfragen mit Ihren Verkäufer-Zugangsdaten allein. Kaufland nimmt sie genauso an.

Storefront

Feld Beschreibung
Standard-Storefront Storefront für Anfragen, die an keine Storefront gebunden sind, etwa die Listen der Lager und Versandgruppen. Der Einrichtungsassistent schaltet sie beim Abschluss ein; sie wird damit der erste eingeschaltete Verkaufskanal. Weitere Storefronts schalten Sie in der Liste Verkaufskanäle ein. Für die Importe gilt sie nur, solange noch keine Storefront eingerichtet ist; danach wird nur für eingeschaltete Storefronts importiert.

Auftragsimport

Feld Beschreibung
Verkaufsaufträge erstellen Aus importierten Kaufland-Aufträgen entstehen Verkaufsaufträge, sobald sie versandbereit sind. Standardmäßig an.

Der Import läuft über die geplante Aufgabe IMPORT-ORDERS (siehe Geplante Kaufland-Aufgaben); der Einrichtungsassistent startet sie. Er arbeitet die eingeschalteten Storefronts ab und holt je Storefront nur die Aufträge, die sich seit dem letzten vollständigen Import geändert haben (Aufträge importiert bis im Teil Kaufland-Storefront). Sind alle Storefronts ausgeschaltet, wird kein Auftrag importiert. Wann der letzte Auftragsimport lief und ob er scheiterte, zeigt das Kaufland-Dashboard in der Karte Verbindung und Aufgaben.

Die Verkaufsaufträge legt der zentrale Auftragsimport von merchantCENTRAL an – wie bei allen Marktplätzen. Welcher Debitor den Auftrag erhält, steht auf der Marktplatzkarte im Bereich Datenschutz: Mit Auf Sammeldebitor buchen laufen alle Aufträge auf einen Sammeldebitor, ohne diese Einstellung legt der Import je Käufer einen Debitor an (Wiedererkennung über die Kaufland-Käufer-ID). Die Preise gehen so an merchantCENTRAL, wie der Käufer sie bezahlt hat: brutto, auch die Versandkosten, und der Verkaufsauftrag führt sie als Preise inkl. MwSt., unabhängig von der Debitorenvorlage. Der Gesamtbetrag des Auftrags enthält die Versandkosten. Das früheste Datum, bis zu dem Kaufland den Versand einer Einheit erwartet, wird zum Datum Versand bis des Verkaufsauftrags.

Ein Verkaufsauftrag entsteht, sobald der Auftrag zu versenden ist. In den ersten 15 Minuten nach dem Kauf hält Kaufland die Adressen zurück, weil der Käufer noch stornieren kann; der Auftrag steht so lange auf Offen. Ist neben einer zu versendenden Einheit eine weitere noch Offen, wartet der Auftrag, bis Kaufland alle nicht stornierten Einheiten freigegeben hat – sonst fehlte diese Einheit im Verkaufsauftrag. Wird eine Einheit erst nach der Anlage des Verkaufsauftrags storniert, meldet der Import das an merchantCENTRAL, siehe Stornierung und Verkaufsauftrag.

Findet merchantCENTRAL zu einer EAN weder einen Artikel noch ein Angebot, entscheidet die Einstellung Auftrag bei unbekanntem Artikel anhalten der Marktplatzkarte: eingeschaltet hält merchantCENTRAL den Auftrag an (Status Angehalten), bis Sie die SKU zugeordnet und den Auftrag mit Erneut importieren erneut importiert haben; sonst scheitert der Auftrag (Status Fehler). Den Grund nennt in beiden Fällen Fehlermeldung am Auftrag, siehe Kaufland-Aufträge. Die übrigen Aufträge laufen weiter, und der nächste Lauf versucht es erneut. Kann Kaufland die Details eines Auftrags nicht liefern, wartet er mit dem Grund in Fehlermeldung und wird beim nächsten Import zuerst erneut gelesen. Fehler des Imports stehen außerdem im Aktivitätsprotokoll von merchantCENTRAL.

Angebotsvorgaben

Feld Beschreibung
Standard-Lager-ID Kaufland-Lager, aus dem neue Angebote versendet werden. Die Auswahl liest die Lager Ihres Kaufland-Kontos.
Standard-Versandgruppen-ID Versandgruppe neuer Angebote auf der Standard-Storefront; die Auswahl liest die Versandgruppen dieser Storefront aus Ihrem Kaufland-Konto. Eine Versandgruppe gehört zu genau einer Storefront, die übrigen Storefronts haben ihre eigene im Teil Kaufland-Storefront. 0 = Kaufland-Standard.
Standard-MwSt.-Kennzeichen MwSt.-Kennzeichen neuer Angebote, etwa Normalsatz, Ermäßigter Satz 1 oder Nullsatz. Kaufland setzt es je Storefront in den dortigen Steuersatz um.

Bestand

Feld Beschreibung
Bestand automatisch synchronisieren Ob der Bestand aus Business Central an Kaufland gesendet wird. Ausgeschaltet stoppt der Schalter jeden Bestandslauf: Die geplante Aufgabe SYNC-INV-BC und Bestand synchronisieren der Marktplatzkarte senden keine Mengen, die gleichnamige Aktion auf den Kaufland-Angeboten endet mit einem Hinweis, und Buchungen markieren keine Angebote mehr zum Senden. Die Angebote behalten die Menge, die Kaufland hat. Standardmäßig an.

Fehlersuche

Feld Beschreibung
API-Anfragen protokollieren Schreibt jeden API-Aufruf mit Anfrage- und Antworttext in das API-Protokoll. Für die Fehlersuche; im Tagesbetrieb ausgeschaltet lassen. Einträge, die älter als 30 Tage sind, werden automatisch gelöscht. Das Aktivitätsprotokoll von merchantCENTRAL hängt nicht an diesem Schalter.

Aktionen

Die Kaufland-Aktionen erscheinen nur auf der Zeile KAUFLAND. Aufträge importiert die Aktion Aufträge importieren der Marktplatzkarte oder das Kaufland-Dashboard. Die Aktionen einer einzelnen Storefront stehen im Teil Kaufland-Storefront.

Auf der Karte

Aktion Beschreibung
Storefronts hinzufügen Nimmt nach Rückfrage die Storefronts von Kaufland, die in der Liste Verkaufskanäle noch fehlen, ausgeschaltet auf und meldet, wie viele es waren. Vorhandene Storefronts bleiben unverändert, an Kaufland geht nichts. Schalten Sie danach die Storefronts ein, auf denen Sie verkaufen. Nur aktiv für Administratoren von merchantCENTRAL mit dem Berechtigungssatz ALN MCK Admin.
Verbindung testen Prüft, ob Kaufland Client-Schlüssel und Geheimschlüssel annimmt: mit einer Anfrage, die Kaufland anhand der Schlüssel prüft. Lehnt Kaufland ab, nennt die Meldung Kauflands Antwort. Im Simulationsmodus geht keine Anfrage hinaus, und die Meldung sagt, dass nichts geprüft wurde.
Kaufland-Lager Öffnet die Kaufland-Lager.
Kaufland-Zustelldienst-Zuordnung Öffnet die Kaufland-Zustelldienst-Zuordnung. Nur nötig, wo Code oder Name eines Zustellers den Spediteur nicht verraten.
Geplante Kaufland-Aufgaben Öffnet die geplanten Aufgaben.
Kaufland-API-Protokoll Öffnet das API-Protokoll. Nur aktiv für Benutzer, die das Protokoll lesen dürfen.

Im Bereich Kaufland-Einstellungen

Aktion Beschreibung
Geheimschlüssel löschen Löscht nach Rückfrage den Geheimschlüssel dieses Mandanten – etwa bevor Sie den Connector übergeben oder entfernen oder wenn der Schlüssel bekannt geworden ist. Bis ein neuer Schlüssel eingegeben ist, geht keine Anfrage an Kaufland. Nur aktiv, solange ein Geheimschlüssel gespeichert ist.
Demo-Lager anlegen (Playground) Nur bei eingeschaltetem Playground: legt ein Lager mit Platzhalteradresse an und trägt es als Standard-Lager-ID ein.

Siehe auch: Kaufland-Storefront · Erste Schritte · Fehlerbehebung · Häufige Fragen