Preis-API: Preise, Mindestaufenthalt und Verfügbarkeit über die API

Du kannst Tagespreise und Mindestaufenthalt pro Einheit direkt über die API lesen und schreiben, zum Beispiel aus einem eigenen Pricing-Tool. Endpunkt: /api/v1/rates auf https://rest.myxentra.com, Doku im Abschnitt „Rates“ unter https://rest.myxentra.com/docs. Die Unit-IDs findest du unter API / MCP im Bereich „Deine Units“.

Du musst nichts extra pushen. Ein Schreibvorgang stößt die Weitergabe an die Portale (Booking.com, Airbnb und so weiter) automatisch an, auf demselben Weg wie die Preisseite in Xentra.

Was du wissen musst

• Kein Schreib-Lock. API und Xentra-Oberfläche bearbeiten dieselben Preise; wer zuletzt schreibt, gewinnt. Auf der Preisseite erscheint dann der grüne Hinweis „Preise zuletzt per API aktualisiert“ mit Zeitpunkt und den betroffenen Einheiten.
• Einheiten mit PriceLabs werden abgelehnt (Status 409). PriceLabs würde den Preis beim nächsten Abgleich ohnehin überschreiben; für diese Einheiten ist die Preissteuerung PriceLabs vorbehalten.
• Feld weglassen ist nicht Feld leeren. Lässt du price oder min_stay für einen Tag weg, bleibt der Wert unverändert. Schickst du ausdrücklich null, wird die Übersteuerung gelöscht und der Saison- oder Grundpreis gilt wieder.
• Lesen liefert beides: den effektiven Wert (Übersteuerung, sonst die greifende Preisregel, in derselben Reihenfolge wie auf der Preisseite, vor dynamischen Regeln und Portalaufschlägen) und die reine Übersteuerung. So kann ein externes Tool schreiben und danach prüfen.
• Grenzen: höchstens 731 Tage pro Anfrage, höchstens 730 Tage in die Zukunft, Preis 1 bis 99999, Mindestaufenthalt 1 bis 30 Nächte.

Hinweis „Preise zuletzt per API aktualisiert“ auf der Preisseite

Verfügbarkeitskalender für deine Website

Willst du auf deiner eigenen Website einen Belegungskalender zeichnen, nimm GET /api/v1/availability?unit_id=<id>&from=<datum>&to=<datum>. Die Antwort enthält Tag für Tag, ob die Nacht frei ist (available), warum nicht (unavailable_reason: gebucht, von dir gesperrt oder vergangen), ob an dem Tag eine Anreise oder Abreise möglich ist (arrival_allowed, departure_allowed), den Mindest- und Höchstaufenthalt und den Nachtpreis. Berechnet wird das genauso wie in Xentras eigenem Belegungskalender.

• Ohne from/to kommen die nächsten 30 Tage, höchstens 731 Tage pro Anfrage.
• Der Mindestaufenthalt zählt am Anreisetag des Aufenthalts.
• Der Preis ist der Nachtpreis wie bei GET /api/v1/rates, also vor dynamischen Regeln und Portalaufschlägen.
• Für die verbindliche Antwort zu einem konkreten Aufenthalt (ist genau dieser Zeitraum buchbar?) nimm GET /api/v1/rates/availability. Ihr price-Block enthält die Endreinigung (cleaning_fee), die Hundegebühr für die angefragten dogs (dog_charge) und total, also denselben Gesamtpreis wie deine Buchungsseite. Die Kurtaxe steht getrennt in tourist_tax (status included mit amount, on_site oder unknown) und ist nie in total enthalten. Betrag und Art der Hundegebühr liefert GET /api/v1/properties/get-property/{id} in pricing als dog_charge_amount und dog_charge_mode.

Für einen Preisrechner auf deiner Website reichen /api/v1/rates und pricing der Einheit (GET /api/v1/properties/get-property/{id}: Endreinigung, Aufpreis je Gast, Gäste im Basispreis, Hunde); Gebühren musst du nicht fest in deine Website schreiben.