Tripadvisor Rentals: Difference between revisions

Jump to navigation Jump to search
← Older edit
No edit summary
No edit summary
 
(55 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category:Channel Manager]]
 
[[Category:Error Messages from Channels]]
<div class="heading">Tripadvisor Rentals API</div>
[[Category:Set up Instructions]]
  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.
  ''This page is about the menu SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS''
https://www.tripadvisor.com/Rentals
https://www.tripadvisor.com/Rentals
<div class="warning">{{#fas:exclamation-triangle}} '''TripAdvisor has shut down its TripAdvisor Rentals business as of October 2024.
Guests will no longer be able to book properties after September 30, 2024, across any of the TripAdvisor Group brands, including Holiday Lettings, Flipkey, and Niumba.
On September 30, 2024, Tripadvisor has  removed functionality that allows the direct booking of properties across any of the Tripadvisor Group brands, including Holiday Lettings, Flipkey, and Niumba.
</div>


__TOC__
__TOC__
== Capabilities==
== Capabilities==
*Create new listings
TripadvisorRentals allows you to synchronise inventory, rates and content. Sending content is optional.
*Update existing listings
 
*Send and update content information
Via the interface you can:
*Send and update pictures
*create new listings
*Beds24.com can export listing content
*update existing listings
*Beds24.com can export inventory
*send and update content information
*Beds24.com can export prices
*send and update pictures
*Beds24 can apply a multiplier to the prices
*export inventory
*Beds24 can import bookings, modifications to bookings and enquiries. Enquiries are imported as "Request" bookings.   
*export prices
*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]].
For details please [[Channel_Manager_Capabilities|click here]].


TripadvisorRentals allows you to synchronise inventory, rates and content. Sending content is optional.  
== 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 availability and booking.


== Limitations==
*Tripadvisor makes the XML connection available to TripadvisorRentals customers with 5 or more listings.
*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.
*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 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 ==
== Before you connect ==
Line 39: Line 50:
== Connect to TripadvisorRentals ==
== Connect to TripadvisorRentals ==
=== Connect to your TripadvisorRentals Account===
=== Connect to your TripadvisorRentals Account===
*Send an email to pmsupport@tripadvisor.com and ask to be connected to Beds24 channel manager via the TripadvisorRentals Content API.
*If you already have an account  which is API connected contact Tripadvisor via the contact form on their website https://rentalsupport.tripadvisor.com/contact_form?l=en_GB with following information:
Give them your Beds24 account number (owner ID) which you can find under SETTINGS-ACCOUNT and tell them this is your Beds24 external account reference.
**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
**Your Beds24 account number (owner ID) which you can find under SETTINGS-ACCOUNT (Tripadvisor might call this "Partner ID")


Activation is per Beds24 account. All properties owned by a Beds24 account can be connected.  
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====
==== Map existing listings====
*Click on "View Listings in Account". You will see a list if your TripadvisorRentals listings with their listing IDs.  
*Click on "View Listings in Account". You will see a list 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.   
*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".
*Select the corresponding room in Beds24 and click "Connect".


==== Create a new TripadvisorRentals lisiting ====
==== Create a new TripadvisorRentals 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.
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.


Line 60: Line 74:
*Go to SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPECIFIC CONTENT and make sure "Active" is set to YES.
*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.
*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 ==
== Prices ==
Daily prices or Rates 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.
Daily prices or 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
In SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPECIFIC CONTENT you can set
Line 68: Line 85:
*The number of guests for which the price applies.
*The number of guests for which the price applies.
*An extra person price.
*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===
=== Price Multiplier===
If you want to add a multiplier to your prices add a '''*''' followed by the multiplier number to your hotel id.
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.
The multiplier applies to all prices and fees which are sent.


For example a hotel id setting '''123456*1.23''' will multiply all prices by 1.23 sent for hotel id 123456. (i.e. raised by 23%)
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 sent with a multiplier less than 1, i.e. '''123456*0.85''' will send a price 85% of the normal price (i.e. lowered by 15%)
Lower prices can be sent with a multiplier less than 1, i.e. '''*0.85''' will send a price 85% of the normal price (i.e. lowered by 15%)


To convert the price of bookings imported add a * after the multiplier, for example '''123456*1.23*''' will divide the price of the booking by 1.23.
To convert the price of bookings imported add a * after the multiplier, for example '''*1.23*''' will divide the price of the booking by 1.23.


You can also use currency conversion template variable. All currencies supported by the booking page currency selector can be used.
You can also use currency conversion template variable. All currencies supported by the booking page currency selector can be used.
Line 93: Line 117:
A tax percentage for taxes which are not included in the price can be entered in SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS->SPECIFIC CONTENT.
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. If required see this [[Setting/custom|list of custom parameters]].
Certain global settings can be overidden with custom values.


== Content ==
== Content ==
Line 100: Line 124:
Tripadvisor does not allow Email addresses or contact information in descriptive texts.  
Tripadvisor does not allow Email addresses or contact information in descriptive texts.  


  '''Following information can not be changed after the listings have been activated on Tripadvisor:'''  
<div class="warning">{{#fas:exclamation-triangle}} '''Following information can not be changed after the listings have been activated on Tripadvisor:'''  
*address (all settings)
*address (all settings)
*latitude
*latitude
*longitude
*longitude
*property type
*property type
*bed configuration
*bed configuration
Make sure these are set up correctly in Beds24 before you send anything to Tripadvisor.
 
Make sure these are set up correctly in Beds24 before you send anything to Tripadvisor.
</div> 


=== Define Bedrooms and Bathrooms===
=== Define Bedrooms and Bathrooms===
They can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP).
Bedrooms and bathrooms can be set up in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS->SET UP.


Criteria which 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.  
*Click on the "edit bedrooms"  or "edit bathrooms" button
*Set the type and use the selectors to define the facilities within each.
*If you have multiple bedrooms or bathrooms make sure you define them all.
*Close the pop 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.
You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.
 
 
Example 1: All units (rooms) have one bedroom and one bathroom. In this case 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 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 room.  
*If you have multiple bedrooms or bathrooms make sure you define them all. If you have more than 2 rooms click "Close" and SAVE. The system will then automatically add more rooms when you click on the "Edit" button again.
*Close the pop up and then press SAVE.


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.
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====
Amenities can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP).
Amenities can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP).


Criteria which 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 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 only applies to one room should be entered in the room.  
Criteria that only apply to one room should be entered into the room.  


Make sure you do not create duplicates.  
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 room/units.
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 rooms/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.
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.
Line 155: Line 169:


You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.
You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.
  Tripadvisor Rentals does not support all features Beds24 offers. For a list of all feature codes Tripadvisor Rentals supports 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 ===
=== Languages ===
Line 164: Line 179:


Tripadvisor only allows cover  (first) pictures in landscape format.
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===
=== Check if data is complete and correct===
Line 179: Line 200:
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.  
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
AIR_CONDITIONING
Line 307: Line 353:


WIFI
WIFI
CHILDREN_NOT_ALLOWED
PETS_CONSIDERED
SMOKING_ALLOWED


== Updates ==
== Updates ==
Line 318: Line 370:
  '''ACTIVATION = FAILURE'''
  '''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.
  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 ==
== Disconnect ==
*Untick  "Inventory", "Prices ", "Bookings",  "Content" to stop Beds24 sending data and importing bookings.
*Contact Tripadvisor and as them to terminate the connection.
Retrieved from "https://wiki.beds24.com/index.php/Tripadvisor_Rentals"