timerecording/set_costcenter.php
Inhaltsverzeichnis
Kompatibilität
Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar.
Erlaubt das anlegen, bearbeiten und löschen von Kostenstellen.
Beschreibung
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
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| import | RTI Importschlüssel | string | ja | |
| action | Unterscheidung der verschiedenen Aktionen | string | zulässige Modi sind:
| ja |
| ident | Kennung der Kostenstellen | string | Eindeutige Kennung der Kostenstelle. Nur mit dieser Kennung ist später möglich eine Kostenstelle wieder zu bearbeiten oder zu löschen. | ja |
| name | Name der Kostenstelle | string | ja(1) | |
| valid_from | Beginn der Gültigkeit der Kostenstelle | string | YYYYmmddHHiiss | ja(1) |
| valid_to | Ende der Gültigkeit der Kostenstelle | string | YYYYmmddHHiiss | nein |
| planned_duration | Geplante Dauer der Kostenstelle | integer | in Minuten | nein |
| 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. Die Kennung der Tätigkeiten muss eindeutig sein und bereits im System hinterlegt sein. Beispiel: [ { "ident": "A100", "duration": 2000 }, { "ident": "A200", "duration": null }, { "ident": "A300" } ] | nein |
| 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 Standard: 0 | nein |
| defined_persons | Festgelegte Personen der Kostenstelle | array | Ein Array von Mitarbeiternummern(string). Werden Personen für eine Kostenstelle festgelegt, so ist es nur noch diesen Personen möglich auf diese Kostenstelle zu buchen. Die Mitarbeiternummer wird über die Personalverwaltung für jede Person separat festgelegt. Beispiel: [ "M1000", "M1001", "M1002" ] | nein |
Hinweise:
(1) Pflichtfeld beim Anlegen einer Kostenstelle
Werden Felder beim Bearbeiten von Kostenstellen nicht übermittelt, so werden diese nicht verändert.
Rückgabe
Beim Anlegen und Bearbeiten wird im Erfolgsfall "COSTCENTER_DATA_SAVED" zurückgegeben.
Beim Löschen einer Kostenstellen wird im Erfolgsfall "COSTCENTER_DELETED" zurückgegeben.
Bei fehlenden oder fehlerhaften Eingaben wird ein "ERROR:Beschreibung" zurückgegeben.
Beispiele
Anlegen einer Kostenstellen mit allen Feldern
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"]
Bearbeiten des Namens einer Kostenstellen
https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=update&name=Büro
Löschen einer Kostenstellen
https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=delete