# Voraussetzungen & Fehlersuche beim Bestellabruf

> Welche Bedingungen eine Gambio-Bestellung erfüllen muss, um abgerufen zu werden – und was zu tun ist, wenn eine Bestellung nicht ankommt.

FFN Connect ruft Bestellungen aus Gambio in regelmäßigen Abständen automatisch ab. Damit eine Bestellung übertragen wird, müssen **alle** der folgenden Voraussetzungen erfüllt sein.

## Voraussetzungen für den Bestellabruf

### 1. Der Bestellstatus muss zum Abruf freigegeben sein

Das ist die häufigste Ursache für nicht abgerufene Bestellungen. FFN Connect ruft **nur Bestellungen ab, deren Gambio-Status du ausdrücklich freigegeben hast**.

So konfigurierst du die Status:

1. Öffne deinen Gambio-Verkaufskanal unter **Verkaufskanäle** und klicke oben rechts auf **Einstellungen**.
2. Wechsle zum Bereich **Bestellungen**.
3. In der Karte **Bestellstatus-Mapping anpassen** siehst du eine Tabelle mit allen Gambio-Bestellstatus.
4. Setze bei jedem Status, der abgerufen werden soll, einen Haken in der Spalte **Ist bereit zum Abruf**.

<!-- 📸 Screenshot TODO: Karte "Bestellstatus-Mapping anpassen" mit der Status-Tabelle; die Spalte "Ist bereit zum Abruf" mit gesetztem Haken deutlich markieren -->

> [!HINWEIS]
> Sind in der Tabelle keine oder nicht alle Status aufgeführt, klicke auf **Status aus Gambio abrufen**, um die aktuelle Statusliste aus deinem Shop zu laden.

<!-- 📸 Screenshot TODO: Button "Status aus Gambio abrufen" (oben rechts in der Karte) -->

<!-- 📸 Screenshot TODO (optional): Gambio-Adminbereich – Bestellung mit ihrem aktuellen Status, zur Veranschaulichung welcher Status freigegeben sein muss -->

Die Spalten der Tabelle im Überblick:

| Spalte | Bedeutung |
|--------|-----------|
| **Gambio Status** | Der Bestellstatus aus deinem Gambio-Shop |
| **Mapping** | Auf welchen FFN-Connect-Status dieser Gambio-Status abgebildet wird |
| **Ist bezahlt** | Markiert Bestellungen mit diesem Status als bezahlt |
| **Ist bereit zum Abruf** | **Nur Status mit Haken werden abgerufen** |

> [!WICHTIG]
> Eine Bestellung, die in Gambio in einem Status liegt, der **nicht** als „Ist bereit zum Abruf" markiert ist (z. B. „Eingegangen" / „Offen"), wird **nicht** übertragen. Sie wird erst abgerufen, sobald ihr Status auf einen freigegebenen Status wechselt.

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

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

### 3. Lager-Zuordnung (falls konfiguriert)

Wenn deinem Verkaufskanal bestimmte Lager zugeordnet sind, werden nur Bestellungen abgerufen, die diesen Lagern zugewiesen sind.

## Warum wird eine einzelne Bestellung nicht abgerufen?

Gehe die folgenden Punkte der Reihe nach durch:

### Der Status ist nicht zum Abruf freigegeben (häufigster Fall)

Prüfe, in welchem Status die Bestellung in Gambio steht, und vergleiche ihn mit der Tabelle unter **Einstellungen → Bestellungen → Bestellstatus-Mapping anpassen**.

- **Lösung:** Setze die Bestellung in Gambio auf einen freigegebenen Status – oder aktiviere für den betreffenden Status den Haken **Ist bereit zum Abruf**.

### Der Status wurde erst spät auf „freigegeben" gesetzt

FFN Connect lädt zurückliegende Bestellungen nur über einen begrenzten Nachlaufzeitraum (etwa **10 Tage** ab Bestelldatum) erneut. Bleibt eine Bestellung sehr lange in einem nicht freigegebenen Status und wird erst danach freigegeben, kann sie aus dem automatischen Abruf herausfallen.

- **Lösung:** Setze Bestellungen möglichst zeitnah auf einen abrufbaren Status. Fällt eine ältere Bestellung heraus, wende dich an deinen Ansprechpartner – sie kann manuell nachgeladen werden.

### Die Bestellung liegt vor dem Startdatum des Abrufs

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

### Die Verbindung zum Shop ist gestört

Wurden in letzter Zeit das Passwort des API-Benutzers, die Shop-URL oder die API-Einstellungen in Gambio geändert, kann der Abruf fehlschlagen.

- **Lösung:** Öffne den Verkaufskanal und prüfe, ob die Verbindung noch besteht. Hinterlege bei Bedarf die aktualisierten Zugangsdaten erneut (siehe [Deinen Gambio-Shop verbinden](/docs/merchants/gambio/connect-shop)).

> [!TIPP]
> Wenn mehrere oder alle Bestellungen fehlen, deutet das eher auf ein Verbindungs- oder Konfigurationsproblem (Punkt 4 oder ein fehlender Status-Haken) hin. Fehlt nur vereinzelt eine Bestellung, ist fast immer der **Bestellstatus** die Ursache.