Buchungen

Buchung verschieben

posthttps://open-api.mynextdays.com/v1/reservations/{reservation_id}/move

Legt die Buchung in einen anderen Zeitraum und/oder ein anderes Objekt.

Warum 202 und nicht 200: die Kette dahinter gibt die alten Nächte frei, belegt die neuen und meldet beide Zustände an die Portale. Sie hat im Betriebssystem EINE Stelle; ein zweiter Weg dorthin wäre ein zweiter Weg zu freigegebenen Nächten ohne Portal-Meldung (Wurzel 1).

Was dieser Aufruf trotzdem SOFORT beantwortet: ob die Zieltage frei sind. Ein belegter Zeitraum ist der häufigste Fehlerfall, und ihn erst Sekunden später über ein Ereignis zu melden wäre unbrauchbar. Geprüft wird mit derselben Funktion, die auch die Verfügbarkeit ausliefert; die verbindliche Prüfung macht die ausführende Stelle noch einmal.

Nicht möglich: eine OTA-Buchung verschieben (die Änderung muss im Portal passieren, sonst verkauft es die freigegebenen Nächte weiter), eine stornierte Buchung, und eine, bei der der Gast schon eingecheckt ist.

Pfad-Parameter

reservation_idstringpflicht

Anfrage-Körperpflicht

check_indatepflicht

check_outdatepflicht

Abreisetag — die Nacht davor ist die letzte.

property_idstringpflicht

Ziel-Objekt. Für eine reine Verlängerung oder Verkürzung dasselbe Objekt mitschicken wie bisher.

repriceboolean

Ohne Angabe bleibt der Preis UNVERÄNDERT — der vereinbarte Preis ist bindend, und ein automatisches Nachrechnen wäre eine stillschweigende Preisänderung. true lässt den Preis für den neuen Zeitraum neu berechnen (Upsell).

Antworten

202Das Verschieben ist beauftragt. Es ist in diesem Moment noch nicht vollzogen — das Ereignis `reservation.updated` meldet den Abschluss.

check_indatepflicht

check_outdatepflicht

property_idstringpflicht

reservation_idstringpflicht

statusstringStandard accepted

409Der Ziel-Zeitraum ist belegt, gesperrt oder vom Verkauf ausgenommen. Es wurde NICHTS verändert.

422Der Zeitraum ist unmöglich oder zu lang.

Sprache

Zugang

Nur in diesem Browser, nur für „Ausprobieren“ — der Wert wird nicht gespeichert und nicht an uns geschickt.

Anfrage

curl -X POST 'https://open-api.mynextdays.com/v1/reservations/%3Creservation_id%3E/move' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "property_id": "…",
  "check_in": "2026-09-10",
  "check_out": "2026-09-10"
}'

Ohne Token antwortet der Aufruf mit 401 — das ist der erwartete Weg.

Beispiel

{
  "reservation_id": "…",
  "property_id": "…",
  "check_in": "2026-09-10",
  "check_out": "2026-09-10"
}