Despegarcom

From Booking Automation Wiki
Revision as of 04:19, 24 November 2020 by Cathy (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Despegar
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

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

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 view large

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

{{#fas:lightbulb}} 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 BookingAutomation, no availability is sent, but the which originally was in HRS is displayed.

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 view large


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

Channel activation.png view large

{{#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.

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

Notes

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 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.
The charge type used in ratePlan: 123456 is incorrect. 
There is a pricing model mismatch between BookingAutomation and Despegar. You can ask Despegar to change it at their end or you can change it in BookingAutomation 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 BookingAutomation is not the same. Change either "Max guests" in BookingAutomation or change the number of guests in Despegar.

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.