Difference between revisions of "Atraveo"

From Beds24 Wiki
Jump to navigation Jump to search
 
(10 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
[[Category:Error Messages from Channels]]
 
[[Category:Error Messages from Channels]]
 
[[Category:Troubleshooting]]
 
[[Category:Troubleshooting]]
<div class="heading">Atraveo</div>
+
<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 works and how to set it up.
+
  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.
 +
 
 +
 
 +
<div class="warning">{{#fas:exclamation-triangle}} Only for existing connections. Use [[Hometogo_Mapping|Hometogo]] for new connections.</div>
  
 
__TOC__
 
__TOC__
Line 14: Line 17:
 
*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.
Line 22: Line 27:
 
*Export Minimum Stay and Maximum Stay can not be exported
 
*Export Minimum Stay and Maximum Stay can not be exported
 
*Export Multiple Rates are not supported
 
*Export Multiple Rates are not supported
*Add a multiplier
 
 
*Closed on Arrival / Closed on Departure can not be exported
 
*Closed on Arrival / Closed on Departure can not be exported
 
*Upsell Items can not be exported.
 
*Upsell Items can not be exported.
Line 30: Line 34:
 
*We can only send availability if you have set up prices which are activated for this channel. This tutorial gives general information how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 
*We can only send availability if you have set up prices which are activated for this channel. This tutorial gives general information how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 
*You need a price for the full occupancy.
 
*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.   
+
*Prices for "Extra Person",  "Extra child" and discounts set in the "Discounts" tab of the rFixed Prices 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 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.  
+
*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 Fixed Prices will be ignored.  
  
  
Line 56: Line 60:
 
*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 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 is displayed.
+
<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 68: Line 72:
 
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.
  
== Multiple properties in one Atraveo account ==
+
1st function: The complete availability
If you have multiple properties at Atraveo you need to change the URL's slightly.
+
2nd function: Live price vacancy  (price and availability on a specific date).
 
 
Replace the propid in the URL with your ownerid. Example:
 
 
 
<nowiki>https://beds24.com/api/atraveo.de/inventory.php?ownerid=266</nowiki>
 
  
<nowiki>https://beds24.com/api/atraveo.de/booking.php?ownerid=266</nowiki>
+
[[Image: Functions.jpg|550px|link=]]
 +
[[Media: Functions.jpg|view large]]
  
You can find your owner ID number in SETTINGS->ACCOUNT.
+
==Prices==
 +
Atraveo uses the prices sent by Beds24 for the live price vacancy query only.  
  
<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.  
+
Basic prices must be set manually in the Atraveo extranet.  
  
==Price Multiplier==
+
===Price Multiplier===
 
If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number in the "Price Multiplier" field.
 
If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number in the "Price Multiplier" field.
  
Line 112: Line 115:
 
For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
 
For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
  
 +
== Multiple properties in one Atraveo account ==
 +
If you have multiple properties at Beds24 you need to change the URL's slightly.
 +
 +
Replace the propid in the URL with your ownerid. Example:
 +
 +
<nowiki>https://beds24.com/api/atraveo.de/inventory.php?ownerid=266</nowiki>
 +
 +
<nowiki>https://beds24.com/api/atraveo.de/booking.php?ownerid=266</nowiki>
 +
 +
You can find your owner ID number in {{#fas:cog}} (SETTINGS) > ACCOUNT.
 +
 +
<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 ==

Latest revision as of 09:42, 9 January 2024

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.


Only for existing connections. Use Hometogo for new connections.

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 rFixed Prices 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 Fixed Prices 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 Beds24 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.