set_driver_license_check_data.php

Last modified by YellowFox_RD on 2025/07/25 11:01

Table of Contents

Allows you to activate and deactivate driver's license control for a person

Warning

To use this function, the “Paid RTI Functions” authorization must be activated in the YellowFox portal.

You can enable this permission in the YellowFox portal in the RTI settings.

Description

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

Parameters

ParameterBezeichnung PersonalverwaltungBeschreibungTypHinweisPflicht
company RTI company keystring yes
import RTI import keystring yes
idemployee numberstart date of beeing an employee at this company    stringthe employee number must be unique and is used for further access to personnel datayes
nfc_tagNFC Tag ID  If not set or empty, then the driver's license check will be deactivated for this personno (1)
check_intervaldriver license check interval  

possible values

  • 2d = every two days
  • week = weekly
  • 2 weeks = every two weeks
  • month = monthly
  • 2 months = every two months
  • quarter = quarterly
  • half = half-yearly
  • year = annually
yes/no (2)
last_check_datelast driver license check date     format: YYYYMMDDHHMMSS
The date must be after the last driver license check date
no (3)

notes:
(1) If no NFC tag is transmitted or if it is empty, the driver's license check is deactivated.
(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.
(3) If no date of the last check is set when activating the driver's license check, any existing last check date remains unchanged.

Return

If successful, "DRIVER_LICENSE_CHECK_DATA_SAVED" is returned.

In case of an error, return the string "ERROR:Description".

Example calls

Activation of the driver's license check with specification of a last check date and a check interval "monthly

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

Deactivating driver's license checks

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