Website bezoeken →
← Terug naar blog

GetYourGuide synchronisatie: zo koppel je je reserveringssysteem correct

5 oktober 2026
GetYourGuide synchronisatie: zo koppel je je reserveringssysteem correct

Synchronisatie met GetYourGuide automatiseert drie dingen: beschikbaarheid, prijzen en boekingsverwerking tussen je eigen systeem en het platform. De eerste concrete stap is het product aanmaken in het Supplier Portal en daar je External Product ID opzoeken. Daarna koppel je die ID aan je reserveringssysteem en start je de validatie, waarbij GetYourGuide controleert of alles correct doorkomt.

Kort samengevat:

  • Alleen systemen die de Product List en Product Details endpoints ondersteunen, maken een snelle en foutloze koppeling mogelijk.
  • Bij inbound koppelingen register je je product eerst handmatig en stuur je beschikbaarheid en prijzen, terwijl outbound gericht is op het ontvangen van reserveringen.
  • Het testen van één product in de sandbox en het nauwkeurig afstemmen van datavelden voorkomt grote foutmarges bij volledige koppelingen.
  • Beschikbaarheid wordt met regelmatige regelmaat gecontroleerd, maar voor directe updates kun je de Notify-Availability endpoint gebruiken om gegevens onmiddellijk door te geven.
  • Automatische prijsupdate via API is niet vanzelfsprekend en vereist expliciete ondersteuning van Price over API door je reserveringssysteem.
Raxbooker
Vereenvoudig je GetYourGuide-koppeling
Raxbooker is een leisureboekingsplatform voor leisurecentrumeigenaren en medewerkers die reserveringen efficiënter willen beheren.
Bezoek Raxbooker

Inhoudsopgave

Welke reserveringssystemen werken met GetYourGuide?

Niet elk reserveringssysteem (SRS, Supported Reservation System) kan zonder meer koppelen. GetYourGuide werkt met een lijst van ondersteunde systemen die via gestandaardiseerde endpoints met het platform communiceren. Of jouw systeem op die lijst staat, bepaalt grotendeels hoeveel handwerk je straks krijgt.

De koppeling draait om twee kernonderdelen die je leverancier moet ondersteunen: Product List en Product Details. Het Product List endpoint laat je reserveringssysteem automatisch zijn producten aanbieden aan GetYourGuide, zodat je niet handmatig elke External Product ID moet invoeren. Product Details zorgt dat capaciteitscategorieën, tijdsloten en taalopties correct meekomen bij de eerste koppeling. Samen maken ze het verschil tussen een koppeling die je in een uur opzet en een die dagen aan heen-en-weer-gemail vergt.

Voordat je met je IT-team of leverancier in gesprek gaat, check je deze punten:

  • Staat je reserveringssysteem op de lijst van ondersteunde systemen van GetYourGuide.
  • Ondersteunt het systeem zowel inbound als outbound dataverkeer, of alleen één richting.
  • Biedt de leverancier 'Price over API' aan, of moet je prijzen handmatig synchroniseren.
  • Is er een testomgeving beschikbaar om de koppeling te valideren voordat je live gaat.

De API-functionaliteiten van GetYourGuide automatiseren beschikbaarheid, prijsupdates en boekingsverwerking rechtstreeks in je eigen systeem, en voegen ticketbarcodes of QR-codes toe aan de gegenereerde vouchers. Dat scheelt niet alleen tijd: het voorkomt ook de dubbele invoer die meestal de oorzaak is van overboekingen of verkeerde prijzen op je activiteitenpagina.

Een laatste controlepunt is vaak onderbelicht: niet elk systeem dat "GetYourGuide-compatibel" claimt, ondersteunt elk endpoint even volledig. Vraag je leverancier concreet welke calls (beschikbaarheid, reserveren, boeken, annuleren) ze daadwerkelijk geautomatiseerd afhandelen, en welke nog handmatige tussenkomst vereisen.

Inbound versus outbound connectors: wie stuurt wat?

De richting van je dataverkeer bepaalt wie welke verantwoordelijkheid draagt. Dat onderscheid is niet academisch: het beslist wie de External Product ID aanlevert, waar prijswijzigingen worden ingevoerd en wie een fout moet oplossen als iets misgaat.

Bij een inbound connector is jouw reserveringssysteem de bron van waarheid. Het verbindingsproces vereist dat je het product eerst aanmaakt in het Supplier Portal van GetYourGuide en vervolgens een External Product ID koppelt. Bij de eerste verbinding is handmatige invoer van die ID vaak nodig, tenzij je systeem het Product List endpoint ondersteunt. Jouw systeem stuurt beschikbaarheid en prijzen naar GetYourGuide, dat die gegevens overneemt zonder ze zelf aan te passen.

Bij een outbound connector werkt de richting omgekeerd: GetYourGuide stuurt boekingsverzoeken naar jouw systeem, dat ze moet accepteren, weigeren of verwerken. Dat vraagt dat je systeem actief luistert naar binnenkomende calls zoals Reserve en Book, in plaats van alleen data te versturen.

Praktisch betekent dit verschil:

  • Bij inbound koppelingen ben jij verantwoordelijk voor de juistheid van prijzen en beschikbaarheid op het moment van versturen.
  • Bij outbound koppelingen moet je systeem razendsnel reageren op boekingsverzoeken om overboekingen te voorkomen.
  • Combinaties van beide richtingen komen voor, vooral bij grotere SRS-leveranciers die zowel inbound als outbound connectoren aanbieden.
  • Testvereisten verschillen: inbound koppelingen test je vooral op dataconsistentie, outbound koppelingen test je op reactiesnelheid en foutafhandeling.

Voor prijsbeheer is dit onderscheid cruciaal. Als je systeem alleen inbound werkt, moet elke prijswijziging via jouw kant worden geïnitieerd en doorgestuurd. Verwacht geen automatische prijsaanpassing vanuit GetYourGuide zelf: die rol ligt bij jouw reserveringssysteem, niet bij het platform.

Checklist: een GetYourGuide-optie koppelen en live zetten

Een koppeling opzetten verloopt in een vaste volgorde, zoals beschreven in onze uitleg over digitale reserveringen en klantverwachtingen. Spring je stappen over of sla je de validatie te vlug over, dan loop je vast op fouten die achteraf lastig te herleiden zijn.

  1. Vul productvelden volledig in. Zorg dat prijs- en capaciteitscategorieën in je eigen reserveringssysteem exact overeenkomen met wat je in het Supplier Portal gaat invoeren.
  2. Maak het product aan in het Supplier Portal. Dit is de eerste vereiste stap in het verbindingsproces en bepaalt de basis waarop GetYourGuide je product herkent.
  3. Koppel de External Product ID. Doe dit handmatig via Connectivity Settings, of automatisch als je systeem het Product List endpoint ondersteunt.
  4. Test availability calls in de sandbox. Controleer of beschikbaarheid correct wordt opgehaald voor meerdere tijdsloten en datums.
  5. Test reserve en cancel reserve. Simuleer een reservering en een annulering om te zien of je systeem beide correct verwerkt zonder restcapaciteit te verliezen.
  6. Test book en cancel book. Voer een volledige boeking en annulering uit; dit zijn de endpoints die GetYourGuide vereist voordat een koppeling geactiveerd wordt.
  7. Laat GetYourGuide valideren. Het platform valideert verbonden producten automatisch nadat prijs- en capaciteitsconfiguraties zijn ingevoerd.
  8. Los technische fouten met je SRS-leverancier op. Bij een mislukte validatie is de reserveringssysteem-provider meestal het eerste aanspreekpunt, niet GetYourGuide zelf.

Tijdens de validatiestap controleert GetYourGuide of de format van je data klopt, of prijscategorieën overeenkomen en of er voldoende tijdsloten beschikbaar zijn. Een mislukte validatie betekent bijna altijd een datamismatch, niet een probleem met het GetYourGuide-platform zelf.

Pro-tip: test altijd eerst één enkel product in de sandbox voordat je je volledige assortiment koppelt: zo herken je structurele fouten voordat ze zich over honderden producten verspreiden.

Wie dit stappenplan negeert en meteen het volledige aanbod koppelt, loopt het risico dat een kleine configuratiefout (een verkeerde tijdzone, een ontbrekende prijscategorie) zich vermenigvuldigt over tientallen producten. Een iteratieve aanpak, zoals ook aanbevolen wordt bij complexere SRS-koppelingen, kost in het begin iets meer tijd maar bespaart achteraf veel uitzoekwerk.

Veelvoorkomende verbindingsfouten en hoe je ze oplost

De meeste koppelingsproblemen zijn geen bugs in GetYourGuide's systeem, maar kleine datafouten aan jouw kant. Een paar terugkerende patronen verklaren het grootste deel van de mislukte validaties.

  • Controleer op verborgen spaties in de External Product ID: een enkel extra spatieteken aan het begin of einde van de ID zorgt dat de koppeling faalt zonder duidelijke foutmelding.
  • Check de tijdzone-instelling van je reserveringssysteem: een mismatch tussen de tijdzone van je systeem en die van de activiteit zelf verstoort de beschikbaarheidsdata.
  • Zorg dat er minimaal twee tijdsloten met beschikbaarheid zijn voordat je valideert: met slechts één tijdslot slaagt de validatietest vaak niet.
  • Stem prijscategorieën exact af tussen je systeem en het Supplier Portal als Price over API actief is: een afwijkende naamgeving van categorieën (bijvoorbeeld "volwassene" versus "adult") breekt de koppeling.
  • Bepaal vooraf wie je contacteert: technische koppelingsfouten los je op met je reserveringssysteem-leverancier, terwijl vragen over het Supplier Portal zelf bij GetYourGuide-support horen.

Ten minste twee beschikbare tijdsloten zijn vereist om een validatietest te laten slagen, en verborgen spaties in de External Product ID behoren tot de meest voorkomende fouten bij handmatige invoer, aldus de documentatie over verbindingsproblemen van GetYourGuide. Dat klinkt klein, maar het verklaart een groot deel van de supporttickets die eigenlijk met een kwartiertje zelfonderzoek te voorkomen waren.

Een praktische volgorde bij problemen: begin bij je eigen data (ID, tijdzone, tijdsloten, prijscategorieën), test opnieuw in de sandbox, en schakel pas support in als de fout blijft bestaan ondanks een schone configuratie. Zie ook onze eigen ervaring met kalender-integratie en het voorkomen van dubbele boekingen, waar vergelijkbare tijdzone- en slotproblemen vaak de kern van het probleem vormen.

Hoe vaak synchroniseert GetYourGuide en wat doet Notify-Availability?

Beschikbaarheid wordt niet continu live opgehaald: GetYourGuide werkt met een vast controleschema dat afhangt van hoe ver de datum in de toekomst ligt. Dat is belangrijk om te weten, want het bepaalt hoe snel een wijziging in jouw systeem zichtbaar wordt op het platform.

Periode vanaf vandaagControlefrequentie
Eerstvolgende periodeDagelijks
Middelste periodeElke 4 dagen
Latere periodeElke 8 dagen

Dit schema geldt voor de reguliere, periodieke beschikbaarheidscontroles die GetYourGuide uitvoert op elk gekoppeld product. Voor de eerste 365 dagen na mapping vindt er bovendien een initiële, volledige controle plaats.

Dat schema werkt prima voor geleidelijke wijzigingen, maar niet voor plotselinge situaties. Een massale annulering of een onverwachte uitbreiding van capaciteit kan niet wachten op de volgende periodieke check. Daarvoor bestaat de Notify-Availability endpoint: die stelt je in staat om GetYourGuide direct te laten weten dat de beschikbaarheid van een product veranderd is, zonder te wachten op het reguliere schema. Zonder die melding loop je het risico dat een activiteit nog boekbaar lijkt terwijl de capaciteit al vol is, met een annulering achteraf als gevolg.

Datastromen voor beschikbaarheid en prijsupdates

Prijzen volgen een ander mechanisme dan beschikbaarheid. Niet elke koppeling is per definitie realtime: of prijswijzigingen automatisch doorkomen, hangt af van of je reserveringssysteem Price over API daadwerkelijk ondersteunt. Veel leveranciers claimen API-koppeling maar implementeren alleen de beschikbaarheidskant, waardoor prijswijzigingen alsnog handmatig moeten. Vraag je leverancier dus expliciet of Price over API volledig is geïmplementeerd, niet alleen of er "een koppeling" bestaat.

Hoe RaxBooker integratie-uitdagingen in de praktijk aanpakt

Veel van de problemen die hierboven staan, komen in de praktijk terug bij elke koppeling: tijdzones die niet overeenkomen, prijscategorieën die anders heten, of een systeem dat alleen beschikbaarheid pusht en geen prijzen. Bij het opzetten van koppelingen letten we daarom bewust op precies die punten voordat een product live gaat.

Ons reserveringssysteem biedt kalendersynchronisatie en API-koppelingen die aansluiten op de endpoints die GetYourGuide vereist, van beschikbaarheidscontroles tot boekingsverwerking. Voor leisurebedrijven die van een ander systeem overstappen, bieden we een overstapservice aan die de technische kant van de migratie overneemt.

  • Er is ondersteuning voor realtime kalendersynchronisatie, zodat beschikbaarheid in het systeem en op het platform consistent kan blijven.
  • API-koppelbaarheid kan inbound en outbound dataverkeer mogelijk maken, afhankelijk van wat een koppeling vereist.
  • Een overstapservice kan het technische overzetten van bestaande data omvatten, inclusief de eerste configuratie van productvelden.

In de praktijk start een nieuwe koppeling bij ons op dezelfde manier als beschreven in de stappen hierboven: eerst een product in de sandbox testen, de External Product ID correct koppelen, en pas daarna reserve- en boekcalls valideren. Dat voorkomt dat kleine datafouten zich verspreiden over het volledige assortiment.

Pro-tip: vraag bij elke nieuwe koppeling expliciet naar de status van Price over API-ondersteuning: dat voorkomt verrassingen bij prijswijzigingen die niet automatisch doorkomen.

Wanneer is een volledige API-koppeling de moeite waard?

Niet elke leisureonderneming heeft evenveel baat bij een volledige API-koppeling. Wie slechts een handvol boekingen per week via GetYourGuide ontvangt, kan prima uit de voeten met handmatige updates en een eenvoudige inbound-koppeling. Het rendement van automatisering stijgt pas echt zodra het volume toeneemt en de kans op menselijke fouten (een vergeten prijswijziging, een dubbele boeking door trage updates) reëel wordt.

De afweging draait om drie factoren: boekingsvolume, de personeelskosten van handmatig beheer, en het risico dat een fout je daadwerkelijk geld kost. Een activiteit met beperkte capaciteit en hoge vraag loopt sneller het risico op overboekingen dan een activiteit met ruime beschikbaarheid, wat de Notify-Availability endpoint voor de eerste groep veel relevanter maakt dan voor de tweede.

Mijn advies is daarom simpel: begin klein. Koppel één product, test het grondig in de sandbox, en breid pas uit zodra de validatie zonder problemen verloopt. Wie meteen het volledige assortiment in één keer koppelt, vermenigvuldigt elke configuratiefout over het hele aanbod in plaats van die te isoleren tot één testgeval.

— Bernard

RaxBooker: starten met GetYourGuide-synchronisatie

Een GetYourGuide-koppeling draait voor een groot deel om de kwaliteit van het onderliggende reserveringssysteem: hoe consistent het beschikbaarheid doorgeeft, hoe volledig het prijscategorieën afstemt en hoe snel het reageert op boekingsverzoeken. Dat is precies waar we met ons platform op inzetten.

Raxbooker

Met onze reserveringssoftware hoef je niet zelf uit te zoeken welke endpoints je moet implementeren: kalendersynchronisatie en API-koppelbaarheid zitten al ingebouwd, en onze overstapservice neemt het technische werk van een migratie over zodat je team zich niet door documentatie moet worstelen.

  • We regelen de technische kant van de overstap via de overstapservice, inclusief het overzetten van bestaande productconfiguraties.
  • We bieden API-koppelbaarheid die aansluit op de endpoints die externe platforms zoals GetYourGuide vereisen.
  • We houden kalendersynchronisatie actueel, zodat beschikbaarheid en boekingen consistent blijven tussen systemen.

Wil je weten hoe dit voor jouw activiteitenaanbod werkt? Bekijk onze reserveringssoftware en overstapservice en vraag een concrete integratie-check aan.

Veelgestelde vragen

Hoe werkt GetYourGuide precies voor aanbieders?

GetYourGuide functioneert als marktplaats die boekingen van reizigers doorstuurt naar het reserveringssysteem van de aanbieder via gestandaardiseerde endpoints. Beschikbaarheid, prijzen en boekingen worden via een koppeling gesynchroniseerd, waarbij automatische validatie controleert of de data correct binnenkomt voordat een product live gaat.

Is GetYourGuide beschikbaar voor Nederlandse aanbieders?

Ja, GetYourGuide is actief als platform waarop ook Nederlandse aanbieders hun activiteiten kunnen aanbieden en koppelen via het Supplier Portal. De technische koppeling zelf verloopt via dezelfde endpoints, ongeacht het land van de aanbieder.

Kan ik als consument geld terugkrijgen van GetYourGuide?

Restitutie hangt af van de annuleringsvoorwaarden die de aanbieder zelf instelt in het Supplier Portal, niet van een vast platformbeleid. Veel activiteiten bieden gratis annuleren tot 24 uur voor aanvang, maar dit verschilt per productpagina en moet je altijd controleren voordat je boekt.

Wat zijn de meest voorkomende oorzaken van een mislukte koppeling?

De meest voorkomende oorzaken zijn verborgen spaties in de External Product ID, een tijdzone-mismatch en te weinig beschikbare tijdsloten tijdens de validatietest. De documentatie over verbindingsproblemen van GetYourGuide beschrijft dat minimaal twee tijdsloten vereist zijn voordat een validatie kan slagen.

Synchroniseert GetYourGuide prijzen altijd automatisch?

Niet standaard: of prijswijzigingen automatisch doorkomen, hangt af van of je reserveringssysteem Price over API volledig ondersteunt. Zonder die ondersteuning moet je prijswijzigingen handmatig invoeren in het Supplier Portal.

Bronnen

Aanbevelingen