set_personnel.php

Last modified by YellowFox_RD on 2025/07/10 11:46

Table of Contents

Description
Parameters
Return
Example calls

Provide functions to create, edit and delete personnel specific data.

Description

POST set_personnel.php?company=RTI_COMPANYKEY&import=RTI_VEHICLEKEY&mode=new&id=01234&key_from=YYYYMMDDHHMMSS&pkey=DF123456789012&name=Max%20Mustermann&groups=Fahrer,Dresden

Parameters

Parameter	Name in personnel administration	Desciption	Type	Remark	Mandatory
company		RTI company key	string		yes
import		RTI import key	string		yes
mode		differentiate between available actions	string	valid modes are: new: create a new person update: change data of an already available person delete: remove a person append_key: add a foreign personnel key to a person	yes
id	employee number	self defined employee number	string	the employee number must be a self defined string for further identification of the person	yes
name	Name	complete name of the person	string		^yes(1)
pkey	personnel key	personnel key for bookings	string	this may be a transponder or driver card to identify the person and assign booked times correctly	^yes(1,2)
key_from	personnel key valid from		string	is only used in the following modes: new append_key update_key format: YYYYMMDDHHMMSS if no value set, the current timestamp will be used	no
key_to	personnel key valid to		string	is only used in the following modes: new append_key update_key format: YYYYMMDDHHMMSS	no
key_deactivation_date	personnel key deactivation date			Only used in the following modes: deactivate_key Format: YYYYMMDDHHMMSS If no value is set, the current time is used. The value cannot be in the future.	no
groups	personnel groups	names of personnel groups to assign	string	names of assigned personnel groups set multiple groups by submit as comma separated string on edit a person, we set only the selected groups (previous assignments will be removed)	no
card_nr	employee licence number	self defined number for assignment to an external timerecording software	string	required especially for correct assignment to ReinerSCT time card software	no
drv_licence_nr	driver licence	number of driver licence	string		no⁽³⁾
drv_licence_valid_to	driver licence valid to	expiration date of driver licence	string	format: YYYYMMDDHHMMSS	no⁽³⁾
identity_card_nr	identity card	identity card number	string		no⁽³⁾
identity_card_valid_to	identity card valid to	expiration date of identity card	string	format: YYYYMMDDHHMMSS	no⁽³⁾
passport_nr	passport	passport number	string		no⁽³⁾
passport_valid_to	passport valid to	expiration date of passport	string	format: YYYYMMDDHHMMSS	no⁽³⁾
adr_cert_nr	ADR certificate	number of adr certificate	string		no⁽³⁾
adr_cert_valid_to	ADR certificate valid to	expiration date of ADR certificate	string	format: YYYYMMDDHHMMSS	no⁽³⁾
bkrfqg_valid_to	qualification by keynumber 95 valid to	expiration date of german "Berufskraftfahrerqualifikationsgesetz"	string	the expiration date of this qualification is printed at driver licence at key number 95	no⁽³⁾
birth	date of birth	birthdate of person	string	format: YYYYMMDDHHMMSS⁽⁴⁾	no⁽³⁾
job_from	employee since	start date of beeing an employee at this company	string	format: YYYYMMDDHHMMSS	no⁽³⁾

Remarks:
(1) mandatory on add a new person
(2) mandatory on add a following card, update or deactivating a personnel key
(3) will be only stored, if tacho archive extension active
(4) If day and/or month are unknown, the birthdate is filled up with "XX" for the unknown values according to german passport law (example: 198006XX or 1980XXXX)

Return

On succesful create, edit or assignment of a following key the return string will be "PERSON_DATA_SAVED".
On successful delete of a person the return string will be "PERSON_DELETED".
In case of an error, return the string "ERROR:Description".

Example calls

Create new person
https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=new&id=1234&name=Maria%20Musterfrau&pkey=98765&group=Aussendienst

Edit person data
https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=update&id=1234&name=Maria%20Musterfrau&pkey=98765&group=Aussendienst

Assign a following card
https://map.yellowfox.de/rti/set_person.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&ekey_from=20180101000000

Update personnel key

https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=update_key&id=1234&pkey=98766&key_from=20180101000000&key_to=20190101000000

Deactivate personnel key

https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=deactivate_key&id=1234&pkey=98766&key_deactivation_date=20180101000000

Delete a person
https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234