17,140
edits
Changes
Jump to navigation
Jump to search
'''New properties need to be using Agodas YCS5 API. If you want to connect a property for the first time and you are on YCS4 please contact Agoda and have them upgrade you to YCS 5'''
== New connections using Agoda YCS5 API ==
====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.[[Image:Expedia4.png|500px|link=]][[Media:Expedia4.png|view large]] 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 id has copied to the rate plan id setting.*If applicable enter your extra bed price.*Click SAVE[[Image:Expedia5.png|500px|link=]][[Media:Expedia5.png|view large]]'''Bookings'''
Activate:*Tick "Inventory", "Prices" and "Bookings"*Save[[Image:Expedia6.png|500px|link=]][[Media:Expedia6.png|view large]] ===Bookings===New Bookings are imported. Modifications and cancellations to bookings are also imported.
===Multiple Rates==='''Extras and Taxes'''
Multiple rates "Upsell Items" can not be created for each date, for example to send prices for different occupancies, minimum stays, meal options or refundable and non-refundable pricesexported.
<div style="display:none">'''1. Derived PricesRooms and room types / Agoda Homes'''
Agode can auto calculate, link If you have room types here and derive rate prices using preset rules. Ask sell rooms individually at another channel or your Agoda rep 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 this up.This option means you only need to send one rate from Beds24 to Agoda and Agoda will auto-calculate the other rate optionsvirtual roooms]].
'''2You 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. </div>Multiple Rate Plan Ids'''com or Expedia but a different Agoda hotel ID for each room on Agoda Homes
*Click on the "Get the == Set Up=====Agoda Room and Rate Codes for this Property Code" link ===Request a connection with Beds24 from Agoda. You may have a menu in your Agoda extranet to view all mapping codes for do this propertyif not ask your Agoda rep.
'''Multiple Rate Ids ===Beds24===*Enter your Agoda hotel id. If you are using Rates'''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)
Each Beds24 rate can be mapped to any valid Agoda rate [[Image:hotel-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 id.If this setting is left blank, the rate id defined in the Beds24 channel manager settings for Agoda will be used-agoda.png|500px|link=]]If the Beds24 rate should be mapped to an alternative Agoda rate id, enter the Agoda rate plan [[Media:hotel-id here-agoda.png|view large]]
[[Image:Expedia7.png|400px|link<embedvideo service=]][[Media"youtube">https:Expedia7//youtu.png|view large]]be/-SbeMMSk8wc</embedvideo>
If you have linked a rate to be used for other offers or rooms use the selector to choose the room you want to [[Image:map-room1.png|500px|link=]][[Media:map-room1.png|view large]]
[[ImageMap Rates:channel_linked.png|400px|link=]][[Media:channel_linked.png|view large]]
'''Multiple Rate Ids using Offers or Daily Prices'''*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]]
Beds24 supports up *Choose the price strategy your account is set to four price "offers" for each room.Each of *You have the four offers can be mapped option to set a different Agoda rate plan id.This price for an "Extra Bed" if this option is particularly useful when mapping daily prices to activated in Agoda.
To define the <span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Agoda rate do not allow single unit Agoda Homes to have extra bed. If you use Agoda Homes you need to set Extra bed price id for each offer, separate the rate ids with colons= 0.For example the following Beds24 rate id setting will map offer 1 to rate id 11111, offer 2 to rate id 22222, offer 3 to rate id 33333 and offer 4 to rate id 44444:
'''11111<span style="color:22222#f3e504; font-size:33333250%;" >{{#fas:4444'''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.
If offer 1 is used only ==Multiple Rates at Agoda==Agoda can support more than one price per room for example to send prices for the Beds24 booking page and only offers 2different minimum stays,3 meal options or refundable and 4 non-refundable prices. There are used for Agoda leave the first rate id blank and start with a colon.For example ''':22222:33333two options:44444'''
The settings for daily prices allow each daily price row '''1. Derived (Child) Prices'''Agoda can auto calculate child rates from one master rate we send. Ask your Agoda rep to be assigned set this up.This option means you only need to a specific offer send one rate from Beds24 to Agoda and therefore mappable to different Agoda will auto-calculate the other rate idsoptions.
'''Same Price 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 Multiple Rate Ids'''each Agoda rate. [[Setting_Prices_for_Booking_Channels#Mapping_channel_rate_codes|Please use these instructions]].If you do not have the appropriate rate ids you need to request Agoda to add them.
This Examples:*'''*1.23''' will multiply all prices by 1.23 (i.e. raised by 23%).*Lower prices can be used to allow sent with a daily multiplier less than 1: '''*0.85''' will send 85% of the normal price set to "Do not allow lower prices" to override multiple Agoda rate ids(i.e. lowered by 15%).If *To convert the comma separated rate ids are defined in price of bookings imported from the channel manager rate id setting and each individual Beds24 rate contains itadd a '''*''' AFTER the multiplier. '''*1.23*'''s specific Agoda rate plan id, each rate 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 mapped to itused.**'''*[CONVERT:IDR-EUR]'''s rate id and daily prices will be mapped convert Indonesian Rupees to all the specified rate ids, over-riding the rate price when appropriateEuros.
For example a property code setting 123456== Activate ==*12.34 Before you activate the connection you can view the live availability and prices that will multiply all prices by 12.34 sent for hotel id 123456be send using the "View actual data" button.
<div style[[Image:actualdata.png|500px|link="display:none">]]Migration[[Media:actualdata.png|view large]]
rate codes
dual mapping - we update both codes during the changeover set different currency and apply a multiplier 1. Send Room Update to check there is no error 2New Bookings are imported. Enter property ID in Maintenence Modifications and use AgodaGetMapping 3. When Mark is available sent GO 4. Mark needs to set the code 5. Go cancellations to SETTINGS->CHANNEL MANAGER->AGODA and refresh the page 6. Send another room update </div> == Existing connections using Agoda API 4 == Note: Agoda will discontinue API version 4 shortly. All properties will be migrated. We will contact you when we are ready to migrate your property. If you need to make changes please send us a support ticket. '''Capabilities'''*Beds24.com can export inventory.*Beds24.com can export rates.*Beds24.com can import bookings.*Beds24.com can import booking cancellations.*Importing cancellations can be disabled for individual bookings. For details please [[Channel_Manager_Capabilities|click here]] This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]]. '''Limitations'''*Your property must use the Agoda "Full Ocupancy" pricing model.*Only the default rate for each room can be updated.*Extra bed or Extra person prices are not supported.*Only bookings made after the connection is established will be also imported, existing bookings must be manually entered into Beds24 to block the dates. '''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 room id code for each room you want to synchronise. You can find the room ids in the Agoda extranet under ROOM CONTROL. The room ID is the number next to Room Type
'''Agoda== 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.com'''
Agoda offers automatic channel manager access for some accounts. == Manage Bookings=====Different Invoice Templates ===If you can not find need a different invoice template for the bookings from this in your account channel you need to contact Agoda and ask to be connected to can use the Beds24.com channel manager[[Invoicees|invoicee]] function.
If you don't already have your room and hotel Id codes please ask your Agoda representative ===Charge Virtual Credit Cards ===Virtual cards can be set to supply thembe auto charged at the date they become valid.To use this option set "Auto Process Virtual Cards" = Yes
'''Beds24<div class="warning">{{#fas:exclamation-triangle}} This option is available for customers who use [[Stripe|Stripe]].com'''If you set "Virtual Cards" = Yes without Stripe activated the system will create a pending payment which can not be collected.</div>
Enter your hotel and room id codes and select If you manually charge virtual credit cards please note that they can only be charged on the desired functions (Inventory, Prices and Bookings)check-out date.
'''Rates''' Only rates with the Agoda channel enabled Channel collect payments will be exported. Single pricing can be exported from the rates "single" price value. Double pricing can be exported from the rates "double" price value. Room pricing can be exported from shown in the rates "room" or "export" price value. Rates can have a multiplier applied to prices booking invoice if the Agoda currency is different to the Beds24 currency. The multiplier is defined by adding a "*" symbol followed by the multiplier to the property code, for example SETTINGS->CHANNEL MANAGER -> “Import Channel Collect Payments” '''123456*1.234''' means the property code is 123456 and the price multiplier is 1.234 The optional Extra Bed Price can be set per room in the channel manager settings. If it is greater than zero it will be sent to Agoda as the Extra Bed Price on all dates. If it is zero it will be ignored and you can set the extra bed price directly in the Agoda extranet. A price multiplier, if used, will also be applied to the extra bed price. '''Price Rows''' Daily price rows can be set to send as either single, double or room occupancy prices“Yes”. Select the appropriate value in the Booking Rules >> Daily Prices menu. '''Bookings''' Bookings are only imported if the booked room has Booking Imports enabled
Any errors occuring during updates will be emailed '''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 with are connected to the error message as returned by AgodaBeds24. Below are common error messages and how to fix themcom channel manager.
no edit summary
[[Category:Channel Manager]]
[[Category:Error Messages from Channels]]
[[Category:Set up InstructionsTroubleshooting]]<div class="heading">Agoda and Agoda Homes</div> ''Synchronising Beds24.com This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > AGODA and explains how the connection with Agodaor Agoda Homes works and how to set it up.com''
http://www.agoda.com
===General===
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
=== 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 multiple rates.
*Importing cancellations can be disabled for individual bookings.
For details please [[Channel_Manager_Capabilities|click here]].
=== Limitations ===
*Only bookings made after the connection is established will be imported, existing bookings must be manually entered into Beds24 to block the dates.
=== What Before you will need =connect ==The Agoda'''Prices'''*We can only send availability if you have set up prices which are activated for this channel.com hotel id code This tutorial gives general information how to [[Setting_Prices_for_Booking_Channels|set prices for your propertychannels]]. This number *Beds24 can send a single (1 person), double (2 guests) and a room price which will be seen near applied for the top right side of maximum occupancy. You have the screen 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.'''
<div class=== Set Up=======Agoda====Request a connection with Beds24 from "warning">{{#fas:exclamation-triangle}} Agodawill depreciate "Per Day Pricing" shortly. You may have a menu in your Agoda extranet to Please do this if not ask your Agoda rep. New properties need to be using Agodas YCS5 API If you are on YCS4 make sure you get upgraded to YCS5NOT choose "Per Day Pricing" any more. </div>
Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.
== What you will need ==The Agoda can set up multiple rate plan ids .com hotel id code for each room, each with pre-defined booking conditionsyour property. Beds24 This number can map a different Beds24 rate or offer to each Agoda rate. If you do not have be seen near the top right side of the appropriate rate plan ids you need to request screen in Agoda to add them.
For Agoda Homes please send a connection request to [email protected] to set BEDS24 as the channel manager via Support Widget in the extranet.
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.
[[Image:map-room.png|500px|link=]]
[[Media:map-room.png|view large]]
'''2. Multiple Rate Plan Ids'''
== Price Multiplier ==If you want to mark your prices up or down or need currency conversion you can add a Beds24 price should be sent multiplier to multiple Agoda rate n idsyour prices, the multiple rate ids can be entered with add a comma separating them. For example ''''12345678,123456789*'''followed by the multiplier number in the "Multiplier" field
=== Price Multiplier =Maximum number accepted bookings ==If you want to add a multiplier to your prices, for example because of a different currency By default all all available rooms are sent to your Beds24 currency, add a * followed by activated channels. In SETTINGS->CHANNEL MANAGER->CHANNEL INVENTORY limit the multiplier number to your hotel Idof accepted bookings for this channel.
*Tick "Inventory", "Prices" and "Bookings"
*Save
[[Image:activate.png|500px|link=]]
[[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> Hotel codes stay the sameroom codes change
Existing bookings are not automatically imported when the connection is established and should be entered into Beds24 manually.
== 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.
Virtual cards can be set to be auto charged at the date they become valid.
== Notes ==
For 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.
'''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.
'''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 '''
'''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'''
'''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.
==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.
