# API-Referenz Kostenstellen (App-Kennung kostenstellen)

> 15 App-Tools. Aufruf immer mit `POST /api/app-tools`, Header `X-API-KEY`, Body `{"name": "<tool>", "input": {…}}`. Welche Tools ein Schlüssel nutzen darf, zeigt `GET /api/app-tools` der Instanz.

Quelle: https://support.unitedsynergy.com/api/referenz/kostenstellen/

## Datenobjekte

Die Standard-Aktionen je Datenobjekt: list (suchen und blättern), get (einen Datensatz lesen), create, update und delete. Nicht jedes Objekt bietet alle fünf an.

### Kostenstellen: `kostenstellen.kst.*`

#### kostenstellen.kst.list

Liste/Suche: Kostenstellen

- Art: Lesen
- Rechte: Kostenstelle lesen
- Datenklassen: B (intern)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"kostenstellen.kst.list","input":{}}`

#### kostenstellen.kst.get

Detail: Kostenstellen

- Art: Lesen
- Rechte: Kostenstelle lesen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"kostenstellen.kst.get","input":{"id":"<id>"}}`

#### kostenstellen.kst.create

Anlegen: Kostenstellen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Kostenstelle anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `nummer` (string)
  - `bezeichnung` (string, Pflicht)
  - `typCode` (string)
  - `betriebsnummer` (string)
  - `parentId` (string)
  - `gueltigVon` (string)
  - `gueltigBis` (string)
  - `aktiv` (boolean)
  - `beschreibung` (string)
- Beispiel: `{"name":"kostenstellen.kst.create","input":{"bezeichnung":"<bezeichnung>"}}`

#### kostenstellen.kst.update

Ändern: Kostenstellen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Kostenstelle ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `nummer` (string)
  - `bezeichnung` (string)
  - `typCode` (string)
  - `betriebsnummer` (string)
  - `parentId` (string)
  - `gueltigVon` (string)
  - `gueltigBis` (string)
  - `aktiv` (boolean)
  - `beschreibung` (string)
- Beispiel: `{"name":"kostenstellen.kst.update","input":{"id":"<id>"}}`

#### kostenstellen.kst.delete

Löschen: Kostenstellen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Kostenstelle löschen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"kostenstellen.kst.delete","input":{"id":"<id>"}}`

### Kostenstellen-Mitglieder: `kostenstellen.mitglied.*`

#### kostenstellen.mitglied.list

Liste/Suche: Kostenstellen-Mitglieder

- Art: Lesen
- Rechte: Kostenstelle lesen
- Datenklassen: B (intern)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"kostenstellen.mitglied.list","input":{}}`

#### kostenstellen.mitglied.get

Detail: Kostenstellen-Mitglieder

- Art: Lesen
- Rechte: Kostenstelle lesen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"kostenstellen.mitglied.get","input":{"id":"<id>"}}`

#### kostenstellen.mitglied.create

Anlegen: Kostenstellen-Mitglieder

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Kostenstelle anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `kostenstelleId` (string, Pflicht)
  - `personId` (string, Pflicht)
  - `rolle` (string)
  - `von` (string)
  - `bis` (string)
- Beispiel: `{"name":"kostenstellen.mitglied.create","input":{"kostenstelleId":"<kostenstelleId>","personId":"<personId>"}}`

#### kostenstellen.mitglied.update

Ändern: Kostenstellen-Mitglieder

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Kostenstelle ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `kostenstelleId` (string)
  - `personId` (string)
  - `rolle` (string)
  - `von` (string)
  - `bis` (string)
- Beispiel: `{"name":"kostenstellen.mitglied.update","input":{"id":"<id>"}}`

#### kostenstellen.mitglied.delete

Löschen: Kostenstellen-Mitglieder

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Kostenstelle löschen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"kostenstellen.mitglied.delete","input":{"id":"<id>"}}`

## Wertelisten

Auswahllisten der App wie Status, Arten oder Kategorien. Du pflegst sie mit denselben fünf Aktionen. Die Werte (code) nutzt du in den Feldern der Datenobjekte.

### Kostenstellen-Typen: `kostenstellen.typ.*`

#### kostenstellen.typ.list

Liste/Suche: Katalog „Kostenstellen-Typen" (kostenstellen)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"kostenstellen.typ.list","input":{}}`

#### kostenstellen.typ.get

Detail: Katalog „Kostenstellen-Typen" (kostenstellen)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"kostenstellen.typ.get","input":{"id":"<id>"}}`

#### kostenstellen.typ.create

Anlegen: Katalog „Kostenstellen-Typen" (kostenstellen)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `label` (string, Pflicht): Anzeige-Text
  - `code` (string): Optional, sonst aus label abgeleitet. Immutable
  - `color` (string): Tailwind-Paar, z.B. "bg-blue-100 text-blue-700"
  - `icon` (string): Lucide-Icon-Name
  - `beschreibung` (string)
- Beispiel: `{"name":"kostenstellen.typ.create","input":{"label":"<label>"}}`

#### kostenstellen.typ.update

Ändern: Katalog „Kostenstellen-Typen" (kostenstellen)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"kostenstellen.typ.update","input":{"id":"<id>"}}`

#### kostenstellen.typ.delete

Löschen: Katalog „Kostenstellen-Typen" (kostenstellen)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"kostenstellen.typ.delete","input":{"id":"<id>"}}`