Version 9.1 von YellowFox_RD am 2025/07/25 09:10

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 wie folgt prüfen oder aktivieren:
15 **Verwaltung** > **Administration** > **RTI-Schnittstelle** > **Einstellungen** > **Berechtigungen**
16 )))
17
18 = Beschreibung =
19
20 (% 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
21
22 = Parameter =
23
24
25 |=Parameter|=Bezeichnung Personalverwaltung|=Beschreibung|=Typ|=Hinweis|=Pflicht
26 |company| |RTI Firmenschlüssel|string| |ja
27 |import| |RTI Importschlüssel|string| |ja
28 |id|MA-Nummer|selbstdefinierbare Mitarbeiternummer|string|die Mitarbeiternummer muss eindeutig sein und dient dem weiteren Zugriff auf die Personaldaten|ja
29 |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)
30 |check_interval|Kontrollintervall| | |(((
31 Mögliche Werte
32
33 * 2d = zweitägig
34 * week = wöchentlich
35 * 2week = 14-tägig
36 * month = monatlich
37 * 2month = alle 2 Monate
38 * quarter = quartalsweise
39 * half = halbjährig
40 * year = jährlich
41 )))|ja/nein (2)
42 |last_check_date|Datum der letzten Führerscheinkontrolle    | | |Format: YYYYMMDDHHMMSS
43 Das Datum muss nach dem letzten Kontrolldatum liegen|nein (3)
44
45 Hinweise:
46 (1) Wird kein NFC-Tag übermittelt oder wenn dieser leer ist, dann wird die Führerscheinkontrolle deaktiviert.
47 (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.
48 (3) Wird beim Aktivieren der Führerscheinkontrolle kein Datum der letzten Kontrolle gesetzt, so bleibt ein eventuell vorhandenes letztes Kontrolldatum unverändert.
49
50 = Rückgabe =
51
52 Im Erfolgsfall "**DRIVER_LICENSE_CHECK_DATA_SAVED**" zurückgegeben.
53
54 Bei fehlenden oder fehlerhaften Eingaben wird ein "**ERROR:Beschreibung**" zurückgegeben.
55
56
57 = Beispiele =
58
59 **Aktivieren der Führerscheinkontrolle mit Angabe eines letzten Kontrolldatums und einem Kontrollintervall "monatlich"**
60
61 {{code language="java"}}
62 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
63 {{/code}}
64
65 **Deaktivieren der Führerscheinkontrolle**
66
67 {{code language="java"}}
68 https://map.yellowfox.de/rti/set_driver_license_check_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&id=1234&nfc_tag=
69 {{/code}}
70
71
72