Difference between revisions of "Despegarcom"

From Beds24 Wiki
Jump to navigation Jump to search
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
[[Category:Channel Manager]]
 
[[Category:Channel Manager]]
 
[[Category:Error Messages from Channels]]
 
[[Category:Error Messages from Channels]]
[[Category:Set up Instructions]]
+
[[Category:Troubleshooting]]
  ''Synchronising Beds24.com with Despegar.com''
+
<div class="heading">Despegar</div>
 +
  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > DESPEGAR and explains how the connection with Despecar and Decolar works and how to set it up.
 
http://www.Despegar.com
 
http://www.Despegar.com
  
Line 24: Line 25:
 
'''Prices'''
 
'''Prices'''
 
*We can only send availability if you have set up prices which are activated for this channel. This tutorial gives general information how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 
*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]].
 +
*If you use rates 1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send on same rate plan. Prices for "Extra Person",  "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent. 
 +
*If you use daily prices the  daily price will send including occupancy. Multiple occupancy prices can send on each rate plan. Extra person price will send.
 
*Beds24 can send a single (1 person), double (2 guests) and room price which is will apply for the maximum occupancy.  
 
*Beds24 can send a single (1 person), double (2 guests) and room price which is will apply for the maximum occupancy.  
 
*Despegar can support more than one price per room for example to send prices for different minimum stays, meal options or refundable and non-refundable prices and  can auto calculate child rates. See  chapter "Multiple Rates"  below.  
 
*Despegar can support more than one price per room for example to send prices for different minimum stays, meal options or refundable and non-refundable prices and  can auto calculate child rates. See  chapter "Multiple Rates"  below.  
*Prices for "Extra Person",  "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent. 
+
 
*If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value.
 
  
 
'''Bookings'''
 
'''Bookings'''
Line 97: Line 99:
 
*If your pricing model is "Per Occupancy Pricing" we will send a price for each occupancy for which a price in Beds24 is defined.  
 
*If your pricing model is "Per Occupancy Pricing" we will send a price for each occupancy for which a price in Beds24 is defined.  
  
 
+
<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Click on the "View Actual Data" Button to check which prices and availability will send. Prices that had already been set in HRS be overridden but cannot be removed. If no prices have are sent from Beds24, no availability is sent, but the which originally was in HRS is displayed.
<span class="circle" >Tip</span> '''''Click on the "View Actual Data" Button to check which prices and availability will send.'''''
 
  
 
== Price Multiplier ==
 
== Price Multiplier ==
Line 134: Line 135:
 
[[Media:channel_activation.png|view large]]
 
[[Media:channel_activation.png|view large]]
  
'''Important''': If you receive error messages from Despegar you will need to fix them immediately. Despegar will reject all updates if there is an error. The "Common Error" section below gives information on common errors and how to fix them.  
+
<div class="warning">{{#fas:exclamation-triangle}} If you receive error messages fyou will need to fix them immediately. The channel will reject all updates if there is an error. The "Common Error" section below gives information on common errors and how to fix them. </div> 
  
 
New Bookings are imported. Modifications and cancellations to bookings are also imported.
 
New Bookings are imported. Modifications and cancellations to bookings are also imported.
Line 140: Line 141:
 
Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.
 
Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.
  
== Updates ==
+
== Updates and Changes==
Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
+
Changes to availability and prices will be instantly sent to the channel. Changes for settings for example minimum stays, the multiplier or number of rooms will send with the next update. Click on "Update" if you want to push them through instantly.
  
 
== Notes ==
 
== Notes ==
Line 147: Line 148:
  
 
==Common Errors==
 
==Common Errors==
Any errors occuring during updates will be emailed to you with the error message as returned by Despegar. Below are common error messages and how to fix them.
+
Any errors occurring during updates will be emailed to you with the error message as returned by Despegar. Below are common error messages and how to fix them.
  
 
  '''The field used to charge the price amount in room: 12345, ratePlan: 12345 for date/s: [xxxx) is incorrect because the hotel works with tax excluded. Be aware that this configuration affects the sell price.'''  
 
  '''The field used to charge the price amount in room: 12345, ratePlan: 12345 for date/s: [xxxx) is incorrect because the hotel works with tax excluded. Be aware that this configuration affects the sell price.'''  
Line 154: Line 155:
 
  '''rate plan 1234 for dates xxx failed because the number of base guests informed (x) does not match the one for the room (x)'''
 
  '''rate plan 1234 for dates xxx failed because the number of base guests informed (x) does not match the one for the room (x)'''
 
  The number of guests Beds24 sends is different from the number of guests in Despegar. Make sure ghe numbers of guests in both Beds24 and Despegar match exactly.
 
  The number of guests Beds24 sends is different from the number of guests in Despegar. Make sure ghe numbers of guests in both Beds24 and Despegar match exactly.
 
  
 
  '''At least one rate exceeds maximum bound. Failed operation: room code 12345, rate plan code 12345, xxx for xx ADULT, for dates ...'''
 
  '''At least one rate exceeds maximum bound. Failed operation: room code 12345, rate plan code 12345, xxx for xx ADULT, for dates ...'''
Line 161: Line 161:
 
  '''Rate update for room xxxxx, rate plan xxxxx for dates xxxx to xxx failed because the number of base guests informed (x) does not match the one for the room (x).'''  
 
  '''Rate update for room xxxxx, rate plan xxxxx for dates xxxx to xxx failed because the number of base guests informed (x) does not match the one for the room (x).'''  
 
  You are trying to send a price for a higher occupancy than what the room is set up in Despegar for. Please correct the maximum number of guests either in Despegar or in Beds24.
 
  You are trying to send a price for a higher occupancy than what the room is set up in Despegar for. Please correct the maximum number of guests either in Despegar or in Beds24.
 +
 +
  '''The charge type used in ratePlan: 123456 is incorrect. '''
 +
  There is a pricing model mismatch between Beds24 and Despegar. You can ask Despegar to change it at their end or you can change it in Beds24 at this menu: SETTINGS->CHANNEL MANAGER->DESPEGAR.
 +
 +
'''Rate update for room xxx, rate plan 123324 for dates xxxx to xxx failed because the number of base guests informed (x) does not match the one for the room (x). Please check this is in /v1/hotels/hotel-info/get or the extranet.'''
 +
The number of guests for this room in Despegar and Beds24 is not the same. Change either "Max guests" in Beds24 or change the number of guests in Despegar.
  
 
==Disconnect==
 
==Disconnect==
 
*Unticking "Inventory" and "Prices" and "Bookings" will stop the synchronisation for a room.
 
*Unticking "Inventory" and "Prices" and "Bookings" will stop the synchronisation for a room.
 
*To completely disconnect the channel manager you might need to  contact Despegar and ask them to disconnect you.
 
*To completely disconnect the channel manager you might need to  contact Despegar and ask them to disconnect you.

Revision as of 19:08, 19 November 2020

Despegar
This page is about the menu  (SETTINGS) CHANNEL MANAGER > DESPEGAR and explains how the connection with Despecar and Decolar works and how to set it up.

http://www.Despegar.com

1 General

2 Capabilities

  • Beds24.com can export inventory.
  • Beds24.com can export multiple rates.
  • Beds24.com can import bookings.
  • Beds24.com can import booking cancellations.
  • Importing cancellations can be disabled for individual bookings.

For details please click here

3 Limitations

  • Only bookings made after the connection is established will be imported, existing bookings must be manually entered into Beds24 to block the dates.

4 Before you connect

Prices

  • We can only send availability if you have set up prices which are activated for this channel. This tutorial gives general information how to set prices for channels.
  • If you use rates 1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple rates with different occupancies can send on same rate plan. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent.
  • If you use daily prices the daily price will send including occupancy. Multiple occupancy prices can send on each rate plan. Extra person price will send.
  • Beds24 can send a single (1 person), double (2 guests) and room price which is will apply for the maximum occupancy.
  • Despegar can support more than one price per room for example to send prices for different minimum stays, meal options or refundable and non-refundable prices and can auto calculate child rates. See chapter "Multiple Rates" below.


Bookings

New Bookings are imported.

Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.

Extras and Taxes

"Upsell Items" can not be exported.

Rooms and room types

If you have room types here and sell rooms individually at another channel or your own web site and want to sell them here as a "roomtype" with a quantity of more than one you can set up virtual roooms.

5 What you will need

The Despegar.com hotel id code for your property and the username and password you create yourself in the Despegar extranet.

6 Set Up

6.1 Despegar

Log into your Despegar extranet

  • Choose Beds24 as channel manager
  • Copy your credendtials

Despegar1.png view large


Despegar2.png view large


Despegar3.png view large


Despegar4.png view large

6.2 Beds24

  • Enter your Despegar username
  • Enter your Despegar password
  • Enter your Despegar hotel id
  • Choose if the prices sent from Beds24 include tax or not
  • Map your rooms and rates

Map Rooms:

  • Click on the "Get Code" link next to the room type id setting.
  • Choose the Despegar room id you want to map to each Beds24 room and click on it.
  • When the correct room id has copied to the room type id setting, click Save.

Standard room mapping.png view large

Map Rates:

  • Set the currency you are using on Despegar. If you use a different currency in Beds24 you can use the multiplier (see below).
  • Set if your prices in Despegar include taxes or not.
  • Click on the "Get Code" link next to the rate plan id setting.
  • Choose the Despegar standard rate for this room and click on it
  • When the correct rate plan id has copied to the rate plan id setting.
  • Click SAVE

Standard rate mapping.png view large

  • If your pricing model is "Per Day Pricing" we send the price and the number of guests for the highest number of guest the system can find. If an extra person price is required you need to set it in Despegar.
  • If your pricing model is "Per Occupancy Pricing" we will send a price for each occupancy for which a price in Beds24 is defined.

Click on the "View Actual Data" Button to check which prices and availability will send. Prices that had already been set in HRS be overridden but cannot be removed. If no prices have are sent from Beds24, no availability is sent, but the which originally was in HRS is displayed.

7 Price Multiplier

If you want to add a multiplier to your prices, for example because of 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%) 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 add a * after the multiplier, for example 123456*1.23* will divide the price of the booking by 1.23.

You can also use currency conversion template variable. All currencies supported by the booking page currency selector can be used.

For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.


8 Multiple Rates at Despegar

Despegar can support more than one price per room for example to send prices for different minimum stays, meal options or refundable and non-refundable prices.

Despegar can set up multiple rate plan ids for each room, each with pre-defined booking conditions. Beds24 can map a different Beds24 rate or offer to each Despegar rate. Please use these instructions. If you do not have the appropriate rate ids you need to request Despegar to add them.


9 Maximum number accepted bookings

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

10 Activate

Before you activate the connection you can view the live availability and prices that will be sent to Despegar using the "View actual data" button.

Channel data neutral.png view large


  • Tick "Inventory", "Prices" and "Bookings"
  • Save

Channel activation.png view large

If you receive error messages fyou will need to fix them immediately. The channel will reject all updates if there is an error. The "Common Error" section below gives information on common errors and how to fix them.

New Bookings are imported. Modifications and cancellations to bookings are also imported.

Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.

11 Updates and Changes

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

12 Notes

13 Common Errors

Any errors occurring during updates will be emailed to you with the error message as returned by Despegar. Below are common error messages and how to fix them.

The field used to charge the price amount in room: 12345, ratePlan: 12345 for date/s: [xxxx) is incorrect because the hotel works with tax excluded. Be aware that this configuration affects the sell price. 
Your tax settings in Despegar and in Beds24 do not line up. Correct your setting for "Tax" in Beds24 or in Despegar.
rate plan 1234 for dates xxx failed because the number of base guests informed (x) does not match the one for the room (x)
The number of guests Beds24 sends is different from the number of guests in Despegar. Make sure ghe numbers of guests in both Beds24 and Despegar match exactly.
At least one rate exceeds maximum bound. Failed operation: room code 12345, rate plan code 12345, xxx for xx ADULT, for dates ...
The price you are sending is higher than the maximum price Despegar allows. Check if the currency you are sending from Beds24 is correct. If it is either lower the price in Beds24 or change/delete the maximum price in Despegar.
Rate update for room xxxxx, rate plan xxxxx for dates xxxx to xxx failed because the number of base guests informed (x) does not match the one for the room (x). 
You are trying to send a price for a higher occupancy than what the room is set up in Despegar for. Please correct the maximum number of guests either in Despegar or in Beds24.
 The charge type used in ratePlan: 123456 is incorrect. 
 There is a pricing model mismatch between Beds24 and Despegar. You can ask Despegar to change it at their end or you can change it in Beds24 at this menu: SETTINGS->CHANNEL MANAGER->DESPEGAR.
Rate update for room xxx, rate plan 123324 for dates xxxx to xxx failed because the number of base guests informed (x) does not match the one for the room (x). Please check this is in /v1/hotels/hotel-info/get or the extranet.
The number of guests for this room in Despegar and Beds24 is not the same. Change either "Max guests" in Beds24 or change the number of guests in Despegar.

14 Disconnect

  • Unticking "Inventory" and "Prices" and "Bookings" will stop the synchronisation for a room.
  • To completely disconnect the channel manager you might need to contact Despegar and ask them to disconnect you.