Changes

Jump to navigation Jump to search

Tripadvisor Rentals

7,816 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.https://www.tripadvisor.com/Rentals <div class="warning">{{#fas:exclamation-triangle}} '''Synchronising Beds24Tripadvisor does not allow any new connections.com with Only Tripadvisor Rentalsaccounts 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 <nowikispan style="color:#019cde;“ >http{{#far:question-circle}} <//wwwspan> at the top right for setup instructions.rentals.tripadvisor.com</nowikidiv>
'''Coming SOON!'''
<div style="display:none">
__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 Via the Tripadvisor Rentals calendar.interface you can:*create new listings== Capabilities==*update existing listings*Beds24.com can export listing 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]].
== Limitations==
*You will need 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 routinely log in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > TRIPADVISOR ICAL to Tripadvisor Rentals use iCal to synchronise availability and respond to your enquiriesbooking. *Bookings A listing can not be imported because activated until the full location (address, latitude, longitude) has been checked by Tripadvisor Rentals does not provide this functionality XML. If you want to import bookings into Beds24 enter After Tripadvisor has checked the Tripadvisor Rentals export calendar URL.*Location information location it can not be updated after they have sent oncechanged.
==Set Up==A *Tripadvisor Rentals listing is a does not support room in types, the connected Beds24room type should have a quantity of one. Where Tripadvisor Rentals specifies a property_id, this corresponds You can [[Combine_individual_rooms_into_a_roomtype|set up virtual roooms]] to a roomid in Beds24create room types for other channels like booking.com if necessary
All rooms visible in the account can be sent to *Tripadvisor Rentalshas specific rules regarding pictures, this includes rooms please see the details in properties linked from other accounts.the [[Tripadvisor_Rentals#Pictures|Pictures section]]
=== Beds24=Before you connect == '''Prices'''*Enable option to We can only send data by ticking "Inventory" and "Bookings". *Note the XML getproperties endpoint shown in the channel manager settings.*Note the XML getavailability endpoint availability if you have set up prices which are activated for each calendar in the this channel manager settings.*Go to SETTINGS->CHANNEL MANAGER->Tripadvisor Rentals->CONTENT DATA and check the content This tutorial gives general information sent how to Tripadvisor Rentals is correct[[Setting_Prices_for_Booking_Channels|set prices for channels]].
=== Tripadvisor Rentals===*Send an email to [email protected] with your Beds24 account ID and and the request to use the TripadvisorRentals Content API.*Once Tripadvisor Rentals (Tripadvisor) connect you, Tripadvisor Rentals will periodically read the XML endpoint to update your Tripadvisor Rentals calendar.'''Bookings'''
=== Content ======= Define Bedrooms and Bathrooms====They can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP)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 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. '''Rooms and room types'''
Criteria which only applies 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 room should be entered in the roomyou 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 create duplicatessupport 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<div class="warning">{{#fas: All units (rooms) have one bedroom and one bathroom. In this case you exclamation-triangle}} '''Following information can set up not be changed after the bedroom and bathroom in SETTING->PROPERTIES->DESCRIPTION. The number will be applied to listings have been activated on Tripadvisor:''' *address (all room/units.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 Make sure these are set the bedrooms up correctly in SETTING-Beds24 before you send anything to Tripadvisor.</div>PROPERTIES->ROOMS->SET UP.
=== Define Bedrooms and Bathrooms===Bedrooms and bathrooms are configured by feature codes which are entered can be set up in the "Features" field{{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS->SET UP.
*Click on the "Edit " button next to the "Features" field. *In the pop up click on "Bedroomedit bedrooms" or "Bathroomedit bathrooms". button *Set the type and use the selectors to define the features facilities 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.
==== 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.
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==== Prices ====Daily prices or Rates with the "color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> Tripadvisor Rentals" channel ticked and set as offer 1 will send to does not support all features Beds24 offers. For a list of all feature codes, Tripadvisor Rentals as long as they are for the full room occupancysupports see "All feature codes" below.
One room price per night and minimum stay value will be sent to Tripadvisor Rentals=== Languages ===We can only send one language. You can set the language in SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS->SPECIFIC CONTENT.
If multiple minim,um stay prices === Pictures===In SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS -> SPECIFIC CONTENT you can set which pictures are available, the one for the shortest minimum stay will be sent.
==== Price Multiplier====A multiplier can be specified with a * followed by the amount to multiply the pricesTripadvisor only allows cover (first) pictures in landscape format.
For example to raise the price by 10% use '''*1.1''' (multiply by 1.1)
For example Tripadvisor will not auto change pictures. If you want to lower the price by 10% use '''*0.9''' (multiply by 0change your pictures do this in Beds24 and then ask Tripadvisor to review your pictures and update them for you.9)
<div class==== Currency====If Tripadvisor requires a different currency from the one you use in Beds24 you can use the "Currencywarning" setting >{{#fas:exclamation-triangle}} Tripadvisor only allows each picture to be used once. Please go to Settings > Channel Manager > Tripadvisor Rentals XML > Specific Content and the "Multiplier set Pictures = Room. Then go to adjust the currencySettings > Booking Engine > Pictures and make sure all 'Room' pictures are only used once. </div>
==== Fees Check if data is complete and Tax=correct===Fees can be entered per property as Upsell Items set Go to a compulsory value. All percentage upsell items except for SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->CONTENT or click on the ones set "View content sent to Tripadvisor"refundable" defined for the property will be includedlink.
Tax%???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.
==== Languages ====If you do not meet the minimum requirements Tripadvisor Rentals might reject all data sent.
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. ==== Pictures=All feature codes ===In SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS -> SPECIFIC CONTENT you 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 set have additional features added to it separated by a space which pictures are sentwill list the features within this room. Multiple rooms can be addedBEDROOM BEDROOM_LIVING_SLEEPING_COMBO BEDROOM_OTHER_SLEEPING_AREA
==== Check if data is complete and correct====Go to SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS ->CONTENT or click on the "View content sent to Fliipkey" link.BED_BUNK
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 ===Tick "Inventory" in SETTINGS->CHANNEL MANAGER->TRIPADVISOR RENTALS.BATHROOM
=== All feature codes ===You can also manually add bedrooms and bathrooms and amenities typing the feature codes exactly as listed below into the "Features" field. BATHROOM_FULL
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
INTERNETBALCONY
SATELLITE_OR_CABLEBEACH_FRONT
POOL_HEATEDBEACH
POOLLAKE
POOL_INDOORBICYCLE
POOL_INDOORBOAT
PARKINGCABLE
TELEVISIONSATELLITE
STEREOCEILING_FAN
DECK_PATIO_UNCOVEREDHEATING
ROOF_TERRACEPOOL_CHILDREN
PRIVATE_YARDCITY
GRILLCYCLING
LINENSDISHWASHER
CLEANING_INCLUDEDDRYER
DVD
 
ELEVATOR
 
FREEZER
FIREPLACE
BALCONYFISHING GAME_ROOM GOLF GRILL GYM POOL_HEATED HIKING HORSE_RIDING CLEANING_INCLUDED POOL_INDOOR
SAFEINTERNET
TOWELSIRON_BOARD
STOVEHOT_TUB
DISHWASHERKETTLE
DRYERLINENS
MICROWAVE
WASHERMOUNTAIN_VIEW OCEAN_VIEW DECK_PATIO_UNCOVERED TABLE_TENNIS POOL_TABLE PRIVATE_YARD PARKING_INCLUDED REFRIGERATOR RURAL
SAUNA
GYMSKIING STAFF STEREO SAFE
POOL_TABLESTOVE
BOATROOF_TERRACE
GOLF TENNIS
FISHING TOASTER
WATERSPORTSTOWELS
HOT_TUBTRAMPOLINE
GAME_ROOMTV
TABLE_TENNISPOOL
TENNIS POOL_PRIVATE
EQUESTRIAN_EVENTSWASHER
GOLF WATERFRONT
BICYCLEWATER_SPORTS
WATER_VIEW
MOUNTAIN_VIEWWIFI CHILDREN_NOT_ALLOWED
RURALPETS_CONSIDERED
WATERFRONTSMOKING_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 ==
*Untick "Inventory", "Prices ", "Bookings", "Content" to stop Beds24 sending data and importing bookings. If you have entered a calendar URL in your *Contact Tripadvisor Rentals account log into Tripadvisor Rentals and remove as them to terminate the linkconnection</div>
2,912

edits

Navigation menu