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

Verstecke letzte Bearbeiter
YellowFox_RD 1.1 1 (% class="box" %)
Dominic Lippmann 2.1 2 (((
3 Inhaltsverzeichnis
4 )))
5
YellowFox_RD 1.1 6 {{toc/}}
7
8 (% class="box" %)
9 (((
Dominic Lippmann 2.1 10 **Kompatibilität**
11 Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar.
YellowFox_RD 1.1 12 )))
13
14 Erlaubt das anlegen, bearbeiten und löschen von Kostenstellen.
Dominic Lippmann 2.1 15
YellowFox_RD 1.1 16 = Beschreibung =
Dominic Lippmann 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
YellowFox_RD 1.1 20 = //Parameter// =
21
Dominic Lippmann 2.1 22
YellowFox_RD 1.1 23 |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
Dominic Lippmann 2.1 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:(((
YellowFox_RD 1.1 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
Dominic Lippmann 2.1 33 |name|Name der Kostenstelle|string| |ja(1)
YellowFox_RD 1.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"}}[
Dominic Lippmann 2.1 41 {
42 "ident": "A100",
43 "duration": 2000
44 },
45 {
46 "ident": "A200",
47 "duration": null
48 },
49 {
50 "ident": "A300"
51 }
YellowFox_RD 1.1 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 =
Dominic Lippmann 2.1 67
YellowFox_RD 1.1 68 Beim Anlegen und Bearbeiten wird im Erfolgsfall "**COSTCENTER_DATA_SAVED**" zurückgegeben.
Dominic Lippmann 2.1 69 Beim Löschen einer Kostenstellen wird im Erfolgsfall "**COSTCENTER_DELETED**" zurückgegeben.
YellowFox_RD 1.1 70 Bei fehlenden oder fehlerhaften Eingaben wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben.
Dominic Lippmann 2.1 71
YellowFox_RD 1.1 72 = Beispiele =
Dominic Lippmann 2.1 73
YellowFox_RD 1.1 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