Marriott: Difference between revisions

Jump to navigation Jump to search
No edit summary
 
(59 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Channel Manager]]
[[Category:Channel Manager]]
[[Category:Troubleshooting]]
[[Category:Troubleshooting]]
<div class="heading">Marriott Homes & Villas - Coming soon! Contact us if you are interested in using this connection. </div>
<div class="heading">Marriott Homes & Villas  </div>


  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > MARRIOTT HOMES & VILLAS and explains how to connect with Marriott Homes and Villas.  
  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > MARRIOTT HOMES & VILLAS and explains how to list and connect with Homes & Villas by Marriott International.
 
Homes & Villas by Marriott Bonvoy (HVMB) is an expertly curated collection of vacation rentals backed by the world’s largest hospitality company that provides travellers access to thousands of private homes.
Each hand-picked home is professionally managed by a vetted property management company to meet Marriott’s exacting standards in design, comfort, and safety.
 
<embedvideo service="youtube"> https://youtu.be/nkcVXbHO3S4</embedvideo>


= Capabilities =
= Capabilities =
Beds24 can
Beds24 can
*Create listings on Marriott Homes & Villas
*Create listings on Homes & Villas by Marriott International
*Update content to Marriott Homes & Villas
*Update content to Homes & Villas by Marriott International
*Export availability
*Export availability and price data
*Export
*Import bookings


For details [https://wiki.beds24.com/index.php?title=Channel_Manager_Capabilities click here].
For details [https://wiki.beds24.com/index.php?title=Channel_Manager_Capabilities click here].


= Limitations =
= Limitations =
Your properties need to meet Marriotts critieria.
*Marriott bookings have a minimum stay of 2 nights, prices for 1 night will not be sent to Marriott.
*Marriott only works with property managers not with individual properties.
*Bookings imported from HVMB will not have detailed fee or tax information. They will only have the type type and total value of the fee/tax, no descriptive information.
*Marriott do not allow 1 night stays and ignore all 1 night prices due to their business policy.
 
=List on Homes & Villas by Marriott International=
To list on Homes & Villas by Marriott International your property management company and your properties need to meet Marriott's standards which are:
 
'''Property Managers'''
*Handle the management, in-stay guest support and cleaning of a minimum of 30 properties (with
some exceptions for various markets and offerings)
*Responsible for updating calendar availability and pricing
*Track record of reliability and customer satisfaction, including response times, compliance with
local regulations and other management responsibilities
 
 
'''Properties/Homes'''
*One (1) or more bedrooms (no studios or home shares)
*A fully equipped kitchen, Wi-Fi, linens, towels and bathroom amenities and other essentials
*Safety equipment, including smoke and carbon monoxide detectors and fire extinguishers
 
Property management companies that meet the above requirements and are interested in listing on Homes & Villas by Marriott International should complete this form: https://hvmi.tfaforms.net/91.


= Before you connect =
= Before you connect =
==Prices==
==Prices==
*We can only send availability if you have set up prices which are activated for Marriott  under "Channels" in the Daily Prices or Rates.  
*We can only send availability if you have set up prices which are activated for Marriott  under "Channels" in the Daily Prices or Fixed Prices.
*Marriott do not allow 1 night stays and ignore all 1 night prices due to their business policy.  
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
*You can set a multiplier to mark your price up or down.
*You can set a multiplier to mark your price up or down.
Line 26: Line 53:
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose  '''Per Day Pricing''' (the default)  if you have only ONE price per date.  
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose  '''Per Day Pricing''' (the default)  if you have only ONE price per date.  


If you have multiple prices activated for Airbnb with different minimum stays the system will send the price with the lowest minimum stay. Of the ones with the lowest minimum stay the one with the highest occupancy will be used.  
If you have multiple prices activated for Marriott with different minimum stays the system will send the price with the lowest minimum stay. Of the ones with the lowest minimum stay the one with the highest occupancy will be used.  


If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value  so the price for the full occupancy can send.  
If you use daily prices with "Extra Person" prices your daily price needs to be set for the max occupancy and the "Extra Person" price needs to be added with a negative value  so the price for the full occupancy can send.  
Line 36: Line 63:
*An extra person price.
*An extra person price.


For example, you have a room for 3 people, you charge 50€ for 2 people and 15€ for 3rd person, create a Rate with Room price - 50 - Upt o 2 people. Then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > MARRIOTT  > SPECIFIC CONTENT >  and set Guests included = 2, Extra Person Price = 15  
For example, you have a room for 3 people, you charge 50€ for 2 people and 15€ for 3rd person, create a Rate with Room price - 50 - Upt o 2 people. Then go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > MARRIOTT  > SPECIFIC CONTENT >  and set Guests included = 2, Extra Person Price = 15


===Per Occupancy (LOS) Pricing===
===Per Occupancy (LOS) Pricing===
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Occupancy Pricing'''  if you want to send prices for different occupancies  and/or  different length of stay..  
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Choose '''Per Occupancy Pricing'''  if you want to send prices for different occupancies  and/or  different length of stay..  


If you use rates the price for each occupancy defined in Beds24 and prices for different length of stay can be sent.1 person, 2 person and room price will send. Room price will send for specified occupancy.  Multiple rates with different occupancies can send. Prices for "Extra Person", "Extra child" and discounts set in the "Discounts" tab of the rates can not be sent.  
If you use Fixed Prices the price for each occupancy defined in Beds24 and prices for different length of stay can be sent.1 person, 2 person and room price will send. Room price will send for specified occupancy.  Multiple prices with different occupancies can send. 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. Extra person price will send.  
If you use daily prices the daily price will send including occupancy. Multiple occupancy prices can send. Extra person price will send.  


The "Min Stay" and "Max Stay" set in the Calendar, Daily Prices or Rates will send.
The "Min Stay" and "Max Stay" set in the calendar will send.
Daily Prices or Fixed Prices will send.
 
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> When sending different prices for different length of stay (LOS), the room restriction strategy {{#fas:cog}} (SETTINGS)  > PROPERTIES > ROOMS > SETUP must be set to "Stay through". The restriction strategy "Arrival" may not calculate the correct pricing after the first night.


==Bookings==
==Bookings==
Line 56: Line 86:
*For properties with one unit: property name from  {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and pictures from the property will send.
*For properties with one unit: property name from  {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION and pictures from the property will send.
*For properties with more than one unit type: the names from {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > DESCRIPTION and the room pictures will send.  
*For properties with more than one unit type: the names from {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > DESCRIPTION and the room pictures will send.  
Our connection supports room types with a quantity of more than one. 


If you sell rooms/renatls  individually at another channel or your 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 up virtual rooms]].
If you sell rooms/renatls  individually at another channel or your 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 up virtual rooms]].


= Setup =
= What you need=
To use the connection you will need to sign up with Marriott Homes & Villas.  
To use the connection you will need to sign up with Marriott Homes & Villas [https://partners.homes-and-villas.marriott.com/s/cp-company-interest-form?i=a018a00000x4d0k here:].  


If you already Marriott Homes & Villas you will need to contact Marriott and ask them to create a new HMCID for Beds24 for your. After you have created your new listings from Beds24 Marriott will be able to attach your historic bookings to your new listings.  
If you already Marriott Homes & Villas you will need to contact Marriott and ask them to create a new HMCID for Beds24 for your. After you have created your new listings from Beds24 Marriott will be able to attach your historic bookings to your new listings.


== Security ==
= Security =
Marriott has specific security requirements. Please go to  {{#fas:cog}} (SETTINGS) ACCOUNT > PRIVACY and set to
Marriott has specific security requirements. Please go to  {{#fas:cog}} (SETTINGS) ACCOUNT > ACCESS and set to
*change your password every three month
*change your password every three month
*use 2-Factor-Authentication for your Beds24 account
*use 2-Factor-Authentication for your Beds24 account
Line 121: Line 153:
<span style="" >{{#fas:reply}} </span>  Yes
<span style="" >{{#fas:reply}} </span>  Yes


= Create listings on  Marriott Homes & Villas=
== Minimum requirements ==
== Minimum requirements ==
Your content needs to meet Marriotts minimum requirements which are:
Your content needs to meet Marriott's minimum requirements which are:
*Unique listing name (min 8 characters, max 255).
*Unique listing name (min 8 characters, max 255).
*Property address
*Property address
Line 128: Line 161:
*Bedrooms (including number and type of beds)
*Bedrooms (including number and type of beds)
*Number of bathrooms
*Number of bathrooms
*Description (must not reference management company name, non-HMVI cancellation policies, etc)
*Description (must not reference management company name, non-HMVI cancellation policies, etc). If you have a Permit Id, add here or in House Rules.
*Valid property type (Apartment, Cabin, House, Villa, Aparthotel, Barn, Building, Casa Particular, Castle, Chacara, Chalet, Chateau, Condo, Cottage, Cycladic House, Estate, Farmhouse, Lodge, Loft, Mas, Mill, Resort, Riad, Serviced Apartment, Studio, Tower, Townhome or Tree House)
*Valid property type (Apartment, Cabin, House, Villa, Aparthotel, Barn, Building, Casa Particular, Castle, Chacara, Chalet, Chateau, Condo, Cottage, Cycladic House, Estate, Farmhouse, Lodge, Loft, Mas, Mill, Resort, Riad, Serviced Apartment, Studio, Tower, Townhome or Tree House)
*At least 3 days of consecutive availability and pricing over the next 365 days
*At least 3 days of consecutive availability and pricing over the next 365 days
*6 or more pictures with minimum resolution of 500 x 800 (must not have watermarks or reference to management company name)
*6 or more pictures with minimum resolution of 500 x 800 (must not have watermarks or reference to management company name)
*5 or more Amenities
*5 or more Amenities
*House rules (must not reference management company name, contact information, or any cancellation policy related to any competing channel or direct bookings)
*House rules (must not reference management company name, contact information, or any cancellation policy related to any competing channel or direct bookings). If you have a Permit Id, add here or in Property Description.


== Create listings on  Marriott Homes & Villas==
== Step-by-Step guide ==
'''Step 1 - Enter your Marriott HMCID'''
'''Step 1 - Enter your Marriott HMCID'''


Line 143: Line 176:
*SAVE
*SAVE


'''Step 2: Enter channel specific content'''  
'''Step 2: Adjust your security settings'''


Go to {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > MARRIOTT >  SPECIFIC CONTENT where you can adjust specific settings and add content information.  
Go to (SETTINGS) ACCOUNT > ACCESS and set to
*change your password every three month
*use 2-Factor-Authentication for your Beds24 account
*time out the Beds24 session after 15 minutes
 
'''Step 3: Enter channel specific content'''
 
Go to {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > MARRIOTT >  SPECIFIC CONTENT where you can adjust specific settings and add content information. Line breaks can be used.


'''Step  - Check if your content meets Marriotts requirements'''
'''Step  - Check if your content meets Marriotts requirements'''
Line 153: Line 193:
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you see a red button "Fix Content Errors" your listing does not meet Marriotts requirements. Click on the button to get to {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > MARRIOTT> VIEW CONTENT.  
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> If you see a red button "Fix Content Errors" your listing does not meet Marriotts requirements. Click on the button to get to {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > MARRIOTT> VIEW CONTENT.  


'''Step 3 - Check which prices will send'''
'''Step 4 - Check which prices will send'''
Click on the "Actual Data" link to check which prices and availability will send. If you see no prices or no availability in the list check your have prices which are activated for Marriott.  
Click on the "Actual Data" link to check which prices and availability will send. If you see no prices or no availability in the list check your have prices which are activated for Marriott.  


'''Step 4: Check the currency setting is correct'''  
'''Step 5: Check the currency setting is correct'''  


Marriott only supports a few currencies. If you use a currency which is not supported you can add a multiplier for currency conversion.
Marriott only supports a few currencies. If you use a currency which is not supported you can add a multiplier for currency conversion.


'''Step 5 - Add a multiplier to your prices (optional)'''
'''Step 6 - Add a multiplier to your prices (optional)'''


If you want to add a multiplier to your prices add a * followed by the multiplier number.
If you want to add a multiplier to your prices add a * followed by the multiplier number.
Line 174: Line 214:
For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.  
For example *[CONVERT:IDR-EUR] will convert Indonesian Rupees to Euros.  


'''Step 6 : Export to Marriott'''
'''Step 7 : Export to Marriott'''


When your content meets Marriotts requirements you can click "Export'''.  
When your content meets Marriotts requirements you can click "Export'''.  
Line 182: Line 222:
*Click on "Confirm"
*Click on "Confirm"


'''Step 7: Check that the connection is working properly'''  
'''Step 8: Check that the connection is working properly'''  


#Click on "View actual data and check the prices you see there are as you expect
#Click on "View actual data and check the prices you see there are as you expect
#Allow a bit of time for Marriott do process the data you have sent then click on "Update". If  Marriott returns an error message scroll down to the "Troubleshooting" section to see why Marriott sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.
#Allow a bit of time for Marriott do process the data you have sent then click on "Update". If  Marriott returns an error message scroll down to the "Troubleshooting" section to see why Marriott sends the error and how to fix it. If you receive an error which is not listed below send us a support ticket.


== Update existing listings on Marriott==
<span style="color:#019cde; font-size: 150%;“ >{{#fas:info-circle}}  </span>  Marriott reviews each listing manually before setting it live. This normally takes one working day.
Prices and availability will sync automatically.  
 
= Update existing listings on Marriott=
Prices and availability will sync automatically. If you want to change the content of your listing go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > MARRIOTT and click "Send to Marriott" then select what they want to update.
 
=Content=
== Permit IDs ==
If you wish to send permit information you can include it under  {{#fas:cog}} (SETTINGS)  Channel Manager > Property Content > Room Content > Room Description Text
 
== Bedrooms and bathrooms==
If you do not set up any bedrooms or bathrooms we will send one as a default.
 
Bedrooms and bathrooms can be set up  in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SET UP.
 
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> Set up bedrooms and bathroom either in the property OR the room. If you set them up in both you will double them up. Do not send additional bathroom amenities if you have a  full bathrooom.
 
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.
 
*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>Marriott does not support all available features available in Beds24.
 
 
BATHROOM
 
BEDROOM
 
 
BED_TWIN
 
BED_SINGLE
 
BED_DOUBLE
 
BED_QUEEN
 
BED_KING
 
BED_BUNK
 
BED_MURPHY
 
BED_SOFA
 
BED_TODDLER
 
BED_FUTON
 
BED_CRIB
 
BED_AIRMATTRESS
 
== Amenities ==
Amenities can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room ({{#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.
 
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 Cable. In this case you can set up the Cabel in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION. The number will be applied to all room/units.
 
Example 2: You have one unit with Cable and another unit without Cable. In this case set the Cable up in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SET UP.
 
Amenities 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 "Amenities".
*Tick the amenities you provide.
*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>: Marriott does not support all available features available in Beds24.
 
==Pictures==
You can define in  {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > MARRIOTT  > SPECIFIC CONTENT which pictures will be used.
 
Marriott requires 6 or more pictures with minimum resolution of 500 x 800 (must not have watermarks or reference to management company name)
 
==Taxes and Fees==
You can add taxes and fees for Marriott in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > MARRIOTT  > SPECIFIC CONTENT under "Custom". Use the context help<span style="color:#019cde;“ >{{#far:question-circle}}  </span> for details.
 
== All feature codes==
 
BED_TWIN
 
BED_SINGLE
 
BED_DOUBLE
 
BED_QUEEN
 
BED_KING
 
BED_BUNK
 
BED_MURPHY
 
BED_SOFA
 
BED_TODDLER
 
BED_FUTON
 
BED_CRIB
 
BED_AIRMATTRESS
 
BED_CRIB
 
BED_TODDLER
 
 
 
BATH_TUB
 
 
BABYSITTING
 
AIR_CONDITIONING
 
BALCONY
 
BASKETBALL_COURT
 
BEACH
 
BEACH_ESSENTIALS
 
BEACH_FRONT
 
CABLE
 
CHECK_IN_OUT_SELF
 
CO_DETECTOR
 
COFFEE_MAKER
 
CONCIERGE
 
DECK_PATIO_UNCOVERED 
 
DISHWASHER
 
DRYER
 
ELEVATOR
 
FIRE_EXTINGUISHER
 
FIREPLACE
 
FIRST_AID_KIT
 
FITNESS_CENTER
 
GAME_ROOM
 
GAMES
 
GROCERY_SHOPPING_SERVICE
 
HAIR_DRYER
 
HEATING
 
HIGHCHAIR
 
HOME_STEP_FREE_ACCESS
 
HOT_TUB
 
JET_SKIING
 
LAUNDRY
 
MICROWAVE
 
MOUNTAIN_VIEW
 
OCEAN_VIEW
 
OUTDOOR _FURNITURE
 
OUTDOOR_FIREPLACE
 
OVEN
 
PARKING_DISABLED
 
PARKING_INCLUDED
 
PARKING_INDOOR
 
PARKING_VALET
 
PETS_CONSIDERED
 
PETS_NOT_ALLOWED
 
POOL
 
POOL_HEATED
 
POOL_PRIVATE
 
PRIVATE_CHEF
 
PRIVATE_YARD
 
REFRIGERATOR
 
SAUNA
 
SKI_IN  SKI_OUT
 
SKI_STORAGE
 
SMOKE_DETECTOR
 
STOVE
 
TABLE_TENNIS
 
TENNIS
 
TOYS
 
WASHER
 
WATER_SPORTS
 
WATER_VIEW
 
WATERFRONT
 
WHEELCHAIR_YES
 
WIDE_HALLWAY_CLEARANCE
 
= Promotions =
This feature allows you to create discounts for any of your HVMB listings.
Once a promotion has its status enabled, clicking save will send the promotion to your Marriott listing where it will be available immediately.
 
= Troubleshooting and common errors=
''RoomSettings array cannot be missing or empty'''
You need to define which beds you provide in your bedrooms. Go to  {{#fas:cog}} (SETTINGS)  PROPERTIES > ROOMS > SETUP then click on "edit bedrooms" and set your bedrooms and bed configuration for each.
 
''Cancellation Policy Category can not be blank''


= Troubleshooting =
''Account is no longer connected to beds24''
You may have invalid Marriott Listing IDs, please contact support and ask to have them deleted


= Disconnect =
= Disconnect =
Set "Publish" = No in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > MARRIOTT > SPECIFIC CONTENT to take your listing offline.
Set "Publish" = No in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > MARRIOTT > SPECIFIC CONTENT, then under MARRIOTT > MAPPING click the "Send to Marriott" button and confirm to take your listing offline.


Set "Enable" = Disable. Beds24 will then stop data exchange.
Set "Enable" = Disable in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > MARRIOTT > MAPPING Beds24 will then stop data exchange.


If you want to terminate the cooperation with Marriott please contact Marriott support.
If you want to terminate the cooperation with Marriott please contact Marriott support.