Terminzeiten (JSON-Body)

POST


																https://…/externalBooking/calcAppointmentTimes2

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

Die JSON-Body-Variante von Terminzeiten (auch bereits belegte) (calcAppointmentTimes): liefert die Uhrzeiten eines Tages, unabhängig davon, ob sie bereits belegt sind. Im Unterschied zur Formular-Variante wird jede Leistung einzeln berechnet – die Antwort enthält die Uhrzeiten getrennt je Leistungs-ID, nicht für die Kombination aller Leistungen. Zusätzlich wird ein Feiertag an diesem Tag mitgeliefert.

Ein Mitarbeiter lässt sich in dieser Variante nicht vorgeben; berechnet wird immer für einen beliebigen Mitarbeiter.

Antwort

Name	Typ	Beschreibung
`day`	string	Der abgefragte Tag im Format TT.MM.JJJJHH:mm.
`specificDate`	string	Name des Feiertags an diesem Tag, sonst leer.
`times`	object	Je Leistungs-ID eine Liste der Uhrzeiten im Format HH:mm.

Fehlerfälle

Status	Antwort	Ursache
`500`	`[invalid:true]`	Der Standort existiert nicht oder gehört nicht zu Ihrem Geschäft. Achtung: Die Antwort ist in diesem Fall kein gültiges JSON.
`400`	`{"invalid":true}`	`offset` oder `selectedProductsIds` fehlt oder ist ungültig.
`variabel`	`{…}`	Die Buchungsanfrage ist für eine der Leistungen nicht zulässig (z. B. Online-Buchung ausgeschaltet). Status und Inhalt wie bei calcAppointmentTimes.

Header

Name	Wert
`Content-Type`	`application/json`

Request-Body (JSON)

Pflichtfelder

Feld	Typ
`servicerGroupId`	Zahl
Beispiel`16` ID des Standorts.
`selectedProductsIds`	Liste
Beispiel`[180611,180612]` IDs der Leistungen als Liste, aus der Leistungsabfrage (calcGroups). Achtung Schreibweise: selectedProductsIds - mit "s" nach "Products".
`offset`	Text
Beispiel`02.01.2019` Abgefragter Tag im Format TT.MM.JJJJ.

Vollständiger Beispiel-Body

{
    "servicerGroupId": 16,
    "selectedProductsIds": [
        180611,
        180612
    ],
    "offset": "02.01.2019"
}

Struktur zuletzt mit der Postman-Collection abgeglichen: 02.11.2026