Mit der Verbindung zum JTL-Fulfillment-Netzwerk (FFN) arbeitet X-Sitter als **Fulfiller** für Händler im JTL-Netzwerk. Sobald du dein JTL-Konto verbunden hast, liest X-Sitter die Händler, ihre Artikel, ihre Anlieferungen (als Avise) und ihre Ausgangsaufträge (als Aufträge) und meldet Versand, Wareneingänge und Bestand an FFN zurück.

Diese Seite behandelt die Verbindung selbst. Danach ordnest du die Händler deinen Mandanten zu ([FFN-Händler](/jtl/ffn-merchants.md)) und schaltest die Auftragsverarbeitung ein ([FFN-Auftragsverarbeitung](/jtl/ffn-order-processing.md)).

![Screenshot: Seite „Fulfillment - Verbindung“ mit dem grünen Status „Verbunden.“ und der Schaltfläche „Verbindung neu herstellen“](/jtl/images/ffn-connection-overview.png)

## Bevor du startest

- Du brauchst ein JTL-Konto, das im JTL-Fulfillment-Netzwerk als Fulfiller registriert ist.
- Dein Benutzer braucht das Recht **JTL › FFN Verbindung** – frag deinen Administrator. Fehlt das Menü für deine Firma, wende dich an den X-Sitter-Support, damit das JTL-Modul freigeschaltet wird.
- Du brauchst keine API-Schlüssel. Der Zugriff von X-Sitter auf JTL ist bereits eingerichtet; du bestätigst ihn nur in deinem JTL-Konto.

## Schritt für Schritt

### 1. Verbinden

1. Öffne in der Seitenleiste **ERP-Systeme › JTL › FFN Verbindung**. Die Seite heißt **Fulfillment - Verbindung**.
2. Klicke auf **Jetzt alle Rechte anfordern & verbinden**.
3. Du wirst zu JTL weitergeleitet. Melde dich mit deinem JTL-Konto an und bestätige den Zugriff für X-Sitter.
4. Zurück in X-Sitter siehst du „Die Verbindung wurde erfolgreich hergestellt“.

![Screenshot: Seite „Fulfillment - Verbindung“ vor der ersten Verbindung mit der Schaltfläche „Jetzt alle Rechte anfordern & verbinden“](/jtl/images/ffn-connection-connect-button.png)

### 2. Verbindungsstatus prüfen

Öffnest du die Seite erneut, zeigt sie oben den Status der Verbindung:

| Status | Bedeutung | Was tun |
|---|---|---|
| **Verbunden. Zugriffstoken gültig bis … , zuletzt erneuert …** | Alles in Ordnung | Nichts |
| **Der Zugriffstoken ist abgelaufen** | Der Zugriff wird alle 10 Minuten automatisch erneuert | Bleibt die Meldung, klicke auf **Verbindung neu herstellen** |
| **Letzter Token-Refresh fehlgeschlagen: …** | JTL hat die Erneuerung abgelehnt | Klicke auf **Verbindung neu herstellen** und bestätige den Zugriff in JTL erneut |

X-Sitter hält die Verbindung automatisch aufrecht. Neu verbinden musst du nur, wenn eine der Warnungen oben bestehen bleibt.

### 3. Händler zuordnen und Verarbeitung einschalten

1. Ordne jeden FFN-Händler einem Mandanten zu: [FFN-Händler](/jtl/ffn-merchants.md).
2. Lege die FFN-Jobs für den Mandanten unter **Administration › Jobs & Verbindungen** an, siehe [Jobs & Verbindungen](/administration/jobs-and-connections.md):
   - **FFN - Aufträge laden** – Aufträge, Wareneingänge und Bestand, siehe [FFN-Auftragsverarbeitung](/jtl/ffn-order-processing.md),
   - **FFN-Produkte laden** – erster Import der Artikel des Händlers, mit den Feldern **Darf Artikel sehen**, **Eigentümer** und Kategorie,
   - **FFN - Produkt Updates** – hält die Artikel aktuell, mit dem Feld **Eigentümer**.
3. Setze die Stichtage in der Karte **Übernahme durch X-Sitter** (siehe unten).

### 4. Die Karte „Übernahme durch X-Sitter“

Sobald die Verbindung besteht, erscheint auf derselben Seite eine zweite Karte **Übernahme durch X-Sitter**.

**Aufträge und Wareneingänge**
Eine Tabelle listet jeden Händler mit aktivem Auftrags-Job: **FFN-Händler**, **Firma**, den Stichtag **Aufträge und Wareneingänge ab** und den Link **Job bearbeiten**. Ein Händler ohne Datum zeigt das Badge **kein Stichtag – der Job tut nichts**. Das Datum selbst wird im Job gesetzt, siehe [FFN-Auftragsverarbeitung](/jtl/ffn-order-processing.md).

**Avisierungen** – der Avis-Import
1. Wähle unter **Avise importieren ab** ein Datum.
2. Klicke auf **Stichtag speichern**.

Ab diesem Datum werden FFN-Anlieferungen aller zugeordneten Händler in X-Sitter als [Avise](/inbound/advance-notices.md) angelegt. Lass das Feld leer, um den Import auszuschalten. Dieses Datum gilt für deine ganze Firma, nicht je Händler.

![Screenshot: Karte „Übernahme durch X-Sitter“ mit der Händler-Tabelle, einem Händler ohne Stichtag und dem Feld „Avise importieren ab“](/jtl/images/ffn-connection-takeover-card.png)

## Was synchronisiert wird

| Daten | Richtung | Wie oft |
|---|---|---|
| Wartende Ausgangsaufträge → Aufträge (nach einer Bestandsprüfung), Bestätigung in FFN, Stornierungen aus FFN | FFN ↔ X-Sitter | jede Minute, nur mit Stichtag im Job |
| Versandmeldung mit Mengen, Paketen und Trackingnummern | X-Sitter → FFN | alle 5 Minuten |
| Wareneingänge zu FFN-Avisen, Abschluss des Avis | X-Sitter → FFN | alle 5 Minuten, nur mit Stichtag im Job |
| Bestandsabgleich je Artikel | X-Sitter ↔ FFN | stündlich, wenn im Job eingeschaltet |
| Artikel (erster Import) | FFN → X-Sitter | jede Minute |
| Artikel-Updates | FFN → X-Sitter | stündlich |
| Anlieferungen → Avise | FFN → X-Sitter | alle 3 Minuten, nur mit dem Datum „Avise importieren ab“ |

## Gut zu wissen / Fehlerbehebung

| Meldung / Symptom | Ursache | Lösung |
|---|---|---|
| Ein Fehlertext statt der Erfolgsmeldung nach der Rückkehr von JTL | JTL hat die Anmeldung nicht abgeschlossen | Starte die Verbindung erneut |
| **Letzter Token-Refresh fehlgeschlagen: … The refresh token is invalid.** | Der Zugriff wurde an anderer Stelle verwendet oder widerrufen, oder er ist nach einer langen Pause abgelaufen | Klicke auf **Verbindung neu herstellen** |
| Es kommen keine Aufträge an | Händler nicht zugeordnet, Auftrags-Job inaktiv oder ohne Stichtag, oder nicht genug Bestand | Siehe [FFN-Auftragsverarbeitung](/jtl/ffn-order-processing.md) |
| Es kommen keine Avise an | Kein Datum unter **Avise importieren ab**, oder der Händler ist nicht zugeordnet | Setze das Datum und prüfe die [Händler-Zuordnung](/jtl/ffn-merchants.md) |

!!!
Probleme mit der FFN-Verbindung (abgelaufener Zugriff, fehlgeschlagener Import von Aufträgen oder Avisen) kannst du dir als Telegram-Nachricht schicken lassen. Abonniere **JTL-FFN - Fehler**, siehe [Telegram-Benachrichtigungen](/account/telegram-notifications.md).
!!!