set_driver_license_check_data.php

Zuletzt geändert von YellowFox_RD am 2025/07/29 13:29

Inhaltsverzeichnis

Erlaubt das Aktivieren und Deaktivieren der Führerscheinkontrolle für eine Person.

Für die Nutzung dieser Funktion muss die Berechtigung „Kostenpflichtige RTI-Funktionen“ im YellowFox Portal aktiviert sein.

Sie können diese Berechtigung im YellowFox Portal in den RTI-Einstellungen aktivieren.

Beschreibung

POST set_driver_license_check_data.php?company=RTI_COMPANYKEY&import=RTI_VEHICLEKEY&id=1234&nfc_tag=123456789A12&check_interval=month&last_check_date=20250625000000

Parameter

ParameterBezeichnung PersonalverwaltungBeschreibungTypHinweisPflicht
company RTI Firmenschlüsselstring ja
import RTI Importschlüsselstring ja
idMA-Nummerselbstdefinierbare Mitarbeiternummerstringdie Mitarbeiternummer muss eindeutig sein und dient dem weiteren Zugriff auf die Personaldatenja
nfc_tagNFC Tag ID zur Führerscheinkontrolle  Wenn nicht gesetzt oder leer, dann wird die Führerscheinkontrolle für diese Person deaktiviertnein (1)
check_intervalKontrollintervall  

Mögliche Werte

  • 2d = zweitägig
  • week = wöchentlich
  • 2week = 14-tägig
  • month = monatlich
  • 2month = alle 2 Monate
  • quarter = quartalsweise
  • half = halbjährig
  • year = jährlich
ja/nein (2)
last_check_dateDatum der letzten Führerscheinkontrolle      Format: YYYYMMDDHHMMSS
Das Datum muss nach dem letzten Kontrolldatum liegen
nein (3)

Hinweise:
(1) Wird kein NFC-Tag übermittelt oder wenn dieser leer ist, dann wird die Führerscheinkontrolle deaktiviert.
(2) Wenn ein NFC-Tag übergeben wird, so ist die Angabe eines Kontrollintervalls Pflicht. Beim Deaktivieren der Führerscheinkontrolle (nfc_tag leer oder nicht übermittelt) ist die Angabe des Kontrollintervalls obsolet.
(3) Wird beim Aktivieren der Führerscheinkontrolle kein Datum der letzten Kontrolle gesetzt, so bleibt ein eventuell vorhandenes letztes Kontrolldatum unverändert.

Rückgabe

Im Erfolgsfall "DRIVER_LICENSE_CHECK_DATA_SAVED" zurückgegeben.

Bei fehlenden oder fehlerhaften Eingaben wird ein "ERROR:Beschreibung" zurückgegeben.

Beispiele

Aktivieren der Führerscheinkontrolle mit Angabe eines letzten Kontrolldatums und einem Kontrollintervall "monatlich"

https://map.yellowfox.de/rti/set_driver_license_check_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&id=1234&nfc_tag=123456789A123&check_interval=month&last_check_date=20250625000000

Deaktivieren der Führerscheinkontrolle

https://map.yellowfox.de/rti/set_driver_license_check_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&id=1234&nfc_tag=