Agoda

From Effective Tours Documentation
Jump to navigation Jump to search
Synchronising Effective Tours.com with Agoda.com and Agoda Homes

http://www.agoda.com

General

Capabilities

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


Limitations

  • To import existing bookings please contact support team.

Before you connect

Prices

  • We can only send availability if you have set up prices which are activated for this channel.
  • Effective Tours can send a single (1 person), double (2 guests) and room price which is will apply for the maximum occupancy.
  • 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 requested to import from support team.


Rooms and room types / Agoda Homes

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 Agoda.com hotel id code for your property. This number can be seen near the top right side of the screen in Agoda

Set Up

Agoda

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

For Agoda Homes please send a connection request to BD-Connectivity@agoda.com to set Effective Tours as the channel manager via Support Widget in the extranet.

Effective Tours

  • Enter your Agoda hotel id

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

Effective Tours can send a single (1 person), double (2 guests) and room price which is will apply for the maximum occupancy. If you need prices for more occupancies talk to Agoda and ask them if the can set up additional rate Ids for you.

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 Effective Tours 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. Effective Tours can map a different Effective Tours rate or offer to each Agoda rate. 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.

Updates

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

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 Effective Tours.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 Effective Tours.com channel manager.
Available allotment (x) cannot greater than number of rooms (x)
This error means Effective Tours 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 rates. 
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 Effective Tours 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 because max occupancy is 1
 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 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 Effective Tours is sending a room price for more guests. Either set a double price in Effective Tours 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 Effective Tours is sending a room price for more guests. Either set a double price in Effective Tours 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 Effective Tours is sending a room price for more guests. Either set the max people for the room to two in Effective Tours or have Agoda raise it to the same value as Effective Tours. 
Default rate: xxxx should be between xx and xxxx
Agoda expects the price to be within this range. Either correct the prices in Effective Tours 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 Effective Tours 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 Effective Tours 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 Effective Tours 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 Effective Tours to be at least as high as the limit.
Rate x00.00 should be between xxx.00.
Agoda has set a price limit for this rate. Either ask Agoda to change or remove the limit or change the price in Effective Tours to be between the prices shown by Agoda. 
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 Effective Tours 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.