Difference between revisions of "Vacation-stay.com"

From Beds24 Wiki
Jump to navigation Jump to search
(Created page with "Category:Channel Manager Category:Error Messages from Channels Category:Set up Instructions ''Synchronising Beds24.com with Vacation-stay.com'' http://www.Vacatio...")
 
 
(39 intermediate revisions by 2 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]]
+
<div class="heading">Rakuten Travel and Vacation STAY</div>
''Synchronising Beds24.com with Vacation-stay.com''
+
This page is about the menues {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > RAKUTEN and    {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > and explains how the interface with these channels works and how it is set up.
http://www.Vacation-stay.com
 
 
 
COMING SOON!
 
 
 
<div style="display:none">  
 
  
 
==General==
 
==General==
Line 13: Line 8:
 
*This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 
*This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 
==Capabilities==
 
==Capabilities==
*Beds24.com can export Inventory
+
*Beds24 can export Inventory
*Beds24.com can export Price
+
*Beds24 can export Price
*Beds24.com can import Bookings
+
*Beds24 can import Bookings
Cancellations?
+
*Beds24 can import Cancellations
  
 
For details please [[Channel_Manager_Capabilities|click here]]
 
For details please [[Channel_Manager_Capabilities|click here]]
 +
 +
The connection between Beds24 and '''Rakuten Tavel'''  is made via '''Vacation STAY'''. 
 +
 +
Vacation STAY and Rakuten Travel are connected via an API integration. Properties listed on Vacation STAY can be listed on and connected to Rakuten travel.
 +
 +
If you create a listing on Vacation STAY your property will be automatically listed on Rakuten Travel.
 +
 +
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  The property creation on Rakuten Travel is semi-automated, so it might take up to a few weeks for the property to show up on Rakuten
 +
Travel.
 +
 
==Limitations==
 
==Limitations==
 
*"Extra Person" prices cannot be exported.
 
*"Extra Person" prices cannot be exported.
*Prices can only be exported for one year in advance.
+
*"Minimum Stay" rules cannot be exported.
 +
*"Maximum Stay" rules cannot be exported.
  
 
== Before you connect ==
 
== Before you connect ==
 
'''Prices'''
 
'''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]].
 
*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]].
*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 Fixed Prices can not be sent.
 +
*We can only send one price per day. If you have multiple prices activated for this channel the price with the lowest minimum stay will 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.
 +
*You can set an "Extra Person" price directly in your VacationSTAY extranet.
  
 
'''Bookings'''
 
'''Bookings'''
Line 33: Line 42:
  
 
Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.
 
Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.
 +
 +
Vacation STAY does not support modification. If a guest wants to modify a booking they will need to cancel and rebook.
 +
 +
If a guest books more than one room Vactation STAY will send a separate unconnected booking for each room.
  
 
'''Extras and Taxes'''
 
'''Extras and Taxes'''
  
 
"Upsell Items" can not be exported.
 
"Upsell Items" can not be exported.
 +
 +
==You need==
 +
*Your VacationSTAY propery ID. If you do not already have a account with Vacation STAY sign up on their web site using the “register” function on the extranet then enter your property information, uploads photos etc on Vacation STAYs extranet.
 +
*API username
 +
*API password
  
  
'''Rooms and room types'''
+
==Set up==
  
Bedandbreakfast.eu does not support room types. You need a room in Beds24 for each room you want to see on Bedandbreakfast.eu. If you sell your rooms  as a "roomtype" with a quantity of more than one on other channels you can [[Combine_individual_rooms_into_a_roomtype|set up virtual roooms]].
+
===Vacation STAY===
==You need==
+
*Please fill in this [https://docs.google.com/forms/d/1sTjh3096hLEH7pzbdmGZPqjHpAx5c17EB3CqpIvJyCA/viewform?edit_requested=true form] and ask Vacation STAY customer support to provide API credentials between Beds24 and Vacation STAY.
Your Bedandbreakfast.eu API key. See this [http://blog.bedandbreakfast.eu/innkeepers/2016/03/15/nieuw-koppeling-tussen-bedandbreakfast-eu-en-channel-managers/?utm_source=B%26B+Innkeepers+Europe&utm_campaign=d6d017da07-EU_EN_Prospects_news_mrt_2016&utm_medium=email&utm_term=0_97a3cb4ccf-d6d017da07-320917981 Bedandbreakfast.eu information] for details
+
*Vacation STAY will notify you by E-mail when the connection is enabled and send you a special API password.
 +
 
 +
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  The credentials used in the extranet and API are different. '''You can not use your normal Vacation STAY username and  password'''.  
  
If you can not find it please ask Bedandbreakfast.eu support.
 
  
==Beds24.com==
+
===Beds24===
*Enter your Api Key
+
*Enter your Vacation STAY property ID
 +
*Enter your Vacation STAY API username
 +
*Enter your Vacation STAY API password
 
*Click SAVE
 
*Click SAVE
*Click the "Get the Room and Rate Codes for this Api Key" link to retrieve your room and property codes.
+
<embedvideo service="youtube">https://youtu.be/-SbeMMSk8wc</embedvideo>
*Enter the codes for your property and each room
+
 
*Activate the connection with the check boxes
+
Map Rooms:
 +
*Click on the "Get Code" link next to the room type id setting.
 +
*Choose the room id you want to map to each Beds24 room and click on it.
 +
*When the correct room id has copied to the room type id setting, click Save.
 +
[[Image:agoda_room_mapping.png|500px|link=]]
 +
[[Media:agoda_room_mapping.png|view large]]
 +
 
 +
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Click on the "View Actual Data" Button to check which prices and availability will send.
 +
 
 +
== Price Multiplier ==
 +
If you want to add a multiplier to your prices, for example because of a different currency to your Beds24 currency, add a * followed by the multiplier number to your hotel id.
  
== Check Connection ==
+
For example a hotel id setting 123456*12.34 will multiply all prices by 12.34 sent for hotel id 123456.
The connection is working if you are not receiving error messages and the display in the channel is correct. If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.
+
 
 +
Examples:
 +
*'''123456*1.23''' will multiply all prices  for property 123456 by 1.23 (i.e. raised by 23%).
 +
*Lower prices can be sent with a multiplier less than 1: '''123456*0.85''' will send 85% of the normal price (i.e. lowered by 15%) for property 123456.
 +
*To convert the price of bookings imported from the channel add a '''*''' AFTER the multiplier. '''123456*1.23*''' will divide the price of the booking by 1.23 for property 123456.
 +
*For currency conversion you can also use currency conversion template variables. All currencies supported by the booking page currency selector can be used.
 +
**'''123456*[CONVERT:IDR-EUR]''' will convert Indonesian Rupees to Euros.
 +
**'''123456*[CONVERT:IDR-EUR][/]0.85''' will convert Indonesian Rupees to Euros and lower the price by 15%.
 +
 
 +
== Activate ==
 +
*Tick "Inventory" and Prices" and "Bookings"
 +
*Save
 +
 
 +
New Bookings are imported. Modifications and cancellations to bookings are also imported.
 +
 
 +
Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.
  
 
== Updates ==
 
== Updates ==
 
Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
 
Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
 +
 +
== Check Connection ==
 +
The connection is working if  you are not receiving error messages and the display in the channel is correct. If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.
  
 
== Common Errors ==
 
== Common Errors ==
  '''Availability for room must be 0 or 1'''
+
  '''iCalendar is set on our site. Please cancel icalendar setting to prevent inconsistency of inventory quantity.'''
  The quantity for this room must be set to 1 in the Bedandbreakfast.eu system. Check wich Bedsandbreakfast.eu if you can raise the number to the number of rooms you actually have.
+
  Log into your Vacation STAY account and remove the iCal connection.
  
  '''Can't set dates 0000-000-00 as available for room xxxx, conflicts with a booking for hotel id xxxx'''
+
  '''the room that has been approved and published has to be only one room'''
  Updates sent are rejected because of a conflicting booking which is already in the system. Most likely this is a due to a manual entry into Bedsanbreakfast.eu. To fix this remove the manual entry.
+
  The setup of the room in VacationStay is incomplete. Log into VacationStay, finish the setup and publish the room.  
  
 +
== Stop Sync ==
 +
Untick "Inventory and Prices" and "Bookings
  
Untick prices for occupanies or with minimum stays you not want to send
 
  
</div">
+
Use this document [https://docs.google.com/forms/d/1g9StyaEeFn1bMpy5l5XZXgZ5TxiPudIPgDJNMZFjVnQ/viewform?edit_requested=trueform] to request the disconnection at Vacation STAY.

Latest revision as of 09:55, 9 January 2024

Rakuten Travel and Vacation STAY
This page is about the menues  (SETTINGS) CHANNEL MANAGER > RAKUTEN and     (SETTINGS) CHANNEL MANAGER > and explains how the interface with these channels works and how it is set up. 

1 General

2 Capabilities

  • Beds24 can export Inventory
  • Beds24 can export Price
  • Beds24 can import Bookings
  • Beds24 can import Cancellations

For details please click here

The connection between Beds24 and Rakuten Tavel is made via Vacation STAY.

Vacation STAY and Rakuten Travel are connected via an API integration. Properties listed on Vacation STAY can be listed on and connected to Rakuten travel.

If you create a listing on Vacation STAY your property will be automatically listed on Rakuten Travel.

The property creation on Rakuten Travel is semi-automated, so it might take up to a few weeks for the property to show up on Rakuten Travel.

3 Limitations

  • "Extra Person" prices cannot be exported.
  • "Minimum Stay" rules cannot be exported.
  • "Maximum Stay" rules cannot 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.
  • Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the Fixed Prices can not be sent.
  • We can only send one price per day. If you have multiple prices activated for this channel the price with the lowest minimum stay will 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.
  • You can set an "Extra Person" price directly in your VacationSTAY extranet.

Bookings

New Bookings are imported.

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

Vacation STAY does not support modification. If a guest wants to modify a booking they will need to cancel and rebook.

If a guest books more than one room Vactation STAY will send a separate unconnected booking for each room.

Extras and Taxes

"Upsell Items" can not be exported.

5 You need

  • Your VacationSTAY propery ID. If you do not already have a account with Vacation STAY sign up on their web site using the “register” function on the extranet then enter your property information, uploads photos etc on Vacation STAYs extranet.
  • API username
  • API password


6 Set up

6.1 Vacation STAY

  • Please fill in this form and ask Vacation STAY customer support to provide API credentials between Beds24 and Vacation STAY.
  • Vacation STAY will notify you by E-mail when the connection is enabled and send you a special API password.

The credentials used in the extranet and API are different. You can not use your normal Vacation STAY username and password.


6.2 Beds24

  • Enter your Vacation STAY property ID
  • Enter your Vacation STAY API username
  • Enter your Vacation STAY API password
  • Click SAVE

Map Rooms:

  • Click on the "Get Code" link next to the room type id setting.
  • Choose the room id you want to map to each Beds24 room and click on it.
  • When the correct room id has copied to the room type id setting, click Save.

Agoda room mapping.png view large

Click on the "View Actual Data" Button to check which prices and availability will send.

7 Price Multiplier

If you want to add a multiplier to your prices, for example because of a different currency to your Beds24 currency, add a * followed by the multiplier number to your hotel id.

For example a hotel id setting 123456*12.34 will multiply all prices by 12.34 sent for hotel id 123456.

Examples:

  • 123456*1.23 will multiply all prices for property 123456 by 1.23 (i.e. raised by 23%).
  • Lower prices can be sent with a multiplier less than 1: 123456*0.85 will send 85% of the normal price (i.e. lowered by 15%) for property 123456.
  • To convert the price of bookings imported from the channel add a * AFTER the multiplier. 123456*1.23* will divide the price of the booking by 1.23 for property 123456.
  • For currency conversion you can also use currency conversion template variables. All currencies supported by the booking page currency selector can be used.
    • 123456*[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
    • 123456*[CONVERT:IDR-EUR][/]0.85 will convert Indonesian Rupees to Euros and lower the price by 15%.

8 Activate

  • Tick "Inventory" and Prices" and "Bookings"
  • Save

New Bookings are imported. Modifications and cancellations to bookings are also imported.

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

9 Updates

Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.

10 Check Connection

The connection is working if you are not receiving error messages and the display in the channel is correct. If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.

11 Common Errors

iCalendar is set on our site. Please cancel icalendar setting to prevent inconsistency of inventory quantity.
Log into your Vacation STAY account and remove the iCal connection.
the room that has been approved and published has to be only one room
The setup of the room in VacationStay is incomplete. Log into VacationStay, finish the setup and publish the room. 

12 Stop Sync

Untick "Inventory and Prices" and "Bookings


Use this document [1] to request the disconnection at Vacation STAY.