Difference between revisions of "Atraveo"

From Beds24 Wiki
Jump to navigation Jump to search
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:Channel Manager]]
 
[[Category:Channel Manager]]
 
[[Category:Error Messages from Channels]]
 
[[Category:Error Messages from Channels]]
[[Category:Set up Instructions]]
+
[[Category:Troubleshooting]]
  ''Synchronising Beds24.com with Atraveo ''
+
<div class="heading">Atraveo – E-Domizil - TuiVillas</div>
 +
  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > ATRAVEO and explains how the connection with Atraveo – E-Domizil - TuiVillas  works and how to set it up. You can also connect to E-Domizil and TuiVillas via Atraveo.
  
 
__TOC__
 
__TOC__
Line 13: Line 14:
 
*Beds24.com can export Rates
 
*Beds24.com can export Rates
 
*Beds24.com can import Bookings
 
*Beds24.com can import Bookings
 +
*Add a multiplier
  
 
For details please [[Channel_Manager_Capabilities|click here]]
 
For details please [[Channel_Manager_Capabilities|click here]]
 +
 
==Limitations==
 
==Limitations==
 
*All data transfers are initiated by Atraveo, we have no influence over how often they update their calendar.
 
*All data transfers are initiated by Atraveo, we have no influence over how often they update their calendar.
 
*Booking cancellations or modifications cannot be imported
 
*Booking cancellations or modifications cannot be imported
 
*Occupancy based prices are not supported
 
*Occupancy based prices are not supported
*Export Minimum Stay are not exported
+
*Export Minimum Stay and Maximum Stay can not be exported
*Export Maximum Stay are not exported
 
 
*Export Multiple Rates are not supported
 
*Export Multiple Rates are not supported
 +
*Closed on Arrival / Closed on Departure can not be exported
 +
*Upsell Items can not be exported.
  
 
== Before you connect ==
 
== Before you connect ==
Line 53: Line 57:
 
*SAVE
 
*SAVE
  
Atraveo requests a price from Beds24. Beds24 will search for a price for the requested number of guests and send this to Atraveo.
+
Atraveo – E-Domizil - TuiVillas  requests a price from Beds24. Beds24 will search for a price for the requested number of guests and send this to Atraveo.
 
 
 
 
<span class="circle" >{{#fas:lightbulb}} Tip</span> '''''Click on the "View Actual Data" Button to check which prices and availability will send.'''''
 
  
 +
<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Click on the "View Actual Data" Button to check which prices and availability will send. Prices that had already been set in Atraveo will be overridden but cannot be removed. If no prices have are sent from Beds24, no availability is sent, but the which originally was in Atraveo – E-Domizil - TuiVillas  is displayed.
  
'''2.  Log into Atraveo'''
+
'''2.  Log into Atraveo – E-Domizil - TuiVillas  '''
  
 
Atraveo calls rented units "properties".  "Properties" in Atraveo connect to "Rooms" in Beds24.
 
Atraveo calls rented units "properties".  "Properties" in Atraveo connect to "Rooms" in Beds24.
Line 67: Line 69:
 
If this field is empty we recommend setting it to the Beds24 room id number this property will connect to.
 
If this field is empty we recommend setting it to the Beds24 room id number this property will connect to.
  
[[Image:atraveo.png|550px|link=]]
+
[[Image: roomidBeds24.jpg|550px|link=]]
[[Media:atraveo.png|view large]]
+
[[Media: roomidBeds24.jpg |view large]]
  
  
 
*Go to the menu Interfaces -> Availability Interface (or "Vacancy interface") and enter the inventory URL supplied by the Beds24 channel manager settings.
 
*Go to the menu Interfaces -> Availability Interface (or "Vacancy interface") and enter the inventory URL supplied by the Beds24 channel manager settings.
  
[[Image:atraveo_2.png|550px|link=]]
+
[[Image: Vakanzschnittstelle_en.jpg|550px|link=]]
[[Media:atraveo_2.png|view large]]
+
[[Media: Vakanzschnittstelle_en.jpg |view large]]
  
  
 
*Go to the menu Interfaces -> Booking Interface and enter the booking URL supplied by the Beds24 channel manager settings.
 
*Go to the menu Interfaces -> Booking Interface and enter the booking URL supplied by the Beds24 channel manager settings.
  
[[Image:atraveo_3.png|550px|link=]]
+
[[Image: bookingatraveo.jpg|550px|link=]]
[[Media:atraveo_3.png|view large]]
+
[[Media: bookingatraveo.jpg|view large]]
  
 
You can view the live availability and prices that will be sent using the "View actual data" button.
 
You can view the live availability and prices that will be sent using the "View actual data" button.
 +
Make sure that both functions are activated in Atraveo Dashboard. If this is not the case, please contact Atraveo Support.
 +
 +
1st function: The complete availability
 +
2nd function: Live price vacancy  (price and availability on a specific date).
 +
 +
[[Image: Functions.jpg|550px|link=]]
 +
[[Media: Functions.jpg|view large]]
 +
 +
==Prices==
 +
Atraveo uses the prices sent by Beds24 for the live price vacancy query only.
 +
 +
Basic prices must be set manually in the Atraveo extranet.
 +
 +
===Price Multiplier===
 +
If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number in the "Price Multiplier" field.
 +
 +
The multiplier applies to all prices and fees which are sent.
 +
 +
For example  '''*1.23''' will multiply all prices by 1.23 (i.e. raised by 23%).
 +
Lower prices can be sent with a multiplier less than 1, i.e. '''*0.85''' will send a price 85% of the normal price (i.e. lowered by 15%)
 +
 +
To convert the price of bookings imported add a * after the multiplier, for example '''*1.23*''' will divide the price of the booking by 1.23.
 +
 +
You can also use currency conversion template variable. All currencies supported by the booking page currency selector can be used.
 +
 +
For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
  
 
== Multiple properties in one Atraveo account ==
 
== Multiple properties in one Atraveo account ==
Line 89: Line 117:
 
Replace the propid in the URL with your ownerid. Example:
 
Replace the propid in the URL with your ownerid. Example:
  
<nowiki>https://www.beds24.com/api/atraveo.de/inventory.php?ownerid=266</nowiki>
+
<nowiki>https://beds24.com/api/atraveo.de/inventory.php?ownerid=266</nowiki>
  
<nowiki>https://www.beds24.com/api/atraveo.de/booking.php?ownerid=266</nowiki>
+
<nowiki>https://beds24.com/api/atraveo.de/booking.php?ownerid=266</nowiki>
  
 
You can find your owner ID number in SETTINGS->ACCOUNT.
 
You can find your owner ID number in SETTINGS->ACCOUNT.
  
  Note: Atraveo checks the link only for the first property. If the first property in your Atraveo account is not set up and connected to Beds24 you will see an error message that the link is not compatible.  
+
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> Atraveo checks the link only for the first property. If the first property in your Atraveo account is not set up and connected to Beds24 you will see an error message that the link is not compatible.  
 
 
 
 
  
 
== Common errors ==
 
== Common errors ==

Revision as of 08:53, 8 September 2022

Atraveo – E-Domizil - TuiVillas
This page is about the menu  (SETTINGS) CHANNEL MANAGER > ATRAVEO and explains how the connection with Atraveo – E-Domizil - TuiVillas  works and how to set it up. You can also connect to E-Domizil and TuiVillas via Atraveo.

1 General

2 Capabilities

  • Beds24.com can export Inventory
  • Beds24.com can export Rates
  • Beds24.com can import Bookings
  • Add a multiplier

For details please click here

3 Limitations

  • All data transfers are initiated by Atraveo, we have no influence over how often they update their calendar.
  • Booking cancellations or modifications cannot be imported
  • Occupancy based prices are not supported
  • Export Minimum Stay and Maximum Stay can not be exported
  • Export Multiple Rates are not supported
  • Closed on Arrival / Closed on Departure can not be exported
  • Upsell Items can not be exported.

4 Before you connect

Prices

  • We can only send availability if you have set up prices which are activated for this channel. This tutorial gives general information how to set prices for channels.
  • You need a price for the full occupancy.
  • Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent.
  • If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value so the price for the full occupancy can send.
  • If you have multiple prices the system searches for the best (lowest) price for the requested period and length of stay. "Check-in" and "Check-out" limitations in rates will be ignored.


Bookings

New Bookings are imported.

Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.

Extras and Taxes

"Upsell Items" can not be exported.

Rooms and room types

If you sell rooms individually at another channel or your own web site and want to sell them here as a "roomtype" with a quantity of more than one you can set up virtual roooms.

5 Set up

1. Beds24

  • Tick "Inventory and Prices" and "Bookings"
  • In "Room Code" enter your Atraveo "Internal property number". Normally this is your Beds24 room id number.
  • SAVE

Atraveo – E-Domizil - TuiVillas requests a price from Beds24. Beds24 will search for a price for the requested number of guests and send this to Atraveo.

Click on the "View Actual Data" Button to check which prices and availability will send. Prices that had already been set in Atraveo will be overridden but cannot be removed. If no prices have are sent from Beds24, no availability is sent, but the which originally was in Atraveo – E-Domizil - TuiVillas is displayed.

2. Log into Atraveo – E-Domizil - TuiVillas

Atraveo calls rented units "properties". "Properties" in Atraveo connect to "Rooms" in Beds24.

You need your "Your own property ID of the holiday accommodation" for each property you want to connect. You can find it when you go to "My Properties" and then click on the property in the "Description" tab.

If this field is empty we recommend setting it to the Beds24 room id number this property will connect to.

RoomidBeds24.jpg view large


  • Go to the menu Interfaces -> Availability Interface (or "Vacancy interface") and enter the inventory URL supplied by the Beds24 channel manager settings.

Vakanzschnittstelle en.jpg view large


  • Go to the menu Interfaces -> Booking Interface and enter the booking URL supplied by the Beds24 channel manager settings.

Bookingatraveo.jpg view large

You can view the live availability and prices that will be sent using the "View actual data" button. Make sure that both functions are activated in Atraveo Dashboard. If this is not the case, please contact Atraveo Support.

1st function: The complete availability 2nd function: Live price vacancy (price and availability on a specific date).

Functions.jpg view large

6 Prices

Atraveo uses the prices sent by Beds24 for the live price vacancy query only.

Basic prices must be set manually in the Atraveo extranet.

6.1 Price Multiplier

If you want to add a multiplier to your prices add a * followed by the multiplier number in the "Price Multiplier" field.

The multiplier applies to all prices and fees which are sent.

For example *1.23 will multiply all prices by 1.23 (i.e. raised by 23%). Lower prices can be sent with a multiplier less than 1, i.e. *0.85 will send a price 85% of the normal price (i.e. lowered by 15%)

To convert the price of bookings imported add a * after the multiplier, for example *1.23* will divide the price of the booking by 1.23.

You can also use currency conversion template variable. All currencies supported by the booking page currency selector can be used.

For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.

7 Multiple properties in one Atraveo account

If you have multiple properties at Atraveo you need to change the URL's slightly.

Replace the propid in the URL with your ownerid. Example:

https://beds24.com/api/atraveo.de/inventory.php?ownerid=266

https://beds24.com/api/atraveo.de/booking.php?ownerid=266

You can find your owner ID number in SETTINGS->ACCOUNT.

Atraveo checks the link only for the first property. If the first property in your Atraveo account is not set up and connected to Beds24 you will see an error message that the link is not compatible.

8 Common errors

The entered availability interface does not appear to be compatible with our specifications. Please check the interface's responses with the requirements referred to below, so that we can make working together even easier.
Check if the "Room Code" you have entered in Beds24 is exactly the same as the one in the "Your own property Id...." in Atraveo.

9 Disconnect

  • Unticking "Inventory" and "Prices" and "Bookings" will stop the synchronisation for a room.
  • Log into your Atraveo extranet and delete the Beds24 URL.