# Deinen PrestaShop-Shop verbinden

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

## Schritt 1: Voraussetzungen

FFN Connect kommuniziert mit deinem PrestaShop-Shop über den **PrestaShop-Webservice (API)**. Du benötigst dafür:

- Die **URL deines Shops** (z. B. `https://meinshop.de`)
- Einen **Webservice-Schlüssel (API-Key)** aus dem PrestaShop-Backend

### Webservice im PrestaShop-Backend aktivieren

1. Öffne im PrestaShop-Backend **Erweiterte Parameter → Webservice**.
2. Aktiviere die Option **PrestaShop-Webservice aktivieren**.
3. Lege über **Neuen Webservice-Schlüssel hinzufügen** einen neuen Schlüssel an.

<!-- TODO Bild: Screenshot PrestaShop-Backend „Erweiterte Parameter → Webservice" mit aktiviertem Webservice und der Schlüssel-Liste -->

### Berechtigungen des Schlüssels setzen

Beim Anlegen des Schlüssels legst du die Zugriffsrechte auf die einzelnen Ressourcen fest. Damit Produkt-, Bestand- und Bestellabgleich vollständig funktionieren, benötigt der Schlüssel mindestens:

| Bereich | Benötigte Rechte | Wofür |
|---------|------------------|-------|
| `products`, `combinations`, `product_option_values` | Anzeigen (GET) | Produkte und Varianten lesen |
| `orders`, `addresses`, `customers` | Anzeigen (GET) | Bestellungen und Adressen lesen |
| `order_states`, `carriers`, `currencies`, `countries`, `states` | Anzeigen (GET) | Status, Versandarten, Währungen, Länder |
| `stock_availables` | Anzeigen + **Bearbeiten** (GET/PUT) | Bestand zurückschreiben |
| `order_histories`, `order_carriers` | Anzeigen + **Bearbeiten** (GET/PUT/POST) | Versandstatus & Trackingnummer zurückmelden |

> [!WICHTIG]
> Für das **Zurückschreiben von Bestand, Versandstatus und Trackingnummer** reichen Leserechte nicht aus. Erteile dem Schlüssel auf `stock_availables`, `order_histories` und `order_carriers` zusätzlich **Schreibrechte (Bearbeiten/Hinzufügen)**, sonst bleiben diese Rückmeldungen wirkungslos.

<!-- TODO Bild: Screenshot der Berechtigungs-Matrix beim Anlegen eines Webservice-Schlüssels in PrestaShop -->

## Schritt 2: Verkaufskanal hinzufügen

1. Wechsle in deinem Fulfillment-Portal zu **Verkaufskanäle → Verkaufskanal hinzufügen**.
2. Wähle **PrestaShop** aus.
3. Gib einen Namen für den Verkaufskanal ein (optional).
4. Trage die **URL** deines Shops ein (z. B. `https://meinshop.de`).
5. Gib deinen **Webservice-Schlüssel** ein.
6. Klicke auf **Weiter**.

<!-- TODO Bild: Screenshot des FFN-Connect-Formulars zum Anlegen des PrestaShop-Verkaufskanals (Shop-URL, Webservice-Schlüssel) -->

FFN Connect prüft die Verbindung sofort. Schlägt sie fehl, hilft die Art der Fehlermeldung bei der Eingrenzung:

> [!HINWEIS]
> - **Nicht erreichbar / falsche URL:** Prüfe die Shop-URL (mit `https://`, ohne Pfad-Anhang wie `/api`).
> - **Zugriff verweigert:** Der Webservice-Schlüssel ist falsch oder ihm fehlen die Rechte auf die benötigten Ressourcen.
> - **Webservice nicht gefunden:** Der PrestaShop-Webservice ist im Backend nicht aktiviert (siehe Schritt 1).

## Schritt 3: Artikel synchronisieren

1. Öffne deinen PrestaShop-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 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).

> [!HINWEIS]
> PrestaShop-Varianten (Kombinationen) werden als eigenständige Artikel synchronisiert. Hat ein Produkt mehrere Kombinationen (z. B. Größe/Farbe), erscheint jede Kombination als eigene Zeile.

## Schritt 4: Bestellabruf verstehen

Damit Bestellungen abgerufen werden, müssen sie sich in PrestaShop in einem geeigneten Status befinden. Welche Bedingungen das sind und was du bei fehlenden Bestellungen prüfst, ist hier beschrieben:

[Voraussetzungen & Fehlersuche beim Bestellabruf](/docs/merchants/prestashop/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.
- **Fehlerhafte Lieferadressen:** Gib bewusst fehlerhafte Adressen an, um zu sehen, wie diese Bestellungen markiert werden.