Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.cloud.anex.is/llms.txt

Use this file to discover all available pages before exploring further.

Dieser Artikel beschreibt, wie du BOOKED! (die Online-Buchungsstrecke) auf deiner Website einbettest und wie du Formulardaten über URL-Parameter oder Data-Attribute vorausfüllen kannst.

​
Voraussetzungen

  • Modul BOOKED! ist aktiviert
  • Das BOOKED!-Widget muss bereits eingerichtet und erstmalig gespeichert sein (siehe BOOKED! einrichten)
  • Der Einbettungscode wird erst nach dem erstmaligen Speichern angezeigt.

​
Widget einbetten

  1. Öffne das BOOKED! Widget in der Widget-Übersicht.
  2. Scrolle zum Abschnitt Einbettungscode.
  3. Wähle die gewünschte Sprache aus. Pro Sprache wird automatisch ein separater Widgetcode generiert.
  4. Kopiere den angezeigten Code und füge ihn an der gewünschten Stelle im HTML deiner Website ein.

​
Formulardaten per URL-Parameter übergeben

Du kannst die Buchungsstrecke über URL-Parameter mit Vorbelegungen aufrufen. Folgende Parameter stehen zur Verfügung:

​
mandant_id

Gibt die ID des vorauszuwählenden Mandanten an. Nur relevant, wenn dem Widget mehrere Mandanten zugewiesen sind. Für eine Buchung kann immer nur ein einziger Mandant ausgewählt sein. Ohne diesen Parameter muss der Gast den Betrieb selbst auswählen.

​
occupancies

Ein Array von Elementen, über welches die Belegung vorausgewählt wird. Jedes zusätzliche Element im Array spiegelt eine weitere Belegung wider.
  • adults: Anzahl von Erwachsenen als Ganzzahl
  • children: Ein Array mit den Altersangaben der Kinder als Ganzzahlen
  • is_travelling_with_pets: Boolean, ob mit Haustieren gereist wird (true = mit Haustieren, false = ohne Haustiere)

​
period

Ein Objekt mit dem Reisezeitraum.
  • arrival: Ankunftsdatum im ISO 8601 Format (z. B. 2025-12-30)
  • departure: Abreisedatum im ISO 8601 Format (z. B. 2025-12-30)

​
room_type_codes

Ein Array von Strings mit den Codes der Zimmerkategorien, die in der Buchungsstrecke auswählbar sein sollen. Bei mehreren Mandanten greift dieser Parameter nur zusammen mit mandant_id.

​
room_type_ids

Ein Array von Ganzzahlen mit den IDs der Zimmerkategorien, die in der Buchungsstrecke auswählbar sein sollen. Bei mehreren Mandanten greift dieser Parameter nur zusammen mit mandant_id.

​
rate_plan_codes

Ein Array von Strings mit den Preislistencodes, die in der Buchungsstrecke auswählbar sein sollen. Bei mehreren Mandanten greift dieser Parameter nur zusammen mit mandant_id.

​
mode

Bestimmt den Modus der Buchungsstrecke:
  • book: Voreinstellung. Der Gast kann buchen. Falls im Widget Anfragen erlaubt sind, ist auch Anfragen möglich.
  • request: Das Widget steht nur im Anfragemodus zur Verfügung. Die Verfügbarkeitsanzeige bleibt bestehen.

​
should_skip_to_room_type_selection

Ein Boolean. Bei true springt die Buchungsstrecke direkt zur Auswahl der Zimmerkategorie. In diesem Fall müssen auch occupancies, period und — bei mehreren Mandanten — mandant_id angegeben werden. Bei false beginnt die Buchungsstrecke beim ersten Schritt.

​
form_fields

Hiermit füllst du beliebige Zusatzfelder im Buchungsformular vor. Übergib ein Objekt mit Key-Value-Paaren, wobei der Key der Data-ID des Formularfeldes in Snake-Case entspricht (z. B. FirstName wird zu first_name).

​
Beispiel-URLs

Vollständige URL mit allen Parametern: 
/?mandant_id=600&occupancies=[{"adults":4},{"adults":2,"children":[5,0,3]}]&period={"arrival":"2025-03-01","departure":"2025-03-05"}&room_type_codes=["DZ","SUI"]&rate_plan_codes=["OS","BB","HB"]&mode="book"&should_skip_to_room_type_selection=false&form_fields={"city":"Bruneck","first_name":"Maxime"}
Anfrage mehrerer Wohneinheiten gleichzeitig: 
/?occupancies=[{"adults":2,"children":[5,2]},{"adults":3}]

​
Formulardaten per Data-Attribute übergeben

Alle URL-Parameter können auch als Data-Attribute direkt am HTML-Element übergeben werden. Die übergebenen Daten müssen gültiges JSON enthalten (mit doppelten Anführungszeichen). 
<anexis-cloud-booked
  data-mandant_id="123"
  data-period='{"arrival":"2025-07-07","departure":"2025-07-10"}'
  [...]
></anexis-cloud-booked>

​
Verwandte Artikel