# Dein Kaufland-Konto verbinden

> Schritt-für-Schritt-Anleitung, wie du dein Kaufland-Verkäuferkonto mit FFN Connect verbindest.

## Schritt 1: Voraussetzungen

FFN Connect kommuniziert mit Kaufland über die **Kaufland Seller-API (v2)**. Du benötigst dafür:

- Einen **Client Key** und einen **Secret Key** aus deinem Kaufland-Verkäuferkonto
- Die Angabe deines **Storefronts** – also des Marktplatz-Landes, auf dem du verkaufst (DE, AT, CZ, SK oder PL)

Die API-Zugangsdaten findest du im Kaufland Seller-Portal in den **Einstellungen** im Bereich für API-Schlüssel/Integrationen.

> [!HINWEIS]
> Die genaue Bezeichnung des Menüpunkts kann sich im Kaufland Seller-Portal ändern. Suche nach dem Bereich, in dem du „API-Schlüssel" bzw. „Client Key" und „Secret Key" erzeugen kannst. Bewahre den Secret Key sicher auf – er wird in der Regel nur einmal angezeigt.

<!-- TODO Bild: Screenshot des Kaufland Seller-Portals, wo Client Key und Secret Key erzeugt werden -->

> [!WICHTIG]
> Ein Verkaufskanal in FFN Connect bildet **genau einen Storefront** (ein Land) ab. Verkaufst du auf mehreren Kaufland-Marktplätzen (z. B. DE und CZ), lege bitte **pro Land einen eigenen Verkaufskanal** an.

## Schritt 2: Verkaufskanal hinzufügen

1. Wechsle in deinem Fulfillment-Portal zu **Verkaufskanäle → Verkaufskanal hinzufügen**.
2. Wähle **Kaufland** aus.
3. Gib einen Namen für den Verkaufskanal ein (optional).
4. Trage deinen **Client Key** und deinen **Secret Key** ein.
5. Wähle den passenden **Storefront** (Verkaufsland) aus.
6. Klicke auf **Weiter**.

<!-- TODO Bild: Screenshot des FFN-Connect-Formulars zum Anlegen des Kaufland-Verkaufskanals (Client Key, Secret Key, Storefront) -->

FFN Connect prüft die Verbindung sofort. Schlägt sie fehl, kontrolliere bitte Client Key, Secret Key und den ausgewählten Storefront.

## Schritt 3: Artikel synchronisieren

1. Öffne deinen Kaufland-Verkaufskanal in FFN Connect, indem du zu **Verkaufskanäle** navigierst und auf den Namen des Verkaufskanals klickst.
2. Klicke auf **Produkte synchronisieren**.
3. Klicke auf **Fortfahren und synchronisieren**.

Der Vorgang kann je nach Anzahl deiner Listings einige Minuten dauern. Anschließend siehst du deine Produkte in der Tabelle des Verkaufskanals. Damit dein Fulfillment-Dienstleister sie bearbeiten kann, gib sie im Hauptmenü unter **Artikel** frei — wie das geht, erklärt der Artikel [Artikel an den Fulfiller freigeben](/docs/merchants/basics/products/release-to-fulfiller).

> [!HINWEIS]
> Über die Kaufland-Anbindung werden bestehende **Listings gelesen** und der **Bestand aktualisiert**. Das Anlegen neuer Listings oder das Ändern von Titeln, Beschreibungen und Bildern erfolgt weiterhin direkt im Kaufland Seller-Portal.

## Schritt 4: Bestellabruf verstehen

Kaufland-Bestellungen werden automatisch abgerufen, sobald sie versandbereit sind. Es gibt – anders als bei klassischen Shopsystemen – **keine manuelle Bestellstatus-Auswahl**. Welche Bestellungen abgerufen werden und worauf du achten musst, ist hier beschrieben:

[Voraussetzungen & Fehlersuche beim Bestellabruf](/docs/merchants/kaufland/order-troubleshooting)

## Schritt 5: Testbestellungen durchführen

Wir empfehlen, nach Abschluss der Einrichtung eine oder mehrere Testbestellungen durchzuführen, um den Ablauf kennenzulernen:

- **Produkte ignorieren:** Teste, wie du bestimmte Produkte aus Bestellungen ausschließen kannst.
- **Regeln festlegen:** Lege fest, wie bestimmte Situationen behandelt werden sollen.
- **Bestand prüfen:** Erstelle Bestellungen für Produkte ohne Bestand.
- **Versandrückmeldung:** Verfolge, ob Trackingnummer und Versanddienstleister korrekt an Kaufland zurückgemeldet werden.
