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.
- Click here for general information on how the channel manager works.
- This tutorial explains how to set prices for channels.
- com can export Inventory
- com can export multiple prices
- com can apply a price multiplier to prices
- MASTERINSOFT can send minimum stays
- 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
- “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
- 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.
- MASTERINSOFT can map a different MASTERINSOFT 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.
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.
New Bookings are imported.
Existing bookings are not automatically imported when the connection is established and should be entered into MASTERINSOFT 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
- Connection request
Contact your Hostelworld account manager and ask to set up a connection with MASTERINSOFT channel manager and an API password.
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.
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 MASTERINSOFT room and click on it.
- When the correct room id has copied to the room type id setting, click Save.
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
- Tick “Inventory”, “Prices” and “Bookings”
For dorms MASTERINSOFT checks the prices in this order:
- single price:
- double price: if no single price is found the system will look for a double price and send this to Hostelworld group
- 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 MASTERINSOFT checks the prices in this order:
- room price
- 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.
- 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.
MASTERINSOFT can map a different MASTERINSOFT 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 MASTERINSOFT 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 MASTERINSOFT.
If this is not possible Use the setting “Number of Beds” for this room (SETTINGS-> CHANNEL MANAGER->HOSTELWORLD)
Rooms marked as
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.
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 MASTERINSOFT. Please correct your mapping.
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.
- 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.
- 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.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 MASTERINSOFT 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 MASTERINSOFT 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 MASTERINSOFT 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 MASTERINSOFT.
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 MASTERINSOFT 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.