Appointments API

Verwalte Termine mit Kunden. Erstelle Beratungstermine, Anproben und Abholtermine.

GET

/api/vendor/appointments

Gibt Termine zurück, optional gefiltert nach Zeitraum.

Benötigt Scope: appointments:read

bash

curl -s "https://brutlers.com/api/vendor/appointments?from=2026-04-01&to=2026-04-30" \
  -H "X-Api-Key: brut_your_api_key_here"

POST

/api/vendor/appointments

Erstellt einen neuen Termin für einen bestehenden Kunden.

Benötigt Scope: appointments:write

Request Body

Field	Type		Description
customerId	string	Pflichtfeld	ID des Kunden (CUID)
type	string	Pflichtfeld	Termintyp
date	string	Pflichtfeld	Datum und Uhrzeit (ISO 8601)
duration	number	Optional	Dauer in Minuten (15–480, Standard: 60)
notes	string	Optional	Notizen zum Termin
orderId	string	Optional	Verknüpfter Auftrag (optional)

Termintyp

CONSULTATION — BeratungFITTING — AnprobePICKUP — AbholungALTERATION — Änderung

bash

curl -X POST https://brutlers.com/api/vendor/appointments \
  -H "X-Api-Key: brut_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "clx1234567890abcdef",
    "type": "CONSULTATION",
    "date": "2026-04-15T10:00:00Z",
    "duration": 60,
    "notes": "Erstberatung Brautkleid"
  }'

Status-Übergänge

Termine durchlaufen folgende Status:

Vorgeschlagen→Bestätigt→Abgeschlossen|Storniert

PROPOSED → CONFIRMED, PROPOSED → CANCELLED, CONFIRMED → COMPLETED, CONFIRMED → CANCELLED

PUT

/api/vendor/appointments/:id

Aktualisiert einen Termin. Status-Übergänge werden validiert.

Benötigt Scope: appointments:write

DELETE

/api/vendor/appointments/:id

Löscht einen Termin. Nur möglich im Status PROPOSED oder CANCELLED.

Benötigt Scope: appointments:write