Help center

Distribution · Step 9 of the listing wizard

Connecting a tour to GetYourGuide

Two systems have to agree before a single traveller can book. This walks through both of them, in the order that works: everything on our side first, then the GetYourGuide portal.

Before you start
You need a product already created on GetYourGuide with at least one option, and the GetYourGuide card in Step 9 has to read CONNECTED. That connection is set up once for your whole account, not per listing. If it says NOT CONNECTED, contact support before going further, because nothing you map here will reach GetYourGuide.
Do it in this order
Set everything up here and save the listing first. Only then open GetYourGuide and point the option at us. If you do it the other way round, GetYourGuide starts sending booking requests for an External Product ID that does not exist on our side yet, and every one of them fails.
The GetYourGuide box in Step 9 of the listing wizard
The whole GetYourGuide box in Step 9, with the listing defaults on top and one row per option below.
1

Turn GetYourGuide on

Open the listing, walk to Step 9 (Distribution), and switch the GetYourGuide toggle on. The box expands underneath it. CONNECTED on the right is your account connection, not this listing.

The GetYourGuide channel toggle switched on
Toggle on. If the listing is still a draft, GetYourGuide can take bookings but the tour will not appear in your GetYourGuide catalogue until you publish it.
2

Fill in the listing defaults

These apply to every option that does not set its own value. You can leave most of them on Auto.

Listing defaults: External Product ID, cutoff, availability type, pricing mode, vacancies, categories
Listing defaults. Every option below inherits these unless it overrides them.
  • External Product ID. Your own reference for this tour. You choose it, it can be any number or code you like, and it only has to be unique inside your account. It matters because GetYourGuide sends it back to us on every availability and booking call: it is how we know which of your tours is being asked about. This listing level one is only used when the listing has no option rows at all. As soon as you add options, each option needs its own.
  • Cutoff. How late a traveller may still book, in seconds before departure. Auto is 3600, which is one hour. Two hours is 7200.
  • Availability type. Fixed time for departures that leave at a set clock time. Open window for anything valid across a whole day. Auto picks fixed time when your schedule has real start times.
  • Pricing mode. Flat is one price per person. Per group is one price for the whole boat. Per category prices adults, children and infants separately. Auto follows how the listing itself is priced.
  • Vacancies by category. Leave off unless GetYourGuide is set up to count adult and child seats separately. Then the seats we report are split per category rather than given as one total.
  • Supported categories. Which ticket types this tour sells. It must be the same set as on GetYourGuide. If GetYourGuide sends a category you have not switched on here, we cannot price it and the booking is refused.
3

Add one option per departure

Travellers book an option, never the listing. A morning and an afternoon departure are two options, so they get two rows. Press Add option for each one.

One option row: name, External Product ID, GYG Option ID, departures, participants
One option row. This one sells the 13:30 departure only, for 2 to 6 people.
  • Name. For you, so you can tell the rows apart. Matching the reference code you use on GetYourGuide makes life easier later.
  • External Product ID. Again yours to choose, and it must be different for every option. This is the value you will type into GetYourGuide in step 6.
  • GYG Option ID. This one is not yours to invent. Copy it from the option on GetYourGuide, where it is shown as Option ID.
  • Departures this option sells. Tick the start times this option covers. Leave everything unticked and the option sells every departure in your schedule.
  • Min and max participants. The maximum is the seat count we enforce. Read the warning further down before you set it.
  • Cutoff, availability type, pricing mode, vacancies. Leave on Listing default unless this one option genuinely differs.
4

Save the listing

Use Save draft, or carry on to Step 10 and save from there. Nothing you typed exists for GetYourGuide until the listing is saved. This is the moment the options become real and the External Product IDs start resolving.

Only now open GetYourGuide
If you set the reservation system on GetYourGuide before saving here, GetYourGuide will start calling us with an ID we do not recognise, and it will look like the connection is broken when it is only early.
5

On GetYourGuide, open the option and go to Connectivity settings

In the GetYourGuide supplier portal, open the product, then edit the option you are connecting. Walk to the Connectivity settings step. Do this for each option separately.

6

Choose Operator Cockpit and paste the External Product ID

Select Yes, I use a reservation system. In the field underneath, type Operator Cockpit and pick it from the list. Then enter the External Product ID you gave this option in step 3. Character for character, no spaces on either end.

GetYourGuide connectivity settings: yes I use a reservation system, Operator Cockpit selected, external product ID filled in
The GetYourGuide connectivity step. Type Operator Cockpit, pick it from the list, then paste the same External Product ID you used on the option here.
7

Check the option summary against your row

When you save, GetYourGuide shows the option summary. Read it next to your option row and make sure the values are the same on both screens.

GetYourGuide option summary: reference code, option ID, cut off time, type, max group size, external product ID
Everything on this panel has a twin in the wizard. The Option ID goes in your GYG Option ID box, the External product ID is the one you chose, and the group size must be the same number as your Max participants.
In Operator Cockpit
On GetYourGuide
External Product ID (on the option)
External product ID
Identical, character for character. Different for every option.
GYG Option ID
Option ID
Copied from GetYourGuide into the wizard, never typed from memory.
Max participants
Group size or maximum participants
The same number, and that number is the real capacity of the boat. This is the one that causes overbooking.
Departures this option sells
Start times on the option
Same times to the minute. 13:30 and 13:35 are two different departures to us, and one of them has no seats.
Cutoff (seconds)
Cut-off time
3600 seconds is 1 hour, 7200 is 2 hours. If GetYourGuide closes later than you do, it sells departures you have already closed.
Pricing mode
Price setup
Per person and per group are different products. Selling the whole boat as one ticket against a per person listing makes the totals disagree.
Supported categories
Ticket categories
Adult, child and infant must be the same set on both sides.
8

Test it

Ask GetYourGuide to run a test booking, or watch the first real one. A booking that arrives lands in your Bookings list within seconds and the seats come out of the same departure your own guests book. If nothing arrives, the External Product ID is the first thing to check.

The mistake that causes overbooking

Nothing reconciles the two systems. GetYourGuide sells against its own copy of the setup, we answer availability and hold seats against ours, and neither side warns you when they disagree.

The damaging case is setting a higher capacity in Operator Cockpit than the option on GetYourGuide actually offers. The two sides now believe in different boats. GetYourGuide keeps selling past the number of seats that really exist, and the mismatch only surfaces at the last moment, when the traveller has already paid and we are asked to hold seats that are not there. We refuse.

The warning shown in the GetYourGuide box about settings that must match
The same warning sits at the top of the GetYourGuide box, next to the fields it is about.
What you will see when this happens
GetYourGuide does not read that refusal as a sold out departure. It reads it as the reservation system failing, so it emails you saying the booking could not be confirmed automatically and asks you to confirm or decline it by hand. Nothing is broken. The two capacities simply disagree, and a traveller is waiting while you decide. Keep the numbers identical and this email never arrives.

Set the maximum to the true capacity of the boat or vehicle, here and on every GetYourGuide option. Not the number you would like to sell, and not a number left over from a bigger boat. Check every option, because the maximum is set per option on both sides.

Lowering it to the honest number can push departures that already carry bookings straight to sold out. That is the correct answer: those seats were never really available.

Questions that come up

Where do I find the Option ID?

On GetYourGuide, on the option itself, shown as Option ID next to the reference code. Copy it across rather than retyping it.

Can two options share one External Product ID?

No. It is the only thing that tells us which departure a booking is for. Sharing it sends the afternoon booking into the morning boat. The wizard refuses to save duplicates.

I changed a departure time. What now?

Change it on GetYourGuide too, in the same sitting, and re-tick the departure on the option row here. A start time that exists on only one side sells a departure that has no seats.

Do I have to push availability after a change?

No. We publish availability to GetYourGuide as soon as it changes, and GetYourGuide also asks us fresh whenever it needs a number.

Bookings still fail and every value matches

Check whether this tour shares a boat with another listing. A booking on either one closes the overlapping window on both, and GetYourGuide is simply told there is nothing left for that time. See Linked availability: tours that share one boat.

Related: What has to match, and where · How options map to your departures · What to enter for External product ID
Still stuck? Open a support request.