Sv translation

language	de

Erlaubt das anlegen, bearbeiten und löschen von Personaldaten

Beschreibung

...

Status
colour Blue
title 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

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⁽³⁾
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 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

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

Sv translation

language	en

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

Description

Status

colour	Blue
title	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

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	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
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 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_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⁽³⁾
drv_licence_valid_to	driver licence valid to	expiration date of driver licence	string	format: YYYYMMDDHHMMSS	no⁽³⁾
identity_card_nr	identity card	identity card number	string		no⁽³⁾
identity_card_valid_to	identity card valid to	expiration date of identity card	string	format: YYYYMMDDHHMMSS	no⁽³⁾
passport_nr	passport	passport number	string		no⁽³⁾
passport_valid_to	passport valid to	expiration date of passport	string	format: YYYYMMDDHHMMSS	no⁽³⁾
adr_cert_nr	ADR certificate	number of adr certificate	string		no⁽³⁾
adr_cert_valid_to	ADR certificate valid to	expiration date of ADR certificate	string	format: YYYYMMDDHHMMSS	no⁽³⁾
bkrfqg_valid_to	qualification by keynumber 95 valid to	expiration date of german "Berufskraftfahrerqualifikationsgesetz"	string	the expiration date of this qualification is printed at driver licence at key number 95	no⁽³⁾
birth	date of birth	birthdate of person	string	format: YYYYMMDDHHMMSS⁽⁴⁾	no⁽³⁾
job_from	employee since	start date of beeing an employee at this company	string	format: YYYYMMDDHHMMSS	no⁽³⁾

Remarks:

(1) mandatory on add a new person

(2) mandatory on add a following card

(3) will be only stored, if tacho archive extension active

(4) If day and/or month are unknown, the birthdate is filled up with "XX" for the unknown values according to german passport law (example: 198006XX or 1980XXXX)

Return

On succesful create, edit or assignment of a following key the return string will be "PERSON_DATA_SAVED".

On successful delete of a person the return string will be "PERSON_DELETED".

In case of an error, return the string "ERROR:Description".

Example calls

Code Block

title	Create new 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	Edit person data

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	Assign a following card

https://map.yellowfox.de/rti/set_person.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&ekey_from=20180101000000

Code Block

title	Delete a person

https

...

://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234

Page tree

Versions Compared

Old Version 4

New Version Current

Key

Beschreibung

Status
colour Blue
title POST
set

Parameter

Rückgabe

Beispiele

Description

Parameters

Return

Example calls

Page tree

Page History

Versions Compared

Old Version 4

New Version Current

Key

Beschreibung

StatuscolourBluetitlePOST set

Parameter

Rückgabe

Beispiele

Description

Parameters

Return

Example calls

Status
colour Blue
title POST
set