# Voraussetzungen & Fehlersuche beim Bestellabruf

> Welche Kaufland-Bestellungen abgerufen werden, was die Besonderheiten sind – und was zu tun ist, wenn eine Bestellung nicht ankommt oder die Versandrückmeldung fehlschlägt.

FFN Connect ruft Bestellungen von Kaufland in regelmäßigen Abständen automatisch ab und reagiert zusätzlich auf Kaufland-Webhooks (z. B. bei neuen Bestellungen). Damit eine Bestellung übertragen wird, müssen die folgenden Voraussetzungen erfüllt sein.

> [!HINWEIS]
> Kaufland ist ein **Marktplatz**, kein Shopsystem. Deshalb gibt es **keine Bestellstatus-Tabelle** wie bei Shop-Anbindungen. Welche Bestellungen abgerufen werden, steuert Kaufland selbst über den Versandstatus der Bestellung.

## Voraussetzungen für den Bestellabruf

### 1. Die Bestellung muss versandbereit sein

FFN Connect ruft **nur Bestellungen ab, die bei Kaufland den Zustand „muss versendet werden" haben** (Kauflands interner Status `need_to_be_sent`). Das sind die Bestellungen, die auf deinen Versand warten.

**Nicht abgerufen** werden dadurch:

- Bestellungen, die noch **nicht bezahlt/bestätigt** sind und damit noch nicht zum Versand freigegeben wurden
- Bestellungen, die **bereits als versendet** gemeldet wurden
- **stornierte** Bestellungen

### 2. Der Storefront muss übereinstimmen

Jeder Verkaufskanal ist mit **genau einem Storefront** (Land) verbunden. Es werden ausschließlich Bestellungen dieses Marktplatz-Landes abgerufen.

> [!WICHTIG]
> Verkaufst du auf mehreren Kaufland-Marktplätzen (z. B. DE und CZ), brauchst du **pro Land einen eigenen Verkaufskanal**. Fehlen die Bestellungen eines bestimmten Landes, ist häufig kein Verkaufskanal für diesen Storefront angelegt.

### 3. Das Bestelldatum muss im Abruf-Zeitraum liegen

FFN Connect ruft Bestellungen ab dem Datum ab, das beim Aktivieren des automatischen Bestellabrufs festgelegt wurde. Bestellungen, die **vor** diesem Startdatum aufgegeben wurden, werden nicht automatisch übertragen.

## Besonderheit: Bestellung = mehrere Positionen

Eine Kaufland-Bestellung besteht aus einzelnen **Order-Units** (eine pro gekaufter Position). Jede Position kann grundsätzlich **einzeln versendet** werden – Teillieferungen sind damit möglich. FFN Connect fasst die Positionen einer Bestellung automatisch zu einer Bestellung zusammen.

## Warum wird eine einzelne Bestellung nicht abgerufen?

Gehe die folgenden Punkte der Reihe nach durch:

### Die Bestellung ist noch nicht versandbereit (häufigster Fall)

Prüfe im Kaufland Seller-Portal, ob die Bestellung wirklich den Zustand „muss versendet werden" hat. Solange sie z. B. noch auf den Zahlungseingang wartet, wird sie nicht abgerufen.

- **Lösung:** Warte, bis Kaufland die Bestellung zum Versand freigibt. Sie wird beim nächsten Abruf automatisch übertragen.

### Die Bestellung gehört zu einem anderen Storefront

Prüfe, auf welchem Marktplatz-Land die Bestellung aufgegeben wurde, und vergleiche es mit dem Storefront deines Verkaufskanals (siehe Voraussetzung 2).

### Die Bestellung liegt vor dem Startdatum des Abrufs

Prüfe das Bestelldatum gegen den eingestellten Abruf-Zeitraum (siehe Voraussetzung 3).

### Die Verbindung zum Konto ist gestört

Wurden Client Key oder Secret Key zwischenzeitlich neu erzeugt oder widerrufen, kann der Abruf fehlschlagen.

- **Lösung:** Öffne den Verkaufskanal und hinterlege bei Bedarf die aktualisierten Zugangsdaten erneut (siehe [Dein Kaufland-Konto verbinden](/docs/merchants/kaufland/connect-marketplace)).

## Versand & Tracking an Kaufland zurückmelden

Sobald eine Bestellung versendet wurde, meldet FFN Connect den Versand mit **Trackingnummer** und **Versanddienstleister** an Kaufland zurück und setzt die Position dort auf „versendet".

Damit das funktioniert, gilt:

### Es muss eine Trackingnummer vorhanden sein

> [!WICHTIG]
> Ohne Trackingnummer wird der Versand **nicht** an Kaufland gemeldet – die Bestellung bleibt dort offen. Stelle sicher, dass das Versandetikett bzw. der Versanddienstleister eine Trackingnummer liefert, bevor die Bestellung als versendet gilt.

### Der Versanddienstleister muss erkannt werden

Kaufland erwartet einen bekannten Versanddienstleister. Folgende Dienstleister werden zugeordnet:

| Versanddienstleister |
|----------------------|
| DHL / DHL Express |
| Deutsche Post |
| DPD |
| GLS |
| Hermes |
| UPS |
| FedEx |
| Austrian Post |
| Asendia |

Lässt sich der Versanddienstleister nicht eindeutig zuordnen, wird er als **„Other"** (Sonstige) gemeldet.

> [!TIPP]
> Bleibt eine bereits versendete Bestellung bei Kaufland offen, ist fast immer eine **fehlende Trackingnummer** die Ursache. Fehlen dagegen viele oder alle Bestellungen, deutet das eher auf ein **Verbindungsproblem** oder einen **falschen Storefront** hin.