When integrating your sales and offers via GetYourGuide, it is important to follow a series of steps to ensure seamless communication and unity between both systems when bookings occur.

Before we can dive into the details, you need to make sure you have submitted your application to GetYourGuide - once it is granted, you will get access to your GetYourGuide interface.

Did you not yet submit your interest in the GetYourGuide integration? 

Get started on your GetYourGuide Supplier Application 


Once you have access and you want to make sure that the communication between GetYourGuide and Convious works, it is time for the next step because that is what external IDs are for.

To add the right external IDs to both systems, there will be steps you need to take in your GetYourGuide interface and steps you need to take in your Convious Control Panel.

Adding external IDs via GetYourGuide

  1. Before you begin, ensure that the products you want to use from the Control Panel are grouped into a single category. Currently, the integration of products spanning multiple categories with GetYourGuide is not supported.

  2. Go to ProductsManage Products.
  3. Choose the activity you would like to connect > Edit details.
  4. Choose the “Options view”. 
  5. Select Edit next to “Connectivity Settings”.
  6. Select Convious as the reservation system from the dropdown list 

  7. Enter Product ID  

The GetYourGuide system has a concept of products and product categories, which represent a subtype of a ticket. For example, a product could be a "Day visit," and it could have one or more (or all) of the following categories:


However, you most likely will have separate products for adults, children, etc., set up in your Convious Control Panel. To link those together, so your Convious system knows those separate products are, in fact, the same product within the GetYourGuide system, a specific format of external IDs is needed.

A few guidelines for GetYourGuide external IDs:

  • They need to be unique across partners and products 
  • They need to be in the following format: <product_id>-<category_id>, where product_id is some unique value that is specified in the GetYourGuide system and category_id is one of the category-IDs listed above.

?Since IDs also need to be globally unique, a recommended way to come up with those external IDs would be to prefix the product ID with the account slug and use sequential numbering. For example, if FunPark integrated with GYG, its IDs would look like this:


7.1 To get the unique product_id you would need to set the names such as funpark_1 or funpark_2 as product IDs in the GetYourGuide system.

Here is an example setup for the FunPark safari tour, which has multiple age category options on GetYourGuide.

7.2  At GetYourGuide, you will have to once enter only 1 ID to the "Day visit"-product from the “GetYourGuide External ID" column.

8. Hit Save.

Adding external IDs via the Convious Control Panel:

Looking at the example above, on the Convious side, you will have 4 products, and thus, you will have to enter the 4 different external IDs to appropriate products - from the column "Convious External ID."

To add an external ID to your product...

1. Navigate to your Products page.

2. Select to edit the product this integration applies to.

3. In the Product editing page, scroll down to the external ID section and add the appropriate external ID.

Here is an example of how this would look like for an adult ticket: 

9. Repeat this process for all corresponding products. In this case, this would be for youth adding funpark_1-YOUTH and for child tickets adding funpark_1-CHILD as external IDs.


And now?

Further, we advise you to check your test booking also by scanning the test ticket at your venue, confirming whether the booking went through to the Convious system as expected.

For more details on the setup, reporting and fee's, please contact support@convious.com