API-Einbindung (fortgeschritten)

Buchbare Termine können über die offenen API-Endpunkte der Consumer Booking API abgefragt und direkt gebucht werden. Da hier nur öffentlich buchbare Termine verfügbar sind, ist keine Authentifizierung erforderlich.

Um vollständige Integrationen über die timum Partner API herzustellen, kontaktiere unseren Service: https://www.timum.de/read/service

Basis-Informationen - Wichtig

Der Buchungskalender “Provider” wird über die seine UUID angegeben: Provider UUID finden

Buchbare Ressourcen (Berater, Immobilien, Objekte) werden über spezifische Identifier aus CRM-Systemen oder über timum UUIDs referenziert: Referenzen finden oder anlegen

Die Terminbuchung über die offene timum API erfolgt über eine typische Request Abfolge.

Terminarten filtern (Optional)

Darüber hinaus ist es möglich, vor die Liste der mit Terminen angeboten Terminarten abfragen und die verfügbaren Termine nach Terminart filtern, falls Sie terminart-spezifische Zeitfenster vorgeben: Endpunkt POST list active products

Buchbare Termine abfragen

Freie buchbare Termine abfragen: Endpunkt GET upcoming bookables

Ausgewählten Zeitslot reservieren

Sobald eine Kundin einen Termin vorausgewählt hat, diesen Termin zunächst für 3 Minuten reservieren, damit der Termin während der Angabe der Kundendaten nicht durch jemand anderes buchbar ist: Endpunkt POST reserve appointment

Termin mit Kundendaten final buchen

Nachdem die Kundin alle erforderlichen Angaben gemacht hat, den Termin mit Kundendaten buchen: POST create appointment with consumer

Beispiel

(folgt in Kürze)