Viator mapping (article)

Susana Moleón Moya
Susana Moleón Moya
  • Updated

Once you have a contract in place with Viator, please contact the Tour CMS team to complete the configuration of your connection by adding your Viator Supplier ID and API key within TourCMS.

On Viator's portal, go to Account  / Connectivity and choose TourCMS as your Reservation system.



You may notice that an Invite code is required for connection to Viator through TourCMS Marketplace:



The TourCMS Support team are able to assist with that after which your products are ready to be mapped between your TourCMS account and the Viator extranet.

For flawless mapping, keep in mind what we call “the four pillars of mapping”: AccountID, TourID, Offer (starting times /supplier notes), and Rates. This information should always be consistent in both systems.

Here’s a quick guide on how to map your products yourself. 

1. Fill in the Viator mapping codes on TourCMS

Go to one of the products that will be distributed through Viator, click on Setup -> Operation / Suppliers



Add the Viator mapping code  in the respective field so the system can send this tour’s information to the Viator extranet. The code has two main parts: 

The first part of the Viator mapping code will be the UniqueID of the tour, which you can find in the Operation/Suppliers tab. The Unique ID is formed by two letters, your account ID and the tour ID. For example, if the Unique ID of a tour is PA_14091_4, we know the Account ID is 14091 and the Tour ID inside that account is 4.

The second part of the Viator mapping code will depend on how your tour’s departures are configured, based on starting times and supplier notes. 

There are four main types of Viator mapping codes depending on departure configuration:

1.1. Single departure per day

Viator mapping code = UniqueID
If a tour has one departure per day, there is no need to add anything to the Unique ID of the tour.

1.2. Several departures per day with different departure times.

Viator mapping code = UniqueID|MAP_TIME
If you have several departures per day differing only by start time, you should add |MAP_TIME to the Unique ID. Every time-slot in TourCMS is mapped to a time-slot in Viator.



2.3. Several timeslots per day with different supplier notes (one departure time per date or no set times in TourCMS and on Viator):

Viator mapping code = UniqueID|MAP_SUPPLIER_OC_TO_SUPPLIER

If you have several departures per day with no time set or starting at the same time but with different supplier notes (for example, multilingual tours), you need to add |MAP_SUPPLIER_OC_TO_SUPPLIER. 

In the example below, as starting times are the same, it is not possible to match those to departures with a time-slot in Viator, so you must match each supplier note with an option in Viator.




2.4. Several start times per day with different supplier notes (multiple start times per date):


If you have several departures per date with different start times plus with different options (for example, multilingual tours), you need to add |MAP_SUPPLIER_OC_TO_SUPPLIER_PLUS_TIME.

For example, a cruise departing at 7:30 pm and 9 pm each day with options of Dinner only / Dinner and Drinks / Dinner, drinks and window table. As the starting times are more than one per day with different start times, Viator's system needs to be triggered to send both option and time when booking for bookings to enter TourCMS into the correct timeslot. Please note this means that each option (supplier note) in TourCMS would require its own Option on Viator portal.




2. Connect your products on the Viator extranet.

Note: For this step you must have created and set up your products on the Viator extranet and added the Viator mapping codes in TourCMS.

Go to the product you want to connect to TourCMS, click on Manage > Product connection > Connect



Click on Select a product to display a list of your products in TourCMS with their name and UniqueID. Only the tours with a Viator mapping code added in TourCMS will be shown in this list.




In case you are mapping a tour with a single departure per day, choose the correct product from the list, and voilà! The connection is done.

In case of different starting times, as long as you have configured the Schedules and prices tab on Viator and correctly added the Viator mapping code in TourCMS, the times will be synchronized automatically when you choose the product from the list and connect it.



If you have different supplier notes, you will need to created different options in Schedules and prices.


Then, in product connection, you will be shown those options so you can map each one with its corresponding time or supplier note. 



3. Rate Types.

Keep in mind that rates also need to be the same in TourCMS and Viator. Many OTAs like Viator have a specific catalog of rate types (for example: adult, child, infant, senior), meaning that any other rates won’t be valid.

  • Can I map several products on TourCMS to just one product on Viator?

Yes, it is possible. 

Let’s look at a concrete example to make it easier. Imagine you have the following three products on TourCMS:

1. Segway Tour in Málaga (ID 1)
2. Segway Tour in Seville (ID 2)
3. Segway Tour in Granada (ID 3)

The same could be configured in Viator as:

1. Segway tour:

  • Option 1: Málaga
  • Option 2: Seville
  • Option 3: Granada

In the product connection tab, you would connect Málaga (option 1 in Viator) with ID 1 in TourCMS, Seville (option 2) with ID 2, and Granada (option 3) with ID 3.

The process is the same as connecting supplier notes, but instead of connecting options in Viator with supplier notes in TourCMS, you would be connecting options in Viator with products in TourCMS.

  • Can I map pick-up points?

It is possible to map pick-up points between TourCMS and Palisis. For more information, check this article.