Hotelbeds
This page is about the menu (SETTINGS) CHANNEL MANAGER > HOTELBEDS and explains how the connection with Hotelbeds works and how to set it up.
This connection to Hotelbeds will also update GTA and Tourico Travel.
1 General
- Click here for general information on how the channel manager works.
- This tutorial explains how to set prices for channels.
2 Capabilities
- com can export inventory
- com can export rates. We send ONE ROOM price. If you have multiple rates by default the lowest price will be sent.
- com can export minimum stay
- com can import bookings
- com can import changes to bookings
For details please click here
3 Limitations
- Rates – Only the ROOM price is sent.
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 rates can not be sent.
Bookings
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.
Credit Cards
If you want to access credit card details through MASTERINSOFT ask Hotelbeds to only accept bookings with credit card details and always send all details to MASTERINSOFT.
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
- Hotelbeds username
- Hotelbeds password
6 Hotelbeds
Contact Hotelbeds support with your Hotelbeds username which you are using to access the Hotelbeds extranet and ask them to connect with MASTERINSOFT. Include following information in the email:
- The URL where the reservations will be sent is: https://api.MASTERINSOFT.com/hotelbeds.com/booking
- The email address where the reservations will be sent in case MASTERINSOFT cannot process them.
Hotelbeds will notify you when the BMS connection is ready.
7 Set Up
Once you have this confirmation from Hotelbeds enter:
- Enter your Hotelbeds username into the field “Username”
- Enter your Hotelbeds password in the field “Password”.
8 MASTERINSOFT.com
Click on the “Get Contract List” link to access your contract list.
Enter account data:
- Enter your Hotelbeds Hotel Code into the field “Hotel Code”
- Enter your Hotelbeds Contract Name in the field “Contract Name”.
- Enter your Hotelbeds Sequence into the field “Sequence”
- Enter your Hotelbeds Office Code into the field “Incoming Office Code”
Press SAVE.
9 Map rooms
Click on the “Get Contract Detail” link to access your contract details.
For each room you want to connect:
- Enter your Hotelbeds Room Code into the field “Room Code”
- Enter your Hotelbeds Room Characteristic into the field “Room Characteristic”
Click on the “View Actual Data” Button to check which prices and availability will send.
10 Multiple contracts
Specify the first contract in the channel manager settings. Make sure “Hotelbeds” is ticked in the “Channels” tab of all rates you want to send to this contract. Multiple contracts require rates to be defined for each contract.
Open the rates or daily prices you want to send to the second contract.
- In rates go to the “Channels” tab. Tick “Hotelbeds” and enter the contract name and sequence for this contract separated by the / symbol.
- Tick “Hotelbeds” and enter the contract name and sequence for this contract separated by the / symbol under “Enable” in the Daily Price settings.
Example: NRF-BAR/45678
If the office code for the contract is different to that set in the channel manager settings, it can be specified as a third item in the rate setting.
Example: NRF-BAR/45678/164
Daily prices and rates in which you have not specified a contract will send only to the first contract.
11 Activate
You can view the live availability and prices that will be sent to Hotelbeds before or after activating using the “View actual data” button.
When everything is correct tick “Inventory”, “Prices” and “Bookings” to activate the connection.
12 Price Multiplier
If you want to add a multiplier to your prices – perhaps because Hotelbds requires a different currency to your MASTERINSOFT currency – add a * followed by the multiplier number to your Contract Name.
For example a Contract Name setting ABC*1.23 will multiply all prices by 1.23 sent for Contract Name ABC. (i.e. raised by 23%) Lower prices can be sent with a multiplier less than 1, i.e. ABC*0.85 will send a price 85% of the normal price (i.e. lowered by 15%)
To convert the price of bookings imported add a * after the multiplier, for example 12345678*1.23* will divide the price of the booking by 1.23.
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.
13 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.
14 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.
15 Manage bookings
By default the payout amount is imported into the “Invoice” tab of new bookings. After you have chosen your sync option you can change this option in SETTINGS-CHANNEL MANAGER “Invoice” = Booking Amount if you want to import the amount the guest pays. If you use this option the lodging amount and cleaning fee will be shown separately.
If you need a different invoice template for the bookings from this channel you can use the invoicee function. Enter the ID number of the invoicee and all incoming bookings from the channel will be assigned to this invoicee (it does not change existing bookings.
15.1 Charge Virtual Credit Cards
Virtual cards can be set to be auto charged at the date they become valid. To use this option set “Auto Process Virtual Cards” = Yes
Virtual cards can be set to be auto charged at the date they become valid.
This option is available for customers who use Stripe. If you set “Virtual Cards” = Yes without Stripe activated the system will create a pending payment which can not be collected.
If you manually charge virtual credit cards please note that they can only be charged on the check-out date.
15.2 Info Codes
Info Codes in the “Info” tab of the booking show you relevant information.
| Code | Use |
| VIRTUALCARD | virtual card was sent from the channel |
| CARDTOSTRIPE | card details were sent to Stripe |
| STRIPEPAYMENT | payment imported from Stripe |
| STRIPEFAIL | card could not sent to Stripe |
| CARDEXPIRES | added when the card expires before check-in |
16 Common Errors
Incorrect user or password
Check if your username password and hotel code are entered correctly. .
If yes send and email to hotelconnect@hotelbeds.com and ask them to check the connection with MASTERINSOFT is activated.
This change is not permitted as it does not agree with the signed contract.
You have a contracted allotment or restriction (for example on the minimum stay you are allowed to send) in Hotelbeds. Click on the “Get Contract Detail” link to check if/which minimum stay restriction (MLOS=X) applies. Make sure the data you send from MASTERINSOFT complies with your contract with Hotelbeds.
17 Notes
- If you want to sync only inventory and have multiple contracts you need a rate for each contract with a price. In the “Channels” tab of the rate deselect “Hotelbeds” and if will not send.