Buchung starten | Handleiding

POST


																https://…/newAppointment/bookAppointmentAPI

Diese Schnittstelle gehört zur Public API und liefert öffentlich sichtbare Daten – ein API-Schlüssel ist nicht nötig.

Die „bookAppointment“ Schnittstelle führt eine provisorische Buchung durch. Diese Buchung ist nach Rückgabe noch nicht abgeschlossen. Es wird hier lediglich ein Zeitbereich „reserviert“. Im Ergebnis der Abfrage sind Informationen ernthalten, die für die weitere Buchung notwendig sind. Hierzu gehört ‚appointmentId‘ und ‚appointmentParticipantId‘.

Falls der Termin bereits oder inzwischen vergeben ist, wird folgende Antwort geliefert:

{ „result“: „GIVEN“ }

Request-Body (JSON)

Pflichtfelder

Feld	Typ
`date`	Text
Beispiel`15.07.2026` Datum des gewünschten Termins im Format TT.MM.JJJJ.
`time`	Text
Beispiel`13:00` Startzeit im Format HH:mm – so, wie sie die Abfrage der verfügbaren Termine liefert.
`selectedProducts`	Liste
Beispiel`[180612]` IDs der gewünschten Leistungen als Liste, aus der Leistungsabfrage (calcGroups).
`servicerGroupId`	Zahl
Beispiel`16` ID des Standorts, an dem gebucht wird.
`bookingGroups`	Objekt
Beispiel`{"0":-1}` Ordnet jeder gebuchten Position einen Mitarbeiter zu.
`bookingGroups.0`	Zahl
Beispiel`-1` Mitarbeiter-ID für die erste Position; -1 steht für „beliebiger Mitarbeiter“.

Optionale Felder

Feld	Typ
`bookingAttributes`	Objekt
Beispiel`{}` Zusätzliche Attribute zur Buchung. Kann leer bleiben.
`appointmentMoveToken`	Text
Nur bei einer Terminverschiebung nötig: das Token des zu verschiebenden Termins. Wird es mitgeschickt, ist die Verschiebung mit diesem Aufruf bereits abgeschlossen – die Schritte „Kundendaten hinzufügen“ und „Buchungsabschluss“ entfallen dann.

Weitere Felder

Feld	Typ
`selectedProductState`	Text
Beispiel`{"serviceProducts":[{"serviceProductId":180612,"group":null,"amount":1,"subPr…` Beschreibt die gewählten Leistungen genauer – als JSON-Zeichenkette mit Menge und Unterleistungen je Leistung.
`bookingSource`	Text
Beispiel`Your API` Freier Text, der im Kalender als Herkunft der Buchung erscheint – zum Beispiel der Name Ihrer Anwendung.

Vollständiger Beispiel-Body

{
    "date": "15.07.2026",
    "time": "13:00",
    "selectedProducts": [
        180612
    ],
    "selectedProductState": "{\"serviceProducts\":[{\"serviceProductId\":180612,\"group\":null,\"amount\":1,\"subProducts\":[]}]}",
    "servicerGroupId": 16,
    "bookingGroups": {
        "0": -1
    },
    "bookingSource": "Your API",
    "bookingAttributes": {},
    "appointmentMoveToken": ""
}

Struktur zuletzt mit der Postman-Collection abgeglichen: 09.09.2026