# Deinen Gambio-Shop verbinden

> Schritt-für-Schritt-Anleitung, wie du deinen Gambio-Shop mit FFN Connect verbindest.

## Schritt 1: Voraussetzungen

FFN Connect kommuniziert mit deinem Gambio-Shop über die **Gambio REST-API (v2)**. Du benötigst dafür:

- Die **URL deines Shops** (z. B. `https://meinshop.gambiocloud.com`)
- Einen **Admin-Benutzer** deines Gambio-Shops mit aktiviertem **API-Zugriff** (Benutzername/E-Mail und Passwort)

> [!HINWEIS]
> Der API-Zugriff wird im Gambio-Adminbereich in der Benutzerverwaltung für den jeweiligen Admin-Benutzer freigeschaltet. Stelle sicher, dass die REST-API aktiviert ist und der Benutzer Lese- und Schreibrechte besitzt. Die genaue Bezeichnung des Menüpunkts kann je nach Gambio-Version abweichen.

## Schritt 2: Verkaufskanal hinzufügen

1. Wechsle in deinem Fulfillment-Portal zu **Verkaufskanäle → Verkaufskanal hinzufügen**.
2. Wähle **Gambio** aus.
3. Gib einen Namen für den Verkaufskanal ein (optional).
4. Trage die **URL** deines Shops ein (z. B. `https://meinshop.gambiocloud.com`).
5. Gib **Admin Username** und **Admin Password** deines Gambio-API-Benutzers ein.
6. Klicke auf **Weiter**.

<!-- 📸 Screenshot TODO: Maske "Verkaufskanal hinzufügen → Gambio" mit den Feldern Name, URL, Admin Username, Admin Password -->

FFN Connect prüft die Verbindung sofort. Schlägt sie fehl, erscheint der Hinweis *„Verbindung zum Shop fehlgeschlagen. Prüfen Sie die URL und Zugangsdaten."*

> [!HINWEIS]
> Bei einem Verbindungsfehler überprüfe bitte: die Shop-URL (mit `https://`, ohne Pfad-Anhang), die Zugangsdaten und ob die REST-API für den Benutzer freigeschaltet ist.

## Schritt 3: Lager-Standort synchronisieren

Navigiere zum Menüpunkt **Lager** und klicke auf **Synchronisieren**. Anschließend wird dir dein Fulfillment-Lager angezeigt. Dieser Schritt ist notwendig, um im nächsten Schritt deine Artikel an deinen Fulfiller freizugeben.

<!-- 📸 Screenshot TODO: Menüpunkt "Lager" mit dem Button "Synchronisieren" und dem angezeigten Fulfillment-Lager -->

## Schritt 4: Artikel synchronisieren

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

Der Vorgang kann je nach Anzahl deiner Produkte und Varianten 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).

<!-- 📸 Screenshot TODO: Produkt-Synchronisierung – Button "Produkte synchronisieren" bzw. die Produkttabelle des Verkaufskanals nach der Synchronisierung -->

## Schritt 5: Bestellstatus zuordnen

Damit Bestellungen abgerufen werden, musst du festlegen, **welche Gambio-Bestellstatus** an FFN Connect übertragen werden sollen. Wie das funktioniert, ist ausführlich beschrieben unter:

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

## Schritt 6: 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.
- **Fehlerhafte Lieferadressen:** Gib bewusst fehlerhafte Adressen an, um zu sehen, wie diese Bestellungen markiert werden.