How to Connect to Viator (TripAdvisor Experiences) – TuriTop Booking System Help Center

Where can I find it? Company tab >>> Channel Manager >>> Viator API.

In this guide, you will learn how to connect your TuriTop services with Viator to centralize all your bookings in your TuriTop panel.

First Things to Check

Before you start connecting your services, there are a few important things you need to know:

To connect Viator with TuriTop, you'll first need to make sure you have an account and have configured your services on both TuriTop and Viator. If you don't have a Viator account yet, please register here.
The Viator integration only works with Tour/Activity services (this is how Viator operates; it's not a limitation of the TuriTop booking system). Services with open schedule or seat selector cannot be synchronized at this time.
The TuriTop integration with Viator manages the exchange of three key pieces of information: it handles the availability of your services between both platforms, inserts reservations sold through Viator into TuriTop, and processes the cancellation of those reservations when necessary. Therefore, you must manually update other details, such as prices, service descriptions, ticket types, and add-ons, on both platforms.
If you use the Seasonal Closing / Maintenance functionality in TuriTop, you must manually edit the availability in Viator. Check this Viator article for more information.
Make sure both platforms have the same time zone. You can check this in TuriTop under the Company tab >>> Default Settings >>> Time Zone. In Viator, your time zone is determined by your geographical location and can be reviewed in your Account settings >>> Office information.
The current integration does not support group tickets. It is essential that your tickets in TuriTop are set up for per-person sales, and that you've configured the same setting in Viator. You can find this setting in each product's configuration under Booking details >>> Pricing type >>> How do you price your product?

Note that deactivating a service in TuriTop does not automatically disable the corresponding product in Viator. For a product to be taken off sale, it must be deactivated on both platforms.

Connect Your TuriTop Account with Your Viator Account

Step 1: Fetch Your API Key

The first thing you will need to do is fetch the API key and connect to Viator. Go to your TuriTop control panel >>> Company tab >>> Channel Manager >>> Viator API:

1. Click on Channel Manager and then Viator API
2. Click on Generate Key
3. Click on Accept
4. Copy your API Key

Step 2: Insert Your API Key in the Viator Panel

Go to your Viator panel and click on your user in the upper-right corner. Go to Account >>> Connectivity >>> Connect now.

From the list, choose TuriTop as the booking system and select Save. Here, you must insert the API Key from Step 1. The request will then be ready to be validated by Viator.

Sometimes the application may remain pending for a while due to a high load of requests Viator receives. To solve this, please contact us at help@turitop.com, and we will complete the validation for you.

Connect Your TuriTop Services

Step 1: Map Viator Tickets to Your TuriTop Tickets

Tickets must have their visibility set to an option that includes the back-office. If this is not set, the mapping will not be possible.

In order to connect the Viator tickets with those in the TuriTop booking system, go to the Services tab >>> PX (Choose your service) >>> Channel Manager >>> Viator API.

Here, select the TuriTop Ticket type that most resembles the Viator Ageband ticket type. When you are done with the ticket mapping, simply click the checkbox next to "Enable this service for Viator API". Once enabled, copy your Supplier Product Code; you will need it later to connect this product in the Viator panel.

In order for the integration to work, every Ticket type must be mapped. If you have ticket types left out or you don't know which to link, choose any of them.

Step 2: Connect Your TuriTop Service to the Corresponding Viator Product

Now you will need the Supplier Product Code from Step 1 to continue with the connection. Copy this code and make sure to clearly identify which TuriTop service (e.g., P1, P4, P76) corresponds to it before you proceed.

To connect your TuriTop service to Viator, you will need to go to the products page in your Viator panel, identify the product you wish to connect, and click on "Manage."

Once you are in the product's configuration, navigate to the "Product connection" section or tab and click "Edit."

Select your TuriTop service that corresponds to the Viator product, ensuring the number matches the Supplier Product Code. Then, click "Connect." Check that the schedules match and click "Save." This completes the API connection with Viator for this product.

Troubleshooting Guide

I'm getting a "Schedules Mismatch" error when connecting a product

If you're seeing an error like "Schedules Mismatch," you need to set up the starting times in Viator to match the times you have in TuriTop. This will prevent the error and allow you to make the connection.

I'm getting an error with code TGDS00028 when I click connect

If you see a "Something went wrong. Error Code: TGDS00028" message when you try to connect the product, don't worry, as this is a common error caused by a delay in the synchronization of new products. We recommend waiting 12 to 24 hours and trying the connection again. You can also solve this in your Viator panel by going to Account >>> Availability Refresh >>> Refresh.

Prices in Viator will affect those entered in TuriTop?

The API connection only checks availability. This means that any other data will not be synced.

I'm getting a "You haven't set starting times" message

If you ever encounter this message, please, go to your affected product page and click on Prices and Schedule. Then, edit the schedule and change the type of schedule to Start Time.