Termin stornieren

Storniert einen bestehenden Termin. Der Termin bleibt in der Datenbank erhalten und wird mit deleted: true markiert.

Request

POST /api/oauth/v2/resource/appointments/{uuid}/cancel

Header

Header	Wert
Authorization	Bearer {access_token}
Content-Type	application/json

Erforderlicher Scope: appointments. Für Kurs-Termine zusätzlich customers.

URL-Parameter

Parameter	Typ	Pflicht	Beschreibung
uuid	string (UUID)	Ja	UUID des zu stornierenden Termins

Request-Body

{
  "reason": "Kunde hat abgesagt",
  "notify": false
}

Request-Felder

Feld	Typ	Pflicht	Beschreibung
reason	string	Nein	Storno-Grund
notify	boolean	Nein	Benachrichtigung steuern. Standard: false für vergangene Termine, sonst gemäß Unternehmenseinstellungen.

Response

Erfolg (200 OK)

{
  "data": {
    "id": "d4e5f6a7-b8c9-0123-defa-123456789012",
    "title": "Erstordination – Anna Muster",
    "start": "2026-04-02T09:00:00+02:00",
    "end": "2026-04-02T10:00:00+02:00",
    "allDay": false,
    "status": "active",
    "type": "customer",
    "note": "Bitte nüchtern erscheinen",
    "customer": {
      "id": "e5f6a7b8-c9d0-1234-efab-234567890123",
      "firstName": "Anna",
      "lastName": "Muster"
    },
    "service": {
      "id": "c3d4e5f6-a7b8-9012-cdef-012345678901",
      "name": "Erstordination"
    },
    "course": null,
    "source": "oauth",
    "deleted": true,
    "deletedAt": "2026-04-01T15:00:00+02:00",
    "stornoReason": "Kunde hat abgesagt",
    "createdAt": "2026-04-01T14:23:00+02:00",
    "updatedAt": "2026-04-01T15:00:00+02:00"
  }
}

Response-Felder

Feld	Typ	Beschreibung
data.id	string (UUID)	Eindeutige Termin-ID
data.title	string	Termintitel
data.start	string (ISO 8601)	Startzeit
data.end	string (ISO 8601)	Endzeit
data.allDay	boolean	Ganztägiger Termin
data.status	string	Terminstatus (active oder request)
data.type	string	Termintyp (z.B. customer)
data.note	string | null	Interne Notiz zum Termin
data.customer	object | null	Verknüpfter Kunde
data.customer.id	string (UUID)	Kunden-ID
data.customer.firstName	string	Vorname
data.customer.lastName	string	Nachname
data.service	object | null	Gebuchte Leistung
data.service.id	string (UUID)	Leistungs-ID
data.service.name	string	Name der Leistung
data.course	object | null	Verknüpfter Kurs (falls Termin ein Kurstermin ist)
data.source	string	Buchungsquelle (z.B. oauth)
data.deleted	boolean	true – Termin wurde storniert
data.deletedAt	string (ISO 8601)	Zeitpunkt der Stornierung
data.stornoReason	string | null	Storno-Grund, null wenn kein Grund angegeben
data.createdAt	string (ISO 8601)	Erstellungszeitpunkt
data.updatedAt	string (ISO 8601)	Letzter Änderungszeitpunkt

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/appointments/b2c3d4e5-f6a7-8901-bcde-f01234567890/cancel" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "beispiel",
    "notify": "beispiel"
  }'

Server

Client-ID

Client-Secret

Parameter

uuid *integer

reason string

notify boolean

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope appointments fehlt; oder Kurs-Termin ohne Scope customers
404	not_found	Termin nicht gefunden oder gehört zu einem anderen Tenant
422	unprocessable_entity	Termin ist bereits storniert oder dieser Termintyp kann nicht storniert werden