Difference between revisions of "Agoda.com"

From Beds24 Wiki
Jump to navigation Jump to search
 
(78 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:Channel Manager]]
 
[[Category:Channel Manager]]
 
[[Category:Error Messages from Channels]]
 
[[Category:Error Messages from Channels]]
−
[[Category:Set up Instructions]]
+
[[Category:Troubleshooting]]
−
  ''Synchronising Beds24.com with Agoda.com''
+
<div class="heading">Agoda and Agoda Homes</div>
 +
  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AGODA and explains how the connection with Agoda or Agoda Homes works and how to set it up.
 
http://www.agoda.com
 
http://www.agoda.com
  
Line 10: Line 11:
  
 
=== Capabilities ===
 
=== Capabilities ===
 +
The connection will work for Agoda and AgodaHomes. [https://www.surveygizmo.com/s3/5166143/Beds24 Click here if you need an account with AgodaHomes].
 
*Beds24.com can export inventory.
 
*Beds24.com can export inventory.
 
*Beds24.com can export multiple rates.
 
*Beds24.com can export multiple rates.
Line 16: Line 18:
 
*Importing cancellations can be disabled for individual bookings.  
 
*Importing cancellations can be disabled for individual bookings.  
  
−
For details please [[Channel_Manager_Capabilities|click here]]
+
For details please [[Channel_Manager_Capabilities|click here]].
  
 
=== Limitations ===
 
=== Limitations ===
 
*Only bookings made after the connection is established will be imported, existing bookings must be manually entered into Beds24 to block the dates.
 
*Only bookings made after the connection is established will be imported, existing bookings must be manually entered into Beds24 to block the dates.
  
−
=== What you will need ===
+
== 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 [[Setting_Prices_for_Booking_Channels|set prices for channels]].
 +
*Beds24 can send a single (1 person), double (2 guests) and a room price which will be applied 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.
 +
*Agoda supports  '''Per Occupancy Pricing'''
 +
**If you use Fixed Prices 1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple prices  with different occupancies can send on same rate plan. '''Prices for "Extra Person",  "Extra child" and discounts set in the "Discounts" tab of the  Fixed Prices 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.'''
 +
 
 +
'''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 / 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 [[Combine_individual_rooms_into_a_roomtype|set up virtual roooms]].
 +
 
 +
You can use the this [[Combine_indivdual_properties_into_one_property_with_multiple_rooms|method]] if you have a property with one hotel ID and three rooms for example on Booking.com or Expedia but a different Agoda hotel ID for each room on Agoda Homes
 +
 
 +
== 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
 
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===
+
== Set Up==
−
====Agoda====
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 1: Agoda
 +
</div>
 +
<div class="mw-collapsible-content">
 
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.
 
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.
−
====Beds24====
+
 
−
*Enter your Agoda hotel id
+
For Agoda Homes please send a connection request to [email protected] to set BEDS24 as the channel manager via Support Widget in the extranet.
−
*Set the currency. If you are using different currencies on Agoda and on Beds24 you can use the price multiplie (see below)
+
</div></div>
 +
 
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 2: Beds24
 +
</div>
 +
<div class="mw-collapsible-content">
 +
*Enter your Agoda hotel id. If you are using Agoda Homes and have multiple rooms in the property set the selector for "Set Hotel ID per" = Room
 +
*Set the currency. If you are using different currencies on Agoda and on Beds24 you can use the price multiplier (see below)
 +
 
 +
[[Image:hotel-id-agoda.png|500px|link=]]
 +
[[Media:hotel-id-agoda.png|view large]]
  
 
<embedvideo service="youtube">https://youtu.be/-SbeMMSk8wc</embedvideo>
 
<embedvideo service="youtube">https://youtu.be/-SbeMMSk8wc</embedvideo>
 +
</div>
 +
</div>
  
−
Map Rooms:
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 3: Map Rooms
 +
</div>
 +
<div class="mw-collapsible-content">
 +
*Select if your price model is "Per Day Pricing" or "Per Occupancy Pricing".
 
*Click on the "Get Code" link next to the room type id setting.
 
*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.
 
*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.
 
*When the correct room id has copied to the room type id setting, click Save.
−
[[Image:agoda_room_mapping.png|500px|link=]]
+
[[Image:map-room.png|500px|link=]]
−
[[Media:agoda_room_mapping.png|view large]]
+
[[Media:map-room.png|view large]]
 +
 
 +
[[Image:map-room1.png|500px|link=]]
 +
[[Media:map-room1.png|view large]]
 +
</div>
 +
</div>
 +
 
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Step 4: Map Rates:
 +
</div>
 +
<div class="mw-collapsible-content">
 +
*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
 +
[[Image:map-rate.png|500px|link=]]
 +
[[Media:map-rate.png|view large]]
 +
 
 +
*Choose the price strategy your account is set to.
 +
*You have the option to set a price for an "Extra Bed" if this option is activated in Agoda.
  
−
Map Rates:
+
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  Agoda do not allow single unit Agoda Homes to have extra bed. If you use Agoda Homes you need to set Extra bed price  = 0.
  
−
Agoda accepts following prices:
+
<span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> 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 Beds24, no availability is sent, but the which originally was in HRS is displayed.
 +
</div></div>
  
−
1. Rooms with a maximum of 2 guests: single price and double price. NO room price.  
+
==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:
  
−
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.
+
'''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'''
  
−
*Click on the "Get Code" link next to the rate plan id setting.
+
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. [[Setting_Prices_for_Booking_Channels#Mapping_channel_rate_codes|Please use these instructions]].
−
*Choose the Agoda standard rate for this room and click on it
+
If you do not have the appropriate rate ids you need to request Agoda to add them.
−
*When the correct rate plan id  has copied to the rate plan id setting.
 
−
*Click SAVE
 
−
[[Image:agoda_standard_rate_mapping.png|500px|link=]]
 
−
[[Media:agoda_standard_rate_mapping.png|view large]]
 
  
−
*If applicable an Extra Beds price
+
== Price Multiplier ==
−
[[Image:agoda_extrabed.png|500px|link=]]
+
If you want to mark your prices up or down or need currency conversion you can add a multiplier to your prices, add a '''*''' followed by the multiplier number in the "Multiplier" field
−
[[Media: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. Agoda expects a price for an extra bed. Please log into your Agoda account and set the extrabed price there.
+
Examples:
 +
*'''*1.23''' will multiply all prices by 1.23  (i.e. raised by 23%).
 +
*Lower prices can be sent with a multiplier less than 1: '''*0.85''' will send 85% of the normal price (i.e. lowered by 15%).
 +
*To convert the price of bookings imported from the channel add a '''*''' AFTER the multiplier. '''*1.23*''' will divide the price of the booking by 1.23.
 +
*For currency conversion you can also use currency conversion template variables. All currencies supported by the booking page currency selector can be used.
 +
**'''*[CONVERT:IDR-EUR]''' will convert Indonesian Rupees to Euros.
  
−
If you need prices for more occupancies talk to Agoda and ask them if the can set up additional rate Ids for you.
+
== 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 ==
 
== Activate ==
 +
*Before you activate the connection you can view the live availability and prices that will be send using the "View actual data" button.
 +
 +
[[Image:actualdata.png|500px|link=]]
 +
[[Media:actualdata.png|view large]]
 +
 
*Tick "Inventory", "Prices" and "Bookings"
 
*Tick "Inventory", "Prices" and "Bookings"
 
*Save
 
*Save
−
[[Image:agoda_activation.png|500px|link=]]
+
[[Image:activate.png|500px|link=]]
−
[[Media:agoda_activation.png|view large]]
+
[[Media:activate.png|view large]]
 +
 
 +
<div class="warning">{{#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. </div> 
  
−
'''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.
 
  
−
===Bookings===
 
 
New Bookings are imported. Modifications and cancellations to bookings are also imported.
 
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.
 
Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.
  
−
===Multiple Rates===
+
== Check Connection ==
−
Multiple rates can be created for each date, for example to send prices for different occupancies, minimum stays, meal options or refundable and non-refundable prices.
+
The connection is working if you are not receiving error messages and the display in the channel is correct. If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.
  
−
'''1. Derived Prices'''
+
== Updates and Changes==
−
Agoda can auto calculate child rates from one master rate we send. Ask your Agoda rep to set this up.
+
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.
−
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'''
+
== Manage Bookings==
 +
===Different Invoice Templates ===
 +
If you need a different invoice template for the bookings from this channel you can use the [[Invoicees|invoicee]] function.
  
−
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. If you do not have the appropriate rate plan ids you need to request Agoda to add them.  
+
===Charge Virtual Credit Cards ===
 +
Virtual cards can be set to be auto charged at the date they become valid. To use this option set "Auto Process Virtual Cards" = Yes
  
−
*Click on the "Get the Agoda Room and Rate Codes for this Property Code" link to view all mapping codes for this property.
+
Virtual cards can be set to be auto charged at the date they become valid.  
  
 +
<div class="warning">{{#fas:exclamation-triangle}} This option is available for customers who use [[Stripe|Stripe]]. If you set "Virtual Cards" = Yes without Stripe activated the system will create a pending payment which can not be collected.</div>
  
−
'''Multiple Rate Ids using Rates'''
+
If you manually charge virtual credit cards please note that they can only be charged on the check-out date.
  
−
Each Beds24 rate can be mapped to any valid Agoda rate plan id that is active and not derived or linked. On the CHANNEL tab of each Beds24 rate is a setting to enter an Agoda rate plan id.
+
== Notes ==
−
If this setting is left blank, the rate plan id defined in the Beds24 channel manager settings for Agoda will be used.
+
For dorms Agoda expects only a single price and not a double or room price.
−
If the Beds24 rate should be mapped to an alternative Agoda rate plan id, enter the Agoda rate plan id here.
 
  
−
<embedvideo service="youtube">https://youtu.be/C5bfXOEtve4</embedvideo>
+
Channel collect payments will be shown in the booking invoice if SETTINGS->CHANNEL MANAGER -> “Import Channel Collect Payments”  is set to “Yes”.
  
−
[[Image:Agoda_rate_mapping.png|400px|link=]]
+
==Common Errors==
−
[[Media::Agoda_rate_mapping.png|view large]]
 
  
  
−
If you have linked a rate to be used for other offers or rooms use the selector to choose the room you want to map.
+
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.
  
−
<embedvideo service="youtube">https://youtu.be/fPdDx9h6VvE</embedvideo>
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
API key is not authorised for Property id:xxxxx
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.
 +
</div></div>
  
−
[[Image:channel_linked.png|400px|link=]]
+
<div class="mw-collapsible mw-collapsed">
−
[[Media:channel_linked.png|view large]]
+
<div  class="headline-collapse" >
 +
Authentication failed. Invalid authentication/Invalid Property id or User not have permission to access Hotel.
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.
 +
</div></div>
  
−
'''Multiple Rate Ids using Offers or Daily Prices'''
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Available allotment (x) cannot greater than number of rooms (x)
 +
</div>
 +
<div class="mw-collapsible-content">
 +
This error means Beds24 is sending a quantity greater than you have listed on Agoda.
 +
</div></div>
  
−
Beds24 supports up to four price "offers" for each room.
+
<div class="mw-collapsible mw-collapsed">
−
Each of the four offers can be mapped to a different Agoda rate plan id.
+
<div  class="headline-collapse" >
−
This is particularly useful when mapping daily prices to Agoda.
+
Please set extrabed rate
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Agoda expects a price for an extra bed. Please log into your Agoda account and set the extrabed price there.
 +
</div></div>
  
−
To define the Agoda rate plan id for each offer, separate the rate plan ids with colons.
+
<div class="mw-collapsible mw-collapsed">
−
For example the following Beds24 rate plan id setting will map offer 1 to rate plan id 11111, offer 2 to rate plan id 22222, offer 3 to rate plan id 33333 and offer 4 to rate plan id 44444:
+
<div  class="headline-collapse" >
 +
Property id: 00000 has not been migrated yet
 +
</div>
 +
<div class="mw-collapsible-content">
 +
You need to  complete your profile creation and self self activation in the Agoda extranet before you map your rooms and rates.
 +
</div></div>
  
−
'''11111:22222:33333:4444'''
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Rate: for ratePlanId: 123456 which is out of stay start/end period: (201X-XX-XX/201X-XX-XX) has not been set
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.
 +
</div></div>
  
−
If offer 1 is used only for the Beds24 booking page and only offers 2,3 and 4 are used for Agoda leave the first rate plan id blank and start with a colon.
+
<div class="mw-collapsible mw-collapsed">
−
For example ''':22222:33333:44444'''
+
<div  class="headline-collapse" >
 +
Invalid room type please check your room type ID
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Please check your room type ids are correct and the connection is enabled.
 +
</div></div>
  
−
The settings for daily prices allow each daily price row to be assigned to a specific offer and therefore mappable to different Agoda rate plan ids
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Room: 00000000 does not exist for Property id: 00000
 +
</div>
 +
<div class="mw-collapsible-content">
 +
You are trying to update a room code which is not a valid Agoda room code. You can only update room codes which are available when you click on "Get Codes".
 +
</div></div>
  
 +
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Cannot set Double rate because max occupancy is 1
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.
 +
</div></div>
  
−
'''Same Price to Multiple Rate Plan Ids'''
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Cannot set double rate when maximum occupancy less than 2
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.
 +
</div></div>
  
−
If a Beds24 price should be sent to multiple Agoda rate plan ids, the multiple rate plan ids can be entered with a comma separating them.  
+
<div class="mw-collapsible mw-collapsed">
−
For example ''''12345678,123456789'''
+
<div  class="headline-collapse" >
 +
Cannot set full rate when maximum occupancy less than 3
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.
  
−
This can be used to allow a daily price set to "Do not allow lower prices" to override multiple Agoda rate plan ids.
+
</div></div>
−
If the comma separated rate plan ids are defined in the channel manager rate plan id setting and each individual Beds24 rate contains it's specific Agoda rate plan id, each rate will be mapped to it's rate plan id and daily prices will be mapped to all the specified rate plan ids, over-riding the rate price when appropriate.
 
  
−
=== Price Multiplier ===
+
<div class="mw-collapsible mw-collapsed">
−
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.
+
<div  class="headline-collapse" >
 +
Cannot set full rate because max occupancy is 2
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.  
 +
</div></div>
  
−
For example a property code setting 123456*12.34 will multiply all prices by 12.34 sent for hotel id 123456.
+
<div class="mw-collapsible mw-collapsed">
 +
<div  class="headline-collapse" >
 +
Cannot set Occupancy X rate because Max occupancy is Y
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Agoda must have the room set for Y but Beds24 is sending a room price for more guests. Either reduce the occupancy level in Beds24  or have Agoda set the room for a higher occupancy.
  
−
== Notes ==
+
</div></div>
−
or dorms Agoda expects only a single price and not a double or room price.
 
−
 
 
−
==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'''
+
<div class="mw-collapsible mw-collapsed">
−
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.
+
<div class="headline-collapse" >
 +
Default rate: xxxx should be between xx and xxxx
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Agoda expects the price to be within this range. Either correct the prices in Beds24 or remove the restriction from Agoda.
  
−
'''Authentication failed. Invalid authentication or User not have permission to access Hotel.'''
+
</div></div>
−
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)'''
+
<div class="mw-collapsible mw-collapsed">
−
This error means Beds24 is sending a quantity greater than you have listed on Agoda.
+
<div class="headline-collapse" >
 +
Please set full occupancy rate.
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.  
  
−
'''Please set extrabed rate'''
+
</div></div>
−
Agoda expects a price for an extra bed. Please log into your Agoda account and set the extrabed price there.
 
  
−
  '''Invalid room type please check your room type ID'''
+
<div class="mw-collapsible mw-collapsed">
−
Please check your room type ids are correct and the connection is enabled.
+
<div class="headline-collapse" >
 +
Price provided not sufficient for Max occupancy = X, rate missing: Full rate
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Agoda expects the room to hold up to X guests and is expecting a price for up to X guests. Check that you have a price for the full occupancy. Another common cause it that you have set the room for a certain occupancy in Beds24 but for a higher occupancy in Agoda.  
 +
</div></div>
  
−
  '''Cannot set double rate when maximum occupancy less than 2 '''
+
<div class="mw-collapsible mw-collapsed">
−
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.
+
<div class="headline-collapse" >
 +
Full Rate should be greater than Double Rate
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.
 +
</div></div>
  
−
  '''Cannot set full rate when maximum occupancy is 2'''
+
<div class="mw-collapsible mw-collapsed">
−
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.
+
<div class="headline-collapse" >
 +
Rate x00.00 cannot less than Minimum Rate xxx.00.
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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.
  
−
'''Cannot set full rate when maximum occupancy less than 3'''
+
</div></div>
−
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'''
+
<div class="mw-collapsible mw-collapsed">
−
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.  
+
<div class="headline-collapse" >
 +
Rate x00.00 should be between xxx.00.
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Agoda has set a price limit for this rate. Either ask Agoda to change or remove the limit or change the price in Beds24 to be between the prices shown by Agoda.  
  
−
'''Please set full occupancy rate.'''
+
</div></div>
−
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'''
+
<div class="mw-collapsible mw-collapsed">
−
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.  
+
<div class="headline-collapse" >
 +
Max extrabed has not been set. You cannot set the extrabed rate
 +
</div>
 +
<div class="mw-collapsible-content">
 +
You do not have an extrabed option in Agoda. Either remove the extrabed price in Beds24 or change your set up in Agoda.
  
−
'''Full Rate should be greater than Double Rate'''
+
</div></div>
−
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.'''
+
<div class="mw-collapsible mw-collapsed">
−
  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.
+
<div class="headline-collapse" >
 +
Rate plan: 0 does not exist for Property id: 00000
 +
</div>
 +
<div class="mw-collapsible-content">
 +
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".
 +
You have added a number which is not a valid Agoda rate id into the field in the "Channels" tab of a rate/daily price.
 +
*Scroll to Rate id and click 'get codes' ensure you select a valid code from the list. 
 +
  *Open your rates (Channel Tab) and make sure the correct Agoda rate id is selected from the 'get codes' list.
 +
*Open your daily prices (Enable list) and make sure the correct Agoda rate id is selected from the 'get codes' list.  
 +
</div></div>
  
−
  '''Max extrabed has not been set, You cannot set the extrabed rate.'''
+
<div class="mw-collapsible mw-collapsed">
−
  You do not have an extrabed option in Agoda. Either remove the extrabed price in Beds24 or change your set up in Agoda.
+
<div class="headline-collapse" >
 +
Requested currency: XXX does not match with Property currency: YYY
 +
</div>
 +
<div class="mw-collapsible-content">
 +
Check the Currency code entered in SETTINGS -> PROPERTIES -> DESCRIPTION -> CURRENCY CODE matches that entered in SETTINGS -> CHANNEL MANAGER -> AGODA.com -> CURRENCY.
 +
</div></div>
  
 
==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 Agoda and ask them to disconnect you.
 
*To completely disconnect the channel manager you might need to  contact Agoda and ask them to disconnect you.

Latest revision as of 17:45, 29 October 2024

Agoda and Agoda Homes
This page is about the menu  (SETTINGS) CHANNEL MANAGER > AGODA and explains how the connection with Agoda or Agoda Homes works and how to set it up.

http://www.agoda.com

1 General

2 Capabilities

The connection will work for Agoda and AgodaHomes. Click here if you need an account with AgodaHomes.

  • 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 a room price which will be applied 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.
  • Agoda supports Per Occupancy Pricing
    • If you use Fixed Prices 1 person, 2 person and room price will send. Room price will send for specified occupancy. Multiple prices with different occupancies can send on same rate plan. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the Fixed Prices 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.

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

You can use the this method if you have a property with one hotel ID and three rooms for example on Booking.com or Expedia but a different Agoda hotel ID for each room on Agoda Homes

5 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

6 Set Up

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

For Agoda Homes please send a connection request to [email protected] to set BEDS24 as the channel manager via Support Widget in the extranet.

Step 2: Beds24

  • Enter your Agoda hotel id. If you are using Agoda Homes and have multiple rooms in the property set the selector for "Set Hotel ID per" = Room
  • Set the currency. If you are using different currencies on Agoda and on Beds24 you can use the price multiplier (see below)

Hotel-id-agoda.png view large

Step 3: Map Rooms

  • Select if your price model is "Per Day Pricing" or "Per Occupancy Pricing".
  • 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.

Map-room.png view large

Map-room1.png view large

Step 4: Map Rates:

  • 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

Map-rate.png view large

  • Choose the price strategy your account is set to.
  • You have the option to set a price for an "Extra Bed" if this option is activated in Agoda.

Agoda do not allow single unit Agoda Homes to have extra bed. If you use Agoda Homes you need to set Extra bed price = 0.

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 Beds24, no availability is sent, but the which originally was in HRS is displayed.

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

8 Price Multiplier

If you want to mark your prices up or down or need currency conversion you can add a multiplier to your prices, add a * followed by the multiplier number in the "Multiplier" field

Examples:

  • *1.23 will multiply all prices by 1.23 (i.e. raised by 23%).
  • Lower prices can be sent with a multiplier less than 1: *0.85 will send 85% of the normal price (i.e. lowered by 15%).
  • To convert the price of bookings imported from the channel add a * AFTER the multiplier. *1.23* will divide the price of the booking by 1.23.
  • For currency conversion you can also use currency conversion template variables. All currencies supported by the booking page currency selector can be used.
    • *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.

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 send using the "View actual data" button.

Actualdata.png view large

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

Activate.png 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 Beds24 manually.

11 Check Connection

The connection is working if you are not receiving error messages and the display in the channel is correct. If you are receiving error messages check in the "Common Errors" section why you are receiving the error and how to fix it.

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

13 Manage Bookings

13.1 Different Invoice Templates

If you need a different invoice template for the bookings from this channel you can use the invoicee function.

13.2 Charge Virtual Credit Cards

Virtual cards can be set to be auto charged at the date they become valid. To use this option set "Auto Process Virtual Cards" = Yes

Virtual cards can be set to be auto charged at the date they become valid.

This option is available for customers who use Stripe. If you set "Virtual Cards" = Yes without Stripe activated the system will create a pending payment which can not be collected.

If you manually charge virtual credit cards please note that they can only be charged on the check-out date.

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

15 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/Invalid Property id 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 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 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.

Room: 00000000 does not exist for Property id: 00000

You are trying to update a room code which is not a valid Agoda room code. You can only update room codes which are available when you click on "Get Codes".

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

Cannot set Occupancy X rate because Max occupancy is Y

Agoda must have the room set for Y but Beds24 is sending a room price for more guests. Either reduce the occupancy level in Beds24 or have Agoda set the room for a higher occupancy.

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 = X, rate missing: Full rate

Agoda expects the room to hold up to X guests and is expecting a price for up to X guests. Check that you have a price for the full occupancy. Another common cause it that you have set the room for a certain occupancy 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.

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 Beds24 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 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". You have added a number which is not a valid Agoda rate id into the field in the "Channels" tab of a rate/daily price. 

*Scroll to Rate id and click 'get codes' ensure you select a valid code from the list.  
*Open your rates (Channel Tab) and make sure the correct Agoda rate id is selected from the 'get codes' list.
*Open your daily prices (Enable list) and make sure the correct Agoda rate id is selected from the 'get codes' list.

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.

16 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.
Retrieved from "https://wiki.beds24.com/index.php?title=Agoda.com&oldid=26037"