| 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
| Parameter | Description | Type | Note | Mandatory |
|---|
Parameters | parameter | name in personnel administration | desciption | type | remark | mandatory |
|---|
| company | RTI company key | string |
| yes |
| import | RTI import key | string |
| yes |
mode | | action | Possible request modes |
- edit an existing cost center
- delete:
|
id | employee number | self defined employee number | string | | ident | Identifier of the cost center | string | Unique identifier of the cost center.
Only with this ID is it possible to edit or delete a cost center later. |
pkey | personnel key | personnel key for bookings | string | | valid_from | Start of the cost center's validity | string | YYYYmmddHHiiss |
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(3) | | to | End of the cost center's validity | string | YYYYmmddHHiiss | no |
| 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 personhttp| a 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 |
|---|