Artikelen over: Veelgestelde vragen

Connect Get Your Guide to your shop

GetYourGuide koppelen met Booqi

De GetYourGuide-integratie van Booqi houdt beschikbaarheid en boekingen gesynchroniseerd tussen je Booqi-account en GetYourGuide. Na het koppelen kan GetYourGuide rechtstreeks beschikbaarheid controleren, reserveringen aanmaken, boekingen bevestigen en annuleringen naar Booqi sturen.

Voordat je begint

Je hebt nodig:

  • Een actief Booqi-account met de producten die je wilt verkopen al ingesteld.
  • Een GetYourGuide-leveranciersaccount.
  • Toegang tot Add-ons in Booqi.
  • Een gebruikersnaam en sterk wachtwoord voor de API-koppeling.

Stap 1: GetYourGuide instellen in Booqi

  1. Log in bij Booqi en ga naar Add-ons.
  2. Open GetYourGuide en schakel de add-on in.
  3. Vul een gebruikersnaam en wachtwoord in voor Basic Authentication. Je gebruikt dezelfde gegevens in GetYourGuide.
  4. Kies welke Booqi-producten GetYourGuide mag verkopen:
    • Alle producten
    • Alleen geselecteerde producten
    • Alle behalve geselecteerde producten
  5. Als je producten ticketcategorieën gebruiken, zoals Volwassene, Kind of Senior, koppel dan elke GetYourGuide-categorie aan de overeenkomende Booqi-doelgroepcategorie.
  6. Sla je instellingen op.

Optioneel: schakel beschikbaarheidsmeldingen in als Booqi GetYourGuide moet informeren wanneer de beschikbaarheid verandert.

Stap 2: Booqi koppelen in GetYourGuide

Configureer Booqi in je GetYourGuide Connectivity-instellingen met deze API-basis-URL:

https://your-subdomain.booqi.me/api/gyg/1

Vervang your-subdomain door je Booqi-subdomein.
Gebruik de gebruikersnaam en het wachtwoord voor Basic Authentication die je in Booqi hebt aangemaakt.
GetYourGuide moet de volgende endpoints gebruiken:

Doel

Endpoint

Beschikbaarheid controleren

GET /get-availabilities

Reservering aanmaken

POST /reserve

Reservering annuleren

POST /cancel-reservation

Boeking bevestigen

POST /book

Boeking annuleren

POST /cancel-booking

Gebruik voor productkoppelingen de Booqi-product-ID. Je vindt deze in de product-URL of in het Booqi-productoverzicht.

Zo werkt de koppeling

  1. GetYourGuide vraagt de beschikbaarheid op bij Booqi voordat een tijdslot wordt aangeboden.
  2. Wanneer een klant een boeking start, maakt GetYourGuide een reservering aan in Booqi.
  3. Zodra de betaling is bevestigd, bevestigt GetYourGuide de boeking en maakt Booqi de tickets aan.
  4. Als een boeking wordt geannuleerd, stuurt GetYourGuide de annulering naar Booqi en komt de capaciteit weer vrij.

Boekingen die via deze koppeling worden aangemaakt, worden in Booqi gemarkeerd als boekingen via GetYourGuide reseller.

De koppeling testen

Controleer vóór je producten live zet op GetYourGuide of:

  • GetYourGuide de beschikbaarheid voor elk gekoppeld product kan ophalen.
  • De juiste ticketcategorieën worden teruggegeven.
  • Een testreservering kan worden aangemaakt en geannuleerd.
  • Een bevestigde boeking de juiste tickets in Booqi aanmaakt.
  • Een annulering de Booqi-bestelling bijwerkt en de beschikbaarheid herstelt.

Problemen oplossen

GetYourGuide ontvangt een authenticatiefout
Controleer of de add-on is ingeschakeld in Booqi en of de gebruikersnaam en het wachtwoord voor Basic Authentication in beide systemen exact overeenkomen.
GetYourGuide kan een product niet vinden
Controleer of het product is ingeschakeld in Booqi, binnen de productselectie voor GetYourGuide valt en is gekoppeld met de juiste Booqi-product-ID.
Een ticketcategorie kan niet worden geboekt
Koppel de betreffende GetYourGuide-categorie, bijvoorbeeld ADULT of CHILD, aan de overeenkomende Booqi-doelgroepcategorie.
Beschikbaarheid ontbreekt of is onjuist
Controleer of het product actieve datums of tijdsloten heeft, voldoende capaciteit heeft en binnen de productselectie van de GetYourGuide-add-on valt.
Een boeking kan niet worden geannuleerd
Boekingen kunnen niet meer worden geannuleerd na het inchecken of nadat het geboekte tijdstip is verstreken.

Bijgewerkt op: 13/10/2026

Was dit artikel nuttig?

Deel uw feedback

Annuleer

Dankuwel!