Objekte

Zahlungsplan und Stornoregel

gethttps://open-api.mynextdays.com/v1/properties/{property_id}/booking-conditions

Was der Gast wann zahlt und was bei einer Absage zurückkommt.

Ohne gepflegte Kondition sind alle Felder null. Das heißt: vollständig bei Buchung, keine Stornozusage. Hier eine Standard-Staffel zu erfinden wäre eine Zusage, die niemand gegeben hat.

Pfad-Parameter

property_idstringpflicht

Query-Parameter

rate_plan_idstring

Der Rate-Plan, dessen Kondition gilt. Ohne Angabe die Standard-Kondition des Betriebs.

Antworten

200Successful Response

balance_days_before_arrivalinteger

cancellation_modestring

Art der Stornoregel.

deposit_methodstring

deposit_requiredbooleanStandard false

first_payment_percentstring

first_payment_timingstring

Wann die erste Zahlung fällig ist.

installmentsinteger

Zahl der Teilzahlungen (1 = alles auf einmal).

namestring

rate_plan_idstring

refund_rulesarray of StornoStaffelStandard []

days_beforeintegerpflicht

refund_percentstringpflicht

422Validation Error

detailarray of ValidationError

ctxContext

inputInput

locarray of string | integerpflicht

msgstringpflicht

typestringpflicht

Sprache

Zugang

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

Anfrage

curl -X GET 'https://open-api.mynextdays.com/v1/properties/%3Cproperty_id%3E/booking-conditions' \
  -H 'Authorization: Bearer <access_token>'

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

Beispiel

{
  "balance_days_before_arrival": 1,
  "cancellation_mode": "…",
  "deposit_method": "…",
  "deposit_required": false
}