Agoda.com

From Beds24 Wiki
Revision as of 15:48, 25 April 2018 by Annette (talk | contribs)
Jump to navigation Jump to search
Synchronising Beds24.com with Agoda.com

http://www.agoda.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.
  • Beds24 can send a single (1 person), double (2 guests) and room price which is will apply for the maximum occupancy. You have the option to set a price for an "Extra Bed" if this option is activated in Agoda.
  • Agoda 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.

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 a channel like Airbnb and want to sell them here as a "roomtype" with a quantity of more than one you can set up virtual roooms.

4.1 What you will need

The Agoda.com hotel id code for your property. This number can be seen near the top right side of the screen in Agoda

4.2 Set Up

4.2.1 Agoda

Request a connection with Beds24 from Agoda. You may have a menu in your Agoda extranet to do this if not ask your Agoda rep.

4.2.2 Beds24

  • Enter your Agoda hotel id
  • Set the currency. If you are using different currencies on Agoda and on Beds24 you can use the price multiplie (see below)

Map Rooms:

  • Click on the "Get Code" link next to the room type id setting.
  • Choose the Agoda 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.

Agoda room mapping.png view large

Map Rates:

Agoda accepts following prices:

1. Rooms with a maximum of 2 guests: single price and double price. NO room price.

2. Rooms for 3 or more guests: a room price for the maximum capacity of the room optionally a single and a double price. If no single or double price a set the rooms price will also be applied to one or two guests.


  • Click on the "Get Code" link next to the rate plan id setting.
  • Choose the Agoda 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

Agoda standard rate mapping.png view large

  • If applicable an Extra Beds price

Agoda extrabed.png view large

Beds24 can send a single (1 person), double (2 guests) and room price which is will apply for the maximum occupancy. You have the option to set a price for an "Extra Bed" if this option is activated in Agoda.

If you need prices for more occupancies talk to Agoda and ask them if the can set up additional rate Ids for you.

4.3 Multiple Rates at Agoda

Agoda 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. There are two options:

1. Derived (Child) Prices Agoda can auto calculate child rates from one master rate we send. Ask your Agoda rep to set this up. This option means you only need to send one rate from Beds24 to Agoda and Agoda will auto-calculate the other rate options.

2. Multiple Rate Plan Ids

Agoda 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 Agoda rate. Please use these instructions. If you do not have the appropriate rate ids you need to request Agoda to add them.


If you do not have the appropriate rate plan ids you need to request Agoda to add them.

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

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

6 Activate

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

Agoda activation.png view large

Important: If you receive error messages from Agoda you will need to fix them immediately. Agoda 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.

7 Updates

Changes in availability will be instantly sent to the channel. Other changes like changes to prices, minimum stays will send with the next update. Click on "Update" if you want to push them through instantly.

8 Notes

For dorms Agoda expects only a single price and not a double or room price.

Channel collect payments will be shown in the booking invoice if SETTINGS->CHANNEL MANAGER -> “Import Channel Collect Payments” is set to “Yes”.

9 Common Errors

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

API key is not authorised for Property id:xxxxx
Please check if your Agoda hotel ID is entered correctly. If it is please contact Agoda and ask them to check if you are connected to the Beds24.com channel manager.
Authentication failed. Invalid authentication or User not have permission to access Hotel.
Please check if your codes are entered correctly. If they are please contact Agoda and ask them to check if you are connected to the Beds24.com channel manager.
Available allotment (x) cannot greater than number of rooms (x)
This error means Beds24 is sending a quantity greater than you have listed on Agoda.
Please set extrabed rate
Agoda expects a price for an extra bed. Please log into your Agoda account and set the extrabed price there.
Property id: 00000 has not been migrated yet
You need to  complete your profile creation and self self activation in the Agoda extranet before you map your rooms and rate. 
Rate: for ratePlanId: 123456 which is out of stay start/end period: (201X-XX-XX/201X-XX-XX) has not been set
The rate has a start and/or end date in Agoda. Prices sent for any dates outside this range will cause this error. Either adjust your prices in Beds24 or in Agoda. 
Invalid room type please check your room type ID
Please check your room type ids are correct and the connection is enabled.
Cannot set double rate when maximum occupancy less than 2 
Agoda must have the room set for single occupancy only and we are sending a double price. Either remove the double price or have Agoda set the room for a higher occupancy.
Cannot set full rate when maximum occupancy is 2
Agoda must have the room set for double occupancy but Beds24 is sending a room price for more guests. Either set a double price in Beds24 remove the room prices or have Agoda set the room for a higher occupancy.
Cannot set full rate when maximum occupancy less than 3
Agoda must have the room set for double occupancy but Beds24 is sending a room price for more guests. Either set a double price in Beds24 remove the room prices or have Agoda set the room for a higher occupancy.
Cannot set Full rate because max occupancy is 2
Agoda have the room set for a maximum of two people but Beds24 is sending a room price for more guests. Either set the max people for the room to two in Beds24 or have Agoda raise it to the same value as Beds24. 
Default rate: xxxx should be between xx and xxxx
Agoda expects the price to be within this range. Either correct the prices in Beds24 or remove the restriction from Agoda.
Please set full occupancy rate.
A full occupancy rate is a price for 3 or more guests. Double rooms do not use full occupancy rates. Agoda expects the room to hold 3 or more guests and is expecting a price for 3 or more people. A common cause it that you have set the room for an occupancy of 2 in Beds24 but for a higher occupancy in Agoda. 
Price provided not sufficient for Max occupancy = 3, rate missing: Full rate
Agoda expects the room to hold 3 or more guests and is expecting a price for 3 or more people. A common cause it that you have set the room for an occupancy of 2 in Beds24 but for a higher occupancy in Agoda. 
Full Rate should be greater than Double Rate
Agoda expects the full rate to be higher. This applies to prices we are sending and prices already in the Agoda system. A common cause is that in Beds24 you have set the room as a double room and in Agoda it is set as a 3 or more person room. Correct the room occupancy so it is the same in both systems. If this is not the reason check which prices are in your Agoda system.
Rate x00.00 cannot less than Minimum Rate xxx.00.
Agoda has set a minimum price limit for this rate. Either ask Agoda to lower the limit or raise the price in Beds24 to be at least as high as the limit.
Max extrabed has not been set, You cannot set the extrabed rate.
You do not have an extrabed option in Agoda. Either remove the extrabed price in Beds24 or change your set up in Agoda.
Rate plan: 0 does not exist for Property id: 00000 
You are trying to update a code which is not a valid Agoda rate plan. You can only update rate plans which are available when you click on "Get Codes".


Requested currency: XXX does not match with Property currency: YYY 
Check the Currency code entered in SETTINGS ->  PROPERTIES -> DESCRIPTION -> CURRENCY CODE matches that entered in SETTINGS -> CHANNEL MANAGER -> AGODA.com -> CURRENCY.

10 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 Agoda and ask them to disconnect you.