Zum Inhalt

Entwicklerhandbuch - API zum Abrufen von Zimmern und Angeboten

Was ist die Retrieve Rooms-API?

Kurzurlaub.de verwendet bspw. OTA_HotelAvailRQ/RS und diverse weitere OTA Nachrichten, um eine Liste aktiver Zimmer und Angebote / Preise für ein Hotel von der Seite des Buchungskanals zu übertragen.

Dieser Service wird von den Hoteliers des Senders genutzt, um ihre Zimmer im Back end einzurichten. Die vom Dienst zurückgegebenen Zimmer müssen im Kanal aktiv sein, damit die Hoteliers Aktualisierungen verwalten können.

Optional können auch alle buchbaren Zusatzleistungen / Services (bspw. 20 min Massage zum Preis von 19,50 Euro) abgerufen werden.

Zwei Arten zum Abrufen von Zimmern und Angeboten

Die erste Frage sollte immer lauten:

Verwenden wir nur

  1. Zimmerdaten abrufen
  2. Zimmerdaten und Angebotsdaten abrufen

Dies bildet auch die Basis des 2. Teils zum Senden von Verfügbarkeiten auf Zimmerebene und/oder Angebotsebene im Bereich Verfügbarkeiten Push-API

1. Zimmerdaten und Angebotsdaten abrufen

Wenn Ihr Kanal sowohl Zimmertypen als auch Preispläne unterstützt, verwenden Sie bitte die Nachricht „Zimmer- und Preiscodes abrufen“.

Wenn Ihr Backend Verfügbarkeiten auf Zimmerebene und Angebotsebene unterstützt - also Zimmertypen und Ratenpläne (sog. RoomType/RatePlan Kombinationen), verwenden Sie bitte die Nachrichten zum „Zimmerdaten und Angebotsdaten abrufen“

2. Nur Zimmerdaten abrufen

Wenn Ihr Backend nur Verfügbarkeiten auf Zimmerebene unterstützt - also nur Zimmertypen (RoomType) und keine Ratenpläne, verwenden Sie bitte die Nachrichten zum „nur Zimmerdaten abrufen“

Abrufen von buchbaren Zusatzleistungen / Services

Optional können auch alle buchbaren Zusatzleistungen / Services (bspw. 20 min Massage zum Preis von 19,50 Euro) abgerufen werden. Dies erfolgt über die Methode OTA_HotelDescriptiveInfoRQ und muss vorab beim Kurzurlaub.de Connectivity Team beantragt werden.

Übersicht der verfügbaren Nachrichten

Übersicht verfügbarer Nachrichten - offizielle OTA Messages - zum Abrufen von Zimmerdaten / Raten / Angebotsinformationen und Preisen