Kaufland-Einrichtung

Kaufland wird wie jeder Marktplatz auf der merchantCENTRAL-Marktplatzkarte eingerichtet: in der Zeile KAUFLAND der Seite Marktplätze. Dort liegen die Einstellungen des Hubs (Einschalten, Lizenz, Debitor, Verkaufskanäle mit ihren Preislisten) und darunter, im Bereich Kaufland-Einstellungen, alles, was nur Kaufland betrifft. Diese Seite beschreibt den Kaufland-Teil.

Die Verbindung zu Kaufland läuft über die Kaufland Seller API mit Client Key und Secret Key. 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 Suche: Marktplätze → Zeile KAUFLAND
Über die Suche: Kaufland Setup (dieselben Einstellungen, mit der Aktion Open in Hub)
Über die Bestellliste → Aktion Setup
Über den Einrichtungsassistenten: Unterstützte Einrichtung → Gruppe „AD merchantCENTRAL - Einrichtung“ → Kaufland Connector Setup; auf der Marktplatzkarte über die Aktion Setup Wizard

Kaufland Setup als eigene Seite

Einrichten in der merchantCENTRAL-Einrichtung öffnet die Marktplatzkarte auf der Zeile KAUFLAND. Nur die Links in Fehlermeldungen führen auf die Seite Kaufland Setup, die dieselben Einstellungen ohne die Marktplatzkarte zeigt. Mit Open in Hub kommen Sie von dort zur Marktplatzkarte.

Einrichtung Schritt für Schritt

Im Kaufland Seller Portal unter Einstellungen → API Client Key und Secret Key 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 Create Demo Warehouse (Playground) ein Lager an.
Marktplatzkarte, Bereich General: Enabled einschalten. Ohne Lizenz öffnet sich die Demo-Registrierung (Start Free Trial).
Kaufland-Einstellungen: im Bereich Connection für Tests Use Playground einschalten, dann unter Authentication Client Key und Secret Key eintragen.
Test Connection prüft, ob Kaufland die Schlüssel annimmt. Dann Default Warehouse ID und Default Shipping Group ID aus den Auswahllisten wählen: Sie lesen Lagerorte und Versandgruppen Ihres Kaufland-Kontos direkt bei Kaufland.
Storefronts öffnen und die Länder aktivieren, auf denen Sie verkaufen; fehlende Länder legt Add All Storefronts ausgeschaltet an. Die Standard-Storefront schaltet der Einrichtungsassistent beim Abschluss selbst ein. Jede aktivierte Storefront wird ein Verkaufskanal der Marktplatzkarte; der Kanal entsteht beim Einschalten von selbst.
Marktplatzkarte, Bereich Sales Channels: jedem Verkaufskanal eine Verkaufspreisliste in seiner Währung zuordnen (CZ in CZK, PL in PLN, sonst EUR).
Marktplatzkarte, Bereich Data Protection: Sammeldebitor oder ein Debitor je Käufer.
Die geplanten Aufgaben prüfen. Der Preis-Sync SYNC-PRICES-BC ist ausgeschaltet angelegt – Sie entscheiden, wann die Preise aus den Preislisten die Preise bei Kaufland ersetzen.

Felder

Connection

Feld	Beschreibung
Use Playground	Alle Aufrufe gehen an den Kaufland Playground (gelb markiert). Gleiche Schlüssel wie das Live-Konto, keine Auswirkung auf den Live-Shop.
Base URL	Basis-URL der Seller API. Folgt Use Playground und lässt sich nur bei ausgeschaltetem Playground ändern.

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.

Authentication

Feld	Beschreibung
Client Key	32-stelliger API-Client-Key aus dem Kaufland Seller Portal (Einstellungen → API).
Secret Key	64-stelliger Secret Key für die HMAC-Signierung der API-Aufrufe. Wird nicht angezeigt; Klick zum Eingeben oder Ändern.

API-Schlüssel

Der Secret Key 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 Key und Secret Key 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. Die Technologiepartner-Zugangsdaten (siehe unten) gelten dagegen für die ganze Umgebung.

Technology Partner

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 – Sie müssen dafür nichts eintragen.

Feld	Beschreibung
Partner Credentials	Woher die Partner-Zugangsdaten kommen: merchantCENTRAL key vault (AppSource-Installation), Entered in this sandbox (nur Sandbox, zum Testen) oder Not available. Ohne Partner-Zugangsdaten laufen alle Anfragen mit Ihren Verkäufer-Zugangsdaten.
Partner Client Key (Sandbox)	Nur in Sandbox-Umgebungen sichtbar, solange kein Key Vault verfügbar ist.
Partner Secret Key (Sandbox)	Wie oben, der zugehörige Secret Key. Klick zum Eingeben oder Ändern.

Storefront

Feld	Beschreibung
Default 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 Verkaufskanal der Marktplatzkarte. Weitere Storefronts aktivieren Sie später unter Storefronts.

Order Import

Feld	Beschreibung
Create Sales Orders	Aus importierten Kaufland-Bestellungen entstehen Verkaufsaufträge, sobald sie versandbereit sind. Standardmäßig an.

Der Import läuft über die geplante Aufgabe IMPORT-ORDERS (siehe Scheduled Tasks); der Einrichtungsassistent startet sie. Er holt je Storefront nur die Bestellungen, die sich seit dem letzten vollständigen Import geändert haben (Orders Imported Until auf der Storefront Card).

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 Data Protection: Mit Post to a Collective Customer 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 der Bestellung enthält die Versandkosten. Das früheste Datum, bis zu dem Kaufland den Versand einer Position erwartet, wird zum Latest Ship Date des Verkaufsauftrags.

Ein Verkaufsauftrag entsteht, sobald die Bestellung 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; die Bestellung steht so lange auf Open. Ist neben einer zu versendenden Position eine weitere noch Open, wartet die Bestellung, bis Kaufland alle nicht stornierten Positionen freigegeben hat – sonst fehlte diese Position im Verkaufsauftrag. Wird eine Position erst nach der Anlage des Verkaufsauftrags storniert, meldet der Import das an merchantCENTRAL, siehe Stornierung und Verkaufsauftrag. Scheitert ein Auftrag – etwa weil zu einer EAN kein Artikel hinterlegt ist –, steht der Grund in Import Error an der Bestellung; die übrigen Bestellungen laufen weiter, und der nächste Lauf versucht es erneut. Kann Kaufland die Details einer Bestellung nicht liefern, wartet sie mit Import Error und wird beim nächsten Import zuerst erneut gelesen. Fehler des Imports stehen außerdem im Aktivitätsprotokoll von merchantCENTRAL.

Shipment Notices

Feld	Beschreibung
Default Carrier	Kaufland-Spediteur für Versandmeldungen, deren Zusteller weder in der Kaufland Carrier Mapping zugeordnet ist noch an Code oder Name erkannt wird, oder die ohne Zusteller kamen. Leer lassen, um stattdessen bei jeder solchen Meldung einen Hinweis zu bekommen.

Offer Defaults

Feld	Beschreibung
Default Warehouse ID	Kaufland-Lagerort, aus dem neue Angebote versendet werden. Die Auswahl liest die Lagerorte Ihres Kaufland-Kontos.
Default Shipping Group 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 auf der Storefront-Karte. 0 = Kaufland-Standard.
Default VAT Indicator	MwSt.-Kennzeichen neuer Angebote: Regelsatz, ermäßigter Satz oder Nullsatz.

Inventory

Feld	Beschreibung
Auto Sync Inventory	Die geplante Aufgabe SYNC-INV-BC sendet Bestandsänderungen aus Business Central an Kaufland. Standardmäßig an.

Sync Status

Schreibgeschützt.

Feld	Beschreibung
Last Order Sync	Zeitpunkt des letzten Auftragsimports.
Last Order Sync Status	Ergebnis des letzten Imports (Grün = Erfolg, Rot = Fehler).
Last Order Sync Message	Meldung des letzten Imports.

Debugging

Feld	Beschreibung
Log API Requests	Schreibt jeden API-Aufruf mit Request- und Response-Body in das API Log. 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 Aktionen stehen im Menü des Bereichs Kaufland-Einstellungen. Bestellungen importiert die Aktion Sync Orders der Marktplatzkarte oder das Dashboard.

Aktion	Beschreibung
Test Connection	Prüft, ob Kaufland Client Key und Secret Key annimmt: mit einer Anfrage, die Kaufland anhand der Schlüssel prüft. Lehnt Kaufland ab, nennt die Meldung Kauflands Antwort.
Create Demo Warehouse (Playground)	Nur bei eingeschaltetem Playground: legt ein Lager mit Platzhalteradresse an und trägt es als Default Warehouse ID ein.
Storefronts	Öffnet die Storefronts.
Warehouses	Öffnet die Lager.
Carrier Mapping	Öffnet die Zuordnung der Kaufland-Spediteure zu den Zustellern. Nur nötig, wo Code oder Name eines Zustellers den Spediteur nicht verraten.
Scheduled Tasks	Öffnet die geplanten Aufgaben.
API Log	Öffnet das API Log.