# `calendar_event` — Kalendereintrag anlegen

**Zweck:** Legt vollautomatisch (ohne Benutzerinteraktion) einen Ereignis-Eintrag an — Termin, Frist oder Vermerk — und verknüpft ihn mit einem Bezugsobjekt (z. B. Maßnahme, Person, Verfahren, Vertrag). Optional können Erinnerungen für Personen hinterlegt werden.

**Parameter**

| Name | Pflicht? | Default | Beschreibung |
|---|---|---|---|
| `referenz_typ` | **ja** | — | Typ des Bezugsobjekts, z. B. `Massnahme`, `Person`, `TG`, `Vertrag` |
| `referenz_id` | **ja** | — | ID/Hash des Bezugsobjekts (als String) |
| `subart` | nein | — | Subkategorie, z. B. `Frist` |
| `kommentar` | nein | — | Text/Inhalt des Eintrags |
| `datum` | nein | *jetzt* | Termin-Datum |
| `frist` | nein | *(keine)* | Fristdatum |
| `kosten` | nein | `0` | Kostenangabe (Komma oder Punkt als Dezimaltrenner) |
| `person` | nein | — | Numerische ID des Erstellers, z. B. `{{ICH.id}}` |
| `zuerinnern` | nein | — | CSV numerischer Personen-IDs, die erinnert werden sollen |
| `output_var` | nein | `ereignis_id` | Prefix der Ausgabevariablen |

**Eingangswerte:** Datumsangaben akzeptieren Unix-Timestamp (rein numerisch), ISO-Format (`2026-05-20` oder `2026-05-20 09:00`) oder relative Angaben (`+14 days`, `monday 09:00`).

**Ausgangswerte:**
- `<prefix>` — ID des neuen Eintrags
- `<prefix>_datum` — formatiertes Datum `d.m.Y` (z. B. für Mails)
- `<prefix>_frist` — formatierte Frist `d.m.Y` (oder leer)

```xml
<task type="calendar_event" id="frist_setzen">
  <config>
    <referenz_typ>Massnahme</referenz_typ>
    <referenz_id>{{massnahme_id}}</referenz_id>
    <subart>Frist</subart>
    <kommentar>{{betreff}}</kommentar>
    <frist>+14 days</frist>
    <zuerinnern>{{gewaehlte_person}}</zuerinnern>
  </config>
</task>
```