Provide functions to create, edit and delete personnel specific data.
Description
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 | vlid modes are:
| 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 | format: YYYYMMDDHHMMSS if no value set, the current timestamp will be used | no | |
key_to | personnel key valid to | string | format: YYYYMMDDHHMMSS | no | |
groups | personnel groups | names of personnel groups to assign | string | names of assigned personnel groups
| 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(3) | |
drv_licence_valid_to | driver licence valid to | expiration date of driver licence | string | format: YYYYMMDDHHMMSS | no(3) |
identity_card_nr | identity card | identity card number | string | no(3) | |
identity_card_valid_to | identity card valid to | expiration date of identity card | string | format: YYYYMMDDHHMMSS | no(3) |
passport_nr | passport | passport number | string | no(3) | |
passport_valid_to | passport valid to | expiration date of passport | string | format: YYYYMMDDHHMMSS | no(3) |
adr_cer_nr | ADR certificate | number of adr certificate | string | no(3) | |
adr_cert_valid_to | ADR certificate valid to | expiration date of ADR certificate | string | format: YYYYMMDDHHMMSS | no(3) |
bkrfqg_valid_to | Qualifikation laut Schlüsselzahl 95 gültig bis | Gültigkeit der Schulung zum Berufskraftfahrerqualifikationsgesetz | string | Die Gültigkeit ist für Berufskraftfahrer auf dem Führerschein unter der Schlüsselzahl 95 erfasst | nein(3) |
birth | Geburtsdatum | Geburtsdatum der Person | string | Format: YYYYMMDDHHMMSS | nein(3) |
job_from | Einstellungsdatum | Einstellungsdatum der Person | string | Format: YYYYMMDDHHMMSS | nein(3) |
Hinweise:
(1) Pflichtfeld beim Anlegen einer Person
(2) Pflichtfeld beim Zuweisen eines Folgeschlüssels
(3) nur verfügbar, wenn das Digitacho Archiv gebucht wurde
Rückgabe
Beim anlegen, bearbeiten und hinzufügen eines Folgeschlüssels wird im Erfolgsfall "PERSON_DATA_SAVED" zurückgegeben.
Beim löschen einer Person wird im Erfolgsfall "PERSON_DELETED" zurückgegeben.
Bei fehlenden oder fehlerhaften Eingaben wird ein "ERROR:Beschreibung" zurückgegeben.
Beispiele
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=new&id=1234&name=Maria%20Musterfrau&pkey=98765&group=Aussendienst
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=update&id=1234&name=Maria%20Musterfrau&pkey=98765&group=Aussendienst
http://map.yellowfox.de/rti/set_person.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&ekey_from=20180101000000
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234