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
| parameterParameter | name Name in personnel administration | desciptionDesciption | typeType | remarkRemark | mandatoryMandatory |
|---|
| 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(3) | | 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) ReturnOn 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". ExamplesExample calls| Code Block |
|---|
| 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 |
|---|
| 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 |
|---|
| https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234 |
|