Live-Demo

Integration von Hotelanbietern

Hotelbeds API-Integration: Content, Mapping und Live-Buchung

Eine Hotelbeds API-Integration besteht aus zwei Aufgaben, nicht aus einer. Sie laden Hotel-Content herunter und speichern ihn, dann buchen Sie zu Live-Raten. PHPTRAVELS erledigt beides im Hotelmodul, mit Ihrem eigenen Hotelbeds-Vertrag und Ihren eigenen Schlüsseln.

  • Content API Sync
  • Booking API Ablauf
  • BOOKABLE- und RECHECK-Raten
  • Hotel-Mapping

Wie die Hotelbeds APIs zusammenspielen

Hotelbeds API-Integration: Content auf der einen Seite, Buchung auf der anderen

Hotelbeds teilt seine Hotel-APIs in zwei Teile. Die Content API liefert statische Daten: Beschreibungen, Bilder, Ausstattung, Verpflegungsarten und Zimmer. Die Booking API liefert Live-Verfügbarkeit und Preise und nimmt die Buchung entgegen. Wählen Sie in der Mitte einen Schritt, um zu sehen, welche Aufrufe er nutzt.

Content API

Statisch, bei Ihnen gespeichert
  • Hotellistehotels · from=1&to=1000Alle Hotels Ihres Portfolios, in Seiten mit bis zu 1.000 Hotels pro Anfrage.
  • Ausstattung, Verpflegung und Zimmerfacilities · boards · roomsDie Codetabellen, die Codes der Booking API in Begriffe übersetzen, die Ihre Gäste verstehen.
  • Bilderphotos.hotelbeds.com/giata/Teilpfade zu Bildern, kombiniert mit dem Foto-Host von Hotelbeds in der gewünschten Größe.
  • Tägliche ÄnderungenlastUpdateTimeNach dem ersten Laden liefert eine tägliche Anfrage mit lastUpdateTime nur die Änderungen.

Anfrageablauf

Booking API

Live, pro Gast aufgerufen
  • VerfügbarkeitPOST /hotelsZimmer, Verpflegung, Preise und Stornogebühren für Ihre Hotelcodes, Reisedaten und Belegung.
  • RatenprüfungPOST /checkratesAktueller Preis und Bedingungen für eine als RECHECK markierte Rate, dazu Upselling-Optionen.
  • BuchungPOST /bookingsBestätigt den gewählten rateKey mit den Namen von Buchendem und Gästen und liefert die Referenz zurück.
  • StornierungDELETE /bookings · simulateSimuliert eine Stornierung, um die Gebühr anzuzeigen, oder storniert die Buchung tatsächlich.
Beispielansicht. Aufrufe wie auf developer.hotelbeds.com dokumentiert; der Ablauf zeigt, wie PHPTRAVELS sie nutzt.

Die meisten gescheiterten Hotelbeds-Projekte vermischen beide Seiten. Sie rufen die Content API während der Gastsuche auf, was langsam ist und, wie Hotelbeds warnt, zur Sperrung Ihrer Zugangsdaten führen kann. Oder sie suchen live ohne gespeicherte Codes und können weder Bilder noch Ausstattung anzeigen. PHPTRAVELS hält beide Seiten getrennt: Der Content wird im Hintergrund synchronisiert, und nur Verfügbarkeit, Ratenprüfung und Buchung laufen, während der Gast wartet.

Wenn Sie mehr über den Anbieter selbst, seine Produkte und die Kontoeröffnung erfahren möchten, lesen Sie das Anbieterprofil von Hotelbeds. Diese Seite behandelt die technische Integration.

Ratentypen

Die vier Ratenfelder, die Ihren Checkout verändern

Jede Hotelbeds-Rate trägt einige Attribute, die festlegen, ob Sie sie sofort buchen können, welchen Preis Sie anzeigen dürfen und wer das Geld einzieht. Diese Felder muss Ihre Engine in jedem Ergebnis auslesen.

FeldErster FallZweiter FallWas PHPTRAVELS tut

Buchbar oder Prüfung nötig

rateType		BOOKABLE

Die Rate ist aktuell. Sie können sie ohne weiteren Aufruf buchen.

RECHECK

Sie müssen zuerst die Ratenprüfung aufrufen, um aktuellen Preis und Bedingungen zu erhalten.

Führt bei RECHECK-Raten vor dem Zahlungsschritt die Ratenprüfung aus und zeigt dem Gast jede Änderung.

Netto oder provisionsfähig

net · sellingRate		net

Nettomodell: Die Preise sind netto, Sie schlagen Ihre eigene Marge auf.

sellingRate

Provisionsmodell: Die Provision ist bereits in sellingRate enthalten, und dieser Preis ist endgültig.

Wendet Ihre Aufschlagsregeln auf Nettoraten an und verkauft provisionsfähige Raten zum sellingRate.

Fester Verkaufspreis

hotelMandatory		true

hotelMandatory ist true: Sie müssen zum sellingRate verkaufen.

false · null

False oder leer bei einer Nettorate: Sie dürfen Ihre eigene Marge festlegen.

Fixiert den angezeigten Preis auf sellingRate, wenn das Hotel es verlangt, unabhängig von der Aufschlagsregel.

Wann der Gast zahlt

paymentType		AT_WEB

Die Zahlung erfolgt bei der Buchung über Ihre Website.

AT_HOTEL

Der Gast zahlt direkt im Hotel.

Kennzeichnet die Rate als Jetzt bezahlen oder Im Hotel bezahlen und passt den Checkout entsprechend an.

Welches Preismodell Sie erhalten, hängt von Ihrem Hotelbeds-Vertrag ab. Laut Hotelbeds empfiehlt Ihr Sales Manager das passende Modell für Ihr Geschäft.

Hotel-Mapping

Ordnen Sie Hotelbeds-Hotels den Hotels zu, die Sie bereits verkaufen

Wenn Sie eigene Verträge oder einen zweiten Anbieter haben, kommt dasselbe Hotel mit unterschiedlichen Codes an. Das Mapping verknüpft sie, sodass der Gast ein Hotel mit der besten Rate sieht und nicht drei Kopien.

So funktioniert das Mapping in PHPTRAVELS

Nach jeder Content-Synchronisation vergleicht PHPTRAVELS die Hotelbeds-Hotels mit Ihrer Hotelliste nach Name, Adresse, Stadt und Koordinaten. Eindeutige Treffer werden automatisch verknüpft. Unsichere Treffer warten auf die Bestätigung durch eine Person, und Hotels ohne Treffer können als neue Unterkünfte importiert oder ignoriert werden.

Zugeordnete Hotels teilen sich im Modul Unterkünfte eine Seite, eine Galerie und eine Bewertung, während jeder Anbieter seine eigenen Raten und Regeln behält. Dasselbe Mapping nutzen Ihre öffentliche Website und Ihr B2B-Reiseportal.

Hotel-Mapping
  • Harbour View HotelLissabon48291397%Zugeordnet
  • Old Town SuitesPrag11735492%Zugeordnet
  • Palm Court ResortDubai66201874%Prüfen
  • Casa Azul BoutiqueSevilla–0%Kein Treffer
  • Northern Lights LodgeTromsø90522766%Prüfen
  • Riverside ApartmentsBudapest33076198%Zugeordnet

Beispielansicht mit erfundenen Hotels und Codes.

Hotelbeds XML oder JSON

Jede Anfrage wird signiert, und Tests beginnen klein

Viele Teams suchen noch nach Hotelbeds XML, doch die aktuelle Dokumentation zeigt JSON-Anfragen. So oder so sind es dieselben Operationen, und jede Anfrage enthält zwei Header.

availability-request.sh (Beispiel)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
Zwei Header
Api-key mit Ihrem Schlüssel und X-Signature: ein SHA256-Hash aus Schlüssel, Secret und aktueller Zeit in Sekunden.
Testserver
Laut Hotelbeds entsprechen die Testserver der Produktion, doch Buchungen dort sind nicht echt und Karten werden nicht belastet.
50 Anfragen pro Tag
Neue Schlüssel öffnen eine Evaluierungsumgebung mit einem Kontingent von 50 Anfragen pro Tag. Mit der Zertifizierung gibt es mehr.
Keine Live-Content-Aufrufe
Hotelbeds warnt, dass Aufrufe der Content API in Echtzeit zur Sperrung der Zugangsdaten führen können. PHPTRAVELS macht das nie.

Content-Sync-Planer

Wie viele Content API Aufrufe Ihre Hotelliste braucht

Laut Hotelbeds kommt die Hotelliste in Seiten mit bis zu 1.000 Hotels, und nach dem ersten Laden liefert eine tägliche Anfrage mit lastUpdateTime nur die Änderungen. Geben Sie Ihre Zahlen ein, um die Synchronisation zu planen.

Anfragen für das erste vollständige Laden
20
Anfragen pro täglicher Aktualisierung
3
Tage für ein vollständiges Laden mit dem Evaluierungskontingent
1

Nur eine Schätzung für die Hotelliste. Codetabellen und Bilder kommen mit einigen weiteren Aufrufen hinzu. Testen Sie beim Evaluierungskontingent von 50 Anfragen pro Tag zuerst mit einem einzigen Reiseziel.

Go-live-Checkliste

Was vor dem Wechsel in den Livebetrieb bereitstehen sollte

Hotelbeds führt Sie über sein Dashboard von der Evaluierung über die Zertifizierung bis zu den Live-Schlüsseln. Diese Punkte sollte eine Hotelbeds API-Integration zuerst abdecken, und so deckt PHPTRAVELS sie ab.

  • Evaluierungsschlüssel im Adminbereich hinterlegt, Testserver ausgewählt
  • Content API mit Ihrer Datenbank synchronisiert, tägliche Aktualisierung geplant
  • Hotels Ihrer Liste zugeordnet, unsichere Treffer geprüft
  • RECHECK-Raten durchlaufen vor der Zahlung die Ratenprüfung
  • sellingRate wird eingehalten, wenn hotelMandatory true ist
  • Ratenhinweise und Stornogebühren werden angezeigt, bevor der Gast zahlt
  • Der Voucher zeigt die Hotelbeds-Referenz und die Ratenhinweise
  • Stornierung zuerst simuliert, dann bestätigt, mit erfasster Gebühr

Zertifizierungsschritte und Live-Zugang legt Hotelbeds für Ihren Vertrag und Markt fest.

Kosten

Eine Lizenz für die Engine, Ihr eigener Vertrag mit Hotelbeds

PHPTRAVELS ist eine einmalige Lizenz mit Quellcode. Hotelbeds ist eine separate Vereinbarung zwischen Ihnen und Hotelbeds, daher bleiben Nettoraten und Schlüssel bei Ihnen.

Startup
Einmalige Lizenz
einmalige Lizenz
Agency
Einmalige Lizenz
einmalige Lizenz
Enterprise
Einmalige Lizenz
einmalige Lizenz

Hotelbeds ist eine von mehreren Hotelquellen, die Sie parallel betreiben können. Sehen Sie in der Übersicht der Reise-APIs, wie es neben RateHawk arbeitet, oder vergleichen Sie Anbieter in der XML-Anbieterliste.

Preise ansehenHotel-Demo testen

FAQ

Fragen zur Hotelbeds API-Integration

Was Entwickler und Reiseunternehmen fragen, bevor sie Hotelbeds anbinden.

Vertrieb kontaktieren

Zwei Teile. Eine Hintergrundsynchronisation mit der Content API, die Hotels, Bilder, Ausstattung, Verpflegungsarten und Zimmer in Ihrer Datenbank speichert, und einen Live-Ablauf mit der Booking API für Verfügbarkeit, Ratenprüfung, Buchung und Stornierung. PHPTRAVELS betreibt beides im Hotelmodul.

Viele sprechen noch von Hotelbeds XML, doch die aktuelle Hotelbeds-Dokumentation zeigt JSON-Anfragen und -Antworten. Die Operationen sind in beiden Fällen dieselben, und PHPTRAVELS übernimmt das Format für Sie.

Eine BOOKABLE-Rate ist bereits aktuell und kann sofort gebucht werden. Eine RECHECK-Rate benötigt zuerst eine Ratenprüfung, die den aktuellen Preis und die Bedingungen liefert. PHPTRAVELS führt diesen Aufruf vor dem Zahlungsschritt aus.

Es ist langsam, und Hotelbeds warnt, dass die Nutzung der Content API in Echtzeit zur Sperrung der Zugangsdaten führen kann. Content sollte seitenweise heruntergeladen, gespeichert und einmal täglich mit lastUpdateTime aktualisiert werden. Genau so arbeitet PHPTRAVELS.

Ja. Sie registrieren sich bei Hotelbeds, unterzeichnen den Vertrag und erhalten Ihren eigenen API-Schlüssel und Ihr Secret. Neue Schlüssel funktionieren in einer Evaluierungsumgebung mit 50 Anfragen pro Tag, bis Sie die Zertifizierung abgeschlossen haben.

Ja. Das Hotel-Mapping verknüpft dieselbe Unterkunft über alle Quellen hinweg, sodass Gäste ein Hotel mit der besten verfügbaren Rate sehen, während jede Quelle ihren eigenen Aufschlag und ihre Regeln behält.

PHPTRAVELS-Pakete beginnen bei als einmalige Lizenz mit Quellcode. Ihr Hotelbeds-Vertrag ist separat und wird direkt mit Hotelbeds vereinbart. Sehen Sie sich die Preisseite an oder fordern Sie beim Vertrieb ein Angebot an.

Weiter entdecken

Mehr zur Plattform