With Bookeo you can sell your tours and activities on GetYourGuide (GYG), an online marketplace where people can find, compare, and book sightseeing tours, excursions, things to do and fun activities from around the world.
If you do not have an account with GetYourGuide, click here to learn how you can sell your products on GetYourGuide and click here to sign up as a supplier.
In this article:
Enable the integration with GetYourGuide
In your Bookeo Tours and Activities account:
1. Go to Marketing>Distribution channels
2. Click on GetYourGuide
3. Tick the Enable [1] checkbox
4. GetYourGuide uses 9 fixed categories of people in its reservations. In the Participants [2] section, you can set to which categories they correspond in Bookeo.
4. To map your Bookeo tours to your GYG tours, in the Products section, click on the New [3] button
5. From the Tour [4] drop-down menu, select the tour
How to map a single tour in Bookeo to multiple products in GYG
Sometimes you have a tour set up in Bookeo, but have two different products corresponding to it in GYG. For example, you offer a guided tour in two languages, and in Bookeo you have set up one tour with a drop-down additional option to let customers select the language, but in GYG you have two separate products, one for each language. In this case, you can map two product IDs in Bookeo, by selecting the Option [7] and Choice [8] corresponding to the specific tour in GYG.6. Click on the Copy [5] button to copy the tour ID that you will have to paste into your GYG Supplier Administration account, following the instructions in the GYG tutorial here.
7. Click OK [6] to save
Tour booking limits
GetYourGuide will only move forward with connecting via API if the maximum booking limits of your tours in Bookeo are equivalent or lower than the cut-off time listed for the product on GYG. GYG accepts a maximum cutoff of 10 hours. You can learn more about GYG cut-off time hereOpen schedule tours
Open schedule tours are not supported by GYG.
Use per person pricing in GetYourGuide
In your GetYourGuide dashboard, you can choose whether to use "per person" or "group pricing" for your tour: make sure to select "per person" pricing.
Special prices
GetYourGuide does not support special prices. If you have set up special prices for your tours, you should select "availability only" in your GetYourGuide dashboard. You will have to manually specify the prices you want to charge in your GetYourGuide dashboard. Click here to learn more
Changes to your tours/activities
Once connected, we strongly recommend that you reach out to your GetYourGuide Account Manager directly if you change your tours/activities - for example, if you change your tour schedule and availability - since this could possibly break the mapping and cause bookings to fail.
Troubleshooting
When setting up the connection in GetYourGuide, if you get an error message, it usually indicates that GetYourGuide found some discrepancy in the configuration. The most common error messages and their solution are below.
"Invalid API Response received from external system"
This message can have several different causes.
Possible cause 1: in your Bookeo dashboard, in the integration page under the section "Participants" you have enabled a person category (Seniors, Student, EU Citizen, etc) that is not enabled in GYG. If a category is not enabled in GYG, make sure to select [DISABLED] in Bookeo, like this:
Possible cause 2: there is a discrepancy between the timezone you set in Bookeo (in Settings>Regional settings) and the timezone configured for the tour in GetYourGuide. If GetYourGuide detects that Bookeo uses a different timezone, it will generate this error message. Make sure to check that your timezone is correct, in your Bookeo dashboard, under Settings>Regional settings.
"While validating the connection, your reservation system rejected a reservation request stating invalid category that is not configured for this product."
This error message usually occurs when GYG tries making a test booking for a participant category that is not supported in your Bookeo settings for the tour. For example if in GYG you set that you accept children, but in Bookeo you set that the tour does not accept children, when GYG tests a booking with children, it will display this error message. In Bookeo, you can set whether you accept a certain category in the People tab of the tour. Also make sure to check Marketing>Distribution channels>GetYourGuide to see where GYG people categories are mapped to Bookeo's.
"While validating the connection, your reservation system rejected the min and max participant configuration for the reservation request"
This error message means that GYG tried a test booking, and it did not match the min/max people requirements that you set in the People tab of the tour's settings page.
For example if in Bookeo you set that the min number of people per booking is 2, then you need to set the same limit in the capacity page of your GYG product dashboard. If in Bookeo you set that the minimum number of Adults is 2, you need to set the same limit in GYG product dashboard. And so on.
Another possible cause for this error message is if in GYG you selected to use "group" pricing instead of "per person". Please review instructions above.