Naar hoofdinhoud

KoppelingenMaxxton

Maxxton koppelen aan je website.

Maxxton is het reserverings- en beheersysteem van grotere vakantieparken en campings. De API is openbaar gedocumenteerd, inclusief een uitgeschreven boekingsstroom, dus je kunt het hele proces op je eigen site zetten in plaats van in een boekingsmodule van een ander.

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 Maxxton je oplevert.

Het hele boekingsproces op je eigen site. Zoeken, prijsvoorstel, boeken en bevestigen, zonder dat de gast je domein verlaat.

Een eigen pagina per accommodatietype. Met naam, omschrijving, voorzieningen en foto’s uit Maxxton, op je eigen adres.

Bijblijven zonder alles opnieuw op te halen. Webhooks en een events-endpoint melden wat er is veranderd, dus je ververst gericht.

Technisch

De koppeling in het kort.

Vorm van de koppeling
REST met JSON en OpenAPI, 336 endpoints in 56 groepen, basispad /maxxton/v2 op api.maxxton.net. Daarnaast webhooks en een OTA-API
Authenticatie
OAuth2 client credentials: POST /maxxton/v2/authenticate met client id, secret en een scope met de driecijferige concern-code
Richting
Beide kanten op
Verversing
Realtime bevragen kan, of je vult een eigen index en houdt die bij met events of webhooks
Wij bouwen het op
WordPress, Next.js, Maatwerk

Waar het misgaat

  • De API kost geld per gebruik, en dat is een ontwerpkeuze en geen factuurregel achteraf. Maxxton hanteert een pay-per-use model waarin het aantal gelijktijdige aanroepen meetelt; dat staat standaard op maximaal 15 per IP-adres. De acceptatieomgeving is gratis. Dat betekent dat een site die bij elke paginaweergave opnieuw de beschikbaarheid ophaalt duurder is dan een site die een eigen index bijhoudt, en dat verschil maak je aan het begin.
  • Er zijn twee manieren om beschikbaarheid te tonen en ze hebben allebei hun plek. Realtime zoeken via de zoek-endpoints geeft altijd het actuele antwoord en past bij een boekingsstap. Een eigen index, gevuld met de beschikbaarheidscall en bijgehouden met events, is sneller en goedkoper en past bij een overzichtspagina. Wij combineren ze meestal: index voor het bladeren, realtime voor het boeken.
  • De sleutels komen van de parkeigenaar, niet van Maxxton. De documentatie zegt het met zoveel woorden: neem contact op met de betreffende Maxxton-klant om toegang te vragen tot hun omgeving en gegevens. Die aanvraag loopt dus via jou als opdrachtgever, en er hoort een driecijferige concern-code bij die in de URL van je Maxxton-omgeving staat. Zet die stap aan het begin.
  • Een boeking heeft statussen en die kun je niet overslaan. Een reservering begint als provisional, optional, quotation of request, en gaat van daaruit naar definitief, geannuleerd of geweigerd. Een definitieve reservering kan alleen nog naar geannuleerd of ingecheckt. Welke status je website maakt en wie hem daarna bevestigt is een afspraak met de receptie, geen technisch detail.

Bron: documentatie van Maxxton Group

Wat is Maxxton?

Maxxton omschrijft zichzelf als het enige platform dat vakantieparken en campings nodig hebben: een reserverings- en property management systeem voor de verblijfsrecreatie.

Het pakket bestaat uit een reserveringsbeheer, een revenue manager voor prijzen en bezetting, een web manager, een customer care manager en een owner manager voor parken waar particulieren hun accommodatie verhuren. Dat laatste is typerend voor waar Maxxton zit: parken met eigenaren, meerdere locaties en een receptie.

Voor je website betekent dat twee dingen. Er staat veel meer in het systeem dan alleen een plattegrond met beschikbare plekken, en het is de moeite waard om vooraf te bepalen wat je site daarvan laat zien. Maxxton zegt zelf dat hun Open API je in staat stelt eigen koppelingen te bouwen, en dat is precies wat wij doen.

Hoe de koppeling met je website werkt

De documentatie staat openbaar op developers.maxxton.com en is uitgebreid: 336 endpoints verdeeld over 56 groepen, met een OpenAPI-beschrijving en negentien handleidingen. Je kunt dus vóór de eerste regel code zien wat er mogelijk is.

De beveiliging is OAuth2 met client credentials. Je post je client id en secret naar /maxxton/v2/authenticate, met een scope die de driecijferige code van de omgeving bevat, en krijgt een token terug dat je in de Authorization-header meestuurt. Er is een acceptatieomgeving op api-test.maxxton.net naast de productieomgeving op api.maxxton.net.

Er is ook een webhook. In plaats van steeds te vragen of er iets is veranderd, laat je Maxxton het melden. Dat scheelt aanroepen, en aanroepen kosten hier geld.

De boekingsstroom, stap voor stap

Maxxton heeft die stroom zelf uitgeschreven, en dat is zeldzaam genoeg om te noemen. Hij bestaat uit vijf stappen en wij volgen hem.

Eerst beschikbaarheid en prijzen. Dat kan realtime met de zoek-endpoints, of door alle beschikbare verblijven en prijzen op te halen en er een eigen index van te maken. Daarna de configuratie: naam, omschrijvingen, units, voorzieningen en foto’s van het accommodatietype. Dan het reserveringsvoorstel, en dat is het slimme deel: je stuurt de gekozen combinatie in en krijgt de complete kostenopbouw terug met alle mogelijke extra’s en de termijnen, zónder dat er iets wordt vastgelegd. De documentatie zegt het letterlijk: er wordt niets opgeslagen en er zijn geen reserveringskosten.

Pas daarna maak je de echte reservering aan, met het accommodatietype, de duur in dagen, de personen met hun leeftijd, het kanaal en de klantgegevens. En als vijfde stap kun je de status bijwerken, van voorstel naar definitief, geannuleerd of ingecheckt.

Waarom je eigen boekingsproces

De meeste parken met Maxxton hebben een boekingsmodule die in een kader op de site staat. Dat werkt, en het is precies de plek waar boekingen weglekken.

Wat in een kader staat komt niet in de HTML van je eigen pagina. Geen eigen adres per accommodatietype, geen eigen tekst eromheen, en niets wat een zoekmachine herkent als jouw aanbod. Wie zoekt op een chalet met hond in jouw regio, vindt die pagina niet. En op een telefoon is een kader in een kader de snelste manier om iemand te laten afhaken.

Met een eigen boekingsproces bepaal je de stappen, de vormgeving en de snelheid. Je kunt meten waar mensen afvallen, want het is je eigen site. En je kunt de stappen samenvoegen die bij jouw park niet nodig zijn. Dat is meer werk aan het begin, en het is het verschil tussen een site die informeert en een site die boekingen oplevert.

Bijgewerkt op

Specialist voor koppelingen

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

Veelgestelde vragen

Kan ik het boeken uit Maxxton op mijn eigen website zetten?

Ja, en Maxxton heeft de stroom zelf uitgeschreven: zoeken naar beschikbaarheid, de configuratie van het accommodatietype ophalen, een reserveringsvoorstel maken, de reservering aanmaken en daarna de status bijwerken. Wij bouwen dat als eigen proces op je eigen domein.

Heeft Maxxton openbare API-documentatie?

Ja, op developers.maxxton.com. Daar staan 336 endpoints in 56 groepen, een OpenAPI-beschrijving, negentien handleidingen en een changelog. Je kunt dus vooraf zien wat er mogelijk is, voordat er iets is gebouwd.

Wat kost de API van Maxxton?

Er geldt een pay-per-use model op de productie-API. Het aantal gelijktijdige aanroepen telt mee en staat standaard op 15 per IP-adres; het aantal aanvragen is niet begrensd maar wordt wel afgerekend. De acceptatieomgeving is gratis, binnen fair use.

Hoe krijg ik toegang tot de API?

Via de parkeigenaar. Maxxton schrijft dat je contact opneemt met hun klant om toegang tot die omgeving en gegevens aan te vragen. Je krijgt een client id, een secret en de driecijferige concern-code die in de URL van de Maxxton-omgeving staat.

Moet mijn site bij elke bezoeker de beschikbaarheid opvragen?

Dat hoeft niet en het is ook niet verstandig, want aanroepen kosten geld. Je kunt alle beschikbaarheden en prijzen ophalen en er een eigen index van maken, en die bijhouden met events of webhooks. Voor het boeken zelf gebruik je wel de realtime zoek-endpoints.

Werkt een Maxxton-koppeling ook op WordPress?

Ja. We slaan de accommodatietypen op als eigen berichttype in WordPress, zodat zoeken, filteren en losse pagina’s werken zoals de rest van je site. De aanroepen naar Maxxton lopen vanaf de server, zodat de sleutels niet in de paginabron staan.

Let’s work together.

Boeken op je eigen site, niet in een kader van een ander.