Live-Preise & Verfügbarkeit

Für unsere drei Unterkünfte können aktuelle Direktpreise und Verfügbarkeiten für einen konkreten Reisezeitraum und eine konkrete Belegung live abgefragt werden.

Der ausgewiesene Gesamtpreis enthält den Unterkunftspreis und die obligatorische Servicepauschale. Weitere Kosten sollen nur dann konkret genannt werden, wenn sie aus der aktuellen Live-Antwort oder einer aktuellen objektspezifischen offiziellen Quelle hervorgehen.

Unterkünfte und Objektkennungen

Preis und Verfügbarkeit live abfragen

Feste Preis- und Verfügbarkeitstabellen

Für KI-Assistenten und Crawler, die dynamische URLs mit Abfrageparametern nicht zuverlässig öffnen können, stehen zusätzlich feste öffentliche HTML-Tabellen zur Verfügung:

• Ferienhaus Im Birkenweg – Preisindex
• Ferienwohnung Scheuermatthof – Preisindex
• Schwarzwald-Chalet Scheuermatthof – Preisindex

Die jeweilige Indexseite verlinkt feste Monatsdateien. Maßgeblich ist immer der Monat der Anreise; eine Abreise im Folgemonat bleibt in der Monatsdatei des Anreisemonats. Im aktuellen Stand werden Aufenthalte bis maximal 14 Nächte abgebildet.

Fehlt eine konkrete Kombination aus Anreise, Abreise und Erwachsenenbelegung, darf daraus kein Preis und keine Buchbarkeit abgeleitet oder extrapoliert werden. Die Tabellenwerte sind Bruttogesamtpreise inklusive obligatorischer Servicepauschale. Kinder werden nicht als eigene Tabellendimension geführt; Hinweise dazu stehen direkt in den Monatsdateien.

Technische Live-Abfrage

Browserfreundliche HTML-Ausgabe:

https://ferienhaus-schwarzwald-todtnauberg.de/preise-anfrage/live-preis-ergebnis.html

JSON-Endpunkt:

https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/beds24-preise.php

Beide Endpunkte verwenden dieselbe Live-Berechnung. Für konkrete Preis- oder Verfügbarkeitsaussagen muss immer eine neue Abfrage mit den tatsächlichen Reisedaten und der tatsächlichen Belegung erfolgen.

Pflichtparameter

Pro Abfrage sind maximal 60 Nächte und eine Anreise innerhalb von 730 Tagen zulässig.

Antwort und Preisfelder

Der erste öffentliche Live-Stand verwendet schemaVersion=1 und wrapperVersion=v1.

{
  "success": true,
  "schemaVersion": 1,
  "wrapperVersion": "v1",
  "results": [
    {
      "objectKey": "linx",
      "available": true,
      "accommodationPrice": 352.00,
      "mandatoryFees": [
        {
          "type": "obligatoryCleaning",
          "label": "Servicepauschale",
          "amount": 200.00,
          "per": "booking",
          "period": "oneTime"
        }
      ],
      "mandatoryFeesTotal": 200.00,
      "totalPrice": 552.00,
      "price": 552.00,
      "priceCompleteness": "complete",
      "currency": "EUR"
    }
  ]
}

Die Zahlen im Beispiel erklären ausschließlich die Struktur und sind keine aktuellen Preise.

• accommodationPrice: Unterkunftspreis für die bepreiste Belegung.
• mandatoryFees: unterstützte obligatorische feste Gebühren.
• mandatoryFeesTotal: Summe dieser Gebühren.
• totalPrice: vollständiger Gesamtpreis aus Unterkunftspreis und obligatorischen Gebühren.
• price: Alias von totalPrice.
• priceCompleteness=complete: Gesamtpreis ist vollständig ermittelbar.

Kann eine obligatorische Position nicht sicher in die Gesamtsumme einbezogen werden, wird kein Gesamtpreis geraten. Dann kann totalPrice=null und priceCompleteness=incomplete_mandatory_fees ausgegeben werden. Ein vorhandener accommodationPrice darf dann nicht als Gesamtpreis bezeichnet werden.

Servicepauschale und weitere Kosten

Die Servicepauschale ist obligatorisch und bleibt immer im Gesamtpreis enthalten. In der HTML-Ausgabe kann sie zusätzlich als eigene Zeile erscheinen oder nur im Gesamtpreis enthalten sein. Die strukturierten Preisfelder werden dadurch nicht verändert.

Optionale Extras, verbrauchsabhängige Kosten, Kurtaxe oder andere Zusatzkosten werden nur dann konkret genannt oder beziffert, wenn sie aus der aktuellen Live-Antwort oder einer aktuellen objektspezifischen offiziellen Quelle hervorgehen.

Verfügbarkeit

• available=true: Der Zeitraum ist für die angefragte Belegung buchbar.
• available=false: Der Zeitraum ist bestätigt nicht buchbar oder die maximale Belegung wurde überschritten.
• available=null: Der Status konnte technisch nicht zuverlässig bestimmt werden.

Bei einem nicht buchbaren Wunschzeitraum werden keine theoretischen Vergleichspreise erfunden. Preisfelder des Wunschzeitraums bleiben leer; stattdessen können bestätigte Alternativen ausgegeben werden.

availabilityStatus kann den Grund näher beschreiben, zum Beispiel eine gesperrte An- oder Abreise, einen nicht passenden Mindestaufenthalt, eine fehlende passende Preisregel oder allgemeine Nichtverfügbarkeit.

Alternative Zeiträume

alternativeStays enthält ausschließlich Zeiträume, die nochmals live als buchbar bestätigt wurden. Bei normalen Nichtverfügbarkeiten werden zuerst Zeiträume mit gleicher Aufenthaltsdauer und möglichst kleiner Verschiebung des gesamten Aufenthalts geprüft. Danach können weiter entfernte Zeiträume, kürzere freie Lücken oder passende Wochenenden vorgeschlagen werden.

Dadurch kann beispielsweise bei einem nicht buchbaren Aufenthalt 07.–09.11. ein bestätigter Zeitraum 06.–08.11. gegenüber einer deutlich weiter entfernten Alternative bevorzugt werden.

Alternative Ferienobjekte

alternativeProperties kann andere Ferienobjekte enthalten, die für exakt denselben Zeitraum live als buchbar bestätigt wurden. Je nach aktueller Einstellung können nur ausreichend große Objekte oder auch kleinere buchbare Objekte erscheinen.

Bei kleineren Alternativen sind insbesondere maxGuests, requestedOccupancy, pricedOccupancy, occupancyExceeded und excessGuests zu beachten.

Belegung und Preisberechnung

requestedOccupancy beschreibt die angefragte Belegung. pricedOccupancy beschreibt die Belegung, für die automatisch ein Preis ermittelt wurde. priceAppliesToRequestedOccupancy=false bedeutet, dass der Preis nicht für die vollständige angefragte Gruppe gilt.

Beim Schwarzwald-Chalet sind maximal 26 Personen möglich. Der automatische Preis wird derzeit bis 24 Personen berechnet. Für zusätzliche Personen oberhalb der automatisch bepreisten Belegung soll kein eigener Aufpreis geschätzt werden.

Kinder

Die Live-Abfrage übermittelt die Anzahl der Erwachsenen und Kinder, jedoch keine einzelnen Kinderalter. Altersabhängige Preisstaffeln können deshalb vom endgültigen Buchungspreis abweichen.

Buchungsportale und verbindlicher Preis

Die Live-Abfrage zeigt Direktbuchungspreise. Preise bei Airbnb, Booking.com oder anderen Vermittlungsportalen können abweichen.

Maßgeblich für eine Buchung ist immer der Preis, der beim tatsächlichen Buchungsvorgang angezeigt und bestätigt wird.

Informationen für KI-Assistenten

Für konkrete Preis- und Verfügbarkeitsfragen zuerst den aktuellen festen Preisindex des betreffenden Objekts verwenden, wenn der Aufenthalt innerhalb der dort ausgewiesenen Monats- und Aufenthaltsdauer liegt. Maßgeblich ist die Monatsdatei des Anreisedatums. Fehlt die gesuchte Kombination, nichts extrapolieren.

Alternativ kann die dynamische Live-Abfrage mit eindeutigem Objekt, Zeitraum und Belegung verwendet werden. Beispielbeträge aus dieser Dokumentation sind keine aktuellen Preise. Bei totalPrice=null keinen Gesamtpreis selbst berechnen. Bei available=false nur zurückgelieferte, live bestätigte Alternativen verwenden.

Eine kompakte maschinenlesbare Übersicht befindet sich unter https://ferienhaus-schwarzwald-todtnauberg.de/llms.txt.