Difference between revisions of "Hotelbeds.com"

From Beds24 Wiki
Jump to navigation Jump to search
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:Channel Manager]]
 
[[Category:Channel Manager]]
 
[[Category:Error Messages from Channels]]
 
[[Category:Error Messages from Channels]]
[[Category:Set up Instructions]]
+
[[Category:Troubleshooting]]
  ''This page is about the menu SETTINGS->CHANNEL MANGER->HOTELBEDS ''
+
<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
  
Line 12: Line 13:
  
 
==Capabilities==
 
==Capabilities==
*Beds24.com can export inventory
+
*Beds24 can export inventory
*Beds24.com can export rates. We send ONE ROOM price. If you have multiple rates by default the lowest price will be sent.  
+
*Beds24 can export rates. We send ONE ROOM price. If you have multiple rates by default the lowest price will be sent.  
*Beds24.com can export minimum stay
+
*Beds24 can export minimum stay
*Beds24.com can import bookings
+
*Beds24 can import bookings
*Beds24.com can import changes to bookings
+
*Beds24 can import changes to bookings
  
 
For details please [[Channel_Manager_Capabilities|click here]]
 
For details please [[Channel_Manager_Capabilities|click here]]
Line 67: Line 68:
  
  
==Beds24.com==
+
==Beds24==
 
Click on the "Get Contract List" link to access your contract list.
 
Click on the "Get Contract List" link to access your contract list.
  
Line 92: Line 93:
  
  
<span class="circle" >{{#fas:lightbulb}} Tip</span> '''''Click on the "View Actual Data" Button to check which prices and availability will send.'''''
+
 
 +
<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 ==
 
== Multiple contracts ==
Line 100: Line 102:
 
Open the rates or daily prices you want to send to the second 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.  
 
*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 (SETTINGS- >PROPERTIES- >ROOMS- >DAILY PRICES then click on "Edit")
+
* 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
 
Example: NRF-BAR/45678
  
Line 143: Line 144:
 
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.  
 
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 ===
+
====Charge Virtual Credit Cards ====
Virtual cards can be set to be auto charged at the date they become valid. To use this option set "Virtual Cards" = Yes
+
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
 +
|-
  
If you manually charge virtual credit cards please note that they can only be charged when they become valid.
+
|CARDEXPIRES
 +
| added when the card expires before check-in
 +
|-
  
Note: 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.
+
|}
  
 
== Common Errors ==
 
== Common Errors ==

Revision as of 19:01, 16 February 2022

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 rates 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

  • 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 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 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.
  • 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 rates 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 Hotelbds 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 rate for each contract with a price. In the "Channels" tab of the rate deselect "Hotelbeds" and if will not send.