Naar hoofdinhoud

KoppelingenBooking Experts

Booking Experts koppelen aan je website.

Booking Experts is het reserveringssysteem waarmee vakantieparken, campings, hotels en verhuurorganisaties hun accommodaties beheren. Wij halen dat aanbod naar je eigen site: per type een eigen pagina, met de beschikbaarheid en de prijzen zoals ze op dat moment in het PMS staan.

Vertrouwd door

200+ bedrijven en webshops

DuxDux
HappyBedHappyBed
Swim EssentialsSwim Essentials
Washin7Washin7
VouwwagenspecialistVouwwagenspecialist
Fit PrepsFit Preps
Verzijden ClinicsVerzijden Clinics
Fysio MoovFysio Moov
Rund & KipRund & Kip
MörgennMörgenn

Wat het oplevert

Wat een koppeling met Booking Experts je oplevert.

Beschikbaarheid uit je PMS. Wat vrij is en wat het kost komt uit Booking Experts, niet uit een lijst die iemand bijhoudt.

Een eigen pagina per accommodatie. Elk type krijgt een eigen adres op je domein, met je eigen tekst, foto’s en voorzieningen.

De boeking komt binnen. De reservering gaat via de API naar Booking Experts, dus je administratie blijft op één plek staan.

Technisch

De koppeling in het kort.

Vorm van de koppeling
REST met JSON:API, beschreven in OpenAPI. Je bouwt er een app voor in de App Store van Booking Experts
Authenticatie
API-sleutel per organisatie in de header X-API-KEY, of OAuth2 voor een app die bij meerdere klanten draait
Richting
Beide kanten op
Verversing
Bij het opvragen; wijzigingen komen binnen via webhooks
Wij bouwen het op
WordPress, Next.js, Maatwerk

Waar het misgaat

  • Je bouwt geen losse koppeling maar een app. Booking Experts werkt met een App Store: je vraagt een demo-account aan, configureert de app onder My Apps, kiest daar de rechten die je nodig hebt en installeert hem op een administratie. Pas daarna krijg je een sleutel. De app doorloopt daarna statussen. Reken die stap in aan het begin van het traject, niet halverwege.
  • Beschikbaarheid komt niet in één keer binnen. De documentatie zegt het met zoveel woorden: tot 24 maanden vooruit, maar per aanvraag maximaal een venster van 120 dagen, en een verblijfsduur van hoogstens 30 dagen. Zoek je op één type of pakket, dan gaat het venster wel naar 24 maanden. Een jaarkalender op je site is dus een reeks aanvragen met eigen opslag erachter, en geen enkele aanroep.
  • Zonder channel en zonder de juiste scope werkt het beschikbaarheidsendpoint niet. Er moet minstens één channel aan je app hangen en je hebt het leesrecht op beschikbaarheid nodig, in hun documentatie availability|read. Dat channel is in Booking Experts ook waar reserveringen aan worden toegerekend, dus het is niet alleen een technisch vinkje.
  • Kies vooraf tussen affiliate en OTA, want dat bepaalt wat je bouwt. Als affiliate haal je beschikbaarheid op, maak je een CheckoutPortal-reservering en stuur je de gast door naar de checkout van Booking Experts; het afrekenen en de administratie blijven daar. Als OTA maak en beheer je de reserveringen zelf, int je de betalingen en draag je commissie af. Dat is een ander traject en een ander gesprek.

Bron: documentatie van Booking Experts B.V.

Wat is Booking Experts?

Booking Experts is een reserveringssysteem voor de recreatiebranche, van Booking Experts B.V. Het richt zich op vakantieparken, hotels, resorts, campings, concerns en groepen, verhuurorganisaties, projectontwikkelaars en kleinschalige recreatiebedrijven.

Het pakket heet BEX PMS en bestaat volgens de leverancier uit een reserveringssysteem, channel management, Zoek & Boek, een App Store, business intelligence, eigenarenmanagement en website-integratie. Daarnaast is er BEX CMS, met een verhuurwebsite, een vastgoedwebsite en een vertaalmodule.

Voor een eigen website is vooral het eerste deel interessant: de accommodatietypen, de beschikbaarheid en de prijzen. Dat is wat een bezoeker komt bekijken en waar hij op afhaakt als het niet klopt.

Hoe de koppeling met je website werkt

Via de API van Booking Experts, en die zit achter hun App Store. Je maakt een app aan, kiest de rechten die je nodig hebt en installeert hem op de administratie van de klant. Daarna praat je met een REST-API die JSON:API-vorm gebruikt en die in OpenAPI beschreven staat.

Wat je ophaalt zijn rentable types en rentable identities met hun foto’s en voorzieningen, de beschikbaarheid met de bijbehorende prijzen, en de prijslijsten daarachter. Wij slaan dat op aan onze kant, maken er per type een eigen pagina van en zetten de zoekfunctie daar bovenop. De beschikbaarheid zelf vragen we op in de stap waar hij telt, want die verandert de hele dag.

Het gaat ook de andere kant op. Reserveringen zijn aan te maken, te wijzigen en te annuleren, en met webhooks laat Booking Experts jouw systeem weten dat er iets is veranderd in plaats van dat je blijft vragen of er nieuws is.

Wat de API wel en niet kan

Wel: accommodaties, voorzieningen, beeldmateriaal, beschikbaarheid, prijslijsten met nachtprijzen en verblijfsduurprijzen, kortingsacties, reserveringen, gasten, facturen en betalingen. Er is genoeg om een volwaardige site op te bouwen, inclusief het boeken zelf.

Niet: alles in één keer ophalen. Het beschikbaarheidsendpoint werkt met een venster van maximaal 120 dagen per aanvraag en een verblijfsduur tot 30 dagen, en je hebt er een channel en het leesrecht availability|read voor nodig. Dat is geen obstakel, maar het bepaalt wel hoe je de zoekfunctie bouwt en waar je gegevens bewaart.

En niet zonder toestemming. De rechten die je app krijgt bepalen wat er binnenkomt. Vraagt de app te weinig, dan blijft een veld leeg zonder dat iemand begrijpt waarom; vraagt hij te veel, dan wordt de installatie bij de klant een gesprek. Wij zetten die lijst daarom vooraf op papier.

Eigen pagina’s of de website van Booking Experts

Booking Experts noemt zelf drie routes. Je neemt een BEX CMS-website, die zij bouwen en die automatisch met het reserveringssysteem is verbonden. Je gaat via hun partner Holiday Media, waarmee een directe API-koppeling bestaat. Of je houdt je eigen website en bouwt de integratie zelf op de OpenAPI.

De eerste twee zijn sneller klaar en daar is niets mis mee. De vraag is wat je site verder moet doen. Een parksite die alleen accommodaties toont is één ding; een site die ook over de omgeving gaat, die lokaal moet scoren op wat je aanbiedt, die arrangementen verkoopt en die eruitziet zoals jouw merk, is iets anders.

Daar zit ook het verschil met een widget of een iframe. Wat daarin staat komt niet in de HTML van je eigen pagina, dus er is geen eigen adres per accommodatietype en er valt voor een zoekmachine weinig te vinden. Bouw je het als eigen pagina’s, dan heeft elk type een eigen titel, een eigen omschrijving en een eigen plek in je site, met de boekknop er gewoon op.

Bijgewerkt op

Specialist voor koppelingen

Jos van der PluijmJosDesign & Development085 83 30 533jos@klubb.nl

Veelgestelde vragen

Kan ik mijn aanbod uit Booking Experts op mijn eigen website tonen?

Ja. Booking Experts noemt drie routes: een website van henzelf, een site via hun partner Holiday Media, of je eigen site met een koppeling op hun OpenAPI. Wij bouwen die derde, zodat elk accommodatietype een eigen pagina op je eigen domein krijgt met de beschikbaarheid uit het PMS.

Heeft Booking Experts een API?

Ja, met openbare documentatie op developers.bookingexperts.com. Het is een REST-API in JSON:API-vorm, beschreven in OpenAPI. Je benadert hem niet rechtstreeks maar via een app die je in hun App Store aanmaakt en op de administratie van de klant installeert.

Kan een gast op mijn eigen site boeken?

Dat hangt af van de route die je kiest. Als affiliate haal je de beschikbaarheid op, maak je een CheckoutPortal-reservering aan en rondt de gast af bij Booking Experts. Als OTA maak en beheer je de reservering zelf en int je de betaling. Die keuze maken we voordat er iets gebouwd wordt.

Hoe actueel is de beschikbaarheid op mijn site?

De beschikbaarheid vragen we op in de stap waar het telt, dus niet uit een voorraadje van gisteren. De accommodaties en hun kenmerken bewaren we wel aan onze kant, zodat de pagina snel laadt. Wijzigingen in het PMS komen daarnaast via webhooks binnen.

Werkt een Booking Experts-koppeling ook op WordPress?

Ja. We slaan de opgehaalde accommodatietypen op als eigen berichttype in WordPress, zodat zoeken, filteren en losse pagina’s werken zoals de rest van je site. Booking Experts blijft leidend: je beheert het aanbod daar en niet in WordPress.

Wat heb ik nodig om te beginnen?

Een Booking Experts-administratie en de bereidheid om een app te laten installeren met de rechten die de koppeling nodig heeft. Die app maken wij aan; het installeren gebeurt op jouw organisatie, en daar komt de API-sleutel uit. Regel dat aan het begin, want zonder sleutel valt er niets te bouwen of te testen.

Let’s work together.

Je accommodaties op je eigen site, met de beschikbaarheid uit je PMS.