...
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| import | RTI Importschlüssel | string | ja | |
| format | Ausgabeformat der Liste | string | unterstützte Formate sind:
Standard: csv
| nein |
| history | Ausgabe aller Personalschlüssel einer Person oder nur des aktuellsten | int |
Standard: 0 | nein |
| id (1) | Eingrenzung der Ausgabe auf die angegebene Personal-ID | string | siehe strict Parameter | nein |
| name (1) | Eingrenzung der Ausgabe auf Personen mit dem angegebenen Namen | string | siehe strict Parameter | nein |
| pkey (1) | Eingrenzung der Ausgabe auf den angegebenen Personalschlüssel | string | siehe strict Parameter | nein |
| group (1) | Eingrenzung der Ausgabe auf Personen mit der angegebenen Gruppe | string | siehe strict Parameter | nein |
| strict | Für alle Parameter mit (1): Unterscheidung ob genau das Suchwort gefunden werden soll oder alle Ergebnisse, die das Suchwort enthalten | int |
Standard: 1 Betrifft die Parameter: id, name, pkey, group | nein |
Rückgabe
Es
...
wird eine Zeichenkette zurück gegebenBei einem Fehler wird der "403 - Verboten: Zugriff verweigert." HTTP-Header gesendet.
CSV Format
Bei einer korrekten Anfrage werden die Personaldaten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste
Anwortzeile immer die Kopfzeile ist, die die Feld-/Spalten Namen festlegt. Dannach folgen dann die Daten
...
Metainformationen
| Trennzeichen | Semikolon ( ; ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Zeile 1 |
...
Spalte CSV | Spalte JSON/XML | Bezeichnung Personalverwaltung | Beschreibung | Hinweis | |
|---|---|---|---|---|---|
| ID | id | MA-Nummer | selbstdefinierte eindeutige Mitarbeiternummer | ||
| NAME | name | Name | vollständiger Name der Person | ||
| KEY | key[id] | Personalschlüssel | Personalschlüssel (für Buchungen über YellowFox) | ||
| VALID_FROM | key[valid_from] | Personalschlüssel gültig ab | Gültigkeitsbeginn des Personalschlüssels | Format: YYYY-MM-DD HH:MM:SS | |
| VALID_TO | key[valid_to] | Personalschlüssel gültig bis | Gültigkeitsende des Personalschlüssels | Format: YYYY-MM-DD HH:MM:SS | |
| GROUPS | groups[group] | Personalgruppen | Komma getrennte Liste mit den Bezeichnungen der zugewiesenen Personalgruppen | ||
| CARD_NR | card_nr | Ausweisnummer | Entspricht der optioPASSnale zuweisbaren Ausweisnummer, welche zur Erfassung von Buchungen mittels ReinerSCT genutzt wird | ||
| (1)DRV_LICENCE_NR | drv_licence[id] | Führerschein | Führerscheinnummer der Person | Daten nur bei gebuchtem Tacho Archiv | |
| (1)DRV_LICENCE_VALID_TO | drv_licence[valid_to] | Führerschein gültig bis | Ablaufdatum des Führerscheins | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
| (1)IDENTITY_CARD_NR | identity_card[id] | Personalausweis | Personalausweisnummer | Daten nur bei gebuchtem Tacho Archiv | |
| (1)IDENTITY_CARD_VALID_TO | identity_card[valid_to] | Personalausweis gültig bis | Ablaufdatum des Personalausweises | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
| (1)PASSPORT_NR | passport[id] | Reisepass | Reisepass Nummer | Daten nur bei gebuchtem Tacho Archiv | |
| (1)PASSPORT_VALID_TO | passport[valid_to] | Reisepass gültig bis | Ablaufdatum des Reisepasses | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
| (1)ADR_CERTIFICATE_NR | adr_certificate[id] | ADR Bescheinigung | Nummer der ADR Bescheinigung | Daten nur bei gebuchtem Tacho Archiv | |
| (1)ADR_CERTICATE_VALID_TO | adr_certificate[valid_to] | ADR Bescheinigung gültig bis | Ablaufdatum der ADR Bescheinigung | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
| (1)BKRFQG_VALID_TO | bkrfqg[valid_to] | Qualifikation laut Schlüsselzahl 95 gültig bis | Gültigkeit der Schulung zum Berufskraftfahrerqualifikationsgesetz | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
| (1)BIRTHDATE | birthdate | Geburtsdatum | Geburtsdatum der Person | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
| (1)JOB_START_DATE | job_start_date | Einstellungsdatum | Einstellungsdatum der Person | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
...