Versions Compared

Old Version 5

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version Current

changes.mady.by.user YellowFox R&D

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Erlaubt das anlegen, bearbeiten und löschen von Personaldaten

Beschreibung

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

Parameter



 

ParameterBezeichnung PersonalverwaltungBeschreibungTypHinweisPflicht
company
 

RTI Firmenschlüsselstring
 

ja
import
 

RTI Importschlüsselstring
 

ja

mode
 

Unterscheidung der verschiedenen Aktionenstring

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

idMA-Nummerselbstdefinierbare Mitarbeiternummerstringdie Mitarbeiternummer muss eindeutig sein und dient dem weiteren Zugriff auf die Personaldatenja
nameNamevollständiger Name der Personstring
 

ja(1)
pkeyPersonalschlüsselBuchungsschlüssel der Personstringdies kann der Transponder oder auch die Fahrerkarte sein, je nachdem welche Option zur Authentifizierung des Personals gewählt ist

ja(1,2)

key_fromPersonalschlüssel gültig ab
 

string

Format: YYYYMMDDHHMMSS

wird kein Wert gesetzt, wird die aktuelle Zeit genommen

nein
key_toPersonalschlüssel gültig bis
 

string

Format: YYYYMMDDHHMMSS

nein
groupsPersonalgruppenNamen der zugewiesenen Personalgruppenstring

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_nrAusweisnummerselbstdefinierte Ausweisnummer der externen SoftwarestringDies entspricht der optionale zuweisbaren Ausweisnummer, welche zur Erfassung von Buchungen mittels ReinerSCT genutzt wirdnein
drv_licence_nrFührerscheinFührerscheinnummer der Personstring
 

nein(3)
drv_licence_valid_toFührerschein gültig bisAblaufdatum des FührerscheinsstringFormat: YYYYMMDDHHMMSSnein(3)
identity_card_nrPersonalausweisPersonalausweisnummerstring
 

nein(3)
identity_card_valid_toPersonalausweis gültig bisAblaufdatum des PersonalausweisesstringFormat: YYYYMMDDHHMMSSnein(3)
passport_nrReisepassReisepass Nummerstring
 

nein(3)
passport_valid_toReisepass gültig bisAblaufdatum des ReisepassesstringFormat: YYYYMMDDHHMMSSnein(3)
adr_
cer
cert_nrADR BescheinigungNummer der ADR Bescheinigungstring
 

nein(3)
adr_cert_valid_toADR Bescheinigung gültig bisAblaufdatum der ADR BescheinigungstringFormat: YYYYMMDDHHMMSSnein(3)
bkrfqg_valid_toQualifikation laut Schlüsselzahl 95 gültig bisGültigkeit der Schulung zum BerufskraftfahrerqualifikationsgesetzstringDie Gültigkeit ist für Berufskraftfahrer auf dem Führerschein unter der Schlüsselzahl 95 erfasstnein(3)
birthGeburtsdatumGeburtsdatum der PersonstringFormat: YYYYMMDDHHMMSS(4)nein(3)
job_fromEinstellungsdatumEinstellungsdatum der PersonstringFormat: YYYYMMDDHHMMSSnein(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ü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

Code Block
titleAnlegen einer Person
httphttps://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
titleBearbeiten einer Person
httphttps://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
titleZuweisen eines Folgeschlüssels
httphttps://map.yellowfox.de/rti/set_person.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&ekeykey_from=20180101000000


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


Sv translation
languageen

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

Description

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

Parameters



 
name
Parameter
parameter
Name in personnel administration
desciption
Desciption
type
Type
remark
Remark
mandatory
Mandatory
company
 

RTI company keystring
 

yes
import
 

RTI import keystring
 

yes

mode
 

differentiate between available actionsstring
vlid

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

idemployee numberself defined employee numberstringthe employee number must be a self defined string for further identification of the personyes
nameNamecomplete name of the personstring
 

yes(1)
pkeypersonnel keypersonnel key for bookingsstringthis may be a transponder or driver card to identify the person and assign booked times correctly

yes(1,2)

key_frompersonnel key valid from
 

string

format: YYYYMMDDHHMMSS

if no value set, the current timestamp will be used

no
key_topersonnel key valid to
 

string

format: YYYYMMDDHHMMSS

no
groupspersonnel groupsnames of personnel groups to assignstring

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_nremployee licence numberself defined number for assignment to an external timerecording softwarestringrequired especially for correct assignment to ReinerSCT time card softwareno
drv_licence_nrdriver licencenumber of driver licencestring
 

no(3)
drv_licence_valid_todriver licence valid toexpiration date of driver licencestringformat: YYYYMMDDHHMMSSno(3)
identity_card_nridentity cardidentity card numberstring
 

no(3)
identity_card_valid_toidentity card valid toexpiration date of identity cardstringformat: YYYYMMDDHHMMSSno(3)
passport_nrpassportpassport numberstring
 

no(3)
passport_valid_topassport valid toexpiration date of passportstringformat: YYYYMMDDHHMMSSno(3)
adr_
cer
cert_nrADR certificatenumber of adr certificatestring
 nein

no(3)
adr_cert_valid_toADR certificate valid toexpiration date of ADR certificatestringformat: YYYYMMDDHHMMSSno(3)
bkrfqg_valid_to
Qualifikation laut Schlüsselzahl 95 gültig bisGültigkeit der Schulung zum BerufskraftfahrerqualifikationsgesetzstringDie Gültigkeit ist für Berufskraftfahrer auf dem Führerschein unter der Schlüsselzahl 95 erfasst
qualification by keynumber 95 valid toexpiration date of german "Berufskraftfahrerqualifikationsgesetz"stringthe expiration date of this qualification is printed at driver licence at key number 95no
(3)
birth
GeburtsdatumGeburtsdatum der Person
date of birthbirthdate of personstring
Format
format: YYYYMMDDHHMMSS(4)
nein
no(3)
job_from
EinstellungsdatumEinstellungsdatum der Person
employee sincestart date of beeing an employee at this companystring
Format
format: YYYYMMDDHHMMSS
nein
no(3)