Tripadvisor Rentals: Difference between revisions

Jump to navigation Jump to search
Created page with "Category:Channel Manager Category:Error Messages from Channels Category:Set up Instructions ''Synchronising Beds24.com with Tripadvisor Rentals'' <nowiki>http://..."
 
No edit summary
 
(96 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Channel Manager]]
[[Category:Error Messages from Channels]]
[[Category:Set up Instructions]]
''Synchronising Beds24.com with Tripadvisor Rentals''
<nowiki>http://www.rentals.tripadvisor.com</nowiki>


'''Coming SOON!'''
<div class="heading">Tripadvisor Rentals API</div>
<div style="display:none">
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.
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__
For details please [[Channel_Manager_Capabilities|click here]]
== Capabilities==
TripadvisorRentals allows you to synchronise inventory, rates and content. Sending content is optional.


Beds24 supplies XML data which Tripadvisor Rentals periodically read and use to update the Tripadvisor Rentals calendar.
Via the interface you can:
== Capabilities==
*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
*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]].


== Limitations==
== Limitations==
*You will need to routinely log in to Tripadvisor Rentals and respond to your enquiries.
*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.
*Bookings 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.
*Location information can not be updated after they have sent once.  


==Set Up==
*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 Tripadvisor Rentals listing is a room in Beds24. Where Tripadvisor Rentals specifies a property_id, this corresponds to a roomid in Beds24.


All rooms visible in the account can be sent to Tripadvisor Rentals, this includes rooms in properties linked from other accounts.
*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


=== Beds24===
*Tripadvisor has specific rules regarding pictures, please see the details in the [[Tripadvisor_Rentals#Pictures|Pictures section]]
*Enable option to send data by ticking "Inventory" and "Bookings".
*Note the XML getproperties endpoint shown in the channel manager settings.
*Note the XML getavailability endpoint for each calendar in the channel manager settings.
*Go to SETTINGS->CHANNEL MANAGER->Tripadvisor Rentals->CONTENT DATA and check the content information sent to Tripadvisor Rentals is correct.


=== Tripadvisor Rentals===
== Before you connect ==
*Send an email to [email protected] with the XML endpoints and the Tripadvisor Rentals listing ID for each and request connecting your calendar to these XML endpoints.
'''Prices'''
*Once Tripadvisor Rentals (Tripadvisor) connect you, Tripadvisor Rentals will periodically read the XML endpoint to update your Tripadvisor Rentals calendar.
*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]].


=== Content ===
'''Bookings'''
==== Define Bedrooms and Bathrooms====
They 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.  
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.


Criteria which only applies to one room should be entered in the room.
'''Rooms and room types'''


Make sure you do not create duplicates.  
If you sell rooms individually on TripadvisorRentals and want to sell them on other channels like Booking.com as a "roomtype" with a quantity of more than one you can [[Combine_individual_rooms_into_a_roomtype|set up virtual roooms]].
 
== Connect to TripadvisorRentals ==
=== Connect to your TripadvisorRentals Account===
*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:
**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. 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 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 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.
 
If you have content errors you will see a button "Fix content errors" which will take you to the page where you can see your problems.
 
==== Activation====
*Click on "View content sent to Tripadvisor Rentals" and on "View Actual Data" to check the information which will be sent is correct.
*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 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===
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 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 '''*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.
 
For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.
 
=== Currency===
You can set the currency you want to send in SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS->SPECIFIC CONTENT. If Tripadvisor requires a different currency from the one you use in Beds24 you can use the "Currency" setting and the "Multiplier to adjust the currency.
 
=== Fees and Tax===
In SETTINGS-> CHANNEL MANAGER-> PROPERTY CONTENT-> ROOM CONTENT you can set
*Cleaning fee
*Security deposit
 
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 ==
Go to SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS->CONTENT DATA and check the content information sent to Tripadvisor Rentals is correct.


Tripadvisor does not allow Email addresses or contact information in descriptive texts.


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


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.
Make sure these are set up correctly in Beds24 before you send anything to Tripadvisor.
</div>


Bedrooms and bathrooms are configured by feature codes which are entered in the "Features" field.
=== Define Bedrooms and Bathrooms===
Bedrooms and bathrooms can be set up  in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS->SET UP.


*Click on the "Edit " button next to the "Features" field.
*Click on the "edit bedrooms" or "edit bathrooms" button
*In the pop up click on "Bedroom" or "Bathroom".
*Set the type and use the selectors to define the facilities within each.
*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 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.
*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.
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.
==== 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 85: 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.


==== Prices ====
<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.
Daily prices or Rates with the "Tripadvisor Rentals" channel ticked and set as offer 1 will send to Tripadvisor Rentals as long as they are for the full room occupancy.  
 
=== Languages ===
We can only send one language. You can set the language in SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS->SPECIFIC CONTENT.
 
=== Pictures===
In SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS -> SPECIFIC CONTENT you can set which pictures are sent.
 
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.  


One room price per night and minimum stay value will be sent to Tripadvisor Rentals.
<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> 


If multiple minim,um stay prices are available, the one for the shortest minimum stay will be sent.
=== Check if data is complete and correct===
Go to SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->CONTENT or click on the "View content sent to Tripadvisor" link.


==== Price Multiplier====
To update the listing content click on the links on this page.  and check the information which will be sent to Tripadvisor Rentals is correct and complete.
A multiplier can be specified with a * followed by the amount to multiply the prices.


For example to raise the price by 10% use '''*1.1''' (multiply by 1.1)
If you do not meet the minimum requirements Tripadvisor Rentals might reject all data sent.


For example to lower the price by 10% use '''*0.9''' (multiply by 0.9)
To check which information is sent to Tripadvisor Rentals click on the "View content sent to Tripadvisor Rentals" link. This will show you the raw data. A click on "View Actual Data" will show you which prices are sent.


==== Currency====
=== All feature codes  ===
If Tripadvisor requires a different currency from the one you use in Beds24 you can use the "Currency" setting and the "Multiplier to adjust the currency.  
You can also manually add bedrooms and bathrooms and amenities typing the feature codes exactly as listed below into the "Features" field.  


==== Fees and Tax====
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.  
Fees can be entered per property as Upsell Items set to a compulsory value. All percentage upsell items except for the ones set to "refundable" defined for the property will be included.


Tax%???
BEDROOM


==== Languages ====
BEDROOM_LIVING_SLEEPING_COMBO


==== Pictures====
BEDROOM_OTHER_SLEEPING_AREA
In SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS -> SPECIFIC CONTENT you can set which pictures are sent.


==== Check if data is complete and correct====
BED_BUNK
Go to SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->CONTENT or click on the "View content sent to Fliipkey" link.


To update the listing content click on the links on this page.  and check the information which will be sent to Tripadvisor Rentals is correct and complete.
BED_CRIB


To update the listing content click on the links on this page.
BED_DOUBLE


If you do not meet the minimum requirements Tripadvisor Rentals might reject all data sent.
BED_SOFA


To check which information is sent to Tripadvisor Rentals click on the "View actual data sent to Tripadvisor Rentals" link. This will show you the raw data.
BED_SINGLE


You can also manually add bedrooms and bathrooms and amenities. For more information see "All feature codes" below.
BED_KING


=== Activation ===
BATHROOM
Tick "Inventory" in SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS.


=== All feature codes  ===
BATHROOM_FULL
You can also manually add bedrooms and bathrooms and amenities typing the feature codes exactly as listed below into the "Features" field.


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


BATHROOM_HALF


AIR_CONDITIONING
AIR_CONDITIONING


INTERNET
BALCONY


SATELLITE_OR_CABLE
BEACH_FRONT


POOL_HEATED
BEACH


POOL
LAKE


POOL_INDOOR
BICYCLE


POOL_INDOOR
BOAT


PARKING
CABLE


TELEVISION
SATELLITE


STEREO
CEILING_FAN


DECK_PATIO_UNCOVERED
HEATING


ROOF_TERRACE
POOL_CHILDREN


PRIVATE_YARD
CITY


GRILL
CYCLING


LINENS
DISHWASHER


CLEANING_INCLUDED
DRYER


DVD
DVD
ELEVATOR
FREEZER


FIREPLACE
FIREPLACE


BALCONY
FISHING
 
GAME_ROOM
 
GOLF
 
GRILL
 
GYM
 
POOL_HEATED
 
HIKING
 
HORSE_RIDING
 
CLEANING_INCLUDED
 
POOL_INDOOR


SAFE
INTERNET


TOWELS
IRON_BOARD


STOVE
HOT_TUB


DISHWASHER
KETTLE


DRYER
LINENS


MICROWAVE
MICROWAVE


WASHER
MOUNTAIN_VIEW
 
OCEAN_VIEW
 
DECK_PATIO_UNCOVERED
 
TABLE_TENNIS
 
POOL_TABLE
 
PRIVATE_YARD
 
PARKING_INCLUDED
 
REFRIGERATOR
 
RURAL


SAUNA
SAUNA


GYM
SKIING
 
STAFF
 
STEREO
 
SAFE


POOL_TABLE
STOVE


BOAT
ROOF_TERRACE


GOLF
TENNIS


FISHING
TOASTER


WATERSPORTS
TOWELS


HOT_TUB
TRAMPOLINE


GAME_ROOM
TV


TABLE_TENNIS
POOL


TENNIS
POOL_PRIVATE


EQUESTRIAN_EVENTS
WASHER


GOLF
WATERFRONT


BICYCLE
WATER_SPORTS


WATER_VIEW
WATER_VIEW


MOUNTAIN_VIEW
WIFI
 
CHILDREN_NOT_ALLOWED


RURAL
PETS_CONSIDERED


WATERFRONT
SMOKING_ALLOWED


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


BEACH
==Common Errors==


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


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


SKI_IN
'''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".


SKI_OUT
'''NOT_FOUND 404'''
  Contact Tripadvisor and ask to check if your are properly connected to Beds24 channel manager via the TripadvisorRentals Content API.


HIKING
'''Forbidden 403'''
Contact Tripadvisor and ask to check if your are properly connected to Beds24 channel manager via the TripadvisorRentals Content API.


OCEAN_VIEW
==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". If you have entered a calendar URL in your Tripadvisor Rentals account log into Tripadvisor Rentals and remove the link.
*Untick "Inventory", "Prices ", "Bookings",  "Content" to stop Beds24 sending data and importing bookings.
 
*Contact Tripadvisor and as them to terminate the connection.
</div>
Retrieved from "https://wiki.beds24.com/index.php/Tripadvisor_Rentals"