Difference between revisions of "Hotelbeds.com"

From Beds24 Wiki
Jump to navigation Jump to search
 
(64 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
[[Category:Channel Manager]]
 
[[Category:Channel Manager]]
  ''Synchronising Beds24.com with Hotelbeds ''
+
[[Category:Error Messages from Channels]]
 +
[[Category:Troubleshooting]]
 +
<div class="heading">Hotelbeds</div>
 +
  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOTELBEDS and explains how the connection with Hotelbeds works and how to set it up.
 
http://www.hotelbeds.com
 
http://www.hotelbeds.com
  
'''==Coming Soon. Contact us via a support ticket if you want to connect.=='''
+
This connection to Hotelbeds will also update GTA and Tourico Travel.
 +
__TOC__
 +
==General==
 +
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
 +
*This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 +
 
 
==Capabilities==
 
==Capabilities==
 +
*Beds24 can export inventory
 +
*Beds24 can export rates. We send ONE ROOM price. If you have multiple prices by default the lowest price will be sent.
 +
*Beds24 can export minimum stay
 +
*Beds24 can import bookings
 +
*Beds24  can import changes to bookings
  
*Beds24.com can export inventory
+
For details please [[Channel_Manager_Capabilities|click here]]
*Beds24.com can export rates
 
*Beds24.com can export minimum stay
 
*Beds24.com can import bookings
 
*Beds24.com can import changes to bookings
 
  
For details please [[Channel_Manager_Capabilities|click here]]
 
 
==Limitations==
 
==Limitations==
Currently the channel manager can synchonise one contract.
+
*Only the ROOM price is sent.
 +
*If you have multiple room types and make a change which applies to your whole property the updates will send for one room type at a time. This limitation will then apply to all channels you use.
 +
 
 +
== 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]].
 +
*Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the Fixed Prices 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 Beds24 manually.
 +
 
 +
'''Extras and Taxes'''
 +
 
 +
"Upsell Items" can not be exported.
 +
 
 +
 
 +
'''Credit Cards'''
 +
 
 +
If you want to access credit card details through Beds24 ask Hotelbeds to only accept bookings with credit card details and always send all details to Beds24.
 +
 
 +
 
 +
'''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==
 
*Hotelbeds username
 
*Hotelbeds username
 
*Hotelbeds password
 
*Hotelbeds password
 +
== Hotelbeds ==
 +
Contact Hotelbeds support with your Hotelbeds username which you are using to access the Hotelbeds  extranet and ask them to connect with Beds24. Include following information in the email:
  
 +
1. The URL where the reservations will be sent is: https://api.beds24.com/hotelbeds.com/booking
  
== Hotelbeds ==
+
2. The email address where the reservations will be sent in case Beds24 cannot process them.
Send and email to [email protected]) with your Hotelbeds username which you are using to access the Hotelbeds  extranet and ask them to connect with Beds24. Include following information in the email:
 
  
1. The URL from where the reservations will be send is: https://api.beds24.com/hotelbeds.com/booking
+
Hotelbeds will notify you when the BMS connection is ready.
  
2. The email address where the reservations will be send in case the Channel answers with NOT PROCESSED is: hotelbeds@beds24.com
+
== 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".  
  
  
Hotelbeds will notify you when the BMS connection is ready.
+
==Beds24==
==Beds24.com==
+
Click on the "Get Contract List" link to access your contract list.
via XML / Swap office code and sequence
 
  
1. Enter account data:
+
Enter account data:
 
*Enter your Hotelbeds Hotel Code into the field "Hotel Code"
 
*Enter your Hotelbeds Hotel Code into the field "Hotel Code"
 
*Enter your Hotelbeds Contract Name in the field "Contract Name".  
 
*Enter your Hotelbeds Contract Name in the field "Contract Name".  
 
*Enter your Hotelbeds Sequence into the field "Sequence"
 
*Enter your Hotelbeds Sequence into the field "Sequence"
*Enter your Hotelbeds Office Code into the field "Office Code"
+
*Enter your Hotelbeds Office Code into the field "Incoming Office Code"
  
 
Press SAVE.
 
Press SAVE.
  
2. Map rooms:
+
[[Image:hotelbeds.png|700px|link=]]
 +
[[Media:hotelbeds.png|view large]]
 +
 
 +
== Map rooms ==
 +
Click on the "Get Contract Detail" link to access your contract details.
  
 
For each room you want to connect:
 
For each room you want to connect:
Line 47: Line 89:
 
*Enter your Hotelbeds Room Characteristic into the field "Room Characteristic"
 
*Enter your Hotelbeds Room Characteristic into the field "Room Characteristic"
  
3.  
+
[[Image:hotelbeds1.png|700px|link=]]
 +
[[Media:hotelbeds1.png|view large]]
 +
 
 +
 
 +
 
 +
<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 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 Daily Prices Fixed Prices you want to send to the second contract.
 +
*In Fixed Prices  go to the "Channels" tab. Tick "Hotelbeds" and enter the contract name and sequence for this contract separated by the / symbol.
 +
* Daily Prices, scroll down to 'Enable List' 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 Fixed Prices in which you have not specified a contract will send only to the first contract.
 +
 
 +
[[Image:hotelbeds2.png|350px|link=]]
 +
[[Media:hotelbeds2.png|view large]]
 +
 
 +
== 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.
 +
 
 +
==Price Multiplier==
 +
If you want to add a multiplier to your prices - perhaps because Hotelbeds requires a different currency to your Beds24 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.
 +
 
 +
== 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.
 +
 
 +
==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.
 +
 
 +
====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.
 +
 
 +
<div class="warning">{{#fas:exclamation-triangle}} This option is available for customers who use [[Stripe|Stripe]]. If you set "Virtual Cards" = Yes without Stripe activated the system will create a pending payment which can not be collected.</div>
 +
 
 +
A payment rule can be specified to be attached to the pending payment, the payment rule can further manage the conditions to collect the payment, for example it could specify to use virtual cards only and not a guest card.
 +
 
 +
You can only select a "payment rule" in Hotelbeds.com after you have created one.
 +
Settings > Payments > Payment Rules and set Payment Source = Virtual card only > then select the payment rule in the channel manager setup for Hotelbeds.com
 +
 
 +
If you manually charge virtual credit cards please note that they can only be charged after the card activation date.
 +
 
 +
====Info Codes====
 +
Info Codes in the "Info" tab of the booking show you relevant information.
 +
 
 +
{| class="wikitable"
 +
 
 +
! scope="col"| Code
 +
! scope="col"| 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
 +
|-
 +
 
 +
|}
  
 
== Common Errors ==
 
== Common Errors ==
 +
'''Incorrect user or password'''
 +
Check if your username password and hotel code are entered correctly. .
 +
If yes send and email to [email protected] and ask them to check the connection with Beds24 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 Beds24 complies with your contract with Hotelbeds.
 +
 +
== Notes ==
 +
*If you want to sync only inventory and have multiple contracts you need a price for each contract. Deselect "Hotelbeds" in your prices and it will not send.

Latest revision as of 13:57, 1 April 2024

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.

http://www.hotelbeds.com

This connection to Hotelbeds will also update GTA and Tourico Travel.

1 General

2 Capabilities

  • Beds24 can export inventory
  • Beds24 can export rates. We send ONE ROOM price. If you have multiple prices by default the lowest price will be sent.
  • Beds24 can export minimum stay
  • Beds24 can import bookings
  • Beds24 can import changes to bookings

For details please click here

3 Limitations

  • Only the ROOM price is sent.
  • If you have multiple room types and make a change which applies to your whole property the updates will send for one room type at a time. This limitation will then apply to all channels you use.

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.

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.


Credit Cards

If you want to access credit card details through Beds24 ask Hotelbeds to only accept bookings with credit card details and always send all details to Beds24.


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 Beds24. Include following information in the email:

1. The URL where the reservations will be sent is: https://api.beds24.com/hotelbeds.com/booking

2. The email address where the reservations will be sent in case Beds24 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 Beds24

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.

Hotelbeds.png view large

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"

Hotelbeds1.png view large


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 Daily Prices Fixed Prices you want to send to the second contract.

  • In Fixed Prices go to the "Channels" tab. Tick "Hotelbeds" and enter the contract name and sequence for this contract separated by the / symbol.
  • Daily Prices, scroll down to 'Enable List' 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 Fixed Prices in which you have not specified a contract will send only to the first contract.

Hotelbeds2.png view large

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 Hotelbeds requires a different currency to your Beds24 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.

A payment rule can be specified to be attached to the pending payment, the payment rule can further manage the conditions to collect the payment, for example it could specify to use virtual cards only and not a guest card.

You can only select a "payment rule" in Hotelbeds.com after you have created one. Settings > Payments > Payment Rules and set Payment Source = Virtual card only > then select the payment rule in the channel manager setup for Hotelbeds.com

If you manually charge virtual credit cards please note that they can only be charged after the card activation 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 [email protected] and ask them to check the connection with Beds24 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 Beds24 complies with your contract with Hotelbeds.

17 Notes

  • If you want to sync only inventory and have multiple contracts you need a price for each contract. Deselect "Hotelbeds" in your prices and it will not send.