Learn how to map Checkfront item parameters to Viator age brands in Checkfront, how to send your integration activation request to Viator, and how to find instructions on connecting your products in Viator. Review our mapping limitations and considerations for further instructions.
|
Looking for more information on Viator? This article is the third in the series covering setting up your Viator integration in Checkfront. Read the previous article for information on accessing the integration setup, signing up for a Viator account, and providing us with the necessary key information and configuration preferences. Read the first article in this series for an introduction to the Viator integration. |
|
Reaching out to Checkfront Support Please reach out to Checkfront Support if you need any help with mapping or would like us to double-check that your mapping is set up correctly. |
Accessing the features mentioned in this article
What industry does this feature apply to?
- X Accommodations | ✓ Activities | ✓ Tours | X Rentals | ✓ Adventures | ✓ Escape Rooms | Learn More
Where can I find this feature using the top menu?
- Classic Items: Manage > Integrations > Channels > Viator
- Classic Products: Contact Support to determine if your account is eligible.
What more do I need to use this feature?
- Admin permissions to manage integrations.
- A Viator account (or sign up during integration setup!)
Which Checkfront version supports this feature - classic items, classic products, or both?
- This feature is available in both our classic version, which uses classic items (Inventory > Items), and our classic version, which uses classic products (Inventory > Products).
|
Are you using Checkfront with Classic Products? Please contact Customer Support to determine whether your account is eligible to use our Viator integration. If your account is eligible, we provide you with further instructions on how to connect with Viator. Learn more here about how to determine if your account is using Classic Products: |
Mapping item parameters
The options you select in the Item Parameters section of the Add-on Setup modal (Integrations > Channels > Viator) determine how your Checkfront item parameters are mapped to your Viator age bands.
Checkfront allows you to create as many item parameters as you need. Conversely, Viator offers only a limited set of parameters for use with its system.
This difference can make it tricky when mapping your parameters between the two systems, depending on the complexity of your Checkfront setup.
The Viator parameters are Adult, Youth, Child, Infant, and Senior. You need to match these to your Checkfront parameters using our mapping settings.
Parameter mapping is achieved via the parameter dropdown menus, as shown in the image above.
The options in the dropdown menu represent the Viator parameters. Check off each one you need to map to the matching Checkfront parameter. Depending on your configuration, you may need to map multiple Viator parameters to each Checkfront parameter.
Usage Examples
Here are some usage examples based on the simple Checkfront parameters, Qty, Adult, and Child.
Qty
The Checkfront parameter Qty (quantity) is not age-based. Therefore, we must map all Viator parameters to this parameter.
Adult
Viator also has an Adult parameter, so this is a simple, like-for-like map.
Child
Looking at the Viator parameters, you see three that could be mapped as children to Checkfront: Youth, Child & Infant.
So, in this case, we will select the three child parameters in Viator and map them to the Child parameter in Checkfront.
Sending an Activation Email to Viator
After you finish mapping and save your configuration settings, click the Send Activation Email button to send your activation to Viator for processing.
| The integration activation with Viator can take up to 24 hours. Plan ahead to allow time to set up your integration without any time pressure! |
Connecting your products in Viator
|
Once you have activated the integration for your account, you can sync your Viator products to your Checkfront items within your Viator dashboard/product builder. You can find out how to do this using Viator's helpful guide. Viator uses the terms API and external reservations system to refer to integrations such as Checkfront. |
Mapping Limitations and Considerations
Configuring items for mapping
Items must meet these configuration requirements.
- Item parameters must be configured per person/guest. Viator mapping does not work with items configured per vehicle, room, or other settings.
- Items must be visible to everyone. Hidden parameters don’t work. This includes staff only, package only, and child items.
- Items must be configured to control inventory.
- Items must have an inventory greater than zero.
- Items must have availability within the next 30 days.
Mapping Multiple Timeslots
|
Expert Tips from Checkfront Support: Mapping Multiple Timeslots "You must create an individual Product Option in Viator to map to each timeslot in Checkfront. Without multiple Product Options, you can only map to one Checkfront timeslot and all bookings are created for this timeslot regardless of the time the Guest selects in Viator." For information on how to set up Product Options in Viator, you can check out these Viator articles: |
Mapping multiple parameters
If a Viator parameter maps to multiple Checkfront parameters for the same item, all selected parameters are mapped automatically. In this case, you cannot map only to select Checkfront parameters.
Reporting on commissions or Guests
Checkfront cannot collect reports on commissions or Guests booked through the channel. You will need to rely on Viator for this information.
Mapping Guest fields
Checkfront cannot map custom Guest fields to Viator remarks, as Viator sends booking details, we cannot sync them with individual booking form fields.
Providing Guest contact information
Viator provides you with the Guest's mobile phone number, but not an email address. Learn more about the Viator Customer Details setting here.
Changing schedules/timeslots
If you change the schedule or time slot of an item, it needs to be manually mapped within iator. You must contact Viator directly and inform them of the change(s). As a result, changes to your schedule take time to be reflected on Viator. In the meantime, you can "close" existing trips by blocking them or setting the capacity to 0.
Changing an item's "schedule" is fine (like opening/closing dates). It becomes tricky only if you change the item's timeslots or SKU, as these are used directly in the "option codes" on Viator.
Viator will need this mapped MANUALLY on their side.
Any changes to items are only reflected when you submit your batch availability request (twice a day), so we cannot remap items immediately after changes are made.
Understanding overbooking rules
Viator is considered Staff under the Rule Sets in Checkfront. If you have a Rule allowing Staff to overbook associated with an item listed on Viator, Viator will look to this rule to determine availability. Viator could overbook an item. If you would prefer Viator be considered a Customer in terms of Rule Sets, then please reach out to Checkfront Support, who can enable this feature for you.
Frequently asked questions
-
If I cancel a booking, what happens to the booking?
If you cancel a booking in Checkfront, it is not automatically canceled in Viator. You need to cancel the Viator booking manually.
If you cancel a booking in Viator, an email can be sent to the Operator, but the booking is not canceled in Checkfront.
-
If I edit a booking, what happens to the booking?
When a booking is edited in Checkfront by an Admin or Staff member, Checkfront does not update Viator. You must manually edit the Viator booking.
When a booking is edited in Viator, an email can be sent to the Operator, but the booking edit is not automatically synced in Checkfront. You must manually update the booking in Checkfront.Once a booking has been synced to Checkfront, it cannot be updated and synced again.
Below are listed some examples of modifications that require manual updates.
- Changes of name/last name made in TripAdvisor / Viator/ Checkfront.
- Changes in the number of Guests (and therefore a new payment added or deducted) made in TripAdvisor / Viator/ Checkfront.
- Changes of the booking date made in TripAdvisor / Viator/ Checkfront.
-
Cancellations of the booking date made in TripAdvisor / Viator/ Checkfront.
-
How often is inventory in Checkfront checked?
If bookings are made in Checkfront, it may take some time for Viator to refresh availability, as Viator checks inventory at regular intervals.
- Availability checks are done twice a day (every 12 hours). This checks the availability for all products for the next 365 days.
- Inventory is rechecked before the booking is confirmed.
-
Does Checkfront send pricing to Viator?
Checkfront doesn't send over the pricing to Viator. Prices must be set manually in Viator.
-
Why do imported bookings display as zero dollars?
Viator does not share cost details with Checkfront. Invoice and tax information can be found in Viator.
-
Do Checkfront Notifications work with Viator bookings?
No, Viator does not provide us with the Guest's email address, so we cannot send automatic email notifications.
-
Do past bookings sync when the integration is activated?
No, Viator only syncs bookings made after the integration has been activated. You can manually import the bookings or adjust the inventor calendars accordingly.
- Which rules transfer to Viator?
- Cutoff (Inventory > Rules)
- Minimum/Maximum duration per item (Inventory > Rules)
- Min/Max per Booking (Inventory > Items > Attributes > Parameters)
-
How do I map Viator Questions and Answers to Checkfront Booking Form fields?
Viator has Guest booking form fields named Questions (label/name) and Answers (value entered by the Guest). You need to ensure the following is in place for the mapping to work.
- The Question name needs to exactly match the Checkfront booking form field Label.
- The Show on invoice option (Manage > Layout > Booking Form > Edit > Option) must be enabled to easily view the Answer from Viator.
< Setting up the Viator Integration with Checkfront