Recranet koppelen aan je website.

Recranet levert een reserveringssysteem voor de verblijfsrecreatie en brengt daar websites, marketing, distributie en partnerintegraties bij. Ze richten zich op vakantieparken, campings, verhuurorganisaties, huizen en appartementen, winterresorts, hotels en concerns.

Het systeem heet Recranet Booking. Daarin zitten de reserveringen, de tarieven, de beschikbaarheid per locatie, de gastgegevens, betalingen, een channelmanager voor Booking.com, Airbnb en Belvilla, en operationele zaken als schoonmaak en toegangscontrole.

Wat Recranet bijzonder maakt in dit rijtje is niet het pakket maar de openheid eromheen. Er is een developerportaal, er staat publieke broncode op GitHub, en de documentatie is zo opgezet dat je elke pagina als markdown kunt ophalen.

De API zit op app.recranet.com/api en werkt met JSON. Je stuurt een Accept-header mee en, als je iets verstuurt, een Content-Type. Datums en tijden gaan in ISO 8601 en komen standaard in UTC terug.

De beveiliging kan op twee manieren: een sleutel in de header X-Api-Key, of Basic Auth met een gebruikersnaam en wachtwoord. Welke van de twee je krijgt, hoor je bij het verstrekken van de gegevens. Beide horen vanaf je server te lopen en niet vanuit de browser.

Het derde vaste onderdeel is de organisatie. Recranet bedient meerdere organisaties op dezelfde API en verwacht daarom bij vrijwel elke aanroep een organisatie-id als queryparameter. De documentatie adviseert hem standaard altijd mee te sturen, ook bij de endpoints die hem niet nodig hebben.

De API-referentie telt 182 endpoints, en ze bestrijken het hele systeem. Reserveringen ophalen, aanmaken en bijwerken. Beschikbaarheid per accommodatie en per unit bekijken en wijzigen. Tarieven lezen en bijwerken, tot op de losse tariefdatum, met versies eronder zodat wijzigingen terug te zien zijn. Gasten, accommodaties met hun vertalingen en voorzieningen, toeslagen, en toegangstokens voor gasten.

Er zitten ook handleidingen bij die verder gaan dan een endpointlijst: een stuk over gastverificatie per e-mail, waarmee je de gegevens van een terugkerende gast automatisch invult nadat hij een code heeft bevestigd. Een stuk over review-uitnodigingen, waarmee je je eigen mails met je eigen sjablonen en je eigen timing stuurt in plaats van de automatische. En een nachtregister, om per nacht te lezen wie er aanwezig was.

Dat zijn precies de dingen die een parksite van een folder onderscheiden. Een gast die zijn e-mailadres invult en de rest ingevuld ziet worden, boekt sneller.

Recranet levert kant-en-klare onderdelen onder de naam Booking Elements, met een WordPress-plugin op GitHub en een handleiding in hun kennisbank. Dat is de snelste route, en voor veel parken is het genoeg.

Eén ding om vooraf te bespreken: in die kennisbank staat een artikel over integratie op een subdomein. Draait het boeken op boeken.jouwpark.nl in plaats van op jouwpark.nl/boeken, dan is dat technisch prima maar meet het anders. Je hebt cross-domain meting nodig om te zien welke pagina de boeking heeft opgeleverd, anders begint de bezoeker bij aankomst op het subdomein aan een nieuwe sessie.

De andere route is je eigen boekingsproces op de API. Meer werk, en je krijgt er de dingen voor terug die met kant-en-klare onderdelen niet kunnen: je eigen stappen, je eigen ontwerp tot en met de bevestiging, en een overzichtspagina met alle accommodaties die uit je eigen gegevens komt en dus door Google gelezen wordt. Wat bij jouw park de moeite waard is, hangt af van hoeveel er via de site geboekt wordt.