Skip to main content
All CollectionsConnectivityOperator Connections (Backends)
Xola Operator Connection
Xola Operator Connection

How to connect your products in Ventrata to operator using Xola booking system to resell their products

Dominic Martinkevic avatar
Written by Dominic Martinkevic
Updated over 3 months ago

Xola is an online booking system for tours and attractions operators, serving a wide range of mid-sized to enterprise operators. Xola serves businesses across the Americas and Western Europe.
​
This operator connection (also referred to as backend) allows you to connect with other operators using Xola as their booking system to resell their products through Ventrata more efficiently and automatically. The capabilities of this connection include:

  • Syncing availability and pricing from your operator's Xola system.

  • Posting bookings, updates, and cancellations from Ventrata to Xola.

  • Receiving vouchers/tickets from your operator's Xola system and issuing them to your customers.

Configuring Operator Backend

Before You Begin:

  1. While Ventrata integrates with Xola, you must be listed as a Distribution Channel in Xola's App Store to use this integration. To inquire about being listed, email [email protected] and [email protected] providing the names of the Xola-powered operators you wish to connect with, along with your desired logo, business name and point of contact for the app listing. Please allow several days for Xola to review and approve your request.
    ​

  2. Once you are listed in Xola's App Store, contact your operator using Xola and request the "OCTO API Key". Your operator will need to install your app in Xola and select products (Xola experiences) the wish to share with you.
    ​

  3. In the Ventrata Dashboard, navigate to Products → Operators, and select the Xola-powered operator for which you would like to set up the connection.

  4. In the Backend Partner section, choose Xola from the list of available connections and enter the OCTO API Key provided to you by your operator. Unless otherwise instructed by the operator or Xola, leave the OCTO Endpoint field with the default pre-filled value for Xola https://octo.xola.com/latest.

    In the Backend Partner section, choose Xola from the list of available connections and enter the OCTO API Key provided to you by your operator. Unless otherwise instructed by the operator or Xola, leave the OCTO Endpoint field with the default pre-filled value for Xola <a href="https://octo.xola.com/latest" target="_blank" rel="nofollow noopener noreferrer">https://octo.xola.com/latest</a>.

  5. Click Update Operator to save the configuration.
    ​

Mapping Products

Once the operator has been configured with its backend, you can proceed to Product Mapping—the process of connecting your Ventrata products and options with the corresponding products and options from the operator's Xola system:

  1. In the Ventrata Dashboard, navigate to Products → Products and select the product you would like to map to the operator's Xola system.
    ​

  2. Edit the product and ensure the Operator is set to the correct operator to which this product belongs, where you have already configured the backend.

  3. Check Backend Connected for this product to use the API connection (backend). To pull availability from Xola, ensure Backend Availability is checked; to pull pricing, check Backend Pricing. If you do not check Backend Availability and/or Backend Pricing, the product will use the availability and/or pricing configured in Ventrata but will still post bookings to Xola. Click Update Product to save.
    ​

    Check Backend Connected for this product to use the API connection (backend). To pull availability from Expian, ensure Backend Availability is checked; to pull pricing, check Backend Pricing. If you do not check Backend Availability and/or Backend Pricing, the product will use the availability and/or pricing configured in Ventrata but will still post bookings to Expian. Click Update Product to save.

  4. The product page will now display a Mappings tab. Navigate to this tab and map your Ventrata product, option(s), and units by selecting the corresponding products, options, and units from the dropdown lists as received from Xola. Ensure that no fields are left empty (unmapped), and click Save Changes.

    The product page will now display a Mappings tab. Navigate to this tab and map your Ventrata product, option(s), and units by selecting the corresponding products, options, and units from the dropdown lists as received from Expian. Ensure that no fields are left empty (unmapped), and click Save Changes.

Supported Capabilities (Detailed)

Availability

✅

When Backend Availability is enabled Ventrata will pull availability from Xola.

This works as follows:

  • Availability Check. When a user interacts with the availability calendar in Ventrata (e.g., selects units and clicks through the dates in the dashboard, web checkout, terminal, etc.), Ventrata will make a live request to Xola to retrieve availability for the given dates. This is usually done in 7-day ranges or for a specific day.

  • The calendar may display cached (non-live) data from the previous time it was requested before the user interacts with the calendar.

Pricing

✅

When Backend Pricing is enabled Ventrata will pull both retail and net (wholesale) pricing from Xola.

This works as follows:

  • Availability Check (Pricing Capability). When a user interacts with the availability calendar in Ventrata (e.g., selects units and clicks through the dates in the dashboard, web checkout, terminal, etc.), Ventrata will make a live request to Xola to retrieve availability along with the pricing for the given dates. This is usually done in 7-day ranges or for a specific day. Pricing will shown to the user and cached / stored in Ventrata as API generated fares.

  • Net (wholesale) pricing returned via the API from Xola will be recorded as cost pricing, regardless of your cost percentage settings on the operator, when using Backend Pricing.

Booking

✅

Bookings, booking changes and cancellation made in Ventrata for the Backend Connected product will be automatically sent to Xola.

This work as follows:

  • Booking Reservation. When a product is added to the cart in Ventrata, a request will be made to reserve the availability.

  • Booking Confirmation. After the payment step, a request to confirm the booking will be made, along with any customer contact information sent at this point. The voucher/ticket provided by Xola will be ingested as a voucher/ticket in Ventrata (except for PDF_FILE, which Ventrata currently does not support).

  • Booking Update. When a booking is changed, an API request to update the booking will be made to Xola.

  • Booking Cancellation. When a booking is cancelled, an API request to cancel the booking will be made to Xola.

Redemption

❌

Booking status from Xola (for example if booking is Redeemed) is not currently communicated back to Ventrata after booking is confirmed.

Pickups

❌

Pickups are not currently supported.

Promotions

❌

Promotions are not currently supported.

Extras

❌

Extras are not currently supported.

​

Troubleshooting

Issue

Possible Solutions

Error when updating operator to save backend configuration.

Likely OCTO API Key or OCTO Endpoint are incorrect. Double-check these details with your operator. If issue persists, contact us for support.

No Backend Connected checkbox in product settings.

Likely operator selected for the product doesn't have backend configured, check backend configuration and try again. If issue persists, contact us for support.

The product/option/unit I want to map is not on the dropdown.

Dropdown list is pulled from Xola based on products/options/units operator made available to you. Double-check these details with your operator. If issue persists, contact us for support.

Partner Information

Xola, Inc.
Hewes Building, 995 Market St,
San Francisco, CA 94103, USA

Partner ID 360a0ae4-5437-4c21-9dfa-68c0e8e22c8a

​

Related Articles
Anchor Operator Connection
Reservotron Operator Connection
Zaui Operator Connection
Expian Operator Connection
RocketRez Operator Connection
Did this answer your question?