Aufgabe anlegen¶

Aufgaben werden über den NotepadController der Laravel-API angelegt. Eine Aufgabe ist ein Notepad-Eintrag ohne Reparaturverknüpfung (entry_type = task).

Anlegen über die API¶

POST /api/v2/notepads

Feld	Pflicht	Beschreibung
`comment`	Ja	Aufgabentext (bis 2048 Zeichen)
`date_time`	Nein	Fälligkeitsdatum/-zeit (Standard: jetzt)
`status`	Nein	Status (Statustyp `notepad`, Standard: `new`)
`assigned_to`	Nein	Zugewiesener Bearbeiter (Benutzer-ID)
`assigned_to_group`	Nein	Zugewiesene Gruppe
`additional_recipients`	Nein	Weitere Empfänger (Liste von Benutzer-IDs)
`inventory_id`	Nein	Verknüpftes Inventargerät
`customer_id`	Nein	Verknüpfter Kunde
`contact_id`	Nein	Verknüpfter Kontakt
`repair_id`	Nein	Verknüpfte Reparatur — macht den Eintrag zur Wartungserinnerung

Priorität

Das V2-Datenmodell kennt keine separate Prioritätsspalte. Dringlichkeit wird über das Fälligkeitsdatum (date_time) und den Status (status) abgebildet.

Anlegen aus dem Kalender¶

Über den Kalender lässt sich eine Aufgabe in einem Schritt für mehrere Inventargeräte anlegen (je Gerät entsteht ein eigener Eintrag, der Kunde wird vom Gerät übernommen):

POST /api/v2/notepads/calendar

Feld	Pflicht	Beschreibung
`comment`	Ja	Aufgabentext
`inventory_ids`	Ja	Liste von Inventargeräten (je Gerät ein Eintrag)
`date_time`	Ja	Fälligkeitsdatum/-zeit
`assigned_to`	Nein	Zugewiesener Bearbeiter
`contact_id`	Nein	Verknüpfter Kontakt
`status`	Nein	Status (Standard: `new`)

Status-Workflow¶

Der Status folgt dem konfigurierten Status-System (Statustyp notepad). Ein Statuswechsel erfolgt über:

POST /api/v2/notepads/{id}/status

Fehlen dabei Pflichtfelder des Zielstatus, antwortet die API mit 422 und der Liste der benötigten Felder; diese werden über POST /api/v2/notepads/{id}/additional-fields nachgereicht.

Berechtigungen¶

Zum Anlegen und Bearbeiten ist die Berechtigung notepad_edit erforderlich.