How to connect  Bókun  to Winedering

What will be connected through the integration?

Here is the list of integrations available:

  1. Availabilities: any updates to availabilities, such as opening or closing dates and times, are reflected on Winedering.com in real-time. You can confidently manage your calendar exclusively through Bokun.

  2. Bookings: Bookings confirmed by customers on Winedering are automatically sent to your booking engine in real time. Any necessary actions to manage these bookings must be performed directly on your booking engine (cancellation, modification, etc.). If the booking needs changes in the number of guests or prices/total amount, you should ask the customer to cancel it and recreate it, or you can do it on their behalf.
     Attention! If there is a discrepancy in prices between Bokun and Winedering, the official total amount for a booking is always the one listed on Winedering. This amount is also noted in the booking details on Bokun. Keep in mind that this can affect how you calculate your revenues, the commission Winedering will charge, and the amount you need to include on the receipt or invoice issued to your customer.

Pricing and Contents
Unlike availability, the descriptions, name and the pricing list will not be synchronized with Bókun. Any price changes must be communicated manually to Winedering.

How to Connect Your Experience on Winedering with Bókun

Before proceeding
Ensure that the experience on Winedering that you want to connect is set to ONLINE.
Retrieve the Experience ID for the experience you want to connect, which is available in the Bókun panel.

Log in to your control panel. From the left menu, click on "Experiences".



In the experiences table, click the name of the experience you want to connect

Note: The experience must be set to ONLINE to connect it to Bókun .



From the left menu, click on the "Connect Booking Engine" button.


 

A modal popup will open, where you can select the BóKUN booking engine and enter the Experience ID of the experience you want to connect, available in the Bókun panel.



Click on the "Check experience" button.  If the Experience ID is valid, a message will show the name of the experience on Bókun



If the name is correct, click the "Save" button to confirm the association. Otherwise, enter a different Experience ID and retry the check.

After saving, if no errors occur, the popup will automatically close, and you will be redirected to the configuration wizard.

NOTE
Before the experience becomes available for online booking, you will need to:

  •  Choose the Price Catalog to use

  • Associate the Bókun pricing categories with the Winedering calendars.



WIZARD - STEP 1 - CHOOSE PRICE CATALOG

Bókun uses Price Catalogs as price lists. For a single experience, multiple Price Catalogs can be configured. Since Winedering does not manage price lists, the supplier will need to select the appropriate Price Catalog to associate with the prices on the bookings sent to Bókun.

WIZARD - STEP 2 - MATCHING PRICING CATEGORIES

On Bókun, it is possible to specify multiple Rates, each of which can have different types of people (Pricing Categories). These options must be associated with Price per Types available on Winedering in the corresponding calendars.



If on Bókun the Rates have been used to allow booking the experience by specifying a language, you will need to indicate the language associated with each Pricing Category during the completion of the Wizard.

Possible Errors

1. Every Price per Type must be active in at least one language. The language field cannot be left empty.



2. You can combine a language and a Price per Type in a single Pricing Category on Bókun



NOTE
In the Winedering booking form, ONLY the Pricing Categories from Bókun that have been associated will be visible.

Once the wizard has been completed correctly, the association will be automatically activated on the Winedering frontend site.

How to resolve potential errors during the setup 

If you encounter the following error during the association:
"The experience cannot be synchronized with Winedering because the customPickUpAllowed option is not set to "ok" on Bokun. Please adjust the setting on Bokun, or insert the ID of another experience."

Check the PICKUP PLACE configuration on Bokun.
If you have configured pickup places in Bokun and the rate of your experience requires the pickup place to be pre-set during the booking, it is necessary to allow the addition of a custom pickup place.

To do this, ensure that the flag “Allow the customer to enter a custom pick-up location”, located in the “Pick-up config” screen in the Bokun dashboard, is enabled.



If you encounter the following error during the association:
"The experience cannot be synchronized with Winedering because the customDropoffAllowed option is not set to "ok" on Bokun. Please adjust the setting on Bokun, or insert the ID of another experience."

Check the DROPOFF PLACE configuration on Bokun 
The same applies to the dropoff place. If you have configured dropoff places and the rate of your experience requires the dropoff place to be pre-set during the booking, it is necessary to allow the addition of a custom dropoff place.

To do this, ensure that the flag “Allow the customer to enter a custom drop-off location”, located in the “Drop-off service” screen in the Bokun dashboard, is enabled.


How to Verify the Connection with Bókun


Log into your control panel.

From the left menu, click on "Experiences".



In the list of experiences, those connected to Bókun will have a Bókun badge next to the name.


Click the name of the experience.



From the left menu, click on the "Manage Booking Engine" button.



The screen with the booking engine configuration and the association status will open.


Troubleshooting Connection Issues with Bókun

If the connection is temporarily suspended
Availability and bookings will no longer sync with Bókun and will instead be managed on Winedering.

HOW TO IDENTIFY CONNECTION ISSUES

Log in to your control panel.

From the left menu, click on "Experiences".


In the list of experiences, the Bókun name will appear in yellow instead of green if there is an issue.




Click on the experience name, and the "Manage Booking Engine" button will be red.




Clicking the button "Manage Booking Engine" will opens a displaying a warning message.


How to Disconnect Your Experience on Winedering from Bókun

Considerations before proceeding:
If the experience is ONLINE, the availability shown on the site will be based on what is set on Winedering.
Ensure that the configuration of the experience is correct before disconnecting it from Bókun.

Log in to your control panel and open the details of the experience you want to disconnect from Bókun.

From the left menu, click on the "Manage Booking Engine" button.

A new page will open showing the status of the connection. Click the "Reset the configuration process" button to remove the connection and proceed.


Managing Bookings Connected with Bókun

Whenever a user confirms a booking for an experience connected to Bókun, the booking will also be automatically created in Bókun.

Important!
The creation or update of bookings from/to Bókun is not in real time!
It may take a few minutes for Bókun and Winedering to synchronize and reflect the same information.

 Log in to your control panel. From the left menu, click on the "Bookings Received" button.

Click on the booking you want to view in detail.

 

If the booking has been correctly created or is pending creation in Bókun, it cannot be managed within Winedering. Any changes, such as confirming or rejecting the booking, must be made in Bókun.


If errors occur during the creation of the booking, they will be displayed in the booking details. Unless the issue is related to availability, you can manually retry by clicking the "Retry" button.