Live demo

Integratie van hotelleveranciers

Hotelbeds API-integratie: content, mapping en live boeken

Een Hotelbeds API-integratie bestaat uit twee taken, niet één. U downloadt en bewaart hotelcontent en boekt daarna op live tarieven. PHPTRAVELS doet beide in de hotelmodule, met uw eigen Hotelbeds-contract en sleutels.

  • Content API-synchronisatie
  • Booking API-flow
  • BOOKABLE- en RECHECK-tarieven
  • Hotelmapping

Hoe de Hotelbeds API's samenwerken

Hotelbeds API-integratie: content aan de ene kant, boeken aan de andere

Hotelbeds splitst zijn hotel-API's in tweeën. De Content API levert statische gegevens: beschrijvingen, afbeeldingen, faciliteiten, verzorgingstypes en kamers. De Booking API levert live beschikbaarheid en prijzen en verwerkt de boeking. Kies een stap in het midden om te zien welke calls die gebruikt.

Content API

Statisch, bij u opgeslagen
  • Hotellijsthotels · from=1&to=1000Elk hotel in uw portfolio, in pagina's van maximaal 1.000 hotels per verzoek.
  • Faciliteiten, verzorging en kamersfacilities · boards · roomsDe codetabellen die codes uit de Booking API omzetten in woorden die uw gasten begrijpen.
  • Afbeeldingenphotos.hotelbeds.com/giata/Gedeeltelijke afbeeldingspaden, gekoppeld aan de fotohost van Hotelbeds in het formaat dat u nodig hebt.
  • Dagelijkse wijzigingenlastUpdateTimeNa de eerste lading levert één verzoek per dag met lastUpdateTime alleen wat er is gewijzigd.

Verzoekflow

Booking API

Live, per gast aangeroepen
  • BeschikbaarheidPOST /hotelsKamers, verzorging, prijzen en annuleringskosten voor uw hotelcodes, data en bezetting.
  • TariefcontrolePOST /checkratesBijgewerkte prijs en voorwaarden voor een tarief gemarkeerd als RECHECK, plus upsellingopties.
  • BoekingPOST /bookingsBevestigt de gekozen rateKey met de namen van hoofdboeker en gasten en geeft de referentie terug.
  • AnnuleringDELETE /bookings · simulateSimuleert een annulering om de kosten te tonen, of annuleert de boeking echt.
Voorbeeldscherm. Calls zoals gedocumenteerd op developer.hotelbeds.com; de flow toont hoe PHPTRAVELS ze gebruikt.

De meeste mislukte Hotelbeds-projecten halen de twee kanten door elkaar. Ze roepen de Content API aan tijdens de zoekopdracht van een gast, wat traag is en, zoals Hotelbeds waarschuwt, tot geblokkeerde inloggegevens kan leiden. Of ze zoeken live zonder opgeslagen codes en kunnen geen afbeeldingen of faciliteiten tonen. PHPTRAVELS houdt beide gescheiden: content wordt op de achtergrond gesynchroniseerd en alleen beschikbaarheid, tariefcontrole en boeking draaien terwijl de gast wacht.

Wilt u meer weten over de leverancier zelf, zijn producten en hoe u een account opent, lees dan het leveranciersprofiel van Hotelbeds. Deze pagina gaat over de technische integratie.

Tarieftypes

De vier tariefvelden die uw checkout veranderen

Elk Hotelbeds-tarief heeft een paar kenmerken die bepalen of u het direct kunt boeken, welke prijs u mag tonen en wie het geld int. Deze velden moet uw engine in elk resultaat uitlezen.

VeldEerste gevalTweede gevalWat PHPTRAVELS doet

Boekbaar of controle nodig

rateType		BOOKABLE

Het tarief is actueel. U kunt het zonder extra call boeken.

RECHECK

U moet eerst tariefcontrole aanroepen voor de actuele prijs en voorwaarden.

Voert bij RECHECK-tarieven vóór de betaalstap de tariefcontrole uit en toont de gast elke wijziging.

Netto of commissiebasis

net · sellingRate		net

Nettomodel: de prijzen zijn netto, dus u voegt uw eigen marge toe.

sellingRate

Commissiemodel: de commissie zit al in sellingRate en die prijs is definitief.

Past uw opslagregels toe op nettotarieven en verkoopt commissietarieven tegen sellingRate.

Vaste verkoopprijs

hotelMandatory		true

hotelMandatory is true: u moet verkopen tegen sellingRate.

false · null

False of leeg bij een nettotarief: u mag uw eigen marge bepalen.

Zet de getoonde prijs vast op sellingRate als het hotel dat eist, ongeacht de opslagregel.

Wanneer de gast betaalt

paymentType		AT_WEB

De betaling wordt bij de boeking geïnd, via uw website.

AT_HOTEL

De gast betaalt rechtstreeks aan het hotel.

Markeert het tarief als nu betalen of betalen in het hotel en past de checkout daarop aan.

Welk prijsmodel u krijgt, hangt af van uw Hotelbeds-contract. Volgens Hotelbeds adviseert uw salesmanager het model dat bij uw bedrijf past.

Hotelmapping

Koppel Hotelbeds-hotels aan de hotels die u al verkoopt

Hebt u eigen contracten of een tweede leverancier, dan komt hetzelfde hotel binnen onder verschillende codes. Mapping koppelt ze, zodat een gast één hotel ziet met het beste tarief, niet drie kopieën.

Zo werkt mapping in PHPTRAVELS

Na elke contentsynchronisatie vergelijkt PHPTRAVELS de Hotelbeds-hotels met uw hotellijst op naam, adres, stad en coördinaten. Duidelijke matches worden automatisch gekoppeld. Twijfelgevallen wachten op bevestiging door een medewerker, en hotels zonder match kunnen als nieuwe accommodaties worden geïmporteerd of genegeerd.

Gekoppelde hotels delen één pagina, één galerij en één reviewscore in de module Verblijven, terwijl elke leverancier zijn eigen tarieven en regels behoudt. Dezelfde mapping wordt gebruikt door uw publieke website en uw B2B-reisportaal.

Hotelmapping
  • Harbour View HotelLissabon48291397%Gekoppeld
  • Old Town SuitesPraag11735492%Gekoppeld
  • Palm Court ResortDubai66201874%Controleren
  • Casa Azul BoutiqueSevilla–0%Geen match
  • Northern Lights LodgeTromsø90522766%Controleren
  • Riverside ApartmentsBoedapest33076198%Gekoppeld

Voorbeeldscherm met verzonnen hotels en codes.

Hotelbeds XML of JSON

Elk verzoek wordt ondertekend en testen begint klein

Teams zoeken nog steeds op Hotelbeds XML, maar de huidige documentatie toont JSON-verzoeken. Hoe dan ook gaat het om dezelfde operaties, en elk verzoek bevat twee headers.

availability-request.sh (voorbeeld)
 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
Twee headers
Api-key met uw sleutel en X-Signature: een SHA256-hash van uw sleutel, uw secret en de huidige tijd in seconden.
Testserver
Volgens Hotelbeds komen de testservers overeen met productie, maar boekingen daar zijn niet echt en kaarten worden niet belast.
50 verzoeken per dag
Nieuwe sleutels openen een evaluatieomgeving met een quotum van 50 verzoeken per dag. Na certificering komt er meer bij.
Geen live contentcalls
Hotelbeds waarschuwt dat realtime calls naar de Content API tot geblokkeerde inloggegevens kunnen leiden. PHPTRAVELS doet dat nooit.

Planner voor contentsynchronisatie

Hoeveel Content API-calls uw hotellijst nodig heeft

Volgens Hotelbeds komt de hotellijst in pagina's van maximaal 1.000 hotels, en na de eerste lading levert een dagelijks verzoek met lastUpdateTime alleen de wijzigingen. Vul uw cijfers in om de synchronisatie te plannen.

Verzoeken voor de eerste volledige lading
20
Verzoeken per dagelijkse update
3
Dagen voor één volledige lading met het evaluatiequotum
1

Alleen een schatting, voor de hotellijst. Codetabellen en afbeeldingen voegen een paar calls toe. Test met het evaluatiequotum van 50 verzoeken per dag eerst met één bestemming.

Go-live-checklist

Wat u klaar moet hebben voordat u live gaat

Hotelbeds brengt u via zijn dashboard van evaluatie naar certificering en daarna naar live sleutels. Dit zijn de punten die een Hotelbeds API-integratie eerst moet afdekken, en hoe PHPTRAVELS dat doet.

  • Evaluatiesleutels toegevoegd in de beheeromgeving, testserver geselecteerd
  • Content API gesynchroniseerd met uw database, met een dagelijkse update ingepland
  • Hotels gekoppeld aan uw lijst, twijfelachtige matches gecontroleerd
  • RECHECK-tarieven gaan vóór de betaling door tariefcontrole
  • sellingRate gerespecteerd als hotelMandatory true is
  • Tariefopmerkingen en annuleringskosten getoond voordat de gast betaalt
  • De voucher toont de Hotelbeds-referentie en de tariefopmerkingen
  • Annulering eerst gesimuleerd, daarna bevestigd, met de kosten vastgelegd

Certificeringsstappen en live toegang worden door Hotelbeds bepaald voor uw contract en markt.

Kosten

Eén licentie voor de engine, uw eigen contract met Hotelbeds

PHPTRAVELS is een eenmalige licentie met de broncode. Hotelbeds is een aparte overeenkomst tussen u en Hotelbeds, dus de nettotarieven en de sleutels blijven van u.

Startup
Eenmalige licentie
eenmalige licentie
Agency
Eenmalige licentie
eenmalige licentie
Enterprise
Eenmalige licentie
eenmalige licentie

Hotelbeds is een van de hotelbronnen die u naast elkaar kunt gebruiken. Bekijk in het overzicht van reis-API's hoe het samengaat met RateHawk, of vergelijk leveranciers in de XML-leverancierslijst.

Bekijk prijzenProbeer de hoteldemo

FAQ

Vragen over de Hotelbeds API-integratie

Wat ontwikkelaars en reisbedrijven vragen voordat ze Hotelbeds koppelen.

Praat met sales

Twee delen. Een achtergrondsynchronisatie met de Content API die hotels, afbeeldingen, faciliteiten, verzorgingstypes en kamers in uw database opslaat, en een live flow met de Booking API voor beschikbaarheid, tariefcontrole, boeking en annulering. PHPTRAVELS draait beide in de hotelmodule.

Veel mensen spreken nog van Hotelbeds XML, maar de huidige Hotelbeds-documentatie toont JSON-verzoeken en -antwoorden. De operaties zijn in beide gevallen hetzelfde, en PHPTRAVELS regelt het formaat voor u.

Een BOOKABLE-tarief is al actueel en kan direct worden geboekt. Een RECHECK-tarief vraagt eerst om een tariefcontrole, die de actuele prijs en voorwaarden teruggeeft. PHPTRAVELS doet die call vóór de betaalstap.

Het is traag, en Hotelbeds waarschuwt dat realtime gebruik van de Content API tot geblokkeerde inloggegevens kan leiden. Content hoort per pagina te worden gedownload, opgeslagen en eenmaal per dag bijgewerkt met lastUpdateTime. Zo werkt PHPTRAVELS.

Ja. U registreert zich bij Hotelbeds, tekent het contract en ontvangt uw eigen API-sleutel en secret. Nieuwe sleutels werken in een evaluatieomgeving met 50 verzoeken per dag tot u de certificering hebt afgerond.

Ja. Hotelmapping koppelt dezelfde accommodatie over alle bronnen, zodat gasten één hotel zien met het beste beschikbare tarief, terwijl elke bron zijn eigen opslag en regels behoudt.

PHPTRAVELS-pakketten beginnen bij als eenmalige licentie met de broncode. Uw Hotelbeds-contract staat los hiervan en sluit u rechtstreeks met Hotelbeds af. Bekijk de prijzenpagina of vraag sales om een offerte.

Verder ontdekken

Meer over het platform