Zum Hauptinhalt springen

Buchung aktualisieren

PUT 
/api/booking/update

Aktualisiert eine bestehende Buchung an Ort und Stelle: Die Buchung behält ihre Id und ihren Verlauf, und die Änderungen der Hauptfelder (Daten, Orte, Fahrzeug oder Kategorie, Distanz, Transport-Ids, Agentur, Vereinbarungen und Preis) werden als Kommentare an der Buchung protokolliert. Es handelt sich um eine Änderungsoperation, nicht um Stornieren und Neubuchen.

Daten, Uhrzeiten, Abhol-/Rückgabeorte, Fahrzeugmodell oder -kategorie, Zusatzleistungen, Transport-Ids (Flugnummern) und preisbezogene Felder werden direkt aktualisiert und der Preis wird neu berechnet (beim Senden von Price gilt dieselbe 1%-Toleranz wie bei der Erstellung). Bei modellbasierter Verfügbarkeit werden die angeforderten Daten erneut geprüft, wobei das zugewiesene Fahrzeug beibehalten wird, solange es verfügbar ist; bei kategoriebasierter Verfügbarkeit wird das Kategorie-Kontingent nur bei einem Kategoriewechsel erneut geprüft — reine Datumsänderungen werden ohne neue Verfügbarkeitsprüfung angewendet.

Buchungsstatus:

  • Stornierte Buchungen werden automatisch reaktiviert. Hat die Buchung ein zugewiesenes Fahrzeug (oder ist die Verfügbarkeit modellbasiert), wird dessen Verfügbarkeit geprüft und die Anfrage schlägt mit BookingStatusNotAllowUpdate fehl, wenn kein Fahrzeug verfügbar ist; kategoriebasierte Buchungen ohne zugewiesenes Fahrzeug werden ohne Verfügbarkeitsprüfung reaktiviert. Die Reaktivierung erfolgt vor der Versionsprüfung, sodass eine später wegen der Version abgelehnte Anfrage die Buchung trotzdem reaktiviert haben kann.
  • Ausgelieferte und geschlossene Buchungen können nicht aktualisiert werden: Die Anfrage schlägt mit BookingStatusNotAllowUpdate fehl und der Buchung wird ein Warnkommentar hinzugefügt.

Versionierung: Wenn sowohl die gespeicherte als auch die eingehende Version numerisch sind, schlägt ein eingehender Wert kleiner oder gleich dem gespeicherten mit BookingVersionError fehl und ein höherer wird angewendet; fehlt einer der beiden Werte oder ist er nicht numerisch, findet keine Versionsprüfung statt und die Aktualisierung wird angewendet.

Kundendaten: Nur Customer.Name und Customer.EmailAddress werden aktualisiert, und nur wenn der Kunde vom selben API-Benutzer erstellt wurde, der die Anfrage stellt; andernfalls werden Kundenänderungen ignoriert. Andere Kundenfelder (Telefon, Alter, Dokumente usw.) werden über diesen Endpunkt nie geändert.

Die Zusatzleistungen werden mit der Anfrage synchronisiert: In Additionals ausgelassene optionale Zusatzleistungen werden aus der Buchung entfernt, während Pflicht-Zusatzleistungen und vom System hinzugefügte (z. B. Gebühren außerhalb der Öffnungszeiten) auch bei Auslassung automatisch wieder angewendet werden.

Wenn FullResponse true ist und die Buchung nach VDR-Deckungsstaffeln tarifiert wurde, können ihre pro Tag abgerechneten Mietzeilen AppliedCoverageBrackets tragen. Jede dieser Zeilen gibt einen einzigen Bereich mit ihrem gesamten Price an. Mehrere Zeilen desselben Zahlers können denselben Bereich angeben, und der Gesamtbetrag dieses Bereichs ist ihre Summe. Das Detail entfällt in allen Zeilen, wenn sich die gespeicherten Zeilen nicht ihren Bereichen zuordnen lassen, zum Beispiel nach einer Verlängerung, die ein anderer Zahler bezahlt. Die vereinfachte Antwort enthält es nie.

Request​

Responses​

Aktualisiert eine bestehende Buchung oder Aktualisiert eine bestehende Buchung