JTL-Fulfillment-Netzwerk (FFN) verbinden

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) und schaltest die Auftragsverarbeitung ein (FFN-Auftragsverarbeitung).

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“.

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.
2. Lege die FFN-Jobs für den Mandanten unter Administration › Jobs & Verbindungen an, siehe Jobs & Verbindungen:
   • FFN - Aufträge laden – Aufträge, Wareneingänge und Bestand, siehe FFN-Auftragsverarbeitung,
   • 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.

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 angelegt. Lass das Feld leer, um den Import auszuschalten. Dieses Datum gilt für deine ganze Firma, nicht je Händler.

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
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