Changes

Jump to navigation Jump to search

Tripadvisor Rentals

5,343 bytes added, 14 February
[[Category:Channel Manager]]
[[Category:Error Messages from Channels]]
[[Category:Set up InstructionsTroubleshooting]]<div class="heading">Tripadvisor Rentals API</div> ''This page is about the menu {{#fas:cog}} (SETTINGS->) CHANNEL MANAGER->TRIPADVISOR RENTALS''and explains how the connection with Tripadvisor Rentals works and how to set it up.<nowiki>httphttps://www.rentals.tripadvisor.com/Rentals <div class="warning">{{#fas:exclamation-triangle}} '''Tripadvisor does not allow any new connections. Only Tripadvisor accounts an existing channel manager connection can use their API.'''  *Tripadvisor accounts with an already existing connection with Beds24 can continue to use the connection.*Tripadvisor accounts changing from another channel manager where they have an API connection can switch their existing connection to Beds24 provided their account i not Itrip.*All other properties can use iCal. Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > TRIPADVISOR ICAL and then click on help <span style="color:#019cde;“ >{{#far:question-circle}} </span> at the top right for setup instructions.</nowikidiv>
__TOC__
== Capabilities==
*Beds24TripadvisorRentals allows you to synchronise inventory, rates and content. Sending content is optional.com  Via the interface you can export listing :*create new listings*update existing listings*send and update contentinformation*send and update pictures*Beds24.com can export inventory*Beds24.com can export prices*Beds24 can apply a multiplier to the prices*export changeover dates, complex closed to arrival and closed to departure rules might not send. *import bookings, modifications to bookings and enquiries. Enquiries are imported as "Request" bookings.
For details please [[Channel_Manager_Capabilities|click here]].
TripadvisorRentals allows == Limitations==*Only for Tripadvisor accounts with an already existing connection with Beds24 or Tripadvisor accounts changing from another channel manager where they had an API connection. If you can not use this connection go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > TRIPADVISOR ICAL to use iCal to synchronise inventory, rates availability and content. Sending content is optionalbooking.
== Limitations==
*Tripadvisor makes the XML connection available to TripadvisorRentals customers with 5 or more listings.
*Bookings and enquiries can not be imported because Tripadvisor Rentals does not provide this functionality XML. If you want to import bookings into Beds24 enter the Tripadvisor Rentals export calendar URL in SETTINGS-CHANNEL MANAGER-FLIPKEY.
*A listing can not be activated until the full location (address, latitude, longitude) has been checked by Tripadvisor. After Tripadvisor has checked the location it can not be changed.
 
*Tripadvisor does not support room types, the connected Beds24 room type should have a quantity of one. You can [[Combine_individual_rooms_into_a_roomtype|set up virtual roooms]] to create room types for other channels like booking.com if necessary
 
*Tripadvisor has specific rules regarding pictures, please see the details in the [[Tripadvisor_Rentals#Pictures|Pictures section]]
== 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]].
 
'''Bookings'''
 
Upcoming bookings will automatically import. If you previously used iCal to import bookings these will get cancelled if Tripadvisor sends a modification. The modified booking will import via XML.
'''Rooms and room types'''
== Connect to TripadvisorRentals ==
=== Connect to your TripadvisorRentals Account===
*Send If you already have an email to pmsupport@account which is API connected contact Tripadvisor via the contact form on their website https://rentalsupport.tripadvisor.com and ask /contact_form?l=en_GB with following information:**Your TripAdvisor Account ID**Your registered TripAdvisor Rentals account Email address**A note that you want to be connected to Beds24 channel manager via the TripadvisorRentals Content API. Give them your **Your Beds24 account number (owner ID) which you can find under SETTINGS-ACCOUNT and tell them (Tripadvisor might call this is your Beds24 external account reference. "Partner ID")
Activation is per Beds24 account. All properties owned by a Beds24 account can be connected. If you have properties in a sub acccount which need to be connected click on the 'User' icon on the top right and then on 'Account Management (in the old control panel SUB ACCOUNT in the top right) Manage Account -> Manage Property > Channel Management > "Tripadvisor Rentals XML Connect via Account". With this setting, you can select that the property connects to Tripadvisor Rentals via a different account than the one it is in.
==== Map existing listings====
*Click on "View Listings in Account". You will see a list if of your TripadvisorRentals listings with their listing IDs. Tripadvisor will also send deleted listings to Beds24. Make sure you ignore them.
*When you click on "view data from channel" you will see the content TripadvisorRentals returns for the listing.
*Select the corresponding room in Beds24 and click "Connect".
==== Create a new TripadvisorRentals lisiting listing====Tick the information you want to send "Inventory", "Bookings", "Prices" "Content" (one or more) then SAVE. If you have no content errors a "Publish" button will appear. After you have clicked "Published" you will see an "Update" button. When you click on "View Listings in Account" you will see the new listing in the list.
There may be a delay before the listing goes live while Tripadvisor reviews the listing.
*Go to SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPECIFIC CONTENT and make sure "Active" is set to YES.
*Then tick the information you want to send "Inventory", "Prices" "Content" (one or more) then SAVE to start the sync.
 
==== Bookings====
If you do not want to import enquires go to SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPECIFIC CONTENT and set "Import Inquiries" = No.
== Prices ==
Daily prices or Rates Fixed Prices with the "Tripadvisor Rentals" channel ticked and set as offer 1 will send to Tripadvisor Rentals. The price sent is a room price, only ONE price can be sent per date. Also a minimum stay can be sent. If you have multiple prices activated for TripadvisorRentals with different minimum stays the system will send the price with the lowest minimum stay.
In SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPECIFIC CONTENT you can set
*The number of guests for which the price applies.
*An extra person price.
*A weekly or monthly discount.
 
Tripadvisor rentals do not support decimal places on prices.
 
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Due to a bug in the Tripadvisor system you will need to first set guests included to blank and the additional price to zero then click publish or update. Once you see no errors, add the additional guest info back in and update again.
 
<span class="" style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> <span style="font-weight: bold;" >Tip</span> Click on the "View Actual Data" Button to check which prices and availability will send.
=== Price Multiplier===
A If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number. The multiplier applies to all prices and fees which are sent. For example a hotel id setting ''*1.23''' will multiply all prices by 1.23 sent (i.e. raised by 23%).Lower prices can be specified sent with a multiplier less than 1, i.e. '''* followed 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 amount to multiply multiplier, for example '''*1.23*''' will divide the price of the pricesbooking by 1.23.
For example to raise the price by 10% You can also use '''*1currency conversion template variable.1''' (multiply All currencies supported by 1the booking page currency selector can be used.1)
For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to lower the price by 10% use '''*0.9''' (multiply by 0Euros.9)
=== Currency===
A tax percentage for taxes which are not included in the price can be entered in SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS->SPECIFIC CONTENT.
 
Certain global settings can be overidden with custom values.
== Content ==
Tripadvisor does not allow Email addresses or contact information in descriptive texts.
<div class="warning">{{#fas:exclamation-triangle}} '''Following information can not be changed after the listings have been activated on Tripadvisor:''' *address (all settings) *latitude *longitude *property type *bed configuration Make sure these are set up correctly in Beds24 before you send anything to Tripadvisor.</div>
=== Define Bedrooms and Bathrooms===
They Bedrooms and bathrooms can be set up for the property in {{#fas:cog}} (SETTING->PROPERTIES->DESCRIPTIONSETTINGS) or per room (SETTING->PROPERTIES->ROOMS->SET UP).
Criteria which apply *Click on the "edit bedrooms" or "edit bathrooms" button *Set the type and use the selectors to all rooms in define the property should be set up with the propertyfacilities within each. They will be automatically applied to *If you have multiple bedrooms or bathrooms make sure you define them all rooms in .*Close the propertypop up and then press SAVE.
Criteria which only applies to one room should be entered in the room.
Make sure you do not create duplicates.   Example 1: All units (rooms) have one bedroom and one bathroom. In this case you You can set up the bedroom and bathroom in SETTING->PROPERTIES->DESCRIPTION. The number will be applied to all room/units. Example 2: You have one unit with one bedroom and another unit with two bedrooms. In this case set the also manually add bedrooms up in SETTING->PROPERTIES->ROOMS->SET UP. Bedrooms and bathrooms are configured by feature codes which are entered in the "Features" field.  *Click on the "Edit " button next to the "Features" field. *In the pop up click on "Bedroom" or "Bathroom". *Set the type and use the selectors to define the features within each roomamenities. *If you have multiple bedrooms or bathrooms make sure you define them all. If you have For more than 2 rooms click information see "Close" and SAVE. The system will then automatically add more rooms when you click on the All feature codes"Edit" button again. *Close the pop up and then press SAVEbelow.
You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes<span style=" below.color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Tripadvisor Rentals does not support all features Beds24 offers. For a list of all feature codes , Tripadvisor Rentals supports see "All feature codes" below.
==== Amenities====
Amenities can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP).
Criteria which that apply to all rooms in the property should be set up with the property. They will be automatically applied to all rooms in the property.
Criteria which that only applies apply to one room should be entered in into the room.
Make sure you do not create duplicates.
Example 1: All units (rooms) have Wifi. In this case , you can set up the Wifi in SETTING->PROPERTIES->DESCRIPTION. The number will be applied to all roomrooms/units.
Example 2: You have one unit with Wifi one and another unit without Wifi. In this case set the Wifi up in SETTING->PROPERTIES->ROOMS->SET UP.
You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Tripadvisor Rentals does not support all features Beds24 offers. For a list of all feature codes , Tripadvisor Rentals supports see "All feature codes" below.
=== Languages ===
Tripadvisor only allows cover (first) pictures in landscape format.
 
 
Tripadvisor will not auto change pictures. If you want to change your pictures do this in Beds24 and then ask Tripadvisor to review your pictures and update them for you.
 
<div class="warning">{{#fas:exclamation-triangle}} Tripadvisor only allows each picture to be used once. Please go to Settings > Channel Manager > Tripadvisor Rentals XML > Specific Content and set Pictures = Room. Then go to Settings > Booking Engine > Pictures and make sure all 'Room' pictures are only used once.
</div>
=== Check if data is complete and correct===
Each room feature code can have additional features added to it separated by a space which will list the features within this room. Multiple rooms can be added.
BEDROOM
 
BEDROOM_LIVING_SLEEPING_COMBO
 
BEDROOM_OTHER_SLEEPING_AREA
 
BED_BUNK
 
BED_CRIB
 
BED_DOUBLE
 
BED_SOFA
 
BED_SINGLE
 
BED_KING
 
BATHROOM
 
BATHROOM_FULL
 
BATHROOM_SHOWER
 
BATHROOM_HALF
AIR_CONDITIONING
WIFI
 
CHILDREN_NOT_ALLOWED
 
PETS_CONSIDERED
 
SMOKING_ALLOWED
 
== Updates ==
Changes to availability and prices will be instantly sent to the channel. Changes for other settings for example minimum stays will send with the next update. Click on "Update" if you want to push them through instantly.
 
==Common Errors==
 
'''Validation failures prevented publishing ACTIVATION / PASS_MANUAL_VERIFICATION Violation '''
TripAdvisor might need a Identification validation, you should have received a email from Tripadvisor with further instructions, if not please contact Tripadvisor.
 
'''ACTIVATION = FAILURE'''
Most likely you have set in your Tripadvisor account that content will be sent from Beds24 but you have not ticked "Content" in SETTINGS-CHANNEL MANAGER-TRIPADVISOR RENTALS we can not send content. Either change the setting in Beds24 or in Tripadvisor.
 
'''domain":"CALENDAR","status":"NOT_CONTROLLED'''
Preferences the fields in the Tripadvisors owner's center, under Listings -> Preferences have been set to No. This section allows you to turn on or off specific sections you want to update via API. You will need to change these to "Yes".
 
'''NOT_FOUND 404'''
Contact Tripadvisor and ask to check if your are properly connected to Beds24 channel manager via the TripadvisorRentals Content API.
 
'''Forbidden 403'''
Contact Tripadvisor and ask to check if your are properly connected to Beds24 channel manager via the TripadvisorRentals Content API.
 
==Notes==
*Tripadvisor collects the full payment from the client and transfers it to you after arrival.
*After departure, Tripadvisor sends out a review requests to guests.
*For support contact Tripadviosr.
== Disconnect ==
*Untick "Inventory", "Prices ", "Bookings", "Content" to stop Beds24 sending data and importing bookings.
*Contact Tripadvisor and as them to terminate the connection.
2,912

edits

Navigation menu