Skip to main content
Diese Anleitung beschreibt, wie du REQUEST! (das Online-Anfrageformular) auf deiner Website einbettest und Formulardaten per URL-Parameter oder Data-Attribute vorausfüllst.

​
Voraussetzungen

  • Modul REQUEST! ist aktiviert
  • Das REQUEST!-Widget ist eingerichtet und gespeichert (siehe REQUEST! einrichten)
  • Der Einbettungscode ist im Widget unter Einbettungscode pro Sprache verfügbar

​
Schritte

  1. Öffne das REQUEST! Widget im Mandant-Dashboard unter Widgets.
  2. Scrolle zum Abschnitt Einbettungscode.
  3. Kopiere den Widgetcode für die gewünschte Sprache.
  4. Füge den kopierten Code in den HTML-Quellcode deiner Website ein.

​
URL-Parameter

Du kannst Formularfelder über die Query-Parameter mandant_ids, occupancies, period und form_fields vorauswählen.

​
mandant_ids

Ein Array von Zahlen mit den vorauszuwählenden Mandanten. Nur relevant, wenn einem Widget mehrere Mandanten zugewiesen sind. Einige Elemente aus occupancies können nur vorausgewählt werden, wenn genau ein Mandant vorausgewählt ist. Ohne diesen Parameter werden standardmäßig alle Mandanten vorausgewählt.

​
occupancies

Ein Array von Elementen, über das Wohneinheiten und Belegung vorausgewählt werden. Jedes zusätzliche Element entspricht einer weiteren Wohneinheit.
  • adults: Anzahl Erwachsene als Ganzzahl
  • children: Array mit dem Alter der Kinder als Ganzzahlen
  • room_type_code: Zimmercode der gewünschten Zimmerkategorie
  • is_travelling_with_pets: true = mit Haustieren, false = ohne Haustiere
  • meal_plan_id: ID der Verpflegungsart (0 = Nur Übernachtung, 1 = Übernachtung mit Frühstück, 2 = Halbpension, 3 = Vollpension, 4 = All-Inclusive)

​
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)

​
form_fields

Ein Objekt mit Key-Value-Paaren zum Vorausfüllen von Zusatzfeldern. Der Key muss der Data-ID des Formularfeldes in Snake-Case entsprechen (z. B. EmailAddress wird zu email_address).

​
Beispiel-URLs

Vollständige URL mit mehreren Parametern:
Anfrage mehrerer Wohneinheiten gleichzeitig:
Für Verlinkungen müssen Anführungszeichen innerhalb eines href-Attributs URL-codiert werden:

​
Data-Attribute

Alle Parameter, die per URL-Query-String übergeben werden können, lassen sich auch als Data-Attribut setzen. Die übergebenen Daten müssen stets gültiges JSON enthalten (mit doppelten Anführungszeichen).
Sollen keine Mandanten vorausgewählt sein:

​
Mehrfaches Einbinden des Widgets

Wenn du REQUEST! mehrmals auf einer Webseite einbindest, vergib für jede Instanz eine eindeutige id:
Jedes Widget auf einer Seite braucht eine eigene, eindeutige id — unabhängig vom Widget-Typ. Kombinierst du BOOKED!, REQUEST! und VOUCHER! auf derselben Seite, muss trotzdem jedes einzelne Tag eine andere id haben. Zwei Widgets auf derselben Seite dürfen sich niemals dieselbe id teilen, auch nicht bei unterschiedlichen Widget-Typen.
Ohne eindeutige id werden Daten zwischen den Widgets vermischt, und nach einer Weiterleitung — etwa zurück von einer Zahlung — kann die Antwort beim falschen Widget landen. Ein Beispiel mit unterschiedlichen Widget-Typen auf einer Seite:

​
Verwandte Artikel