belbo
  • Overview
  • API-Referenz
      • Abfrage der Standorte
      • Abfrage der Leistungen und Gruppen
      • Berechnung der Mitarbeiter zu Leistungen
      • Abfrage des Warenkorbs
      • Zusatzdienstleistungen für gewählte Leistungen abfragen
      • Abfrage von zusätzlichen Feldern (deprecated)
      • Mitarbeiterinformationsabfrage
      • Mitarbeitersuche mit Namen
      • Preisdetails für Leistung
      • Schrittweisen Buchungsprozess abfragen
      • Verfügbare Termine
      • Terminzeiten (auch bereits belegte)
      • Buchung starten (alt)
      • Buchung starten
      • Buchungsstatus abfragen
      • Abfrage des Warenkorbs für eine Buchung
      • Kundendaten zur Buchung hinzufügen
      • Abfrage Termin-spezifischer Felder
      • Terminspezifische Informationen speichern
      • Buchungsabschluss
      • Newsletterregistrierung
      • Gutscheinrestwertabfrage
      • Bewertungsabfrage
      • Abfrage der verkaufbaren Gutscheine
      • Token erhalten
      • Token auslesen
      • Sprache ändern
      • News
      • Standorte
      • Login
      • Login SHA-2
      • Logout
      • Fragenkatalog auslesen
      • Fragenkatalog auslesen mit Infos
      • Übergreifenden Fragenkatalog auslesen
      • Simple Registrierung
      • Registrierung
      • Registrierung bestätigen (optional)
      • Passwort vergessen
      • Passwort neu setzen (optional)
      • Push ID speichern
      • Passwort ändern
      • Benachrichtigungseinstellungen abfragen
      • Benachrichtigungseinstellungen ändern
      • Zukünftige Terminliste
      • Vergangene Termine
      • Termin absagen
      • Account löschen
      • Profilabfrage
      • Profiländerung
      • Mitarbeiter für Leistungen (deprecated)
      • Mitarbeiter für Leistungen
      • Verfügbare Tage
      • Tagesabfrage
      • Terminzeiten für einen Tag (deprecated)
      • Terminzeiten für einen Tag
      • Uhrzeit reservieren
      • Buchung abschließen
      • Arbeitszeiten abfragen
      • Arbeitszeiten erstellen
      • Arbeitszeiten ändern
      • Arbeitszeiten löschen
      • Arbeitszeiten, Abwesenheiten und Notizen eines Mitarbeiters abrufen
      • Mitarbeiter mit Pause blockieren
      • Terminänderung eines Tages abfragen
      • Termine für einen Tag abfragen
      • Daten für einen einzelnen Termin abfragen
      • Termine für einen Kunden abfragen
      • Kundensuche nach Mobilnummer
      • Kundenliste mit Mobilnummer
      • Kundenabfrage
      • Rechnungen abfragen
      • Produktauflistung VK
      • Produktsuche
      • Leistungsauflistung gruppiert nach Produktgruppe
      • Leistungsauflistung
      • Gutscheinauflistung
      • Mitarbeiter
      • Kassenstandsabfrage
      • Bestand an einem Verkaufsprodukt ändern
      • Kundentermin absagen
Skip to content

API-Referenz › Private API › Terminbuchung

Uhrzeit reservieren

POST https://…/mobile/rest/1.0/appointment/reserveAppointment
Diese Schnittstelle gehört zur Private API: Sie arbeitet auf den Daten eines angemeldeten Kundenprofils. Holen Sie sich zuerst über initSession ein Token und melden Sie den Kunden über login an – siehe API-Schnittstellen.

Diese Abfrage dient der tatsächlichen Reservierung eines Termins. Der Termin wird durch diese Abfrage bereits für weitere Buchungen blockiert, ohne dass dieser tatsächlich bereits verbindlich gebucht ist. Die vorübergehende Reservierung hält 15 Minuten an.

  • servicerId: Kann den Wert 0 enthalten, wenn die Wahl des Mitarbeiters unbestimmt ist.

Als Rückgabe werden diverse Termininformationen gesendet, die für die weitere Buchung relevant sind. Dazu gehört die „internalID“, die für diesen Termin immer eindeutig ist. Die ID des Termins ändert sich mit jeder Änderung am Termin.

  • servicePrices: Die Menge der Preise, die diesem Termin zugeordnet sind. Je nach Auswahl von Leistungen können hier viele Preise enthalten sein. Preise sind grundsätzlich unveränderlich, so dass auch nach Preisänderungen die gleichen Preise im Termin enthalten sind.

Parameter

NameÜbergabe
servicerId Body
Platzhalter{{servicerId}}
serviceIds Body
Platzhalter{{selectedProducts}}
forDay Body
Beispiel{{bookingDay}}T13:00

Header

NameWert
Content-Type application/x-www-form-urlencoded

Struktur zuletzt mit der Postman-Collection abgeglichen: 09.09.2026

Beispielantworten

200 Uhrzeit reservieren
{
    "appointment": {
        "fromDate": "1902141300",
        "untilDate": "1902141450",
        "fromDate_year": "2019",
        "fromDate_dayMonth": "14.Feb",
        "fromDate_weekDay": "Donnerstag",
        "fromDate_clock": "13:00",
        "length": "1 Stunde 50 Minuten ",
        "internalID": 12287083,
        "id": 49623714,
        "appointmentState": "DRAFT",
        "servicesFreetext": null,
        "price": "200,00",
        "targetLocation": null,
        "distancePrice": 0,
        "servicer": {
            "id": 7473
        },
        "serviceDescriptions": [
            "Micro Peeling"
        ],
        "servicerGroup": {
            "id": 16
        },
        "appointment_type": "CUSTOMER",
        "internalid": 12287083,
        "customer_id": 4172510,
        "appointment_result": "UNKNOWN"
    },
    "servicePrices": [
        {
            "id": 486343,
            "serviceProduct": {
                "id": 180611
            },
            "supplierInvoice": null,
            "servicerRole": null,
            "customerPropertyType": null,
            "price": 200,
            "supplierBonus": null,
            "active": true,
            "factor": null,
            "validFrom": "01.11.201715:52",
            "replacedByServicePrice": null,
            "originalPrices": [
                {
                    "id": 486341
                }
            ],
            "customerStatus": null,
            "weekDay": null,
            "noAssistance": false,
            "price2": 200,
            "supplierDiscount": null,
            "priceType": {
                "enumType": "de.zeitfest.service.PriceType",
                "name": "FIXED"
            },
            "priority": 0,
            "servicerGroup": {
                "id": 16
            },
            "fromHour": null,
            "primeCost": null,
            "label": "Basispreis",
            "servicer": {
                "id": 7473
            },
            "tax": 0.19,
            "preferredSalePrice": null
        }
    ],
    "productCoupons": null,
    "hideServicerForCustomer": true,
    "result": "success",
    "locationRequired": false
}
200 Uhrzeit reservieren
{
    "appointment": {
        "fromDate": "1901031200",
        "untilDate": "1901031350",
        "fromDate_year": "2019",
        "fromDate_dayMonth": "03.Jan",
        "fromDate_weekDay": "Donnerstag",
        "fromDate_clock": "12:00",
        "length": "1 Stunde 50 Minuten ",
        "internalID": 11894111,
        "id": 48104407,
        "appointmentState": "DRAFT",
        "servicesFreetext": null,
        "price": "200,00",
        "targetLocation": null,
        "distancePrice": 0,
        "servicer": {
            "id": 7473
        },
        "serviceDescriptions": [
            "Micro Peeling"
        ],
        "servicerGroup": {
            "id": 16
        },
        "appointment_type": "CUSTOMER",
        "internalid": 11894111,
        "customer_id": 4172510,
        "appointment_result": "UNKNOWN"
    },
    "servicePrices": [
        {
            "id": 486343,
            "serviceProduct": {
                "id": 180611
            },
            "supplierInvoice": null,
            "servicerRole": null,
            "customerPropertyType": null,
            "price": 200,
            "supplierBonus": null,
            "active": true,
            "factor": null,
            "validFrom": "01.11.201715:52",
            "replacedByServicePrice": null,
            "originalPrices": [
                {
                    "id": 486341
                }
            ],
            "customerStatus": null,
            "weekDay": null,
            "noAssistance": false,
            "price2": 200,
            "supplierDiscount": null,
            "priceType": {
                "enumType": "de.zeitfest.service.PriceType",
                "name": "FIXED"
            },
            "priority": 0,
            "servicerGroup": {
                "id": 16
            },
            "fromHour": null,
            "primeCost": null,
            "label": "Basispreis",
            "servicer": {
                "id": 7473
            },
            "tax": 0.19,
            "preferredSalePrice": null
        }
    ],
    "productCoupons": null,
    "hideServicerForCustomer": true,
    "result": "success",
    "locationRequired": false
}

Have a question? Ask it here.

This manual is a service by belbo. Legal notice