Info |
---|
| This function is only available for customers with activated time recording V3. |
Allows you to create, edit and delete cost centers. Description timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_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 | Hint | Mandatory |
---|
company | RTI company key | string |
| yes | import | RTI import key | string |
| yes | action | Possible request modes | string | permissible modes are: - new: create a new cost center
- update: edit an existing cost center
- delete: delete a cost center
| yes | 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. | yes | name | Name of the cost center | string |
| yes(1) | valid_from | Start of the cost center's validity | string | YYYYmmddHHiiss | yes(1) | valid_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.
ReturnWhen 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. Examples Code Block |
---|
title | Create a new cost center with all possible fields |
---|
| httphttps://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&action=new&ident=B1234&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"] |
Code Block |
---|
title | Edit the name of a cost center |
---|
| httphttps://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=update&name=Büro |
Code Block |
---|
title | Delete a cost center |
---|
| httphttps://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=delete |
|