Vermietsoftware
API
API

Externe Anbindung

Verbinde deine Anwendung mit bookyt und nutze die leistungsstarken Funktionen der API Testjourney Schnittstelle. Damit kannst du externe Buchungen anlegen und einsehen.

Wie verwende ich Testjourney?

Um die API Testjourney zu nutzen, gehe in deinem Bookyt Verwaltungsbereich zu den Einstellungen. Klicke auf den Reiter "Grundeinstellungen" und dann auf "API". Wenn du die API Schnittstelle erfolgreich gebucht hast, siehst du dies im grün hinterlegten Hinweis. Starte die Einrichtung mit einem Klick auf "API Einbuchung Testjourney".

API Testjourney
API Testjourney

API Testumgebung Stationen und Kategorien
API Testumgebung Stationen und Kategorien

1. Stationen und Kategorien

Nun siehst du deinen XML Token, der die Grundlage für die Kommunikation zwischen Bookyt und deiner externen Lösung darstellt. Lade die Datensätze aus Bookyt mit einem Klick auf "Laden". Bookyt importiert nun die Stations-, Kategorie- und Artikeldaten und generiert die nötigen Calls. Beachte, dass das Request beim Empfangen der Stations- und Kategoriedaten mit einem "GET" Parameter versehen sein muss!


2. Tarife und Verfügbarkeit

Importiere die Tarife und die Verfügbarkeit der Mietartikel mit einem Klick auf "Laden". Du kannst Mietbeginn, Mietende, die Stations-ID und die Kategorie-ID manuell anpassen und mit einem erneuten Klick auf "Laden" einen Call und die darin enthaltenen Daten generieren. Wenn du nicht die Bookyt Tariffunktion nutzen möchtest, kannst du bei der Einbuchung `preisliste_id = 0` setzen und die Preise in den Positionen einfach mitgeben. Das Request beim Empfangen der Tarif- und Verfügbarkeitsdaten muss ebenfalls mit einem "GET" Parameter versehen sein!

API Testumgebung Tarife
API Testumgebung Tarife

API Testumgebung Buchung erhalten
API Testumgebung Buchung erhalten

3. Buchung erstellen

Hier wird der Payload generiert, der an Bookyt übertragen werden kann, um eine Buchung im System zu hinterlegen. Mit einem Klick auf "Senden" wird dieser Payload versendet und die Buchung angelegt. Der generierte QR Code wird systemweit genutzt - er ist die Online Quittungsseite für den Kunden und kann gleichzeitig mit der Bookyt App erfasst werden, um die Buchung für Abholung und Rückgabe abzurufen. Das konkrete Fahrzeug wird beim Einbuchen von Bookyt im Hintergrund zugewiesen. Das Request beim Senden der Buchungsdaten muss mit einem "POST" Parameter versehen sein!


4. Storno

Füge hier eine Vorgangsnummer ein und klicke auf "Stornieren", um den angegebenen Vorgang aus dem System herauszulöschen. Dabei werden voreingestellte Stornobelege im Hintergrund generiert. Ein Beispiel Call wird ebenfalls generiert, um eine zuvor angelegte Buchung zu stornieren. Das Request beim Senden der Stornodaten muss mit einem "POST" Parameter versehen sein!

API Testumgebung Storno
API Testumgebung Storno