Difference between revisions of "Booking.com: Synchronise bookings prices availability"

From Beds24 Wiki
Jump to navigation Jump to search
 
(272 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
[[Category:Channel Manager]]
 
[[Category:Channel Manager]]
 
[[Category:Booking.com]]
 
[[Category:Booking.com]]
[[Category:Error Messages from Channels]]
+
[[Category:Troubleshooting]]
[[Category:Set up Instructions]]
 
''Synchronising Prices, Availabiltiy and Bookings with your [https://join.booking.com/index.html?aid=3000042&utm_source=connectivity_providers&utm_medium=Email&utm_campaign=NPIN_property%20referral Booking.com] account''
 
  
=General=
+
<div class="heading">Booking.com: Synchronize Bookings, Prices and Availability</div>
*You need an account with Booking.com If you do not yet have one you can [[Booking.com_XML:_Create_and_update_properties_and_rooms_on_Booking.com|create a Booking.com account directly from Beds24]].
+
This page is about the menu  {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM  > MAPPING and explains how to export prices, availability, rules and import bookings, modifications to bookings and cancellations for existing listings on Booking.com
  
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
+
<div class="warning">{{#fas:exclamation-triangle}} Use [[Booking.com:_Import_Properties_from_Booking.com_to_Beds24|these instructions if you want to import]] properties from Booking.com to Beds24. </div> 
*This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 
  
=Capabilities=
+
<div style="display:none">
With the connection you can
+
<div class="summarybox">
*Export prices, availability and rules
+
When all of your prices, and rooms are set up in Beds24 you can start the integration with Booking.com:
**send inventory (available rooms)
+
#Initiate the connection in Booking.com  
**send minimum stay
+
#Map your rooms and Booking.com rate plans
**send maximum stay
+
#Set the rooms you want to sync to "Enable"
**send closed to arrival and closed to departure
+
#Import all upcoming bookings
**send multiple rates
+
#Check what will send to Booking.com
**add a multiplier to mark prices up or down.
+
#Activate the connection
*Import bookings, modifications to bookings and cancellations, importing modifications or cancellations can be disabled for individual bookings
 
*create Booking.com rate plans
 
*Report invalid cards and no-shows can be reported to Booking.com from the "Details" tab of the booking. If you use Stripe you can set in SETTINGS->CHANNEL MANAGER to automatically report invalid cards to Booking.com
 
*Create and manage promotions
 
*View reviews and react to reviews
 
  
=Limitations=
+
Read the complete [https://wiki.beds24.com/index.php?title=Booking.com:_Synchronise_bookings_prices_availability instructions] before you start the integration.  
If you export inventory you will also need to export rates from Beds24, rates can not be set within the Booking.com extranet.
 
  
Booking.com may sometimes withhold the credit card number or CCV unless you specifically request they are sent to you. Contact your Booking.com rep if this is occurring and you require this information.
+
<div class="warning alert alert-danger">{{#fas:exclamation-triangle}} Use [https://wiki.beds24.com/index.php/Booking.com:_Import_Properties_from_Booking.com_to_Beds24 these instructions if you want to import]  properties from Booking.com to Beds24. </div> 
 +
</div>
 +
</div>
  
= Before you Connect =
+
__TOC__
'''Prices'''
+
=What you should know  and do before getting started=
 +
<div class="bluebox">
 +
'''As a longstanding Booking.com Premier Partner Beds24 can offer you advanced functionality and many convenience functions. Once set up you can manage everything directly from Beds24 which will save you time and make working with Booking.com really easy. '''
  
When the connection is activated Booking.com will remove all price and availability details on the Booking.com extranet and replace them with the data sent from Beds24. Therefore prices and availability of all rooms must be set up in Beds24 before connecting. 
+
Learn [[:Category:Channel Manager| how the channel manager works]].
*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]].
 
*Booking.com needs a room price for the maximum number of guest.
 
*If you want to send a single price and a room price you need to ask Booking.com to activate the single price option for you.
 
*Prices for "Extra Person",  "Extra child" and discounts set in the "Discounts" tab of the rates can not be exported to Booking.com.  If you need prices for more occupancy levels talk to Booking.com about derived rates or additional rate codes (see chapter "Multiple Rates" further down).  
 
  
'''Extras and Taxes'''
+
If you want to export inventory (availability) Booking.com demands prices to be sent from Beds24 so you will not be able to set prices the Booking.com extranet after the connection has been enabled.
  
"Upsell Items" can not be exported to Booking.com.  
+
All of your prices, rooms, and bookings from other sources must be set up in Beds24 before you connect:
 +
*The prices you want to send to Booking.com need to have Booking.com activated under "Channels"
 +
*Beds24 can not import past booking from before Booking.com was connected as a distribution channel. You can add these manually in the Calendar, via the "Add booking" button at the top or import them from a .csv file in  {{#fas:cog}} (SETTINGS) > PROPERTIES
 +
*Your rooms and room types in Beds24 have to match your set up in Booking.com. If you sell rooms individually at another channel or your own website and want to sell them on Booking.com as a "room type" with a quantity of more than one you can [[Combine_individual_rooms_into_a_roomtype|set up virtual rooms]].
 +
</div>
  
If required you can enter extras and fees can directly in Booking.com.
+
==Capabilities and Limitations==
 
+
'''With this connection you can:'''
'''Bookings'''
+
*send  prices and availability
 
+
**send multiple prices
Upcoming bookings can be imported.  Booking.com will only send a summary of the booking, not the full information. The full information can still be accessed in the Booking.com extranet. New bookings made after activation will include full booking information.
+
**add a multiplier to mark prices up or down
 
+
**create Booking.com rate plans if you want to add additional pricing options
'''Credit Cards'''
+
*send restrictions
 
+
**send minimum stay
If you want to access credit card details through Beds24 ask Booking.com to only accept bookings with credit card details and always send all details to Beds24.
+
**send maximum stay
 
+
**send closed to arrival and closed to departure
'''Rooms and room types'''
+
*import and manage bookings
 
+
**import new bookings, modifications to bookings and cancellations (importing modifications or cancellations can be disabled for individual bookings)
If you sell rooms individually at another channel or your own web site and want to sell them on Booking.com as a "roomtype" with a quantity of more than one you can [[Combine_individual_rooms_into_a_roomtype|set up virtual rooms]].
+
**report no-shows date changes and guest misconduct to Booking.com  
 +
**report invalid cards to Booking.com. If you use Stripe you can set to automatically report invalid cards to Booking.com (go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER to activate this option)
 +
*create and manage Booking.com promotions
 +
*view reviews and react to reviews
  
'''Dorms'''
+
'''Limitations:'''
 +
*Extras taxes and fees will not automatically send or update. Set/change these in your Booking.com Extranet unless you want to manage your full Booking.com content from Beds24.
 +
*Beds24 imports only confirmed bookings. If you have set to only accept "Requests" you will need to accept the booking in your Booking.com extranet and they will import once they are confirmed.
 +
*Changes to availability and prices will be instantly sent to the channel. Changes to settings for example minimum stays, or quantity of rooms  or the multiplier will send with the next update but you have the option to push them manually if you require an instant update.
  
Booking.com requires the bed price be sent to them as the room price. Therefore they do not accept a single price for a dorm. Make sure you set "Booking.com Rate Type"= One Price. If you want to send a single price for other rooms ask Booking.com to set up a "Single" rate id for these.
+
==Prices for Booking.com==
 +
Our connection with Booking.com supports '''Occupancy Pricing (OBP)'''  so Beds24 can send a price for each occupancy defined in your prices in Beds24. We will automatically set all newly connected properties to "Occupancy Pricing (OBP)" which also allows you to just send one price per day for the full occupancy.
 +
*If you use Daily Prices, a price for each date and occupancy will be sent. Multiple occupancy prices can send on each rate plan. Extra person price in the daily price will send. [[:Category:Daily_Prices|See this tutorial on how to use daily prices]].
 +
*If you use Fixed Prices, 1 person, 2 person and room price will send. The room price will send for specified occupancy. Multiple fixed prices with different occupancies can send on same rate plan. <span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the Fixed Prices can not be sent.
 +
*If you currently use '''RLO (derived) prices''' for different occupancies on Booking.com:
 +
*#If you want to keep RLO pricing, the Beds24 prices you want to send to Booking.com need to to be the right price for "base number of guests" in Booking.com so Booking.com can calculate correctly.
 +
*#If you want to send prices for different occupancies from Beds24, contact Booking.com and ask them to remove all linked prices. Then change your pricing model in Beds24 to "Occupancy Pricing".
  
= Sync Prices, Availability and Bookings =
+
'''Prices for dorms'''
Setting up the connection is a 4 step process:
 
  
1) You request a connection on Booking.com extranet- nothing changes you are still bookable according to the prices and inventory you have set in the Booking.com extranet
+
For dorms Booking.com requires the bed price be sent to them as the room price. They do not accept a single price for a dorm. Therefore we will have to manually adjust your pricing model. If you want to send a single price for other rooms  you can create additional rate plans for single use in [[Booking.com:_Create_Booking.com_Rate_Plans_in_Beds24|{{#fas:cog}} (SETTINGS)  CHANNEL MANAGER->BOOKING.COM > RATE PLANS]].
  
2) Beds24 accepts your request - nothing changes you are still bookable according to the prices inventory you have set in the Booking.com extranet
+
=Connect a property on Booking.com to a property in Beds24 to synchronize prices, availability and bookings=
 +
This channel has a very specific activation process that must be followed carefully. Click on "Expand" to view the details for each step.
  
Between step 2 and 3 you should map your rooms and rates, check everything and import existing bookings from Booking.com to block the booked dates.
+
<embedvideo service="youtube">https://youtu.be/rsqRWgawcWU</embedvideo>
  
3) You enable the connection in Booking.com - this is when Booking.com removes your inventory and rates and you are temporarily not bookable.
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 1: Initiate the connection in Booking.com
 +
</div>
 +
<div class="mw-collapsible-content">
  
4) Beds24 sends prices and availability to Booking.com. You are bookable again. To send the update immediately click the "Update" buttons in the channel manager settings.
+
1. Click on the "Connect to Booking.com" button to login to Booking.com then go to ACCOUNT > CONNECTIVITY PROVIDER.
 +
If you have a Booking.com group account log to Booking.com and go to ACCOUNT > CONNECTIVITY PROVIDER and select Beds24 as channel manager from there.
  
Bookings are not removed from the Booking.com extranet. Existing and new bookings are always visible in the Booking.com extranet.
+
2. Search for Beds24.
  
 +
3. Tick all tick boxes.
  
==Initiate the connection in Booking.com==
+
4. Complete the rest of the on screen instructions.
Initiate the XML connection from the property menu within the booking.com extranet and then do the Beds24 setup.
 
  
1) Login to Booking.com and go to ACCOUNT->CHANNEL MANAGER. If you do not see this option contact Booking.com and tell them you want to use a channel manager
+
[[Image:extranet-booking.png|500px|link=]]
 +
[[Media:extranet-booking.png|view large]]
  
2) Click the Start button and search for BEDS24.
+
<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span>  For a two-way connection you need to select both "Reservations" and  "Rates and Availability". Beds24 can then export inventory to Booking.com and import bookings from Booking.com. If you select only  "Reservations" or only "Rates and Availability" you only have a "one-way" connection meaning the action you did not select must be manually maintained by you.  
 +
</div></div>
  
<embedvideo service="youtube">https://youtu.be/VYzWI-PDVYk</embedvideo>
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >  
 +
Step 2: Enter your Booking.com property ID
 +
</div>
 +
<div class="mw-collapsible-content">
 +
#Copy your Booking.com hotel ID and paste it into the "Hotel Id " field
 +
#Press SAVE
 +
</div></div>
  
3) Complete the rest of the on screen instructions.
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 3: Map your rooms
 +
</div>
 +
<div class="mw-collapsible-content">
 +
#Click on the "Get Codes" link next to the room id setting, a list of room Ids will be retrieved from Booking.com and displayed
 +
#Choose the Booking.com room you want to map to the Beds24 room and click on it
 +
#Check the correct room Id has been copied to the room id setting
 +
#Press Save
 +
</div></div>
  
It is possible to select a "one way" or "two way" connection with Booking.com. The normal case is "two way" which will both export inventory to Booking.com and import bookings from Booking.com. If you select any of the "one way" options only one of these actions will be performed and the other must be manually maintained by you.
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 4: Map your Booking.com rate plans
 +
</div>
 +
<div class="mw-collapsible-content">
 +
'''1. If you have only one Booking.com rate plan'''
 +
#Click on the "Get Codes" link next to the rate id setting and a list of rate Ids will be retrieved from Booking.com for the saved room id
 +
#Choose the Booking.com rate plan and click on it
 +
#Check the rate plan Id has been copied to the rate plan Id setting
 +
#Press SAVE
  
4) When ready you will receive a notification from Booking.com, go to the Channel Manager menu again and activate the connection.
+
'''2. If you have more than one Booking.com rate plan'''
 +
#Click on the "Get Code" link next to the rate id setting and a list of rate Ids will be retrieved from Booking.com for the saved room id
 +
#Choose the Booking.com standard rate plan
 +
#Check the rate plan Id has been copied to the rate plan Id setting
 +
#Press Save
 +
#Open the prices (PRICES > Daily Prices/Fixed Prices) which you want to send your other Booking.com rate plans
 +
#Click on "Get Codes" and choose the Booking.com rate plan you want to update with this price
 +
#Check the rate plan Id has been copied to the rate plan Id setting
 +
#Press SAVE
  
==Set up and mapping in Beds24==
+
<div class="warning">{{#fas:exclamation-triangle}} You can only map the rate plans Booking.com makes available when you click on "Get Codes". Do not enter any other numbers. Linked prices (slave or child rate plans) on Booking.com i.e. for refundable/non refundable options can not update from Beds24. Deactivate these in Booking.com </div> 
1) Enter your Booking.com Hotel Id into SETTINGS -> CHANNEL MANAGER -> BOOKING.COM  "Hotel ID" setting and '''then scroll to the bottom of the page and click SAVE'''.
+
</div></div>
  
[[Image:bookingcom1.png|450px|link=]]
+
<div class="mw-collapsible mw-collapsed">
[[Media:bookingcom1.png|view large]]
+
<div  class="headline-collapse" >
 +
Step 5: Enable rooms
 +
</div>
 +
<div class="mw-collapsible-content">
 +
#Scroll down to the rooms and set "Enable" = Enabled
 +
#If you have multiple room types repeat for each room
 +
#Press SAVE
 +
</div></div>
  
2) Set "Booking Price Import" to either import the room price only or the room price plus unpaid extras (cleaning charges, local taxes etc.)
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 6: Set a multiplier  to mark your prices up or down or for currency conversion (optional)
 +
</div>
 +
<div class="mw-collapsible-content">
 +
You can add a multiplier to your prices, add a '''*''' followed by the multiplier number in the "Multiplier" field
  
3) Some Booking.com rate ids can accept a room price plus a single occupancy price on the same rate id. If you have this rate type and want to send the single occupancy price set "Booking.com Rate Type " = "Full + Single". If you do not have this rate type or you are not sure set "Booking.com Rate Type "= "One Price "
+
Examples:
 +
*'''*1.23''' will multiply all prices by 1.23  (i.e. raised by 23%).
 +
*Lower prices can be sent with a multiplier less than 1: '''*0.85''' will send 85% of the normal price (i.e. lowered by 15%).
 +
*To convert the price of bookings imported from the channel add a '''*''' AFTER the multiplier. '''*1.23*''' will divide the price of the booking by 1.23.
 +
*For currency conversion you can also use currency conversion template variables. All currencies supported by the booking page currency selector can be used.
 +
**'''*[CONVERT:IDR-EUR]''' will convert Indonesian Rupees to Euros.
 +
**'''*[CONVERT:IDR-EUR]*''' will convert Indonesian Rupees to Euros and back to Indonesian Rupees on the import.
 +
</div></div>
  
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 7: Import upcoming bookings
 +
</div>
 +
<div class="mw-collapsible-content">
 +
#Click on the "Import Existing Bookings" button to import upcoming bookings from Booking.com. We can then import 10 bookings. Repeat if you have more
 +
#If you have bookings from Airbnb and/or Expedia you can import them directly from the channel as well
 +
#If you have bookings from other sources you can add these manually in the Calendar, via the "Add booking" button at the top or import them from a .csv file in  {{#fas:cog}} (SETTINGS) > PROPERTIES
 +
#If you want to close additional dates or limit check-in and/or check-out you can use the "Override" function in the Calendar
 +
</div></div>
  
4) Mapping
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 8: Check what will send to Booking.com
 +
</div>
 +
<div class="mw-collapsible-content">
 +
#Click on the "Price Data" Button to check which prices and availability will send.
 +
#If you have multiple room types repeat for each room.
 +
</div></div>
  
<embedvideo service="youtube">https://youtu.be/-SbeMMSk8wc</embedvideo>
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 9: Activate the connection
 +
</div>
 +
<div class="mw-collapsible-content">
 +
When you activate the connection Booking.com will remove your prices and availability from their system and replace them with the prices and availability sent from the channel manager.
  
Map Rooms:
+
You can activate the connection when your mapping and prices are correct  and you have added all upcoming bookings.
*Click on the "Get Code" link next to the room id setting, a list of room ids will be retrieved from Booking.com and displayed.
+
*Press "Activate Connection" and then "Activate Connection Now".  
*Choose the Booking.com room you want to map to the Beds24 room and click on it.
 
*When the correct room id has copied to the room id setting, click Save.
 
  
[[Image:bookingcomrooms.png|450px|link=]]
+
<div class="warning">{{#fas:exclamation-triangle}} If you have dorms: Do not activate the connection yourself. Please send us a support ticket in which you explain that you have dorms with Booking.com. We will then manually adjust your settings so the connection can work. </div> 
[[Media:bookingcomrooms.png|view large]]
+
</div></div>
  
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 10: Remove Auto-Replenishment (optional)</div>
 +
<div class="mw-collapsible-content">
 +
Beds24 will automatically reopen rooms when you have availability. If you have  Auto-Replenishment enabled, Booking.com will not wait for the update sent from Beds24 but will automatically re-open the closed room when a guest cancels even if you have a booking from another source. You can opt-out of the feature by following these steps:
 +
*Log into your Booking.com account
 +
*Click on the Rates & Availability tab
 +
*Go to the Settings symbol on the top-right corner of your Calendar
 +
*Click on Auto-Replenishment
 +
*Under Calendar Settings, click "No" to turn off the Auto-Replenishment feature
 +
</div></div>
  
Map Rates:
+
<div class="mw-collapsible mw-collapsed">
*Click on the "Get Code" link next to the rate id setting and a list of rate ids will be retrieved from Booking.com for the saved room id.
+
<div  class="headline-collapse" >
*Choose the Booking.com rate id for this room and click on it. This will normally be the standard rate.
+
Step 11: Check  that the connection is working properly</div>
*When the correct rate id has copied to the rate id setting, click Save.
+
<div class="mw-collapsible-content">
 +
Click "Refresh" for the Connection Status to check the status of your property at Booking.coms end.
  
[[Image:bookingcomrates.png|450px|link=]]
+
If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.
[[Media:bookingcomrates.png|view large]]
 
  
 +
The connection is working if and your property is selling if
 +
*you do not receive any erros
 +
*you see Connection Status: XML Active and Hotel Status: Open / bookable
 +
*you are not receiving error messages
 +
*the display in the channel is correct.
  
  <span class="circle" >Tip</span> ''Click on the "View Actual Data" Button to check which prices and availability will send.''
+
This is what the different status values mean:
 +
*Ready to Open: The property has been reviewed by Booking.com, and is ready to open. Open the property in your Booking.com extranet or go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM > SYNC CONTENT and click on "Open property".
 +
*Open/Bookable: The property is open and live on Booking.com. It is ready to receive reservations.
 +
*Autoclosed: Availability: The property has no availability and has been closed. Go to {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER->BOOKING.COM > MAPPING, click on "Price Data" to check which prices and availability will send. If required adjust your prices and inventory.
 +
*Duplicate: This property has been found to be a duplicate of another property.
 +
*XML: Closed: The property has been closed. Open the property in your Booking.com extranet or go to  {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM > SYNC CONTENT and click on "Open property".
 +
*Closed:The property is closed and no longer bookable on Booking.com. Check your Booking.com extranet for further information.
 +
</div></div>
  
===Multiple Rate Plans at Booking.com===
+
=After the connection is activated=
Booking.com can support more than one price  per room for example to send prices for different occupancies, minimum stays, meal options or refundable and non-refundable prices. There are two options:
+
<div class="warning">{{#fas:exclamation-triangle}} Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays, or quantity of rooms  or the multiplier will send with the next update. Click on "Update" if you want to push them through instantly.
 +
</div> 
 +
==Communication with guests==
 +
You can communicate with Booking.com guest directly from Beds24.  
  
'''1. Linked/Derived Prices'''
+
You can view all messages which Booking.com makes available from the "API Messages" component on the DASHBOARD and individual communication from the "Messages" tab in the booking.  
  
Booking.com can auto calculate different occupancies from one standard rate. This rate is either for the base or for the maximum occupancy of a specific room. The system then automatically adds or subtracts a percentage price per person when the occupancy increases or decreases.
+
You and your guests will see the messages in Booking.com Messaging Center.
  
Talk to your Booking.com rep about how to best set this up (either a base rate to add on to or a maximum occupancy rate to subtract from).
+
Currently messaging with guests from Booking.com has following limitations:
 +
*Guests must click on "View Messages" in the email to login to Booking.com and answer from there.
 +
*If a guest hits "reply" on E-mail they received from Booking.com, Booking.com does not send the reply to Beds24 and will also not make the reply available in Booking.com. 
 +
*Booking.com does not allow links in messages. Use attachments instead.  
  
 +
Properties can send messages to guests within the following time frames:
 +
*From the time of booking until 7 days after the guest checkout.
 +
*From the time of booking until 7 days after the booking is cancelled.
 +
*If the guest messages about the booking, the property gets an additional 14-day window to reply to the guest irrespective of when the booking was cancelled or when the guest checked out.
 +
*Currently, guests can send messages to properties from the time of booking until 66 days after the checkout.
  
'''2. Multiple Rate Ids'''
+
<div class="warning">{{#fas:exclamation-triangle}}  If you use dependencies you can only assign the bookings into a room in the same property as the room which is mapped to Booking.com.</div>
  
Booking.com can set up multiple rate ids for each room, each with pre-defined booking conditions. Beds24  can send a different price to each Booking.com rate ID.  [[Setting_Prices_for_Booking_Channels#Mapping_channel_rate_codes|Please use these instructions]].
+
'''To use this function'''
  
If you do not have the appropriate rate ids you need to request Booking.com to add them.
+
#Add the component  "API Messages" to your [[:Category:Dashboard|DASHBOARD]]
 +
#To send Auto Action Emails via messaging set "Send Message" on the "Messaging" tab in the Auto Action to one of the API options.
 +
#Bookings need to be in a Property that is connected to Booking.com to use the Message API, otherwise communication will be via Email. If you are not sure your connection has Message API, please log into Booking.com and and go to ACCOUNT > CONNECTIVITY PROVIDER. Disconnect from Beds24 and reconnect this time ticking all tick boxes as shown here: https://wiki.beds24.com/images/6/69/Extranet-booking.png
  
===Price Multiplier===
+
Booking.com allows .jpg and .png attachments but no links or pdfs.  
If you want to add a multiplier to your prices, for example because the channel 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%)
+
<div class="warning">{{#fas:exclamation-triangle}} Ensure you do NOT use special characters in the auto action message text as this will breach the Booking.com security checks, and the message will fail to send.</div>
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%)
 
  
To convert the price of bookings imported from the channel add a * after the multiplier, for example '''123456*1.23*''' will divide the price of the booking by 1.23.
+
==Manage bookings==
 +
===Credit cards, charging virtual credit cards & payments ===
 +
Credit card details are imported and shown on the "INVOICE" tab of the booking. If not please refer to "Missing credit card details" in "Troubleshooting" section below.  
  
You can also use currency conversion template variable. All currencies supported by the booking page currency selector can be used.
+
Bookings with payments collected by Booking.com will show the payment amount collected as a payment in the "Invoice" tab of the booking.
  
Example: *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
+
'''Charge virtual cards automatically'''
  
Example: *[CONVERT:IDR-EUR][/]0.85 will convert Indonesian Rupees to Euros and  send a price 85% of the normal price (i.e. lowered by 15%)
+
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
  
 +
For Booking.com virtual cards you can set to adjust the charge automatically to the full amount available on the card at the time it is charged. To do so create a rule with these settings and specify it in the booking.com "Virtual Card Payment Rule" setting:
 +
*Funds Source: Virtual Card
 +
*Payment value adjustment = choose any except for "None"
  
===Activating in Beds24 and Booking.com===
+
<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>
You can view the live availability and prices that will be sent to Booking.com before or after activating using the "View actual data" button.
 
  
[[Image:booking13.png|450px|link=]]
+
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. [https://wiki.beds24.com/index.php/Stripe_Channel_Virtual_Cards#Set_up| Click here for more details]
[[Media:booking13.png|view large]]
 
  
 +
'''Charge virtual cards manually'''
  
1) Import existing bookings from Booking.com
+
If you manually charge virtual credit cards please note that they can only be charged after the activation date.
  
Make sure the "Bookings" check box for each mapped room is ticked and saved and then click the "Import existing bookings" button.
+
===Report No-shows, invalid cards, date changes  guest misconduct, request cancellations or restrict channel modifications===
 +
You will see buttons in the "Details" tab of the bookings which allow you to
 +
*Report No-shows
 +
*Report invalid cards
 +
*Report date changes 
 +
*Report guest misconduct
 +
*Request the booking to be cancelled
  
[[Image:booking15.png|450px|link=]]
+
If you do not want to allow channel modifications by default you can change the setting for "Allow Channel Modifications" value" in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER.
[[Media:booking15.png|view large]]
 
  
If for any reason your existing bookings do not import, the dates could be reopened and resold. To prevent this import the bookings via CSV.
+
===Info Codes for relevant information===
 +
Info Codes in the "Info" tab of the booking show you relevant information about the booking and the guest.
  
a. Export your bookings as CSV from booking.com
+
{| class="wikitable"
b. Go to https://api.beds24.com/csv/putbookingcomcsv.php and import the csv file to Beds24.
+
! scope="col"| Code
Follow the instructions on the page carefully so they import to the correct rooms.
+
! scope="col"| Use
 +
|-
  
If this is also unsuccessful, block the booked dates in the beds24 calendar. Please note that in this case cancellations and modifications will not be imported automatically.
 
  
 +
| BOOKINGCOMCARD
 +
| invalid card reported to Booking.com
 +
|-
  
2) Make sure your inventory is correct in Beds24. Check existing bookings in Booking.com imported and dates blocked by other sources are blocked in Beds24. Dates can be blocked by either entering a booking manually into Beds24 for those dates or using the inventory and override functions on the control panel calendar for those dates. Failure to do this could allow new bookings on dates you are not available. All available dates in Beds24 will be sent to Booking.com as available for new bookings.
 
  
[[Image:Booking_com_12.png|450px|link=]]
+
| BOOKINGCOMFLAG
[[Media:Booking_com_12.png|view large]]
+
| Booking.com general info flag (Genius/no credit card)
 +
|-
  
 +
| BOOKINGCOMVIRTCARD
 +
| Booking.com sent a virtual card
 +
|-
  
3) Enable the connection in Beds24 by ticking "Inventory and Rates" for each mapped room and saving. The "Bookings" checkbox should already be ticked but tick it as well if it is not ticked and bookings should be imported.
+
| BOOKINGCOMBANKTRANS
 +
| booking paid via bank transfer from Booking.com
 +
|-
  
[[Image:bookingcomactivate.png|450px|link=]]
+
|CARDTOSTRIPE
[[Media:bookingcmactivate.png|view large]]
+
| card details were sent to Stripe
 +
|-
  
4) When all the set up in Beds24 is correct you can make the final step to enable the connection (go live) from the Booking.com extranet.
+
|STRIPEPAYMENT
 +
| payment imported from Stripe
 +
|-
  
[[Image:bookingconfirm.png|450px|link=]]
+
|STRIPEFAIL
[[Media:bookingconfirm.png|view large]]
+
| card could not send to Stripe
 +
|-
  
5) When you go live your rates and inventory will be deleted from Booking.com and a full reload will occur from your Beds24 Inventory.
+
|CARDEXPIRES
 +
| added when the card expires before check-in
 +
|-
  
You can use the "Update" button on each room to speed this up. Your bookings will not be deleted from Booking.com but make sure the dates are blocked in Beds24 before going live so they will not be reopened.
+
|}
  
6) Once updated, check all your values in the Booking.com extranet for correctness and if required make any adjustments to the settings to fix.
+
===VAT value on extra items===
 +
If an extra item name in the booking matches the name of an upsell item for the property, the VAT value of the upsell item will be used.
 +
Otherwise, the VAT value defined in the Property booking rules will be used.
  
7) Channel collect payments will be shown in the booking invoice if SETTINGS->CHANNEL MANAGER -> “Import Channel Collect Payments”  is set to “Yes”.
+
===Different invoice templates ===
 +
If you need a different invoice template for the bookings from this channel you can use the [[Invoicees|invoicee]] function.
  
8) You can allow cancellation fees and commission values to overwrite booking values when cancelled by channel  if SETTINGS->CHANNEL MANAGER -> “IImport Cancel Fees”  is set to “Yes”.
+
==Reviews==
 +
To access Booking.com reviews from your DASHBOARD unlock the DASHBORAD click on the hamburger menu then on "Extentions" and add the Booking.com Review Module.
  
===Maximum number accepted bookings ===
+
==Create and manage Booking.com promotions==
By default all available rooms are sent to activated channels. In SETTINGS->CHANNEL MANAGER->CHANNEL INVENTORY limit the number of accepted bookings for this channel.
+
Promotions can be  created, modified and deactivated in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING-COM >PROMOTIONS. 
 +
 +
[[Booking.com:_Promotions|Click here for more information and setup instructions.]]
  
=== Check Connection ===
+
==Manage or add Booking.com Rate Plans==
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.
+
To manage your rate plans go to [[Booking.com:_Create_Booking.com_Rate_Plans_in_Beds24|{{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > BOOKING.COM > RATE PLANS]].  
 +
If you want to offer multiple price options for example a non-refundable rate or your rate plan contains meals you can also create additional rate plans.
  
=== Updates ===
+
==Limit the maximum number accepted bookings if you do not want to offer all rooms ==
Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays, or quantity of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
+
By default, all available rooms are sent to activated channels. In {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > CHANNEL INVENTORY limit the number of accepted bookings for this channel.
  
=== Setup Problems===
+
=Troubleshooting=
1) The room is being unexpectedly closed at booking.com
+
==Common issues==
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >"Room code is not unique" warning when saving in Beds24.
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Each Booking.com room id is unique and can be mapped to only one room in Beds24. If you enter the same Booking.com room id more than once the room updates will overwrite each other causing inaccurate information being sent to Booking.com which will cause overbookings.
 +
</div></div>
  
The channel manager will close the room on all dates which do not have a valid price available for sending to booking.com. Make sure you have prices for the complete range of dates you are sending (1 year or 2 years)
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >No Room codes are available</div>
 +
<div class="mw-collapsible-content">
 +
During the Setup of your connection, click on 'Get the Booking.com Room and Rate Codes for this "Property Code"'
  
2) "Room code is not unique" warning when saving in Beds24.
+
You will see the list of Rooms/Rate codes returned from Booking.com. If Booking.com does not make any rooms available. If you are sure you have rooms please forward the RUID to Booking.com support and ask them to check why they do not return any rooms.
 +
</div></div>
  
Each Booking.com room id is unique and can be mapped to only one room in Beds24. If you enter the same Booking.com room id more than once the room updates will overwrite each other causing inaccurate information being sent to Booking.com
+
<div class="mw-collapsible mw-collapsed">
 
+
<div  class="headline-collapse" >The room is being unexpectedly closed at Booking.com</div>
3) Missing Credit Card Details
+
<div class="mw-collapsible-content">
 +
The channel manager will close the room on all dates which do not have a valid price available for sending to Booking.com. Make sure you have prices for the complete range of dates you are sending (1 year or 2 years).
 +
</div></div>
  
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" > Messages from Auto actions are not visible in Booking.com message centre'''
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Ensure you do not have any special characters in the message text that could fail the Booking.com Security checks. (For example do not use * or @ in the message text).
 +
</div></div>
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >Credit card details are missing in Beds24
 +
</div>
 +
<div class="mw-collapsible-content">
 
When Booking.com sends the credit card number it will be available in the "Payments and Charges" tab of the booking unless it has been stored in a third party system such as Stripe.  
 
When Booking.com sends the credit card number it will be available in the "Payments and Charges" tab of the booking unless it has been stored in a third party system such as Stripe.  
 
The encoded CVC number is available from the booking notification email sent to the host as the line labelled Security Code. Enter the Security Code value from the email into the booking to view the CVC.
 
The encoded CVC number is available from the booking notification email sent to the host as the line labelled Security Code. Enter the Security Code value from the email into the booking to view the CVC.
  
*If there is no Security Code item in the host notification email, the CVC was not collected or sent for this booking. Please ask Booking.com to collect and send it to Beds24 if you require it.
+
*If there is no Security Code item in the host notification email, the CVC was not collected or sent for this booking. Booking.com may sometimes withhold the credit card number or CCV unless you specifically request they are sent to you. Contact your Booking.com rep if this is occurring and you require this information.
 
*If credit card details are always missing and you require them, please ask Booking.com to collect and send credit card details to Beds24
 
*If credit card details are always missing and you require them, please ask Booking.com to collect and send credit card details to Beds24
 
*If Booking.com normally sends credit card details but did not do so for a specific booking and you always want a card as security, please ask Booking.com to exclusively accept bookings with a credit card number.
 
*If Booking.com normally sends credit card details but did not do so for a specific booking and you always want a card as security, please ask Booking.com to exclusively accept bookings with a credit card number.
 +
</div></div>
  
4) Daily prices and prices for the Room, Double and Single occupancy can be mapped to Booking.com.
+
<div class="mw-collapsible mw-collapsed">
 
+
<div  class="headline-collapse" >Deleting a rate or price in Beds24 will not delete the price in Booking.com
These can be mapped to Booking.com rate id's and will use the booking conditions of that rate id. Extra person and extra child prices within a Beds24 Rate and discounts set in a Rates Discount section are not able to export to Booking.com or other channels.
+
</div>
 
+
<div class="mw-collapsible-content">
=== Notes===
+
If you need to close a rate at Booking.com, make the rate id unbookable at Beds24, for example by closing the room or removing the price and wait for it to update at Booking.com. Only once the rate has closed at Booking.com it is safe to remove it from Beds24.
1) Credit card details are imported and shown on the "INVOICE" tab of the booking. If not please refer to "Missing Credit Card Details" in Setup Problems above.
 
 
 
2) Multiple Rates - if you want to send multiple prices for a room you must have a rate id for each rate in Booking.com and a matching rate with the price and rate id setup in Beds24. See the Multiple Rates section above for more details.
 
 
 
3) Single occupancy prices must be activated within booking.com if you are sending them to multi person room rates. They can be disabled by setting "Rates" = "Full Only"
 
 
 
4) For bookings imported through the button "Import upcoming bookings" Booking.com will only send a summary of the booking, not the full information. The full information can still be accessed in the Booking.com extranet. New bookings made after activation will include full booking information.
 
 
 
5) Deleting a rate or price in Beds24 will not delete the price in Booking.com. If you need to close a rate at Booking.com, make the rate id unbookable at Beds24, for example by closing the room or removing the price and wait for it to update at Booking.com. Only once the rate has closed at Booking.com it is safe to remove it from Beds24.
 
  
 
You can close a rate at booking.com by making sure there is no price for it on the dates to close in Beds24.
 
You can close a rate at booking.com by making sure there is no price for it on the dates to close in Beds24.
Line 256: Line 421:
  
 
Note that if there is no price on any day at all for a rate, this will not necessarily close the rate, in this case no information will be sent and whatever data is in Booking.com will remain.
 
Note that if there is no price on any day at all for a rate, this will not necessarily close the rate, in this case no information will be sent and whatever data is in Booking.com will remain.
 +
<span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span>  <span style="font-weight: bold;" >Tip</span>  Click on the "View Price Data" Button to check which prices and availability will send.
 +
</div></div>
  
You can always see the data being sent with the "View Actual Data" button in the channel manager.
+
==Error messages==
 
 
6) Bookings with payment collected by booking.com will show the payment amount collected as a payment in the booking invoice.
 
 
 
=Manage Bookings=
 
===Report No-shows, Invalid cards or Restrict Channel Modifications===
 
This screenshot shows specific settings for bookings from Booking.com:
 
 
 
[[Image:bookingcom_manage.png|800px|link=]]
 
[[Media:bookingcom_manage.png|view large]]
 
 
 
If you want to not allow channel modifications by default you can change the setting for "Allow Channel Modifications" value" in SETTINGS->CHANNEL MANAGER.
 
 
 
If you need a different invoice template for the bookings from this channel you can use the [[Invoicees|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.
 
 
 
<embedvideo service="youtube">https://youtu.be/qfwM2SiiLI8</embedvideo>
 
 
 
===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
 
 
 
If you manually charge virtual credit cards please note that they can only be charged when they become valid.
 
 
 
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.
 
 
 
=Disconnect=
 
*Unticking "Inventory and Prices" and "Bookings" will stop Beds24 sending data to Booking.com. This will not remove the data from Booking.com and it will still be bookable.
 
*To completely disconnect the channel manager please log into your Booking.com extranet and click on the Account icon in the top right-hand corner. Select Channel Manager from the drop-down menu. Click the Deactivate button to cancel the connection to Beds24.
 
 
 
=Common Errors=
 
 
Any errors reported by  Booking.com will be emailed to you with the error message as returned by Booking.com.  
 
Any errors reported by  Booking.com will be emailed to you with the error message as returned by Booking.com.  
 
The error message usually includes information about the date, rate or room with the problem and a brief description.
 
The error message usually includes information about the date, rate or room with the problem and a brief description.
 
Below are common error messages and how to fix them.
 
Below are common error messages and how to fix them.
  
  '''Access denied while trying to get rooms for hotel XXXXXX '''
+
<div class="mw-collapsible mw-collapsed">
Check if you have received a notification from Booking.com that the connection is ready.  
+
<div class="headline-collapse" > Hotel access denied</div>
*If not please check in the Booking.com extranet that the connection has been requested.  
+
<div class="mw-collapsible-content">
*If yes please check the Booking.com hotel id you have entered is correct and does not have blank spaces.
+
Check if you have received a notification from Booking.com that the connection is ready.  
*If your connection is set up check if you confirmed the connection in your Booking.com Extranet as explained under „Activation“ step 4:
+
*If not please check in the Booking.com extranet that the connection has been requested.  
 +
*If yes please check the Booking.com hotel id you have entered is correct and does not have blank spaces.
 +
*Click on "Connection Status" to check that the connection is properly activated.
 +
</div></div>
  
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" > OBP_PRICING_PASSED_FOR_
 +
LOS_RATE, OBP_PRICING_PASSED_FOR_RLO_RATE, OBP_PRICING_PASSED_FOR_DEFAULT_RATE, OBP_PRICING_PASSED_FOR_SINGLE_USE_RATE</div>
 +
<div class="mw-collapsible-content">
 +
Send us a Support Ticket, so we can correct your pricing model.
 +
</div></div>
  
  '''Access denied'''
+
<div class="mw-collapsible mw-collapsed">
Log into Booking.com and activate the connection as described under "Activate" step 4 and make sure you have confirmed the connection with Beds24..
+
<div class="headline-collapse" > INVALID_USE_OF_SINGLE_OCCUPANCY</div>
 +
<div class="mw-collapsible-content">
 +
Booking.com does not allow you to send a single price.
 +
Go to {{#fas:cog}} (SETTINGS)  > BOOKING.COM > MAPPING and set "Booking.com Pricing Model"= Per Day Pricing
 +
</div></div>
  
  '''Updating availability hasn't been enabled for hotel 0000'''
+
<div class="mw-collapsible mw-collapsed">
  You have not activated the connection in the booking.com extranet. Please log into your booking.com extranet and activate the connection.
+
<div class="headline-collapse" > NOT_A_VALID_OCCUPANCY</div>
 +
<div class="mw-collapsible-content">
 +
Check that "Max guests" set in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP is the same as the occupancy you have set for the room in your Booking.com extranet.
 +
</div></div>
  
  '''Not allowed to update Single Use Rate for Room'''
+
<div class="mw-collapsible mw-collapsed">
Booking.com have not activated a single occupancy price for the room.
+
<div class="headline-collapse" > WARN_PRICE_TOO_LOW_LIMIT and WARN_PRICE_TOO_HIGH_LIMIT
Either ask Booking.com to allow a single price or set "Booking.com Rate Type"= One Price
+
</div>
 +
<div class="mw-collapsible-content">
 +
Booking.com considers the price you want to send varies significantly from the prices which are already in Booking.com, or if it’s outside the accepted threshold – the minimum being €5 and the maximum being €50,000 (or the equivalent in the local currency).
  
'''Rooms to Sell were set below the Minimum Contracted rooms for these dates'''
+
Either adjust your price in Beds24 or try to change the limitation at Booking.com
You have agreed to supply a minimum number of rooms to Booking.com on the mentioned dates and Beds24 is trying to update them to a number lower than your agreed minimum. Booking.com have ignored the Beds24 values on those dates and used your agreed minimum instead.
+
</div></div>
*Make sure you have valid rates for the mentioned dates and no bookings from other sources
 
*Beds24: change your inventory to send the allotment you have guaranteed Booking.com
 
*Booking.com: Ask Booking.com to remove the guaranteed allotment
 
  
  '''Rate is not active'''
+
<div class="mw-collapsible mw-collapsed">
You do not have an active Booking.com rate id with this number. Please double check your rates and daily prices and select a valid Booking.com rate id from the list in 'get codes'.
+
<div class="headline-collapse" > Not allowed to update Single Use Rate for Room''' or '''CANNOT_SET_SINGLE_USE_RATE
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Booking.com have not activated a single occupancy price for the room.
 +
Either ask Booking.com to allow a single price (set up a "Single" rate id) or set "Booking.com Rate Type" = Per Day Pricing
 +
 +
If it is a dorm: Booking.com requires the bed price be sent to them as the room price. Therefore they do not accept a single price for a dorm. Set "Booking.com Rate Type" = Per Day Pricing and make sure to set your prices in all rates as a room price (and not as a single price).
 +
</div></div>
  
  '''Room is not active'''
+
<div class="mw-collapsible mw-collapsed">
Booking.com has not activated the room for selling. Please ask Booking.com to activate it and check the room id  is correct.
+
<div class="headline-collapse" > Rate is not active''' or '''RATE_NOT_ACTIVE''' or '''RATE_NOT_ACTIVE_FOR_ROOM''' or '''RATE_DOES_NOT_EXIST'''</div>
 +
<div class="mw-collapsible-content">
 +
You do not have an active Booking.com rate id with this number. You can only update Booking.com Rate Plans which show when you click on 'Get codes'.
 +
*Go to Prices > Channel Mapping enter the code from the error message Search box and click on the price and and select and ID which you see when you click 'Get codes'.
 +
*Please double check your Fixed prices and Daily prices and select a valid Booking.com rate id from the list in 'get codes'. You can only send prices for active Booking.com rate codes.  
 +
</div></div>
  
  '''Rate 123456 cannot be updated via XML'''
+
<div class="mw-collapsible mw-collapsed">
This rate has not been activated for channel management. Ask Booking.com to activate it.  
+
<div class="headline-collapse" > '''Room is not active''' or '''ROOM_NOT_ACTIVE''' or '''ROOM_ID_INVALID'''</div>
 +
<div class="mw-collapsible-content">
 +
You can only update rooms which show when you click on 'Get codes'.
 +
If you do have a room with this ID ask Booking.com to activate it. It is activated when you see it when you click on "Get Codes".
 +
</div></div>
  
  '''Did not set Close Room 'XY for Rate Category 'ZZ' because of remaining Minimum Contracted Rooms on dates.....'''
+
<div class="mw-collapsible mw-collapsed">
You have guaranteed and to have a minimum number of rooms to sell on Booking.com but the channel manager is sending a lower quantity than contracted.
+
<div class="headline-collapse" > RATE_IS_A_SLAVE_RATE</div>
*Make sure you have valid rates for the mentioned dates and no bookings from other sources
+
<div class="mw-collapsible-content">
*Beds24: change your inventory to send the minimum contracted rooms you have guaranteed Booking.com
+
You cannot set occupancy_price for a child rate 123456789, since they are automatically set based on Rate Relations.  
*Booking.com: Ask Booking.com to remove the minimum contracted rooms
 
  
'''Rate does not exist'''
+
You cannot set closed_as_last_night for a child rate 123456789, since they are automatically set based on Rate Relations /message
You have added a number which is not a valid Booking.com rate id into the field in the "Channels" tab of a rate/daily price.  
+
It is not possible to send prices for this rate plan as it is Derived/calculated from another Rate Plan by Booking.com.
*Open your rates (Channel Tab) and make sure the correct booking.com rate id is selected from the 'get codes' list.
+
*'''Option 1'''
*Open your daily prices (Enable list) and make sure the correct booking.com rate id is selected from the 'get codes' list.  
+
*Go to Booking.com Extranet, go to Rates & Availability and click 'Edit' on the Rate id identified in the error message, then 'Edit' the Price, and select 'Setup as a new rate plan'. Click Save. View the details in this short video :- https://screenpal.com/watch/c0lV6CVmFNd
 +
*'''Option 2'''
 +
*Go to {{#fas:cog}} (SETTINGS) > BOOKING.COM > MAPPING and select a valid Rate Plan id from the 'get codes' list.  
 +
*Go to Prices > Channel Mapping enter the Rate id in the Search box and click on the Daily Price/Rate and make sure the correct booking.com rate id is selected from the 'get codes' list.  
 +
*Go to Prices > Channel Mapping enter the Rate id in the Search box and click on the Daily Price/Rate untick Booking.com and remove the Rate plan id.
 +
</div></div>
  
  '''hotel 'xxxxx' not allowed for user 'Beds24ProductionServer''''
+
<div class="mw-collapsible mw-collapsed">
  Check if you have received a notification from Booking.com that the connection is ready.  
+
<div class="headline-collapse" > RATE_EDITABLE_ONLY_ON_EXTRANET</div>
*If not please check in the Booking.com extranet that the connection has been requested.  
+
<div class="mw-collapsible-content">
*If yes please check the Booking.com hotel id you have entered is correct and does not have blank spaces.
+
You are trying to update a non-XML rate. Log into your Booking.com extranet remove the rate.
 +
</div></div>
  
  '''hotel 'xxxxx' not allowed for user BA-bookingautomationadmin''''
+
<div class="mw-collapsible mw-collapsed">
  Check if you have received a notification from Booking.com that the connection is ready.
+
<div class="headline-collapse" > Room reservation does not belong to this hotel reservation</div>
*If not please check in the Booking.com extranet that the connection has been requested.  
+
<div class="mw-collapsible-content">
*If yes please check the Booking.com hotel id you have entered is correct and does not have blank spaces.
+
The booking was already cancelled in Booking.com before the Channel synchronisation.
 +
</div></div>
  
  '''rate is not active'''
+
<div class="mw-collapsible mw-collapsed">
  You are trying to send prices for a Booking.com rate code which is not active. You can only send prices for active Booking.com rate codes. You will see your active rate codes when you click on "Get Codes". Make sure you only map these rates in you channel manager settings, daily prices and rates.
+
<div class="headline-collapse" > Message thread not found</div>
 +
<div class="mw-collapsible-content">
 +
There are two possible reasons:
  
  '''rate does not exist'''
+
1. The Booking.com connection for the property does not allow the use of the messaging API.
  You are trying to send prices for a Booking.com rate code which does not exist. You can only send prices for active Booking.com rate codes. You will see your active rate codes when you click on "Get Codes". Make sure you only map these rates in you channel manager settings, daily prices and rates.  
+
  Please log into Booking.com and and go to ACCOUNT > CONNECTIVITY PROVIDER. Disconnect from Beds24 and reconnect this time ticking all tick boxes as shown here: https://wiki.beds24.com/images/6/69/Extranet-booking.png
 +
 +
2. You have assigned or moved the booking into a room that is in a different property than originally booked. If you want to use messaging with Booking.com you can move/assign booking only to rooms in the same property as the one originally booked.
 +
</div></div>
  
  '''room/rate combination is not active'''
+
<div class="mw-collapsible mw-collapsed">
Your codes are not correctly mapped. Check you have entered the right Booking.com mapping codes.
+
<div class="headline-collapse" > Failed to post message: Message content failed to pass security filters</div>
 +
<div class="mw-collapsible-content">
 +
Ensure you do not have any special characters in the message text that could fail the Booking.com Security checks. (For example do not use * or @ in the message text).
 +
</div></div>
  
'''Not allowed to update Single Use Rate for Room'''
+
<div class="mw-collapsible mw-collapsed">
  Booking.com requires the bed price be sent to them as the room price. Therefore they do not accept a single price for a dorm. Set "Booking.com Rate Type"= One Price. If you want to send a single price for other rooms ask Booking.com to set up a "Single" rate id for these.
+
<div class="headline-collapse" >Message failed to send to reservation 12345678 - content or attachment is required</div>
 +
<div class="mw-collapsible-content">
 +
There are two possible reasons:
  
'''Room reservation does not belong to this hotel reservation'''
+
1. There is no content in the language of the Guest (OR the default language you have set for your account,) in the Messaging tab of the auto action that you triggered for this booking.
The booking was already cancelled in Booking.com before the Channel syncronisation.
+
*Open the booking go to the Mail & Action tab and check the guest language.
 +
*Open the auto action and ensure you have text in the Subject, Plain Text Field and HTML Field.  
  
=Notes=
+
2. Auto action should not send a message to the guest, go to the Messaging tab in the Auto action and set 'Sending Message' = NO (or Internal)
 +
</div></div>
  
1) Credit card details are imported and shown on the "INVOICE" tab of the booking. If not please refer to "Missing Credit Card Details" in Setup Problems above.  
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >This account doesn't have access to this property.","code":"FORBIDDEN"</div>
 +
<div class="mw-collapsible-content">
 +
Log into Booking.com and go to ACCOUNT > CONNECTIVITY PROVIDER. Disconnect from Beds24 and reconnect this time ticking all tick boxes as shown here: https://wiki.beds24.com/images/6/69/Extranet-booking.png
  
2) Multiple Rates - if you want to send multiple prices for a room you must have a rate id for each rate in Booking.com and a matching rate with the price and rate id setup in Beds24. See the Multiple Rates section above for more details.
+
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> If you use dependencies you can only assign the bookings into a room in the same property as the room which is mapped to Booking.com.
 +
</div></div>
  
3) Single occupancy prices must be activated within booking.com if you are sending them to multi person room rates. They can be disabled by setting "Rates" = "Full Only"
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >You cannot mark credit card as invalid since the property has not passed trust verification checks'''</div>
 +
<div class="mw-collapsible-content">
 +
Booking.com does not allow you to mark credit cards as invalid because you have not passed their trust verification process. Please contact your Booking.com Account Manager.
 +
</div></div>
  
4) For bookings imported through the button "Import upcoming bookings" Booking.com will only send a summary of the booking, not the full information. The full information can still be accessed in the Booking.com extranet. New bookings made after activation will include full booking information.
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >Connections to fix: 0</div>
 +
<div class="mw-collapsible-content">
 +
Booking.com incorrectly show this error in the Booking.com Extranet. There is no problem at all and you should ignore the rest of the text on the screen.
 +
</div></div>
  
5) Deleting a rate or price in Beds24 will not delete the price in Booking.com. If you need to close a rate at Booking.com, make the rate id unbookable at Beds24, for example by closing the room or removing the price and wait for it to update at Booking.com. Only once the rate has closed at Booking.com it is safe to remove it from Beds24.
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >OCCUPANCY_EXCEEDS_MAX_PERSONS</div>
 +
<div class="mw-collapsible-content">
 +
Room 12345678 has a maximum occupancy of 4. You cannot set an occupancy_price for an occupancy of 5 for rate 123456783
  
You can close a rate at booking.com by making sure there is no price for it on the dates to close in Beds24.
+
Check that "Max guests" set in {{#fas:cog}} (SETTINGS)  PROPERTIES > ROOMS > SETUP is the same as the occupancy you have set for the room in your Booking.com extranet.
As long as the rate has at least a price for 1 day in the next year, all the other dates without prices will be closed.
+
</div></div>
  
If you have multiple rates at booking.com, the other rates can continue to be available by giving them prices.
+
=Disconnect=
 +
*Set 'Enable' to 'Disable' this will stop Beds24 sending data to Booking.com. This will not remove the data from Booking.com and it will still be bookable.
 +
*To completely disconnect the channel manager please log into your Booking.com extranet and click on the Account icon in the top right-hand corner. Select Channel Manager from the drop-down menu. Click the Deactivate button to cancel the connection to Beds24.
  
Note that if there is no price on any day at all for a rate, this will not necessarily close the rate, in this case no information will be sent and whatever data is in Booking.com will remain.
+
= FAQ =
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" > I have multiple Booking.com hotel ids. How do I set this up?'''
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Beds24 can handle multiple properties in one account. You will need a property in Beds24 for each property you have on Booking.com so you can connect them so each Booking.com property ID or hotel ID requires one property in Beds24.
 +
</div></div>
  
You can always see the data being sent with the "View Actual Data" button in the channel manager.
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >I have multiple Booking.com accounts. How do I set this up? '''
 +
</div>
 +
<div class="mw-collapsible-content">
 +
The system can handle multiple properties in one account. It doesn't matter whether the Booking.com properties are in different Booking.com accounts.  
 +
</div></div>
  
6) Bookings with payment collected by booking.com will show the payment amount collected as a payment in the booking invoice.
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >Will I receive notifications on new bookings?
 +
</div>
 +
<div class="mw-collapsible-content">
 +
After you activate the channel manager the channel will stop sending notifications. You will receive an Email notification from Beds24 instead and you will also see new bookings on your dashboard provided you use the "Latest Bookings" module.  
 +
</div></div>
  
= FAQ =
+
<div class="mw-collapsible mw-collapsed">
=== Will I receive notifications on new bookings?===
+
<div  class="headline-collapse" > Do guests receive a confirmation?'''
After you activate the channel manager the channel will stop sending notifications. You will receive them from Beds24 instead.
+
</div>
 +
<div class="mw-collapsible-content">
 +
The channel confirms the booking with the guest. Beds24 will not sent an additional confirmation message to the guest. If you want to send an additional confirmation or welcome message for the guest you can set up an Auto Action Email.
 +
</div></div>
  
=== Do guests receive a confirmation? ===
+
<div class="mw-collapsible mw-collapsed">
The channel confirms the booking with the guest. Beds24 will not sent a confirmation message. If you want to send one as well you can set up an Auto Action Email.
+
<div  class="headline-collapse" > How do I modify or cancel a booking?'''
 +
</div>
 +
<div class="mw-collapsible-content">
 +
You can request Booking.com to cancel the booking or report changed stay dates from the "Details" tab of the bookings.
  
=== How do I modify or cancel a booking?===
+
Otherwise bookings coming from a channel should be modified by the channel. Just changing the status of a booking in Beds24 to "Cancelled"  will not cancel the booking in Booking.com and can cause a double booking.
Bookings coming from a channel should be modified by the channel. Cancelling a booking in Beds24 will not cancel the booking in Booking.com and can cause a double booking. Please ask booking.com or the guest to cancel the booking in Booking.com and the cancellation will be sent to Beds24.  
 
  
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"). If you have changed the room you can set "Allow Channel Modifications" = All but not room changes.
+
If for some reason you need to make a change in Beds24 and do not want an update from the channel to override it, you can set "Allow Channel Modifications" = No ("Details" tab of the booking"). If you have changed the room you can set "Allow Channel Modifications" = All except room changes. If you do this you will need to manage all changes manually.
 +
</div></div>
  
=== How do can I access credit card details?===
+
<div class="mw-collapsible mw-collapsed">
This is how you can [[View_Credit_Card_Details| view credit card details]]. Booking.com may sometimes withhold the credit card number or CCV unless you specifically request they are sent to you. Contact your Booking.com rep if this is occurring and you require this information to always be sent.
+
<div  class="headline-collapse" > How can I access credit card details?'''
 +
</div>
 +
<div class="mw-collapsible-content">
 +
This is how you can [[View_Credit_Card_Details| view credit card details]]. Booking.com may sometimes withhold the credit card number or CCV unless you specifically request they are sent to you. Contact Booking.com support if this is occurring and you require this information to always be sent.
 +
</div></div>
  
=== How do I add a promotion or special price?===
+
<div class="mw-collapsible mw-collapsed">
You can set up promotions directly in Beds24 or in the Booking.com extranet.  
+
<div  class="headline-collapse" > How do I add a promotion for Booking.com?'''
 +
</div>
 +
<div class="mw-collapsible-content">
 +
You can set up promotions directly in Beds24 in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > BOOKING.COM > PROMOTIONS or in the Booking.com extranet.
 +
</div></div>
  
=== How do I add extra costs or fees?===
+
<div class="mw-collapsible mw-collapsed">
Extra Costs, e.g. tax, cleaning fee, service charge can be set directly in the channels extranet.  
+
<div  class="headline-collapse" > How do I add extra costs or fees?'''
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Extras taxes and fees will not automatically send or update. Set/change these in your Booking.com Extranet unless you want to manage your full Booking.com content from Beds24.
 +
*Changes to availability and prices will be instantly sent to the channel. Chang
 +
</div></div>
  
=== Can I send different prices for different minimum stays or for different numbers of guests?===
+
<div class="mw-collapsible mw-collapsed">
Yes. You can do this either with "derived" prices or multiple rates ids. See the "Multiple rates" section of this page.  
+
<div  class="headline-collapse" > Can I send different prices for different minimum stays or for different numbers of guests?'''
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Yes. With "Occupancy Prices (OBP) Beds24 will send prices for each occupancy you have defined in your prices. If you have different prices for different minimum stays Beds24 will send these.
 +
</div></div>
  
=== I have multiple Booking.com hotel ids. How do I set this up? ===
+
<div class="mw-collapsible mw-collapsed">
The system can handle multiple properties in one account. Each Booking.com hotel requires one property in Beds24.
+
<div  class="headline-collapse" > What to do when I receive an overbooking?'''
 
+
</div>
=== I have multiple Booking.com accounts. How do I set this up? ===
+
<div class="mw-collapsible-content">
The system can handle multiple properties in one account. It doesn't matter whether the Booking.com properties are in different Booking.com accounts. Each Booking.com property still requires one property in Beds24, though.
 
 
 
=== 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.  
 
*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 Booking.com room code in multiple rooms in Beds24 can cause overbookings. Check your set up for warnings.  
 
*Entering the same Booking.com room code in multiple rooms in Beds24 can cause overbookings. Check your set up for warnings.  
 +
*If you have  Auto-Replenishment enabled, Booking.com will not wait for the update sent from Beds24 but will automatically re-open the closed room when a guest cancels even if you have a booking from another source. You can opt-out of the feature by following these steps:
 +
**Log into your Booking.com account
 +
**Click on the Rates & Availability tab
 +
**Go to the Settings symbol on the top-right corner of your Calendar
 +
**Click on Auto-Replenishment
 +
**Under Calendar Settings, click "No" to turn off the Auto-Replenishment feature
  
 
If you can not see a problem in your set up send us a support ticket with the booking numbers and dates.
 
If you can not see a problem in your set up send us a support ticket with the booking numbers and dates.
 +
</div></div>
  
=== Why did a booking not import?===
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" > Why did a booking not import?'''
 +
</div>
 +
<div class="mw-collapsible-content">
 
*Check if the room for which you received the booking is properly mapped.  
 
*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.
 
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.
 +
</div></div>
  
=== Why is the price for the booking wrong?===
+
<div class="mw-collapsible mw-collapsed">
*A special offer set up in the channel may have reduced the price the channel manager sent.
+
<div  class="headline-collapse" >Why is the price for the booking wrong?'''</div>
 +
<div class="mw-collapsible-content">
 +
Possilbe reasons:
 +
*Check if you have set up promotions or linked Prices in Booking.com. These will reduce the price the channel manager sent.
 
*Your prices are not set up as you expect.
 
*Your prices are not set up as you expect.
 +
</div></div>
  
=== What are contracted rooms? ===
+
<div class="mw-collapsible mw-collapsed">
This is an agreement between you and the channel where you agree to provide a number of rooms exclusively to that channel. This means you will not be able to sell these rooms directly or on other channels.
+
<div  class="headline-collapse" > What do I do when I have a no show?'''</div>
 
+
<div class="mw-collapsible-content">
=== What do I do when I have a no show?===
 
 
To report a no show to Booking.com open the booking and click the button in the "Details" tab.
 
To report a no show to Booking.com open the booking and click the button in the "Details" tab.
 +
</div></div>
  
=== What do I do when a guest provides an invalid credit card number?===
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" > What do I do when a guest provides an invalid credit card number?'''</div>
 +
<div class="mw-collapsible-content">
 
Invalid cards can be reported to Booking.com via a button on the "Details" tab of the booking.
 
Invalid cards can be reported to Booking.com via a button on the "Details" tab of the booking.
  
If you use Stripe you can set in SETTINGS->CHANNEL MANAGER to automatically report invalid cards to Booking.com.
+
If you use Stripe you can set in {{#fas:cog}} (SETTINGSCHANNEL MANAGER to automatically report invalid cards to Booking.com.
 +
</div></div>
  
=== I originally set my connection as a one-way connection, now I want a two-way connection===
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" > I accidentally set my connection as a one-way connection, now I want a two-way connection'''</div>
 +
<div class="mw-collapsible-content">
 
You will need to disconnect your connection with Beds24 in the Booking.com extranet and then initiate the connection with two-way connection.
 
You will need to disconnect your connection with Beds24 in the Booking.com extranet and then initiate the connection with two-way connection.
 +
</div>

Latest revision as of 15:35, 4 October 2024


Booking.com: Synchronize Bookings, Prices and Availability
This page is about the menu   (SETTINGS) CHANNEL MANAGER > BOOKING.COM  > MAPPING and explains how to export prices, availability, rules and import bookings, modifications to bookings and cancellations for existing listings on Booking.com
Use these instructions if you want to import properties from Booking.com to Beds24.

When all of your prices, and rooms are set up in Beds24 you can start the integration with Booking.com:

  1. Initiate the connection in Booking.com
  2. Map your rooms and Booking.com rate plans
  3. Set the rooms you want to sync to "Enable"
  4. Import all upcoming bookings
  5. Check what will send to Booking.com
  6. Activate the connection

Read the complete instructions before you start the integration.

Use these instructions if you want to import properties from Booking.com to Beds24.

1 What you should know and do before getting started

As a longstanding Booking.com Premier Partner Beds24 can offer you advanced functionality and many convenience functions. Once set up you can manage everything directly from Beds24 which will save you time and make working with Booking.com really easy.

Learn how the channel manager works.

If you want to export inventory (availability) Booking.com demands prices to be sent from Beds24 so you will not be able to set prices the Booking.com extranet after the connection has been enabled.

All of your prices, rooms, and bookings from other sources must be set up in Beds24 before you connect:

  • The prices you want to send to Booking.com need to have Booking.com activated under "Channels"
  • Beds24 can not import past booking from before Booking.com was connected as a distribution channel. You can add these manually in the Calendar, via the "Add booking" button at the top or import them from a .csv file in (SETTINGS) > PROPERTIES
  • Your rooms and room types in Beds24 have to match your set up in Booking.com. If you sell rooms individually at another channel or your own website and want to sell them on Booking.com as a "room type" with a quantity of more than one you can set up virtual rooms.

1.1 Capabilities and Limitations

With this connection you can:

  • send prices and availability
    • send multiple prices
    • add a multiplier to mark prices up or down
    • create Booking.com rate plans if you want to add additional pricing options
  • send restrictions
    • send minimum stay
    • send maximum stay
    • send closed to arrival and closed to departure
  • import and manage bookings
    • import new bookings, modifications to bookings and cancellations (importing modifications or cancellations can be disabled for individual bookings)
    • report no-shows date changes and guest misconduct to Booking.com
    • report invalid cards to Booking.com. If you use Stripe you can set to automatically report invalid cards to Booking.com (go to (SETTINGS) CHANNEL MANAGER to activate this option)
  • create and manage Booking.com promotions
  • view reviews and react to reviews

Limitations:

  • Extras taxes and fees will not automatically send or update. Set/change these in your Booking.com Extranet unless you want to manage your full Booking.com content from Beds24.
  • Beds24 imports only confirmed bookings. If you have set to only accept "Requests" you will need to accept the booking in your Booking.com extranet and they will import once they are confirmed.
  • Changes to availability and prices will be instantly sent to the channel. Changes to settings for example minimum stays, or quantity of rooms or the multiplier will send with the next update but you have the option to push them manually if you require an instant update.

1.2 Prices for Booking.com

Our connection with Booking.com supports Occupancy Pricing (OBP) so Beds24 can send a price for each occupancy defined in your prices in Beds24. We will automatically set all newly connected properties to "Occupancy Pricing (OBP)" which also allows you to just send one price per day for the full occupancy.

  • If you use Daily Prices, a price for each date and occupancy will be sent. Multiple occupancy prices can send on each rate plan. Extra person price in the daily price will send. See this tutorial on how to use daily prices.
  • If you use Fixed Prices, 1 person, 2 person and room price will send. The room price will send for specified occupancy. Multiple fixed prices with different occupancies can send on same rate plan. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the Fixed Prices can not be sent.
  • If you currently use RLO (derived) prices for different occupancies on Booking.com:
    1. If you want to keep RLO pricing, the Beds24 prices you want to send to Booking.com need to to be the right price for "base number of guests" in Booking.com so Booking.com can calculate correctly.
    2. If you want to send prices for different occupancies from Beds24, contact Booking.com and ask them to remove all linked prices. Then change your pricing model in Beds24 to "Occupancy Pricing".

Prices for dorms

For dorms Booking.com requires the bed price be sent to them as the room price. They do not accept a single price for a dorm. Therefore we will have to manually adjust your pricing model. If you want to send a single price for other rooms you can create additional rate plans for single use in (SETTINGS) CHANNEL MANAGER->BOOKING.COM > RATE PLANS.

2 Connect a property on Booking.com to a property in Beds24 to synchronize prices, availability and bookings

This channel has a very specific activation process that must be followed carefully. Click on "Expand" to view the details for each step.

Step 1: Initiate the connection in Booking.com

1. Click on the "Connect to Booking.com" button to login to Booking.com then go to ACCOUNT > CONNECTIVITY PROVIDER. If you have a Booking.com group account log to Booking.com and go to ACCOUNT > CONNECTIVITY PROVIDER and select Beds24 as channel manager from there.

2. Search for Beds24.

3. Tick all tick boxes.

4. Complete the rest of the on screen instructions.

Extranet-booking.png view large

For a two-way connection you need to select both "Reservations" and "Rates and Availability". Beds24 can then export inventory to Booking.com and import bookings from Booking.com. If you select only "Reservations" or only "Rates and Availability" you only have a "one-way" connection meaning the action you did not select must be manually maintained by you.

Step 2: Enter your Booking.com property ID

  1. Copy your Booking.com hotel ID and paste it into the "Hotel Id " field
  2. Press SAVE

Step 3: Map your rooms

  1. Click on the "Get Codes" link next to the room id setting, a list of room Ids will be retrieved from Booking.com and displayed
  2. Choose the Booking.com room you want to map to the Beds24 room and click on it
  3. Check the correct room Id has been copied to the room id setting
  4. Press Save

Step 4: Map your Booking.com rate plans

1. If you have only one Booking.com rate plan

  1. Click on the "Get Codes" link next to the rate id setting and a list of rate Ids will be retrieved from Booking.com for the saved room id
  2. Choose the Booking.com rate plan and click on it
  3. Check the rate plan Id has been copied to the rate plan Id setting
  4. Press SAVE

2. If you have more than one Booking.com rate plan

  1. Click on the "Get Code" link next to the rate id setting and a list of rate Ids will be retrieved from Booking.com for the saved room id
  2. Choose the Booking.com standard rate plan
  3. Check the rate plan Id has been copied to the rate plan Id setting
  4. Press Save
  5. Open the prices (PRICES > Daily Prices/Fixed Prices) which you want to send your other Booking.com rate plans
  6. Click on "Get Codes" and choose the Booking.com rate plan you want to update with this price
  7. Check the rate plan Id has been copied to the rate plan Id setting
  8. Press SAVE
You can only map the rate plans Booking.com makes available when you click on "Get Codes". Do not enter any other numbers. Linked prices (slave or child rate plans) on Booking.com i.e. for refundable/non refundable options can not update from Beds24. Deactivate these in Booking.com

Step 5: Enable rooms

  1. Scroll down to the rooms and set "Enable" = Enabled
  2. If you have multiple room types repeat for each room
  3. Press SAVE

Step 6: Set a multiplier to mark your prices up or down or for currency conversion (optional)

You can add a multiplier to your prices, add a * followed by the multiplier number in the "Multiplier" field

Examples:

  • *1.23 will multiply all prices by 1.23 (i.e. raised by 23%).
  • Lower prices can be sent with a multiplier less than 1: *0.85 will send 85% of the normal price (i.e. lowered by 15%).
  • To convert the price of bookings imported from the channel add a * AFTER the multiplier. *1.23* will divide the price of the booking by 1.23.
  • For currency conversion you can also use currency conversion template variables. All currencies supported by the booking page currency selector can be used.
    • *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
    • *[CONVERT:IDR-EUR]* will convert Indonesian Rupees to Euros and back to Indonesian Rupees on the import.

Step 7: Import upcoming bookings

  1. Click on the "Import Existing Bookings" button to import upcoming bookings from Booking.com. We can then import 10 bookings. Repeat if you have more
  2. If you have bookings from Airbnb and/or Expedia you can import them directly from the channel as well
  3. If you have bookings from other sources you can add these manually in the Calendar, via the "Add booking" button at the top or import them from a .csv file in (SETTINGS) > PROPERTIES
  4. If you want to close additional dates or limit check-in and/or check-out you can use the "Override" function in the Calendar

Step 8: Check what will send to Booking.com

  1. Click on the "Price Data" Button to check which prices and availability will send.
  2. If you have multiple room types repeat for each room.

Step 9: Activate the connection

When you activate the connection Booking.com will remove your prices and availability from their system and replace them with the prices and availability sent from the channel manager.

You can activate the connection when your mapping and prices are correct and you have added all upcoming bookings.

  • Press "Activate Connection" and then "Activate Connection Now".
If you have dorms: Do not activate the connection yourself. Please send us a support ticket in which you explain that you have dorms with Booking.com. We will then manually adjust your settings so the connection can work.
Step 10: Remove Auto-Replenishment (optional)

Beds24 will automatically reopen rooms when you have availability. If you have Auto-Replenishment enabled, Booking.com will not wait for the update sent from Beds24 but will automatically re-open the closed room when a guest cancels even if you have a booking from another source. You can opt-out of the feature by following these steps:

  • Log into your Booking.com account
  • Click on the Rates & Availability tab
  • Go to the Settings symbol on the top-right corner of your Calendar
  • Click on Auto-Replenishment
  • Under Calendar Settings, click "No" to turn off the Auto-Replenishment feature
Step 11: Check that the connection is working properly

Click "Refresh" for the Connection Status to check the status of your property at Booking.coms end.

If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.

The connection is working if and your property is selling if

  • you do not receive any erros
  • you see Connection Status: XML Active and Hotel Status: Open / bookable
  • you are not receiving error messages
  • the display in the channel is correct.

This is what the different status values mean:

  • Ready to Open: The property has been reviewed by Booking.com, and is ready to open. Open the property in your Booking.com extranet or go to (SETTINGS) CHANNEL MANAGER > BOOKING.COM > SYNC CONTENT and click on "Open property".
  • Open/Bookable: The property is open and live on Booking.com. It is ready to receive reservations.
  • Autoclosed: Availability: The property has no availability and has been closed. Go to (SETTINGS) CHANNEL MANAGER->BOOKING.COM > MAPPING, click on "Price Data" to check which prices and availability will send. If required adjust your prices and inventory.
  • Duplicate: This property has been found to be a duplicate of another property.
  • XML: Closed: The property has been closed. Open the property in your Booking.com extranet or go to (SETTINGS) CHANNEL MANAGER > BOOKING.COM > SYNC CONTENT and click on "Open property".
  • Closed:The property is closed and no longer bookable on Booking.com. Check your Booking.com extranet for further information.

3 After the connection is activated

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

3.1 Communication with guests

You can communicate with Booking.com guest directly from Beds24.

You can view all messages which Booking.com makes available from the "API Messages" component on the DASHBOARD and individual communication from the "Messages" tab in the booking.

You and your guests will see the messages in Booking.com Messaging Center.

Currently messaging with guests from Booking.com has following limitations:

  • Guests must click on "View Messages" in the email to login to Booking.com and answer from there.
  • If a guest hits "reply" on E-mail they received from Booking.com, Booking.com does not send the reply to Beds24 and will also not make the reply available in Booking.com.
  • Booking.com does not allow links in messages. Use attachments instead.

Properties can send messages to guests within the following time frames:

  • From the time of booking until 7 days after the guest checkout.
  • From the time of booking until 7 days after the booking is cancelled.
  • If the guest messages about the booking, the property gets an additional 14-day window to reply to the guest irrespective of when the booking was cancelled or when the guest checked out.
  • Currently, guests can send messages to properties from the time of booking until 66 days after the checkout.
If you use dependencies you can only assign the bookings into a room in the same property as the room which is mapped to Booking.com.

To use this function

  1. Add the component "API Messages" to your DASHBOARD
  2. To send Auto Action Emails via messaging set "Send Message" on the "Messaging" tab in the Auto Action to one of the API options.
  3. Bookings need to be in a Property that is connected to Booking.com to use the Message API, otherwise communication will be via Email. If you are not sure your connection has Message API, please log into Booking.com and and go to ACCOUNT > CONNECTIVITY PROVIDER. Disconnect from Beds24 and reconnect this time ticking all tick boxes as shown here: https://wiki.beds24.com/images/6/69/Extranet-booking.png

Booking.com allows .jpg and .png attachments but no links or pdfs.

Ensure you do NOT use special characters in the auto action message text as this will breach the Booking.com security checks, and the message will fail to send.

3.2 Manage bookings

3.2.1 Credit cards, charging virtual credit cards & payments

Credit card details are imported and shown on the "INVOICE" tab of the booking. If not please refer to "Missing credit card details" in "Troubleshooting" section below.

Bookings with payments collected by Booking.com will show the payment amount collected as a payment in the "Invoice" tab of the booking.

Charge virtual cards automatically

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

For Booking.com virtual cards you can set to adjust the charge automatically to the full amount available on the card at the time it is charged. To do so create a rule with these settings and specify it in the booking.com "Virtual Card Payment Rule" setting:

  • Funds Source: Virtual Card
  • Payment value adjustment = choose any except for "None"
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. Click here for more details

Charge virtual cards manually

If you manually charge virtual credit cards please note that they can only be charged after the activation date.

3.2.2 Report No-shows, invalid cards, date changes guest misconduct, request cancellations or restrict channel modifications

You will see buttons in the "Details" tab of the bookings which allow you to

  • Report No-shows
  • Report invalid cards
  • Report date changes
  • Report guest misconduct
  • Request the booking to be cancelled

If you do not want to allow channel modifications by default you can change the setting for "Allow Channel Modifications" value" in (SETTINGS) CHANNEL MANAGER.

3.2.3 Info Codes for relevant information

Info Codes in the "Info" tab of the booking show you relevant information about the booking and the guest.

Code Use
BOOKINGCOMCARD invalid card reported to Booking.com
BOOKINGCOMFLAG Booking.com general info flag (Genius/no credit card)
BOOKINGCOMVIRTCARD Booking.com sent a virtual card
BOOKINGCOMBANKTRANS booking paid via bank transfer from Booking.com
CARDTOSTRIPE card details were sent to Stripe
STRIPEPAYMENT payment imported from Stripe
STRIPEFAIL card could not send to Stripe
CARDEXPIRES added when the card expires before check-in

3.2.4 VAT value on extra items

If an extra item name in the booking matches the name of an upsell item for the property, the VAT value of the upsell item will be used. Otherwise, the VAT value defined in the Property booking rules will be used.

3.2.5 Different invoice templates

If you need a different invoice template for the bookings from this channel you can use the invoicee function.

3.3 Reviews

To access Booking.com reviews from your DASHBOARD unlock the DASHBORAD click on the hamburger menu then on "Extentions" and add the Booking.com Review Module.

3.4 Create and manage Booking.com promotions

Promotions can be created, modified and deactivated in (SETTINGS) CHANNEL MANAGER > BOOKING-COM >PROMOTIONS.

Click here for more information and setup instructions.

3.5 Manage or add Booking.com Rate Plans

To manage your rate plans go to (SETTINGS) CHANNEL MANAGER > BOOKING.COM > RATE PLANS. If you want to offer multiple price options for example a non-refundable rate or your rate plan contains meals you can also create additional rate plans.

3.6 Limit the maximum number accepted bookings if you do not want to offer all rooms

By default, all available rooms are sent to activated channels. In (SETTINGS) CHANNEL MANAGER > CHANNEL INVENTORY limit the number of accepted bookings for this channel.

4 Troubleshooting

4.1 Common issues

"Room code is not unique" warning when saving in Beds24.

Each Booking.com room id is unique and can be mapped to only one room in Beds24. If you enter the same Booking.com room id more than once the room updates will overwrite each other causing inaccurate information being sent to Booking.com which will cause overbookings.

No Room codes are available

During the Setup of your connection, click on 'Get the Booking.com Room and Rate Codes for this "Property Code"'

You will see the list of Rooms/Rate codes returned from Booking.com. If Booking.com does not make any rooms available. If you are sure you have rooms please forward the RUID to Booking.com support and ask them to check why they do not return any rooms.

The room is being unexpectedly closed at Booking.com

The channel manager will close the room on all dates which do not have a valid price available for sending to Booking.com. Make sure you have prices for the complete range of dates you are sending (1 year or 2 years).

Messages from Auto actions are not visible in Booking.com message centre

Ensure you do not have any special characters in the message text that could fail the Booking.com Security checks. (For example do not use * or @ in the message text).

Credit card details are missing in Beds24

When Booking.com sends the credit card number it will be available in the "Payments and Charges" tab of the booking unless it has been stored in a third party system such as Stripe. The encoded CVC number is available from the booking notification email sent to the host as the line labelled Security Code. Enter the Security Code value from the email into the booking to view the CVC.

  • If there is no Security Code item in the host notification email, the CVC was not collected or sent for this booking. Booking.com may sometimes withhold the credit card number or CCV unless you specifically request they are sent to you. Contact your Booking.com rep if this is occurring and you require this information.
  • If credit card details are always missing and you require them, please ask Booking.com to collect and send credit card details to Beds24
  • If Booking.com normally sends credit card details but did not do so for a specific booking and you always want a card as security, please ask Booking.com to exclusively accept bookings with a credit card number.
Deleting a rate or price in Beds24 will not delete the price in Booking.com

If you need to close a rate at Booking.com, make the rate id unbookable at Beds24, for example by closing the room or removing the price and wait for it to update at Booking.com. Only once the rate has closed at Booking.com it is safe to remove it from Beds24.

You can close a rate at booking.com by making sure there is no price for it on the dates to close in Beds24. As long as the rate has at least a price for 1 day in the next year, all the other dates without prices will be closed.

If you have multiple rates at booking.com, the other rates can continue to be available by giving them prices.

Note that if there is no price on any day at all for a rate, this will not necessarily close the rate, in this case no information will be sent and whatever data is in Booking.com will remain. Tip Click on the "View Price Data" Button to check which prices and availability will send.

4.2 Error messages

Any errors reported by Booking.com will be emailed to you with the error message as returned by Booking.com. The error message usually includes information about the date, rate or room with the problem and a brief description. Below are common error messages and how to fix them.

Hotel access denied

Check if you have received a notification from Booking.com that the connection is ready.

  • If not please check in the Booking.com extranet that the connection has been requested.
  • If yes please check the Booking.com hotel id you have entered is correct and does not have blank spaces.
  • Click on "Connection Status" to check that the connection is properly activated.
OBP_PRICING_PASSED_FOR_ LOS_RATE, OBP_PRICING_PASSED_FOR_RLO_RATE, OBP_PRICING_PASSED_FOR_DEFAULT_RATE, OBP_PRICING_PASSED_FOR_SINGLE_USE_RATE

Send us a Support Ticket, so we can correct your pricing model.

INVALID_USE_OF_SINGLE_OCCUPANCY

Booking.com does not allow you to send a single price. Go to (SETTINGS) > BOOKING.COM > MAPPING and set "Booking.com Pricing Model"= Per Day Pricing

NOT_A_VALID_OCCUPANCY

Check that "Max guests" set in (SETTINGS) PROPERTIES > ROOMS > SETUP is the same as the occupancy you have set for the room in your Booking.com extranet.

WARN_PRICE_TOO_LOW_LIMIT and WARN_PRICE_TOO_HIGH_LIMIT

Booking.com considers the price you want to send varies significantly from the prices which are already in Booking.com, or if it’s outside the accepted threshold – the minimum being €5 and the maximum being €50,000 (or the equivalent in the local currency).

Either adjust your price in Beds24 or try to change the limitation at Booking.com

Not allowed to update Single Use Rate for Room or CANNOT_SET_SINGLE_USE_RATE

Booking.com have not activated a single occupancy price for the room. Either ask Booking.com to allow a single price (set up a "Single" rate id) or set "Booking.com Rate Type" = Per Day Pricing

If it is a dorm: Booking.com requires the bed price be sent to them as the room price. Therefore they do not accept a single price for a dorm. Set "Booking.com Rate Type" = Per Day Pricing and make sure to set your prices in all rates as a room price (and not as a single price).

Rate is not active or RATE_NOT_ACTIVE or RATE_NOT_ACTIVE_FOR_ROOM or RATE_DOES_NOT_EXIST

You do not have an active Booking.com rate id with this number. You can only update Booking.com Rate Plans which show when you click on 'Get codes'.

  • Go to Prices > Channel Mapping enter the code from the error message Search box and click on the price and and select and ID which you see when you click 'Get codes'.
  • Please double check your Fixed prices and Daily prices and select a valid Booking.com rate id from the list in 'get codes'. You can only send prices for active Booking.com rate codes.
Room is not active or ROOM_NOT_ACTIVE or ROOM_ID_INVALID

You can only update rooms which show when you click on 'Get codes'. If you do have a room with this ID ask Booking.com to activate it. It is activated when you see it when you click on "Get Codes".

RATE_IS_A_SLAVE_RATE

You cannot set occupancy_price for a child rate 123456789, since they are automatically set based on Rate Relations.

You cannot set closed_as_last_night for a child rate 123456789, since they are automatically set based on Rate Relations /message It is not possible to send prices for this rate plan as it is Derived/calculated from another Rate Plan by Booking.com.

  • Option 1
  • Go to Booking.com Extranet, go to Rates & Availability and click 'Edit' on the Rate id identified in the error message, then 'Edit' the Price, and select 'Setup as a new rate plan'. Click Save. View the details in this short video :- https://screenpal.com/watch/c0lV6CVmFNd
  • Option 2
  • Go to (SETTINGS) > BOOKING.COM > MAPPING and select a valid Rate Plan id from the 'get codes' list.
  • Go to Prices > Channel Mapping enter the Rate id in the Search box and click on the Daily Price/Rate and make sure the correct booking.com rate id is selected from the 'get codes' list.
  • Go to Prices > Channel Mapping enter the Rate id in the Search box and click on the Daily Price/Rate untick Booking.com and remove the Rate plan id.
RATE_EDITABLE_ONLY_ON_EXTRANET

You are trying to update a non-XML rate. Log into your Booking.com extranet remove the rate.

Room reservation does not belong to this hotel reservation

The booking was already cancelled in Booking.com before the Channel synchronisation.

Message thread not found

There are two possible reasons:

1. The Booking.com connection for the property does not allow the use of the messaging API.

Please log into Booking.com and and go to ACCOUNT > CONNECTIVITY PROVIDER. Disconnect from Beds24 and reconnect this time ticking all tick boxes as shown here: https://wiki.beds24.com/images/6/69/Extranet-booking.png

2. You have assigned or moved the booking into a room that is in a different property than originally booked. If you want to use messaging with Booking.com you can move/assign booking only to rooms in the same property as the one originally booked.

Failed to post message: Message content failed to pass security filters

Ensure you do not have any special characters in the message text that could fail the Booking.com Security checks. (For example do not use * or @ in the message text).

Message failed to send to reservation 12345678 - content or attachment is required

There are two possible reasons:

1. There is no content in the language of the Guest (OR the default language you have set for your account,) in the Messaging tab of the auto action that you triggered for this booking.

  • Open the booking go to the Mail & Action tab and check the guest language.
  • Open the auto action and ensure you have text in the Subject, Plain Text Field and HTML Field.

2. Auto action should not send a message to the guest, go to the Messaging tab in the Auto action and set 'Sending Message' = NO (or Internal)

This account doesn't have access to this property.","code":"FORBIDDEN"

Log into Booking.com and go to ACCOUNT > CONNECTIVITY PROVIDER. Disconnect from Beds24 and reconnect this time ticking all tick boxes as shown here: https://wiki.beds24.com/images/6/69/Extranet-booking.png

If you use dependencies you can only assign the bookings into a room in the same property as the room which is mapped to Booking.com.

You cannot mark credit card as invalid since the property has not passed trust verification checks

Booking.com does not allow you to mark credit cards as invalid because you have not passed their trust verification process. Please contact your Booking.com Account Manager.

Connections to fix: 0

Booking.com incorrectly show this error in the Booking.com Extranet. There is no problem at all and you should ignore the rest of the text on the screen.

OCCUPANCY_EXCEEDS_MAX_PERSONS

Room 12345678 has a maximum occupancy of 4. You cannot set an occupancy_price for an occupancy of 5 for rate 123456783

Check that "Max guests" set in (SETTINGS) PROPERTIES > ROOMS > SETUP is the same as the occupancy you have set for the room in your Booking.com extranet.

5 Disconnect

  • Set 'Enable' to 'Disable' this will stop Beds24 sending data to Booking.com. This will not remove the data from Booking.com and it will still be bookable.
  • To completely disconnect the channel manager please log into your Booking.com extranet and click on the Account icon in the top right-hand corner. Select Channel Manager from the drop-down menu. Click the Deactivate button to cancel the connection to Beds24.

6 FAQ

I have multiple Booking.com hotel ids. How do I set this up?

Beds24 can handle multiple properties in one account. You will need a property in Beds24 for each property you have on Booking.com so you can connect them so each Booking.com property ID or hotel ID requires one property in Beds24.

I have multiple Booking.com accounts. How do I set this up?

The system can handle multiple properties in one account. It doesn't matter whether the Booking.com properties are in different Booking.com accounts.

Will I receive notifications on new bookings?

After you activate the channel manager the channel will stop sending notifications. You will receive an Email notification from Beds24 instead and you will also see new bookings on your dashboard provided you use the "Latest Bookings" module.

Do guests receive a confirmation?

The channel confirms the booking with the guest. Beds24 will not sent an additional confirmation message to the guest. If you want to send an additional confirmation or welcome message for the guest you can set up an Auto Action Email.

How do I modify or cancel a booking?

You can request Booking.com to cancel the booking or report changed stay dates from the "Details" tab of the bookings.

Otherwise bookings coming from a channel should be modified by the channel. Just changing the status of a booking in Beds24 to "Cancelled" will not cancel the booking in Booking.com and can cause a double booking.

If for some reason you need to make a change in Beds24 and do not want an update from the channel to override it, you can set "Allow Channel Modifications" = No ("Details" tab of the booking"). If you have changed the room you can set "Allow Channel Modifications" = All except room changes. If you do this you will need to manage all changes manually.

How can I access credit card details?

This is how you can view credit card details. Booking.com may sometimes withhold the credit card number or CCV unless you specifically request they are sent to you. Contact Booking.com support if this is occurring and you require this information to always be sent.

How do I add a promotion for Booking.com?

You can set up promotions directly in Beds24 in (SETTINGS) CHANNEL MANAGER > BOOKING.COM > PROMOTIONS or in the Booking.com extranet.

How do I add extra costs or fees?

Extras taxes and fees will not automatically send or update. Set/change these in your Booking.com Extranet unless you want to manage your full Booking.com content from Beds24.

  • Changes to availability and prices will be instantly sent to the channel. Chang
Can I send different prices for different minimum stays or for different numbers of guests?

Yes. With "Occupancy Prices (OBP) Beds24 will send prices for each occupancy you have defined in your prices. If you have different prices for different minimum stays Beds24 will send these.

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 Booking.com room code in multiple rooms in Beds24 can cause overbookings. Check your set up for warnings.
  • If you have Auto-Replenishment enabled, Booking.com will not wait for the update sent from Beds24 but will automatically re-open the closed room when a guest cancels even if you have a booking from another source. You can opt-out of the feature by following these steps:
    • Log into your Booking.com account
    • Click on the Rates & Availability tab
    • Go to the Settings symbol on the top-right corner of your Calendar
    • Click on Auto-Replenishment
    • Under Calendar Settings, click "No" to turn off the Auto-Replenishment feature

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?

Possilbe reasons:

  • Check if you have set up promotions or linked Prices in Booking.com. These will reduce 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?

To report a no show to Booking.com open the booking and click the button in the "Details" tab.

What do I do when a guest provides an invalid credit card number?

Invalid cards can be reported to Booking.com via a button on the "Details" tab of the booking.

If you use Stripe you can set in (SETTINGS) CHANNEL MANAGER to automatically report invalid cards to Booking.com.

I accidentally set my connection as a one-way connection, now I want a two-way connection

You will need to disconnect your connection with Beds24 in the Booking.com extranet and then initiate the connection with two-way connection.