Beiträge in diesem Abschnitt

FleetSync: Führerscheinkontrolle mit Fleet-ID koppeln

Veröffentlicht:
Aktualisiert:

Modul: Systemadministration → Hintergrundaufgaben → Tab „FleetSync Task"

Zielgruppe: Administratoren

Benötigte Berechtigung: system.background_tasks (zusätzlich Lizenz „FleetSync")

Überblick

Der FleetSync-Dienst gleicht die elektronische Führerscheinkontrolle des Anbieters Fleet-ID automatisch mit FMWeb ab: Erfolgreiche Kontrollen werden regelmäßig abgeholt und in die Fahrerakte übernommen – Sie pflegen die Prüftermine nicht mehr von Hand.

Je Kontrolle aktualisiert FMWeb beim passenden Fahrer:

  • „Zuletzt vorgelegt am" (Datum der letzten erfolgreichen Kontrolle)
  • die nächste Führerscheinprüfung (berechnet aus dem Führerschein-Intervall des Fahrers)
  • einen Eintrag in der Kontrollhistorie (Quelle „Fleet")

Übernommen werden nur Kontrollen, die neuer sind als das bereits gespeicherte Datum. Ohne gültige FleetSync-Lizenz überspringt der Dienst die Verarbeitung und protokolliert dies im Log (Artikel 112).

Konfiguration

Systemadministration → Hintergrundaufgaben (/applications/backgroundtasks/dashboard) → Tab „FleetSync Task":

  1. „Ist aktiv?" einschalten und die Wartezeit zwischen den Ausführungen (Minuten) festlegen.
  2. API Version wählen:
  • V2 (empfohlen): Base URL (Standard https://my.fleet-id.de/) und Bearer Token eintragen. Der Token stammt aus Ihrem Fleet-ID-Konto.
  • V1 (Legacy): API Benutzer und API Passwort eintragen.
  1. Zuordnungen anlegen („Zuordnung hinzufügen"):
  • Bei V2 ordnen Sie jedem FMWeb-Mandanten die zugehörige Fleet-ID Kunden-ID zu („Mandanten ↔ Fleet-ID Kunden-ID"). Nur zugeordnete Mandanten werden synchronisiert.
  • Bei V1 wählen Sie lediglich die zu synchronisierenden Mandanten.
  1. „FleetSync Einstellungen testen" klicken – bei V2 speichert FMWeb die Einstellungen und prüft die Verbindung anhand der ersten Zuordnung. Solange der Test bei aktiviertem Dienst nicht erfolgreich war, bleibt Speichern gesperrt.

Fahrer-Zuordnung: das Feld „Fleet-ID"

Der Abgleich erfolgt über das Feld Fleet-ID in der Fahrerakte, das die Barcode-/Siegelnummer des Führerscheins enthalten muss (die Nummer des bei Fleet-ID registrierten Prüfsiegels). Fahrer ohne hinterlegte bzw. nicht übereinstimmende Nummer werden nicht aktualisiert; Fleet-ID-Fahrer ohne ausgegebenen Barcode überspringt der Dienst.

Tipp: In den Führerschein-Erinnerungen können Sie mit „Nur Mails versenden, wenn Fleet-ID eingetragen wurde?" die FMWeb-Erinnerungen auf Fahrer ohne externe Kontrolle beschränken bzw. gezielt kombinieren (Artikel 05).

Kontrolle und Fehlersuche

Im Tab „Logs" des Hintergrundaufgaben-Dashboards sehen Sie je Lauf eine Zusammenfassung, z. B. „FleetSync v2: tenant 1: 42 drivers returned, 40 matched, 3 updated". Fehlerzeilen (ungültiger Token, unbekannte Kunden-ID) öffnen Sie per Klick mit vollständigem Fehlertext (Artikel 15).

Häufige Fragen

Ein Fahrer wird nie aktualisiert – woran liegt es? Prüfen Sie: (1) Fleet-ID-Feld in der Fahrerakte = Barcodenummer des Siegels, (2) der Mandant des Fahrers ist zugeordnet, (3) das Führerschein-Intervall des Fahrers ist gepflegt, sonst kann die nächste Prüfung nicht berechnet werden.

V1 oder V2? Neue Einrichtungen immer mit V2 (Token-basiert, Zuordnung je Kunden-ID). V1 bleibt nur für Bestandskonten der alten Fleet-ID-API.

Verwandte Artikel

AH
Geschrieben von Alexander Hagemann
Aktualisiert:
Zugriff abgelehnt
Zugriff abgelehnt