1. Home
  2. Dokumente
  3. bookyt API Grundlagen
  4. Statuswerte setzen

Statuswerte setzen

Der POST-Aufruf „update_status“ ermöglicht es, Statuswerte von Vorgängen in der Bookyt Vermietsoftware zu aktualisieren. Dieser Aufruf ist nützlich, um den aktuellen Status eines Vorgangs zu ändern und wichtige Informationen wie Kilometerstände bei der Ankunft und Abfahrt zu erfassen. Hier sind die Details zu diesem POST-Aufruf:

  • call=update_status: Dieser Teil des API-Aufrufs gibt an, dass du den Status eines Vorgangs aktualisieren möchtest.
  • vorgang_nr: Hier gibst du eine eindeutige Nummer oder Kennung an, die den betreffenden Vorgang identifiziert.
  • status_id: Dieser Parameter repräsentiert die Kennung oder Nummer, die den neuen Status darstellt, in den der Vorgang geändert werden soll. Der Status kann beispielsweise „Reserviert“, „Abgeholt“, „Abgerechnet“ usw. sein.
  • km_stand_ankunft: Dieser Parameter ermöglicht es, den Kilometerstand bei der Ankunft des Fahrzeugs oder der Ressource anzugeben.
  • km_stand_abfahrt: Hier kannst du den Kilometerstand bei der Abfahrt des Fahrzeugs oder der Ressource angeben.

Hier ist ein Beispiel für einen vollständigen POST-Request:

curl -X POST 'https://deine-frontend-url/api.php' \
-H 'Content-Type: application/json' \
-d '{
  "call": "update_status",
  "vorgang_nr": "V123456",
  "status_id": 2,
  "km_stand_ankunft": 50000,
  "km_stand_abfahrt": 50350,
  "token": "xyz"
}'

Mit diesem API-Aufruf kannst du den Status eines Vorgangs aktualisieren und gleichzeitig relevante Kilometerstände erfassen, was besonders wichtig ist, um den Zustand und die Abrechnung von Vermietungsressourcen genau zu verfolgen.