Erlaubt das anlegen, bearbeiten und löschen von Personaldaten Beschreibung 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(1) | | 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 | Format: YYYYMMDDHHMMSS wird kein Wert gesetzt, wird die aktuelle Zeit genommen | nein | | key_to | Personalschlüssel gültig bis |
| string | Format: YYYYMMDDHHMMSS | 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(3) | | drv_licence_valid_to | Führerschein gültig bis | Ablaufdatum des Führerscheins | string | Format: YYYYMMDDHHMMSS | nein(3) | | identity_card_nr | Personalausweis | Personalausweisnummer | string |
| nein(3) | | identity_card_valid_to | Personalausweis gültig bis | Ablaufdatum des Personalausweises | string | Format: YYYYMMDDHHMMSS | nein(3) | | passport_nr | Reisepass | Reisepass Nummer | string |
| nein(3) | | passport_valid_to | Reisepass gültig bis | Ablaufdatum des Reisepasses | string | Format: YYYYMMDDHHMMSS | nein(3) | | adr_cercert_nr | ADR Bescheinigung | Nummer der ADR Bescheinigung | string |
| nein(3) | | adr_cert_valid_to | ADR Bescheinigung gültig bis | Ablaufdatum der ADR Bescheinigung | string | Format: YYYYMMDDHHMMSS | nein(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(4) | 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 (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ückgabeBeim 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| Code Block |
|---|
| title | 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 |
| Code Block |
|---|
| title | 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 |
| Code Block |
|---|
| title | Zuweisen eines Folgeschlüssels |
|---|
| https://map.yellowfox.de/rti/set_person.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&key_from=20180101000000 |
| Code Block |
|---|
| title | Löschen einer Person |
|---|
| https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234 |
|