Difference between revisions of "Atraveo"
| (63 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
[[Category:Channel Manager]] | [[Category:Channel Manager]] | ||
[[Category:Error Messages from Channels]] | [[Category:Error Messages from Channels]] | ||
| − | [[Category: | + | [[Category:Troubleshooting]] |
| − | + | <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. | ||
| + | |||
| + | <div class="warning">{{#fas:exclamation-triangle}} Only for existing connections. Use [[Hometogo_Mapping|Hometogo]] for new connections.</div> | ||
| + | |||
| + | __TOC__ | ||
| + | ==General== | ||
| + | *[[:Category:Channel Manager|Click here]] for general information on how the channel manager works. | ||
| + | *This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]]. | ||
==Capabilities== | ==Capabilities== | ||
| Line 9: | 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. | ||
*Booking cancellations or modifications cannot be imported | *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. | ||
| + | |||
| + | == 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 [[Setting_Prices_for_Booking_Channels|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 [[Combine_individual_rooms_into_a_roomtype|set up virtual roooms]]. | ||
| + | |||
| + | ==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. | ||
| + | |||
| + | <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 – 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. | ||
| + | |||
| + | [[Image: roomidBeds24.jpg|550px|link=]] | ||
| + | [[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. | ||
| + | |||
| + | [[Image: Vakanzschnittstelle_en.jpg|550px|link=]] | ||
| + | [[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. | ||
| + | |||
| + | [[Image: bookingatraveo.jpg|550px|link=]] | ||
| + | [[Media: 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). | ||
| + | |||
| + | [[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%) | ||
| − | 1. | + | 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 == | |
| + | 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 == |
| + | '''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. | ||
==Disconnect== | ==Disconnect== | ||
*Unticking "Inventory" and "Prices" and "Bookings" will stop the synchronisation for a room. | *Unticking "Inventory" and "Prices" and "Bookings" will stop the synchronisation for a room. | ||
*Log into your Atraveo extranet and delete the Beds24 URL. | *Log into your Atraveo extranet and delete the Beds24 URL. | ||
Latest revision as of 09:42, 9 January 2024
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.
Contents
1 General
- Click here for general information on how the channel manager works.
- This tutorial explains how to set prices for channels.
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.
- 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 -> Booking Interface and enter the booking URL supplied by the Beds24 channel manager settings.
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).
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.
