| Info |
|---|
| Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar. |
Erlaubt das anlegen, bearbeiten und löschen von Kostenstellen. Beschreibung 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: - new: eine neue Kostenstelle anlegen
- update: Daten einer angelegten Kostenstelle ändern
- delete: eine angelegte Kostenstelle löschen
| 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: | Code Block |
|---|
| [
{
"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: | Code Block |
|---|
| [ "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ückgabeBeim 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| Code Block |
|---|
| title | Anlegen einer Kostenstellen mit allen Feldern |
|---|
| 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 | Bearbeiten des Namens einer Kostenstellen |
|---|
| 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 | Löschen einer Kostenstellen |
|---|
| httphttps://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=delete |
|