set_personnel.php

Zuletzt geändert von YellowFox_RD am 2025/07/10 11:46

Inhaltsverzeichnis

Beschreibung
Parameter
Rückgabe
Beispiele

Erlaubt das anlegen, bearbeiten und löschen von Personaldaten

Beschreibung

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

Parameter

Parameter	Bezeichnung Personalverwaltung	Beschreibung	Typ	Hinweis	Pflicht
company		RTI Firmenschlüssel	string		ja
import		RTI Importschlüssel	string		ja
mode		Unterscheidung der verschiedenen Aktionen	string	zulässige Modi sind: new: eine neue Person anlegen update: Daten einer angelegten Person ändern delete: eine angelegte Person löschen append_key: einer Person einen neuen Folgeschlüssel zuweisen	ja
id	MA-Nummer	selbstdefinierbare Mitarbeiternummer	string	die Mitarbeiternummer muss eindeutig sein und dient dem weiteren Zugriff auf die Personaldaten	ja
name	Name	vollständiger Name der Person	string		ja⁽¹⁾
pkey	Personalschlüssel	Buchungsschlüssel der Person	string	dies kann der Transponder oder auch die Fahrerkarte sein, je nachdem welche Option zur Authentifizierung des Personals gewählt ist	ja^(1,2)
key_from	Personalschlüssel gültig ab		string	wird nur bei folgenden Modi verwendet: new append_key update_key Format: YYYYMMDDHHMMSS wird kein Wert gesetzt, wird die aktuelle Zeit genommen	nein
key_to	Personalschlüssel gültig bis		string	wird nur bei folgenden Modi verwendet: new append_key update_key Format: YYYYMMDDHHMMSS	nein
key_deactivation_date	Personalschlüssel Deaktivierungs-Datum			wird nur bei folgenden Modi verwendet: deactivate_key Format: YYYYMMDDHHMMSS wird kein Wert gesetzt, wird die aktuelle Zeit genommen Der Wert darf nicht in der Zukunft liegen	nein
groups	Personalgruppen	Namen der zugewiesenen Personalgruppen	string	Bezeichnung der zugeordneten Personalgruppe Mehrere Gruppen lassen sich mittels Komma getrennter Liste hinzufügen Beim bearbeiten werden eventuell vorher vorhandene Gruppenzuordnungen gelöscht	nein
card_nr	Ausweisnummer	selbstdefinierte Ausweisnummer der externen Software	string	Dies entspricht der optionale zuweisbaren Ausweisnummer, welche zur Erfassung von Buchungen mittels ReinerSCT genutzt wird	nein
drv_licence_nr	Führerschein	Führerscheinnummer der Person	string		nein⁽³⁾
drv_licence_valid_to	Führerschein gültig bis	Ablaufdatum des Führerscheins	string	Format: YYYYMMDDHHMMSS	nein⁽³⁾
identity_card_nr	Personalausweis	Personalausweisnummer	string		nein⁽³⁾
identity_card_valid_to	Personalausweis gültig bis	Ablaufdatum des Personalausweises	string	Format: YYYYMMDDHHMMSS	nein⁽³⁾
passport_nr	Reisepass	Reisepass Nummer	string		nein⁽³⁾
passport_valid_to	Reisepass gültig bis	Ablaufdatum des Reisepasses	string	Format: YYYYMMDDHHMMSS	nein⁽³⁾
adr_cert_nr	ADR Bescheinigung	Nummer der ADR Bescheinigung	string		nein⁽³⁾
adr_cert_valid_to	ADR Bescheinigung gültig bis	Ablaufdatum der ADR Bescheinigung	string	Format: YYYYMMDDHHMMSS	nein⁽³⁾
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⁽³⁾
birth	Geburtsdatum	Geburtsdatum der Person	string	Format: YYYYMMDDHHMMSS⁽⁴⁾	nein⁽³⁾
job_from	Einstellungsdatum	Einstellungsdatum der Person	string	Format: YYYYMMDDHHMMSS	nein⁽³⁾

Hinweise:
(1) Pflichtfeld beim Anlegen einer Person
(2) Pflichtfeld beim Zuweisen, Bearbeiten oder Deaktivieren eines Personalschlüssels
(3) nur verfügbar, wenn das Digitacho Archiv gebucht wurde
(4) Wenn Tag und/oder Monat unbekannt ist, wird der Geburtstag mit "XX" für die unbekannten Werte aufgefüllt entsprechend deutschem Ausweisgesetz (Bsp: 198006XX oder 1980XXXX)

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

Anlegen einer 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

Bearbeiten einer Person
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

Zuweisen eines Folgeschlüssels
https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&key_from=20180101000000

Aktualisieren eines Personalschlüssels

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

Deaktivieren eines Personalschlüssel

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

Löschen einer Person
https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234