Skip to Content
Last modified by YellowFox_RD on 2025/07/25 11:01
Show last authors
1 (% class="box" %)
2 (((
3 Table of Contents
4 )))
5
6 {{toc/}}
7
8 Allows you to activate and deactivate driver's license control for a person
9
10 {{warning}}
11 To use this function, the “Paid RTI Functions” authorization must be activated in the YellowFox portal.
12
13 You can enable this permission in the YellowFox portal in the RTI settings.
14 {{/warning}}
15
16 = Description =
17
18 (% 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
19
20 = Parameters =
21
22 |=Parameter|=Bezeichnung Personalverwaltung|=Beschreibung|=Typ|=Hinweis|=Pflicht
23 |company| |RTI company key|string| |yes
24 |import| |RTI import key|string| |yes
25 |id|employee number|start date of beeing an employee at this company    |string|the employee number must be unique and is used for further access to personnel data|yes
26 |nfc_tag|NFC Tag ID| | |If not set or empty, then the driver's license check will be deactivated for this person|no (1)
27 |check_interval|driver license check interval| | |(((
28 possible values
29
30 * 2d = every two days
31 * week = weekly
32 * 2 weeks = every two weeks
33 * month = monthly
34 * 2 months = every two months
35 * quarter = quarterly
36 * half = half-yearly
37 * year = annually
38 )))|yes/no (2)
39 |last_check_date|last driver license check date   | | |format: YYYYMMDDHHMMSS
40 The date must be after the last driver license check date|no (3)
41
42 notes:
43 (1) If no NFC tag is transmitted or if it is empty, the driver's license check is deactivated.
44 (2) If an NFC tag is submitted, specifying a control interval is mandatory. If driver's license check is deactivated (nfc_tag is empty or not transmitted), specifying the control interval is obsolete.
45 (3) If no date of the last check is set when activating the driver's license check, any existing last check date remains unchanged.
46
47
48 = Return =
49
50 If successful, "**DRIVER_LICENSE_CHECK_DATA_SAVED**" is returned.
51
52 In case of an error, return the string "(% class="error" %)**ERROR:Description**(%%)".
53
54 = Example calls =
55
56 **Activation of the driver's license check with specification of a last check date and a check interval "monthly**
57
58 {{code language="java"}}
59 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
60 {{/code}}
61
62 **Deactivating driver's license checks**
63
64 {{code language="java"}}
65 https://map.yellowfox.de/rti/set_driver_license_check_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&id=1234&nfc_tag=
66 {{/code}}
67
68
69