Difference between revisions of "Vacation-stay.com"

From Beds24 Wiki
Jump to navigation Jump to search
 
(20 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 by Rakuten''
+
  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.  
  
 
==General==
 
==General==
Line 8: 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
*Beds24.com can import 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.
 +
*"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.
 
*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.  
 
*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.  
Line 31: Line 43:
 
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.
  
VacationStay does not support modification. If a guest wants to modify a booking they will need to cancel and rebook.  
+
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 VactationStay will send a separate unconnected booking for each room.  
+
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'''
Line 40: Line 52:
  
 
==You need==
 
==You need==
*Your VacationSTAY propery ID. If you do not already have a account with VacationSTAY sign up on their web site using the “register” function on the extranet then enter your property information, uploads photos etc on VacationSTAYs extranet.  
+
*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 username
 
*API password
 
*API password
Line 47: Line 59:
 
==Set up==
 
==Set up==
  
===VacationSTAY===
+
===Vacation STAY===
*Please fill in this  [https://docs.google.com/forms/d/1sTjh3096hLEH7pzbdmGZPqjHpAx5c17EB3CqpIvJyCA/viewform?edit_requested=true form] and ask VacationSTAY customer support to provide API credentials between Beds24 and VacationSTAY.  
+
*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.  
*VacationSTAY will notify you by E-mail when the connection is enabled and send you a special API password.  
+
*Vacation STAY will notify you by E-mail when the connection is enabled and send you a special API password.  
  
  NOTE: The credentials used in the extranet and API are different. '''You can not use your normal VacationSTAY username and  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'''.  
  
  
===Beds24.com===
+
===Beds24===
*Enter your VacationSTAY property ID
+
*Enter your Vacation STAY property ID
*Enter your VacationSTAY API username
+
*Enter your Vacation STAY API username
*Enter your VacationSTAY API password
+
*Enter your Vacation STAY API password
 
*Click SAVE
 
*Click SAVE
 
<embedvideo service="youtube">https://youtu.be/-SbeMMSk8wc</embedvideo>
 
<embedvideo service="youtube">https://youtu.be/-SbeMMSk8wc</embedvideo>
Line 68: Line 80:
 
[[Media:agoda_room_mapping.png|view large]]
 
[[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.
 +
 +
For example a hotel id setting 123456*12.34 will multiply all prices by 12.34 sent for hotel id 123456.
  
  <span class="circle" >Tip</span> ''Click on the "View Actual Data" Button to check which prices and availability will send.''  
+
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 ==
 
== Activate ==
Line 81: Line 105:
 
== 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 ==
 
== 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.
 
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.
 
== 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.
 
  
 
== Common Errors ==
 
== Common Errors ==
 
  '''iCalendar is set on our site. Please cancel icalendar setting to prevent inconsistency of inventory quantity.'''
 
  '''iCalendar is set on our site. Please cancel icalendar setting to prevent inconsistency of inventory quantity.'''
  Log into your VacationStay account and remove the iCal connection.
+
  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.  
  
 
== Stop Sync ==
 
== Stop Sync ==
Line 97: Line 120:
  
  
Use this   [https://docs.google.com/forms/d/1g9StyaEeFn1bMpy5l5XZXgZ5TxiPudIPgDJNMZFjVnQ/viewform?edit_requested=trueform] to request the disconnection at VacationStay
+
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 10: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.