Difference between revisions of "HostelWorld.com"

From Beds24 Wiki
Jump to navigation Jump to search
(35 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
[[Category:Error Messages from Channels]]
 
[[Category:Error Messages from Channels]]
 
[[Category:Set up Instructions]]
 
[[Category:Set up Instructions]]
  ''Synchronising Beds24.com with Hostelworld group (HostelWorld.com, HostelBookers.com, Hostels.com, Bedandbreakfastworld.com)'
+
[[Category:Troubleshooting]]
http://www.hostelworld.com
+
<div class="heading">Hostelworld</div>
 +
  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOSTELWORLD and explains how the connection with Hostelworld group (HostelWorld.com, HostelBookers.com, Hostels.com, Bedandbreakfastworld.com) works and how to set it up.
 
==General==
 
==General==
 
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
 
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
Line 12: Line 13:
 
*Beds24.com can export multiple prices
 
*Beds24.com can export multiple prices
 
*Beds24.com can apply a price multiplier to prices
 
*Beds24.com can apply a price multiplier to prices
 +
*Beds24 can send minimum stays
 
*Beds24.com can import Bookings
 
*Beds24.com can import Bookings
  
Line 19: Line 21:
  
 
==Limitations==
 
==Limitations==
*Hostelworld accept minimum stays only on a per property level. All availability will be sent with a one night minimum.
 
 
*"Extra Person" prices cannot be exported.
 
*"Extra Person" prices cannot be exported.
 
*Hostelworld will reserve inventory for a booking as soon as the guest starts the booking process. We can not close the room once a booking is in progress even if the availability changed during this period.
 
*Hostelworld will reserve inventory for a booking as soon as the guest starts the booking process. We can not close the room once a booking is in progress even if the availability changed during this period.
 +
 +
== 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]].
 +
*Beds24 can map a different Beds24 rate or offer to each Hostelworld rate code. Currently Hostelworld only supports refundable and non-refundable rates.
 +
*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.
 +
 +
'''Private Rooms'''
 +
 +
To sell a complete room at Hostelworld set it to a "Private" room type in their system. We will still send the bed price as per a bed but Private rooms will only be sold if all the beds in the room are booked together.
 +
 +
'''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]].
  
 
==You need==
 
==You need==
Line 66: Line 93:
  
 
==Prices==
 
==Prices==
Beds24 checks the prices in this order:
+
For dorms Beds24 checks the prices in this order:
  
1. room price: it a room price is set the system will divide the room price by the number of beds and send this to Hostelworld group
+
1. single price:  
  
2. double price: if no room price is found the system will look for a double price, divide it by 2 and send this to Hostelworld group
+
2. double price: if no single price is found the system will look for a double price and send this to Hostelworld group
  
3. single price: if no room price and no double price are found the system will send the single price as bed price to Hostelworld group. For dorm beds just set a single price.  
+
3. room price: if no single or double price are found the system will look for a room price and send this to Hostelworld group. This includes the export price.  
  
Beds24 can map a different Beds24 rate or offer to each Hostelworld. Currently Hostelworld only supports refundable and non-refundable rates. [[Setting_Prices_for_Booking_Channels#Mapping_channel_rate_codes|Please use these instructions]].
+
 
 +
For private rooms Beds24 checks the prices in this order:
 +
 
 +
1. room price
 +
 
 +
2. double price: if no room price is found the system will look for a double price, divide it by 2 and send this to Hostelworld group as the price per bed for the private room.
 +
 
 +
3. single price: if no room price and no double price are found the system will send the single price as bed price to Hostelworld group.
 +
 
 +
The price paid by the guest is the bed price multiplied by the number of beds in the private room.
 +
 
 +
 
 +
<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.
 +
 
 +
===Multiple Rates===
 +
Hostelworld support multiple rate codes.
 +
 
 +
Beds24 can map a different Beds24 rate or offer to each Hostelworld rate code. Currently Hostelworld only supports refundable and non-refundable rates. [[Setting_Prices_for_Booking_Channels#Mapping_channel_rate_codes|Please use these instructions]].
  
 
If you do not have the appropriate rate ids you need to request Hostelwrold to add them.
 
If you do not have the appropriate rate ids you need to request Hostelwrold to add them.
  
==Price Multiplier==
+
===Price Multiplier===
 
If you want to add a multiplier to your prices, for example because Hostelworld requires a different currency to your Beds24 currency, add a '''*''' followed by the multiplier number to your hotel id.
 
If you want to add a multiplier to your prices, for example because Hostelworld requires a different currency to your Beds24 currency, add a '''*''' followed by the multiplier number to your hotel id.
  
Line 86: Line 130:
 
You can also use currency conversion template variable. All currencies supported by the booking page currency selector can be used.
 
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.
+
Example: *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
 +
 
 +
Example: *[CONVERT:IDR-EUR][/]0.85 will convert Indonesian Rupees to Euros and divides the price by 0.85 which raises it by circa 15%
 +
 
 +
== 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.
 +
 
 +
== Updates and Changes==
 +
Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays, the multiplier 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==
Line 110: Line 162:
 
  If username and Hostelworld API password are correctly entered please check with your Hostelworld account manager whether the connection is activated.
 
  If username and Hostelworld API password are correctly entered please check with your Hostelworld account manager whether the connection is activated.
  
 +
  '''Non existing room type'''
 +
You have mapped a code for a room which does not exist in Hostelworld. Go to SETTINGS->CHANNEL MANAGER->HOSTELWORLD and check your mapping. You can only map codes which show up when you click on "Get Codes".
 
   
 
   
 +
 
  '''Date ranges overlap'''
 
  '''Date ranges overlap'''
 
  You have two rooms mapped to the same  Hostelworld room code. Each Hostelworld room code can only be mapped to one room in Beds24. Please correct your mapping.
 
  You have two rooms mapped to the same  Hostelworld room code. Each Hostelworld room code can only be mapped to one room in Beds24. Please correct your mapping.
  
  '''<error roomtypeid="1234" code=""></error>'''
+
  '''roomtypeid="1234" code='''
 
  If the room has been deleted in Hostelworld untick "Prices", "Inventory" and "Bookings". If the room has not been deleted in Hostelworld please check if it is properly set up there.
 
  If the room has been deleted in Hostelworld untick "Prices", "Inventory" and "Bookings". If the room has not been deleted in Hostelworld please check if it is properly set up there.
 +
 +
'''Incorrect Price, Invalid rate plan(s)'''
 +
You have added a number which is not a valid Hostelworld rate id into the field in the "Channels" tab of a rate/daily price.
 +
*Open your rates (Channel Tab) and make sure the correct rate id is selected from the 'get codes' list.
 +
*Open your daily prices (Enable list) and make sure the correct rate id is selected from the 'get codes' list.
  
 
==Notes==
 
==Notes==
 
+
*The password is a special API password not your regular Hostelword password. Changing the password will break the connection.
The password is a special API password not your regular Hostelword password. Changing the password will break the connection.
+
*To sell a complete room at Hostelworld set it to a "Private" room type in their system.
 
 
 
 
To sell a complete room at Hostelworld set it to a "Private" room type in their system.
 
 
We will still send the bed price as per a dorm but Private rooms will only be sold if all the beds in the room are booked together.
 
We will still send the bed price as per a dorm but Private rooms will only be sold if all the beds in the room are booked together.
 +
*Hostelworld can send credit card details but they will not send a CCV.
  
 
==Disconnect==
 
==Disconnect==
Line 141: Line 199:
 
=== How do I add a promotion or special price?===  
 
=== How do I add a promotion or special price?===  
 
Special offers do not send from the channel manager.  All special offers must be managed manually in the channels extranet.   
 
Special offers do not send from the channel manager.  All special offers must be managed manually in the channels extranet.   
 
=== Can I send different prices for different minimum stays or different numbers of guests?===
 
No. We can send one price.
 
  
 
=== I have multiple properties. How do I set this up? ===
 
=== I have multiple properties. How do I set this up? ===

Revision as of 10:03, 18 May 2020

Hostelworld
This page is about the menu  (SETTINGS) CHANNEL MANAGER > HOSTELWORLD and explains how the connection with  Hostelworld group (HostelWorld.com, HostelBookers.com, Hostels.com, Bedandbreakfastworld.com) works and how to set it up.

1 General

2 Capabilities

  • Beds24.com can export Inventory
  • Beds24.com can export multiple prices
  • Beds24.com can apply a price multiplier to prices
  • Beds24 can send minimum stays
  • Beds24.com can import Bookings

Hostelworld group use per bed pricing and inventory. A double would be two beds in the Hostelworld group system and a triple three beds.

For details please click here

3 Limitations

  • "Extra Person" prices cannot be exported.
  • Hostelworld will reserve inventory for a booking as soon as the guest starts the booking process. We can not close the room once a booking is in progress even if the availability changed during this period.

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.
  • Beds24 can map a different Beds24 rate or offer to each Hostelworld rate code. Currently Hostelworld only supports refundable and non-refundable rates.
  • 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.

Private Rooms

To sell a complete room at Hostelworld set it to a "Private" room type in their system. We will still send the bed price as per a bed but Private rooms will only be sold if all the beds in the room are booked together.

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 You need

  • Hostelworld group property ID
  • Hostelworld API password

6 Beds24.com

1. Connection request

Contact your Hostelworld account manager and ask to set up a connection with Beds24 channel manager and an API password.

2. Setup

Hostelworld will notify you when the connection is enabled and send you a special API password. NOTE: You can not use your normal Hostelworld password.

1) Enter your Hostelworld Id, your Hostelworld API password and if necessary adjust the currency to the currency you are using on Hostelword then SAVE.

Hostelworld 1.png view large

2) Map Rooms:

  • Click on the "Get Code" link next to the room type id setting.
  • Choose theHostelworld 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

3) Map Rates:

  • Click on the "Get Code" link next to the rate plan id setting.
  • Choose the Hostelwrold standard rate for this room and click on it
  • When the correct rate plan id has copied to the rate plan id setting.
  • Click SAVE

Agoda standard rate mapping.png view large


4) Activate:

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

7 Prices

For dorms Beds24 checks the prices in this order:

1. single price:

2. double price: if no single price is found the system will look for a double price and send this to Hostelworld group

3. room price: if no single or double price are found the system will look for a room price and send this to Hostelworld group. This includes the export price.


For private rooms Beds24 checks the prices in this order:

1. room price

2. double price: if no room price is found the system will look for a double price, divide it by 2 and send this to Hostelworld group as the price per bed for the private room.

3. single price: if no room price and no double price are found the system will send the single price as bed price to Hostelworld group.

The price paid by the guest is the bed price multiplied by the number of beds in the private room.


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

7.1 Multiple Rates

Hostelworld support multiple rate codes.

Beds24 can map a different Beds24 rate or offer to each Hostelworld rate code. Currently Hostelworld only supports refundable and non-refundable rates. Please use these instructions.

If you do not have the appropriate rate ids you need to request Hostelwrold to add them.

7.2 Price Multiplier

If you want to add a multiplier to your prices, for example because Hostelworld requires 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*1.23 will multiply all prices by 1.23 sent for hotel id 123456. (i.e. raised by 23%) Lower prices can be sent with a multiplier less than 1, i.e. 123456*0.85 will send a price 85% of the normal price (i.e. lowered by 15%)

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

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

Example: *[CONVERT:IDR-EUR][/]0.85 will convert Indonesian Rupees to Euros and divides the price by 0.85 which raises it by circa 15%

8 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.

9 Updates and Changes

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

10 Common Errors

Any errors occurring during updates will be emailed to you with the error message . Below are common error messages and how to fix them.

Incorrect beds for Private room type
The number of beds available for a private room must be the same as the number of beds in the room. Hostelworld will not accept partial availability. 
Make sure the number of beds set up in Hostelworld is the same as in Beds24. 
If this is not possible Use the setting "Number of Beds" for this room (SETTINGS-> CHANNEL MANAGER->HOSTELWORLD)
Rooms marked as <inactive>1</inactive> are inactive. 
Inactive rooms can not be synronised. 
This is the advice Hostelword gives for these cases:
There is no need to do anything with that room unless they want to add and use that room again.
If that is the case they will need to add this room again with the same settings to reactivate it, otherwise they can leave it inactive. There is no availability for this room type so they will not get any bookings for that room.
Property's currency doesn't match with the currency which allocation is being uploaded with
Please check the currency selected is the currency you are using on Hostelworld and adjust the setting. If it is not you might want to double check the currency you set in SETTINGS->PROPERTIES->DESCRIPTION is correct.
Signature Invalid
Check if the username is correct and and the password entered is your Hostelworld API password provided by your Hostelworld account manager.
If username and Hostelworld API password are correctly entered please check with your Hostelworld account manager whether the connection is activated.
 Non existing room type
You have mapped a code for a room which does not exist in Hostelworld. Go to SETTINGS->CHANNEL MANAGER->HOSTELWORLD and check your mapping. You can only map codes which show up when you click on "Get Codes".

Date ranges overlap
You have two rooms mapped to the same  Hostelworld room code. Each Hostelworld room code can only be mapped to one room in Beds24. Please correct your mapping.
roomtypeid="1234" code=
If the room has been deleted in Hostelworld untick "Prices", "Inventory" and "Bookings". If the room has not been deleted in Hostelworld please check if it is properly set up there.
Incorrect Price, Invalid rate plan(s)
You have added a number which is not a valid Hostelworld rate id into the field in the "Channels" tab of a rate/daily price. 
*Open your rates (Channel Tab) and make sure the correct rate id is selected from the 'get codes' list.
*Open your daily prices (Enable list) and make sure the correct rate id is selected from the 'get codes' list.

11 Notes

  • The password is a special API password not your regular Hostelword password. Changing the password will break the connection.
  • To sell a complete room at Hostelworld set it to a "Private" room type in their system.

We will still send the bed price as per a dorm but Private rooms will only be sold if all the beds in the room are booked together.

  • Hostelworld can send credit card details but they will not send a CCV.

12 Disconnect

  • Unticking "Inventory and "Prices" and "Bookings" will stop the synchronisation for a room.
  • To completely disconnect the channel manager you might need to contact Hostelworld and ask them to disconnect you.


13 FAQ

13.1 Will I receive notifications on new bookings?

After you activate the channel manager the channel will stop sending notifications. You will receive them from Beds24 instead.

13.2 How do I modify or cancel a booking?

Bookings coming from a channel should be modified by the channel. Cancelling a booking in Beds24 will not cancel the booking in the channel and can cause a double booking.

If for some reason you need to make a change in Beds24 and do not want the channel to override it, you can set "Allow Channel Modifications" = No ("Details" tab of the booking").

13.3 How do I add a promotion or special price?

Special offers do not send from the channel manager. All special offers must be managed manually in the channels extranet.

13.4 I have multiple properties. How do I set this up?

The system can handle multiple properties in one account. Each Hostelworld property requires one property in Beds24.

13.5 What to do when I receive an overbooking?

  • Check if you are receiving error messages by email or in the potential issues menu. Error messages need to be addressed immediately because they can mean the channel manger is able to make updates.
  • Entering the same room code in multiple rooms in Beds24 can cause overbookings. Check your set up for warnings.

If you can not see a problem in your set up send us a support ticket with the booking numbers and dates.

13.6 Why did a booking not import?

  • Check if the room for which you received the booking is properly mapped.

If you can not see a problem in your set up send us a support ticket with the booking number and the date the booking was made.

13.7 Why is the price for the booking wrong?

  • A special offer set up in the channel may have reduced the price the channel manager sent.
  • Your prices are not set up as you expect.

13.8 What do I do when I have a no show?

Contact Hostelworld if you need to report a no-show.