YellowFox-Telematik anbinden: Kilometerstände und Führerscheinkontrolle
Überblick
Der YellowFox-Dienst holt in regelmäßigen Abständen Daten aus Ihrem YellowFox-Telematikportal und überträgt zwei Dinge nach FMWeb:
- Kilometerstände: Für jedes Fahrzeug mit gepflegter YellowFox-Kennung übernimmt FMWeb den aktuellen km-Stand samt Zeitstempel aus der Fahrzeugposition. Die Änderung wird in der Kilometer-Historie des Fahrzeugs dokumentiert (Quelle YellowFox).
- Führerscheinkontrollen: Für Fahrer, die ihren Führerschein am YellowFox-NFC-Leser vorlegen, übernimmt FMWeb „Zuletzt vorgelegt am", die nächste Prüfung und das Prüfintervall und schreibt einen Eintrag in die Kontrollhistorie (Quelle „YellowFox"). Übernommen werden nur Kontrollen, die neuer sind als das gespeicherte Datum.
Ohne gültige YellowFox-Lizenz überspringt der Dienst die Verarbeitung und protokolliert dies im Log (Artikel 112).
Voraussetzungen: Kennungen pflegen
- Fahrzeuge: In der Fahrzeugakte das Feld „YF Fahrzeug Ident" mit der YellowFox-Fahrzeugkennung füllen. Fahrzeuge ohne Kennung werden ignoriert.
- Fahrer: In der Fahrerakte das Feld „NFC" mit der Tag-ID des Fahrers füllen. Die NFC-Kennung muss eindeutig sein – FMWeb prüft beim Speichern auf Duplikate („NFC bereits vergeben").
Konfiguration
Systemadministration → Hintergrundaufgaben (/applications/backgroundtasks/dashboard) → Tab „YellowFox Task":
- „Ist aktiv?" einschalten.
- Wartezeit zwischen den Ausführungen in Stunden festlegen (1–24).
- API Benutzer und API Passwort aus Ihrem YellowFox-Konto eintragen (API-Zugang ggf. bei YellowFox freischalten lassen).
- Die Mandanten auswählen, für die Daten importiert werden sollen.
- „YellowFox Einstellungen testen" klicken – FMWeb ruft zur Probe die Fahrerliste ab. Bei aktiviertem Dienst bleibt Speichern gesperrt, bis der Test erfolgreich war.
Kontrolle und Fehlersuche
Im Tab „Logs" finden Sie je Durchlauf die Meldung „YFoxTask complete" sowie ggf. Fehler aus der Fahrer- oder Fahrzeugverarbeitung; ein Klick auf die Zeile zeigt Details (Artikel 15).
Typische Ursachen, wenn Daten ausbleiben:
- Fahrzeug/Fahrer ohne (korrekte) Kennung „YF Fahrzeug Ident" bzw. „NFC"
- Mandant nicht in der Mandanten-Auswahl des Tasks
- API-Zugangsdaten geändert – Test-Button erneut ausführen
Häufige Fragen
Überschreibt YellowFox manuell erfasste Kilometerstände? Der Dienst setzt den aktuellen km-Stand des Fahrzeugs auf den Telematikwert des jeweiligen Laufs; die Änderungen sind in der km-Historie nachvollziehbar. Manuelle Tachoerfassungen bleiben als eigene Einträge erhalten.
Kann ich YellowFox und Fleet-ID parallel nutzen? Ja. Beide Dienste schreiben in dieselben Führerschein-Felder, übernehmen aber jeweils nur neuere Kontrollen – es „gewinnt" die aktuellste Vorlage, die Quelle ist in der Historie ersichtlich.
Verwandte Artikel
