Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37

Zeige letzte Bearbeiter
1 (% class="box" %)
2 (((
3 Inhaltsverzeichnis
4 )))
5
6 {{toc/}}
7
8 (% class="box" %)
9 (((
10 **Kompatibilität**
11 Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar.
12 )))
13
14 Erlaubt das anlegen, bearbeiten und löschen von Kostenstellen.
15
16 = Beschreibung =
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
20 = //Parameter// =
21
22
23 |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
24 |company|RTI Firmenschlüssel|string| |ja
25 |import|RTI Importschlüssel|string| |ja
26 |action|Unterscheidung der verschiedenen Aktionen|string|zulässige Modi sind:(((
27 * new: eine neue Kostenstelle anlegen
28 * update: Daten einer angelegten Kostenstelle ändern
29 * delete: eine angelegte Kostenstelle löschen
30 )))|ja
31 |ident|Kennung der Kostenstellen|string|Eindeutige Kennung der Kostenstelle.
32 Nur mit dieser Kennung ist später möglich eine Kostenstelle wieder zu bearbeiten oder zu löschen.|ja
33 |name|Name der Kostenstelle|string| |ja(1)
34 |valid_from|Beginn der Gültigkeit der Kostenstelle|string|YYYYmmddHHiiss|ja(1)
35 |valid_to|Ende der Gültigkeit der Kostenstelle|string|YYYYmmddHHiiss|nein
36 |planned_duration|Geplante Dauer der Kostenstelle|integer|in Minuten|nein
37 |defined_activities|Festgelegte Tätigkeiten der Kostenstellen|array|Ein Array von Objekten die die Kennung (string) und eine optionale Planungsdauer in Minuten (integer oder string) pro Tätigkeit enthalten.
38 Die Kennung der Tätigkeiten muss eindeutig sein und bereits im System hinterlegt sein.
39 Beispiel:
40 {{code language="js"}}[
41 {
42 "ident": "A100",
43 "duration": 2000
44 },
45 {
46 "ident": "A200",
47 "duration": null
48 },
49 {
50 "ident": "A300"
51 }
52 ]{{/code}}|nein
53 |allow_other_activities|Diese Option legt fest ob neben den übergebenen Tätigkeiten "defined_activities" auch andere Tätigkeiten für die Buchung erlaubt sind.|integer|Mögliche Werte: 0 oder 1
54 Standard: 0|nein
55 |defined_persons|Festgelegte Personen der Kostenstelle|array|Ein Array von Mitarbeiternummern(string).
56 Werden Personen für eine Kostenstelle festgelegt, so ist es nur noch diesen Personen möglich auf diese Kostenstelle zu buchen.
57 Die Mitarbeiternummer wird über die Personalverwaltung für jede Person separat festgelegt.
58 Beispiel:
59 {{code language="js"}}[ "M1000", "M1001", "M1002" ]{{/code}}|nein
60
61 Hinweise:
62 (1) Pflichtfeld beim Anlegen einer Kostenstelle
63
64 Werden Felder beim Bearbeiten von Kostenstellen nicht übermittelt, so werden diese nicht verändert.
65
66 = Rückgabe =
67
68 Beim Anlegen und Bearbeiten wird im Erfolgsfall "**COSTCENTER_DATA_SAVED**" zurückgegeben.
69 Beim Löschen einer Kostenstellen wird im Erfolgsfall "**COSTCENTER_DELETED**" zurückgegeben.
70 Bei fehlenden oder fehlerhaften Eingaben wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben.
71
72 = Beispiele =
73
74 **Anlegen einer Kostenstellen mit allen Feldern**
75 {{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}}
76
77 **Bearbeiten des Namens einer Kostenstellen**
78 {{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}}
79
80 **Löschen einer Kostenstellen**
81 {{code language="java"}}https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=delete{{/code}}
82