Zum Inhalt springen
Zuletzt geändert von YellowFox_RD am 2025/07/29 13:29
Zeige letzte Bearbeiter
1 (% class="box" %)
2 (((
3 Inhaltsverzeichnis
4 )))
5
6 {{toc/}}
7
8 Erlaubt das Aktivieren und Deaktivieren der Führerscheinkontrolle für eine Person.
9
10 (% class="box warningmessage" %)
11 (((
12 Für die Nutzung dieser Funktion muss die Berechtigung **„Kostenpflichtige RTI-Funktionen“** im YellowFox Portal aktiviert sein.
13
14 Sie können diese Berechtigung im YellowFox Portal in den** RTI-Einstellungen** aktivieren.
15 )))
16
17 = Beschreibung =
18
19 (% class="blue mark" %)//**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
20
21 = Parameter =
22
23
24 |=Parameter|=Bezeichnung Personalverwaltung|=Beschreibung|=Typ|=Hinweis|=Pflicht
25 |company| |RTI Firmenschlüssel|string| |ja
26 |import| |RTI Importschlüssel|string| |ja
27 |id|MA-Nummer|selbstdefinierbare Mitarbeiternummer|string|die Mitarbeiternummer muss eindeutig sein und dient dem weiteren Zugriff auf die Personaldaten|ja
28 |nfc_tag|NFC Tag ID zur Führerscheinkontrolle| | |Wenn nicht gesetzt oder leer, dann wird die Führerscheinkontrolle für diese Person deaktiviert|nein (1)
29 |check_interval|Kontrollintervall| | |(((
30 Mögliche Werte
31
32 * 2d = zweitägig
33 * week = wöchentlich
34 * 2week = 14-tägig
35 * month = monatlich
36 * 2month = alle 2 Monate
37 * quarter = quartalsweise
38 * half = halbjährig
39 * year = jährlich
40 )))|ja/nein (2)
41 |last_check_date|Datum der letzten Führerscheinkontrolle    | | |Format: YYYYMMDDHHMMSS
42 Das Datum muss nach dem letzten Kontrolldatum liegen|nein (3)
43
44 Hinweise:
45 (1) Wird kein NFC-Tag übermittelt oder wenn dieser leer ist, dann wird die Führerscheinkontrolle deaktiviert.
46 (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.
47 (3) Wird beim Aktivieren der Führerscheinkontrolle kein Datum der letzten Kontrolle gesetzt, so bleibt ein eventuell vorhandenes letztes Kontrolldatum unverändert.
48
49 = Rückgabe =
50
51 Im Erfolgsfall "**DRIVER_LICENSE_CHECK_DATA_SAVED**" zurückgegeben.
52
53 Bei fehlenden oder fehlerhaften Eingaben wird ein "**ERROR:Beschreibung**" zurückgegeben.
54
55
56 = Beispiele =
57
58 **Aktivieren der Führerscheinkontrolle mit Angabe eines letzten Kontrolldatums und einem Kontrollintervall "monatlich"**
59
60 {{code language="java"}}
61 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
62 {{/code}}
63
64 **Deaktivieren der Führerscheinkontrolle**
65
66 {{code language="java"}}
67 https://map.yellowfox.de/rti/set_driver_license_check_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&id=1234&nfc_tag=
68 {{/code}}
69
70
71