Kaufland API Setup
Zentrale Einrichtungsseite für den Kaufland Connector. Hier werden die API-Zugangsdaten, Bestellimport-Einstellungen, Synchronisationsstatus und Debug-Optionen konfiguriert.
Die Verbindung zu Kaufland erfolgt über die Kaufland Seller API mit Client Key und Secret Key. Zusätzlich steht eine Playground-Umgebung (Sandbox) für Tests zur Verfügung.
Seite öffnen
- Über die Suche: Kaufland API Setup
- Über das Role Center → Administration → Setup
- Über das Dashboard → Aktion Setup
Felder
General
Allgemeine API-Einstellungen.
| Feld | Beschreibung |
|---|---|
| Base URL | Basis-URL der Kaufland Seller API (z. B. https://sellerapi.kaufland.de/v2). |
| Use Playground | Wenn aktiviert, werden alle API-Aufrufe an die Kaufland-Sandbox-Umgebung gesendet. Ideal für Tests ohne Auswirkungen auf den Produktivshop. |
| Default Storefront | Standard-Ländershop für API-Aufrufe (z. B. DE, AT). Kann pro Storefront-Konfiguration überschrieben werden. |
| User Agent | HTTP User-Agent-Header für API-Aufrufe. Identifiziert das aufrufende System gegenüber Kaufland. |
Authentication
Zugangsdaten für die Kaufland Seller API.
| Feld | Beschreibung |
|---|---|
| Client Key | 32-stelliger API-Client-Key aus dem Kaufland-Seller-Portal. Zu finden unter Einstellungen > API-Zugang. |
| Secret Key | 64-stelliger Secret Key für die HMAC-Signierung der API-Aufrufe. Wird maskiert angezeigt (***). |
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 generiert werden.
Order Import
Einstellungen für den automatischen Bestellimport.
| Feld | Beschreibung |
|---|---|
| Auto Import Orders | Aktiviert den automatischen Bestellimport über die Job Queue. |
| Order Import Interval (Min) | Intervall in Minuten für den automatischen Bestellimport. Nur aktiv, wenn Auto Import Orders aktiviert ist. |
| Create Sales Orders | Wenn aktiviert, werden importierte Kaufland-Bestellungen automatisch als BC-Verkaufsaufträge angelegt. |
| Default Customer No. | Standard-Debitorennummer für automatisch erstellte Verkaufsaufträge. Nur aktiv, wenn Create Sales Orders aktiviert ist. |
Sync Status
Schreibgeschützte Statusinformationen zur letzten Synchronisation.
| Feld | Beschreibung |
|---|---|
| Last Order Sync | Zeitstempel der letzten Bestellsynchronisation. |
| Last Order Sync Status | Status der letzten Synchronisation (farblich hervorgehoben: Grün = Erfolg, Rot = Fehler). |
| Last Order Sync Message | Statusmeldung oder Fehlerbeschreibung der letzten Synchronisation. |
Debugging
| Feld | Beschreibung |
|---|---|
| Log API Requests | Wenn aktiviert, werden alle API-Aufrufe im API Log protokolliert (inkl. Request/Response Body). Nützlich für Fehlerdiagnose, sollte im Produktivbetrieb aus Performance-Gründen deaktiviert werden. |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Test Connection | Testet die Verbindung zur Kaufland Seller API mit den eingetragenen Zugangsdaten. Bei Erfolg erscheint eine Bestätigung, bei Fehler die Fehlermeldung. |
| Import Orders | Startet den manuellen Bestellimport. Alle neuen Bestellungen seit der letzten Synchronisation werden importiert. |
| View Orders | Öffnet die Bestellliste. |
| View API Log | Öffnet das API Log mit allen protokollierten API-Aufrufen. |