Skip to main content

Bókun Operator Connection

How to connect your products in Ventrata to operator using the Bókun booking system to resell their products

Updated yesterday

Bókun, part of Tripadvisor, is a comprehensive booking, inventory, and channel management system built for tours, activities, and attractions.

This operator connection (also referred to as backend) allows you to connect with other operators who use Bókun as their ticketing 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 Bókun system.

  • Posting bookings, updates, and cancellations from Ventrata to Bókun.

  • Receiving vouchers/tickets from your operator's Bókun system and issuing them to your customers.
    ​

Configuring Operator Backend

Before You Begin:

  1. Contact your operator who uses Bókun and request the "OCTO API Key" for you to resell their products through Ventrata. The operator can issue an API key by going to Settings → Connectivity → API keys → Create an API key → Save → [x] enable OCTO on this API key, in their Bókun account.
    ​

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

  3. In the Backend Partner section, choose Bókun from the list of available connections and enter the OCTO API Key provided to you by your operator. Unless otherwise instructed by the operator, leave the OCTO Endpoint field with the default pre-filled value of https://api.bokun.io/octo/v1

    In the Backend Partner field, select Expian from the list of connections available and enter OCTO API Key you were provided by your Operator.

  4. 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 Bókun system:

  1. In the Ventrata Dashboard, navigate to Products → Products and select the product you would like to map to the operator's Bókun 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 Bókun, 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 Bókun. 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 Bókun. 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 Bókun.

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 Bókun 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 Bókun.

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 Bókun 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 Bókun 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 Bókun.

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 Bókun 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 Bókun.

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

Redemption

❌

Booking status from Bókun (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 the operator to save backend configuration.

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

No Backend Connected checkbox in product settings.

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

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

The dropdown list is pulled from Bókun based on products/options/units operator made available to you. Double-check these details with your operator. If the issue persists, contact us for support.

Partner Information

Tripadvisor LLC dba Bókun
400 1st Avenue

Needham, MA 02494, USA
​

Partner ID 18d71b21-57e4-4811-8818-a7be06311725

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