Difference between revisions of "Despegarcom"

From Booking Automation Wiki
Jump to: navigation, search
(Common Errors)
 
(One intermediate revision by the same user not shown)
Line 136: Line 136:
 
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 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.
  
  '''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.'''
Your tax settings in Despegar and in BookingAutomation do not line up. Correct your setting for "Tax" in BookingAutomation or in Despegar.'''
+
Your tax settings in Despegar and in BookingAutomation do not line up. Correct your setting for "Tax" in BookingAutomation 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 BookingAutomation sends is different from the number of guests in Despegar. Make sure the numbers of guests in both BookingAutomation 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 ...
+
'''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 price you are sending is higher than the maximum price Despegar allows. Check if the currency you are sending from BookingAutomation is correct. If it is either, lower the price in BookingAutomation or change/delete the maximum price in Despegar.'''
+
The number of guests BookingAutomation sends is different from the number of guests in Despegar. Make sure the numbers of guests in both BookingAutomation 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 BookingAutomation is correct. If it is either lower the price in BookingAutomation 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 BookingAutomation.
  
 
==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.

Latest revision as of 10:02, 8 October 2019

Synchronising Booking Automation with Despegar.com

http://www.Despegar.com

General

Capabilities

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

For details please click here

Limitations

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

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.
  • BookingAutomation 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.
  • 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

New Bookings are imported.

Existing bookings are not automatically imported when the connection is established and should be entered into BookingAutomation 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.

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.

Set Up

Despegar

Log into your Despegar extranet

  • Choose BookingAutomation as channel manager
  • Copy your credentials

Despegar1.png

Despegar2.png

Despegar3.png

Despegar4.png

BookingAutomation

  • Enter your Despegar username
  • Enter your Despegar password
  • Enter your Despegar hotel id
  • Choose if the prices sent from BookingAutomation 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 BookingAutomation room and click on it.
  • When the correct room id has copied to the room type id setting, click Save.

Standard Room Mapping.png

Map Rates:

  • Set the currency you are using on Despegar. If you use a different currency in BookingAutomation 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

  • 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 BookingAutomation is defined.

Price Multiplier

If you want to add a multiplier to your prices, for example because of a different currency to your BookingAutomation 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.


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. BookingAutomation can map a different BookingAutomation 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.


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.

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

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

Channel activation.png

Important: If you received 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.

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 BookingAutomation manually.

Updates

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

Notes

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.

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 BookingAutomation do not line up. Correct your setting for "Tax" in BookingAutomation 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 BookingAutomation sends is different from the number of guests in Despegar. Make sure the numbers of guests in both BookingAutomation 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 BookingAutomation is correct. If it is either lower the price in BookingAutomation 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 BookingAutomation.

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.