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

Click herefor general information on how the channel manager works.
This tutorial explains how to set prices for channels.

2 Capabilities

com can export inventory.
com can export multiple rates.
com can import bookings.
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 MASTERINSOFT 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.
MASTERINSOFT 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 MASTERINSOFT 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 MASTERINSOFT as channel manager
Copy your credendtials

view large

6.2 MASTERINSOFT

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

view large

Map Rates:

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

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

view large

Tick “Inventory”, “Prices” and “Bookings”
Save

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

The charge type used in ratePlan: 123456 is incorrect.

There is a pricing model mismatch between MASTERINSOFT and Despegar. You can ask Despegar to change it at their end or you can change it in MASTERINSOFT 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 MASTERINSOFT is not the same. Change either “Max guests” in MASTERINSOFT 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.