Wiki source code of timerecording/set_costcenter.php
Last modified by YellowFox_RD on 2025/01/23 10:44
Hide last authors
author | version | line-number | content |
---|---|---|---|
![]() |
1.1 | 1 | (% class="box" %) |
![]() |
2.1 | 2 | ((( |
![]() |
4.1 | 3 | Table of Contents |
![]() |
2.1 | 4 | ))) |
5 | |||
![]() |
1.1 | 6 | {{toc/}} |
7 | |||
8 | (% class="box" %) | ||
9 | ((( | ||
![]() |
4.1 | 10 | **Compatibility** |
11 | This function is only available for customers with activated time recording V3. | ||
![]() |
1.1 | 12 | ))) |
13 | |||
![]() |
4.1 | 14 | Allows you to create, edit and delete cost centers. |
![]() |
2.1 | 15 | |
![]() |
4.1 | 16 | = Description = |
![]() |
2.1 | 17 | |
18 | (% class="blue mark" %)**POST**(%%)** //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 | ||
19 | |||
![]() |
4.1 | 20 | = //Parameters// = |
![]() |
1.1 | 21 | |
![]() |
4.1 | 22 | |=Parameter|=Description|=Type|=Note|=Mandatory |
23 | |company|RTI company key|string| |yes | ||
24 | |import|RTI import key|string| |yes | ||
25 | |action|Possible request modes|string|permissible modes are:((( | ||
26 | * new: create a new cost center | ||
27 | * update: edit an existing cost center | ||
28 | * delete: delete a cost center | ||
29 | )))|yes | ||
30 | |ident|Identifier of the cost center|string|Unique identifier of the cost center. | ||
31 | Only with this ID is it possible to edit or delete a cost center later.|yes | ||
32 | |name|Name of the cost center|string| |yes(1) | ||
33 | |valid_from|Start of the cost center's validity|string|YYYYmmddHHiiss|yes(1) | ||
34 | |valid_to|End of the cost center's validity|string|YYYYmmddHHiiss|no | ||
35 | |planned_duration|Planned duration of the cost center|integer|in minutes|no | ||
36 | |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. | ||
37 | The identification of the activities must be unique and already stored in the system. | ||
38 | Example: | ||
![]() |
1.1 | 39 | {{code language="js"}}[ |
![]() |
2.1 | 40 | { |
41 | "ident": "A100", | ||
42 | "duration": 2000 | ||
43 | }, | ||
44 | { | ||
45 | "ident": "A200", | ||
46 | "duration": null | ||
47 | }, | ||
48 | { | ||
49 | "ident": "A300" | ||
50 | } | ||
![]() |
4.1 | 51 | ]{{/code}}|no |
52 | |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 | ||
53 | default: 0|no | ||
54 | |defined_persons|Defined persons of the cost center|array|An array of employee numbers (string). | ||
55 | If persons are specified for a cost center, it is only possible for these persons to create a time booking to this cost center. | ||
56 | The employee number is determined separately for each person via the personnel administration. | ||
57 | {{code language="js"}}[ "M1000", "M1001", "M1002" ]{{/code}}|no | ||
58 | Hints: | ||
59 | (1) Mandatory field when creating a cost center | ||
60 | If fields are not transmitted when editing cost centers, they will not be changed. | ||
![]() |
1.1 | 61 | |
![]() |
4.1 | 62 | = Return = |
![]() |
1.1 | 63 | |
![]() |
4.1 | 64 | When creating and editing, "**COSTCENTER_DATA_SAVED**" is returned if successful. |
65 | When deleting a cost center, "**COSTCENTER_DELETED**" is returned if successful.. | ||
66 | If entries are missing or incorrect, an "(% class="error" %)**ERROR:description**(%%)" is returned. | ||
![]() |
1.1 | 67 | |
![]() |
4.1 | 68 | = Examples = |
![]() |
2.1 | 69 | |
![]() |
4.1 | 70 | **Create a new cost center with all possible fields** |
71 | {{code language="java"}}https://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}} | ||
![]() |
2.1 | 72 | |
![]() |
4.1 | 73 | **Edit the name of a cost center** |
![]() |
1.1 | 74 | {{code language="java"}}https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=update&name=Büro{{/code}} |
75 | |||
![]() |
4.1 | 76 | **Delete a cost center** |
![]() |
1.1 | 77 | {{code language="java"}}https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=delete{{/code}} |
78 |