Verfügbarkeitssuche über externe APIs

Wir haben für Branchenportale mit Unterkünften Anbindungen an externe APIs realisiert. Das sind z. B. Portale für Hotels, Ferienwohnungen etc. Über diese Anbindungen lassen sich die Verfügbarkeiten der Unterkünfte abfragen, bei Verfügbarkeit können direkt Buchungslinks generiert werden, über die die Besucher Unterkünfte buchen können.

Einstellungen für Verfügbarkeit

Wenn das Feature auf dem Branchenportal aktiv ist, können die Einstellungen für Verfügbarkeit im Management konfiguriert werden:

Dabei können folgende Einstellungen vorgenommen werden:

1. Verfügbarkeitssuche aktivieren: die Verfügbarkeitssuche wird dann bei den Suchfiltern auf der Suchseite angezeigt
2. Verfügbarkeitssuche auf Startseite: wenn aktiviert, wird die Verfügbarkeitssuche auch auf der Startseite in der Minisuche angezeigt
3. Anzahl Zimmer ausblenden: diese Option ist hilfreich für Portale, auf denen normalerweise nur eine Unterkunft gesucht wird, also z. B. Ferienhäuser oder Ferienwohnungen. Während bei Hotelportalen oft mehrere Zimmer gesucht werden, geht es bei Ferienwohnungen aber eher darum, Objekte mit einer bestimmten Anzahl von Zimmern (Schlafzimmern) zu suchen. Diese Suche nach Anzahl Zimmern wird durch die Discoverize-eigene Suchlogik abgedeckt. Während es bei Hotels meistens mehrere Zimmer in jeder Kategorie gibt, sind Ferienwohungen/-häuser eher individuelle Unterkünfte, die es so nur einmal gibt. Deswegen macht die Suche nach mehreren Einheiten hier über die externe Schnittstelle meistens keinen Sinn.
4. Text für Buchen-Button: hier kann ein Text festgelegt werden, der dann beim Buchen-Button auf der Detailseite angezeigt wird
5. API aktivieren: bei jedem unterstützten Schnittstellenanbieter muss die API aktiviert werden. Durch die Aktivierung werden die benötigten Felder bei den Einträgen angelegt, so dass man die Zuordnung der Einträge zu den jeweiligen Unterkünften auf den Schnittstellen vornehmen kann.

Schritte zum Aktivieren der Verfügbarkeit auf einem Portal

1. Wir schalten die Verfügbarkeit auf dem Portal frei
2. Sie aktivieren die entsprechende API  für den Anbieter, mit dem Sie kooperieren wollen
3. Sie hinterlegen die Einstellungen des API-Anbieters (wir können das auch durchführen, wenn Sie uns die Daten zukommen lassen)
4. Sie hinterlegen die externen IDs der jeweiligen Unterkünfte (z. B. per Import oder auf der Eintrag-Editieren-Seite). Die Felder sind momentan nur für den Portalbetreiber sichtbar und können nur durch diesen editiert werden.
5. Wenn genug Unterkünfte im Portal vorhanden sind, aktivieren Sie die Verfügbarkeitssuche auf der Suchseite und evtl. auch auf der Startseite

Verfügbarkeit auf der Suchseite

Auf der Suchseite können Besucher nach verfügbaren Unterkünften filtern und diese Suchen auch mit den individuellen Suchfiltern kombinieren:

Bei verfügbaren Unterkünften wird der günstigste Preis angezeigt und ein Link, über den die Details dieser Unterkunft geöffnet werden können:

Verfügbarkeit auf der Startseite

Wenn aktiviert (s. Einstellungen für Verfügbarkeit weiter oben), wird die Suche nach Verfügbarkeiten auch in der Minisuche auf der Startseite angezeigt:

Verfügbarkeit auf der Detailseite

Wenn nach einer Verfügbarkeitssuche auf die Detailseite eines Suchergebnisses gewechselt wird, gibt es dort folgende Möglichkeiten:

1. die Suche nach Verfügbarkeiten kann noch angepasst und für diesen Eintrag jederzeit aktualisiert werden.
2. das aktuelle Verfügbarkeitsergebnis (gleicher Suchfilter wie auf Suchseite) wird dort nochmal gecheckt und dann auch angezeigt.

Unterkünfte, bei denen die ID eines der aktivierten Verfügbarkeitsanbieter hinterlegt ist, zeigen automatisch den Suchfilter für die Verfügbarkeitssuche an. Damit kann bei dieser Unterkunft direkt nach der Verfügbarkeit gesucht werden. Es findet jedoch keine initiale Suche beim Aufruf der Seite statt:

Immer wenn eine Verfügbarkeit vorliegt, wird der Anfrage-Button ausgeblendet, da der Buchen-Button dann ja den primären Aktionslink darstellt.

Anbindung an externe APIs

Bitte beachten Sie, dass sie die APIs nur aktivieren können, wenn Sie mit dem entsprechenden Unternehmen für das Branchenportal einen Vertrag geschlossen haben und vom jeweiligen API-Anbieter die entsprechenden Zugangsdaten für die API bekommen haben.
Generell ist die Anbindung an externe Schnittstellen mit einem gewissen Anpassungsaufwand verbunden. Wenn Sie Ihr Portal an eine externe Schnittstelle anbinden möchten, können Sie uns gerne für eine erste Abschätzung kontaktieren.