Info |
---|
| This function is only available for customers with activated time recording V3. |
Allows you Provide functions to create, edit and delete personnel specific datacost centers. Description timerecording/set_ personnelcostcenter.php?company= RTICOMPANY_ COMPANYKEYRTIKEY&import= RTI_VEHICLEKEY&mode=new&id=01234&key_from=YYYYMMDDHHMMSS&pkey=DF123456789012&name=Max%20Mustermann&groups=Fahrer,DresdenCOMPANY_IMPORTKEY&action=ACTION_TYPE&name=COSTCENTER_IDENT&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 Parameters
Parameters |
parameter | name in personnel administration | desciption | type | remark | mandatory |
---|
Parameter | Description | Type | Note | Mandatory |
---|
company | RTI company key | string |
| yes |
import | RTI import key | string |
| yes |
mode | action | Possible request modes |
differentiate between available actionsvalid person change data of an already available person- edit an existing cost center
- delete:
|
remove a personappend_key: add a foreign personnel key to a personid | employee number | ident | Identifier of the cost center |
self defined employee numberthe employee number must be a self defined string for further identification of the personUnique identifier of the cost center. Only with this ID is it possible to edit or delete a cost center later. | yes |
name | Name |
complete name personpkey | personnel key | personnel key for bookings | string | valid_from | Start of the cost center's validity | string | YYYYmmddHHiiss |
this may be a transponder or driver card to identify the person and assign booked times correctly,2keyfromto | End of the cost center's validity |
personnel key valid fromformat: YYYYMMDDHHMMSSif value set, the current timestamp will be usedno | 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(3) | |
planned_duration | Planned duration of the cost center | integer | in minutes | no |
defined_activities | Defined activities of the cost center | array | An array of objects containing the identifier and an optional planning time in minutes per activity. The identification of the activities must be unique and already stored in the system. Example: Code Block |
---|
| [
{
"ident": "A100",
"duration": 2000
},
{
"ident": "A200",
"duration": null
},
{
"ident": "A300"
}
] |
| no |
allow_other_activities | This option determines whether other activities are allowed for the booking in addition to the "defined_activities". | integer | Possible values: 0 or 1 default: 0 | no |
defined_persons | Defined persons of the cost center | array | An array of employee numbers (string). If persons are specified for a cost center, it is only possible for these persons to create a time booking to this cost center. The employee number is determined separately for each person via the personnel administration. Code Block |
---|
| [ "M1000", "M1001", "M1002" ] |
| no |
Hints:
(1) Mandatory field when creating a cost center
If fields are not transmitted when editing cost centers, they will not be changed.
Return
When creating and editing, "COSTCENTER_DATA_SAVED" is returned if successful.
When deleting a cost center, "COSTCENTER_DELETED" is returned if successful..
If entries are missing or incorrect, an "ERROR:description" is returned
drv_licence_valid_to | driver licence valid to | expiration date of driver licence | string | format: YYYYMMDDHHMMSS | no(3) |
identity_card_nr | identity card | identity card number | string | no(3) | identity_card_valid_to | identity card valid to | expiration date of identity card | string | format: YYYYMMDDHHMMSS | no(3) |
passport_nr | passport | passport number | string | no(3) | passport_valid_to | passport valid to | expiration date of passport | string | format: YYYYMMDDHHMMSS | no(3) |
adr_cer_nr | ADR certificate | number of adr certificate | string | no(3) | adr_cert_valid_to | ADR certificate valid to | expiration date of ADR certificate | string | format: YYYYMMDDHHMMSS | no(3) |
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(3) |
birth | date of birth | birthdate of person | string | format: YYYYMMDDHHMMSS(4) | no(3) |
job_from | employee since | start date of beeing an employee at this company | string | format: YYYYMMDDHHMMSS | no(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
new personhttpa new cost center with all possible fields |
|
https://map.yellowfox.de/rti/timerecording/set_ |
personnelcostcenter.php?company=COMPANY_RTIKEY&import= |
IMPORTRTIKEYmodeid1234Maria%20Musterfraupkey98765&group=Aussendienst20210101000000&valid_to=20211231235959&planned_duration=10000&defined_activities=[{"ident":"A100","duration":5000},{"ident":"A200","duration":5000}]&allow_other_activities=0&defined_persons=["M1000","M1001"] |
Code Block |
---|
title | Edit the name of a cost center |
---|
|
https |
Code Block |
---|
|
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 |
---|