Difference between revisions of "HostelWorld.com"

From Bemar Wiki
Jump to: navigation, search
Line 53: Line 53:
*Hostelworld API password
*Hostelworld API password
'''1. Connection request'''
'''1. Connection request'''

Latest revision as of 13:57, 13 June 2018

Synchronising Bemar/Beds24.com with Hostelworld group (HostelWorld.com, HostelBookers.com, Hostels.com, Bedandbreakfastworld.com)'




  • Bemar/Beds24.com can export Inventory
  • Bemar/Beds24.com can export multiple prices
  • Bemar/Beds24.com can apply a price multiplier to prices
  • Bemar/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


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


  • 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.
  • Bemar/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.

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 dorm but Private rooms will only be sold if all the beds in the room are booked together.


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.

You need

  • Hostelworld group property ID
  • Hostelworld API password


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.

350px 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.

500px 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

500px view large

4) Activate:

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


Bemar/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

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

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.

Multiple Rates

Hostelworld support multiple rate codes.

Bemar/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.

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.

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

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.


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

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.

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.
<error roomtypeid="1234" code=""></error>
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.


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.


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


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.

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").

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.

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?

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

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.

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.

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.

What do I do when I have a no show?

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