# SynCore-API: Anleitungen und Referenz

> Die SynCore-API hat einen Endpunkt: `/api/app-tools`. `GET` liefert den Katalog der Tools, die der API-Key nutzen darf, `POST` führt ein Tool aus. Diese Datei enthält alle Artikel von https://support.unitedsynergy.com/api/ und https://support.unitedsynergy.com/mcp/ und die Referenz aller 867 App-Tools aus 26 Apps (355 lesen, 189 anlegen, 174 ändern, 148 löschen, 1 sonstige). Maßgeblich für eine Instanz bleibt ihr eigener Katalog.

---

# API & Integrationen im Überblick

> Was die App-Tools-API kann, was du dafür brauchst und in welcher Reihenfolge du vorgehst.

Quelle: https://support.unitedsynergy.com/api/uebersicht/

Mit der **App-Tools-API** bindest du SynCore an andere Systeme an: Daten lesen, Datensätze anlegen oder ändern, Abläufe anstoßen. Die API nutzt dieselben Aktionen wie SynCore selbst und prüft dieselben Rechte wie bei einem Benutzer in der Oberfläche.

## So ist die API aufgebaut

- **Ein Endpunkt:** `/api/app-tools`. `GET` liefert den Katalog der für dich erlaubten Aktionen, der sogenannten Tools. `POST` führt genau eines davon aus.
- **Ein Schlüssel je Integration:** Der API-Key gehört zu einem Mandanten und handelt als ein technischer Benutzer, der **Actor-User**. Was dieser Benutzer in SynCore sehen und ändern darf, darf auch die Integration.
- **Ein Katalog, der sich anpasst:** Welche Tools es gibt, hängt von den aktiven Apps, den Rollen und den Datenbereichen des Actor-Users ab. Eine feste, für alle gültige Tool-Liste gibt es nicht.
- **Eine Spur im Audit-Log:** Standardmäßig steht jeder ausgeführte Aufruf mit Mandant, Actor-User, Tool und Ergebnis im Audit-Log. Wie die API geschützt ist, steht unter [Sicherheit der API](https://support.unitedsynergy.com/api/sicherheit/).

## In dieser Reihenfolge vorgehen

1. Technischen Benutzer mit knappen Rechten anlegen und API-Key beantragen: [API-Keys, Scopes und Berechtigungen](https://support.unitedsynergy.com/api/api-keys/)
2. Ersten Katalog abrufen und ein lesendes Tool ausführen: [API-Quickstart](https://support.unitedsynergy.com/api/quickstart/)
3. Anfragen und Fehlerfälle gezielt testen: [API-Anfragen sicher testen](https://support.unitedsynergy.com/api/anfragen-testen/)
4. Felder, Antworten, Statuscodes und Limits nachschlagen: [App-Tools-API Referenz](https://support.unitedsynergy.com/api/app-tools/)
5. Tools einer App mit Eingabefeldern und Rechten nachschlagen: [Referenz nach App](https://support.unitedsynergy.com/api/referenz/)

Für einige feste Aufgaben, etwa ein Anmeldeformular auf deiner Website oder Bestellungen aus einem Shop, gibt es eigene Endpunkte mit eigenem Scope: [Spezialanbindungen neben den App-Tools](https://support.unitedsynergy.com/api/spezialanbindungen/).

## Mit KI-Assistenten arbeiten

Claude, Cursor, VS Code und andere Clients verbindest du direkt über MCP mit deiner Instanz. Der Assistent nutzt dann dieselben Tools mit denselben Rechten wie die API, auf Wunsch im Code-Mode mit Programmen statt Einzelaufrufen. Alles dazu steht in der Rubrik [MCP & KI-Assistenten](https://support.unitedsynergy.com/mcp/uebersicht/).

Damit ein Assistent die Dokumentation kennt, gib Claude, ChatGPT oder deinem eigenen Assistenten die Adresse `https://support.unitedsynergy.com/api/llms.txt`. Darin stehen alle Artikel zur API und zu MCP und die Referenz aller App-Tools als Klartext. Jede Seite gibt es auch einzeln: Häng `llms.txt` an ihre Adresse an, zum Beispiel `/api/referenz/crm/llms.txt`. Eine Übersicht aller Dateien steht unter `/llms.txt`.

Den API-Key gibst du dem Assistenten nicht in den Chat. Er gehört in die Umgebung, in der die Aufrufe laufen.

> **Grenzen der API**
>
> Tools für besonders geschützte Daten der Datenklasse D, zum Beispiel Gesundheitsdaten, bietet die API nicht an. Pro Schlüssel gilt ein Anfragelimit, die Werte stehen in der [Referenz](https://support.unitedsynergy.com/api/app-tools/#anfragelimits).

> **Wenn es nicht klappt**
>
> Statuscodes, Meldungen und ihre häufigsten Ursachen findest du unter [Wenn eine API-Anfrage scheitert](https://support.unitedsynergy.com/api/fehlerbehebung/).

---

# API-Quickstart

> Rufe den persönlichen App-Tool-Katalog ab und führe deine erste sichere SynCore-Anfrage aus.

Quelle: https://support.unitedsynergy.com/api/quickstart/

SynCore stellt Integrationen über die **App-Tools-API** bereit. Der Katalog ist dynamisch: Du siehst ausschließlich die Apps und Aktionen, die für den Benutzer hinter deinem API-Key freigegeben sind.

> **Das brauchst du**
>
> Du benötigst die Basis-URL deiner SynCore-Instanz und einen API-Key mit dem Scope `app-tools` und einem zugeordneten Actor-User. Den Rohwert des Schlüssels erhältst du nur einmal.

## 1. Zugangsdaten als Umgebungsvariablen setzen

PowerShell:

```powershell
$SynCoreBaseUrl = 'https://syncore.example.com'
$env:SYNCORE_API_KEY = 'syn_DEIN_SCHLUESSEL'
```

Bash, z. B. unter Linux oder macOS:

```bash
export SYNCORE_BASE_URL='https://syncore.example.com'
export SYNCORE_API_KEY='syn_DEIN_SCHLUESSEL'
```

Verwende die URL ohne abschließenden Schrägstrich. Schreibe den Schlüssel nicht in Quellcode, Git-Repositories, Tickets oder Screenshots.

## 2. Deinen verfügbaren Katalog abrufen

PowerShell:

```powershell
$Headers = @{ 'X-API-KEY' = $env:SYNCORE_API_KEY }
Invoke-RestMethod `
  -Method Get `
  -Uri "$SynCoreBaseUrl/api/app-tools?includeStructure=1" `
  -Headers $Headers
```

curl:

```bash
curl --request GET \
  "$SYNCORE_BASE_URL/api/app-tools?includeStructure=1" \
  --header "X-API-KEY: $SYNCORE_API_KEY"
```

Die Antwort enthält:

- `tools`: alle für diesen Schlüssel erlaubten Aktionen mit Ein- und Ausgabeschema,
- `structure`: sichtbare Apps, Seiten, Navigation und effektive Berechtigungen,
- `rules`: verbindliche Laufzeitregeln für Auswahl, Bestätigung und Readback.

## 3. Ein lesendes Tool auswählen

Wähle für den ersten Test aus `tools[]` ein Tool mit `sideEffect: "none"`. Übernimm den `name` exakt und bilde `input` nach dem gelieferten `inputSchema`.

```json
{
  "name": "textbausteine.list_templates",
  "input": {
    "limit": 10
  }
}
```

Der Name ist nur ein Beispiel. Ist die App nicht aktiviert oder fehlen dem Actor-User die Rechte, erscheint dieses Tool gar nicht in deinem Katalog.

## 4. Tool ausführen

```powershell
$Body = @'
{
  "name": "textbausteine.list_templates",
  "input": { "limit": 10 }
}
'@

Invoke-RestMethod `
  -Method Post `
  -Uri "$SynCoreBaseUrl/api/app-tools" `
  -Headers $Headers `
  -ContentType 'application/json' `
  -Body $Body
```

Eine erfolgreiche Antwort hat immer `ok: true` und nennt das ausgeführte Tool sowie das Modul. Die Fachdaten stehen je nach Tool in `data` oder in weiteren, im `outputSchema` beschriebenen Feldern.

> **Ergebnis**
>
> Wenn der Katalog geladen wird und ein lesendes Tool `ok: true` zurückgibt, sind URL, API-Key, Scope, Actor-User und dessen Berechtigungen korrekt eingerichtet.

## Sicherheitsregeln

1. Lade vor einer Aktion immer zuerst den aktuellen Katalog mit `includeStructure=1`.
2. Rate keine IDs. Ermittle Datensätze zuerst über ein sichtbares Listen- oder Such-Tool.
3. Bei mehreren Treffern muss der Benutzer die Auswahl treffen.
4. Führe Aktionen mit `confirmationRequired: true` erst nach ausdrücklicher Bestätigung aus.
5. Prüfe Änderungen anschließend mit einem Lese- oder Listen-Tool.

Standardmäßig steht jeder ausgeführte Tool-Aufruf, auch ein fachlich gescheiterter, mit Mandant, Actor-User, Tool und Ergebnis im Audit-Log. Was sich abschalten lässt, steht unter [Sicherheit der API](https://support.unitedsynergy.com/api/sicherheit/). Abgewiesene Aufrufe (`400`, `403`, `404`) erreichen das Tool nicht. Die Aufbewahrung richtet sich nach der Audit-Einstellung des Mandanten.

---

# API-Keys, Scopes und Berechtigungen

> Verstehe, wie ein SynCore-API-Key einem Mandanten und einem Benutzer mit begrenzten Rechten zugeordnet ist.

Quelle: https://support.unitedsynergy.com/api/api-keys/

Ein API-Key ist kein Generalschlüssel. Er gehört zu genau einem Mandanten und handelt für App-Tools als ein fest zugeordneter **Actor-User**.

## Zweistufiges Berechtigungsmodell

| Stufe | Prüfung |
| --- | --- |
| API-Key | Der Schlüssel muss gültig, nicht gesperrt und mit dem Scope `app-tools` ausgestattet sein. |
| Actor-User | Dessen Rollen, aktivierte Apps, Datenrechte und Datenscopes entscheiden, welche Tools sichtbar und ausführbar sind. |

Ein erfolgreicher Katalogaufruf zeigt daher nicht alle SynCore-Funktionen, sondern nur die für diese technische Identität erlaubten Aktionen.

## API-Key beantragen

API-Keys stellt die SynCore-Plattformadministration aus, nicht der Mandant selbst. So bereitest du den Antrag vor:

1. Lege für die Integration einen eigenen **technischen Benutzer** an, zum Beispiel „Integration Warenwirtschaft". Wie das geht, steht unter [Einen Benutzer anlegen](https://support.unitedsynergy.com/benutzer/benutzer-anlegen/).
2. Gib diesem Benutzer nur die Rollen und Datenbereiche, die die Integration wirklich braucht.
3. Wende dich an den Support und nenne: Mandant, Zweck der Integration, den technischen Benutzer, ob der Schlüssel für Test oder Produktion gedacht ist und ob er Daten löschen soll (siehe [Löschen über den Schlüssel](#löschen-über-den-schlüssel)).

Der vollständige Rohwert beginnt mit `syn_` und wird nur unmittelbar nach der Erstellung angezeigt. SynCore speichert danach nur einen SHA-256-Hash und ein kurzes Präfix.

> **Rohwert sofort sichern**
>
> Verlierst du den einmal angezeigten Rohwert, kann SynCore ihn nicht wiederherstellen. Dann wird der alte Schlüssel gesperrt und ein neuer ausgegeben.

## Ausgabe und Widerruf (Plattformadministration)

1. Öffne in der Admin-Konsole unter **Zugriff** die Seite **API Keys**. Die Liste zeigt die Schlüssel des aktiven Mandanten. Einen anderen wählst du links über der Tabelle in der Auswahl **Mandant**; hinter jedem Namen steht die Zahl seiner Schlüssel. **Alle Mandanten** zeigt alle Schlüssel nur zum Lesen, ohne Aktionen.
2. Klick oben rechts auf **Key erzeugen**. Es öffnet sich der Dialog **MCP-Zugang (App-Tools-Key)** mit dem Namen des Mandanten.
3. Wähle unter **Actor-User** den technischen Benutzer. Zur Auswahl stehen nur Mitglieder dieses Mandanten.
4. Trag unter **Bezeichnung** einen sprechenden Namen ein (vorbelegt ist „MCP App-Tools").
5. Soll die Integration löschen dürfen, schalte **Löschen erlaubt** ein und prüf die **Grenze je Stunde** (vorbelegt 200). Ohne diesen Schalter löscht der Schlüssel nichts.
6. Klick auf **Key erzeugen** und übergib den angezeigten Schlüssel sofort auf einem sicheren Weg. Er ist nur dieses eine Mal sichtbar.

Der Schlüssel bekommt immer den Scope `app-tools` und gilt für die App-Tools-API und für den [MCP-Zugang](https://support.unitedsynergy.com/mcp/verbinden/), dessen Adresse unten im Dialog steht. Schlüssel mit anderen Scopes, etwa für eine Newsletter-Anmeldung von deiner Website, stellt United Synergy aus: [Spezialanbindungen neben den App-Tools](https://support.unitedsynergy.com/api/spezialanbindungen/). In der Liste steht er mit Bezeichnung, Präfix, Mandant, Scopes, der Spalte **Löschen**, Alter, letzter Nutzung und Status. Über **⋯** in seiner Zeile:

- **Bearbeiten** öffnet den Dialog **Key bearbeiten**, ebenso ein Klick auf die Zeile. Dort änderst du die **Bezeichnung** und bei Schlüsseln mit Benutzer den **Code-Mode** (mit **Programme freigeben**: **Niemand** = Programme schreiben sofort mit den Rechten des Benutzers, sonst gibt die gewählte Person jeden Schreibaufruf frei), **Löschen erlaubt** und die **Grenze je Stunde**. **Speichern** übernimmt alles in einem Schritt. Benutzer, Scopes und Laufzeit lassen sich nicht ändern; dafür stellst du einen neuen Schlüssel aus oder rotierst.
- **Löschen freigeben** erscheint nur, wenn die Grenze überschritten wurde, und hebt die Sperre auf. Dasselbe geht im Dialog **Key bearbeiten** über den Hinweis oben.
- **Widerrufen** sperrt den Schlüssel nach einer Rückfrage sofort, Integrationen mit diesem Schlüssel bekommen danach `401`.

Ausgabe, Widerruf, Änderungen aus **Key bearbeiten** (mit altem und neuem Wert), Sperre und Freigabe stehen im Audit-Log.

Die Seite **API-Keys** der Admin-Konsole zeigt alle Schlüssel mit Alter, letzter Nutzung und Status. Sie markiert Schlüssel, die nie genutzt wurden, seit 90 Tagen still sind oder älter als 180 Tage sind. Abgeschaltet wird dabei nichts.

> **Kein automatischer Ablauf**
>
> Ein API-Key läuft nicht von selbst ab. So fällt keine Integration ohne Vorwarnung aus. Tauschen und Sperren passieren immer bewusst.

## Schlüssel tauschen

1. Lass einen neuen Schlüssel für denselben Actor-User ausgeben.
2. Stell die Integration auf den neuen Schlüssel um und prüf sie mit einem lesenden Tool.
3. Lass den alten Schlüssel widerrufen.

Ein Mandant kann mehrere aktive Schlüssel haben, deshalb entsteht beim Wechsel keine Lücke.

## Actor-User nach dem Least-Privilege-Prinzip

Verwende für eine Integration einen eigenen technischen Benutzer und gib ihm nur die tatsächlich benötigten Rollen und Datenbereiche. Nutze keinen Plattform-Administrator als Actor-User, nur um Berechtigungsprobleme zu umgehen.

Änderungen an Rollen oder aktivierten Apps wirken beim nächsten API-Aufruf. Auch ein gültiger Schlüssel kann deshalb später einen kleineren Katalog oder `403 Forbidden` erhalten.

Soll eine Integration nur lesen, gib dem technischen Benutzer eine Rolle, die nur lesen darf. Der Schlüssel kann dann nichts anlegen, ändern oder löschen.

## Löschen über den Schlüssel

Jeder Schlüssel trägt zwei Einstellungen zum Löschen. Sie gelten für alles, was über diesen Schlüssel läuft, also App-Tools-API und MCP. In der Oberfläche von SynCore ändern sie nichts, dort entscheiden weiter die Rollen.

| Einstellung | Wirkung |
| --- | --- |
| Löschen erlaubt | Aus: Tools, die Daten löschen, fehlen im Katalog und in der Tool-Liste deines MCP-Clients. Ein Aufruf trotzdem endet mit `403`. Neue Schlüssel bekommen „aus“, Schlüssel von vor dem 31.10.2026 behalten das Löschen. |
| Grenze je Stunde | Höchstzahl Löschungen über diesen Schlüssel in einer Stunde, Standard 200. Die nächste Löschung endet mit `429`, danach ist Löschen über den Schlüssel gesperrt und die Plattformadministration bekommt einen Alarm. Lesen, Anlegen und Ändern laufen weiter. |

Ob der Actor-User etwas löschen darf, entscheiden weiter seine Rollen. Die Einstellungen am Schlüssel schränken nur ein, sie erlauben nie mehr, als die Rollen erlauben. Eine Sperre nach überschrittener Grenze hebt nur die Plattformadministration auf. Viele Datensätze landen beim Löschen im Papierkorb und lassen sich von dort zurückholen, Einträge in Wertelisten werden dagegen endgültig gelöscht.

## Schlüssel sicher verwenden

- Übertrage den Schlüssel ausschließlich über HTTPS im Header `X-API-KEY`.
- Verwende nie Query-Parameter wie `?apiKey=...`.
- Halte Schlüssel aus Quellcode, Browser-Frontend, Logs, Tickets und Screenshots heraus.
- Speichere ihn in einem Secret Store oder als geschützte Umgebungsvariable.
- Verwende getrennte Schlüssel für Test und Produktion.
- Sperre einen kompromittierten oder nicht mehr benötigten Schlüssel sofort.
- Stimme eine regelmäßige Rotation mit allen beteiligten Systemen ab.

## Wo welcher Schlüssel liegt

| Was | Wo abgelegt | Wer nutzt es |
| --- | --- | --- |
| Dein SynCore-API-Key im Klartext | Auf der Seite der Integration: Secret Store oder geschützte Umgebungsvariable | Nur die Integration |
| Derselbe Schlüssel in SynCore | Nur als SHA-256-Hash mit Präfix, nicht umkehrbar | SynCore prüft damit jede Anfrage |
| Zugangsdaten, die SynCore für andere Dienste braucht, zum Beispiel Kartendienst, Mailversand oder angebundene externe Tools | Im **Credential Store** der Admin-Konsole, je Mandant verschlüsselt (AES-256-GCM) | Nur SynCore selbst. Anlegen, Ändern und Löschen stehen im Audit-Log, der letzte Zugriff wird vermerkt |

Leg deinen SynCore-API-Key nicht im Credential Store ab. Der ist für Zugangsdaten gedacht, mit denen SynCore andere Dienste aufruft, nicht für Schlüssel, mit denen andere SynCore aufrufen.

## Authentifizierungsbeispiel

```http
GET /api/app-tools?includeStructure=1 HTTP/1.1
Host: syncore.example.com
X-API-KEY: syn_...
Accept: application/json
```

Der Headername ist nicht case-sensitiv. In der Dokumentation verwenden wir einheitlich `X-API-KEY`.

## Typische Authentifizierungsfehler

| Status | Bedeutung |
| --- | --- |
| `401` | Schlüssel fehlt, ist unbekannt oder wurde gesperrt. |
| `403` | Scope `app-tools` fehlt, kein Actor-User ist zugeordnet, dessen Berechtigung reicht nicht aus, oder der Schlüssel darf nicht löschen bzw. ist für Löschungen gesperrt. |
| `429` | Zu viele Anfragen mit diesem Schlüssel (warte die Sekunden aus `Retry-After` ab) oder die Grenze für Löschungen je Stunde ist erreicht (dann bleibt Löschen gesperrt, bis die Plattformadministration freigibt). |

Mehr Fälle mit den genauen Meldungen stehen unter [Wenn eine API-Anfrage scheitert](https://support.unitedsynergy.com/api/fehlerbehebung/).

Gib bei einer Supportanfrage nur das sichtbare Schlüsselpräfix und den Namen des Schlüssels an, niemals den vollständigen Rohwert.

---

# Sicherheit der API

> Wie SynCore Zugriffe über die API schützt, was deine Integration beitragen muss und wo du Sicherheitslücken meldest.

Quelle: https://support.unitedsynergy.com/api/sicherheit/

Diese Seite fasst zusammen, wie die SynCore-API geschützt ist und was deine Integration selbst beitragen muss. Sie hilft dir bei der Einrichtung und bei einer Sicherheitsprüfung, zum Beispiel wenn du als Einrichtung unter NIS2 deine Dienstleister bewerten musst.

## Was SynCore schützt

- **Schlüssel:** Ein API-Key besteht aus `syn_` und 24 Zufallsbytes. SynCore speichert davon nur einen SHA-256-Hash und die ersten zwölf Zeichen als Erkennungsmerkmal. Den vollständigen Schlüssel siehst du genau einmal, bei der Ausgabe.
- **Zweck:** Jeder Schlüssel trägt Scopes. Ein App-Tools-Schlüssel öffnet nur die App-Tools, jede [Spezialanbindung](https://support.unitedsynergy.com/api/spezialanbindungen/) verlangt ihren eigenen Scope.
- **Rechte:** Ein App-Tools-Schlüssel handelt als ein technischer Benutzer, der Actor-User. Die API prüft bei jedem Aufruf dieselben Rollen, Rechte und Datenbereiche wie in der Oberfläche. Hat der Schlüssel keinen Actor-User oder gibt es ihn nicht mehr, lehnt SynCore jeden Aufruf ab.
- **Mandantentrennung:** Ein Schlüssel gehört zu genau einem Mandanten. Kein Feld der Anfrage kann den Mandanten wechseln, jede Abfrage bleibt auf diesen Mandanten beschränkt.
- **Besonders geschützte Daten:** Tools für Daten der Datenklasse D, etwa Personalakten, Abwesenheiten, Schülerdaten und Lohnabrechnungen, bietet die API nicht an. Diese Daten bearbeitest du nur in der Oberfläche.
- **Änderungen mit Rückfrage:** Tools, die Daten anlegen, ändern oder löschen, sind im Katalog mit `confirmationRequired` gekennzeichnet. SynCore markiert, deine Anwendung holt die ausdrückliche Bestätigung ein.
- **Protokoll:** Standardmäßig steht jeder ausgeführte Aufruf mit Mandant, Actor-User, Tool und Ergebnis im Audit-Log, auch ein fachlich gescheiterter. Die Eingabedaten selbst speichert das Protokoll nicht. Mandanten-Administratoren können die Protokollierung einzelner Bereiche abschalten. Belege, Personal- und Schülerdaten werden immer protokolliert.
- **Anfragelimits:** Pro Schlüssel sind 1.200 Anfragen pro Minute und Endpunkt erlaubt, darüber antwortet SynCore mit `429`. Details stehen unter [Anfragelimits](https://support.unitedsynergy.com/api/app-tools/#anfragelimits).
- **Kein Zugriff aus fremden Webseiten:** Die API sendet keine CORS-Freigaben. Skripte auf anderen Webseiten können sie im Browser deshalb nicht aufrufen. Der MCP-Zugang lehnt Anfragen mit fremdem `Origin` zusätzlich mit `403` ab.
- **MCP mit denselben Regeln:** Der [MCP-Zugang](https://support.unitedsynergy.com/mcp/verbinden/) nutzt dieselben Schlüssel und dieselben Prüfungen wie die App-Tools-API. Im Audit-Log steht als Quelle „mcp“. Mit `?nur=lesen` an der Adresse sieht ein Assistent nur Werkzeuge, die nichts verändern.
- **Fehlermeldungen ohne Interna:** Scheitert ein Tool an der Datenbank, nennt die Antwort nur den Fehlercode und einen verständlichen Satz, keine Abfragen und keine Tabellennamen.
- **Sofortige Sperre:** Ein widerrufener Schlüssel gilt ab der nächsten Anfrage nicht mehr, die Integration bekommt `401`.
- **Zugangsdaten zu fremden Diensten:** Passwörter und Schlüssel für angebundene Dienste liegen verschlüsselt (AES-256-GCM) je Mandant im Credential Store, getrennt von den API-Keys. Mehr dazu unter [Wo welcher Schlüssel liegt](https://support.unitedsynergy.com/api/api-keys/).

## Was deine Integration beitragen muss

1. Leg für jede Integration einen eigenen technischen Benutzer mit knappen Rechten an, nie ein persönliches Konto: [API-Key beantragen](https://support.unitedsynergy.com/api/api-keys/).
2. Halte den Schlüssel auf dem Server, in einem Secret-Speicher oder einer Umgebungsvariable. Er gehört nicht in Browser-Code, Repositories, Tickets, Mails oder in den Chat mit einem KI-Assistenten.
3. Ruf SynCore nur über die HTTPS-Adresse deiner Instanz auf.
4. Führ Tools mit `confirmationRequired` erst nach ausdrücklicher Bestätigung aus und prüf das Ergebnis mit einem Lese-Tool.
5. Tausch Schlüssel regelmäßig, denn sie laufen nicht von selbst ab. Könnte ein Schlüssel bekannt geworden sein, lass ihn sofort widerrufen.
6. Speichere Antworten mit Personendaten nur so lange, wie deine Anwendung sie braucht, und schreib sie nicht in Protokolle.

> **Sicherheitskonzept für Prüfungen**
>
> Für eine Sicherheitsprüfung, zum Beispiel als Einrichtung unter NIS2, stellt United Synergy das Sicherheitskonzept von SynCore auf Anfrage über den [Support](https://support.unitedsynergy.com/support/) bereit.

## Sicherheitslücke gefunden?

Schreib an **security@unitedsynergy.com**. Die Kontaktdaten stehen auch in der Datei `/.well-known/security.txt` jeder SynCore-Instanz. Beschreib, was du gefunden hast und wie es sich nachstellen lässt. Schick keine echten Personendaten und nie einen vollständigen API-Key.

> **Wenn du einen Missbrauch vermutest**
>
> Lass den betroffenen Schlüssel sofort widerrufen und melde den Vorfall über den [Support](https://support.unitedsynergy.com/support/). Nenne das Präfix des Schlüssels, den Zeitraum und was dir aufgefallen ist.

---

# App-Tools-API Referenz

> Referenz für Katalogabruf, Tool-Metadaten, Ausführung, Antworten und Fehler der SynCore-App-Tools-API.

Quelle: https://support.unitedsynergy.com/api/app-tools/

Die App-Tools-API hat einen zentralen Endpunkt. `GET` liefert den berechtigungsgefilterten Katalog, `POST` führt genau ein darin beschriebenes Tool aus. KI-Assistenten erreichen dieselben Tools über MCP: [MCP und KI-Assistenten im Überblick](https://support.unitedsynergy.com/mcp/uebersicht/).

## Basis und Authentifizierung

- Basis-URL: die HTTPS-Adresse deiner SynCore-Instanz
- Endpunkt: `/api/app-tools`
- Authentifizierung: Header `X-API-KEY`
- Content-Type bei `POST`: `application/json`

## GET /api/app-tools

Liefert alle für den Actor-User sichtbaren Tools.

### Query-Parameter

| Parameter | Typ | Standard | Bedeutung |
| --- | --- | --- | --- |
| `includeStructure` | Boolean | `false` | Bei `1`, `true` oder `yes` zusätzlich App-Struktur, effektive Rechte und Laufzeitregeln liefern. |
| `stufe` | Text | keine | `name`, `beschreibung`, `schema` oder `typescript`, siehe [Katalog in Stufen](#katalog-in-stufen). Ohne Angabe kommt die volle Form wie bisher. |
| `app` | Text | alle | Nur Tools dieser Apps, mehrere durch Komma getrennt, zum Beispiel `crm,projektsyn`. |
| `suche` | Text | keine | Suchbegriffe durch Leerzeichen getrennt. Jeder Begriff muss in Name, App-Bezeichnung oder Beschreibung vorkommen. |

Empfohlener Aufruf:

```http
GET /api/app-tools?includeStructure=1 HTTP/1.1
Host: syncore.example.com
X-API-KEY: syn_...
Accept: application/json
```

### Katalog in Stufen

Bei vollen Rechten liefert der Katalog über 1.000 Tools, rund 700 KB. Für das Finden reicht meist weniger:

| Stufe | Inhalt je Tool | Größe des vollen Katalogs |
| --- | --- | --- |
| `name` | `name`, `module`, `sideEffect` | rund 80 KB |
| `beschreibung` | dazu `appId`, `label`, `description`, `confirmationRequired`, `dataClasses` | rund 270 KB |
| `schema` | alle Felder aus [Tool-Metadaten](#tool-metadaten) | rund 700 KB |
| `typescript` | die Tools als TypeScript-Deklaration, Antwort als Text statt JSON | rund 550 KB |

Mit Stufe enthält die Antwort zusätzlich `stufe` und `anzahl`. Sinnvoll ist ein Ablauf in zwei Schritten: erst `?stufe=name&suche=konto` zum Finden, dann `?stufe=schema&suche=crm.konto.list` für die Eingaben.

`?stufe=typescript&app=crm` liefert die Tools der App als Deklaration, die ein Programm oder ein KI-Agent direkt verwenden kann:

```ts
declare const syncore: {
  crm: {
    /** Liste/Suche: Konten (CRM) … */
    konto_list(input: CrmKontoListInput): Promise<SynCoreErgebnis<unknown>>;
  };
};
```

Die Typen beschreiben nur die Eingaben. Geprüft wird bei jedem `POST` weiter im Server: Schema, Rechte und Datenbereich.

Jede Antwort trägt einen `ETag`. Schickst du ihn beim nächsten Abruf im Header `If-None-Match` mit und hat sich nichts geändert, antwortet SynCore mit `304` ohne Inhalt. Eine unbekannte Stufe oder eine ungültige App-Kennung beantwortet SynCore mit `400`.

### Tool-Metadaten

| Feld | Bedeutung |
| --- | --- |
| `name` | Stabiler Name, der bei `POST` unverändert verwendet wird. |
| `module` / `appId` | Zugehörige SynCore-App und stabile App-ID. |
| `label` / `description` | Anzeigename und fachliche Beschreibung. |
| `inputSchema` | Zulässige Eingabe als JSON-Schema. |
| `outputSchema` | Beschreibung der Ausgabe, sofern für das Tool hinterlegt. |
| `requires` | Erforderliche fachliche Berechtigungen. |
| `dataClasses` | Betroffene Datenklassen. Tools für besonders geschützte Klasse-D-Daten werden nicht über diese Fläche angeboten. |
| `sideEffect` | Kennzeichnet, ob das Tool Daten liest oder einen Seiteneffekt auslöst. |
| `confirmationRequired` | Eine aufrufende Anwendung muss vor der Ausführung eine ausdrückliche Bestätigung einholen. |
| `dsgvoNote` | Datenschutzhinweis zum Umfang der verarbeiteten oder übertragenen Daten. |

> **Der Katalog ist die Vertragsgrundlage**
>
> Verwende keine fest eingebaute globale Tool-Liste. Apps, Rechte, Datenscopes und Tool-Schemas können sich je Mandant und Version unterscheiden. Maßgeblich ist immer die aktuelle GET-Antwort der Zielinstanz.

Hat dein Mandant externe Dienste angebunden, können deren Tools ebenfalls im Katalog stehen. `dsgvoNote` nennt dann, welche Daten an den Dienst gehen.

Alle Tools, die SynCore mitbringt, stehen mit Eingabefeldern und nötigen Rechten in der [Referenz nach App](https://support.unitedsynergy.com/api/referenz/). Welche davon du tatsächlich aufrufen darfst, zeigt dein Katalog.

## POST /api/app-tools

Führt ein Tool im Kontext des Mandanten und des Actor-Users aus.

### Request Body

```json
{
  "name": "textbausteine.list_templates",
  "input": {
    "typ": "PDF",
    "limit": 20
  }
}
```

| Feld | Pflicht | Bedeutung |
| --- | --- | --- |
| `name` | ja | Exakter Tool-Name aus dem aktuellen Katalog. |
| `input` | nein | JSON-Objekt entsprechend `inputSchema`; ohne Eingabe `{}` verwenden. |

Vor der Ausführung prüft SynCore den Tool-Namen, das Eingabeschema, die App-Aktivierung, alle benötigten Berechtigungen und den effektiven Datenscope.

### Erfolgreiche Antwort

```json
{
  "ok": true,
  "tool": "textbausteine.list_templates",
  "module": "textbausteine",
  "data": []
}
```

Je nach Tool können zusätzlich unter anderem `summary`, `entityType`, `entityId`, `needsSelection` oder `candidates` vorkommen. Beachte das gelieferte `outputSchema` und behandle unbekannte zusätzliche Felder tolerant.

Wenn `needsSelection: true` zurückkommt, darfst du nicht automatisch weiterschreiben. Zeige die Kandidaten an und lasse den Benutzer auswählen.

### Listen blättern

Jedes lesende Listen-Tool nimmt `limit` und `offset` an. Liefert ein Tool höchstens 200 Einträge auf einmal (Standard und Höchstwert, bei den Datenobjekt-Listen `…list` Standard 50), steht in der Antwort zusätzlich `seite`:

```json
{
  "ok": true,
  "tool": "textbausteine.list_documents",
  "data": [ … ],
  "seite": { "offset": 0, "limit": 200, "gesamt": 312, "weitere": true }
}
```

Bei `weitere: true` holst du die nächste Seite mit `offset` plus `limit`, hier `"offset": 200`. Ein `limit` über 200 beantwortet SynCore mit `400`. Einige Listen-Tools liefern statt einer Liste ein kleines Objekt, etwa die Stufen einer Pipeline oder die Freigaben eines Datensatzes. Dort gibt es kein `limit`, das Eingabeschema im Katalog zeigt es.

## Verbindlicher Ablauf bei Änderungen

1. Katalog und Struktur abrufen.
2. Zielentität über ein Lese- oder Such-Tool eindeutig bestimmen.
3. Eingabe gegen `inputSchema` aufbauen.
4. Bei `confirmationRequired: true` die konkrete Aktion bestätigen lassen.
5. Mutation ausführen.
6. Ergebnis mit einem Lese- oder Listen-Tool verifizieren.

Die Bestätigung ist eine Prozesspflicht der aufrufenden Anwendung. Es gibt dafür kein pauschales `confirmed`-Feld im Transportformat.

## Dateien an einen Datensatz hängen

Mit `files.upload` legst du eine Datei an einem Datensatz ab, zum Beispiel ein Angebot an einem Projekt oder ein Foto an einer Aufgabe. `files.list` zeigt danach, was dort hängt.

```json
{
  "name": "files.upload",
  "input": {
    "filename": "Angebot.pdf",
    "mimeType": "application/pdf",
    "contentBase64": "JVBERi0xLjcK...",
    "ownerType": "projektsyn.projekt",
    "ownerId": "prj_123"
  }
}
```

| Feld | Pflicht | Bedeutung |
| --- | --- | --- |
| `filename` | ja | Dateiname mit Endung, höchstens 255 Zeichen. |
| `mimeType` | ja | Dateityp, zum Beispiel `application/pdf` oder `image/png`. Er muss zum Inhalt passen. |
| `contentBase64` | ja | Dateiinhalt als Base64, auch als `data:`-URL. |
| `ownerType` | ja | Art des Datensatzes: `projektsyn.projekt`, `projektsyn.ticket`, `crm.konto`, `crm.kontakt`, `crm.potenzial`, `vertraege.vertrag`, `auftraege.auftrag`, `produkte.artikel`, `seminar.katalog` oder `seminar.veranstaltung`. |
| `ownerId` | ja | ID des Datensatzes aus dem passenden Lese-Tool. |
| `tags` | nein | Schlagworte. |
| `folderId` | nein | Ordner im Dateispeicher deines Mandanten. |

Es gelten dieselben Regeln wie beim Hochladen im Browser:

- Du brauchst das Recht, den Datensatz zu bearbeiten, und er muss in deinem Datenbereich liegen. Für `files.list` reicht das Leserecht.
- Ein Datensatz, den es in deinem Mandanten nicht gibt oder den du nicht sehen darfst, ergibt `404`.
- Erlaubt sind PDF, Word, Excel, PowerPoint, Bilder (PNG, JPEG, GIF, WebP, HEIC), Text, CSV, JSON, XML und ZIP. SynCore prüft den Inhalt gegen den angegebenen Typ, HTML und SVG werden abgelehnt.
- Eine vorhandene Datei wird nicht ersetzt, jeder Aufruf legt eine neue an.
- Die größte Datei bestimmt deine Instanz (Standard 100 MB). Base64 macht die Anfrage etwa ein Drittel größer als die Datei, plane große Dateien entsprechend ein oder lade sie im Browser hoch.

Personal-, Bewerber-, Bildungs- und Belegakten nimmt das Tool bewusst nicht an. Lade Dokumente dort über die jeweilige Seite in SynCore hoch.

## Große Dateien ohne Base64: Upload- und Download-Link

Base64 im Aufruf kostet Tokens: jedes Byte der Datei läuft durch das Sprachmodell, grob 400.000 Tokens je Megabyte. Von außen (MCP, API) nimmt `files.upload` deshalb nur kleine Dateien an (Standard 1 MB). Für alles, was als Datei vorliegt, gibt es den Link-Weg: das Werkzeug meldet die Datei an und liefert eine Adresse samt fertigem Befehl, die Bytes gehen direkt von der Platte zum Server.

1. `files.upload_link` mit Name, Typ und Datensatz aufrufen. Die Antwort enthält `url`, `expiresAt` und `befehle.bash` beziehungsweise `befehle.powershell`.
2. Den Befehl im Ordner der Datei ausführen, zum Beispiel:

```bash
curl -sS -f -T "foto.png" -H "Content-Type: image/png" "https://deine-instanz/api/files/direkt/<token>"
```

3. Die Antwort des PUT ist die angelegte Datei (`id`, `url`). Mit `files.list` prüfen.

Für den Weg zurück liefert `files.download_link` mit der `id` aus `files.list` eine Adresse für `GET`, zum Beispiel `curl -sS -f -o "foto.png" "<url>"`. Die Datei kommt als Anhang.

Regeln:

- Ein Upload-Link gilt 15 Minuten und genau einmal, ein Download-Link 10 Minuten und bis dahin mehrfach.
- Der Link ist an deinen Mandanten, deine Person, deinen API-Key und den Datensatz gebunden. Ein widerrufener Key macht den Link ungültig. Beim Abruf prüft SynCore das Recht am Datensatz noch einmal.
- Der `Content-Type` im Befehl muss zum angemeldeten Typ passen, sonst antwortet der Server mit `415`. Ohne `Content-Type` gilt der angemeldete Typ.
- Beim Empfang gelten dieselben Prüfungen wie beim Hochladen im Browser (Typ-Allowlist, Inhalt, Größe, Virenscan). Wird die Datei abgelehnt, bleibt der Link bis zum Ablauf für einen korrigierten Versuch offen.
- Je Person sind höchstens 20 offene Links gleichzeitig möglich.
- Das Protokoll enthält Name, Typ und Größe, nie den Inhalt.

Der Befehl braucht eine Shell. Claude Code, Cursor und Skripte können ihn ausführen, ein Chat-Client ohne Shell nicht; dort bleibt `files.upload` für kleine Dateien.

## HTTP-Statuscodes

| Status | Bedeutung |
| --- | --- |
| `200` | Katalog geliefert oder Tool erfolgreich ausgeführt. |
| `400` | Tool-Name fehlt, JSON ist ungültig oder `input` verletzt das Schema. |
| `401` | Session beziehungsweise API-Key fehlt oder ist ungültig. |
| `403` | Scope, Actor-User, App-Aktivierung oder fachliche Berechtigung fehlt. |
| `404` | Der angegebene Tool-Name existiert nicht, oder das Tool findet den angegebenen Datensatz nicht. |
| `413` | Die Datei ist größer, als die Instanz annimmt (`files.upload`, `/api/files/direkt/<token>`), oder der Base64-Aufruf von außen liegt über der kleinen Grenze (dann `files.upload_link` nehmen). |
| `410` | Der Direktlink ist abgelaufen oder schon benutzt (`/api/files/direkt/<token>`). |
| `415` | Der `Content-Type` des PUT passt nicht zum angemeldeten Typ (`/api/files/direkt/<token>`). |
| `422` | Das Tool wurde gefunden, konnte die fachliche Aktion aber nicht ausführen. |
| `429` | Zu viele Anfragen. Warte die Sekunden aus dem Header `Retry-After` ab. |
| `501` | Für ein registriertes Tool fehlt serverseitig ein Handler; bitte den Support informieren. |

## Fehlerantworten

Bei `400`, `401`, `403`, `404`, `413` und `501` steht die Ursache im Feld `message`:

```json
{
  "message": "Tool nicht gefunden: crm.konto_lsit"
}
```

Bei einem fachlichen Fehler liefert `422` stattdessen `ok`, `tool` und `error`:

```json
{
  "ok": false,
  "tool": "beispiel.tool",
  "error": "Fachliche Ursache"
}
```

`429` antwortet mit einem kurzen Klartext statt JSON und dem Header `Retry-After`. Welche Meldung was bedeutet, steht unter [Wenn eine API-Anfrage scheitert](https://support.unitedsynergy.com/api/fehlerbehebung/).

Wiederhole `400`, `403` oder `422` nicht blind. Korrigiere zuerst Eingabe, Rechte oder fachlichen Zustand.

## Anfragelimits

SynCore zählt Anfragen mit API-Key je Schlüssel, Methode und Endpunkt in einem Zeitfenster von einer Minute.

| Limit | Standardwert | Folge |
| --- | --- | --- |
| Anfragen je API-Key | 1.200 pro Minute, getrennt für `GET` und `POST` | `429 Zu viele Anfragen` bis zum Ende des Zeitfensters |

Jede Antwort trägt `X-RateLimit-Limit` (Limit im Zeitfenster) und `X-RateLimit-Remaining` (verbleibende Anfragen). Bei `429` nennt `Retry-After` die Wartezeit in Sekunden. Die Werte sind Standardwerte und können je Instanz abweichen.

> **Sauber mit Limits umgehen**
>
> Verteile Massenläufe über die Zeit, wiederhole nach `429` erst nach `Retry-After` und nur einmal. Bei `401` prüfst du zuerst den Schlüssel, statt die Anfrage in einer Schleife zu wiederholen.

## OpenAPI-Datei

Die Transport-API kannst du als [OpenAPI 3.1 herunterladen](https://support.unitedsynergy.com/openapi/syncore-app-tools.openapi.json) und in Postman, Bruno oder Insomnia importieren. Da die verfügbaren Tools dynamisch sind, ersetzt die OpenAPI-Datei nicht den Katalogabruf.

---

# API-Anfragen sicher testen

> Teste den App-Tool-Katalog und einzelne SynCore-Tools mit PowerShell, curl oder einer OpenAPI-Anwendung.

Quelle: https://support.unitedsynergy.com/api/anfragen-testen/

Teste Integrationen zuerst mit einem eigenen Testschlüssel und einem Actor-User mit begrenzten Rechten. Beginne immer mit einem lesenden Tool.

> **Kein API-Key im Hilfe-Center**
>
> Gib deinen echten API-Key niemals auf einer öffentlichen Webseite ein. Der Befehls-Generator unten verarbeitet nur URL, Tool-Name und JSON lokal im Browser. Er sendet nichts und verwendet im Ergebnis ausschließlich die Variable `SYNCORE_API_KEY`.

## 1. Schlüssel im Terminal setzen

PowerShell:

```powershell
$env:SYNCORE_API_KEY = 'syn_DEIN_SCHLUESSEL'
```

Bash:

```bash
export SYNCORE_API_KEY='syn_DEIN_SCHLUESSEL'
```

## 2. Katalog testen

PowerShell:

```powershell
$BaseUrl = 'https://syncore.example.com'
$Headers = @{ 'X-API-KEY' = $env:SYNCORE_API_KEY }
$Catalog = Invoke-RestMethod `
  -Method Get `
  -Uri "$BaseUrl/api/app-tools?includeStructure=1" `
  -Headers $Headers

$Catalog.tools | Select-Object name, module, sideEffect, confirmationRequired
```

Prüfe, ob nur die erwarteten Apps und Aktionen erscheinen. Ein zu großer Katalog deutet auf zu weit gefasste Rollen des Actor-Users hin.

## 3. Ausführbaren Befehl erzeugen

Übernimm einen Tool-Namen aus deinem aktuellen Katalog und baue die Eingabe nach dessen `inputSchema`.

*(Im Hilfe-Center steht hier ein Generator, der aus Basis-URL, Tool-Name und Eingabe einen PowerShell- und einen curl-Befehl baut: `POST /api/app-tools`, Header `X-API-KEY`, Body `{"name": "<tool>", "input": {…}}`.)*

## 4. Ergebnis bewerten

- HTTP `200` und `ok: true`: Transport, Schlüssel, Rechte und Tool-Ausführung waren erfolgreich.
- Leere Daten sind nicht automatisch ein Fehler; möglicherweise gibt es im Datenscope keine passenden Datensätze.
- `needsSelection: true`: Kandidaten anzeigen und eine Auswahl anfordern.
- Bei einer Mutation den Zielzustand anschließend mit einem Lese-Tool prüfen.
- HTTP `429`: die Sekunden aus `Retry-After` abwarten und die Anfrage dann einmal wiederholen.
- Fehler nach Statuscode behandeln und keine automatischen Endlosschleifen bauen. Die Meldungen und ihre Ursachen stehen unter [Wenn eine API-Anfrage scheitert](https://support.unitedsynergy.com/api/fehlerbehebung/).

## Mit OpenAPI-Tools testen

1. Lade die [SynCore App-Tools OpenAPI-Datei](https://support.unitedsynergy.com/openapi/syncore-app-tools.openapi.json) herunter.
2. Importiere sie in Postman, Bruno oder Insomnia.
3. Setze die Server-Variable `baseUrl` auf deine SynCore-Instanz.
4. Hinterlege `X-API-KEY` als geschütztes Secret der lokalen Umgebung.
5. Rufe zuerst `GET /api/app-tools?includeStructure=1` auf.
6. Kopiere einen sichtbaren Tool-Namen und dessen Eingabeschema in den `POST`-Request.

Die OpenAPI-Datei beschreibt den stabilen Transport. Welche fachlichen Tools verfügbar sind, bestimmt ausschließlich der aktuelle Katalog der Zielinstanz.

## Abnahmereihenfolge

Für einen nachvollziehbaren Integrationstest empfehlen wir:

1. Ungültiger Key ergibt `401`.
2. Gültiger Key liefert einen berechtigungsgefilterten Katalog.
3. Ein lesendes Tool liefert `ok: true`.
4. Ein absichtlich unzulässiges Eingabefeld beziehungsweise ein falscher Typ ergibt `400`.
5. Ein schreibendes Tool wird erst nach Bestätigung ausgeführt.
6. Der geänderte Zustand wird per Readback nachgewiesen.
7. Ein gesperrter Schlüssel wird unmittelbar mit `401` abgewiesen.

Dokumentiere dabei Instanz, Version, Zeitpunkt, Schlüsselpräfix, Tool-Name und Ergebnis, aber niemals den vollständigen API-Key oder personenbezogene Antwortdaten.

---

# Spezialanbindungen neben den App-Tools

> Welche festen Schnittstellen SynCore für Website-Formulare, Shops, Partner-Apps und die Einrichtung von Rollen anbietet und wie du einen Schlüssel dafür bekommst.

Quelle: https://support.unitedsynergy.com/api/spezialanbindungen/

Fast alles, was du per API mit SynCore machst, läuft über die [App-Tools](https://support.unitedsynergy.com/api/app-tools/). Für einige feste Aufgaben gibt es zusätzlich eigene Endpunkte, zum Beispiel für ein Anmeldeformular auf deiner Website oder für Bestellungen aus einem Shop. Jeder davon verlangt einen eigenen Scope.

## Was für alle Spezialanbindungen gilt

- Du authentifizierst dich mit dem Header `X-API-KEY`. Eine Anmeldung im Browser zählt hier nicht.
- Der Schlüssel bestimmt den Mandanten. Kein Feld in der Anfrage kann ihn ändern.
- Jeder Endpunkt prüft seinen eigenen Scope. Ein App-Tools-Schlüssel öffnet keine Spezialanbindung, und ein Schlüssel für eine Spezialanbindung öffnet keine App-Tools.
- Fehlt der Schlüssel oder ist er ungültig, antwortet SynCore mit `401`. Fehlt der Scope, kommt `403` mit der Meldung `API-Key fehlt Scope: …`.
- Pro Schlüssel sind 1.200 Anfragen pro Minute erlaubt. Endpunkte, die Mails auslösen, zählen strenger und pro IP-Adresse: 30 pro Minute für den Mailversand, 10 pro Minute für die Newsletter-Anmeldung. Darüber kommt `429` mit dem Header `Retry-After`.

> **Schlüssel bekommst du über United Synergy**
>
> In der Plattformadministration lassen sich nur App-Tools-Schlüssel erzeugen. Schlüssel für Spezialanbindungen stellt United Synergy aus, jeweils nur mit dem Scope, den die Anbindung braucht. Schreib uns über den [Support](https://support.unitedsynergy.com/support/), wofür du die Anbindung brauchst und welcher Benutzer als Actor-User dahinterstehen soll.

## Übersicht

| Anbindung | Endpunkt | Scope |
| --- | --- | --- |
| Newsletter-Anmeldung von deiner Website | `POST /api/newsletter/anmeldung` | `newsletter.anmeldung` |
| Kontakte aus Formularen ins CRM | `POST /api/crm/import` | `crm.import` |
| Seminarbuchung aus einem Shop | `POST /api/seminar/webhook/order` | `seminar:webhook` |
| Mails über das Postfach des Mandanten | `POST /api/mail/relay` | `mail.relay` |
| Rollen und Rechte einrichten | `POST /api/admin/roles`, `PUT /api/admin/roles/{slug}/permissions` | `iam:manage` |

## Newsletter-Anmeldung von deiner Website

Dein Formular schickt die Anmeldung an deinen eigenen Server, und der ruft SynCore mit dem Schlüssel auf. Der Schlüssel gehört nie in den Browser.

```json
{
  "email": "anna@example.com",
  "name": "Anna Beispiel",
  "company": "Beispiel GmbH",
  "quelle": "Website Fußzeile"
}
```

- Pflicht ist nur `email`. `name`, `company` und `quelle` sind freiwillig.
- SynCore verschickt eine Bestätigungsmail (Double-Opt-in). Pro Adresse geht höchstens eine Bestätigungsmail in 24 Stunden raus.
- Ist die Adresse noch nicht im CRM, legt SynCore Konto und Kontakt erst an, wenn die Person den Link in der Bestätigungsmail anklickt. Unbestätigte Adressen speichert SynCore nicht.
- Die Antwort ist immer `{ "ok": true }`, auch wenn die Adresse schon bekannt ist. So kann niemand über das Formular herausfinden, wer im CRM steht.
- Schickst du das Feld `website` mit einem Wert mit, behandelt SynCore die Anfrage als Bot und speichert nichts. Das Feld eignet sich als unsichtbare Falle in deinem Formular.

## Kontakte aus Formularen ins CRM

Der Endpunkt legt Konto und Kontakt an oder hängt einen Kontakt an ein bestehendes Konto. Er arbeitet in drei Schritten, die du über `mode` wählst:

| `mode` | Was passiert | Nötiges Recht des Actor-Users |
| --- | --- | --- |
| `preview` (Standard) | Sucht mögliche Dubletten. Schreibt nichts. | Konto lesen |
| `search` | Sucht Konten per Freitext im Feld `search`. | Konto lesen |
| `commit` | Legt Konto und Kontakt an oder hängt den Kontakt an `kontoId`. | Konto anlegen |

```json
{
  "mode": "commit",
  "konto": { "name": "Beispiel GmbH", "email": "info@beispiel.de" },
  "kontakt": { "vorname": "Anna", "nachname": "Beispiel", "email": "anna@beispiel.de" },
  "nachricht": "Bitte um Rückruf wegen einer Demo.",
  "source": "Kontaktformular",
  "tags": ["website-lead"]
}
```

- Prüf vor dem Anlegen mit `preview`, ob es das Konto schon gibt. Gibt es einen Treffer, schickst du beim `commit` dessen `kontoId` mit.
- `nachricht` landet als Eintrag im Verlauf des Kontos. Mit `tags` gibst du einem neu angelegten Konto bis zu fünf Schlagworte mit.
- Legt SynCore ein neues Konto an, antwortet es mit `201`, sonst mit `200`. Die Antwort enthält `kontoId`, `kontaktId` und `created`.

## Seminarbuchung aus einem Shop

Nach einer abgeschlossenen Bestellung meldet dein Shop die Buchung an SynCore.

```json
{
  "veranstaltungId": "<ID der Veranstaltung>",
  "teilnehmer": { "personId": "<ID der Person>", "organisationId": "<ID des Kontos>", "gebuehrNetto": 490 },
  "belegErzeugen": true
}
```

- Pflicht ist `veranstaltungId`. Die Buchung bekommt den Teilnehmerstatus „angemeldet“.
- Mit `belegErzeugen: true` legt SynCore gleich den Beleg zur Anmeldung an.
- Die Antwort enthält `buchungId` und, falls erzeugt, `belegId`.

## Mails über das Postfach des Mandanten

Für Partner-Apps, die im Namen des Mandanten Mails verschicken, zum Beispiel die Rettungsheft-App. SynCore verschickt über das Mailkonto, das im Mandanten eingerichtet ist.

```json
{
  "to": "empfaenger@example.com",
  "toName": "Max Beispiel",
  "subject": "Deine Anmeldung",
  "text": "Hallo Max, deine Anmeldung ist eingegangen."
}
```

- Pflicht sind `to`, `subject` und entweder `text` oder `html`.
- Den Absender bestimmt immer SynCore. Ein Absenderfeld gibt es nicht, damit der Endpunkt kein offenes Mail-Relay wird.
- Jeder Versand steht im Mail-Protokoll und im Audit-Log.

## Rollen und Rechte einrichten

Für Partner, die einen neuen Mandanten automatisch einrichten. Mit `POST /api/admin/roles` legst du eine Rolle an (`label` ist Pflicht, `slug` und `description` sind freiwillig). Mit `PUT /api/admin/roles/{slug}/permissions` setzt du ihre Rechte:

- `{ "seed": "defaults" }` übernimmt die Standardrechte der Apps.
- `{ "grants": [{ "permissionKey": "…", "scope": "…" }] }` setzt die Rechte ausdrücklich.

Administratorrollen und Administratorrechte lassen sich über diesen Weg nicht ändern.

## Anbindungen, die United Synergy einrichtet

- **Rettungsheft-App:** Nachweise, Stundenplan, Anwesenheit per QR-Code und Kurse laufen über eigene Endpunkte. United Synergy richtet sie beim Einrichten der App ein, du musst dafür nichts programmieren.
- **Externe Lern- und Praxisplattformen:** Rückmeldungen von Lernergebnissen und Praxisdurchgängen richtet United Synergy mit dem jeweiligen Anbieter ein.
- **Betrieb der Plattform:** Schnittstellen für Updates, Lizenzen und Sicherheitsmeldungen nutzt nur United Synergy. Sie stehen deshalb nicht in dieser Hilfe.

> **Wenn eine Spezialanbindung scheitert**
>
> Prüf zuerst Scope und Actor-User des Schlüssels: `403` mit `API-Key fehlt Scope` heißt, dass der Schlüssel für einen anderen Zweck ausgestellt ist. Weitere Meldungen erklärt [Wenn eine API-Anfrage scheitert](https://support.unitedsynergy.com/api/fehlerbehebung/).

---

# Wenn eine API-Anfrage scheitert

> Statuscode und Meldung einordnen und die Ursache bei Schlüssel, Rechten, Eingabe oder Limit finden.

Quelle: https://support.unitedsynergy.com/api/fehlerbehebung/

Jede abgewiesene Anfrage nennt einen Statuscode und eine Meldung. Bei den meisten Fehlern steht die Meldung im Feld `message`, bei `422` im Feld `error`. Die Tabellen zeigen, womit die Meldung beginnt, was dahintersteckt und was du tun kannst.

## 401: Der Schlüssel wird nicht akzeptiert

| Meldung beginnt mit | Ursache | Lösung |
| --- | --- | --- |
| `Nicht eingeloggt` | Der Header `X-API-KEY` fehlt. | Header mitsenden und Schreibweise prüfen. |
| `Ungueltiger oder fehlender API-Key` | Der Schlüssel ist falsch kopiert, unbekannt oder wurde widerrufen. | Schlüssel neu aus dem Secret Store einsetzen. Wurde er widerrufen, einen neuen beantragen. |

## 403: Der Schlüssel ist gültig, aber etwas fehlt

| Meldung beginnt mit | Ursache | Lösung |
| --- | --- | --- |
| `API-Key fehlt Scope: app-tools` | Der Schlüssel wurde für eine andere Anbindung ausgegeben. | Einen App-Tools-Key beantragen, siehe [API-Keys](https://support.unitedsynergy.com/api/api-keys/). |
| `API-Key hat keinen Actor-User` | Dem Schlüssel ist kein technischer Benutzer zugeordnet. | Neuen Schlüssel mit Actor-User ausgeben lassen. |
| `Actor-User des API-Keys existiert nicht mehr` | Der technische Benutzer wurde gelöscht. | Benutzer neu anlegen und dafür einen neuen Schlüssel ausgeben lassen. |
| `Modul … ist nicht aktiv` | Die App ist im Mandanten nicht aktiviert. | App aktivieren lassen oder ein Tool einer aktiven App nutzen. |
| `Permission fehlt: …` | Der Rolle des Actor-Users fehlt das genannte Recht, zum Beispiel `update:Konto`. | Das Recht in der Rolle ergänzen, aber nur so weit wie nötig. |

## 400, 404, 422 und 501: Anfrage oder Tool passt nicht

| Status und Meldung | Ursache | Lösung |
| --- | --- | --- |
| `400 Tool-Name fehlt` | Im Body fehlt `name`, oder der Body ist kein gültiges JSON. | JSON-Body mit `name` senden und `Content-Type: application/json` setzen. |
| `400` mit anderer Meldung | Die Eingabe verletzt das `inputSchema`. Mehrere Verstöße stehen mit Semikolon getrennt in einer Meldung. | Eingabe nach dem Schema aus dem aktuellen Katalog korrigieren. |
| `404 Tool nicht gefunden: …` | Der Tool-Name ist falsch geschrieben oder existiert in dieser Version nicht. | Namen exakt aus dem aktuellen Katalog übernehmen. |
| `422` mit `ok: false` | Das Tool lief, konnte die fachliche Aktion aber nicht ausführen, zum Beispiel weil ein Datensatz fehlt. | Zustand mit einem Lese-Tool prüfen, nicht blind wiederholen. |
| `422` mit `Datenbankcode …` | Die Datenbank hat die Änderung abgelehnt, etwa `23505` für einen Wert, der eindeutig sein muss und schon existiert, oder `23503` für einen fehlenden verknüpften Datensatz. | Eingabe anhand des Satzes vor dem Code korrigieren. Interna wie Tabellennamen nennt die Antwort bewusst nicht. |
| `501 Kein Handler registriert` | Das Tool ist bekannt, aber auf dem Server fehlt die Umsetzung. | Support mit Tool-Name und Zeitpunkt informieren. |

## 429: Zu viele Anfragen

| Meldung | Ursache | Lösung |
| --- | --- | --- |
| `Zu viele Anfragen` | Das Limit für diesen Schlüssel ist im aktuellen Zeitfenster erreicht. | Die Sekunden aus `Retry-After` abwarten, Last über die Zeit verteilen. |

Die Limits stehen in der [Referenz unter Anfragelimits](https://support.unitedsynergy.com/api/app-tools/#anfragelimits).

## Der Katalog ist leer oder ein Tool fehlt

Ein Tool, das in der [Referenz nach App](https://support.unitedsynergy.com/api/referenz/) steht, fehlt in deinem Katalog, wenn die App im Mandanten nicht aktiv ist oder dem Actor-User das Recht fehlt. Ruf den Katalog mit `includeStructure=1` ab: `structure` zeigt die sichtbaren Apps und die effektiven Rechte des Actor-Users.

> **Was der Support braucht**
>
> Nenne Instanz, Zeitpunkt, Statuscode, Meldung, Tool-Name und das Präfix des Schlüssels. Schick nie den vollständigen API-Key und keine personenbezogenen Antwortdaten.

---

# MCP und KI-Assistenten im Überblick

> Was MCP ist, welche drei Arbeitsweisen SynCore anbietet und in welcher Reihenfolge du einen Assistenten anschließt.

Quelle: https://support.unitedsynergy.com/mcp/uebersicht/

MCP (Model Context Protocol) ist der Standard, über den KI-Assistenten wie Claude, Cursor oder VS Code Werkzeuge nutzen. SynCore bietet seine App-Tools über MCP an: Dein Assistent kann damit Konten suchen, Aufgaben anlegen oder Auswertungen ziehen, mit genau den Rechten des technischen Benutzers hinter dem API-Key. Jeder Aufruf steht im Audit-Log.

> **Bevor du beginnst**
>
> Du brauchst einen API-Key mit dem Scope `app-tools` und einem Actor-User: [API-Keys, Scopes und Berechtigungen](https://support.unitedsynergy.com/api/api-keys/). Nimm für den Assistenten einen eigenen technischen Benutzer mit knappen Rechten, nie dein persönliches Konto.

## Drei Arbeitsweisen

- **Klassisch:** Dein Assistent sieht jedes Werkzeug einzeln, bei vollen Rechten über 1.000, und ruft je Schritt eines auf. Jedes Ergebnis landet in seinem Kontext.
- **Such-Modus:** Dein Assistent sieht zwei Werkzeuge, eines zum Suchen und eines zum Ausführen. Er findet die passenden Werkzeuge per Suche, ruft sie aber weiter einzeln auf.
- **Code-Mode:** Dein Assistent schreibt ein kurzes Programm, das viele Werkzeuge nacheinander aufruft, die Daten filtert und zählt und nur das Ergebnis zurückgibt. Er sieht fünf Werkzeuge: suchen, Programm ausführen, Stand abfragen, Skills lesen und vorschlagen.

| Arbeitsweise | Passt, wenn | Einschalten |
| --- | --- | --- |
| Klassisch | dein Client Werkzeuge selbst sucht (etwa Claude Code) und Aufgaben wenige Schritte haben | Standard |
| Such-Modus | dein Client alle Werkzeugbeschreibungen in den Kontext lädt (etwa Claude Desktop, Cursor, VS Code) | `?modus=suche` an der Adresse |
| Code-Mode | eine Frage viele Datensätze berührt oder ein Ablauf immer wieder gleich läuft | Schalter **Code-Mode** am API-Key |

Der Code-Mode spart am meisten. In unserer Messung mit der Frage „offene und überfällige Aufgaben je Projekt“ über zwölf Projekte brauchte der klassische Weg 13 Aufrufe und brachte rund 414.000 Zeichen in den Kontext des Assistenten. Im Code-Mode war es ein Aufruf mit rund 1.200 Zeichen, bei gleichem Ergebnis.

Rechte, Datenbereich und Audit-Log sind in allen drei Arbeitsweisen gleich. Keine Arbeitsweise kann mehr als der Actor-User in der Oberfläche.

## In dieser Reihenfolge vorgehen

1. Technischen Benutzer mit knappen Rechten anlegen und einen API-Key ausgeben lassen: [API-Keys, Scopes und Berechtigungen](https://support.unitedsynergy.com/api/api-keys/)
2. Den Assistenten eintragen: [Assistenten mit SynCore verbinden](https://support.unitedsynergy.com/mcp/verbinden/)
3. Festlegen, welche Werkzeuge er sieht, zum Ausprobieren nur lesende: [Welche Werkzeuge dein Assistent sieht](https://support.unitedsynergy.com/mcp/werkzeuge/)
4. Für viele Schritte auf einmal den Code-Mode nutzen: [So arbeitet der Code-Mode](https://support.unitedsynergy.com/mcp/code-mode/) und [Code-Mode einschalten und absichern](https://support.unitedsynergy.com/mcp/code-mode-einschalten/)

Klappt etwas nicht, stehen die häufigsten Meldungen unter [Wenn der Assistent nicht verbindet oder abgewiesen wird](https://support.unitedsynergy.com/mcp/fehlerbehebung/).

## Die Dokumentation für den Assistenten

Damit dein Assistent diese Anleitungen kennt, gib ihm die Adresse `https://support.unitedsynergy.com/mcp/llms.txt`. Darin stehen alle Artikel dieser Rubrik als Klartext. Soll er eine eigene Anbindung bauen, nimm `https://support.unitedsynergy.com/api/llms.txt`: Dort stehen zusätzlich die Artikel zur API und die Referenz aller App-Tools. Jede Seite gibt es auch einzeln, wenn du `llms.txt` an ihre Adresse anhängst, zum Beispiel `/mcp/code-mode/llms.txt`.

---

# Assistenten mit SynCore verbinden

> Claude Code, Cursor, VS Code oder Claude Desktop per MCP mit deiner SynCore-Instanz verbinden.

Quelle: https://support.unitedsynergy.com/mcp/verbinden/

Dein Assistent spricht SynCore über eine Adresse und einen API-Key an. Wie du beides einträgst, hängt vom Client ab.

> **Bevor du beginnst**
>
> Du brauchst einen API-Key mit dem Scope `app-tools` und einem Actor-User: [API-Keys, Scopes und Berechtigungen](https://support.unitedsynergy.com/api/api-keys/). Wer den Key in der Admin-Konsole erzeugt, sieht die Adresse der Instanz direkt unter dem Formular.

## Adresse und Schlüssel

- **Adresse:** `https://<deine-instanz>/api/mcp`
- **Schlüssel:** im Header `X-API-KEY`. Schreib ihn nie in die Adresse.
- **Übertragung:** Streamable HTTP. SynCore antwortet mit JSON und braucht keine Sitzung.
- **Protokollversionen:** 2026-07-28 sowie 2025-11-25, 2025-06-18, 2025-03-26 und 2024-11-05. Dein Client wählt selbst.

Ob dein Assistent Werkzeuge einzeln aufruft oder Programme schickt, legt der Key fest, nicht die Adresse: [Code-Mode einschalten und absichern](https://support.unitedsynergy.com/mcp/code-mode-einschalten/).

## Claude Code

Im Terminal:

```bash
claude mcp add --transport http syncore https://deine-instanz.example/api/mcp --header "X-API-KEY: syn_…"
```

Der Schlüssel steht danach in deiner lokalen Claude-Code-Konfiguration. Für ein gemeinsames Projekt legst du stattdessen eine `.mcp.json` an und holst den Schlüssel aus einer Umgebungsvariable:

```json
{
  "mcpServers": {
    "syncore": {
      "type": "http",
      "url": "https://deine-instanz.example/api/mcp",
      "headers": { "X-API-KEY": "${SYNCORE_API_KEY}" }
    }
  }
}
```

Nimm einen eigenen Variablennamen wie `SYNCORE_API_KEY`. Ist die Variable nicht gesetzt, schickt Claude Code den Platzhalter unverändert und SynCore antwortet mit `401`.

## Cursor

In `~/.cursor/mcp.json` (für dich) oder `.cursor/mcp.json` (im Projekt):

```json
{
  "mcpServers": {
    "syncore": {
      "url": "https://deine-instanz.example/api/mcp",
      "headers": { "X-API-KEY": "${env:SYNCORE_API_KEY}" }
    }
  }
}
```

## VS Code

In `.vscode/mcp.json`. VS Code fragt beim ersten Start nach dem Schlüssel und speichert ihn geschützt:

```json
{
  "inputs": [
    { "type": "promptString", "id": "syncore-key", "description": "SynCore API-Key", "password": true }
  ],
  "servers": {
    "syncore": {
      "type": "http",
      "url": "https://deine-instanz.example/api/mcp",
      "headers": { "X-API-KEY": "${input:syncore-key}" }
    }
  }
}
```

## Claude Desktop

Claude Desktop verbindet sich über das Hilfsprogramm `mcp-remote` (braucht Node.js 18 oder neuer). Trag in `claude_desktop_config.json` ein:

```json
{
  "mcpServers": {
    "syncore": {
      "command": "npx",
      "args": ["mcp-remote", "https://deine-instanz.example/api/mcp", "--header", "X-API-KEY:${SYNCORE_API_KEY}"],
      "env": { "SYNCORE_API_KEY": "syn_…" }
    }
  }
}
```

Schreib nach `X-API-KEY:` kein Leerzeichen, unter Windows bricht der Aufruf sonst ab. Der Schlüssel steht in dieser Datei im Klartext, schütz sie wie ein Passwort.

> **Connectoren in claude.ai und ChatGPT**
>
> Die Connector-Einrichtung in claude.ai und in ChatGPT verlangt eine Anmeldung per OAuth. Die bietet SynCore noch nicht an. Einzelne Organisationen können in claude.ai bereits eigene Request-Header eintragen (Beta), dann funktioniert es dort mit `X-API-KEY`. Für alle anderen gelten vorerst die Wege oben.

## Sicherheit

- Es gelten dieselben Prüfungen wie bei der [App-Tools-API](https://support.unitedsynergy.com/api/app-tools/): Schlüssel, Scope, Actor-User, Rechte, Datenbereich, Eingabeschema und Audit-Log. Details stehen unter [Sicherheit der API](https://support.unitedsynergy.com/api/sicherheit/).
- SynCore nimmt den Schlüssel nur im Header `X-API-KEY` an, keine Anmeldung aus dem Browser und kein Cookie.
- Anfragen aus fremden Webseiten (Header `Origin`) lehnt SynCore mit `403` ab.
- Zum Ausprobieren eignet sich `?nur=lesen` an der Adresse. So kann der Assistent nichts verändern, auch wenn der Actor-User es dürfte.

> **Ergebnis**
>
> Dein Assistent zeigt SynCore mit seinen Werkzeugen an. Frag ihn zum Beispiel nach den zuletzt angelegten Konten. Der Aufruf steht danach im Audit-Log, als Quelle ist „mcp“ vermerkt.

---

# Welche Werkzeuge dein Assistent sieht

> Wie Rechte und Parameter an der Adresse bestimmen, welche SynCore-Werkzeuge dein Assistent sieht, und wann der Such-Modus hilft.

Quelle: https://support.unitedsynergy.com/mcp/werkzeuge/

Dein Assistent sieht nie mehr als der Actor-User hinter dem API-Key. Mit Parametern an der Adresse engst du die Auswahl zusätzlich ein. Weniger Werkzeuge helfen dem Assistenten, manche Clients arbeiten nur mit einer begrenzten Zahl zuverlässig.

## Was die Rechte festlegen

- Die Namen entsprechen der [Referenz nach App](https://support.unitedsynergy.com/api/referenz/), nur mit Unterstrich statt Punkt: aus `crm.konto.list` wird `crm_konto_list`.
- Dein Assistent sieht nur Werkzeuge der aktivierten Apps, für die der Actor-User Rechte hat. Werkzeuge für Daten der Datenklasse D fehlen.
- Werkzeuge, die Daten anlegen, ändern oder löschen, sind entsprechend gekennzeichnet. Clients wie Claude Code fragen vor solchen Aufrufen nach, solange du sie nicht dauerhaft freigibst.
- Werkzeuge, die löschen, gibt es über den Key nur, wenn an ihm **Löschen erlaubt** an ist: [Code-Mode einschalten und absichern](https://support.unitedsynergy.com/mcp/code-mode-einschalten/).

## Auswahl an der Adresse einengen

| Parameter | Wirkung | Beispiel |
| --- | --- | --- |
| `apps` | nur die Werkzeuge dieser Apps (App-Kennungen aus der Referenz) | `?apps=crm,auftraege` |
| `nur=lesen` | nur Werkzeuge, die nichts verändern | `?nur=lesen` |
| `wertelisten` | Wertelisten: `aus`, `lesen` (Standard) oder `alle` | `?wertelisten=alle` |
| `modus=suche` | dein Assistent sieht nur zwei Werkzeuge: `search_tools` zum Suchen und `call_tool` zum Ausführen | `?modus=suche` |

Die Parameter lassen sich kombinieren, zum Beispiel `https://deine-instanz.example/api/mcp?apps=crm&nur=lesen`. Sie können die Rechte nur einschränken, nie erweitern: Was der Actor-User nicht darf, bleibt gesperrt. Bei einem Key im Code-Mode gelten `apps` und `nur=lesen` genauso, `modus=suche` hat dort keine Wirkung.

## Viele Werkzeuge: der Such-Modus

Ohne Einschränkung zeigt SynCore deinem Assistenten jedes Werkzeug einzeln, bei vollen Rechten über 1.000. Clients ohne eigene Werkzeugsuche (etwa Claude Desktop, Cursor, VS Code) laden dann alle Beschreibungen in ihren Kontext, das sind rund 90.000 Token, bevor du die erste Frage stellst.

Mit `?modus=suche` sieht dein Assistent stattdessen nur zwei Werkzeuge, zusammen rund 450 Token:

1. `search_tools` sucht Werkzeuge nach Begriffen, zum Beispiel „konto list“ oder „aufgabe anlegen“, auf Wunsch nur in einer App. Mit `stufe` bestimmt der Assistent, wie viel er je Treffer bekommt: nur den Namen, die Beschreibung (Standard), das Eingabeschema oder eine TypeScript-Deklaration.
2. `call_tool` führt ein gefundenes Werkzeug aus, mit dem Namen aus der Suche und den Eingaben nach dessen Schema.

Die übrigen Parameter gelten auch im Such-Modus. `?modus=suche&nur=lesen` findet und startet also nur lesende Werkzeuge. Rechte, Datenbereich und Audit-Log bleiben dieselben wie beim Einzelaufruf.

> **Ergebnis**
>
> Der Such-Modus spart Kontext, aber jeder Schritt bleibt ein eigener Aufruf. Berührt eine Frage viele Datensätze, ist der [Code-Mode](https://support.unitedsynergy.com/mcp/code-mode/) sparsamer.

---

# So arbeitet der Code-Mode

> Wie dein Assistent im Code-Mode Programme schreibt, welche Werkzeuge und Grenzen es gibt und wie er Skills nutzt.

Quelle: https://support.unitedsynergy.com/mcp/code-mode/

Im Code-Mode ruft dein Assistent die Werkzeuge nicht einzeln auf. Er schreibt ein kurzes Programm in TypeScript, das die Werkzeuge nacheinander aufruft, die Daten filtert und zählt und nur das Ergebnis zurückgibt. Die Zwischenstände landen nicht in seinem Kontext. Das spart viele Token, wenn eine Frage Dutzende Datensätze berührt.

> **Bevor du beginnst**
>
> Der API-Key muss im Code-Mode stehen, die Code-Ausführung muss auf deiner Instanz eingerichtet sein, und der Actor-User braucht das Recht „Programme über einen API-Schlüssel ausführen“. Wie du das einrichtest: [Code-Mode einschalten und absichern](https://support.unitedsynergy.com/mcp/code-mode-einschalten/).

## Die fünf Werkzeuge

Ein Key im Code-Mode zeigt dem Assistenten nur diese Werkzeuge:

- `search_tools` sucht Werkzeuge nach Begriffen, auf Wunsch nur in einer App. Mit `stufe` „typescript“ bekommt der Assistent die Deklaration als `syncore.<app>.<werkzeug>(input)`.
- `code_ausfuehren` führt ein Programm aus (`programm` und `werkzeuge`) oder startet einen Skill (`skill` und `eingabe`).
- `lauf_status` zeigt den Stand eines Laufs: läuft, fertig mit Ergebnis, abgebrochen, oder mit Freigabe am Key: wartet, abgelehnt, verfallen.
- `skills_lesen` zeigt die Skills, die die Verbindung starten kann, je App eine Übersicht oder einen Skill im Ganzen.
- `skill_vorschlagen` schlägt das Programm eines fertigen Laufs als Skill vor. Mit `?nur=lesen` fehlt dieses Werkzeug.

## So läuft ein Programm ab

1. Der Assistent sucht mit `search_tools` die passenden Werkzeuge, zum Beispiel „projekt list“ und „ticket list“, mit `stufe` „typescript“.
2. Er schreibt den Rumpf einer async-Funktion und schickt ihn mit `code_ausfuehren`. In `werkzeuge` nennt er die Namen aus der Suche mit Punkt (`projektsyn.projekt.list`), im Programm ruft er sie mit Unterstrich auf (`syncore.projektsyn.projekt_list`).
3. SynCore startet das Programm in einer eigenen Sandbox. Jeder Werkzeugaufruf kommt zurück zu SynCore und läuft dort mit den Rechten des Actor-Users, wie ein Einzelaufruf.
4. Mit `return` gibt das Programm das Ergebnis zurück. Die Antwort nennt den Lauf (`prl_…`), den Stand liefert bei Bedarf `lauf_status`.

So sieht ein Programm aus, das offene Aufgaben je Projekt zählt:

```ts
const projekte = await syncore.projektsyn.projekt_list({ limit: 50 });
const ergebnis = [];
for (const p of projekte.data) {
  const aufgaben = await syncore.projektsyn.ticket_list({ filters: { projektId: p.id }, limit: 200 });
  ergebnis.push({ projekt: p.name, aufgaben: aufgaben.data.length });
}
return ergebnis;
```

Dazu `werkzeuge: ["projektsyn.projekt.list", "projektsyn.ticket.list"]`. Zurück kommt nur die kurze Liste, nicht die einzelnen Aufgaben.

## Was ein Programm darf

- **Nur die genannten Werkzeuge.** Ein Werkzeug, das nicht in `werkzeuge` steht, gibt es im Programm nicht.
- **Kein Netz, keine Dateien.** Bereit stehen nur `syncore` und `console`.
- **Rechte wie der klassische Weg.** Lesen, Anlegen und Ändern laufen sofort, Löschen nur, wenn am Key **Löschen erlaubt** an ist. Ist am Key unter **Programme freigeben** eine Person eingetragen, laufen Schreibaufrufe zuerst als Vorschau und erst nach ihrer Freigabe: [Programme von Agenten freigeben](https://support.unitedsynergy.com/workflows/programme/).
- **Jeder Aufruf im Audit-Log.** Als Quelle ist „code“ vermerkt, dazu der Lauf. Die Läufe selbst stehen in der App **Automationen** auf der Seite **Programme**.

## Grenzen

| Grenze | Wert |
| --- | --- |
| Laufzeit je Programm | 60 Sekunden |
| Rechenzeit je Programm (Warten auf Werkzeuge zählt nicht) | 15 Sekunden |
| Werkzeugaufrufe je Programm | 200 |
| Werkzeuge je Programm | 50 |
| Länge des Programms | 100.000 Zeichen |
| Ergebnis an den Assistenten | gekürzt auf rund 6.000 Token |
| Listen je Aufruf | höchstens 200 Einträge, danach mit `offset` weiterblättern |
| Gleichzeitige Läufe | 2 je Mandant |
| Offene Läufe | 20 je Mandant, 5 je Key |

Ein Programm, das eine Grenze überschreitet, bricht ab. Der Lauf steht dann auf **Abgebrochen** mit dem Grund.

## Skills: bewährte Programme wiederverwenden

Ein **Skill** ist ein Programm mit Beschreibung und Eingabe, das dein Assistent starten kann, statt es neu zu schreiben. Vier liefert SynCore mit: **Aufgaben anlegen und Zeiten buchen**, **Rechnung aus Zeiten**, **Berichte ziehen** und **CRM-Import mit Abgleich**.

1. `skills_lesen` ohne Angabe zeigt alle Skills, die die Verbindung starten kann. Mit `{ "app": "crm" }` kommt die Übersicht einer App (Werkzeuge, Lesen und Schreiben, typische Abläufe), mit `{ "skill": "crm_import_abgleich" }` ein Skill mit Eingabe-Schema und Programm.
2. Gestartet wird ein Skill mit `code_ausfuehren { "skill": "…", "eingabe": { … } }`. Die Eingabe prüft SynCore gegen das Schema des Skills.
3. Lief ein eigenes Programm gut, schlägt der Assistent es mit `skill_vorschlagen` als Skill vor. Gespeichert wird nur ein Vorschlag; übernehmen kann ihn nur ein Mensch: [Skills übernehmen](https://support.unitedsynergy.com/workflows/programme/).

> **Ergebnis**
>
> Ein Skill schreibt wie jedes Programm: sofort mit den Rechten des Actor-Users oder, wenn am Key eine Person eingetragen ist, erst nach ihrer Freigabe.

---

# Code-Mode einschalten und absichern

> Code-Mode, Freigabe und Löschen am API-Key einstellen und die Rechte für Programme vergeben.

Quelle: https://support.unitedsynergy.com/mcp/code-mode-einschalten/

Ob ein Assistent Programme schickt oder Werkzeuge einzeln aufruft, entscheidet sein API-Key. Ab Werk ist jeder Key klassisch. Den Code-Mode schaltet ein Plattform-Admin je Key ein, zusammen mit zwei Schaltern, die festlegen, wie weit der Assistent schreiben darf.

> **Bevor du beginnst**
>
> Die Code-Ausführung muss auf deiner Instanz eingerichtet sein. Ist sie es nicht, richtet United Synergy sie zuerst auf dem Server ein. Code-Mode, Freigabe und Löschen gibt es nur bei Keys, die als Benutzer handeln (Actor-User).

## Code-Mode am Key einschalten

1. Öffne **Admin-Konsole › Zugriff › API Keys** und wähle über der Tabelle den Mandanten.
2. Klicke auf die Zeile des Keys (oder **⋯** und **Bearbeiten**). Der Dialog **Key bearbeiten** öffnet sich. Beim Erzeugen eines neuen Keys über **Key erzeugen** stehen dieselben Schalter gleich im Formular.
3. Schalte **Code-Mode** ein.
4. Wähle bei **Programme freigeben**, ob Programme sofort schreiben (**Niemand, Programme schreiben sofort**) oder ob eine Person jeden Schreibaufruf vorher freigibt.
5. Lass **Löschen erlaubt** aus, wenn der Assistent nichts löschen soll. Schaltest du es ein, legst du die **Grenze je Stunde** fest.
6. Klicke **Speichern**.

> **Ergebnis**
>
> Die Änderung gilt sofort und steht im Protokoll mit den geänderten Feldern. Schaltest du den Code-Mode aus, bricht auch ein laufendes Programm beim nächsten Werkzeugaufruf ab.

## Was die Schalter bewirken

| Schalter | Aus | An |
| --- | --- | --- |
| **Code-Mode** | klassischer MCP, jedes Werkzeug einzeln; Programme starten nicht | nur Programme in der Sandbox; einzelne Aufrufe über MCP und `/api/app-tools` weist SynCore ab |
| **Programme freigeben** | **Niemand**: Programme lesen, legen an und ändern sofort | eine Person: Schreibaufrufe laufen erst als Vorschau, nur diese Person bekommt eine Aufgabe und gibt frei oder lehnt ab |
| **Löschen erlaubt** | Werkzeuge, die löschen, sind über den Key nicht nutzbar, weder einzeln noch in Programmen | löschen erlaubt, soweit die Rollen des Actor-Users es erlauben, bis zur **Grenze je Stunde** |

Liegt der Key über der Grenze je Stunde, sperrt SynCore das Löschen über diesen Key, bis ein Plattform-Admin es mit **⋯** und **Löschen freigeben** wieder freigibt. Dazu kommt ein Alarm.

Der Actor-User des Keys kann seine eigenen Programme nie freigeben. Wie die Freigabe im Alltag abläuft: [Programme von Agenten freigeben](https://support.unitedsynergy.com/workflows/programme/).

## Rechte für Programme

Unter **Admin › Berechtigungen** in der App **Automationen**:

| Recht | Wer es braucht |
| --- | --- |
| Programme über einen API-Schlüssel ausführen | die Rolle des Actor-Users, sonst startet kein Programm |
| Schreibaufrufe eines Programms freigeben oder ablehnen | die Person, die am Key unter **Programme freigeben** steht |
| Seite Programme sehen, dazu Datenobjekt **Programm** lesen | alle, die Läufe ansehen sollen |

Ab Werk hat nur die Admin-Rolle des Mandanten diese Rechte. Gib das Recht zum Ausführen nur technischen Benutzern mit eng geschnittener Rolle. Ist die App **Automationen** im Mandanten nicht aktiv, starten keine Programme, auch wenn Key und Rechte stimmen.

## So sicherst du den Assistenten ab

- **Eigener technischer Benutzer** je Assistent, mit einer Rolle, die nur die nötigen Apps und Datenbereiche enthält.
- **Zum Ausprobieren** `?nur=lesen` an die Adresse hängen. Dann laufen auch im Code-Mode nur lesende Werkzeuge.
- **Mit Freigabe**, wenn der Assistent fremde Inhalte liest, etwa Mails oder Dokumente, und ein Mensch jeden Schreibvorgang sehen soll.
- **Löschen aus**, solange du keinen Grund hast, es einzuschalten.
- **Ablaufdatum** am Key setzen und den Key über **⋯** und **Rotieren** erneuern, wenn er in falsche Hände geraten sein könnte: [API-Keys, Scopes und Berechtigungen](https://support.unitedsynergy.com/api/api-keys/).

> **Wenn es nicht klappt**
>
> Mit Code-Mode funktionieren Befehle und Anleitungen deines Assistenten nicht mehr, die SynCore-Werkzeuge einzeln aufrufen. Brauchst du beides, gib dem Assistenten zwei Keys: einen klassischen und einen im Code-Mode.

---

# Wenn der Assistent nicht verbindet oder abgewiesen wird

> Die häufigsten Meldungen bei MCP und im Code-Mode, ihre Ursache und was du tust.

Quelle: https://support.unitedsynergy.com/mcp/fehlerbehebung/

Die meisten Fehler liegen am Key, an der Adresse oder an den Rechten des Actor-Users. Die Meldung sagt meist schon, was fehlt.

## Verbindung und Key

| Antwort | Ursache | Lösung |
| --- | --- | --- |
| `401` mit `API-Key fehlt` | Der Header `X-API-KEY` kommt nicht an. | Konfiguration prüfen, bei Umgebungsvariablen: ist sie gesetzt? |
| `401` mit `Ungueltiger oder fehlender API-Key` | Schlüssel falsch, gekürzt oder widerrufen, oder der Mandant ist nicht mehr aktiv. | Schlüssel neu eintragen oder einen neuen ausgeben lassen. |
| `401` mit `API-Schlüssel abgelaufen` | Das Ablaufdatum ist erreicht, oder nach einer Rotation ist die Übergangsfrist des alten Schlüssels vorbei. | Den neuen Schlüssel eintragen oder einen neuen ausgeben lassen. |
| `403` mit `API-Key fehlt Scope: app-tools` | Der Schlüssel ist für eine Spezialanbindung ausgestellt. | Einen App-Tools-Schlüssel verwenden. |
| `403` mit `API-Key hat keinen Actor-User` | Dem Schlüssel fehlt der technische Benutzer. | Schlüssel mit Actor-User ausgeben lassen. |
| `405` | Der Client ruft die Adresse per GET auf. | Im Client die Übertragung „Streamable HTTP“ bzw. `http` wählen. |

## Werkzeuge

| Antwort | Ursache | Lösung |
| --- | --- | --- |
| `Unbekanntes Tool` | Name mit Punkt, Filter an der Adresse oder fehlende Rechte. | Namen aus der Tool-Liste des Clients nehmen, Filter und Rechte prüfen. |
| `Unbekanntes Tool … nur search_tools und call_tool` | Die Adresse enthält `modus=suche`. | Werkzeuge über `call_tool` aufrufen oder `modus=suche` aus der Adresse nehmen. |
| Ergebnis beginnt mit `Fehler:` | Eingabe, Rechte oder fachlicher Zustand passen nicht. | Die Meldung sagt, was fehlt. Der Assistent kann die Eingabe damit meist selbst korrigieren. |

## Code-Mode

| Antwort | Ursache | Lösung |
| --- | --- | --- |
| `403` mit `Dieser API-Schlüssel ist im Code-Mode: Werkzeuge nur über Programme` | Der Key steht im Code-Mode und ruft ein Werkzeug einzeln auf. | Programme über `code_ausfuehren` schicken oder einen klassischen Key verwenden. |
| `Code-Mode ist an diesem API-Schlüssel ausgeschaltet` | Der Key ist klassisch (ab Werk) oder wurde während eines Laufs umgestellt. | Ein Plattform-Admin schaltet **Code-Mode** ein: [Code-Mode einschalten und absichern](https://support.unitedsynergy.com/mcp/code-mode-einschalten/). |
| `Die Code-Ausführung ist auf dieser Instanz nicht eingeschaltet` | Auf dem Server deiner Instanz fehlt die Sandbox für Programme. | Bei deinem Ansprechpartner von United Synergy nachfragen. |
| `Dem Benutzer des Schlüssels fehlt das Recht „Programme ausführen“` | Die Rolle des Actor-Users darf keine Programme starten. | Unter **Admin › Berechtigungen** der Rolle in der App **Automationen** „Programme über einen API-Schlüssel ausführen“ geben. |
| `Die App Automationen ist in diesem Mandanten nicht aktiv` | Programme laufen über die App Automationen. | Die App im Mandanten einschalten lassen. |
| `Fehler: Unbekannte Werkzeuge …` | Das Programm nennt in `werkzeuge` einen Namen, den der Key nicht erreicht. | Mit `search_tools` nach dem richtigen Namen suchen, Rechte und Filter an der Adresse prüfen. |
| `Cannot read properties of undefined` im Programm | Das Werkzeug wird im Programm mit Punkt statt Unterstrich aufgerufen. | Im Programm `syncore.crm.konto_list(…)`, in `werkzeuge` dagegen `crm.konto.list`. |
| Lauf **Abgebrochen** mit Grund `cpu`, `zeit` oder `aufrufe` | Das Programm rechnet zu lange, läuft länger als 60 Sekunden oder ruft mehr als 200 Werkzeuge auf. | Weniger Schleifen, Arbeit auf mehrere Läufe verteilen. Grenzen: [So arbeitet der Code-Mode](https://support.unitedsynergy.com/mcp/code-mode/). |
| Lauf **Wartet auf Freigabe** | Am Key ist unter **Programme freigeben** eine Person eingetragen. | Die Person gibt frei: [Programme von Agenten freigeben](https://support.unitedsynergy.com/workflows/programme/). |

> **Bevor du beginnst**
>
> Wer einen eigenen MCP-Client baut: Bei moderner Protokollversion müssen die Header `MCP-Protocol-Version`, `Mcp-Method` und bei `tools/call` `Mcp-Name` zum Inhalt passen, sonst kommt `400` mit Code `-32020`. Eine nicht unterstützte Version beantwortet SynCore mit `400`, Code `-32022` und der Liste der unterstützten Versionen.

---

# API-Referenz Arbeitszeit (App-Kennung arbeitszeit)

> 30 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/arbeitszeit/

## 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.

### Schichtplan: `arbeitszeit.schicht.*`

#### arbeitszeit.schicht.list

Liste/Suche: Schichtplan

- Art: Lesen
- Rechte: Arbeitszeit lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"arbeitszeit.schicht.list","input":{}}`

#### arbeitszeit.schicht.get

Detail: Schichtplan

- Art: Lesen
- Rechte: Arbeitszeit lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"arbeitszeit.schicht.get","input":{"id":"<id>"}}`

#### arbeitszeit.schicht.create

Anlegen: Schichtplan

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Arbeitszeit anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `schichtartCode` (string)
  - `von` (string, Pflicht)
  - `bis` (string, Pflicht)
  - `bezeichnung` (string)
  - `bemerkung` (string)
  - `standortId` (string)
  - `kostenstelleId` (string)
- Beispiel: `{"name":"arbeitszeit.schicht.create","input":{"von":"<von>","bis":"<bis>"}}`

#### arbeitszeit.schicht.update

Ändern: Schichtplan

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Arbeitszeit ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `schichtartCode` (string)
  - `von` (string)
  - `bis` (string)
  - `bezeichnung` (string)
  - `bemerkung` (string)
  - `standortId` (string)
  - `kostenstelleId` (string)
- Beispiel: `{"name":"arbeitszeit.schicht.update","input":{"id":"<id>"}}`

#### arbeitszeit.schicht.delete

Löschen: Schichtplan

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Arbeitszeit löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"arbeitszeit.schicht.delete","input":{"id":"<id>"}}`

### Zeiterfassung: `arbeitszeit.eintrag.*`

#### arbeitszeit.eintrag.list

Liste/Suche: Zeiterfassung

- Art: Lesen
- Rechte: Arbeitszeit lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"arbeitszeit.eintrag.list","input":{}}`

#### arbeitszeit.eintrag.get

Detail: Zeiterfassung

- Art: Lesen
- Rechte: Arbeitszeit lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"arbeitszeit.eintrag.get","input":{"id":"<id>"}}`

#### arbeitszeit.eintrag.create

Anlegen: Zeiterfassung

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Arbeitszeit anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `personId` (string, Pflicht)
  - `datum` (string, Pflicht)
  - `beginn` (string)
  - `ende` (string)
  - `pauseMinuten` (number)
  - `statusCode` (string)
  - `bereichCode` (string)
  - `kommentar` (string)
- Beispiel: `{"name":"arbeitszeit.eintrag.create","input":{"personId":"<personId>","datum":"<datum>"}}`

#### arbeitszeit.eintrag.update

Ändern: Zeiterfassung

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Arbeitszeit ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `personId` (string)
  - `datum` (string)
  - `beginn` (string)
  - `ende` (string)
  - `pauseMinuten` (number)
  - `statusCode` (string)
  - `bereichCode` (string)
  - `kommentar` (string)
- Beispiel: `{"name":"arbeitszeit.eintrag.update","input":{"id":"<id>"}}`

#### arbeitszeit.eintrag.delete

Löschen: Zeiterfassung

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Arbeitszeit löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"arbeitszeit.eintrag.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.

### Arbeitsbereiche: `arbeitszeit.bereich.*`

#### arbeitszeit.bereich.list

Liste/Suche: Katalog „Arbeitsbereiche" (arbeitszeit)

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

#### arbeitszeit.bereich.get

Detail: Katalog „Arbeitsbereiche" (arbeitszeit)

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

#### arbeitszeit.bereich.create

Anlegen: Katalog „Arbeitsbereiche" (arbeitszeit)

- 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":"arbeitszeit.bereich.create","input":{"label":"<label>"}}`

#### arbeitszeit.bereich.update

Ändern: Katalog „Arbeitsbereiche" (arbeitszeit)

- 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":"arbeitszeit.bereich.update","input":{"id":"<id>"}}`

#### arbeitszeit.bereich.delete

Löschen: Katalog „Arbeitsbereiche" (arbeitszeit)

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

### Lohnarten: `arbeitszeit.lohnart.*`

#### arbeitszeit.lohnart.list

Liste/Suche: Katalog „Lohnarten" (arbeitszeit)

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

#### arbeitszeit.lohnart.get

Detail: Katalog „Lohnarten" (arbeitszeit)

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

#### arbeitszeit.lohnart.create

Anlegen: Katalog „Lohnarten" (arbeitszeit)

- 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":"arbeitszeit.lohnart.create","input":{"label":"<label>"}}`

#### arbeitszeit.lohnart.update

Ändern: Katalog „Lohnarten" (arbeitszeit)

- 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":"arbeitszeit.lohnart.update","input":{"id":"<id>"}}`

#### arbeitszeit.lohnart.delete

Löschen: Katalog „Lohnarten" (arbeitszeit)

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

### Schichtarten: `arbeitszeit.schichtart.*`

#### arbeitszeit.schichtart.list

Liste/Suche: Katalog „Schichtarten" (arbeitszeit)

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

#### arbeitszeit.schichtart.get

Detail: Katalog „Schichtarten" (arbeitszeit)

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

#### arbeitszeit.schichtart.create

Anlegen: Katalog „Schichtarten" (arbeitszeit)

- 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":"arbeitszeit.schichtart.create","input":{"label":"<label>"}}`

#### arbeitszeit.schichtart.update

Ändern: Katalog „Schichtarten" (arbeitszeit)

- 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":"arbeitszeit.schichtart.update","input":{"id":"<id>"}}`

#### arbeitszeit.schichtart.delete

Löschen: Katalog „Schichtarten" (arbeitszeit)

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

### Status: `arbeitszeit.status.*`

#### arbeitszeit.status.list

Liste/Suche: Katalog „Status" (arbeitszeit)

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

#### arbeitszeit.status.get

Detail: Katalog „Status" (arbeitszeit)

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

#### arbeitszeit.status.create

Anlegen: Katalog „Status" (arbeitszeit)

- 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":"arbeitszeit.status.create","input":{"label":"<label>"}}`

#### arbeitszeit.status.update

Ändern: Katalog „Status" (arbeitszeit)

- 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":"arbeitszeit.status.update","input":{"id":"<id>"}}`

#### arbeitszeit.status.delete

Löschen: Katalog „Status" (arbeitszeit)

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

---

# API-Referenz Aufgaben (App-Kennung projektsyn)

> 51 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/projektsyn/

## 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.

### Aufgaben (ProjektSyn): `projektsyn.ticket.*`

#### projektsyn.ticket.list

Liste/Suche: Aufgaben (ProjektSyn)

- Art: Lesen
- Rechte: Ticket lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"projektsyn.ticket.list","input":{}}`

#### projektsyn.ticket.get

Detail: Aufgaben (ProjektSyn)

- Art: Lesen
- Rechte: Ticket lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"projektsyn.ticket.get","input":{"id":"<id>"}}`

#### projektsyn.ticket.create

Anlegen: Aufgaben (ProjektSyn)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ticket anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `beschreibung` (string)
  - `prioritaet` (string): Werte: `kritisch`, `hoch`, `normal`, `niedrig`
  - `deadline` (string)
  - `projektId` (string)
  - `statusId` (string)
  - `crmGbzId` (string)
  - `assigneeIds` (string)
  - `geschaetzteDauer` (number)
  - `herkunftVorlageId` (string)
  - `tags` (string)
  - `fortschritt` (number)
  - `startDatum` (string)
  - `endeDatum` (string)
  - `abhaengigkeitTicketIds` (string)
  - `ownerType` (string)
  - `ownerId` (string)
  - `aktivitaetsTyp` (string): Werte: `anruf`, `mail`, `termin`, `notiz`, `aufgabe`
  - `erledigt` (boolean)
- Beispiel: `{"name":"projektsyn.ticket.create","input":{"titel":"<titel>"}}`

#### projektsyn.ticket.update

Ändern: Aufgaben (ProjektSyn)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ticket ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `prioritaet` (string): Werte: `kritisch`, `hoch`, `normal`, `niedrig`
  - `deadline` (string)
  - `projektId` (string)
  - `statusId` (string)
  - `crmGbzId` (string)
  - `assigneeIds` (string)
  - `geschaetzteDauer` (number)
  - `herkunftVorlageId` (string)
  - `tags` (string)
  - `fortschritt` (number)
  - `startDatum` (string)
  - `endeDatum` (string)
  - `abhaengigkeitTicketIds` (string)
  - `ownerType` (string)
  - `ownerId` (string)
  - `aktivitaetsTyp` (string): Werte: `anruf`, `mail`, `termin`, `notiz`, `aufgabe`
  - `erledigt` (boolean)
- Beispiel: `{"name":"projektsyn.ticket.update","input":{"id":"<id>"}}`

#### projektsyn.ticket.delete

Löschen: Aufgaben (ProjektSyn)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ticket löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"projektsyn.ticket.delete","input":{"id":"<id>"}}`

### Aufgaben-Vorlagen (ProjektSyn): `projektsyn.vorlage.*`

#### projektsyn.vorlage.list

Liste/Suche: Aufgaben-Vorlagen (ProjektSyn)

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

#### projektsyn.vorlage.get

Detail: Aufgaben-Vorlagen (ProjektSyn)

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

#### projektsyn.vorlage.create

Anlegen: Aufgaben-Vorlagen (ProjektSyn)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vorlage anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `titel` (string, Pflicht)
  - `beschreibung` (string)
  - `prioritaet` (string): Werte: `kritisch`, `hoch`, `normal`, `niedrig`
  - `kategorie` (string)
  - `fristTage` (number)
  - `fristZeitpunkt` (string): Werte: `vor_datum`, `nach_datum`
  - `pflichtaufgabe` (boolean)
  - `geschaetzteDauer` (number)
  - `url` (string)
  - `tags` (string)
  - `farbe` (string)
- Beispiel: `{"name":"projektsyn.vorlage.create","input":{"titel":"<titel>"}}`

#### projektsyn.vorlage.update

Ändern: Aufgaben-Vorlagen (ProjektSyn)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vorlage ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `prioritaet` (string): Werte: `kritisch`, `hoch`, `normal`, `niedrig`
  - `kategorie` (string)
  - `fristTage` (number)
  - `fristZeitpunkt` (string): Werte: `vor_datum`, `nach_datum`
  - `pflichtaufgabe` (boolean)
  - `geschaetzteDauer` (number)
  - `url` (string)
  - `tags` (string)
  - `farbe` (string)
- Beispiel: `{"name":"projektsyn.vorlage.update","input":{"id":"<id>"}}`

### Kanban-Spalten (ProjektSyn): `projektsyn.status_spalte.*`

#### projektsyn.status_spalte.list

Liste/Suche: Kanban-Spalten (ProjektSyn)

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

#### projektsyn.status_spalte.get

Detail: Kanban-Spalten (ProjektSyn)

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

#### projektsyn.status_spalte.create

Anlegen: Kanban-Spalten (ProjektSyn)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Projekt ändern
- Datenklassen: B (intern)
- Eingabe:
  - `projektId` (string, Pflicht)
  - `name` (string, Pflicht)
  - `position` (number)
  - `farbe` (string)
  - `icon` (string)
  - `istFakturierung` (boolean)
  - `istAbgeschlossen` (boolean)
- Beispiel: `{"name":"projektsyn.status_spalte.create","input":{"projektId":"<projektId>","name":"<name>"}}`

#### projektsyn.status_spalte.update

Ändern: Kanban-Spalten (ProjektSyn)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Projekt ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `projektId` (string)
  - `name` (string)
  - `position` (number)
  - `farbe` (string)
  - `icon` (string)
  - `istFakturierung` (boolean)
  - `istAbgeschlossen` (boolean)
- Beispiel: `{"name":"projektsyn.status_spalte.update","input":{"id":"<id>"}}`

#### projektsyn.status_spalte.delete

Löschen: Kanban-Spalten (ProjektSyn)

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

### Projekte (ProjektSyn): `projektsyn.projekt.*`

#### projektsyn.projekt.list

Liste/Suche: Projekte (ProjektSyn)

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

#### projektsyn.projekt.get

Detail: Projekte (ProjektSyn)

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

#### projektsyn.projekt.create

Anlegen: Projekte (ProjektSyn)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Projekt anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `name` (string, Pflicht)
  - `beschreibung` (string)
  - `farbe` (string)
  - `defaultView` (string): Werte: `liste`, `kanban`, `kalender`, `scheduler`, `gantt`
  - `ownerType` (string)
  - `ownerId` (string)
  - `ownerLabel` (string)
- Beispiel: `{"name":"projektsyn.projekt.create","input":{"name":"<name>"}}`

#### projektsyn.projekt.update

Ändern: Projekte (ProjektSyn)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Projekt ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `name` (string)
  - `beschreibung` (string)
  - `farbe` (string)
  - `defaultView` (string): Werte: `liste`, `kanban`, `kalender`, `scheduler`, `gantt`
  - `ownerType` (string)
  - `ownerId` (string)
  - `ownerLabel` (string)
- Beispiel: `{"name":"projektsyn.projekt.update","input":{"id":"<id>"}}`

#### projektsyn.projekt.delete

Löschen: Projekte (ProjektSyn)

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

### Projektvorlagen (ProjektSyn): `projektsyn.projektvorlage.*`

#### projektsyn.projektvorlage.list

Liste/Suche: Projektvorlagen (ProjektSyn)

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

#### projektsyn.projektvorlage.get

Detail: Projektvorlagen (ProjektSyn)

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

#### projektsyn.projektvorlage.create

Anlegen: Projektvorlagen (ProjektSyn)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vorlage anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `titel` (string, Pflicht)
  - `beschreibung` (string)
  - `kategorie` (string)
  - `gruppierung` (string)
  - `farbe` (string)
- Beispiel: `{"name":"projektsyn.projektvorlage.create","input":{"titel":"<titel>"}}`

#### projektsyn.projektvorlage.update

Ändern: Projektvorlagen (ProjektSyn)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vorlage ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `kategorie` (string)
  - `gruppierung` (string)
  - `farbe` (string)
- Beispiel: `{"name":"projektsyn.projektvorlage.update","input":{"id":"<id>"}}`

### Zeitbuchungen (ProjektSyn): `projektsyn.zeitbuchung.*`

#### projektsyn.zeitbuchung.list

Liste/Suche: Zeitbuchungen (ProjektSyn)

- Art: Lesen
- Rechte: Zeitbuchung lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"projektsyn.zeitbuchung.list","input":{}}`

#### projektsyn.zeitbuchung.get

Detail: Zeitbuchungen (ProjektSyn)

- Art: Lesen
- Rechte: Zeitbuchung lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"projektsyn.zeitbuchung.get","input":{"id":"<id>"}}`

#### projektsyn.zeitbuchung.create

Anlegen: Zeitbuchungen (ProjektSyn)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Zeitbuchung anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `ticketId` (string, Pflicht)
  - `datum` (string, Pflicht)
  - `start` (string)
  - `ende` (string)
  - `dauer` (number, Pflicht)
  - `notiz` (string)
- Beispiel: `{"name":"projektsyn.zeitbuchung.create","input":{"ticketId":"<ticketId>","datum":"<datum>","dauer":1}}`

#### projektsyn.zeitbuchung.update

Ändern: Zeitbuchungen (ProjektSyn)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Zeitbuchung ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `ticketId` (string)
  - `datum` (string)
  - `start` (string)
  - `ende` (string)
  - `dauer` (number)
  - `notiz` (string)
- Beispiel: `{"name":"projektsyn.zeitbuchung.update","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.

### Gruppierungen: `projektsyn.gruppierungen.*`

#### projektsyn.gruppierungen.list

Liste/Suche: Katalog „Gruppierungen" (projektsyn)

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

#### projektsyn.gruppierungen.get

Detail: Katalog „Gruppierungen" (projektsyn)

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

#### projektsyn.gruppierungen.create

Anlegen: Katalog „Gruppierungen" (projektsyn)

- 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":"projektsyn.gruppierungen.create","input":{"label":"<label>"}}`

#### projektsyn.gruppierungen.update

Ändern: Katalog „Gruppierungen" (projektsyn)

- 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":"projektsyn.gruppierungen.update","input":{"id":"<id>"}}`

#### projektsyn.gruppierungen.delete

Löschen: Katalog „Gruppierungen" (projektsyn)

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

### Kategorien: `projektsyn.kategorien.*`

#### projektsyn.kategorien.list

Liste/Suche: Katalog „Kategorien" (projektsyn)

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

#### projektsyn.kategorien.get

Detail: Katalog „Kategorien" (projektsyn)

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

#### projektsyn.kategorien.create

Anlegen: Katalog „Kategorien" (projektsyn)

- 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":"projektsyn.kategorien.create","input":{"label":"<label>"}}`

#### projektsyn.kategorien.update

Ändern: Katalog „Kategorien" (projektsyn)

- 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":"projektsyn.kategorien.update","input":{"id":"<id>"}}`

#### projektsyn.kategorien.delete

Löschen: Katalog „Kategorien" (projektsyn)

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

### Tags: `projektsyn.tags.*`

#### projektsyn.tags.list

Liste/Suche: Katalog „Tags" (projektsyn)

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

#### projektsyn.tags.get

Detail: Katalog „Tags" (projektsyn)

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

#### projektsyn.tags.create

Anlegen: Katalog „Tags" (projektsyn)

- 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":"projektsyn.tags.create","input":{"label":"<label>"}}`

#### projektsyn.tags.update

Ändern: Katalog „Tags" (projektsyn)

- 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":"projektsyn.tags.update","input":{"id":"<id>"}}`

#### projektsyn.tags.delete

Löschen: Katalog „Tags" (projektsyn)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### projektsyn.book_time

Bucht Zeit auf eine bestehende Aufgabe

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ticket lesen, Zeitbuchung anlegen
- Datenklassen: C (vertraulich)
- Datenschutz: Bucht Arbeitszeit fuer den aktuellen Nutzer auf eine tenant-interne Aufgabe.
- Eingabe:
  - `ticketId` (string, Pflicht)
  - `hours` (number, Pflicht)
  - `date` (string): ISO-Datum YYYY-MM-DD, Default heute
  - `start` (string): HH:MM. Ohne Angabe beginnt die Buchung im Anschluss an die letzte eigene Buchung des Tages, sonst 09:00
  - `note` (string)
- Beispiel: `{"name":"projektsyn.book_time","input":{"ticketId":"<ticketId>","hours":1}}`

#### projektsyn.book_time_on_customer

Bucht Zeit auf ein CRM-Konto und erzeugt dafuer eine verknuepfte Aufgabe

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: crm: Konto lesen, Ticket anlegen, Zeitbuchung anlegen
- Datenklassen: C (vertraulich)
- Datenschutz: Sucht ein CRM-Konto im aktiven Tenant. Bei mehreren Treffern wird nicht gebucht, sondern Auswahl angefordert.
- Eingabe:
  - `customerId` (string)
  - `customerSearch` (string): Suchbegriff, wenn customerId unbekannt ist
  - `customerName` (string)
  - `kunde` (string)
  - `hours` (number, Pflicht)
  - `date` (string): ISO-Datum YYYY-MM-DD, Default heute
  - `start` (string): HH:MM. Ohne Angabe beginnt die Buchung im Anschluss an die letzte eigene Buchung des Tages, sonst 09:00
  - `title` (string)
  - `note` (string)
- Beispiel: `{"name":"projektsyn.book_time_on_customer","input":{"hours":1}}`

#### projektsyn.erfahrungs_report

PDCA-Check / Wissensdatenbank: je Aufgaben-Vorlage Plan (geschaetzteDauer) vs. Do (Ø gebuchte Ist-Zeit), Instanzen, Erledigt-Quote, Varianz, Optimierungs-Flags. Plus promote_kandidaten = wiederkehrende Aufgaben aus ad-hoc/allgemeinen Projekten OHNE Vorlagen-Herkunft (mit Ø-Ist-Zeit) als Kandidaten für neue Vorlagen. Basis fuer ACT: Schaetzungen korrigieren + Vorlagen erweitern. Aussagekraft waechst mit Instanzen + Zeitbuchungen.

- Art: Lesen
- Rechte: Ticket lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `min_instanzen` (number): Nur Vorlagen-Aufgaben mit mindestens N Instanzen (Default 1)
- Beispiel: `{"name":"projektsyn.erfahrungs_report","input":{}}`

#### projektsyn.instantiate_projektvorlage

Erstellt aus einer Projektvorlage (Bündel) ein neues Projekt mit allen gebündelten Aufgaben und hängt es optional an einen Datensatz (CRM-Konto via crmGbzId, oder beliebig via ownerType+ownerId).

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Projekt anlegen, Ticket anlegen, Vorlage lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Legt ein Projekt + Aufgaben im aktiven Tenant an, optional verknüpft mit einem Datensatz.
- Eingabe:
  - `projektvorlageId` (string, Pflicht): ID der Projektvorlage (ChecklistenVorlage)
  - `name` (string): Projektname (Default: Vorlagentitel)
  - `crmGbzId` (string): CRM-Konto-ID, Projekt + Aufgaben daran hängen
  - `ownerType` (string): Generischer Owner-Typ (z.B. modul.entitaet)
  - `ownerId` (string): Generische Owner-Datensatz-ID
  - `basisDatum` (string): ISO-Datum für Frist-Berechnung der Aufgaben
- Beispiel: `{"name":"projektsyn.instantiate_projektvorlage","input":{"projektvorlageId":"<projektvorlageId>"}}`

#### projektsyn.instantiate_vorlage

Erstellt ein Ticket aus einer Vorlage

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vorlage lesen, Ticket anlegen
- Datenklassen: C (vertraulich)
- Datenschutz: Erstellt eine Aufgabe aus einer tenant-internen Vorlage.
- Eingabe:
  - `vorlageId` (string, Pflicht)
  - `projektId` (string)
  - `basisDatum` (string): ISO-Datum fuer Frist-Berechnung
  - `crmGbzId` (string)
  - `ownerType` (string)
  - `ownerId` (string)
- Beispiel: `{"name":"projektsyn.instantiate_vorlage","input":{"vorlageId":"<vorlageId>"}}`

#### projektsyn.projekt_zu_vorlage

PDCA-Act: leitet aus einem echten Projekt eine Projekt-Vorlage + Aufgaben-Vorlagen ab (Rueckrichtung Projekt→Vorlage). Dauer je abgeleiteter Vorlage = gelernte Ist-Zeit (Zeitbuchung), sonst Schaetzung. Fuer den Aufbau des Vorlagen-Pools aus gelebter Praxis.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ticket anlegen
- Datenklassen: C (vertraulich)
- Datenschutz: Legt Vorlagen aus vorhandenen Projekt-Aufgaben an (Klasse C, keine Personendaten im Vorlagen-Inhalt).
- Eingabe:
  - `projektId` (string, Pflicht): Quell-Projekt, aus dem die Vorlage abgeleitet wird
  - `name` (string): Name der neuen Projekt-Vorlage (Default: "Vorlage: <Projektname>")
- Beispiel: `{"name":"projektsyn.projekt_zu_vorlage","input":{"projektId":"<projektId>"}}`

#### projektsyn.projekt.freigabe_list

Listet die Mandanten, fuer die ein Projekt freigegeben ist, PLUS die moeglichen Ziele (alle echten Mandanten). Fuer das Mandanten-Multiselect am Projekt. Mandantenuebergreifendes PM: 1:1 wie crm.konto.freigabe.

- Art: Lesen
- Rechte: Projekt lesen
- Datenklassen: B (intern)
- Eingabe:
  - `projektId` (string, Pflicht): Projekt-ID (projektsyn_projekte.id)
- Beispiel: `{"name":"projektsyn.projekt.freigabe_list","input":{"projektId":"<projektId>"}}`

#### projektsyn.projekt.freigabe_set

Setzt die Mandanten, fuer die ein Projekt freigegeben ist (Replace-Semantik; nur der Hauptmandant und nur am eigenen Projekt). Das Ziel-Haus sieht dann das Projekt und dessen Aufgaben und kann Aufgaben an Nutzer beider Mandanten zuweisen.

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Projekt ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Macht ein Projekt inkl. Aufgaben fuer einen fremden Mandanten sichtbar und bearbeitbar. Nur Hauptmandant, nur mit vertraglicher Grundlage.
- Eingabe:
  - `projektId` (string, Pflicht): Projekt-ID (projektsyn_projekte.id)
  - `zielTenantIds` (string[]): Ziel-Tenant-IDs. Leer = alle Freigaben entfernen
- Beispiel: `{"name":"projektsyn.projekt.freigabe_set","input":{"projektId":"<projektId>"}}`

#### projektsyn.wochen_report

Wochen-Planungs-Report: offene Aufgaben nach Faelligkeit gebuendelt (ueberfaellig / diese_woche / naechste_woche / ohne_datum / spaeter) + KPIs + Auslastung pro Verantwortlichem (offen, ueberfaellig, Stunden, Prio hoch). Fuer die Wochenplanung/-organisation. Umplanen dann via projektsyn_ticket_update.

- Art: Lesen
- Rechte: Ticket lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `nur_ich` (boolean): true = nur Aufgaben des aktuellen Nutzers
  - `userId` (string): Auf einen bestimmten Verantwortlichen filtern (User-ID). nur_ich hat Vorrang
- Beispiel: `{"name":"projektsyn.wochen_report","input":{}}`

---

# API-Referenz Aufträge (App-Kennung auftraege)

> 31 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/auftraege/

## 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.

### Aufträge: `auftraege.auftrag.*`

#### auftraege.auftrag.list

Liste/Suche: Aufträge

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

#### auftraege.auftrag.get

Detail: Aufträge

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

#### auftraege.auftrag.create

Anlegen: Aufträge

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Auftrag anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `nummer` (string)
  - `bezeichnung` (string, Pflicht)
  - `externeNummer` (string)
  - `auftragsartCode` (string, Pflicht)
  - `gewerkCode` (string)
  - `statusCode` (string)
  - `prioritaet` (string)
  - `parentId` (string)
  - `kontoId` (string, Pflicht)
  - `kontaktId` (string)
  - `objektId` (string)
  - `vertragId` (string)
  - `verantwortlichPersonId` (string)
  - `vorOrtPersonId` (string)
  - `kolonneKstId` (string)
  - `kostenstelleId` (string)
  - `eingangAm` (string)
  - `beginnGeplant` (string)
  - `endeGeplant` (string)
  - `fristBis` (string)
  - `abgeschlossenAm` (string)
  - `beschreibung` (string)
  - `bemerkung` (string)
  - `wert` (number)
  - `waehrung` (string)
- Beispiel: `{"name":"auftraege.auftrag.create","input":{"bezeichnung":"<bezeichnung>","auftragsartCode":"<auftragsartCode>","kontoId":"<kontoId>"}}`

#### auftraege.auftrag.update

Ändern: Aufträge

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Auftrag ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `nummer` (string)
  - `bezeichnung` (string)
  - `externeNummer` (string)
  - `auftragsartCode` (string)
  - `gewerkCode` (string)
  - `statusCode` (string)
  - `prioritaet` (string)
  - `parentId` (string)
  - `kontoId` (string)
  - `kontaktId` (string)
  - `objektId` (string)
  - `vertragId` (string)
  - `verantwortlichPersonId` (string)
  - `vorOrtPersonId` (string)
  - `kolonneKstId` (string)
  - `kostenstelleId` (string)
  - `eingangAm` (string)
  - `beginnGeplant` (string)
  - `endeGeplant` (string)
  - `fristBis` (string)
  - `abgeschlossenAm` (string)
  - `beschreibung` (string)
  - `bemerkung` (string)
  - `wert` (number)
  - `waehrung` (string)
- Beispiel: `{"name":"auftraege.auftrag.update","input":{"id":"<id>"}}`

#### auftraege.auftrag.delete

Löschen: Aufträge

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

### Beteiligte am Auftrag: `auftraege.beteiligter.*`

#### auftraege.beteiligter.list

Liste/Suche: Beteiligte am Auftrag

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

#### auftraege.beteiligter.get

Detail: Beteiligte am Auftrag

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

#### auftraege.beteiligter.create

Anlegen: Beteiligte am Auftrag

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Auftrag ändern
- Datenklassen: B (intern)
- Eingabe:
  - `auftragId` (string, Pflicht)
  - `rolleCode` (string, Pflicht)
  - `kontoId` (string)
  - `kontaktId` (string)
  - `bezeichnung` (string)
  - `bemerkung` (string)
  - `position` (number)
- Beispiel: `{"name":"auftraege.beteiligter.create","input":{"auftragId":"<auftragId>","rolleCode":"<rolleCode>"}}`

#### auftraege.beteiligter.update

Ändern: Beteiligte am Auftrag

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Auftrag ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `auftragId` (string)
  - `rolleCode` (string)
  - `kontoId` (string)
  - `kontaktId` (string)
  - `bezeichnung` (string)
  - `bemerkung` (string)
  - `position` (number)
- Beispiel: `{"name":"auftraege.beteiligter.update","input":{"id":"<id>"}}`

#### auftraege.beteiligter.delete

Löschen: Beteiligte am Auftrag

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Auftrag ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"auftraege.beteiligter.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.

### Auftragsarten: `auftraege.auftragsart.*`

#### auftraege.auftragsart.list

Liste/Suche: Katalog „Auftragsarten" (auftraege)

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

#### auftraege.auftragsart.get

Detail: Katalog „Auftragsarten" (auftraege)

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

#### auftraege.auftragsart.create

Anlegen: Katalog „Auftragsarten" (auftraege)

- 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":"auftraege.auftragsart.create","input":{"label":"<label>"}}`

#### auftraege.auftragsart.update

Ändern: Katalog „Auftragsarten" (auftraege)

- 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":"auftraege.auftragsart.update","input":{"id":"<id>"}}`

#### auftraege.auftragsart.delete

Löschen: Katalog „Auftragsarten" (auftraege)

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

### Auftragsstatus: `auftraege.status.*`

#### auftraege.status.list

Liste/Suche: Katalog „Auftragsstatus" (auftraege)

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

#### auftraege.status.get

Detail: Katalog „Auftragsstatus" (auftraege)

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

#### auftraege.status.create

Anlegen: Katalog „Auftragsstatus" (auftraege)

- 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":"auftraege.status.create","input":{"label":"<label>"}}`

#### auftraege.status.update

Ändern: Katalog „Auftragsstatus" (auftraege)

- 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":"auftraege.status.update","input":{"id":"<id>"}}`

#### auftraege.status.delete

Löschen: Katalog „Auftragsstatus" (auftraege)

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

### Beteiligtenrollen: `auftraege.beteiligtenrolle.*`

#### auftraege.beteiligtenrolle.list

Liste/Suche: Katalog „Beteiligtenrollen" (auftraege)

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

#### auftraege.beteiligtenrolle.get

Detail: Katalog „Beteiligtenrollen" (auftraege)

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

#### auftraege.beteiligtenrolle.create

Anlegen: Katalog „Beteiligtenrollen" (auftraege)

- 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":"auftraege.beteiligtenrolle.create","input":{"label":"<label>"}}`

#### auftraege.beteiligtenrolle.update

Ändern: Katalog „Beteiligtenrollen" (auftraege)

- 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":"auftraege.beteiligtenrolle.update","input":{"id":"<id>"}}`

#### auftraege.beteiligtenrolle.delete

Löschen: Katalog „Beteiligtenrollen" (auftraege)

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

### Gewerke: `auftraege.gewerk.*`

#### auftraege.gewerk.list

Liste/Suche: Katalog „Gewerke" (auftraege)

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

#### auftraege.gewerk.get

Detail: Katalog „Gewerke" (auftraege)

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

#### auftraege.gewerk.create

Anlegen: Katalog „Gewerke" (auftraege)

- 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":"auftraege.gewerk.create","input":{"label":"<label>"}}`

#### auftraege.gewerk.update

Ändern: Katalog „Gewerke" (auftraege)

- 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":"auftraege.gewerk.update","input":{"id":"<id>"}}`

#### auftraege.gewerk.delete

Löschen: Katalog „Gewerke" (auftraege)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### auftraege.wartung_erzeugen

Wartungsaufträge aus Verträgen: zeigt je Wartungsvertrag (Merkmal intervall_monate) letzte und nächste Wartung (letzte + Intervall, Felder letzte_wartung/naechste_wartung am Vertrag) und legt fällige Wartungsaufträge an (30 Tage Vorlauf, je Vertrag höchstens ein offener). Standard ist dryRun=true (nur Vorschau); mit dryRun=false wird angelegt.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Auftrag anlegen, vertraege: Vertrag lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Liest Verträge des Mandanten und legt Aufträge an; keine Daten verlassen den Mandanten.
- Eingabe:
  - `dryRun` (boolean): true (Standard) = nur Vorschau, false = anlegen
  - `vorlaufTage` (number): Tage vor Fälligkeit, ab denen angelegt wird (Standard 30)
- Beispiel: `{"name":"auftraege.wartung_erzeugen","input":{}}`

---

# API-Referenz Ausbildung (App-Kennung bildung)

> 98 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/bildung/

## 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.

### Ausbildungen: `bildung.ausbildung.*`

#### bildung.ausbildung.list

Liste/Suche: Ausbildungen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.ausbildung.list","input":{}}`

#### bildung.ausbildung.get

Detail: Ausbildungen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.ausbildung.get","input":{"id":"<id>"}}`

#### bildung.ausbildung.create

Anlegen: Ausbildungen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `nummer` (string): Natürlicher Schlüssel für Dedup
  - `titel` (string, Pflicht)
  - `kuerzel` (string)
  - `kategorie` (string)
  - `abschlussCode` (string)
  - `dauer` (number)
  - `einheit` (string)
  - `ue` (number)
  - `beginn` (string)
  - `ende` (string)
  - `statusCode` (string)
  - `bemerkung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.ausbildung.create","input":{"titel":"<titel>"}}`

#### bildung.ausbildung.update

Ändern: Ausbildungen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `kuerzel` (string)
  - `kategorie` (string)
  - `abschlussCode` (string)
  - `dauer` (number)
  - `einheit` (string)
  - `ue` (number)
  - `beginn` (string)
  - `ende` (string)
  - `statusCode` (string)
  - `bemerkung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.ausbildung.update","input":{"id":"<id>"}}`

#### bildung.ausbildung.delete

Löschen: Ausbildungen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.ausbildung.delete","input":{"id":"<id>"}}`

### Lerninhalte: `bildung.lerninhalt.*`

#### bildung.lerninhalt.list

Liste/Suche: Lerninhalte

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.lerninhalt.list","input":{}}`

#### bildung.lerninhalt.get

Detail: Lerninhalte

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.lerninhalt.get","input":{"id":"<id>"}}`

#### bildung.lerninhalt.create

Anlegen: Lerninhalte

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `nummer` (string)
  - `beschreibung` (string)
  - `ue` (number)
  - `dauer` (number)
  - `einheit` (string)
  - `typ` (string)
  - `url` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.lerninhalt.create","input":{"titel":"<titel>"}}`

#### bildung.lerninhalt.update

Ändern: Lerninhalte

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `nummer` (string)
  - `beschreibung` (string)
  - `ue` (number)
  - `dauer` (number)
  - `einheit` (string)
  - `typ` (string)
  - `url` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.lerninhalt.update","input":{"id":"<id>"}}`

#### bildung.lerninhalt.delete

Löschen: Lerninhalte

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.lerninhalt.delete","input":{"id":"<id>"}}`

### Modul-Zuordnungen: `bildung.modul_ausbildung.*`

#### bildung.modul_ausbildung.list

Liste/Suche: Modul-Zuordnungen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.modul_ausbildung.list","input":{}}`

#### bildung.modul_ausbildung.get

Detail: Modul-Zuordnungen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.modul_ausbildung.get","input":{"id":"<id>"}}`

#### bildung.modul_ausbildung.create

Anlegen: Modul-Zuordnungen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `modul` (string)
  - `ausbildung` (string)
- Beispiel: `{"name":"bildung.modul_ausbildung.create","input":{}}`

#### bildung.modul_ausbildung.update

Ändern: Modul-Zuordnungen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
- Beispiel: `{"name":"bildung.modul_ausbildung.update","input":{"id":"<id>"}}`

### Module: `bildung.modul.*`

#### bildung.modul.list

Liste/Suche: Module

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.modul.list","input":{}}`

#### bildung.modul.get

Detail: Module

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.modul.get","input":{"id":"<id>"}}`

#### bildung.modul.create

Anlegen: Module

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `nummer` (string)
  - `beschreibung` (string)
  - `ue` (number)
  - `dauer` (number)
  - `einheit` (string)
  - `lernortCode` (string)
  - `phase` (string)
  - `jahr` (number)
  - `abschlussCode` (string)
  - `color` (string)
  - `badge` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.modul.create","input":{"titel":"<titel>"}}`

#### bildung.modul.update

Ändern: Module

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `ue` (number)
  - `dauer` (number)
  - `einheit` (string)
  - `lernortCode` (string)
  - `phase` (string)
  - `jahr` (number)
  - `abschlussCode` (string)
  - `color` (string)
  - `badge` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.modul.update","input":{"id":"<id>"}}`

#### bildung.modul.delete

Löschen: Module

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.modul.delete","input":{"id":"<id>"}}`

### Schulklassen: `bildung.schulklasse.*`

#### bildung.schulklasse.list

Liste/Suche: Schulklassen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.schulklasse.list","input":{}}`

#### bildung.schulklasse.get

Detail: Schulklassen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.schulklasse.get","input":{"id":"<id>"}}`

#### bildung.schulklasse.create

Anlegen: Schulklassen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `bezeichnung` (string, Pflicht)
  - `nummer` (string)
  - `ausbildungId` (string)
  - `statusCode` (string)
  - `bemerkung` (string)
  - `aktiv` (boolean)
  - `ausbildungNummer` (string): Verweis auf Ausbildung.nummer, wird zu Ausbildung-ID aufgelöst (Ausbildung muss zuerst importiert sein)
- Beispiel: `{"name":"bildung.schulklasse.create","input":{"bezeichnung":"<bezeichnung>"}}`

#### bildung.schulklasse.update

Ändern: Schulklassen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `bezeichnung` (string)
  - `nummer` (string)
  - `ausbildungId` (string)
  - `statusCode` (string)
  - `bemerkung` (string)
  - `aktiv` (boolean)
  - `ausbildungNummer` (string): Verweis auf Ausbildung.nummer, wird zu Ausbildung-ID aufgelöst (Ausbildung muss zuerst importiert sein)
- Beispiel: `{"name":"bildung.schulklasse.update","input":{"id":"<id>"}}`

#### bildung.schulklasse.delete

Löschen: Schulklassen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.schulklasse.delete","input":{"id":"<id>"}}`

### Skills: `bildung.skill.*`

#### bildung.skill.list

Liste/Suche: Skills

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.skill.list","input":{}}`

#### bildung.skill.get

Detail: Skills

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.skill.get","input":{"id":"<id>"}}`

#### bildung.skill.create

Anlegen: Skills

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `nummer` (string)
  - `beschreibung` (string)
  - `kategorie` (string)
  - `istPflicht` (boolean)
  - `istPruefung` (boolean)
  - `schwierigkeit` (string)
  - `videoUrl` (string)
  - `dauerMin` (number)
  - `indikation` (string)
  - `nachweisSoll` (string)
  - `mindestzahl` (number)
  - `nachweisSetting` (string)
  - `autonomie` (string)
  - `leitlinie` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.skill.create","input":{"titel":"<titel>"}}`

#### bildung.skill.update

Ändern: Skills

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `kategorie` (string)
  - `istPflicht` (boolean)
  - `istPruefung` (boolean)
  - `schwierigkeit` (string)
  - `videoUrl` (string)
  - `dauerMin` (number)
  - `indikation` (string)
  - `nachweisSoll` (string)
  - `mindestzahl` (number)
  - `nachweisSetting` (string)
  - `autonomie` (string)
  - `leitlinie` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.skill.update","input":{"id":"<id>"}}`

#### bildung.skill.delete

Löschen: Skills

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.skill.delete","input":{"id":"<id>"}}`

### Themen: `bildung.thema.*`

#### bildung.thema.list

Liste/Suche: Themen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.thema.list","input":{}}`

#### bildung.thema.get

Detail: Themen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.thema.get","input":{"id":"<id>"}}`

#### bildung.thema.create

Anlegen: Themen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `nummer` (string)
  - `beschreibung` (string)
  - `lernortCode` (string)
  - `ue` (number)
  - `dauer` (number)
  - `einheit` (string)
  - `typ` (string)
  - `sollUe` (number)
  - `zuordnung` (string)
  - `aprBereich` (string)
  - `aprNummer` (string)
  - `systemrelevant` (boolean)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.thema.create","input":{"titel":"<titel>"}}`

#### bildung.thema.update

Ändern: Themen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `lernortCode` (string)
  - `ue` (number)
  - `dauer` (number)
  - `einheit` (string)
  - `typ` (string)
  - `sollUe` (number)
  - `zuordnung` (string)
  - `aprBereich` (string)
  - `aprNummer` (string)
  - `systemrelevant` (boolean)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.thema.update","input":{"id":"<id>"}}`

#### bildung.thema.delete

Löschen: Themen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.thema.delete","input":{"id":"<id>"}}`

### Unterricht-Zuordnungen: `bildung.unterricht_ausbildung.*`

#### bildung.unterricht_ausbildung.list

Liste/Suche: Unterricht-Zuordnungen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.unterricht_ausbildung.list","input":{}}`

#### bildung.unterricht_ausbildung.get

Detail: Unterricht-Zuordnungen

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.unterricht_ausbildung.get","input":{"id":"<id>"}}`

#### bildung.unterricht_ausbildung.create

Anlegen: Unterricht-Zuordnungen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `unterricht` (string)
  - `ausbildung` (string)
- Beispiel: `{"name":"bildung.unterricht_ausbildung.create","input":{}}`

#### bildung.unterricht_ausbildung.update

Ändern: Unterricht-Zuordnungen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
- Beispiel: `{"name":"bildung.unterricht_ausbildung.update","input":{"id":"<id>"}}`

### Unterrichte: `bildung.unterricht.*`

#### bildung.unterricht.list

Liste/Suche: Unterrichte

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bildung.unterricht.list","input":{}}`

#### bildung.unterricht.get

Detail: Unterrichte

- Art: Lesen
- Rechte: BildungStammdaten lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.unterricht.get","input":{"id":"<id>"}}`

#### bildung.unterricht.create

Anlegen: Unterrichte

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `nummer` (string)
  - `beschreibung` (string)
  - `ue` (number)
  - `dauer` (number)
  - `einheit` (string)
  - `ziele` (string)
  - `handlungssituation` (string)
  - `unterrichtsformCode` (string)
  - `color` (string)
  - `badge` (string)
  - `nachweisErstellen` (boolean)
  - `statusCode` (string)
  - `modulNummer` (string): Verweis auf Modul.nummer → Modul↔Unterricht-Verknüpfung (Modul zuerst importieren)
  - `themaNummern` (string): Verweis(e) auf Thema.nummer → Unterricht↔Thema (Themen zuerst importieren)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.unterricht.create","input":{"titel":"<titel>"}}`

#### bildung.unterricht.update

Ändern: Unterrichte

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `ue` (number)
  - `dauer` (number)
  - `einheit` (string)
  - `ziele` (string)
  - `handlungssituation` (string)
  - `unterrichtsformCode` (string)
  - `color` (string)
  - `badge` (string)
  - `nachweisErstellen` (boolean)
  - `statusCode` (string)
  - `modulNummer` (string): Verweis auf Modul.nummer → Modul↔Unterricht-Verknüpfung (Modul zuerst importieren)
  - `themaNummern` (string): Verweis(e) auf Thema.nummer → Unterricht↔Thema (Themen zuerst importieren)
  - `aktiv` (boolean)
- Beispiel: `{"name":"bildung.unterricht.update","input":{"id":"<id>"}}`

#### bildung.unterricht.delete

Löschen: Unterrichte

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: BildungStammdaten löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bildung.unterricht.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.

### Abschlüsse: `bildung.abschluss.*`

#### bildung.abschluss.list

Liste/Suche: Katalog „Abschlüsse" (bildung)

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

#### bildung.abschluss.get

Detail: Katalog „Abschlüsse" (bildung)

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

#### bildung.abschluss.create

Anlegen: Katalog „Abschlüsse" (bildung)

- 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":"bildung.abschluss.create","input":{"label":"<label>"}}`

#### bildung.abschluss.update

Ändern: Katalog „Abschlüsse" (bildung)

- 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":"bildung.abschluss.update","input":{"id":"<id>"}}`

#### bildung.abschluss.delete

Löschen: Katalog „Abschlüsse" (bildung)

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

### Fallbeispiel-Kategorien: `bildung.fallbeispielKategorie.*`

#### bildung.fallbeispielKategorie.list

Liste/Suche: Katalog „Fallbeispiel-Kategorien" (bildung)

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

#### bildung.fallbeispielKategorie.get

Detail: Katalog „Fallbeispiel-Kategorien" (bildung)

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

#### bildung.fallbeispielKategorie.create

Anlegen: Katalog „Fallbeispiel-Kategorien" (bildung)

- 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":"bildung.fallbeispielKategorie.create","input":{"label":"<label>"}}`

#### bildung.fallbeispielKategorie.update

Ändern: Katalog „Fallbeispiel-Kategorien" (bildung)

- 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":"bildung.fallbeispielKategorie.update","input":{"id":"<id>"}}`

#### bildung.fallbeispielKategorie.delete

Löschen: Katalog „Fallbeispiel-Kategorien" (bildung)

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

### Klassengruppen: `bildung.klassengruppe.*`

#### bildung.klassengruppe.list

Liste/Suche: Katalog „Klassengruppen" (bildung)

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

#### bildung.klassengruppe.get

Detail: Katalog „Klassengruppen" (bildung)

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

#### bildung.klassengruppe.create

Anlegen: Katalog „Klassengruppen" (bildung)

- 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":"bildung.klassengruppe.create","input":{"label":"<label>"}}`

#### bildung.klassengruppe.update

Ändern: Katalog „Klassengruppen" (bildung)

- 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":"bildung.klassengruppe.update","input":{"id":"<id>"}}`

#### bildung.klassengruppe.delete

Löschen: Katalog „Klassengruppen" (bildung)

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

### Lernorte: `bildung.lernort.*`

#### bildung.lernort.list

Liste/Suche: Katalog „Lernorte" (bildung)

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

#### bildung.lernort.get

Detail: Katalog „Lernorte" (bildung)

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

#### bildung.lernort.create

Anlegen: Katalog „Lernorte" (bildung)

- 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":"bildung.lernort.create","input":{"label":"<label>"}}`

#### bildung.lernort.update

Ändern: Katalog „Lernorte" (bildung)

- 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":"bildung.lernort.update","input":{"id":"<id>"}}`

#### bildung.lernort.delete

Löschen: Katalog „Lernorte" (bildung)

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

### Methoden: `bildung.methode.*`

#### bildung.methode.list

Liste/Suche: Katalog „Methoden" (bildung)

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

#### bildung.methode.get

Detail: Katalog „Methoden" (bildung)

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

#### bildung.methode.create

Anlegen: Katalog „Methoden" (bildung)

- 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":"bildung.methode.create","input":{"label":"<label>"}}`

#### bildung.methode.update

Ändern: Katalog „Methoden" (bildung)

- 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":"bildung.methode.update","input":{"id":"<id>"}}`

#### bildung.methode.delete

Löschen: Katalog „Methoden" (bildung)

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

### Schüler-Status: `bildung.schuelerstatus.*`

#### bildung.schuelerstatus.list

Liste/Suche: Katalog „Schüler-Status" (bildung)

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

#### bildung.schuelerstatus.get

Detail: Katalog „Schüler-Status" (bildung)

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

#### bildung.schuelerstatus.create

Anlegen: Katalog „Schüler-Status" (bildung)

- 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":"bildung.schuelerstatus.create","input":{"label":"<label>"}}`

#### bildung.schuelerstatus.update

Ändern: Katalog „Schüler-Status" (bildung)

- 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":"bildung.schuelerstatus.update","input":{"id":"<id>"}}`

#### bildung.schuelerstatus.delete

Löschen: Katalog „Schüler-Status" (bildung)

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

### Skill-Kategorien: `bildung.skillkategorie.*`

#### bildung.skillkategorie.list

Liste/Suche: Katalog „Skill-Kategorien" (bildung)

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

#### bildung.skillkategorie.get

Detail: Katalog „Skill-Kategorien" (bildung)

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

#### bildung.skillkategorie.create

Anlegen: Katalog „Skill-Kategorien" (bildung)

- 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":"bildung.skillkategorie.create","input":{"label":"<label>"}}`

#### bildung.skillkategorie.update

Ändern: Katalog „Skill-Kategorien" (bildung)

- 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":"bildung.skillkategorie.update","input":{"id":"<id>"}}`

#### bildung.skillkategorie.delete

Löschen: Katalog „Skill-Kategorien" (bildung)

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

### Status: `bildung.status.*`

#### bildung.status.list

Liste/Suche: Katalog „Status" (bildung)

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

#### bildung.status.get

Detail: Katalog „Status" (bildung)

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

#### bildung.status.create

Anlegen: Katalog „Status" (bildung)

- 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":"bildung.status.create","input":{"label":"<label>"}}`

#### bildung.status.update

Ändern: Katalog „Status" (bildung)

- 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":"bildung.status.update","input":{"id":"<id>"}}`

#### bildung.status.delete

Löschen: Katalog „Status" (bildung)

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

### Teilnehmer-Rollen: `bildung.teilnehmerRolle.*`

#### bildung.teilnehmerRolle.list

Liste/Suche: Katalog „Teilnehmer-Rollen" (bildung)

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

#### bildung.teilnehmerRolle.get

Detail: Katalog „Teilnehmer-Rollen" (bildung)

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

#### bildung.teilnehmerRolle.create

Anlegen: Katalog „Teilnehmer-Rollen" (bildung)

- 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":"bildung.teilnehmerRolle.create","input":{"label":"<label>"}}`

#### bildung.teilnehmerRolle.update

Ändern: Katalog „Teilnehmer-Rollen" (bildung)

- 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":"bildung.teilnehmerRolle.update","input":{"id":"<id>"}}`

#### bildung.teilnehmerRolle.delete

Löschen: Katalog „Teilnehmer-Rollen" (bildung)

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

### Unterrichtsformen: `bildung.unterrichtsform.*`

#### bildung.unterrichtsform.list

Liste/Suche: Katalog „Unterrichtsformen" (bildung)

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

#### bildung.unterrichtsform.get

Detail: Katalog „Unterrichtsformen" (bildung)

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

#### bildung.unterrichtsform.create

Anlegen: Katalog „Unterrichtsformen" (bildung)

- 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":"bildung.unterrichtsform.create","input":{"label":"<label>"}}`

#### bildung.unterrichtsform.update

Ändern: Katalog „Unterrichtsformen" (bildung)

- 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":"bildung.unterrichtsform.update","input":{"id":"<id>"}}`

#### bildung.unterrichtsform.delete

Löschen: Katalog „Unterrichtsformen" (bildung)

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

### Verlaufs-Phasen: `bildung.phase.*`

#### bildung.phase.list

Liste/Suche: Katalog „Verlaufs-Phasen" (bildung)

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

#### bildung.phase.get

Detail: Katalog „Verlaufs-Phasen" (bildung)

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

#### bildung.phase.create

Anlegen: Katalog „Verlaufs-Phasen" (bildung)

- 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":"bildung.phase.create","input":{"label":"<label>"}}`

#### bildung.phase.update

Ändern: Katalog „Verlaufs-Phasen" (bildung)

- 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":"bildung.phase.update","input":{"id":"<id>"}}`

#### bildung.phase.delete

Löschen: Katalog „Verlaufs-Phasen" (bildung)

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

---

# API-Referenz Belege (App-Kennung belege)

> 46 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/belege/

## 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.

### Belege: `belege.beleg.*`

#### belege.beleg.list

Liste/Suche: Belege

- Art: Lesen
- Rechte: Beleg lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"belege.beleg.list","input":{}}`

#### belege.beleg.get

Detail: Belege

- Art: Lesen
- Rechte: Beleg lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"belege.beleg.get","input":{"id":"<id>"}}`

#### belege.beleg.create

Anlegen: Belege

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Beleg verwalten
- Datenklassen: C (vertraulich)
- Eingabe:
  - `belegtypCode` (string, Pflicht): z.B. angebot, auftrag, rechnung, lieferschein
  - `datum` (string)
  - `statusCode` (string)
  - `organisationId` (string)
  - `personId` (string)
  - `betreff` (string)
  - `liefertermin` (string)
  - `gueltigBis` (string)
  - `frist` (number)
  - `zahlungsbedingungCode` (string)
  - `lieferbedingungCode` (string)
  - `waehrung` (string)
  - `ustFrei` (boolean)
  - `ustId` (string)
  - `kopftext` (string)
  - `fusstext` (string)
  - `eroeffnungstext` (string)
  - `bemerkungen` (string)
  - `internerVermerk` (string)
  - `rabatt` (number)
  - `rabattProzent` (number)
- Beispiel: `{"name":"belege.beleg.create","input":{"belegtypCode":"<belegtypCode>"}}`

#### belege.beleg.update

Ändern: Belege

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Beleg verwalten
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `belegtypCode` (string): z.B. angebot, auftrag, rechnung, lieferschein
  - `datum` (string)
  - `statusCode` (string)
  - `organisationId` (string)
  - `personId` (string)
  - `betreff` (string)
  - `liefertermin` (string)
  - `gueltigBis` (string)
  - `frist` (number)
  - `zahlungsbedingungCode` (string)
  - `lieferbedingungCode` (string)
  - `waehrung` (string)
  - `ustFrei` (boolean)
  - `ustId` (string)
  - `kopftext` (string)
  - `fusstext` (string)
  - `eroeffnungstext` (string)
  - `bemerkungen` (string)
  - `internerVermerk` (string)
  - `rabatt` (number)
  - `rabattProzent` (number)
- Beispiel: `{"name":"belege.beleg.update","input":{"id":"<id>"}}`

#### belege.beleg.delete

Löschen: Belege

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Beleg verwalten
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"belege.beleg.delete","input":{"id":"<id>"}}`

### Belegpositionen: `belege.position.*`

#### belege.position.list

Liste/Suche: Belegpositionen

- Art: Lesen
- Rechte: Beleg lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"belege.position.list","input":{}}`

#### belege.position.create

Anlegen: Belegpositionen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Beleg verwalten
- Datenklassen: C (vertraulich)
- Eingabe:
  - `belegId` (string, Pflicht)
  - `position` (number)
  - `zeilentyp` (string): AB=Artikel, TX=Text, SP=Summe
  - `produktId` (string)
  - `produkt` (string)
  - `produktnummer` (string)
  - `menge` (number)
  - `einzelpreis` (number)
  - `rabatt` (number)
  - `rabattProzent` (number)
  - `steuersatz` (number)
  - `steuersatzCode` (string)
  - `mengeneinheit` (string)
  - `beschreibung` (string)
  - `positionstext` (string)
- Beispiel: `{"name":"belege.position.create","input":{"belegId":"<belegId>"}}`

#### belege.position.update

Ändern: Belegpositionen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Beleg verwalten
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `belegId` (string)
  - `position` (number)
  - `zeilentyp` (string): AB=Artikel, TX=Text, SP=Summe
  - `produktId` (string)
  - `produkt` (string)
  - `produktnummer` (string)
  - `menge` (number)
  - `einzelpreis` (number)
  - `rabatt` (number)
  - `rabattProzent` (number)
  - `steuersatz` (number)
  - `steuersatzCode` (string)
  - `mengeneinheit` (string)
  - `beschreibung` (string)
  - `positionstext` (string)
- Beispiel: `{"name":"belege.position.update","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.

### Belegtypen: `belege.belegtyp.*`

#### belege.belegtyp.list

Liste/Suche: Katalog „Belegtypen" (belege)

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

#### belege.belegtyp.get

Detail: Katalog „Belegtypen" (belege)

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

#### belege.belegtyp.create

Anlegen: Katalog „Belegtypen" (belege)

- 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":"belege.belegtyp.create","input":{"label":"<label>"}}`

#### belege.belegtyp.update

Ändern: Katalog „Belegtypen" (belege)

- 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":"belege.belegtyp.update","input":{"id":"<id>"}}`

#### belege.belegtyp.delete

Löschen: Katalog „Belegtypen" (belege)

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

### Lieferbedingungen: `belege.lieferbedingung.*`

#### belege.lieferbedingung.list

Liste/Suche: Katalog „Lieferbedingungen" (belege)

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

#### belege.lieferbedingung.get

Detail: Katalog „Lieferbedingungen" (belege)

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

#### belege.lieferbedingung.create

Anlegen: Katalog „Lieferbedingungen" (belege)

- 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":"belege.lieferbedingung.create","input":{"label":"<label>"}}`

#### belege.lieferbedingung.update

Ändern: Katalog „Lieferbedingungen" (belege)

- 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":"belege.lieferbedingung.update","input":{"id":"<id>"}}`

#### belege.lieferbedingung.delete

Löschen: Katalog „Lieferbedingungen" (belege)

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

### Status: `belege.status.*`

#### belege.status.list

Liste/Suche: Katalog „Status" (belege)

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

#### belege.status.get

Detail: Katalog „Status" (belege)

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

#### belege.status.create

Anlegen: Katalog „Status" (belege)

- 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":"belege.status.create","input":{"label":"<label>"}}`

#### belege.status.update

Ändern: Katalog „Status" (belege)

- 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":"belege.status.update","input":{"id":"<id>"}}`

#### belege.status.delete

Löschen: Katalog „Status" (belege)

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

### Steuersätze: `belege.steuersatz.*`

#### belege.steuersatz.list

Liste/Suche: Katalog „Steuersätze" (belege)

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

#### belege.steuersatz.get

Detail: Katalog „Steuersätze" (belege)

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

#### belege.steuersatz.create

Anlegen: Katalog „Steuersätze" (belege)

- 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":"belege.steuersatz.create","input":{"label":"<label>"}}`

#### belege.steuersatz.update

Ändern: Katalog „Steuersätze" (belege)

- 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":"belege.steuersatz.update","input":{"id":"<id>"}}`

#### belege.steuersatz.delete

Löschen: Katalog „Steuersätze" (belege)

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

### Vertriebswege: `belege.distribution.*`

#### belege.distribution.list

Liste/Suche: Katalog „Vertriebswege" (belege)

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

#### belege.distribution.get

Detail: Katalog „Vertriebswege" (belege)

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

#### belege.distribution.create

Anlegen: Katalog „Vertriebswege" (belege)

- 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":"belege.distribution.create","input":{"label":"<label>"}}`

#### belege.distribution.update

Ändern: Katalog „Vertriebswege" (belege)

- 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":"belege.distribution.update","input":{"id":"<id>"}}`

#### belege.distribution.delete

Löschen: Katalog „Vertriebswege" (belege)

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

### Vorlagen-Kategorien: `belege.vorlage_kategorie.*`

#### belege.vorlage_kategorie.list

Liste/Suche: Katalog „Vorlagen-Kategorien" (belege)

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

#### belege.vorlage_kategorie.get

Detail: Katalog „Vorlagen-Kategorien" (belege)

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

#### belege.vorlage_kategorie.create

Anlegen: Katalog „Vorlagen-Kategorien" (belege)

- 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":"belege.vorlage_kategorie.create","input":{"label":"<label>"}}`

#### belege.vorlage_kategorie.update

Ändern: Katalog „Vorlagen-Kategorien" (belege)

- 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":"belege.vorlage_kategorie.update","input":{"id":"<id>"}}`

#### belege.vorlage_kategorie.delete

Löschen: Katalog „Vorlagen-Kategorien" (belege)

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

### Zahlungsbedingungen: `belege.zahlungsbedingung.*`

#### belege.zahlungsbedingung.list

Liste/Suche: Katalog „Zahlungsbedingungen" (belege)

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

#### belege.zahlungsbedingung.get

Detail: Katalog „Zahlungsbedingungen" (belege)

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

#### belege.zahlungsbedingung.create

Anlegen: Katalog „Zahlungsbedingungen" (belege)

- 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":"belege.zahlungsbedingung.create","input":{"label":"<label>"}}`

#### belege.zahlungsbedingung.update

Ändern: Katalog „Zahlungsbedingungen" (belege)

- 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":"belege.zahlungsbedingung.update","input":{"id":"<id>"}}`

#### belege.zahlungsbedingung.delete

Löschen: Katalog „Zahlungsbedingungen" (belege)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### belege.festschreibe

Schreibt einen Beleg GoBD-fest (ab dann unveränderbar). Optional vorher PDF erzeugen.

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Beleg verwalten
- Datenklassen: C (vertraulich)
- Datenschutz: Setzt einen Beleg irreversibel auf festgeschrieben (GoBD).
- Eingabe:
  - `belegId` (string, Pflicht)
- Beispiel: `{"name":"belege.festschreibe","input":{"belegId":"<belegId>"}}`

#### belege.rechnung_aus_zeiten

Fasst die Zeitbuchungen eines Projekts (projektId) ODER aller Aufgaben eines CRM-Kontos (crmGbzId), optional im Zeitraum, zusammen und legt daraus eine Rechnung mit Positionen an (Entwurf, nicht festgeschrieben). Eines von projektId/crmGbzId ist Pflicht.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Beleg verwalten, projektsyn: Zeitbuchung lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Liest Zeitbuchungen tenant-intern + legt einen Rechnungs-Entwurf an.
- Eingabe:
  - `projektId` (string): Projekt-ID (Zeiten aller Aufgaben des Projekts)
  - `crmGbzId` (string): CRM-Konto-ID (Zeiten aller Aufgaben des Kontos), Alternative zu projektId
  - `stundensatz` (number, Pflicht): € pro Stunde
  - `von` (string): YYYY-MM-DD (optional)
  - `bis` (string): YYYY-MM-DD (optional)
  - `steuersatz` (number): Default 19
  - `betreff` (string)
- Beispiel: `{"name":"belege.rechnung_aus_zeiten","input":{"stundensatz":1}}`

#### belege.versende

Versendet einen Beleg per E-Mail über den Mailservice und legt dazu eine Mitteilung an. dryRun=true (Default) macht nur Vorschau + Mitteilung; dryRun=false versendet echt.

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Beleg verwalten
- Datenklassen: C (vertraulich)
- Datenschutz: Versendet bei dryRun=false eine E-Mail an die Beleg-Rechnungsadresse + legt eine Mitteilung an. Empfängerdaten aus dem Beleg.
- Eingabe:
  - `belegId` (string, Pflicht)
  - `dryRun` (boolean): Default true (Vorschau). false = echter Versand
  - `empfaenger` (string): E-Mail-Override (sonst aus Rechnungsadresse)
  - `betreff` (string)
  - `text` (string): HTML-Body (optional)
- Beispiel: `{"name":"belege.versende","input":{"belegId":"<belegId>"}}`

---

# API-Referenz Benutzerverwaltung (App-Kennung benutzerverwaltung)

> 3 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/benutzerverwaltung/

## 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.

### Personen / Benutzer: `benutzerverwaltung.person.*`

#### benutzerverwaltung.person.list

Liste/Suche: Personen / Benutzer

- Art: Lesen
- Rechte: Person lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"benutzerverwaltung.person.list","input":{}}`

#### benutzerverwaltung.person.get

Detail: Personen / Benutzer

- Art: Lesen
- Rechte: Person lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"benutzerverwaltung.person.get","input":{"id":"<id>"}}`

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### benutzerverwaltung.onboard

Legt eine Person an; mit E-Mail zusätzlich Login-Account + Tenant-Mitgliedschaft mit Rollen (tenant_roles.slug). invite=false (Default) provisioniert nur, invite=true versendet den Magic-Link. Idempotent auf E-Mail (existierender User wird verlinkt). Admin-Rollen sind gesperrt. Für Bulk-Onboarding je Kunde.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Benutzer anlegen
- Datenklassen: C (vertraulich)
- Datenschutz: Legt personenbezogene Stammdaten + Login-Account tenant-isoliert an. Rollen werden nur gesetzt, Admin-Rollen sind gesperrt (Privilege-Escalation-Schutz).
- Eingabe:
  - `vorname` (string, Pflicht)
  - `nachname` (string, Pflicht)
  - `email` (string): E-Mail für den Login-Account. Ohne E-Mail wird nur eine Person (Stammdaten) angelegt
  - `rollen` (string[]): Rollen-Slugs (tenant_roles.slug), Mehrfachauswahl. Admin-Rollen werden abgelehnt
  - `invite` (boolean): true = Magic-Link (Einladung) sofort versenden. Default false = nur Konto anlegen
  - `mitLogin` (boolean): Login-Account anlegen. Default true wenn E-Mail vorhanden
  - `anrede` (string)
  - `titel` (string)
  - `telefon` (string)
  - `mobil` (string)
- Beispiel: `{"name":"benutzerverwaltung.onboard","input":{"vorname":"<vorname>","nachname":"<nachname>"}}`

---

# API-Referenz Bewerber (App-Kennung bewerber)

> 36 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/bewerber/

## 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.

### Bewerber: `bewerber.bewerber.*`

#### bewerber.bewerber.list

Liste/Suche: Bewerber

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

#### bewerber.bewerber.get

Detail: Bewerber

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

#### bewerber.bewerber.create

Anlegen: Bewerber

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `vorname` (string)
  - `nachname` (string, Pflicht)
  - `email` (string)
  - `telefon` (string)
  - `mobil` (string)
  - `geburtsdatum` (string)
  - `anrede` (string)
  - `titel` (string)
  - `statusCode` (string)
  - `stelleId` (string)
  - `bewerbertypCode` (string)
  - `gewuenschterBeginn` (string)
  - `gueltigBis` (string)
  - `gehaltsvorstellung` (number)
  - `bewertung` (number)
  - `kosten` (number)
  - `ablehnungsgrundCode` (string)
  - `ablehnungsfreitext` (string)
  - `bemerkung` (string)
  - `standort` (string)
  - `fachbereich` (string)
  - `funktion` (string)
  - `eingangsdatum` (string)
- Beispiel: `{"name":"bewerber.bewerber.create","input":{"nachname":"<nachname>"}}`

#### bewerber.bewerber.update

Ändern: Bewerber

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `vorname` (string)
  - `nachname` (string)
  - `email` (string)
  - `telefon` (string)
  - `mobil` (string)
  - `geburtsdatum` (string)
  - `anrede` (string)
  - `titel` (string)
  - `statusCode` (string)
  - `stelleId` (string)
  - `bewerbertypCode` (string)
  - `gewuenschterBeginn` (string)
  - `gueltigBis` (string)
  - `gehaltsvorstellung` (number)
  - `bewertung` (number)
  - `kosten` (number)
  - `ablehnungsgrundCode` (string)
  - `ablehnungsfreitext` (string)
  - `bemerkung` (string)
  - `standort` (string)
  - `fachbereich` (string)
  - `funktion` (string)
  - `eingangsdatum` (string)
- Beispiel: `{"name":"bewerber.bewerber.update","input":{"id":"<id>"}}`

#### bewerber.bewerber.delete

Löschen: Bewerber

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

### Stellen: `bewerber.stelle.*`

#### bewerber.stelle.list

Liste/Suche: Stellen

- Art: Lesen
- Rechte: Bewerber lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bewerber.stelle.list","input":{}}`

#### bewerber.stelle.get

Detail: Stellen

- Art: Lesen
- Rechte: Bewerber lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bewerber.stelle.get","input":{"id":"<id>"}}`

#### bewerber.stelle.create

Anlegen: Stellen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `nummer` (string)
  - `beschreibung` (string)
  - `fachbereich` (string)
  - `standort` (string)
  - `statusCode` (string)
  - `gueltigAb` (string)
  - `gueltigBis` (string)
- Beispiel: `{"name":"bewerber.stelle.create","input":{"titel":"<titel>"}}`

#### bewerber.stelle.update

Ändern: Stellen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `nummer` (string)
  - `beschreibung` (string)
  - `fachbereich` (string)
  - `standort` (string)
  - `statusCode` (string)
  - `gueltigAb` (string)
  - `gueltigBis` (string)
- Beispiel: `{"name":"bewerber.stelle.update","input":{"id":"<id>"}}`

#### bewerber.stelle.delete

Löschen: Stellen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bewerber.stelle.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.

### Ablehnungsgründe: `bewerber.ablehnungsgrund.*`

#### bewerber.ablehnungsgrund.list

Liste/Suche: Katalog „Ablehnungsgründe" (bewerber)

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

#### bewerber.ablehnungsgrund.get

Detail: Katalog „Ablehnungsgründe" (bewerber)

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

#### bewerber.ablehnungsgrund.create

Anlegen: Katalog „Ablehnungsgründe" (bewerber)

- 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":"bewerber.ablehnungsgrund.create","input":{"label":"<label>"}}`

#### bewerber.ablehnungsgrund.update

Ändern: Katalog „Ablehnungsgründe" (bewerber)

- 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":"bewerber.ablehnungsgrund.update","input":{"id":"<id>"}}`

#### bewerber.ablehnungsgrund.delete

Löschen: Katalog „Ablehnungsgründe" (bewerber)

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

### Bewerbertypen: `bewerber.typ.*`

#### bewerber.typ.list

Liste/Suche: Katalog „Bewerbertypen" (bewerber)

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

#### bewerber.typ.get

Detail: Katalog „Bewerbertypen" (bewerber)

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

#### bewerber.typ.create

Anlegen: Katalog „Bewerbertypen" (bewerber)

- 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":"bewerber.typ.create","input":{"label":"<label>"}}`

#### bewerber.typ.update

Ändern: Katalog „Bewerbertypen" (bewerber)

- 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":"bewerber.typ.update","input":{"id":"<id>"}}`

#### bewerber.typ.delete

Löschen: Katalog „Bewerbertypen" (bewerber)

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

### Kanaltypen: `bewerber.kanaltyp.*`

#### bewerber.kanaltyp.list

Liste/Suche: Katalog „Kanaltypen" (bewerber)

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

#### bewerber.kanaltyp.get

Detail: Katalog „Kanaltypen" (bewerber)

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

#### bewerber.kanaltyp.create

Anlegen: Katalog „Kanaltypen" (bewerber)

- 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":"bewerber.kanaltyp.create","input":{"label":"<label>"}}`

#### bewerber.kanaltyp.update

Ändern: Katalog „Kanaltypen" (bewerber)

- 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":"bewerber.kanaltyp.update","input":{"id":"<id>"}}`

#### bewerber.kanaltyp.delete

Löschen: Katalog „Kanaltypen" (bewerber)

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

### Status (Pipeline): `bewerber.status.*`

#### bewerber.status.list

Liste/Suche: Katalog „Status (Pipeline)" (bewerber)

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

#### bewerber.status.get

Detail: Katalog „Status (Pipeline)" (bewerber)

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

#### bewerber.status.create

Anlegen: Katalog „Status (Pipeline)" (bewerber)

- 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":"bewerber.status.create","input":{"label":"<label>"}}`

#### bewerber.status.update

Ändern: Katalog „Status (Pipeline)" (bewerber)

- 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":"bewerber.status.update","input":{"id":"<id>"}}`

#### bewerber.status.delete

Löschen: Katalog „Status (Pipeline)" (bewerber)

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

### Stellenstatus: `bewerber.stellestatus.*`

#### bewerber.stellestatus.list

Liste/Suche: Katalog „Stellenstatus" (bewerber)

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

#### bewerber.stellestatus.get

Detail: Katalog „Stellenstatus" (bewerber)

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

#### bewerber.stellestatus.create

Anlegen: Katalog „Stellenstatus" (bewerber)

- 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":"bewerber.stellestatus.create","input":{"label":"<label>"}}`

#### bewerber.stellestatus.update

Ändern: Katalog „Stellenstatus" (bewerber)

- 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":"bewerber.stellestatus.update","input":{"id":"<id>"}}`

#### bewerber.stellestatus.delete

Löschen: Katalog „Stellenstatus" (bewerber)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### bewerber.einstellen

Stellt einen Bewerber ein: legt (idempotent) einen Mitarbeiter im Personal-Modul an und markiert den Bewerber als eingestellt.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Übernimmt die Person des Bewerbers als Mitarbeiter (festangestellt/Probezeit). Cross-Modul-Schreibvorgang ins Personal-Modul.
- Eingabe:
  - `id` (string, Pflicht): Bewerber-ID
- Beispiel: `{"name":"bewerber.einstellen","input":{"id":"<id>"}}`

---

# API-Referenz Charts (App-Kennung reporting)

> 7 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/reporting/

## 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.

### Reports: `reporting.report.*`

#### reporting.report.list

Liste/Suche: Reports

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

#### reporting.report.get

Detail: Reports

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

#### reporting.report.create

Anlegen: Reports

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Report anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `titel` (string, Pflicht)
  - `beschreibung` (string)
  - `kategorie` (string)
  - `icon` (string)
  - `entitaetId` (string, Pflicht)
  - `chartType` (string): Werte: `bar`, `line`, `area`, `pie`, `donut`, `stacked_bar`, `kpi`, `gauge`, `funnel`, `radar`, `scatter`, `heatmap`, `pivot_table`
  - `sort` (number)
  - `aktiv` (boolean)
- Beispiel: `{"name":"reporting.report.create","input":{"titel":"<titel>","entitaetId":"<entitaetId>"}}`

#### reporting.report.update

Ändern: Reports

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Report ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `kategorie` (string)
  - `icon` (string)
  - `entitaetId` (string)
  - `chartType` (string): Werte: `bar`, `line`, `area`, `pie`, `donut`, `stacked_bar`, `kpi`, `gauge`, `funnel`, `radar`, `scatter`, `heatmap`, `pivot_table`
  - `sort` (number)
  - `aktiv` (boolean)
- Beispiel: `{"name":"reporting.report.update","input":{"id":"<id>"}}`

#### reporting.report.delete

Löschen: Reports

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### reporting.list_reports

Listet alle aktiven Reports der Tenant

- Art: Lesen
- Rechte: Report lesen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Liefert Report-Metadaten, keine Rohdaten.
- Eingabe:
  - `kategorie` (string)
- Beispiel: `{"name":"reporting.list_reports","input":{}}`

#### reporting.run_report

Fuehrt einen Report aus und gibt die aggregierten Daten zurueck

- Art: Lesen
- Rechte: Report lesen, Query anlegen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Fuehrt nur registrierte Reports aus. Datenklasse haengt vom angebundenen Datenobjekt ab.
- Eingabe:
  - `reportId` (string, Pflicht)
- Beispiel: `{"name":"reporting.run_report","input":{"reportId":"<reportId>"}}`

---

# API-Referenz Datenintegration (App-Kennung datenintegration)

> 2 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/datenintegration/

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### datenintegration.import

Importiert Zeilen (rows) in ein registriertes Datenobjekt, mit Dedup über identity-Felder. dryRun=true (Default) prüft nur. mode=insert (nur neu) oder upsert (anlegen/aktualisieren). Resource-IDs via list_resources.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Datenintegration anlegen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Schreibt Fachdaten tenant-isoliert über die jeweilige Resource. Resource-eigene Datenklasse + Schreibsperre (z.B. Klasse D) gelten weiter.
- Eingabe:
  - `resource` (string, Pflicht): Resource-ID, z.B. "bildung.thema" oder "crm.konto"
  - `rows` (object[], Pflicht): Daten-Zeilen als Objekte { feldKey: wert } gemäß den Feldern der Resource
  - `mode` (string): insert = nur Neuanlage (vorhandene überspringen) · upsert = anlegen oder aktualisieren. Werte: `insert`, `upsert`
  - `dryRun` (boolean): true (Default) = nur prüfen, nichts schreiben. false = wirklich importieren
- Beispiel: `{"name":"datenintegration.import","input":{"resource":"<resource>","rows":[]}}`

#### datenintegration.list_resources

Listet alle importier-/exportierbaren Datenobjekte (Resource-ID, Felder, Datenklasse, importierbar?). Discovery vor dem Import.

- Art: Lesen
- Rechte: Datenintegration lesen
- Datenklassen: A (öffentlich)
- Eingabe:
  - `module` (string): Optionaler Filter auf einen Modul-Slug, z.B. "bildung"
- Beispiel: `{"name":"datenintegration.list_resources","input":{}}`

---

# API-Referenz Fehlzeiten (App-Kennung fehlzeit)

> 20 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/fehlzeit/

## 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.

### Fehlzeit-Kategorien: `fehlzeit.kategorie.*`

#### fehlzeit.kategorie.list

Liste/Suche: Katalog „Fehlzeit-Kategorien" (fehlzeit)

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

#### fehlzeit.kategorie.get

Detail: Katalog „Fehlzeit-Kategorien" (fehlzeit)

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

#### fehlzeit.kategorie.create

Anlegen: Katalog „Fehlzeit-Kategorien" (fehlzeit)

- 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":"fehlzeit.kategorie.create","input":{"label":"<label>"}}`

#### fehlzeit.kategorie.update

Ändern: Katalog „Fehlzeit-Kategorien" (fehlzeit)

- 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":"fehlzeit.kategorie.update","input":{"id":"<id>"}}`

#### fehlzeit.kategorie.delete

Löschen: Katalog „Fehlzeit-Kategorien" (fehlzeit)

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

### Intervalle: `fehlzeit.intervall.*`

#### fehlzeit.intervall.list

Liste/Suche: Katalog „Intervalle" (fehlzeit)

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

#### fehlzeit.intervall.get

Detail: Katalog „Intervalle" (fehlzeit)

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

#### fehlzeit.intervall.create

Anlegen: Katalog „Intervalle" (fehlzeit)

- 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":"fehlzeit.intervall.create","input":{"label":"<label>"}}`

#### fehlzeit.intervall.update

Ändern: Katalog „Intervalle" (fehlzeit)

- 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":"fehlzeit.intervall.update","input":{"id":"<id>"}}`

#### fehlzeit.intervall.delete

Löschen: Katalog „Intervalle" (fehlzeit)

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

### Status: `fehlzeit.status.*`

#### fehlzeit.status.list

Liste/Suche: Katalog „Status" (fehlzeit)

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

#### fehlzeit.status.get

Detail: Katalog „Status" (fehlzeit)

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

#### fehlzeit.status.create

Anlegen: Katalog „Status" (fehlzeit)

- 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":"fehlzeit.status.create","input":{"label":"<label>"}}`

#### fehlzeit.status.update

Ändern: Katalog „Status" (fehlzeit)

- 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":"fehlzeit.status.update","input":{"id":"<id>"}}`

#### fehlzeit.status.delete

Löschen: Katalog „Status" (fehlzeit)

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

### Urlaubsarten: `fehlzeit.urlaubsart.*`

#### fehlzeit.urlaubsart.list

Liste/Suche: Katalog „Urlaubsarten" (fehlzeit)

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

#### fehlzeit.urlaubsart.get

Detail: Katalog „Urlaubsarten" (fehlzeit)

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

#### fehlzeit.urlaubsart.create

Anlegen: Katalog „Urlaubsarten" (fehlzeit)

- 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":"fehlzeit.urlaubsart.create","input":{"label":"<label>"}}`

#### fehlzeit.urlaubsart.update

Ändern: Katalog „Urlaubsarten" (fehlzeit)

- 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":"fehlzeit.urlaubsart.update","input":{"id":"<id>"}}`

#### fehlzeit.urlaubsart.delete

Löschen: Katalog „Urlaubsarten" (fehlzeit)

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

---

# API-Referenz Gebäudemanagement (App-Kennung ressource)

> 18 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/ressource/

## 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.

### Prüfregeln (Gebäudemanagement): `ressource.pruefregel.*`

#### ressource.pruefregel.list

Liste/Suche: Prüfregeln (Gebäudemanagement)

- Art: Lesen
- Rechte: Raum lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"ressource.pruefregel.list","input":{}}`

#### ressource.pruefregel.get

Detail: Prüfregeln (Gebäudemanagement)

- Art: Lesen
- Rechte: Raum lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"ressource.pruefregel.get","input":{"id":"<id>"}}`

#### ressource.pruefregel.create

Anlegen: Prüfregeln (Gebäudemanagement)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `ausstattungCode` (string, Pflicht)
  - `pruefartCode` (string, Pflicht)
  - `intervallMonate` (number)
  - `rechtsgrundlage` (string)
  - `hinweis` (string)
- Beispiel: `{"name":"ressource.pruefregel.create","input":{"ausstattungCode":"<ausstattungCode>","pruefartCode":"<pruefartCode>"}}`

#### ressource.pruefregel.update

Ändern: Prüfregeln (Gebäudemanagement)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `ausstattungCode` (string)
  - `pruefartCode` (string)
  - `intervallMonate` (number)
  - `rechtsgrundlage` (string)
  - `hinweis` (string)
- Beispiel: `{"name":"ressource.pruefregel.update","input":{"id":"<id>"}}`

#### ressource.pruefregel.delete

Löschen: Prüfregeln (Gebäudemanagement)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"ressource.pruefregel.delete","input":{"id":"<id>"}}`

### Raum-Belegungen (Gebäudemanagement): `ressource.belegung.*`

#### ressource.belegung.list

Liste/Suche: Raum-Belegungen (Gebäudemanagement)

- Art: Lesen
- Rechte: Raum lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"ressource.belegung.list","input":{}}`

#### ressource.belegung.get

Detail: Raum-Belegungen (Gebäudemanagement)

- Art: Lesen
- Rechte: Raum lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"ressource.belegung.get","input":{"id":"<id>"}}`

#### ressource.belegung.create

Anlegen: Raum-Belegungen (Gebäudemanagement)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `raumId` (string, Pflicht)
  - `von` (string, Pflicht)
  - `bis` (string, Pflicht)
  - `titel` (string)
  - `bemerkung` (string)
  - `anzahl` (number)
- Beispiel: `{"name":"ressource.belegung.create","input":{"raumId":"<raumId>","von":"<von>","bis":"<bis>"}}`

#### ressource.belegung.update

Ändern: Raum-Belegungen (Gebäudemanagement)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `raumId` (string)
  - `von` (string)
  - `bis` (string)
  - `titel` (string)
  - `bemerkung` (string)
  - `anzahl` (number)
- Beispiel: `{"name":"ressource.belegung.update","input":{"id":"<id>"}}`

#### ressource.belegung.delete

Löschen: Raum-Belegungen (Gebäudemanagement)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"ressource.belegung.delete","input":{"id":"<id>"}}`

### Räume (Gebäudemanagement): `ressource.raum.*`

#### ressource.raum.list

Liste/Suche: Räume (Gebäudemanagement)

- Art: Lesen
- Rechte: Raum lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"ressource.raum.list","input":{}}`

#### ressource.raum.get

Detail: Räume (Gebäudemanagement)

- Art: Lesen
- Rechte: Raum lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"ressource.raum.get","input":{"id":"<id>"}}`

#### ressource.raum.create

Anlegen: Räume (Gebäudemanagement)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `nummer` (string)
  - `standortId` (string)
  - `kapazitaet` (number)
  - `groesseQm` (number)
  - `bestuhlung` (string)
  - `bemerkung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"ressource.raum.create","input":{"titel":"<titel>"}}`

#### ressource.raum.update

Ändern: Räume (Gebäudemanagement)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `nummer` (string)
  - `standortId` (string)
  - `kapazitaet` (number)
  - `groesseQm` (number)
  - `bestuhlung` (string)
  - `bemerkung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"ressource.raum.update","input":{"id":"<id>"}}`

### Standorte (Gebäudemanagement): `ressource.standort.*`

#### ressource.standort.list

Liste/Suche: Standorte (Gebäudemanagement)

- Art: Lesen
- Rechte: Raum lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"ressource.standort.list","input":{}}`

#### ressource.standort.get

Detail: Standorte (Gebäudemanagement)

- Art: Lesen
- Rechte: Raum lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"ressource.standort.get","input":{"id":"<id>"}}`

#### ressource.standort.create

Anlegen: Standorte (Gebäudemanagement)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `name` (string, Pflicht)
  - `kuerzel` (string)
  - `organisationId` (string)
  - `bemerkung` (string)
  - `aktiv` (boolean)
  - `strasse` (string)
  - `hausnummer` (string)
  - `plz` (string)
  - `ort` (string)
  - `land` (string)
- Beispiel: `{"name":"ressource.standort.create","input":{"name":"<name>"}}`

#### ressource.standort.update

Ändern: Standorte (Gebäudemanagement)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Raum ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `name` (string)
  - `kuerzel` (string)
  - `organisationId` (string)
  - `bemerkung` (string)
  - `aktiv` (boolean)
  - `strasse` (string)
  - `hausnummer` (string)
  - `plz` (string)
  - `ort` (string)
  - `land` (string)
- Beispiel: `{"name":"ressource.standort.update","input":{"id":"<id>"}}`

---

# API-Referenz Inbox (App-Kennung mitteilungen)

> 1 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/mitteilungen/

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### mitteilungen.send

Sendet eine Chat-Nachricht an einen User des Tenants (löst Push aus). Absender ist der ausführende User, sofern "from" nicht gesetzt ist.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Mitteilung senden
- Datenklassen: B (intern)
- Datenschutz: Sendet eine Chat-Nachricht zwischen Tenant-Usern. Freitext wird nicht in Audit-Details gespeichert.
- Eingabe:
  - `to` (string, Pflicht): Empfänger: User-ID oder E-Mail (muss Tenant-Mitglied sein)
  - `body` (string, Pflicht): Nachrichtentext
  - `from` (string): Optional: Absender (User-ID/E-Mail). Default = ausführender User
- Beispiel: `{"name":"mitteilungen.send","input":{"to":"<to>","body":"<body>"}}`

---

# API-Referenz Kontakte (App-Kennung crm)

> 199 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/crm/

## 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.

### Anrufe (CRM): `crm.anruf.*`

#### crm.anruf.list

Liste/Suche: Anrufe (CRM)

- Art: Lesen
- Rechte: Anruf lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"crm.anruf.list","input":{}}`

### Kontakte (CRM): `crm.kontakt.*`

#### crm.kontakt.list

Liste/Suche: Kontakte (CRM)

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"crm.kontakt.list","input":{}}`

#### crm.kontakt.get

Detail: Kontakte (CRM)

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"crm.kontakt.get","input":{"id":"<id>"}}`

#### crm.kontakt.create

Anlegen: Kontakte (CRM)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `kontoNummer` (string): Verweis auf crm.konto.nummer (optional; wenn angegeben, muss das Konto existieren). Leer = eigenständiger Kontakt ohne Firma
  - `email` (string): Dedup-Schlüssel (wenn vorhanden). Über update korrigierbar
  - `anrede` (string)
  - `vorname` (string)
  - `nachname` (string)
  - `funktion` (string)
  - `abteilung` (string)
  - `telefon` (string)
  - `mobil` (string)
  - `kontaktart` (string)
  - `bemerkung` (string)
  - `idQuelle` (string): Original-ID aus Altsystem (Datensatzkennung) → Person-Kern intrexxSourceId; präziser Dedup-/Auflöse-Schlüssel
- Beispiel: `{"name":"crm.kontakt.create","input":{}}`

#### crm.kontakt.update

Ändern: Kontakte (CRM)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Kontakt ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `kontoNummer` (string): Verweis auf crm.konto.nummer (optional; wenn angegeben, muss das Konto existieren). Leer = eigenständiger Kontakt ohne Firma
  - `email` (string): Dedup-Schlüssel (wenn vorhanden). Über update korrigierbar
  - `anrede` (string)
  - `vorname` (string)
  - `nachname` (string)
  - `funktion` (string)
  - `abteilung` (string)
  - `telefon` (string)
  - `mobil` (string)
  - `kontaktart` (string)
  - `bemerkung` (string)
- Beispiel: `{"name":"crm.kontakt.update","input":{"id":"<id>"}}`

#### crm.kontakt.delete

Löschen: Kontakte (CRM)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Kontakt löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"crm.kontakt.delete","input":{"id":"<id>"}}`

### Konten (CRM): `crm.konto.*`

#### crm.konto.list

Liste/Suche: Konten (CRM)

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"crm.konto.list","input":{}}`

#### crm.konto.get

Detail: Konten (CRM)

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"crm.konto.get","input":{"id":"<id>"}}`

#### crm.konto.create

Anlegen: Konten (CRM)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `nummer` (string): Natürlicher Schlüssel für Dedup
  - `name` (string, Pflicht)
  - `gbzTyp` (string): Werte: `firma`, `person`
  - `art` (string)
  - `email` (string)
  - `telefon` (string)
  - `mobil` (string)
  - `url` (string)
  - `strasse` (string)
  - `plz` (string)
  - `ort` (string)
  - `land` (string)
  - `bundesland` (string): Code aus core.bundesland, z.B. he. Ein Klarname wie Hessen wird beim Schreiben auf den Code übersetzt. Filterbar über crm_konto_list filters.bundesland (Code, Klarname oder Komma-Liste)
  - `branche` (string)
  - `bemerkung` (string)
  - `lifecycleStage` (string): Tenantbezogener Code aus crm.lifecycle_stage; Capture-Import setzt lead
  - `leadStatus` (string): Capture-Import setzt zu_pruefen (Nachbearbeiten)
- Beispiel: `{"name":"crm.konto.create","input":{"name":"<name>"}}`

#### crm.konto.update

Ändern: Konten (CRM)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `name` (string)
  - `gbzTyp` (string): Werte: `firma`, `person`
  - `art` (string)
  - `email` (string)
  - `telefon` (string)
  - `mobil` (string)
  - `url` (string)
  - `strasse` (string)
  - `plz` (string)
  - `ort` (string)
  - `land` (string)
  - `bundesland` (string): Code aus core.bundesland, z.B. he. Ein Klarname wie Hessen wird beim Schreiben auf den Code übersetzt. Filterbar über crm_konto_list filters.bundesland (Code, Klarname oder Komma-Liste)
  - `branche` (string)
  - `bemerkung` (string)
  - `lifecycleStage` (string): Tenantbezogener Code aus crm.lifecycle_stage; Capture-Import setzt lead
  - `leadStatus` (string): Capture-Import setzt zu_pruefen (Nachbearbeiten)
- Beispiel: `{"name":"crm.konto.update","input":{"id":"<id>"}}`

### Kundenobjekte: `crm.objekt.*`

#### crm.objekt.list

Liste/Suche: Kundenobjekte

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

#### crm.objekt.get

Detail: Kundenobjekte

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

#### crm.objekt.create

Anlegen: Kundenobjekte

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Objekt anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `kontoId` (string, Pflicht)
  - `nummer` (string)
  - `name` (string, Pflicht)
  - `art` (string)
  - `strasse` (string)
  - `hausnummer` (string)
  - `plz` (string)
  - `ort` (string)
  - `land` (string)
  - `bundesland` (string)
  - `latitude` (number)
  - `longitude` (number)
  - `info` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"crm.objekt.create","input":{"kontoId":"<kontoId>","name":"<name>"}}`

#### crm.objekt.update

Ändern: Kundenobjekte

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Objekt ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `kontoId` (string)
  - `nummer` (string)
  - `name` (string)
  - `art` (string)
  - `strasse` (string)
  - `hausnummer` (string)
  - `plz` (string)
  - `ort` (string)
  - `land` (string)
  - `bundesland` (string)
  - `latitude` (number)
  - `longitude` (number)
  - `info` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"crm.objekt.update","input":{"id":"<id>"}}`

#### crm.objekt.delete

Löschen: Kundenobjekte

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

### Links (CRM): `crm.link.*`

#### crm.link.list

Liste/Suche: Links (CRM)

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"crm.link.list","input":{}}`

#### crm.link.get

Detail: Links (CRM)

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"crm.link.get","input":{"id":"<id>"}}`

#### crm.link.create

Anlegen: Links (CRM)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `kontoNummer` (string): Owner = Konto (crm.konto.nummer). Alternativ kontaktQuelle/kontaktEmail für Kontakt-Owner
  - `kontaktQuelle` (string): Owner = Kontakt: Quell-Kennung (Person intrexxSourceId)
  - `kontaktEmail` (string): Owner = Kontakt: Fallback-Auflösung über E-Mail
  - `typ` (string): Link-Typ (Default: website). Werte: `linkedin`, `xing`, `website`, `instagram`, `facebook`, `xtwitter`, `youtube`, `sonstige`
  - `url` (string, Pflicht)
  - `label` (string)
  - `idQuelle` (string): Dedup-Schlüssel für idempotenten Re-Import (→ crm_link.intrexxSourceId)
- Beispiel: `{"name":"crm.link.create","input":{"url":"<url>"}}`

### Potenziale / Deals (CRM): `crm.potenzial.*`

#### crm.potenzial.list

Liste/Suche: Potenziale / Deals (CRM)

- Art: Lesen
- Rechte: Potenzial lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"crm.potenzial.list","input":{}}`

#### crm.potenzial.get

Detail: Potenziale / Deals (CRM)

- Art: Lesen
- Rechte: Potenzial lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"crm.potenzial.get","input":{"id":"<id>"}}`

#### crm.potenzial.create

Anlegen: Potenziale / Deals (CRM)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Potenzial anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `kontoNummer` (string, Pflicht): Verweis auf crm.konto.nummer, der Deal hängt an diesem Konto (muss existieren)
  - `bezeichnung` (string, Pflicht): Name des Deals/Potenzials
  - `leadStatus` (string): Deal-Pipeline-Stufe (Default: lead). Werte: `lead`, `qualifiziert`, `angebot`, `verhandlung`, `gewonnen`, `verloren`
  - `potential` (number): Geschätztes Volumen in Euro
  - `qualitaet` (number): Abschlusswahrscheinlichkeit 0-100
  - `bereich` (string)
  - `bemerkung` (string)
- Beispiel: `{"name":"crm.potenzial.create","input":{"kontoNummer":"<kontoNummer>","bezeichnung":"<bezeichnung>"}}`

#### crm.potenzial.update

Ändern: Potenziale / Deals (CRM)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Potenzial ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `kontoNummer` (string): Verweis auf crm.konto.nummer, der Deal hängt an diesem Konto (muss existieren)
  - `bezeichnung` (string): Name des Deals/Potenzials
  - `leadStatus` (string): Deal-Pipeline-Stufe (Default: lead). Werte: `lead`, `qualifiziert`, `angebot`, `verhandlung`, `gewonnen`, `verloren`
  - `potential` (number): Geschätztes Volumen in Euro
  - `qualitaet` (number): Abschlusswahrscheinlichkeit 0-100
  - `bereich` (string)
  - `bemerkung` (string)
- Beispiel: `{"name":"crm.potenzial.update","input":{"id":"<id>"}}`

#### crm.potenzial.delete

Löschen: Potenziale / Deals (CRM)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Potenzial löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"crm.potenzial.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.

### Abteilungen: `crm.abteilung.*`

#### crm.abteilung.list

Liste/Suche: Katalog „Abteilungen" (crm)

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

#### crm.abteilung.get

Detail: Katalog „Abteilungen" (crm)

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

#### crm.abteilung.create

Anlegen: Katalog „Abteilungen" (crm)

- 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":"crm.abteilung.create","input":{"label":"<label>"}}`

#### crm.abteilung.update

Ändern: Katalog „Abteilungen" (crm)

- 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":"crm.abteilung.update","input":{"id":"<id>"}}`

#### crm.abteilung.delete

Löschen: Katalog „Abteilungen" (crm)

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

### Bereiche: `crm.bereich.*`

#### crm.bereich.list

Liste/Suche: Katalog „Bereiche" (crm)

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

#### crm.bereich.get

Detail: Katalog „Bereiche" (crm)

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

#### crm.bereich.create

Anlegen: Katalog „Bereiche" (crm)

- 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":"crm.bereich.create","input":{"label":"<label>"}}`

#### crm.bereich.update

Ändern: Katalog „Bereiche" (crm)

- 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":"crm.bereich.update","input":{"id":"<id>"}}`

#### crm.bereich.delete

Löschen: Katalog „Bereiche" (crm)

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

### Beziehungsstatus: `crm.beziehungsstatus.*`

#### crm.beziehungsstatus.list

Liste/Suche: Katalog „Beziehungsstatus" (crm)

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

#### crm.beziehungsstatus.get

Detail: Katalog „Beziehungsstatus" (crm)

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

#### crm.beziehungsstatus.create

Anlegen: Katalog „Beziehungsstatus" (crm)

- 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":"crm.beziehungsstatus.create","input":{"label":"<label>"}}`

#### crm.beziehungsstatus.update

Ändern: Katalog „Beziehungsstatus" (crm)

- 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":"crm.beziehungsstatus.update","input":{"id":"<id>"}}`

#### crm.beziehungsstatus.delete

Löschen: Katalog „Beziehungsstatus" (crm)

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

### Branchen: `crm.branche.*`

#### crm.branche.list

Liste/Suche: Katalog „Branchen" (crm)

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

#### crm.branche.get

Detail: Katalog „Branchen" (crm)

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

#### crm.branche.create

Anlegen: Katalog „Branchen" (crm)

- 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":"crm.branche.create","input":{"label":"<label>"}}`

#### crm.branche.update

Ändern: Katalog „Branchen" (crm)

- 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":"crm.branche.update","input":{"id":"<id>"}}`

#### crm.branche.delete

Löschen: Katalog „Branchen" (crm)

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

### Buying-Rolle: `crm.buying_rolle.*`

#### crm.buying_rolle.list

Liste/Suche: Katalog „Buying-Rolle" (crm)

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

#### crm.buying_rolle.get

Detail: Katalog „Buying-Rolle" (crm)

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

#### crm.buying_rolle.create

Anlegen: Katalog „Buying-Rolle" (crm)

- 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":"crm.buying_rolle.create","input":{"label":"<label>"}}`

#### crm.buying_rolle.update

Ändern: Katalog „Buying-Rolle" (crm)

- 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":"crm.buying_rolle.update","input":{"id":"<id>"}}`

#### crm.buying_rolle.delete

Löschen: Katalog „Buying-Rolle" (crm)

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

### Datenherkunft: `crm.datenherkunft.*`

#### crm.datenherkunft.list

Liste/Suche: Katalog „Datenherkunft" (crm)

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

#### crm.datenherkunft.get

Detail: Katalog „Datenherkunft" (crm)

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

#### crm.datenherkunft.create

Anlegen: Katalog „Datenherkunft" (crm)

- 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":"crm.datenherkunft.create","input":{"label":"<label>"}}`

#### crm.datenherkunft.update

Ändern: Katalog „Datenherkunft" (crm)

- 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":"crm.datenherkunft.update","input":{"id":"<id>"}}`

#### crm.datenherkunft.delete

Löschen: Katalog „Datenherkunft" (crm)

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

### Fachrichtungen: `crm.fachrichtung.*`

#### crm.fachrichtung.list

Liste/Suche: Katalog „Fachrichtungen" (crm)

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

#### crm.fachrichtung.get

Detail: Katalog „Fachrichtungen" (crm)

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

#### crm.fachrichtung.create

Anlegen: Katalog „Fachrichtungen" (crm)

- 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":"crm.fachrichtung.create","input":{"label":"<label>"}}`

#### crm.fachrichtung.update

Ändern: Katalog „Fachrichtungen" (crm)

- 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":"crm.fachrichtung.update","input":{"id":"<id>"}}`

#### crm.fachrichtung.delete

Löschen: Katalog „Fachrichtungen" (crm)

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

### Funktionen: `crm.funktion.*`

#### crm.funktion.list

Liste/Suche: Katalog „Funktionen" (crm)

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

#### crm.funktion.get

Detail: Katalog „Funktionen" (crm)

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

#### crm.funktion.create

Anlegen: Katalog „Funktionen" (crm)

- 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":"crm.funktion.create","input":{"label":"<label>"}}`

#### crm.funktion.update

Ändern: Katalog „Funktionen" (crm)

- 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":"crm.funktion.update","input":{"id":"<id>"}}`

#### crm.funktion.delete

Löschen: Katalog „Funktionen" (crm)

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

### Kommunikationsstil: `crm.kommunikationsstil.*`

#### crm.kommunikationsstil.list

Liste/Suche: Katalog „Kommunikationsstil" (crm)

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

#### crm.kommunikationsstil.get

Detail: Katalog „Kommunikationsstil" (crm)

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

#### crm.kommunikationsstil.create

Anlegen: Katalog „Kommunikationsstil" (crm)

- 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":"crm.kommunikationsstil.create","input":{"label":"<label>"}}`

#### crm.kommunikationsstil.update

Ändern: Katalog „Kommunikationsstil" (crm)

- 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":"crm.kommunikationsstil.update","input":{"id":"<id>"}}`

#### crm.kommunikationsstil.delete

Löschen: Katalog „Kommunikationsstil" (crm)

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

### Kontaktart: `crm.kontaktart.*`

#### crm.kontaktart.list

Liste/Suche: Katalog „Kontaktart" (crm)

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

#### crm.kontaktart.get

Detail: Katalog „Kontaktart" (crm)

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

#### crm.kontaktart.create

Anlegen: Katalog „Kontaktart" (crm)

- 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":"crm.kontaktart.create","input":{"label":"<label>"}}`

#### crm.kontaktart.update

Ändern: Katalog „Kontaktart" (crm)

- 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":"crm.kontaktart.update","input":{"id":"<id>"}}`

#### crm.kontaktart.delete

Löschen: Katalog „Kontaktart" (crm)

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

### Konten-Arten: `crm.arten.*`

#### crm.arten.list

Liste/Suche: Katalog „Konten-Arten" (crm)

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

#### crm.arten.get

Detail: Katalog „Konten-Arten" (crm)

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

#### crm.arten.create

Anlegen: Katalog „Konten-Arten" (crm)

- 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":"crm.arten.create","input":{"label":"<label>"}}`

#### crm.arten.update

Ändern: Katalog „Konten-Arten" (crm)

- 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":"crm.arten.update","input":{"id":"<id>"}}`

#### crm.arten.delete

Löschen: Katalog „Konten-Arten" (crm)

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

### Konto-Kontaktart: `crm.gbz_kontaktart.*`

#### crm.gbz_kontaktart.list

Liste/Suche: Katalog „Konto-Kontaktart" (crm)

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

#### crm.gbz_kontaktart.get

Detail: Katalog „Konto-Kontaktart" (crm)

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

#### crm.gbz_kontaktart.create

Anlegen: Katalog „Konto-Kontaktart" (crm)

- 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":"crm.gbz_kontaktart.create","input":{"label":"<label>"}}`

#### crm.gbz_kontaktart.update

Ändern: Katalog „Konto-Kontaktart" (crm)

- 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":"crm.gbz_kontaktart.update","input":{"id":"<id>"}}`

#### crm.gbz_kontaktart.delete

Löschen: Katalog „Konto-Kontaktart" (crm)

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

### Konto-Typen: `crm.gbztyp.*`

#### crm.gbztyp.list

Liste/Suche: Katalog „Konto-Typen" (crm)

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

#### crm.gbztyp.get

Detail: Katalog „Konto-Typen" (crm)

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

#### crm.gbztyp.create

Anlegen: Katalog „Konto-Typen" (crm)

- 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":"crm.gbztyp.create","input":{"label":"<label>"}}`

#### crm.gbztyp.update

Ändern: Katalog „Konto-Typen" (crm)

- 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":"crm.gbztyp.update","input":{"id":"<id>"}}`

#### crm.gbztyp.delete

Löschen: Katalog „Konto-Typen" (crm)

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

### Kontostatus: `crm.lifecycle_stage.*`

#### crm.lifecycle_stage.list

Liste/Suche: Katalog „Kontostatus" (crm)

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

#### crm.lifecycle_stage.get

Detail: Katalog „Kontostatus" (crm)

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

#### crm.lifecycle_stage.create

Anlegen: Katalog „Kontostatus" (crm)

- 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":"crm.lifecycle_stage.create","input":{"label":"<label>"}}`

#### crm.lifecycle_stage.update

Ändern: Katalog „Kontostatus" (crm)

- 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":"crm.lifecycle_stage.update","input":{"id":"<id>"}}`

#### crm.lifecycle_stage.delete

Löschen: Katalog „Kontostatus" (crm)

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

### Konzernebene: `crm.konzernebene.*`

#### crm.konzernebene.list

Liste/Suche: Katalog „Konzernebene" (crm)

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

#### crm.konzernebene.get

Detail: Katalog „Konzernebene" (crm)

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

#### crm.konzernebene.create

Anlegen: Katalog „Konzernebene" (crm)

- 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":"crm.konzernebene.create","input":{"label":"<label>"}}`

#### crm.konzernebene.update

Ändern: Katalog „Konzernebene" (crm)

- 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":"crm.konzernebene.update","input":{"id":"<id>"}}`

#### crm.konzernebene.delete

Löschen: Katalog „Konzernebene" (crm)

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

### Lehrberechtigung: `crm.lehrberechtigung.*`

#### crm.lehrberechtigung.list

Liste/Suche: Katalog „Lehrberechtigung" (crm)

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

#### crm.lehrberechtigung.get

Detail: Katalog „Lehrberechtigung" (crm)

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

#### crm.lehrberechtigung.create

Anlegen: Katalog „Lehrberechtigung" (crm)

- 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":"crm.lehrberechtigung.create","input":{"label":"<label>"}}`

#### crm.lehrberechtigung.update

Ändern: Katalog „Lehrberechtigung" (crm)

- 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":"crm.lehrberechtigung.update","input":{"id":"<id>"}}`

#### crm.lehrberechtigung.delete

Löschen: Katalog „Lehrberechtigung" (crm)

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

### Leitungsebene: `crm.leitungsebene.*`

#### crm.leitungsebene.list

Liste/Suche: Katalog „Leitungsebene" (crm)

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

#### crm.leitungsebene.get

Detail: Katalog „Leitungsebene" (crm)

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

#### crm.leitungsebene.create

Anlegen: Katalog „Leitungsebene" (crm)

- 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":"crm.leitungsebene.create","input":{"label":"<label>"}}`

#### crm.leitungsebene.update

Ändern: Katalog „Leitungsebene" (crm)

- 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":"crm.leitungsebene.update","input":{"id":"<id>"}}`

#### crm.leitungsebene.delete

Löschen: Katalog „Leitungsebene" (crm)

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

### Mail-Status: `crm.mail_status.*`

#### crm.mail_status.list

Liste/Suche: Katalog „Mail-Status" (crm)

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

#### crm.mail_status.get

Detail: Katalog „Mail-Status" (crm)

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

#### crm.mail_status.create

Anlegen: Katalog „Mail-Status" (crm)

- 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":"crm.mail_status.create","input":{"label":"<label>"}}`

#### crm.mail_status.update

Ändern: Katalog „Mail-Status" (crm)

- 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":"crm.mail_status.update","input":{"id":"<id>"}}`

#### crm.mail_status.delete

Löschen: Katalog „Mail-Status" (crm)

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

### Mitarbeiterzahl: `crm.anz_mitarbeiter.*`

#### crm.anz_mitarbeiter.list

Liste/Suche: Katalog „Mitarbeiterzahl" (crm)

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

#### crm.anz_mitarbeiter.get

Detail: Katalog „Mitarbeiterzahl" (crm)

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

#### crm.anz_mitarbeiter.create

Anlegen: Katalog „Mitarbeiterzahl" (crm)

- 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":"crm.anz_mitarbeiter.create","input":{"label":"<label>"}}`

#### crm.anz_mitarbeiter.update

Ändern: Katalog „Mitarbeiterzahl" (crm)

- 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":"crm.anz_mitarbeiter.update","input":{"id":"<id>"}}`

#### crm.anz_mitarbeiter.delete

Löschen: Katalog „Mitarbeiterzahl" (crm)

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

### Mitgliedsart: `crm.mitgliedsart.*`

#### crm.mitgliedsart.list

Liste/Suche: Katalog „Mitgliedsart" (crm)

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

#### crm.mitgliedsart.get

Detail: Katalog „Mitgliedsart" (crm)

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

#### crm.mitgliedsart.create

Anlegen: Katalog „Mitgliedsart" (crm)

- 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":"crm.mitgliedsart.create","input":{"label":"<label>"}}`

#### crm.mitgliedsart.update

Ändern: Katalog „Mitgliedsart" (crm)

- 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":"crm.mitgliedsart.update","input":{"id":"<id>"}}`

#### crm.mitgliedsart.delete

Löschen: Katalog „Mitgliedsart" (crm)

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

### Mitgliedsstatus: `crm.mitgliedsstatus.*`

#### crm.mitgliedsstatus.list

Liste/Suche: Katalog „Mitgliedsstatus" (crm)

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

#### crm.mitgliedsstatus.get

Detail: Katalog „Mitgliedsstatus" (crm)

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

#### crm.mitgliedsstatus.create

Anlegen: Katalog „Mitgliedsstatus" (crm)

- 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":"crm.mitgliedsstatus.create","input":{"label":"<label>"}}`

#### crm.mitgliedsstatus.update

Ändern: Katalog „Mitgliedsstatus" (crm)

- 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":"crm.mitgliedsstatus.update","input":{"id":"<id>"}}`

#### crm.mitgliedsstatus.delete

Löschen: Katalog „Mitgliedsstatus" (crm)

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

### Pain Points: `crm.pain.*`

#### crm.pain.list

Liste/Suche: Katalog „Pain Points" (crm)

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

#### crm.pain.get

Detail: Katalog „Pain Points" (crm)

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

#### crm.pain.create

Anlegen: Katalog „Pain Points" (crm)

- 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":"crm.pain.create","input":{"label":"<label>"}}`

#### crm.pain.update

Ändern: Katalog „Pain Points" (crm)

- 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":"crm.pain.update","input":{"id":"<id>"}}`

#### crm.pain.delete

Löschen: Katalog „Pain Points" (crm)

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

### Rating: `crm.vertrieb_rating.*`

#### crm.vertrieb_rating.list

Liste/Suche: Katalog „Rating" (crm)

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

#### crm.vertrieb_rating.get

Detail: Katalog „Rating" (crm)

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

#### crm.vertrieb_rating.create

Anlegen: Katalog „Rating" (crm)

- 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":"crm.vertrieb_rating.create","input":{"label":"<label>"}}`

#### crm.vertrieb_rating.update

Ändern: Katalog „Rating" (crm)

- 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":"crm.vertrieb_rating.update","input":{"id":"<id>"}}`

#### crm.vertrieb_rating.delete

Löschen: Katalog „Rating" (crm)

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

### Rechtsform: `crm.unternehmensart.*`

#### crm.unternehmensart.list

Liste/Suche: Katalog „Rechtsform" (crm)

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

#### crm.unternehmensart.get

Detail: Katalog „Rechtsform" (crm)

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

#### crm.unternehmensart.create

Anlegen: Katalog „Rechtsform" (crm)

- 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":"crm.unternehmensart.create","input":{"label":"<label>"}}`

#### crm.unternehmensart.update

Ändern: Katalog „Rechtsform" (crm)

- 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":"crm.unternehmensart.update","input":{"id":"<id>"}}`

#### crm.unternehmensart.delete

Löschen: Katalog „Rechtsform" (crm)

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

### Schlüsseltyp: `crm.schluesseltyp.*`

#### crm.schluesseltyp.list

Liste/Suche: Katalog „Schlüsseltyp" (crm)

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

#### crm.schluesseltyp.get

Detail: Katalog „Schlüsseltyp" (crm)

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

#### crm.schluesseltyp.create

Anlegen: Katalog „Schlüsseltyp" (crm)

- 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":"crm.schluesseltyp.create","input":{"label":"<label>"}}`

#### crm.schluesseltyp.update

Ändern: Katalog „Schlüsseltyp" (crm)

- 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":"crm.schluesseltyp.update","input":{"id":"<id>"}}`

#### crm.schluesseltyp.delete

Löschen: Katalog „Schlüsseltyp" (crm)

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

### Umsatzklasse: `crm.umsatzklasse.*`

#### crm.umsatzklasse.list

Liste/Suche: Katalog „Umsatzklasse" (crm)

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

#### crm.umsatzklasse.get

Detail: Katalog „Umsatzklasse" (crm)

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

#### crm.umsatzklasse.create

Anlegen: Katalog „Umsatzklasse" (crm)

- 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":"crm.umsatzklasse.create","input":{"label":"<label>"}}`

#### crm.umsatzklasse.update

Ändern: Katalog „Umsatzklasse" (crm)

- 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":"crm.umsatzklasse.update","input":{"id":"<id>"}}`

#### crm.umsatzklasse.delete

Löschen: Katalog „Umsatzklasse" (crm)

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

### Unternehmensgröße: `crm.groesse.*`

#### crm.groesse.list

Liste/Suche: Katalog „Unternehmensgröße" (crm)

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

#### crm.groesse.get

Detail: Katalog „Unternehmensgröße" (crm)

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

#### crm.groesse.create

Anlegen: Katalog „Unternehmensgröße" (crm)

- 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":"crm.groesse.create","input":{"label":"<label>"}}`

#### crm.groesse.update

Ändern: Katalog „Unternehmensgröße" (crm)

- 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":"crm.groesse.update","input":{"id":"<id>"}}`

#### crm.groesse.delete

Löschen: Katalog „Unternehmensgröße" (crm)

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

### Verlust-/Begründung: `crm.vertrieb_begruendung.*`

#### crm.vertrieb_begruendung.list

Liste/Suche: Katalog „Verlust-/Begründung" (crm)

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

#### crm.vertrieb_begruendung.get

Detail: Katalog „Verlust-/Begründung" (crm)

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

#### crm.vertrieb_begruendung.create

Anlegen: Katalog „Verlust-/Begründung" (crm)

- 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":"crm.vertrieb_begruendung.create","input":{"label":"<label>"}}`

#### crm.vertrieb_begruendung.update

Ändern: Katalog „Verlust-/Begründung" (crm)

- 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":"crm.vertrieb_begruendung.update","input":{"id":"<id>"}}`

#### crm.vertrieb_begruendung.delete

Löschen: Katalog „Verlust-/Begründung" (crm)

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

### Verteiler: `crm.verteiler.*`

#### crm.verteiler.list

Liste/Suche: Katalog „Verteiler" (crm)

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

#### crm.verteiler.get

Detail: Katalog „Verteiler" (crm)

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

#### crm.verteiler.create

Anlegen: Katalog „Verteiler" (crm)

- 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":"crm.verteiler.create","input":{"label":"<label>"}}`

#### crm.verteiler.update

Ändern: Katalog „Verteiler" (crm)

- 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":"crm.verteiler.update","input":{"id":"<id>"}}`

#### crm.verteiler.delete

Löschen: Katalog „Verteiler" (crm)

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

### Vertriebssegment: `crm.vertriebssegment.*`

#### crm.vertriebssegment.list

Liste/Suche: Katalog „Vertriebssegment" (crm)

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

#### crm.vertriebssegment.get

Detail: Katalog „Vertriebssegment" (crm)

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

#### crm.vertriebssegment.create

Anlegen: Katalog „Vertriebssegment" (crm)

- 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":"crm.vertriebssegment.create","input":{"label":"<label>"}}`

#### crm.vertriebssegment.update

Ändern: Katalog „Vertriebssegment" (crm)

- 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":"crm.vertriebssegment.update","input":{"id":"<id>"}}`

#### crm.vertriebssegment.delete

Löschen: Katalog „Vertriebssegment" (crm)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### crm.anruf_ergebnis

Haelt Ergebnis und Kurznotiz an einem Anruf aus dem Journal fest (Mailbox, erreicht, Rueckruf vereinbart, Termin ...). Fuer Anrufe ohne Konto der einzige Ort fuer den Gespraechsinhalt; bei zugeordneten Anrufen zusaetzlich zur Aktivitaet. Aendert nur die genannten Felder.

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Anruf ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `anrufId` (string, Pflicht): ID des Anrufs aus dem Journal
  - `ergebnisCode` (string): Gespraechsergebnis. nicht_erreicht = Mailbox/keiner dran. Ein gesetzter Code wird nur ueberschrieben, nie geloescht. Werte: `nicht_erreicht`, `gatekeeper_info`, `rueckruf_vereinbart`, `erreicht_recherche`, `kein_fit`, `kein_timing_nurture`, `mail_einwilligung`, `termin_vereinbart`, `qualifiziert`, `werbewiderspruch`
  - `notiz` (string): Kurznotiz zum Gespraech, zwei bis drei Saetze. Ersetzt die bisherige Notiz; leerer String loescht sie
- Beispiel: `{"name":"crm.anruf_ergebnis","input":{"anrufId":"<anrufId>"}}`

#### crm.anruf_report

Kennzahlen zum Anrufjournal: Anzahl eingehend/ausgehend, verpasste Anrufe, Erreichbarkeit in Prozent, durchschnittliche Gespraechsdauer, offene Rueckrufe und nicht zugeordnete Anrufe. Liefert bewusst KEINE Rufnummern.

- Art: Lesen
- Rechte: Anruf lesen
- Datenklassen: B (intern)
- Eingabe:
  - `tage` (number): Zeitraum in Tagen rueckwaerts (Default 30, max 365)
  - `kontoId` (string): Nur Anrufe zu diesem CRM-Konto
- Beispiel: `{"name":"crm.anruf_report","input":{}}`

#### crm.anruf_starten

Startet einen Anruf ueber das EIGENE verbundene Sipgate-Konto des aufrufenden Nutzers (Click-to-Call): zuerst klingelt das gespeicherte Standardgeraet (z.B. die Sipgate-eSIM), nach Annahme waehlt Sipgate die Zielnummer. Zielnummer international (+49...). Mit kontoId steht der Anruf SOFORT als erledigte Aktivitaet am Konto (Rueckgabe aktivitaetTicketId) - den Gespraechsinhalt danach per projektsyn.ticket.update in die Beschreibung schreiben. Ohne kontoId nur Anruf; das Journal /crm/anrufe fuellt der Provider-Push.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Anruf lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Loest einen echten Telefonanruf beim Provider aus (Kosten, Aussenwirkung). Die Zielnummer wird im Audit maskiert.
- Eingabe:
  - `nummer` (string, Pflicht): Zielnummer international, z.B. +494171607650. Nationale Schreibweise wird abgelehnt, nicht geraten
  - `kontoId` (string): Optional: CRM-Konto, zu dem der Anruf gehoert - nur zur Rueckmeldung, die Zuordnung uebernimmt der Matcher
- Beispiel: `{"name":"crm.anruf_starten","input":{"nummer":"<nummer>"}}`

#### crm.anruf_zuordnen

Ordnet einen Anruf aus dem Journal einem CRM-Konto und/oder Kontakt zu. Fuer Anrufe, die die automatische Rufnummern-Erkennung nicht aufloesen konnte. Legt bei zugeordnetem Konto die fehlende Aktivitaet im Aktivitaetsstrom nach.

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Anruf ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `anrufId` (string, Pflicht): ID des Anrufs aus dem Journal
  - `kontoId` (string): CRM-Konto, zu dem der Anruf gehoert
  - `kontaktId` (string): Ansprechpartner, falls bekannt
- Beispiel: `{"name":"crm.anruf_zuordnen","input":{"anrufId":"<anrufId>"}}`

#### crm.gmail_file

Legt eine Gmail-Mail (messageId aus crm.gmail_scan) ins CRM ab, Extension-Logik: Konto per Absender-Domain matchen (bei mehreren Treffern kontoId anfordern) oder neu als Lead anlegen, dann Mail + Logbuch. Braucht gmail.readonly (Volltext). Danach crm.mail_analyze → Aufgaben/MEDDIC/Deal ableiten. Vorher prüfen, nicht blind alles ablegen.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto anlegen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Legt eine eingehende Mail (Personendaten Klasse B/C) am Konto ab; ggf. neues Lead-Konto. Mail-Inhalt nicht in Audit-Details.
- Eingabe:
  - `messageId` (string, Pflicht): Gmail-Message-ID aus crm.gmail_scan
  - `kontoId` (string): Ziel-Konto (crm_gbz_geschaeftsbeziehung.id). Leer = automatisch matchen/anlegen
- Beispiel: `{"name":"crm.gmail_file","input":{"messageId":"<messageId>"}}`

#### crm.gmail_scan

Read-only Scan des verbundenen Gmail-Kontos (Metadaten From/To/Subject/Date, paginiert), Posteingang oder Gesendet. Findet VERGESSENE LEADS = Gegenpartei nicht im CRM erfasst; markiert Lead-Betreffe. Mit mit_bekannten:"true" kommen zusaetzlich Mails an bereits erfasste Kontakte im Bucket `bekannter_kontakt` inkl. konto_id, das ist der Weg, einen Postausgang an ein BESTEHENDES Konto zu haengen. Default ab_datum 2026/02/01 (Schul-Outreach-Start). Braucht gmail.readonly (Google-Konto neu verbinden). Ablegen via crm.gmail_file.

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `ab_datum` (string): Nur Mails ab Datum (YYYY/MM/DD). Default 2026/02/01
  - `limit` (number): Max. zu scannende Mails (Default 400)
  - `ordner` (string): posteingang (Default) | gesendet. Gesendet = Gegenpartei ist der Empfaenger
  - `suche` (string): Eigener Gmail-Query. Ueberschreibt den Default-Rauschfilter
  - `nur_neue_konten` (string): "true" = nur komplett neue Orgs (Domain nicht im CRM)
  - `mit_bekannten` (string): "true" = Mails an bereits erfasste Kontakte mit ausgeben (Bucket `bekannter_kontakt`, inkl. konto_id). Noetig, um Postausgang an ein bestehendes Konto zu haengen
- Beispiel: `{"name":"crm.gmail_scan","input":{}}`

#### crm.konto_report

Voll-Dossier eines einzelnen Kontos in einem Call: Stammlage + Pains, alle Kontakte mit Vertriebs-Profil (Buying-Rolle/Kommunikationsstil/Kanal/Beziehungsstatus/Motive) + Links, alle Potenziale mit MEDDIC, Notizen, letzte Aktivitaeten, offene Aufgaben, abgelegte Mails, plus Vollqualifikation (BANT, MEDDIC-Abdeckung, Profil-Vollstaendigkeit, Luecken, naechster Schritt). Fuer die Konto-Vorbereitung vor Anruf/Termin.

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Liest ein vollständiges Konto-Dossier inkl. Kontakt-Profile + abgelegte Mails (Klasse C). Nur lesend, keine Weitergabe an Dritte.
- Eingabe:
  - `kontoId` (string): ID des Kontos (crm_gbz_geschaeftsbeziehung.id). Entweder kontoId oder search
  - `search` (string): Alternativ: Name oder Nummer des Kontos (erster Treffer)
- Beispiel: `{"name":"crm.konto_report","input":{}}`

#### crm.konto_teilen

Teilt ein CRM-Konto mit einem Vertriebspartner (Cross-Tenant-Sicht) oder hebt die Teilung auf. Der Partner sieht das Konto dann in SEINEM Mandanten; Eigentum und Datensatz bleiben bei uns. Ohne partnerTenantId wird die Teilung aufgehoben. Voraussetzung: aktive Kooperation (siehe crm.partner_list).

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Macht einen Kundendatensatz fuer einen fremden Mandanten sichtbar. Nur mit vertraglicher Grundlage (AVV/Partnervertrag) einsetzen.
- Eingabe:
  - `kontoId` (string, Pflicht): CRM-Konto-ID (gbz), das geteilt werden soll
  - `partnerTenantId` (string): Ziel-Partner (aus crm.partner_list). Weglassen = Teilung aufheben
- Beispiel: `{"name":"crm.konto_teilen","input":{"kontoId":"<kontoId>"}}`

#### crm.konto.freigabe_list

Listet die Mandanten, fuer die ein Konto freigegeben ist, PLUS die moeglichen Ziele (aktive Kooperations-Partner) fuer das Multiselect. Unterschied zu crm.konto_teilen: die Freigabe ist n:m, ein Konto kann gleichzeitig bei mehreren Mandanten liegen, ohne dass einer dem anderen den Zugriff nimmt.

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Liest nur die Mandanten-Freigabe-Liste eines Kontos (Beziehungs-Metadaten, keine personenbezogenen Inhalte).
- Eingabe:
  - `kontoId` (string, Pflicht): CRM-Konto-ID (crm_gbz_geschaeftsbeziehung.id)
- Beispiel: `{"name":"crm.konto.freigabe_list","input":{"kontoId":"<kontoId>"}}`

#### crm.konto.freigabe_set

Setzt die Mandanten, fuer die ein Konto freigegeben ist (Replace-Semantik; nur an AKTIVE Kooperations-Partner). Die uebergebene Liste ist danach der Stand, ein leeres Array entfernt alle Freigaben.

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Macht einen Kundendatensatz fuer fremde Mandanten sichtbar. Nur an aktive Kooperations-Partner und nur mit vertraglicher Grundlage (AVV/Partnervertrag).
- Eingabe:
  - `kontoId` (string, Pflicht): CRM-Konto-ID (crm_gbz_geschaeftsbeziehung.id)
  - `zielTenantIds` (string[]): Ziel-Tenant-IDs (aktive Kooperations-Partner). Leer = alle Freigaben entfernen
- Beispiel: `{"name":"crm.konto.freigabe_set","input":{"kontoId":"<kontoId>"}}`

#### crm.kooperation_aktivieren

Aktiviert die Kooperation eines CRM-Kontos: provisioniert einen Partner-Tenant aus der Vorlage der Konto-Art (crm_gbz_arten.standard_tenant_id), legt platform_kooperation an und verknuepft das Konto. Voraussetzung: die Konto-Art hat eine Vorlage (standard_tenant_id) hinterlegt. Idempotent (bestehender Partner-Tenant wird zurueckgegeben).

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto ändern, Instanz anlegen
- Datenklassen: C (vertraulich)
- Datenschutz: Provisioniert einen eigenstaendigen Partner-Mandanten und richtet eine Cross-Tenant-Kooperation ein. Nur fuer autorisierte Vertriebs-/Admin-Rollen.
- Eingabe:
  - `kontoId` (string, Pflicht): CRM-Konto-ID (gbz), dessen Art eine Kooperations-Vorlage (standard_tenant_id) hat
- Beispiel: `{"name":"crm.kooperation_aktivieren","input":{"kontoId":"<kontoId>"}}`

#### crm.leadgen_report

Gesamter Vertriebsstand in einem Report: KPIs, Lead-Funnel, Wiedervorlagen (ueberfaellig + kommende 14 Tage, mit ueberfaellig-Flag + tage_bis), offene Aufgaben, letzte Aktivitaeten, abgelegte Mails, offene Deals, priorisierte Leads (je Lead auch meddic_dims=MEDDIC-Abdeckung 0-8 und pains=Anzahl Pain-Tags als Qualifizierungstiefe). Fuer Planung/Steuerung. Fuer das Voll-Dossier + Vollqualifikation eines EINZELNEN Kontos: crm.konto_report.

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Aggregierter Vertriebsstand inkl. Ansprechpartner-Kontaktdaten (Klasse C). Nur lesend fuer Planung/Steuerung.
- Eingabe:
  - `limit` (number): Zeilen je Liste (Default 25)
  - `tier` (string): Optional: nur Leads dieses Tiers (A|B|C)
  - `bundesland` (string): Optional: nur Leads und Wiedervorlagen aus diesem Bundesland. Code aus core.bundesland (z.B. he) oder Klarname (Hessen), Komma-Liste möglich. KPIs, Funnel, Aufgaben, Mails und Deals bleiben mandantenweit
- Beispiel: `{"name":"crm.leadgen_report","input":{}}`

#### crm.log_activity

Traegt eine Aktivitaet an einem CRM-Konto ein (Anruf, Mail, Termin, Notiz oder offene Aufgabe). Erscheint sofort im Konto-Tab "Aktivitaeten" - es ist ein ProjektSyn-Ticket mit Konto-Bezug, derselbe Weg wie die automatische Telefonie-Aktivitaet. Vergangenheits-Typen werden als erledigt abgelegt, "aufgabe" bleibt offen.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto lesen, Logbuch anlegen
- Datenklassen: C (vertraulich)
- Datenschutz: Schreibt einen Aktivitaets-Eintrag zur Kundenakte. Freitext wird nicht in Audit-Details gespeichert.
- Eingabe:
  - `gbzId` (string, Pflicht): CRM-Konto-ID
  - `typ` (string): Art der Aktivitaet. Default notiz. Nur "aufgabe" bleibt offen. Werte: `anruf`, `mail`, `termin`, `notiz`, `aufgabe`
  - `titel` (string, Pflicht)
  - `inhalt` (string): Was gesagt/geschrieben wurde. Landet in der Beschreibung
- Beispiel: `{"name":"crm.log_activity","input":{"gbzId":"<gbzId>","titel":"<titel>"}}`

#### crm.mail_analyze

Analyse-Bundle fuer den mailgetriebenen Vertriebszyklus: die (unbearbeiteten) eingehenden Mails eines Kontos + aktueller Profil-/MEDDIC-/Pain-Kontext + Anleitung. Danach schreibt der Aufrufer MEDDIC via crm.meddic_add, setzt crm.mail_set_status und legt ggf. eine Aufgabe an. Personen-Profil nur als Vorschlag (DSGVO).

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Liest eingehende Mails + Profil-/MEDDIC-Kontext eines Kontos (Klasse C) fuer die Vertriebs-Analyse. Personen-Profil-Ableitungen nur als Vorschlag, nie stiller Write.
- Eingabe:
  - `kontoId` (string): Konto (crm_gbz_geschaeftsbeziehung.id), analysiert dessen Mails
  - `mailId` (string): Alternativ: eine einzelne Mail (Konto wird daraus abgeleitet)
  - `nur_neue` (boolean): Default true = nur Mails mit Status neu/in_bearbeitung
- Beispiel: `{"name":"crm.mail_analyze","input":{}}`

#### crm.mail_get

Liest eine abgelegte Mail inkl. Inhalt (bodyContent)

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Liest den Volltext einer abgelegten Mail (Klasse C). Nur lesend, keine Weitergabe.
- Eingabe:
  - `mailId` (string, Pflicht)
- Beispiel: `{"name":"crm.mail_get","input":{"mailId":"<mailId>"}}`

#### crm.mail_list

Listet abgelegte Mails (eingehend/ausgehend) zu einem Konto

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Listet abgelegte Mails-Metadaten eines Kontos (Klasse C). Nur lesend.
- Eingabe:
  - `kontoId` (string, Pflicht)
  - `richtung` (string): Werte: `eingehend`, `ausgehend`
  - `limit` (number)
- Beispiel: `{"name":"crm.mail_list","input":{"kontoId":"<kontoId>"}}`

#### crm.mail_send

Sendet eine E-Mail über das verbundene Gmail-Konto des Nutzers und legt sie als ausgehend am Konto ab

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto lesen, Logbuch anlegen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Versendet eine E-Mail nach außen über das verbundene Postfach und legt sie in der Kundenakte ab.
- Eingabe:
  - `kontoId` (string, Pflicht)
  - `to` (string, Pflicht)
  - `cc` (string): Optionale CC-Empfänger, komma-separiert
  - `bcc` (string): Optionale BCC-Empfänger, komma-separiert
  - `from` (string): Optionaler Absender: E-Mail eines verbundenen Postfachs (z.B. info@unitedsynergy.com). Default: das Login-Postfach des Nutzers
  - `subject` (string, Pflicht)
  - `bodyHtml` (string, Pflicht)
  - `inReplyToMailId` (string)
- Beispiel: `{"name":"crm.mail_send","input":{"kontoId":"<kontoId>","to":"<to>","subject":"<subject>","bodyHtml":"<bodyHtml>"}}`

#### crm.mail_set_status

Setzt den Vertriebs-Workflow-Status einer abgelegten Mail (Katalog crm.mail_status: neu|in_bearbeitung|analysiert|aufgabe_erstellt|beantwortet|erledigt).

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Setzt nur ein Workflow-Statusfeld an einer abgelegten Mail (Klasse C). Kein Mail-Inhalt in Audit-Details.
- Eingabe:
  - `mailId` (string, Pflicht)
  - `status` (string, Pflicht): Katalog-Code aus crm.mail_status. Leer = zurueck auf neu
- Beispiel: `{"name":"crm.mail_set_status","input":{"mailId":"<mailId>","status":"<status>"}}`

#### crm.meddic_add

Legt eine MEDDIC-Erkenntnis an, an einem Potenzial (potenzialId) ODER konto-direkt (gbzId). typ = MEDDIC-Dimension (pain|metrics|economic_buyer|decision_criteria|decision_process|champion|competition|timing). Fuer die Mail-/Meeting-Analyse.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Potenzial ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Legt eine Vertriebs-Qualifizierungs-Erkenntnis am Deal/Konto an (Klasse C, Geschäftsdaten). Freitext nicht in Audit-Details.
- Eingabe:
  - `typ` (string, Pflicht): MEDDIC-Dimension (pain|metrics|economic_buyer|decision_criteria|decision_process|champion|competition|timing)
  - `inhalt` (string): Freitext-Erkenntnis
  - `potenzialId` (string): Deal-Ebene (crm_gbz_vertrieb_potential.id)
  - `gbzId` (string): Konto-Ebene (crm_gbz_geschaeftsbeziehung.id), ohne Deal
- Beispiel: `{"name":"crm.meddic_add","input":{"typ":"<typ>"}}`

#### crm.meeting_analyze

Analyse-Bundle fuer Meetings: die Termine eines Kontos/Kontakts (oder ein einzelnes Meeting) mit Teilnehmern (gematchte CRM-Kontakte), Meet-Link und dem Volltext der Besprechungsnotiz (Gemini), plus aktueller MEDDIC-/Pain-Kontext. Danach schreibt der Aufrufer Erkenntnisse via crm.meddic_add und legt ggf. eine Aufgabe an. Fuer die Nachbereitung von Vertriebsterminen.

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Liest Meeting-Notizen (Gemini-Volltext) + Teilnehmer + MEDDIC-Kontext (Klasse C, sensibler Gespraechsinhalt). Personen-Profil-Ableitungen nur als Vorschlag, nie stiller Write.
- Eingabe:
  - `kontoId` (string): Konto (crm_gbz_geschaeftsbeziehung.id), dessen Meetings
  - `kontaktId` (string): Alternativ: Kontakt (crm_gbz_kontakt.id), dessen Meetings
  - `meetingId` (string): Alternativ: ein einzelnes Meeting (platform_calendar_events.id)
  - `limit` (number): Max Meetings (Default 10)
- Beispiel: `{"name":"crm.meeting_analyze","input":{}}`

#### crm.partner_list

Listet die Vertriebspartner (Kooperationen) dieses Mandanten: Partner-Tenant-ID, Name, Rolle, Status und das verknuepfte CRM-Konto. Liefert die partnerTenantId, die crm.konto_teilen erwartet.

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: B (intern)
- Eingabe:
  - `nurAktiv` (boolean): Nur aktive Kooperationen (Default true)
- Beispiel: `{"name":"crm.partner_list","input":{}}`

#### crm.pipeline_stage_create

Legt eine neue Deal-Pipeline-Stufe am Ende an. weight ist die Forecast-Wahrscheinlichkeit 0-100; isWon/isLost markieren Endzustaende. Danach ggf. crm.pipeline_stage_update fuer position.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Aendert die Pipeline-Konfiguration (Klasse C, keine Personendaten).
- Eingabe:
  - `label` (string, Pflicht): Anzeige-Label der Stufe
  - `key` (string): Optionaler stabiler Key (wird sonst aus Label abgeleitet). Wird am Potenzial in lead_status gespeichert
  - `weight` (number): Forecast-Wahrscheinlichkeit 0-100
  - `color` (string): Tailwind-Farbklassen, z.B. "bg-cyan-100 text-cyan-700"
  - `isWon` (boolean): Endzustand Gewonnen
  - `isLost` (boolean): Endzustand Verloren
- Beispiel: `{"name":"crm.pipeline_stage_create","input":{"label":"<label>"}}`

#### crm.pipeline_stage_delete

Loescht eine Deal-Pipeline-Stufe. Blockt, wenn noch Potenziale in dieser Stufe stehen, erst umziehen, dann loeschen.

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Aendert die Pipeline-Konfiguration (Klasse C, keine Personendaten).
- Eingabe:
  - `id` (string, Pflicht): Stage-ID aus crm.pipeline_stage_list
- Beispiel: `{"name":"crm.pipeline_stage_delete","input":{"id":"<id>"}}`

#### crm.pipeline_stage_list

Listet die Deal-Pipeline-Stufen des Tenants. Der Kontostatus wird separat ueber den Katalog crm.lifecycle_stage gepflegt. Liefert id/key/label/position/weight/color/isWon/isLost/kriterien.

- Art: Lesen
- Rechte: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Liest ausschließlich tenantbezogene Deal-Pipeline-Konfiguration; keine Personen- oder Kontoinhalte.
- Eingabe: keine, `input` ist `{}`
- Beispiel: `{"name":"crm.pipeline_stage_list","input":{}}`

#### crm.pipeline_stage_update

Aendert eine Pipeline-Stufe: label, weight (0-100), color, position, isWon, isLost, kriterien (Bullet-Liste Erfolgskriterien). Der KEY ist bewusst nicht aenderbar (schuetzt bestehende lead_status-Verweise und verhindert Re-Seed-Dubletten). Fuer Gewichts-Rekalibrierung an reale Abschlussquoten.

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Konto ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Aendert die Pipeline-Konfiguration (Klasse C, keine Personendaten).
- Eingabe:
  - `id` (string, Pflicht): Stage-ID (crm_pipeline_stages.id, aus crm.pipeline_stage_list)
  - `label` (string)
  - `weight` (number): Forecast-Wahrscheinlichkeit 0-100
  - `color` (string): Tailwind-Farbklassen
  - `position` (number): Reihenfolge (kleiner = weiter vorn)
  - `isWon` (boolean)
  - `isLost` (boolean)
  - `kriterien` (string[]): Erfolgskriterien/Leitfaden je Stufe
- Beispiel: `{"name":"crm.pipeline_stage_update","input":{"id":"<id>"}}`

#### crm.rueckruf_anlegen

Legt zu einem Anruf eine Rueckrufaufgabe an (ProjektSyn-Aufgabe, verknuepft mit dem Anruf). Gibt es zu dem Anruf schon eine, wird sie zurueckgegeben statt eine zweite anzulegen.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Anruf ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `anrufId` (string, Pflicht): ID des Anrufs aus dem Journal
  - `userId` (string): Wer zurueckrufen soll. Default: der Mitarbeiter des Anrufs
  - `faelligAm` (string): Faelligkeitsdatum (ISO). Default: heute
  - `notiz` (string): Worum es geht
- Beispiel: `{"name":"crm.rueckruf_anlegen","input":{"anrufId":"<anrufId>"}}`

---

# 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>"}}`

---

# API-Referenz LMS (App-Kennung lms)

> 5 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/lms/

## 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.

### Kurse (LMS): `lms.kurs.*`

#### lms.kurs.list

Liste/Suche: Kurse (LMS)

- Art: Lesen
- Rechte: LmsKurs lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"lms.kurs.list","input":{}}`

#### lms.kurs.get

Detail: Kurse (LMS)

- Art: Lesen
- Rechte: LmsKurs lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"lms.kurs.get","input":{"id":"<id>"}}`

#### lms.kurs.create

Anlegen: Kurse (LMS)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: LmsKurs anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `beschreibung` (string)
  - `klasse` (string)
  - `status` (string): entwurf | aktiv | …
  - `dauerMinuten` (number)
  - `coverUrl` (string)
- Beispiel: `{"name":"lms.kurs.create","input":{"titel":"<titel>"}}`

#### lms.kurs.update

Ändern: Kurse (LMS)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: LmsKurs ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `klasse` (string)
  - `status` (string): entwurf | aktiv | …
  - `dauerMinuten` (number)
  - `coverUrl` (string)
- Beispiel: `{"name":"lms.kurs.update","input":{"id":"<id>"}}`

#### lms.kurs.delete

Löschen: Kurse (LMS)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: LmsKurs löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"lms.kurs.delete","input":{"id":"<id>"}}`

---

# API-Referenz Memo (App-Kennung memo)

> 6 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/memo/

## 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.

### Memos: `memo.eintrag.*`

#### memo.eintrag.list

Liste/Suche: Memos

- Art: Lesen
- Rechte: Memo lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"memo.eintrag.list","input":{}}`

#### memo.eintrag.get

Detail: Memos

- Art: Lesen
- Rechte: Memo lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"memo.eintrag.get","input":{"id":"<id>"}}`

#### memo.eintrag.create

Anlegen: Memos

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Memo anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `text` (string, Pflicht)
  - `quelle` (string)
  - `status` (string)
  - `zuordnungTyp` (string)
  - `zuordnungId` (string)
  - `zuordnungLabel` (string)
  - `userId` (string)
- Beispiel: `{"name":"memo.eintrag.create","input":{"text":"<text>"}}`

#### memo.eintrag.update

Ändern: Memos

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Memo ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `text` (string)
  - `quelle` (string)
  - `status` (string)
  - `zuordnungTyp` (string)
  - `zuordnungId` (string)
  - `zuordnungLabel` (string)
  - `userId` (string)
- Beispiel: `{"name":"memo.eintrag.update","input":{"id":"<id>"}}`

#### memo.eintrag.delete

Löschen: Memos

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Memo löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"memo.eintrag.delete","input":{"id":"<id>"}}`

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### memo.zuordnen

Memo aus dem Sammeltopf zuordnen: legt das Ziel an (Konto-Logbuch, Aufgabe, Notiz oder Wissens-Eintrag) und markiert das Memo als zugeordnet. Für die KI-Triage, vorher listen (memo_eintrag_list, filter status=neu) und mit Torben abstimmen.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Memo ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Memo-Inhalt wird in den Ziel-Datensatz kopiert (Logbuch am Konto, Aufgabe, Notiz oder Wissen), Inhalt vorher prüfen, personenbezogene Notizen landen sonst im Team-Kontext.
- Eingabe:
  - `memoId` (string, Pflicht): ID des Memos (memo_…)
  - `typ` (string, Pflicht): Zuordnungs-Ziel. Werte: `konto_logbuch`, `aufgabe`, `notiz`, `wissen`
  - `kontoId` (string): Konto (crm_gbz…), Pflicht bei konto_logbuch, optional bei wissen als Bindung. Fällt sonst auf den Erfassungs-Kontext des Memos zurück
  - `titel` (string): Titel für Logbuch/Aufgabe/Wissen. Default: erste Memo-Zeile
  - `wissenTyp` (string): Nur bei typ=wissen. Default: fakt. Werte: `recherche`, `dossier`, `fakt`, `doku`
  - `quelle` (string): Nur bei typ=wissen: Herkunft (Vault-Pfad, URL). Default: memo
- Beispiel: `{"name":"memo.zuordnen","input":{"memoId":"<memoId>","typ":"konto_logbuch"}}`

---

# API-Referenz Newsletter (App-Kennung newsletter)

> 9 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/newsletter/

## 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.

### Newsletter: `newsletter.newsletter.*`

#### newsletter.newsletter.list

Liste/Suche: Newsletter

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

#### newsletter.newsletter.get

Detail: Newsletter

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

#### newsletter.newsletter.create

Anlegen: Newsletter

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Newsletter anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `name` (string, Pflicht)
  - `betreff` (string)
  - `status` (string)
  - `verteilerCode` (string)
  - `empfaengerCount` (number)
  - `versendetAm` (string)
- Beispiel: `{"name":"newsletter.newsletter.create","input":{"name":"<name>"}}`

#### newsletter.newsletter.update

Ändern: Newsletter

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Newsletter ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `name` (string)
  - `betreff` (string)
  - `status` (string)
  - `verteilerCode` (string)
  - `empfaengerCount` (number)
  - `versendetAm` (string)
- Beispiel: `{"name":"newsletter.newsletter.update","input":{"id":"<id>"}}`

#### newsletter.newsletter.delete

Löschen: Newsletter

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

### Versand: `newsletter.versand.*`

#### newsletter.versand.list

Liste/Suche: Versand

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

#### newsletter.versand.get

Detail: Versand

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### newsletter.preview

Prueft Empfaenger-Segment und rendert die email-sichere HTML-Vorschau eines Newsletters (kein Versand)

- Art: Lesen
- Rechte: Newsletter lesen, Versand lesen
- Datenklassen: B (intern)
- Eingabe:
  - `newsletterId` (string, Pflicht)
- Beispiel: `{"name":"newsletter.preview","input":{"newsletterId":"<newsletterId>"}}`

#### newsletter.send

Versendet einen Newsletter an das aufgeloeste Empfaenger-Segment (Gmail-Firmenpostfach/SMTP), je Mail mit Abmelde-Link. Nicht rueckholbar.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Newsletter lesen, Newsletter ändern, Versand anlegen
- Datenklassen: B (intern)
- Datenschutz: Versendet eine Massenmail an alle eingewilligten Empfaenger des Segments. Jede Mail traegt einen personalisierten Abmelde-Link.
- Eingabe:
  - `newsletterId` (string, Pflicht)
- Beispiel: `{"name":"newsletter.send","input":{"newsletterId":"<newsletterId>"}}`

---

# API-Referenz Personal (App-Kennung personal)

> 60 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/personal/

## 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.

### Abteilungen: `personal.abteilung.*`

#### personal.abteilung.list

Liste/Suche: Katalog „Abteilungen" (personal)

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

#### personal.abteilung.get

Detail: Katalog „Abteilungen" (personal)

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

#### personal.abteilung.create

Anlegen: Katalog „Abteilungen" (personal)

- 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":"personal.abteilung.create","input":{"label":"<label>"}}`

#### personal.abteilung.update

Ändern: Katalog „Abteilungen" (personal)

- 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":"personal.abteilung.update","input":{"id":"<id>"}}`

#### personal.abteilung.delete

Löschen: Katalog „Abteilungen" (personal)

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

### Arbeitszeitmodelle: `personal.arbeitszeit.*`

#### personal.arbeitszeit.list

Liste/Suche: Katalog „Arbeitszeitmodelle" (personal)

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

#### personal.arbeitszeit.get

Detail: Katalog „Arbeitszeitmodelle" (personal)

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

#### personal.arbeitszeit.create

Anlegen: Katalog „Arbeitszeitmodelle" (personal)

- 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":"personal.arbeitszeit.create","input":{"label":"<label>"}}`

#### personal.arbeitszeit.update

Ändern: Katalog „Arbeitszeitmodelle" (personal)

- 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":"personal.arbeitszeit.update","input":{"id":"<id>"}}`

#### personal.arbeitszeit.delete

Löschen: Katalog „Arbeitszeitmodelle" (personal)

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

### Ausbildungsarten: `personal.ausbildungsart.*`

#### personal.ausbildungsart.list

Liste/Suche: Katalog „Ausbildungsarten" (personal)

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

#### personal.ausbildungsart.get

Detail: Katalog „Ausbildungsarten" (personal)

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

#### personal.ausbildungsart.create

Anlegen: Katalog „Ausbildungsarten" (personal)

- 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":"personal.ausbildungsart.create","input":{"label":"<label>"}}`

#### personal.ausbildungsart.update

Ändern: Katalog „Ausbildungsarten" (personal)

- 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":"personal.ausbildungsart.update","input":{"id":"<id>"}}`

#### personal.ausbildungsart.delete

Löschen: Katalog „Ausbildungsarten" (personal)

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

### Berufsgruppen: `personal.berufsgruppe.*`

#### personal.berufsgruppe.list

Liste/Suche: Katalog „Berufsgruppen" (personal)

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

#### personal.berufsgruppe.get

Detail: Katalog „Berufsgruppen" (personal)

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

#### personal.berufsgruppe.create

Anlegen: Katalog „Berufsgruppen" (personal)

- 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":"personal.berufsgruppe.create","input":{"label":"<label>"}}`

#### personal.berufsgruppe.update

Ändern: Katalog „Berufsgruppen" (personal)

- 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":"personal.berufsgruppe.update","input":{"id":"<id>"}}`

#### personal.berufsgruppe.delete

Löschen: Katalog „Berufsgruppen" (personal)

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

### Beurteilungstypen: `personal.beurteilungstyp.*`

#### personal.beurteilungstyp.list

Liste/Suche: Katalog „Beurteilungstypen" (personal)

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

#### personal.beurteilungstyp.get

Detail: Katalog „Beurteilungstypen" (personal)

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

#### personal.beurteilungstyp.create

Anlegen: Katalog „Beurteilungstypen" (personal)

- 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":"personal.beurteilungstyp.create","input":{"label":"<label>"}}`

#### personal.beurteilungstyp.update

Ändern: Katalog „Beurteilungstypen" (personal)

- 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":"personal.beurteilungstyp.update","input":{"id":"<id>"}}`

#### personal.beurteilungstyp.delete

Löschen: Katalog „Beurteilungstypen" (personal)

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

### Fachbereiche: `personal.fachbereich.*`

#### personal.fachbereich.list

Liste/Suche: Katalog „Fachbereiche" (personal)

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

#### personal.fachbereich.get

Detail: Katalog „Fachbereiche" (personal)

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

#### personal.fachbereich.create

Anlegen: Katalog „Fachbereiche" (personal)

- 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":"personal.fachbereich.create","input":{"label":"<label>"}}`

#### personal.fachbereich.update

Ändern: Katalog „Fachbereiche" (personal)

- 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":"personal.fachbereich.update","input":{"id":"<id>"}}`

#### personal.fachbereich.delete

Löschen: Katalog „Fachbereiche" (personal)

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

### Funktionen: `personal.funktion.*`

#### personal.funktion.list

Liste/Suche: Katalog „Funktionen" (personal)

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

#### personal.funktion.get

Detail: Katalog „Funktionen" (personal)

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

#### personal.funktion.create

Anlegen: Katalog „Funktionen" (personal)

- 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":"personal.funktion.create","input":{"label":"<label>"}}`

#### personal.funktion.update

Ändern: Katalog „Funktionen" (personal)

- 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":"personal.funktion.update","input":{"id":"<id>"}}`

#### personal.funktion.delete

Löschen: Katalog „Funktionen" (personal)

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

### Qualifikationsarten: `personal.qualifikationsart.*`

#### personal.qualifikationsart.list

Liste/Suche: Katalog „Qualifikationsarten" (personal)

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

#### personal.qualifikationsart.get

Detail: Katalog „Qualifikationsarten" (personal)

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

#### personal.qualifikationsart.create

Anlegen: Katalog „Qualifikationsarten" (personal)

- 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":"personal.qualifikationsart.create","input":{"label":"<label>"}}`

#### personal.qualifikationsart.update

Ändern: Katalog „Qualifikationsarten" (personal)

- 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":"personal.qualifikationsart.update","input":{"id":"<id>"}}`

#### personal.qualifikationsart.delete

Löschen: Katalog „Qualifikationsarten" (personal)

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

### Qualifikationsgruppen: `personal.quali_gruppe.*`

#### personal.quali_gruppe.list

Liste/Suche: Katalog „Qualifikationsgruppen" (personal)

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

#### personal.quali_gruppe.get

Detail: Katalog „Qualifikationsgruppen" (personal)

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

#### personal.quali_gruppe.create

Anlegen: Katalog „Qualifikationsgruppen" (personal)

- 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":"personal.quali_gruppe.create","input":{"label":"<label>"}}`

#### personal.quali_gruppe.update

Ändern: Katalog „Qualifikationsgruppen" (personal)

- 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":"personal.quali_gruppe.update","input":{"id":"<id>"}}`

#### personal.quali_gruppe.delete

Löschen: Katalog „Qualifikationsgruppen" (personal)

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

### Tarifgruppen: `personal.tarifgruppe.*`

#### personal.tarifgruppe.list

Liste/Suche: Katalog „Tarifgruppen" (personal)

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

#### personal.tarifgruppe.get

Detail: Katalog „Tarifgruppen" (personal)

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

#### personal.tarifgruppe.create

Anlegen: Katalog „Tarifgruppen" (personal)

- 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":"personal.tarifgruppe.create","input":{"label":"<label>"}}`

#### personal.tarifgruppe.update

Ändern: Katalog „Tarifgruppen" (personal)

- 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":"personal.tarifgruppe.update","input":{"id":"<id>"}}`

#### personal.tarifgruppe.delete

Löschen: Katalog „Tarifgruppen" (personal)

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

### Unfallarten: `personal.unfallart.*`

#### personal.unfallart.list

Liste/Suche: Katalog „Unfallarten" (personal)

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

#### personal.unfallart.get

Detail: Katalog „Unfallarten" (personal)

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

#### personal.unfallart.create

Anlegen: Katalog „Unfallarten" (personal)

- 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":"personal.unfallart.create","input":{"label":"<label>"}}`

#### personal.unfallart.update

Ändern: Katalog „Unfallarten" (personal)

- 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":"personal.unfallart.update","input":{"id":"<id>"}}`

#### personal.unfallart.delete

Löschen: Katalog „Unfallarten" (personal)

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

### Vergütungsarten: `personal.verguetungsart.*`

#### personal.verguetungsart.list

Liste/Suche: Katalog „Vergütungsarten" (personal)

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

#### personal.verguetungsart.get

Detail: Katalog „Vergütungsarten" (personal)

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

#### personal.verguetungsart.create

Anlegen: Katalog „Vergütungsarten" (personal)

- 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":"personal.verguetungsart.create","input":{"label":"<label>"}}`

#### personal.verguetungsart.update

Ändern: Katalog „Vergütungsarten" (personal)

- 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":"personal.verguetungsart.update","input":{"id":"<id>"}}`

#### personal.verguetungsart.delete

Löschen: Katalog „Vergütungsarten" (personal)

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

---

# API-Referenz Plattform-Stammdaten (App-Kennung core)

> 30 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/core/

## 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.

### Anrede: `core.anrede.*`

#### core.anrede.list

Liste/Suche: Katalog „Anrede" (core)

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

#### core.anrede.get

Detail: Katalog „Anrede" (core)

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

#### core.anrede.create

Anlegen: Katalog „Anrede" (core)

- 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":"core.anrede.create","input":{"label":"<label>"}}`

#### core.anrede.update

Ändern: Katalog „Anrede" (core)

- 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":"core.anrede.update","input":{"id":"<id>"}}`

#### core.anrede.delete

Löschen: Katalog „Anrede" (core)

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

### Bundesländer: `core.bundesland.*`

#### core.bundesland.list

Liste/Suche: Katalog „Bundesländer" (core)

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

#### core.bundesland.get

Detail: Katalog „Bundesländer" (core)

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

#### core.bundesland.create

Anlegen: Katalog „Bundesländer" (core)

- 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":"core.bundesland.create","input":{"label":"<label>"}}`

#### core.bundesland.update

Ändern: Katalog „Bundesländer" (core)

- 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":"core.bundesland.update","input":{"id":"<id>"}}`

#### core.bundesland.delete

Löschen: Katalog „Bundesländer" (core)

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

### Länder: `core.land.*`

#### core.land.list

Liste/Suche: Katalog „Länder" (core)

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

#### core.land.get

Detail: Katalog „Länder" (core)

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

#### core.land.create

Anlegen: Katalog „Länder" (core)

- 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":"core.land.create","input":{"label":"<label>"}}`

#### core.land.update

Ändern: Katalog „Länder" (core)

- 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":"core.land.update","input":{"id":"<id>"}}`

#### core.land.delete

Löschen: Katalog „Länder" (core)

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

### Sprachen: `core.sprache.*`

#### core.sprache.list

Liste/Suche: Katalog „Sprachen" (core)

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

#### core.sprache.get

Detail: Katalog „Sprachen" (core)

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

#### core.sprache.create

Anlegen: Katalog „Sprachen" (core)

- 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":"core.sprache.create","input":{"label":"<label>"}}`

#### core.sprache.update

Ändern: Katalog „Sprachen" (core)

- 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":"core.sprache.update","input":{"id":"<id>"}}`

#### core.sprache.delete

Löschen: Katalog „Sprachen" (core)

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

### Staatsangehörigkeit: `core.staatsangehoerigkeit.*`

#### core.staatsangehoerigkeit.list

Liste/Suche: Katalog „Staatsangehörigkeit" (core)

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

#### core.staatsangehoerigkeit.get

Detail: Katalog „Staatsangehörigkeit" (core)

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

#### core.staatsangehoerigkeit.create

Anlegen: Katalog „Staatsangehörigkeit" (core)

- 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":"core.staatsangehoerigkeit.create","input":{"label":"<label>"}}`

#### core.staatsangehoerigkeit.update

Ändern: Katalog „Staatsangehörigkeit" (core)

- 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":"core.staatsangehoerigkeit.update","input":{"id":"<id>"}}`

#### core.staatsangehoerigkeit.delete

Löschen: Katalog „Staatsangehörigkeit" (core)

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

### Titel: `core.titel.*`

#### core.titel.list

Liste/Suche: Katalog „Titel" (core)

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

#### core.titel.get

Detail: Katalog „Titel" (core)

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

#### core.titel.create

Anlegen: Katalog „Titel" (core)

- 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":"core.titel.create","input":{"label":"<label>"}}`

#### core.titel.update

Ändern: Katalog „Titel" (core)

- 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":"core.titel.update","input":{"id":"<id>"}}`

#### core.titel.delete

Löschen: Katalog „Titel" (core)

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

---

# API-Referenz Produkte (App-Kennung produkte)

> 42 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/produkte/

## 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.

### Artikel (Produkte): `produkte.artikel.*`

#### produkte.artikel.list

Liste/Suche: Artikel (Produkte)

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

#### produkte.artikel.get

Detail: Artikel (Produkte)

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

#### produkte.artikel.create

Anlegen: Artikel (Produkte)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Artikel anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `bezeichnung` (string, Pflicht)
  - `nummer` (string)
  - `ean` (string)
  - `herstellerArtikelnummer` (string)
  - `warengruppe` (string)
  - `statusCode` (string)
  - `beschreibung` (string)
  - `steuersatz` (number)
  - `bestand` (number)
  - `mindestbestand` (number)
  - `sollbestand` (number)
  - `lagerartikel` (boolean)
  - `planbar` (boolean)
  - `shopAktiv` (boolean)
  - `gesperrt` (boolean)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.artikel.create","input":{"bezeichnung":"<bezeichnung>"}}`

#### produkte.artikel.update

Ändern: Artikel (Produkte)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Artikel ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `bezeichnung` (string)
  - `nummer` (string)
  - `ean` (string)
  - `herstellerArtikelnummer` (string)
  - `warengruppe` (string)
  - `statusCode` (string)
  - `beschreibung` (string)
  - `steuersatz` (number)
  - `bestand` (number)
  - `mindestbestand` (number)
  - `sollbestand` (number)
  - `lagerartikel` (boolean)
  - `planbar` (boolean)
  - `shopAktiv` (boolean)
  - `gesperrt` (boolean)
  - `aktiv` (boolean)
- Beispiel: `{"name":"produkte.artikel.update","input":{"id":"<id>"}}`

#### produkte.artikel.delete

Löschen: Artikel (Produkte)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Artikel löschen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"produkte.artikel.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.

### Artikel-Status: `produkte.status.*`

#### produkte.status.list

Liste/Suche: Katalog „Artikel-Status" (produkte)

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

#### produkte.status.get

Detail: Katalog „Artikel-Status" (produkte)

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

#### produkte.status.create

Anlegen: Katalog „Artikel-Status" (produkte)

- 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":"produkte.status.create","input":{"label":"<label>"}}`

#### produkte.status.update

Ändern: Katalog „Artikel-Status" (produkte)

- 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":"produkte.status.update","input":{"id":"<id>"}}`

#### produkte.status.delete

Löschen: Katalog „Artikel-Status" (produkte)

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

### Buchungscodes: `produkte.buchungscode.*`

#### produkte.buchungscode.list

Liste/Suche: Katalog „Buchungscodes" (produkte)

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

#### produkte.buchungscode.get

Detail: Katalog „Buchungscodes" (produkte)

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

#### produkte.buchungscode.create

Anlegen: Katalog „Buchungscodes" (produkte)

- 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":"produkte.buchungscode.create","input":{"label":"<label>"}}`

#### produkte.buchungscode.update

Ändern: Katalog „Buchungscodes" (produkte)

- 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":"produkte.buchungscode.update","input":{"id":"<id>"}}`

#### produkte.buchungscode.delete

Löschen: Katalog „Buchungscodes" (produkte)

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

### Lagertypen: `produkte.lagertyp.*`

#### produkte.lagertyp.list

Liste/Suche: Katalog „Lagertypen" (produkte)

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

#### produkte.lagertyp.get

Detail: Katalog „Lagertypen" (produkte)

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

#### produkte.lagertyp.create

Anlegen: Katalog „Lagertypen" (produkte)

- 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":"produkte.lagertyp.create","input":{"label":"<label>"}}`

#### produkte.lagertyp.update

Ändern: Katalog „Lagertypen" (produkte)

- 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":"produkte.lagertyp.update","input":{"id":"<id>"}}`

#### produkte.lagertyp.delete

Löschen: Katalog „Lagertypen" (produkte)

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

### Mengeneinheiten: `produkte.mengeneinheit.*`

#### produkte.mengeneinheit.list

Liste/Suche: Katalog „Mengeneinheiten" (produkte)

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

#### produkte.mengeneinheit.get

Detail: Katalog „Mengeneinheiten" (produkte)

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

#### produkte.mengeneinheit.create

Anlegen: Katalog „Mengeneinheiten" (produkte)

- 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":"produkte.mengeneinheit.create","input":{"label":"<label>"}}`

#### produkte.mengeneinheit.update

Ändern: Katalog „Mengeneinheiten" (produkte)

- 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":"produkte.mengeneinheit.update","input":{"id":"<id>"}}`

#### produkte.mengeneinheit.delete

Löschen: Katalog „Mengeneinheiten" (produkte)

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

### Preistypen: `produkte.preistyp.*`

#### produkte.preistyp.list

Liste/Suche: Katalog „Preistypen" (produkte)

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

#### produkte.preistyp.get

Detail: Katalog „Preistypen" (produkte)

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

#### produkte.preistyp.create

Anlegen: Katalog „Preistypen" (produkte)

- 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":"produkte.preistyp.create","input":{"label":"<label>"}}`

#### produkte.preistyp.update

Ändern: Katalog „Preistypen" (produkte)

- 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":"produkte.preistyp.update","input":{"id":"<id>"}}`

#### produkte.preistyp.delete

Löschen: Katalog „Preistypen" (produkte)

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

### Prüfarten: `ressource.pruefart.*`

#### ressource.pruefart.list

Liste/Suche: Katalog „Prüfarten" (produkte)

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

#### ressource.pruefart.get

Detail: Katalog „Prüfarten" (produkte)

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

#### ressource.pruefart.create

Anlegen: Katalog „Prüfarten" (produkte)

- 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":"ressource.pruefart.create","input":{"label":"<label>"}}`

#### ressource.pruefart.update

Ändern: Katalog „Prüfarten" (produkte)

- 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":"ressource.pruefart.update","input":{"id":"<id>"}}`

#### ressource.pruefart.delete

Löschen: Katalog „Prüfarten" (produkte)

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

### Warengruppen: `produkte.warengruppe.*`

#### produkte.warengruppe.list

Liste/Suche: Katalog „Warengruppen" (produkte)

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

#### produkte.warengruppe.get

Detail: Katalog „Warengruppen" (produkte)

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

#### produkte.warengruppe.create

Anlegen: Katalog „Warengruppen" (produkte)

- 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":"produkte.warengruppe.create","input":{"label":"<label>"}}`

#### produkte.warengruppe.update

Ändern: Katalog „Warengruppen" (produkte)

- 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":"produkte.warengruppe.update","input":{"id":"<id>"}}`

#### produkte.warengruppe.delete

Löschen: Katalog „Warengruppen" (produkte)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### produkte.artikel.freigabe_list

Listet die Ziel-Mandanten, fuer die ein Artikel freigegeben ist (Cross-Tenant-Sichtbarkeit).

- Art: Lesen
- Rechte: Artikel lesen
- Datenklassen: B (intern)
- Datenschutz: Liest nur die Mandanten-Freigabe-Liste eines Artikels (Beziehungs-Metadaten, keine personenbezogenen Daten).
- Eingabe:
  - `artikelId` (string, Pflicht): Artikel-ID (produkte_artikel.id)
- Beispiel: `{"name":"produkte.artikel.freigabe_list","input":{"artikelId":"<artikelId>"}}`

#### produkte.artikel.freigabe_set

Setzt die Ziel-Mandanten, fuer die ein Artikel freigegeben ist (Replace; nur an AKTIVE Kooperations-Partner).

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Artikel ändern
- Datenklassen: B (intern)
- Datenschutz: Macht einen Artikel-Datensatz fuer fremde Mandanten sichtbar. Nur an aktive Kooperations-Partner, mit vertraglicher Grundlage.
- Eingabe:
  - `artikelId` (string, Pflicht): Artikel-ID (produkte_artikel.id)
  - `zielTenantIds` (string[]): Ziel-Tenant-IDs (aktive Kooperations-Partner). Leer = alle Freigaben entfernen
- Beispiel: `{"name":"produkte.artikel.freigabe_set","input":{"artikelId":"<artikelId>"}}`

---

# API-Referenz Seminare (App-Kennung seminar)

> 50 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/seminar/

## 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.

### Seminar-Katalog: `seminar.katalog.*`

#### seminar.katalog.list

Liste/Suche: Seminar-Katalog

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

#### seminar.katalog.get

Detail: Seminar-Katalog

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

#### seminar.katalog.create

Anlegen: Seminar-Katalog

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Seminar anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `nummer` (string)
  - `titel` (string, Pflicht)
  - `programmId` (string)
  - `kategorieCode` (string)
  - `typCode` (string)
  - `inhalt` (string)
  - `ziel` (string)
  - `zielgruppe` (string)
  - `methodik` (string)
  - `voraussetzungen` (string)
  - `zusatznutzen` (string)
  - `ansprechpartnerPersonId` (string)
  - `seoTitle` (string)
  - `seoDescription` (string)
  - `seoKeywords` (string)
  - `targetPage` (string)
  - `linkDetail` (string)
  - `online` (boolean)
- Beispiel: `{"name":"seminar.katalog.create","input":{"titel":"<titel>"}}`

#### seminar.katalog.update

Ändern: Seminar-Katalog

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Seminar ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `nummer` (string)
  - `titel` (string)
  - `programmId` (string)
  - `kategorieCode` (string)
  - `typCode` (string)
  - `inhalt` (string)
  - `ziel` (string)
  - `zielgruppe` (string)
  - `methodik` (string)
  - `voraussetzungen` (string)
  - `zusatznutzen` (string)
  - `ansprechpartnerPersonId` (string)
  - `seoTitle` (string)
  - `seoDescription` (string)
  - `seoKeywords` (string)
  - `targetPage` (string)
  - `linkDetail` (string)
  - `online` (boolean)
- Beispiel: `{"name":"seminar.katalog.update","input":{"id":"<id>"}}`

#### seminar.katalog.delete

Löschen: Seminar-Katalog

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

### Seminar-Programme: `seminar.programm.*`

#### seminar.programm.list

Liste/Suche: Seminar-Programme

- Art: Lesen
- Rechte: Seminar lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"seminar.programm.list","input":{}}`

#### seminar.programm.get

Detail: Seminar-Programme

- Art: Lesen
- Rechte: Seminar lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"seminar.programm.get","input":{"id":"<id>"}}`

#### seminar.programm.create

Anlegen: Seminar-Programme

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Seminar anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `bezeichnung` (string, Pflicht)
  - `code` (string)
  - `online` (boolean)
  - `seoTitle` (string)
- Beispiel: `{"name":"seminar.programm.create","input":{"bezeichnung":"<bezeichnung>"}}`

#### seminar.programm.update

Ändern: Seminar-Programme

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Seminar ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `bezeichnung` (string)
  - `code` (string)
  - `online` (boolean)
  - `seoTitle` (string)
- Beispiel: `{"name":"seminar.programm.update","input":{"id":"<id>"}}`

### Seminar-Veranstaltungen: `seminar.veranstaltung.*`

#### seminar.veranstaltung.list

Liste/Suche: Seminar-Veranstaltungen

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

#### seminar.veranstaltung.get

Detail: Seminar-Veranstaltungen

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

#### seminar.veranstaltung.create

Anlegen: Seminar-Veranstaltungen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Seminar anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `katalogId` (string)
  - `nummer` (string)
  - `bezeichnung` (string)
  - `statusCode` (string)
  - `typCode` (string)
  - `von` (string)
  - `bis` (string)
  - `uhrzeitVon` (string)
  - `uhrzeitBis` (string)
  - `raumId` (string)
  - `raumText` (string)
  - `ort` (string)
  - `plz` (string)
  - `dozentPersonId` (string)
  - `maxTeilnehmer` (number)
  - `steuersatz` (number)
  - `bestaetigtFrist` (string)
  - `intervallCode` (string)
  - `katalogNummer` (string): Verweis auf Katalog.nummer, wird zu Seminar-ID aufgelöst (Katalog muss zuerst importiert sein)
- Beispiel: `{"name":"seminar.veranstaltung.create","input":{}}`

#### seminar.veranstaltung.update

Ändern: Seminar-Veranstaltungen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Seminar ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `katalogId` (string)
  - `nummer` (string)
  - `bezeichnung` (string)
  - `statusCode` (string)
  - `typCode` (string)
  - `von` (string)
  - `bis` (string)
  - `uhrzeitVon` (string)
  - `uhrzeitBis` (string)
  - `raumId` (string)
  - `raumText` (string)
  - `ort` (string)
  - `plz` (string)
  - `dozentPersonId` (string)
  - `maxTeilnehmer` (number)
  - `steuersatz` (number)
  - `bestaetigtFrist` (string)
  - `intervallCode` (string)
  - `katalogNummer` (string): Verweis auf Katalog.nummer, wird zu Seminar-ID aufgelöst (Katalog muss zuerst importiert sein)
- Beispiel: `{"name":"seminar.veranstaltung.update","input":{"id":"<id>"}}`

#### seminar.veranstaltung.delete

Löschen: Seminar-Veranstaltungen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Seminar löschen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"seminar.veranstaltung.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.

### Abschlussarten: `seminar.abschluss.*`

#### seminar.abschluss.list

Liste/Suche: Katalog „Abschlussarten" (seminar)

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

#### seminar.abschluss.get

Detail: Katalog „Abschlussarten" (seminar)

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

#### seminar.abschluss.create

Anlegen: Katalog „Abschlussarten" (seminar)

- 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":"seminar.abschluss.create","input":{"label":"<label>"}}`

#### seminar.abschluss.update

Ändern: Katalog „Abschlussarten" (seminar)

- 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":"seminar.abschluss.update","input":{"id":"<id>"}}`

#### seminar.abschluss.delete

Löschen: Katalog „Abschlussarten" (seminar)

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

### Förderarten: `seminar.foerderung.*`

#### seminar.foerderung.list

Liste/Suche: Katalog „Förderarten" (seminar)

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

#### seminar.foerderung.get

Detail: Katalog „Förderarten" (seminar)

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

#### seminar.foerderung.create

Anlegen: Katalog „Förderarten" (seminar)

- 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":"seminar.foerderung.create","input":{"label":"<label>"}}`

#### seminar.foerderung.update

Ändern: Katalog „Förderarten" (seminar)

- 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":"seminar.foerderung.update","input":{"id":"<id>"}}`

#### seminar.foerderung.delete

Löschen: Katalog „Förderarten" (seminar)

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

### Kategorien: `seminar.kategorie.*`

#### seminar.kategorie.list

Liste/Suche: Katalog „Kategorien" (seminar)

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

#### seminar.kategorie.get

Detail: Katalog „Kategorien" (seminar)

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

#### seminar.kategorie.create

Anlegen: Katalog „Kategorien" (seminar)

- 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":"seminar.kategorie.create","input":{"label":"<label>"}}`

#### seminar.kategorie.update

Ändern: Katalog „Kategorien" (seminar)

- 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":"seminar.kategorie.update","input":{"id":"<id>"}}`

#### seminar.kategorie.delete

Löschen: Katalog „Kategorien" (seminar)

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

### Status: `seminar.status.*`

#### seminar.status.list

Liste/Suche: Katalog „Status" (seminar)

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

#### seminar.status.get

Detail: Katalog „Status" (seminar)

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

#### seminar.status.create

Anlegen: Katalog „Status" (seminar)

- 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":"seminar.status.create","input":{"label":"<label>"}}`

#### seminar.status.update

Ändern: Katalog „Status" (seminar)

- 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":"seminar.status.update","input":{"id":"<id>"}}`

#### seminar.status.delete

Löschen: Katalog „Status" (seminar)

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

### Storno-Gründe: `seminar.storno.*`

#### seminar.storno.list

Liste/Suche: Katalog „Storno-Gründe" (seminar)

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

#### seminar.storno.get

Detail: Katalog „Storno-Gründe" (seminar)

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

#### seminar.storno.create

Anlegen: Katalog „Storno-Gründe" (seminar)

- 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":"seminar.storno.create","input":{"label":"<label>"}}`

#### seminar.storno.update

Ändern: Katalog „Storno-Gründe" (seminar)

- 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":"seminar.storno.update","input":{"id":"<id>"}}`

#### seminar.storno.delete

Löschen: Katalog „Storno-Gründe" (seminar)

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

### Teilnehmer-Status: `seminar.tlnstatus.*`

#### seminar.tlnstatus.list

Liste/Suche: Katalog „Teilnehmer-Status" (seminar)

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

#### seminar.tlnstatus.get

Detail: Katalog „Teilnehmer-Status" (seminar)

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

#### seminar.tlnstatus.create

Anlegen: Katalog „Teilnehmer-Status" (seminar)

- 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":"seminar.tlnstatus.create","input":{"label":"<label>"}}`

#### seminar.tlnstatus.update

Ändern: Katalog „Teilnehmer-Status" (seminar)

- 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":"seminar.tlnstatus.update","input":{"id":"<id>"}}`

#### seminar.tlnstatus.delete

Löschen: Katalog „Teilnehmer-Status" (seminar)

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

### Veranstaltungstypen: `seminar.typ.*`

#### seminar.typ.list

Liste/Suche: Katalog „Veranstaltungstypen" (seminar)

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

#### seminar.typ.get

Detail: Katalog „Veranstaltungstypen" (seminar)

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

#### seminar.typ.create

Anlegen: Katalog „Veranstaltungstypen" (seminar)

- 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":"seminar.typ.create","input":{"label":"<label>"}}`

#### seminar.typ.update

Ändern: Katalog „Veranstaltungstypen" (seminar)

- 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":"seminar.typ.update","input":{"id":"<id>"}}`

#### seminar.typ.delete

Löschen: Katalog „Veranstaltungstypen" (seminar)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### seminar.register_teilnehmer

Meldet ein CRM-Konto (gbzId) als Teilnehmer zu einer Veranstaltung an. Bei Überbuchung → Warteliste. belegErzeugen=true legt zusätzlich einen Rechnungsbeleg an (mit Adressen + Mitgliedsrabatt).

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Seminar ändern, crm: Konto lesen
- Datenklassen: C (vertraulich)
- Datenschutz: Legt eine Buchung an + optional einen Beleg mit den Adressdaten des Kontos. Tenant-intern.
- Eingabe:
  - `veranstaltungId` (string, Pflicht): Veranstaltungs-ID
  - `gbzId` (string, Pflicht): CRM-Konto-ID (Teilnehmer/Organisation)
  - `gebuehrNetto` (number): Gebühr netto (optional, sonst aus VA)
  - `belegErzeugen` (boolean): true = Rechnungsbeleg miterzeugen
  - `mitgliedsrabatt` (number): Rabatt-Betrag überschreiben (optional)
- Beispiel: `{"name":"seminar.register_teilnehmer","input":{"veranstaltungId":"<veranstaltungId>","gbzId":"<gbzId>"}}`

---

# API-Referenz Verträge (App-Kennung vertraege)

> 20 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/vertraege/

## 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.

### Verträge: `vertraege.vertrag.*`

#### vertraege.vertrag.list

Liste/Suche: Verträge

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

#### vertraege.vertrag.get

Detail: Verträge

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

#### vertraege.vertrag.create

Anlegen: Verträge

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vertrag anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `nummer` (string)
  - `bezeichnung` (string, Pflicht)
  - `vertragsartCode` (string, Pflicht)
  - `statusCode` (string)
  - `kontoId` (string, Pflicht)
  - `kontaktId` (string)
  - `objektId` (string)
  - `rolleTenant` (string)
  - `gegenstand` (string)
  - `beginn` (string)
  - `ende` (string)
  - `laufzeitMonate` (number)
  - `autoVerlaengerung` (boolean)
  - `verlaengerungMonate` (number)
  - `kuendigungsfristMonate` (number)
  - `gekuendigtAm` (string)
  - `gekuendigtZum` (string)
  - `unterzeichnetAm` (string)
  - `wert` (number)
  - `waehrung` (string)
  - `abrechnungsrhythmus` (string)
  - `verantwortlichUserId` (string)
  - `bemerkung` (string)
- Beispiel: `{"name":"vertraege.vertrag.create","input":{"bezeichnung":"<bezeichnung>","vertragsartCode":"<vertragsartCode>","kontoId":"<kontoId>"}}`

#### vertraege.vertrag.update

Ändern: Verträge

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vertrag ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `nummer` (string)
  - `bezeichnung` (string)
  - `vertragsartCode` (string)
  - `statusCode` (string)
  - `kontoId` (string)
  - `kontaktId` (string)
  - `objektId` (string)
  - `rolleTenant` (string)
  - `gegenstand` (string)
  - `beginn` (string)
  - `ende` (string)
  - `laufzeitMonate` (number)
  - `autoVerlaengerung` (boolean)
  - `verlaengerungMonate` (number)
  - `kuendigungsfristMonate` (number)
  - `gekuendigtAm` (string)
  - `gekuendigtZum` (string)
  - `unterzeichnetAm` (string)
  - `wert` (number)
  - `waehrung` (string)
  - `abrechnungsrhythmus` (string)
  - `verantwortlichUserId` (string)
  - `bemerkung` (string)
- Beispiel: `{"name":"vertraege.vertrag.update","input":{"id":"<id>"}}`

#### vertraege.vertrag.delete

Löschen: Verträge

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

### Vertragspositionen: `vertraege.position.*`

#### vertraege.position.list

Liste/Suche: Vertragspositionen

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

#### vertraege.position.get

Detail: Vertragspositionen

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

#### vertraege.position.create

Anlegen: Vertragspositionen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vertrag ändern
- Datenklassen: B (intern)
- Eingabe:
  - `vertragId` (string, Pflicht)
  - `position` (number)
  - `artikelId` (string)
  - `bezeichnung` (string, Pflicht)
  - `beschreibung` (string)
  - `menge` (number)
  - `einheit` (string)
  - `einzelpreis` (number)
  - `rabattProzent` (number)
  - `intervall` (string)
  - `gesamt` (number)
- Beispiel: `{"name":"vertraege.position.create","input":{"vertragId":"<vertragId>","bezeichnung":"<bezeichnung>"}}`

#### vertraege.position.update

Ändern: Vertragspositionen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vertrag ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `vertragId` (string)
  - `position` (number)
  - `artikelId` (string)
  - `bezeichnung` (string)
  - `beschreibung` (string)
  - `menge` (number)
  - `einheit` (string)
  - `einzelpreis` (number)
  - `rabattProzent` (number)
  - `intervall` (string)
  - `gesamt` (number)
- Beispiel: `{"name":"vertraege.position.update","input":{"id":"<id>"}}`

#### vertraege.position.delete

Löschen: Vertragspositionen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Vertrag ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"vertraege.position.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.

### Vertragsarten: `vertraege.vertragsart.*`

#### vertraege.vertragsart.list

Liste/Suche: Katalog „Vertragsarten" (vertraege)

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

#### vertraege.vertragsart.get

Detail: Katalog „Vertragsarten" (vertraege)

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

#### vertraege.vertragsart.create

Anlegen: Katalog „Vertragsarten" (vertraege)

- 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":"vertraege.vertragsart.create","input":{"label":"<label>"}}`

#### vertraege.vertragsart.update

Ändern: Katalog „Vertragsarten" (vertraege)

- 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":"vertraege.vertragsart.update","input":{"id":"<id>"}}`

#### vertraege.vertragsart.delete

Löschen: Katalog „Vertragsarten" (vertraege)

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

### Vertragsstatus: `vertraege.status.*`

#### vertraege.status.list

Liste/Suche: Katalog „Vertragsstatus" (vertraege)

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

#### vertraege.status.get

Detail: Katalog „Vertragsstatus" (vertraege)

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

#### vertraege.status.create

Anlegen: Katalog „Vertragsstatus" (vertraege)

- 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":"vertraege.status.create","input":{"label":"<label>"}}`

#### vertraege.status.update

Ändern: Katalog „Vertragsstatus" (vertraege)

- 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":"vertraege.status.update","input":{"id":"<id>"}}`

#### vertraege.status.delete

Löschen: Katalog „Vertragsstatus" (vertraege)

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

---

# API-Referenz Vorlagen (App-Kennung textbausteine)

> 42 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/textbausteine/

## 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.

### Datenobjekte (Template-Entitäten): `textbausteine.datenobjekt.*`

#### textbausteine.datenobjekt.list

Liste/Suche: Datenobjekte (Template-Entitäten)

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

#### textbausteine.datenobjekt.get

Detail: Datenobjekte (Template-Entitäten)

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

#### textbausteine.datenobjekt.update

Ändern: Datenobjekte (Template-Entitäten)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateEntitaet ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `name` (string)
  - `isActive` (boolean)
- Beispiel: `{"name":"textbausteine.datenobjekt.update","input":{"id":"<id>"}}`

### Dokument-/Mail-Vorlagen: `textbausteine.vorlage.*`

#### textbausteine.vorlage.list

Liste/Suche: Dokument-/Mail-Vorlagen

- Art: Lesen
- Rechte: TemplateElement lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"textbausteine.vorlage.list","input":{}}`

#### textbausteine.vorlage.get

Detail: Dokument-/Mail-Vorlagen

- Art: Lesen
- Rechte: TemplateElement lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"textbausteine.vorlage.get","input":{"id":"<id>"}}`

#### textbausteine.vorlage.create

Anlegen: Dokument-/Mail-Vorlagen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateElement anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `name` (string, Pflicht)
  - `format` (string): PDF/WORD/EXCEL/PPTX/EMAIL. Werte: `PDF`, `WORD`, `EXCEL`, `PPTX`, `EMAIL`
  - `category` (string)
  - `app` (string)
  - `entityTypeId` (string)
  - `layoutId` (string)
  - `orientation` (string): Werte: `portrait`, `landscape`
  - `header` (string)
  - `footer` (string)
  - `mailMode` (string): marketing = visueller Block-Builder. Werte: `einfach`, `marketing`
  - `subject` (string)
  - `body` (string)
  - `senderAccountId` (string)
- Beispiel: `{"name":"textbausteine.vorlage.create","input":{"name":"<name>"}}`

#### textbausteine.vorlage.update

Ändern: Dokument-/Mail-Vorlagen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateElement ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `name` (string)
  - `format` (string): PDF/WORD/EXCEL/PPTX/EMAIL. Werte: `PDF`, `WORD`, `EXCEL`, `PPTX`, `EMAIL`
  - `category` (string)
  - `app` (string)
  - `entityTypeId` (string)
  - `layoutId` (string)
  - `orientation` (string): Werte: `portrait`, `landscape`
  - `header` (string)
  - `footer` (string)
  - `mailMode` (string): marketing = visueller Block-Builder. Werte: `einfach`, `marketing`
  - `subject` (string)
  - `body` (string)
  - `senderAccountId` (string)
- Beispiel: `{"name":"textbausteine.vorlage.update","input":{"id":"<id>"}}`

#### textbausteine.vorlage.delete

Löschen: Dokument-/Mail-Vorlagen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateElement löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"textbausteine.vorlage.delete","input":{"id":"<id>"}}`

### Dokument-Layouts: `textbausteine.layout.*`

#### textbausteine.layout.list

Liste/Suche: Dokument-Layouts

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

#### textbausteine.layout.get

Detail: Dokument-Layouts

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

#### textbausteine.layout.create

Anlegen: Dokument-Layouts

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: DokumentLayout anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `bezeichnung` (string, Pflicht)
  - `kategorie` (string)
  - `header` (string)
  - `fusszeile` (string)
- Beispiel: `{"name":"textbausteine.layout.create","input":{"bezeichnung":"<bezeichnung>"}}`

#### textbausteine.layout.update

Ändern: Dokument-Layouts

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: DokumentLayout ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `bezeichnung` (string)
  - `kategorie` (string)
  - `header` (string)
  - `fusszeile` (string)
- Beispiel: `{"name":"textbausteine.layout.update","input":{"id":"<id>"}}`

#### textbausteine.layout.delete

Löschen: Dokument-Layouts

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: DokumentLayout löschen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"textbausteine.layout.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.

### Dokument-Typen: `textbausteine.dokument_typ.*`

#### textbausteine.dokument_typ.list

Liste/Suche: Katalog „Dokument-Typen" (textbausteine)

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

#### textbausteine.dokument_typ.get

Detail: Katalog „Dokument-Typen" (textbausteine)

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

#### textbausteine.dokument_typ.create

Anlegen: Katalog „Dokument-Typen" (textbausteine)

- 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":"textbausteine.dokument_typ.create","input":{"label":"<label>"}}`

#### textbausteine.dokument_typ.update

Ändern: Katalog „Dokument-Typen" (textbausteine)

- 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":"textbausteine.dokument_typ.update","input":{"id":"<id>"}}`

#### textbausteine.dokument_typ.delete

Löschen: Katalog „Dokument-Typen" (textbausteine)

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

### Vorlagen-Kategorien: `textbausteine.vorlage_kategorie.*`

#### textbausteine.vorlage_kategorie.list

Liste/Suche: Katalog „Vorlagen-Kategorien" (textbausteine)

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

#### textbausteine.vorlage_kategorie.get

Detail: Katalog „Vorlagen-Kategorien" (textbausteine)

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

#### textbausteine.vorlage_kategorie.create

Anlegen: Katalog „Vorlagen-Kategorien" (textbausteine)

- 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":"textbausteine.vorlage_kategorie.create","input":{"label":"<label>"}}`

#### textbausteine.vorlage_kategorie.update

Ändern: Katalog „Vorlagen-Kategorien" (textbausteine)

- 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":"textbausteine.vorlage_kategorie.update","input":{"id":"<id>"}}`

#### textbausteine.vorlage_kategorie.delete

Löschen: Katalog „Vorlagen-Kategorien" (textbausteine)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### textbausteine.create_document_record

Legt einen Eintrag in der Versand-Dokumentbibliothek an

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: VersandDokument anlegen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Schreibt nur Dokument-Metadaten. Datei-Upload bleibt im vorhandenen Files-Service.
- Eingabe:
  - `titel` (string, Pflicht)
  - `typCode` (string)
  - `category` (string)
  - `mailbar` (boolean)
  - `beschreibung` (string)
- Beispiel: `{"name":"textbausteine.create_document_record","input":{"titel":"<titel>"}}`

#### textbausteine.create_layout

Legt ein Dokument-Layout fuer Vorlagen an

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: DokumentLayout anlegen
- Datenklassen: B (intern)
- Datenschutz: Schreibt Layout-Metadaten und optionale Header/Footer im aktiven Tenant.
- Eingabe:
  - `name` (string, Pflicht)
  - `category` (string)
  - `header` (string)
  - `footer` (string)
- Beispiel: `{"name":"textbausteine.create_layout","input":{"name":"<name>"}}`

#### textbausteine.create_sequenz

Legt eine Mail-Sequenz an (optional mit Schritten: Betreff/Text/Vorlage + Versatz in Tagen)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: MailSequenz anlegen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Schreibt Vorlage/Texte der Sequenz, keine personenbezogenen Empfänger.
- Eingabe:
  - `name` (string, Pflicht)
  - `steps` (object[])
- Beispiel: `{"name":"textbausteine.create_sequenz","input":{"name":"<name>"}}`

#### textbausteine.create_template

Legt Dokument-, Word-, Excel-, PPTX- oder Mail-Vorlagen fuer Chat/API/MCP an

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateElement anlegen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Schreibt eine Vorlage im aktiven Tenant. Freitext-Inhalte landen nicht im Tool-Audit.
- Eingabe:
  - `name` (string, Pflicht)
  - `format` (string): Werte: `PDF`, `WORD`, `EXCEL`, `PPTX`, `EMAIL`
  - `category` (string)
  - `app` (string)
  - `entityTypeId` (string)
  - `layoutId` (string)
  - `orientation` (string): Werte: `portrait`, `landscape`
  - `content` (string)
  - `body` (string)
  - `subject` (string)
  - `mailMode` (string): Werte: `einfach`, `marketing`
  - `mailBg` (string)
  - `mailWidth` (integer)
  - `reportId` (string)
  - `dataSource` (string): Kurzform: listPath fuer eine einzelne Positionstabelle (statt elements). z.B. "positionen"
  - `columns` (object[]): Spalten der Kurzform-Positionstabelle (nur mit dataSource). Pro Spalte field ODER template
  - `elements` (object[]): Voller Block-Baum (Vorrang vor content/dataSource). Block-Typen: RICH_TEXT {content:"<p>..${var}..</p>"} · DYNAMIC_TABLE {config:{dataSource:"<listPath>",showHeaders,borderStyle,headerBgColor,cellPadding,fontSize,columns:[{field|template,label,width,alignment,format}]}} · REPEATER {config:{dataSource},children:[...]} · LAYOUT_ROW{children:[{type:"LAYOUT_COLUMN",width,children:[...]}]} · PAGE_BREAK
  - `mailBlocks` (object[])
  - `attachmentTemplateIds` (string[])
- Beispiel: `{"name":"textbausteine.create_template","input":{"name":"<name>"}}`

#### textbausteine.enroll_in_sequenz

Schreibt einen Empfänger (E-Mail, optional CRM-Kontakt/Konto) in eine Sequenz ein; startet ab heute oder startAt

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: MailEnrollment anlegen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Verarbeitet die E-Mail-Adresse des Empfängers; löst getakteten Mailversand aus.
- Eingabe:
  - `sequenzId` (string, Pflicht)
  - `email` (string, Pflicht)
  - `kontaktId` (string)
  - `kontoId` (string)
  - `startAt` (string): ISO-Datum, ab dem Schritt 1 fällig wird (sonst sofort)
- Beispiel: `{"name":"textbausteine.enroll_in_sequenz","input":{"sequenzId":"<sequenzId>","email":"<email>"}}`

#### textbausteine.generate_document

Erzeugt aus einer Vorlage ein PDF, DOCX oder XLSX und legt die Datei im Files-Service ab

- Art: Export, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateElement lesen, TemplateElement exportieren
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Erzeugt eine Datei tenant-isoliert im Files-Service. Die Ausgabe kann Klasse-C-Fachdaten enthalten.
- Eingabe:
  - `templateId` (string, Pflicht)
  - `format` (string): Werte: `pdf`, `docx`, `xlsx`
  - `data` (object)
  - `variables` (object)
  - `filename` (string)
  - `ownerType` (string)
  - `ownerId` (string)
- Beispiel: `{"name":"textbausteine.generate_document","input":{"templateId":"<templateId>"}}`

#### textbausteine.list_documents

Listet kuratierte Versand-Dokumente aus der Dokumentenbibliothek

- Art: Lesen
- Rechte: VersandDokument lesen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Liefert Dokument-Metadaten und Datei-Referenzen, aber keine Datei-Inhalte.
- Eingabe: keine, `input` ist `{}`
- Beispiel: `{"name":"textbausteine.list_documents","input":{}}`

#### textbausteine.list_enrollments

Listet Sequenz-Läufe, entweder einer Sequenz (sequenzId) oder eines CRM-Kontos (kontoId), inkl. Fortschritt

- Art: Lesen
- Rechte: MailEnrollment lesen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Liefert Empfänger-Adressen + Status; keine Mail-Inhalte.
- Eingabe:
  - `sequenzId` (string)
  - `kontoId` (string)
- Beispiel: `{"name":"textbausteine.list_enrollments","input":{}}`

#### textbausteine.list_entities

Listet Datenobjekte fuer Vorlagen- und Excel-Erzeugung

- Art: Lesen
- Rechte: TemplateEntitaet lesen
- Datenklassen: B (intern)
- Datenschutz: Liefert Datenobjekt-Metadaten und Felddefinitionen, keine Fachdaten.
- Eingabe: keine, `input` ist `{}`
- Beispiel: `{"name":"textbausteine.list_entities","input":{}}`

#### textbausteine.list_layouts

Listet Dokument-Layouts fuer Vorlagen

- Art: Lesen
- Rechte: DokumentLayout lesen
- Datenklassen: B (intern)
- Datenschutz: Liefert Layout-Metadaten, keine generierten Dokumentinhalte.
- Eingabe: keine, `input` ist `{}`
- Beispiel: `{"name":"textbausteine.list_layouts","input":{}}`

#### textbausteine.list_sequenzen

Listet Mail-Sequenzen (Cadences) des Tenants mit Schritt- und Lauf-Anzahl

- Art: Lesen
- Rechte: MailSequenz lesen
- Datenklassen: B (intern)
- Datenschutz: Liefert nur Sequenz-Metadaten, keine Empfänger-Adressen.
- Eingabe: keine, `input` ist `{}`
- Beispiel: `{"name":"textbausteine.list_sequenzen","input":{}}`

#### textbausteine.list_templates

Listet Dokument-, Excel- und Mail-Vorlagen des aktiven Tenants

- Art: Lesen
- Rechte: TemplateElement lesen
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Liefert nur Vorlagen-Metadaten, keine generierten Dokumentinhalte.
- Eingabe:
  - `typ` (string): Werte: `PDF`, `WORD`, `EXCEL`, `PPTX`, `EMAIL`
  - `limit` (integer)
- Beispiel: `{"name":"textbausteine.list_templates","input":{}}`

#### textbausteine.send_mail_template

Versendet eine bestehende Textbaustein-Mailvorlage ueber den vorhandenen Tenant-Mail-Service

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateElement lesen, MailTemplate senden
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Rendert eine bestehende Mail-Vorlage und uebergibt sie an sendTemplatedMail. SMTP/Credentials bleiben im bestehenden Mail-Service.
- Eingabe:
  - `templateId` (string, Pflicht)
  - `to` (string, Pflicht)
  - `toName` (string)
  - `data` (object)
  - `variables` (object)
- Beispiel: `{"name":"textbausteine.send_mail_template","input":{"templateId":"<templateId>","to":"<to>"}}`

#### textbausteine.send_template_for_record

Robust: Mail-Vorlage mit echten Daten senden. Baut einen namespaced Multi-Entität-Kontext aus den mitgegebenen Records: ${konto.*} (kontoId), ${kontakt.*} (kontaktId), ${angebot.*} (belegId), ${absender.*} (absenderName/-Email, frei wählbar). Gate: bleibt ein ${…} unaufgelöst → KEIN Versand (Liste der fehlenden Felder). dryRun=true (Default) = Vorschau. Empfänger aus kontakt.email oder to. Absender: verbundenes Gmail-Konto (absenderEmail) → von dort, sonst Tenant-Default. Für Angebote mit PDF: /angebot (belege.versende).

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateElement lesen, MailTemplate senden
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Rendert eine Mail-Vorlage mit den echten Feldern der gewählten Records (Konto/Kontakt/Beleg) + frei wählbarem Absender und versendet. Versand nur bei dryRun=false und placeholder-frei.
- Eingabe:
  - `templateId` (string, Pflicht)
  - `kontoId` (string): CRM-Konto → ${konto.*}
  - `kontaktId` (string): Ansprechpartner → ${kontakt.*} (auch Default-Empfänger via kontakt.email)
  - `belegId` (string): Beleg/Angebot → ${angebot.*}
  - `belegPdf` (boolean): true = Angebot-PDF aus dem Beleg (belegId) rendern + anhängen (für /angebot). Braucht ein Gmail-Konto (absenderEmail)
  - `absenderName` (string): Absender-Name → ${absender.name} (frei wählbar)
  - `absenderEmail` (string): Absender-Email → ${absender.email}; ist es ein verbundenes Gmail-Konto, wird VON dort gesendet
  - `to` (string): Empfänger-Override; sonst kontakt.email
  - `toName` (string)
  - `dryRun` (boolean): Default true (Vorschau + Platzhalter-Check). false = echter Versand
- Beispiel: `{"name":"textbausteine.send_template_for_record","input":{"templateId":"<templateId>"}}`

#### textbausteine.set_enrollment_status

Setzt den Status eines Sequenz-Laufs: pausiert | aktiv (fortsetzen) | gestoppt

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: MailEnrollment ändern
- Datenklassen: B (intern)
- Datenschutz: Ändert nur den Lauf-Status, keine personenbezogenen Inhalte.
- Eingabe:
  - `enrollmentId` (string, Pflicht)
  - `status` (string, Pflicht): Werte: `aktiv`, `pausiert`, `gestoppt`
  - `grund` (string)
- Beispiel: `{"name":"textbausteine.set_enrollment_status","input":{"enrollmentId":"<enrollmentId>","status":"aktiv"}}`

#### textbausteine.update_document_record

Aktualisiert einen Eintrag in der Versand-Dokumentbibliothek

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: VersandDokument ändern
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Aendert nur Dokument-Metadaten. Datei-Inhalte bleiben im vorhandenen Files-Service.
- Eingabe:
  - `documentId` (string, Pflicht)
  - `titel` (string)
  - `typCode` (string)
  - `category` (string)
  - `mailbar` (boolean)
  - `beschreibung` (string)
- Beispiel: `{"name":"textbausteine.update_document_record","input":{"documentId":"<documentId>"}}`

#### textbausteine.update_layout

Aktualisiert ein Dokument-Layout

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: DokumentLayout ändern
- Datenklassen: B (intern)
- Datenschutz: Aendert Layout-Metadaten und optionale Header/Footer im aktiven Tenant.
- Eingabe:
  - `layoutId` (string, Pflicht)
  - `name` (string, Pflicht)
  - `category` (string)
  - `header` (string)
  - `footer` (string)
- Beispiel: `{"name":"textbausteine.update_layout","input":{"layoutId":"<layoutId>","name":"<name>"}}`

#### textbausteine.update_template

Aktualisiert eine bestehende Vorlage, inklusive Mail-, Marketing-, Dokument- und Excel-Inhalt

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateElement ändern
- Datenklassen: B (intern), C (vertraulich)
- Datenschutz: Aendert eine Vorlage im aktiven Tenant. Freitext-Inhalte landen nicht im Tool-Audit.
- Eingabe:
  - `templateId` (string, Pflicht)
  - `name` (string)
  - `format` (string): Werte: `PDF`, `WORD`, `EXCEL`, `PPTX`, `EMAIL`
  - `category` (string)
  - `app` (string)
  - `entityTypeId` (string)
  - `layoutId` (string)
  - `orientation` (string): Werte: `portrait`, `landscape`
  - `content` (string)
  - `body` (string)
  - `subject` (string)
  - `mailMode` (string): Werte: `einfach`, `marketing`
  - `mailBg` (string)
  - `mailWidth` (integer)
  - `reportId` (string)
  - `dataSource` (string): Kurzform: listPath fuer eine einzelne Positionstabelle (statt elements). z.B. "positionen"
  - `columns` (object[]): Spalten der Kurzform-Positionstabelle (nur mit dataSource). Pro Spalte field ODER template
  - `elements` (object[]): Voller Block-Baum (Vorrang vor content/dataSource). Block-Typen: RICH_TEXT {content:"<p>..${var}..</p>"} · DYNAMIC_TABLE {config:{dataSource:"<listPath>",showHeaders,borderStyle,headerBgColor,cellPadding,fontSize,columns:[{field|template,label,width,alignment,format}]}} · REPEATER {config:{dataSource},children:[...]} · LAYOUT_ROW{children:[{type:"LAYOUT_COLUMN",width,children:[...]}]} · PAGE_BREAK
  - `mailBlocks` (object[])
  - `attachmentTemplateIds` (string[])
- Beispiel: `{"name":"textbausteine.update_template","input":{"templateId":"<templateId>"}}`

#### textbausteine.upsert_entity

Legt ein Datenobjekt (Entity) an oder aktualisiert es, inkl. Datenquellen (Tabelle+Alias+Felder), Joins, Filter, Parameter. NICHT fuer Belege/CRM-Personendaten verwenden (Datenschutz: Belege binden direkt an den Beleg-Kontext, ohne Datenobjekt).

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: TemplateEntitaet ändern
- Datenklassen: B (intern)
- Datenschutz: Schreibt eine Datenobjekt-Definition (Metadaten/Struktur) im aktiven Tenant. Keine Fachdaten.
- Eingabe:
  - `id` (string): Vorhandene Entity-ID zum Aktualisieren; weglassen = neu anlegen
  - `name` (string, Pflicht)
  - `isActive` (boolean)
  - `dataSources` (object[], Pflicht): Datenquellen. Erste = Basistabelle
  - `joins` (object[])
  - `filters` (object[])
  - `parameters` (object[])
- Beispiel: `{"name":"textbausteine.upsert_entity","input":{"name":"<name>","dataSources":[]}}`

---

# API-Referenz Wissen (App-Kennung wissen)

> 5 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/wissen/

## 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.

### Wissen: `wissen.eintrag.*`

#### wissen.eintrag.list

Liste/Suche: Wissen

- Art: Lesen
- Rechte: Wissen lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"wissen.eintrag.list","input":{}}`

#### wissen.eintrag.get

Detail: Wissen

- Art: Lesen
- Rechte: Wissen lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"wissen.eintrag.get","input":{"id":"<id>"}}`

#### wissen.eintrag.create

Anlegen: Wissen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Wissen anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `inhalt` (string)
  - `typ` (string)
  - `quelle` (string)
  - `ownerType` (string)
  - `ownerId` (string)
  - `status` (string)
- Beispiel: `{"name":"wissen.eintrag.create","input":{"titel":"<titel>"}}`

#### wissen.eintrag.update

Ändern: Wissen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Wissen ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `inhalt` (string)
  - `typ` (string)
  - `quelle` (string)
  - `ownerType` (string)
  - `ownerId` (string)
  - `status` (string)
- Beispiel: `{"name":"wissen.eintrag.update","input":{"id":"<id>"}}`

#### wissen.eintrag.delete

Löschen: Wissen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Wissen löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"wissen.eintrag.delete","input":{"id":"<id>"}}`

---

# API-Referenz Workflows (App-Kennung workflows)

> 9 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/workflows/

## 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.

### Workflow-Vorlagen: `workflows.template.*`

#### workflows.template.list

Liste/Suche: Workflow-Vorlagen

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

#### workflows.template.get

Detail: Workflow-Vorlagen

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

### Workflows (Flows): `workflows.flow.*`

#### workflows.flow.list

Liste/Suche: Workflows (Flows)

- Art: Lesen
- Rechte: Flow lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"workflows.flow.list","input":{}}`

#### workflows.flow.get

Detail: Workflows (Flows)

- Art: Lesen
- Rechte: Flow lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"workflows.flow.get","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.

### Flow-Kategorien: `workflows.kategorie.*`

#### workflows.kategorie.list

Liste/Suche: Katalog „Flow-Kategorien" (workflows)

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

#### workflows.kategorie.get

Detail: Katalog „Flow-Kategorien" (workflows)

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

#### workflows.kategorie.create

Anlegen: Katalog „Flow-Kategorien" (workflows)

- 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":"workflows.kategorie.create","input":{"label":"<label>"}}`

#### workflows.kategorie.update

Ändern: Katalog „Flow-Kategorien" (workflows)

- 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":"workflows.kategorie.update","input":{"id":"<id>"}}`

#### workflows.kategorie.delete

Löschen: Katalog „Flow-Kategorien" (workflows)

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

---

# API-Referenz Ziele & Entwicklung (App-Kennung entwicklung)

> 32 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/entwicklung/

## 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.

### Gespräche: `entwicklung.gespraech.*`

#### entwicklung.gespraech.list

Liste/Suche: Gespräche

- Art: Lesen
- Rechte: Gespraech lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"entwicklung.gespraech.list","input":{}}`

#### entwicklung.gespraech.get

Detail: Gespräche

- Art: Lesen
- Rechte: Gespraech lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"entwicklung.gespraech.get","input":{"id":"<id>"}}`

### Ziele: `entwicklung.ziel.*`

#### entwicklung.ziel.list

Liste/Suche: Ziele

- Art: Lesen
- Rechte: Ziel lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"entwicklung.ziel.list","input":{}}`

#### entwicklung.ziel.get

Detail: Ziele

- Art: Lesen
- Rechte: Ziel lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"entwicklung.ziel.get","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.

### Bewertungsskalen: `entwicklung.skala.*`

#### entwicklung.skala.list

Liste/Suche: Katalog „Bewertungsskalen" (entwicklung)

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

#### entwicklung.skala.get

Detail: Katalog „Bewertungsskalen" (entwicklung)

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

#### entwicklung.skala.create

Anlegen: Katalog „Bewertungsskalen" (entwicklung)

- 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":"entwicklung.skala.create","input":{"label":"<label>"}}`

#### entwicklung.skala.update

Ändern: Katalog „Bewertungsskalen" (entwicklung)

- 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":"entwicklung.skala.update","input":{"id":"<id>"}}`

#### entwicklung.skala.delete

Löschen: Katalog „Bewertungsskalen" (entwicklung)

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

### Gesprächstypen: `entwicklung.typ.*`

#### entwicklung.typ.list

Liste/Suche: Katalog „Gesprächstypen" (entwicklung)

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

#### entwicklung.typ.get

Detail: Katalog „Gesprächstypen" (entwicklung)

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

#### entwicklung.typ.create

Anlegen: Katalog „Gesprächstypen" (entwicklung)

- 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":"entwicklung.typ.create","input":{"label":"<label>"}}`

#### entwicklung.typ.update

Ändern: Katalog „Gesprächstypen" (entwicklung)

- 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":"entwicklung.typ.update","input":{"id":"<id>"}}`

#### entwicklung.typ.delete

Löschen: Katalog „Gesprächstypen" (entwicklung)

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

### Kompetenzen: `entwicklung.kompetenz.*`

#### entwicklung.kompetenz.list

Liste/Suche: Katalog „Kompetenzen" (entwicklung)

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

#### entwicklung.kompetenz.get

Detail: Katalog „Kompetenzen" (entwicklung)

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

#### entwicklung.kompetenz.create

Anlegen: Katalog „Kompetenzen" (entwicklung)

- 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":"entwicklung.kompetenz.create","input":{"label":"<label>"}}`

#### entwicklung.kompetenz.update

Ändern: Katalog „Kompetenzen" (entwicklung)

- 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":"entwicklung.kompetenz.update","input":{"id":"<id>"}}`

#### entwicklung.kompetenz.delete

Löschen: Katalog „Kompetenzen" (entwicklung)

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

### Zielarten: `entwicklung.zielart.*`

#### entwicklung.zielart.list

Liste/Suche: Katalog „Zielarten" (entwicklung)

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

#### entwicklung.zielart.get

Detail: Katalog „Zielarten" (entwicklung)

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

#### entwicklung.zielart.create

Anlegen: Katalog „Zielarten" (entwicklung)

- 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":"entwicklung.zielart.create","input":{"label":"<label>"}}`

#### entwicklung.zielart.update

Ändern: Katalog „Zielarten" (entwicklung)

- 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":"entwicklung.zielart.update","input":{"id":"<id>"}}`

#### entwicklung.zielart.delete

Löschen: Katalog „Zielarten" (entwicklung)

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

### Zielkategorien: `entwicklung.zielkategorie.*`

#### entwicklung.zielkategorie.list

Liste/Suche: Katalog „Zielkategorien" (entwicklung)

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

#### entwicklung.zielkategorie.get

Detail: Katalog „Zielkategorien" (entwicklung)

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

#### entwicklung.zielkategorie.create

Anlegen: Katalog „Zielkategorien" (entwicklung)

- 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":"entwicklung.zielkategorie.create","input":{"label":"<label>"}}`

#### entwicklung.zielkategorie.update

Ändern: Katalog „Zielkategorien" (entwicklung)

- 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":"entwicklung.zielkategorie.update","input":{"id":"<id>"}}`

#### entwicklung.zielkategorie.delete

Löschen: Katalog „Zielkategorien" (entwicklung)

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

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### entwicklung.upsert_gespraech

Legt ein Gespräch an oder ändert es (id optional). Person + Typ + Status. Bearbeitung läuft durch den Service.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Gespraech ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string): Gespräch-ID (leer = neu anlegen)
  - `data` (object, Pflicht): Felder: personId, titel, typCode, status, betreuerUserId, datumGeplant, zusammenfassung, leistungWert, potenzialWert, risikoFlag, risikoGrund, naechstesGespraechAm
- Beispiel: `{"name":"entwicklung.upsert_gespraech","input":{"data":{}}}`

#### entwicklung.upsert_ziel

Legt ein Ziel an oder ändert es (id optional). Erreichungsgrad wird bei quantitativen Zielen automatisch berechnet.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ziel ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string): Ziel-ID (leer = neu anlegen)
  - `data` (object, Pflicht): Felder: personId, titel, art (qualitativ|quantitativ), ebene, kategorieCode, vereinbarung, zieldefinition, messgroesse, einheit, zielwert, istwert, gewichtung, skalaCode, status, zielDatum, gespraechId
- Beispiel: `{"name":"entwicklung.upsert_ziel","input":{"data":{}}}`

#### entwicklung.ziel_checkin

Bucht einen Fortschritts-Check-in auf ein Ziel. Spiegelt istwert/Erreichungsgrad auf das Ziel (Rechenlogik im Service).

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ziel ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `zielId` (string, Pflicht): Ziel-ID
  - `erreichungsgrad` (number): Erreichungsgrad in % (0..100+)
  - `istwert` (number): Aktueller Ist-Wert (bei quantitativen Zielen)
  - `kommentar` (string): Notiz zum Check-in
- Beispiel: `{"name":"entwicklung.ziel_checkin","input":{"zielId":"<zielId>"}}`