Versions Compared

Old Version 7

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 8

changes.mady.by.user YellowFox R&D

Saved on

Key

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


Info
titleKompatibilität

Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar.


Erlaubt das anlegen, bearbeiten und löschen von Kostenstellen

Beschreibung

timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&action=ACTION_TYPE&name=COSTCENTER_NAME&valid_from=COSTCENTER_VALIDFROM_DATETIME&valid_to=COSTCENTER_VALIDTO_DATETIME&planned_duration=COSTCENTER_DURATION&defined_activities=COSTCENTER_ACTIVITIES&allow_other_activities=COSTCENTER_OTHER_ACTIVITIES_OPTION&defined_persons=COSTCENTER_PERSONS

Parameter



ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
ja
importRTI Importschlüsselstring

ja

actionUnterscheidung der verschiedenen Aktionenstring

zulässige Modi sind:

  • new: eine neue Kostenstelle anlegen
  • update: Daten einer angelegten Kostenstelle ändern
  • delete: eine angelegte Kostenstelle löschen


ja

nameName der Kostenstellestring
ja(1)
valid_fromBeginn der Gültigkeit der KostenstellestringYYYYmmddHHiissja(1)
valid_toEnde der Gültigkeit der Kostenstelle stringYYYYmmddHHiissnein
planned_durationGeplante Dauer der Kostenstelleintegerin Minutennein
defined_activitiesFestgelegte Tätigkeiten der Kostenstellenarray

Ein Array von Objekten die die Kennung und eine optionale Planungsdauer in Minuten pro Tätigkeit enthalten.
Die Kennung der Tätigkeiten muss eindeutig sein und bereits im System hinterlegt sein.
Beispiel:

Code Block
languagejs
[
	{
		ident: 'A100',
		duration: 2000
	},
	{
		ident: 'A200',
		duration: null
	},
	{
		ident: 'A300'
	}
]


nein
allow_other_activitiesDiese Option legt fest ob neben den übergebenen Tätigkeiten "defined_activities" auch andere Tätigkeiten für die Buchung erlaubt sind.integerMögliche Werte: 0 oder 1
Standard: 0		nein
defined_personsFestgelegte Personen der Kostenstellearray

Ein Array von Mitarbeiternummern(string).
Werden Personen für eine Kostenstelle festgelegt, so ist es nur noch diesen Personen möglich auf diese Kostenstelle zu buchen.
Die Mitarbeiternummer werden über die Personalverwaltung für jede Person separat festgelegt.

Beispiel:

Code Block
languagejs
[ 'M1000', 'M1001', 'M1002' ]


nein

Hinweise:

(1) Pflichtfeld beim Anlegen einer Kostenstelle


Rückgabe

Beim Anlegen und Bearbeiten wird im Erfolgsfall "COSTCENTER_DATA_SAVED" zurückgegeben.

Beim Löschen einer Kostenstellen wird im Erfolgsfall "COSTCENTER_DELETED" zurückgegeben.

Bei fehlenden oder fehlerhaften Eingaben wird ein "ERROR:Beschreibung" zurückgegeben.

Beispiele

Code Block
titleAnlegen einer Kostenstellen
http://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEYCOMPANY_IMPORTKEY&action=new&name=Baustelle&valid_from=20210101000000&valid_to=20211231235959&planned_duration=10000&defined_activities=[{ident:'A100',duration:5000},{ident:'A200',duration:5000}]&allow_other_activities=0&defined_persons=['M1000','M1001']





Sv translation
languageen

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

Description

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



parametername in personnel administrationdesciptiontyperemarkmandatory
company
RTI company keystring
yes
import
RTI import keystring

yes

mode
differentiate between available actionsstring

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_nrADR certificatenumber of adr certificatestring
no(3)
adr_cert_valid_toADR certificate valid toexpiration date of ADR certificatestringformat: YYYYMMDDHHMMSSno(3)
bkrfqg_valid_toqualification 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)
birthdate of birthbirthdate of personstringformat: YYYYMMDDHHMMSS(4)no(3)
job_fromemployee sincestart date of beeing an employee at this companystringformat: YYYYMMDDHHMMSSno(3)

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".

Examples

Code Block
titleCreate new person
http://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
titleEdit person data
http://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
titleAssign a following card
http://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
titleDelete a person
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234