# 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":{}}`