Assistent: Tagesüberblick, Termine anlegen, Kundenakte

Neben den Bereichen, die eins zu eins den Tabellen entsprechen, hat die Schnittstelle eine Handvoll Pfade für den Arbeitsalltag. Sie sind für Sprachassistenten gebaut (etwa einen MCP-Server, der die Software an ein Sprachmodell anschließt), aber du kannst sie genauso aus jedem anderen Programm aufrufen. Zwei Dinge unterscheiden sie von den normalen Bereichen: Sie liefern aufgelöste, kurze Antworten — Namen statt Kennungen, nur gefüllte Felder, immer mit der Heute-Zeile davor — und alles Schreibende läuft zuerst als Probelauf.

Lesen

Pfad	Liefert
`GET /api/v1/_ueberblick?datum=2026-09-15`	Alles für einen Tag: Termine aller Arten (deine eigenen markiert), Belegung von Tagesstätte, Pension und Stundenbetreuung, offene Anfragen, fällige Aufgaben, offene und überfällige Rechnungen. Ohne `datum` ist es heute.
`GET /api/v1/_termine?von=…&bis=…`	Termine in einem Zeitraum, wahlweise für einen Kunden (`id_contact`), ein Tier (`id_pet`) oder einen Mitarbeiter (`id_employee`). Höchstens 92 Tage und 50 Zeilen.
`GET /api/v1/_freie_zeiten?datum=…&id_employee=…&minuten=60`	Wann ein Mitarbeiter an einem Tag noch Zeit hat: belegte Blöcke, freie Fenster und konkrete Startzeiten. Ohne `id_employee` ist es der Mitarbeiter, dem der Schlüssel gehört.
`GET /api/v1/_belegung?von=…&bis=…`	Belegung je Tag: belegt, Plätze, frei — bei der Pension mit An- und Abreisen.
`GET /api/v1/_anfragen`	Alles, was auf dich wartet: Terminanfragen, Pensions- und Tagesstättenanfragen, Stornowünsche, Kündigungen, Abo-Anfragen, Freischaltungen.
`GET /api/v1/contacts/suche?q=Meier`	Kundensuche nach Name, Firma, E-Mail, Kundennummer oder Ort — mit den Tieren je Treffer. Mit `?telefon=0171…` auch nach Telefonnummer, egal wie sie geschrieben ist.
`GET /api/v1/contacts/{id}/akte`	Die Kurzakte eines Kunden: Anschrift, Tiere, Abos und Stempelkarten mit Reststand, offene Rechnungen, letzte und nächste Termine, letzte Vermerke.
`GET /api/v1/services/buchbar`	Die Leistungen, mit denen ein Termin angelegt werden kann — mit Dauer, Preis und Terminart.

Jede Antwort beginnt mit heute (Datum, Wochentag, Uhrzeit). Termine tragen den Wochentag im Feld tag. Datum gibst du immer als JJJJ-MM-TT an, Uhrzeiten als HH:MM. Texte, die Kunden selbst geschrieben haben (Anfragetexte, Kommentare), kommen hier nie mit — nur Namen, Zahlen, Daten und Zustände.

Schreiben: erst Probelauf, dann ausführen

Fünf Aktionen legen an oder ändern etwas: POST /api/v1/coachingappointments/anlegen (Einzeltermin), POST /api/v1/coachingappointments/{id}/verschieben, POST /api/v1/coachingappointments/{id}/serie (wiederkehrende Termine), POST /api/v1/groupappointments/anlegen (Gruppentermin), POST /api/v1/contacts/anlegen (Kunde) und POST /api/v1/pets/anlegen (Tier).

Alle folgen demselben Muster. Ohne "ausfuehren": true passiert nichts — du bekommst die aufgelöste Zusammenfassung zurück und siehst, was angelegt würde:

POST /api/v1/coachingappointments/anlegen
{ "id_customer": 4711, "id_service": 55, "datum": "2026-09-15", "uhrzeit": "10:00" }

→ { "probelauf": true, "gespeichert": false,
    "termin": { "tag": "Di 15.09.2026", "von": "10:00", "bis": "11:00",
                "leistung": "Physio", "kunde": "Meier, Anna", "tier": "Bello",
                "mitarbeiter": "Muster, Maxine", "ort": "Praxis",
                "zahlweg": "Stempelkarte „Physio 10er“ (noch 4 von 10, nach dem Termin 3)" },
    "naechster_schritt": "Zum Speichern denselben Aufruf mit \"ausfuehren\": true wiederholen." }

Derselbe Aufruf mit "ausfuehren": true legt den Termin an — genau so, wie es das Formular in der Software täte: Terminart und Dauer kommen aus der Leistung, der Zahlweg läuft über Abo, Stempelkarte oder Rechnungsposition, Kalender werden nachgezogen. Was dabei nicht passiert: Es geht keine Terminbestätigung an den Kunden. Wenn du eine willst, verschickst du sie aus der Software.

Ein paar Regeln, die dir Arbeit abnehmen:

Hat der Kunde genau ein Tier, wird es genommen. Hat er mehrere, bekommst du eine Rückfrage mit der Liste und gibst id_pet an.
Der Mitarbeiter ist, wenn du nichts angibst, der Inhaber des Schlüssels.
Überschneidungen (Mitarbeiter, Ort), Urlaub und Sperrzeiten stehen unter konflikte. Beim Ausführen blocken sie mit dem Fehler 409 — außer du gibst "trotzdem": true mit.
Ein zweiter Aufruf mit gleichem Kunden, gleicher Leistung und gleichem Zeitpunkt legt keinen zweiten Termin an, sondern meldet den vorhandenen.
Bei Kunde und Tier prüft der Probelauf auf Dubletten (gleicher Name, gleiche E-Mail).

Für die Lesepfade braucht ein Schlüssel die Stufe „Mitarbeiter“; ist er auf Bereiche beschränkt, muss assistent in der Liste stehen. Rechnungsangaben sieht nur ein Schlüssel der Stufe „Buchhaltung“ — andere bekommen an der Stelle einen Hinweis statt Zahlen.

Assistent: Tagesüberblick, Termine anlegen, Kundenakte