Hometogo Mapping: Difference between revisions

Jump to navigation Jump to search
← Older edit
No edit summary
Lesley (talk | contribs)
3,945 edits
 
(31 intermediate revisions by 4 users not shown)
Line 4: Line 4:


<div class="heading">Hometogo</div>
<div class="heading">Hometogo</div>
  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO and explains how to set up an XML connection with Hometogo.
  This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > MAPPING and explains how to set up an XML connection with Hometogo.


=Coming Soon=
<div style="display:none">
==General==
==General==
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
*[[:Category:Channel Manager|Click here]] for general information on how the channel manager works.
*Via this interface you will be visible on other Hometogo brands such as e-domizil,  Atraveo, Wimdu, Tripping and Casamundo
*This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
*This tutorial explains how to [[Setting_Prices_for_Booking_Channels|set prices for channels]].
*Use the [https://www.hometogo.com/connection-guide/zk3u5/ Hometogo Property Manager Handbook] for information on how to work with Hometogo.


== Capabilities ==
== Capabilities ==
Line 19: Line 18:
*Beds24 sends date changes made in Beds24 and status changes to "Cancelled" to Hometogo
*Beds24 sends date changes made in Beds24 and status changes to "Cancelled" to Hometogo


== Limitations ==
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  Hometogo prioritises onboarding projects based on the number of properties. If you do not have a large number of properties it might take several weeks or even month for Hometogo to get back to you.


== Limitations ==
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> Cancellations are sent from Hometogo via email to the Property, manual updates are required in Beds24. Open the booking and in the Summary tab set the Status = Cancelled.


== Before you connect ==
== Before you connect ==
Line 31: Line 32:


Only bookings made after the connection is established will be imported and can be managed. Existing bookings can be imported via iCal or manually.
Only bookings made after the connection is established will be imported and can be managed. Existing bookings can be imported via iCal or manually.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> Cancellations are sent from Hometogo via email to the Property, manual updates are required in Beds24. Open the booking and in the Summary tab set the Status = Cancelled.


Hometogo will send confirmation messages to guests. If you want to send an additional confirmation message you can set up an Auto Action in {{#fas:cog}} (SETTINGS)  GUEST MANAGEMENT >AUTO ACTIONS.
Hometogo will send confirmation messages to guests. If you want to send an additional confirmation message you can set up an Auto Action in {{#fas:cog}} (SETTINGS)  GUEST MANAGEMENT >AUTO ACTIONS.
'''Properties'''
The connection works per Beds24 account/subaccount. You will need to make all properties you want to connect available in the Beds24 account which is connected to Hometogo .


== Set up ==
== Set up ==
Line 38: Line 46:


Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > VIEW CONTENT and check what will send.
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > VIEW CONTENT and check what will send.
Any settings which do not meet Hometogos requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.


'''Step 2 - Activate rooms '''
'''Step 2 - Activate rooms '''


Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > MAPPING and tick "Enable" for all rooms you want to send to Hometogo.
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > MAPPING and tick "Enable" for all rooms you want to send to Hometogo.
If you see a red button "Fix Content Errors" your content does not meet Hometogos requirements. Click on the button. Any settings which do not meet Hometogos requirements are highlighted on red. Click on the links to go to the settings where you can fix the problems.


'''Step 3 - Check which prices will send '''
'''Step 3 - Check which prices will send '''
Line 52: Line 60:


*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > MAPPING and click on "Connect to Homtogo"
*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > MAPPING and click on "Connect to Homtogo"
*Fill in the form and press "Submit"
*Fill in the form and press "Submit"


All listings which meet Hometogo's requurements and are activated will be sent to Hometogo. Hometogo will then begin integration process and reach out to you if required.  
All listings which meet Hometogo's requirements and are activated will be sent to Hometogo. Hometogo will then begin integration process and reach out to you if required.  


When you are  live Hometogo will send you an Email with your personal link to check their properties on HomeToGo.
When you are  live Hometogo will send you an Email with your personal link to check their properties on HomeToGo.


=== Multiple Hometogo accounts ===
=== Multiple Hometogo accounts ===
Line 67: Line 75:
English content is mandatory. If you have content in other languages than English Hometogo will use the language which matches the language of the Homtogo site you signed up with.  
English content is mandatory. If you have content in other languages than English Hometogo will use the language which matches the language of the Homtogo site you signed up with.  


If you need to activate languages go to{{#fas:cog}} (SETTINGS)  BOOKING ENGINE > INTERNATIONALISATION.
If you need to activate languages go to {{#fas:cog}} (SETTINGS)  BOOKING ENGINE > INTERNATIONALISATION.


==== Minimum Requirements ====
=== Minimum Requirements ===
To send property information to Hometogo, the following information must be entered into Beds24 to meet the Hometogo minimum content requirement for listings:
To send property information to Hometogo, the following information must be entered into Beds24 to meet the Hometogo minimum content requirement for listings:
*Property name
*Property name
Line 82: Line 90:
*You will need prices and inventory
*You will need prices and inventory


==== Room Configurations - Define Bedrooms and Bathrooms====
=== Prices ===
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.
 
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>Hometogo does not support all features Beds24 offers. For a list of all feature codes Hometogo supports see "All feature codes" below.
 
==== Amenities, Features and Location Type====
Amenities and Location Type 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 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 Wifi. In this case you can set up the Wifi in SETTING->PROPERTIES->DESCRIPTION. The number will be applied to all room/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.
 
 
Features and 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.
 
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Adding "cleaning" features and a "location type" is very important for your performance. You add them manually.  Bedrooms and bathrooms and amenities can also be inserted manually. For more information see "All feature codes" below.
 
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> For a list of all feature codes and location types Hometogo supports see "All feature codes" below.
 
==== Prices ====
In {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO > SPECIFIC ROOM CONTENT you can set which type of price you want to send.
In {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO > SPECIFIC ROOM CONTENT you can set which type of price you want to send.


With '''Per Occupancy Pricing'''  a price for each occupancy defined in Beds24 and prices for different length of stay can be sent.
With '''Per Occupancy Pricing'''  a price for each occupancy defined in Beds24 and prices for different length of stay can be sent.


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.


"Max Stay" set in the CALENDAR or rates can be sent.  
"Max Stay" set in the CALENDAR or prices can be sent.  


<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> Hometogo occupancy pricing only support minimum stays up to 30 days.  
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> Hometogo occupancy pricing only support minimum stays up to 30 days.  
Line 165: Line 130:
For example '''*[CONVERT:IDR-EUR]''' will convert Indonesian Rupees to Euros.
For example '''*[CONVERT:IDR-EUR]''' will convert Indonesian Rupees to Euros.


===== Taxes & Fees=====
===== Fees & Taxes =====
Taxes and fees can be added in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO > SPECIFIC ROOM CONTENT under "Custom".  
Taxes and fees can be added in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO > SPECIFIC ROOM CONTENT under "Custom".  


Line 175: Line 140:
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  A Cleaning fee is required by Hometogo and if it is not set by one of these methods a value of zero will automatically be sent. You can enter the cleaning fee in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER- > PROPERTY CONTENT->ROOM CONTENT.
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span>  A Cleaning fee is required by Hometogo and if it is not set by one of these methods a value of zero will automatically be sent. You can enter the cleaning fee in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER- > PROPERTY CONTENT->ROOM CONTENT.


==== Pets====
=== Children===
If you allow children set the number of children which are allowed or "Dont ask" in the setting for  "Maximum Children" in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP.
 
=== Pets===
If you do not allow pets you choose "Pets not allowed" as feature in SETTING->PROPERTIES-> DESCRIPTION. Fees for pets can be set as custom values in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO  > SPECIFIC ROOM CONTENT.
If you do not allow pets you choose "Pets not allowed" as feature in SETTING->PROPERTIES-> DESCRIPTION. Fees for pets can be set as custom values in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO  > SPECIFIC ROOM CONTENT.


==== Policies ====
=== Policies ===
You can set the minimum age via a "Custom" value in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER  > HOMETOGO  > SPECIFIC ROOM CONTENT.
You can set the minimum age via a "Custom" value in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER  > HOMETOGO  > SPECIFIC ROOM CONTENT.


===== Cancellation Policy =====
===== Cancellation Policy =====
Hometogo requires a  cancellation policy. We will send the policies set in SETTING->PROPERTIES-> DESCRIPTION.
Hometogo requires a  cancellation policy. We will send the policies set in {{#fas:cog}} (SETTINGS) BOOKING ENGINE.


You can can which policy applies in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO  > SPECIFIC ROOM CONTENT
You can select which policy applies in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO  > SPECIFIC ROOM CONTENT


If you want to send a custom cancellation policy you need to set the actual poly in "Custom" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > SPECIFIC ROOM CONTENT.  
If you want to send a custom cancellation policy you need to set the actual poly in "Custom" in {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > SPECIFIC ROOM CONTENT.  
Use the context help <span style="color:#007bff;“ >{{#far:question-circle}}  </span> for detailed instructions.
Use the context help <span style="color:#007bff;“ >{{#far:question-circle}}  </span> for detailed instructions.


===== Children=====
=== Room Configurations - Define Bedrooms and Bathrooms===
If you allow children set the number of children which are allowed or "Dont ask" in the setting for  "Maximum Children" in SETTING->PROPERTIES-> ROOMS -> SETUP.
Bedrooms and bathrooms can be set up  in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS->SET UP.
 
*Click on the "edit bedrooms"  or "edit bathrooms" butten
*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.
 
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>Hometogo does not support all features Beds24 offers. For a list of all feature codes Hometogo supports see "All feature codes" below.
 
=== Amenities, Features and Location Type===
Amenities and Location Type can be set up for the property ({{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION) or per room ({{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP.).
 
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 Wifi. In this case you can set up the Wifi in {{#fas:cog}} (SETTINGS) PROPERTIES > DESCRIPTION. The number will be applied to all room/units.
 
Example 2: You have one unit with  Wifi one and another unit without Wifi. In this case set the Wifi up in {{#fas:cog}} (SETTINGS) PROPERTIES > ROOMS > SETUP.
 
 
Features and 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.
 
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> Adding "cleaning" features and a "location type" is very important for your performance. You add them manually. Bedrooms and bathrooms and amenities can also be inserted manually. For more information see "All feature codes" below.
 
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> For a list of all feature codes and location types Hometogo supports see "All feature codes" below.


=== Payments ===
=== Payments ===
If you do not use Hometogo Payment solutions go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO  > SPECIFIC PROPERTY CONTENT to set which payment method you accept.


=== Pictures===
=== Permit / National Identification Code ===
Hometogo supports property pictures and room pictures.
The value in the property permit setting is sent to Home To Go as the National Identification Code value.
*The pictures activated as  "Property Pictures" in {{#fas:cog}} (SETTINGS) BOOKING ENGINE > PICTURES will be sent for the property. Make sure you have enabled at least 6 property pictures per listing.
*The pictures activated as "Room Pictures" in {{#fas:cog}} (SETTINGS)  BOOKING ENGINE > PICTURES will be sent for the room. If there are no room pictures then offer pictures will be sent for the room.
*If your listings are per room property pictures are used for the first room listing only and room pictures are used for the other room listings.


If you use external pictures you need to make sure they are .jpg format.
Custom values can be defined to specify specific values for this channel only. This will override the values you have set generally. Add the parameters one per line.  


If you need to change a picture, add or change it's caption text to ensure it gets re-imported by Hometogo.
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO  > SPECIFIC ROOM CONTENT > CUSTOM and enter the appropriate values.  


*With a single-unit listing (Listing per Room)  room pictures are sent first (in property section) and property pictures in room settings so not all listings look the same.
*With a multi-unit listings (Listing per Property) property pictures send first.


When the same pictures is in the property and the room we only send it once.
Available parameters are:


<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span>  Make sure you add captions to your pictures. Please see the pictures help page for instructions.
PERMIT - sends National Identification Code. If you only have the PERMIT value, the same value will be sent to both


== Activation ==
PERMITREGIONAL - sends the Registration Number to Hometogo.
'''Step 1: Check content ''' 


Go to{{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO  > VIEW CONTENT.
Examples:


If you do not meet the minimum requirements Hometogo will reject all data sent.
PERMIT AB01244


To update the listing content click on the links on this page.  
This will send AB01244 as National Identification Code for this room to this channel instead of the one defined per property.


To check which information is sent to Hometogo go to {{#fas:cog}} (SETTINGS)  > CHANNEL MANAGER > HOMETOGO > VIEW CONTENT. This will show you the raw data.  A click on "View Actual Data" will show you which prices are sent.
PERMITREGIONAL AB01244


'''Checklist  - these factors are important for the performance  of your listings'''
This will send AB01244 as Registration Number for this room. Otherwise the value in PERMIT will be sent.
*Choose your headline carefully and make sure your key (first) picture and your headline work together.
*Recommended are 24 ''pictures", make sure  all have captions.
*Add '''Location Type ''' feature so your listing will show in location based searches.
*Add ''cleaning''' features''.  


'''Step 2:  Enable rooms'''
=== Pictures===
If you use external pictures you need to make sure they are .jpg format.


Go to {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO > MAPPING and tick "Enable".  
When the same pictures is in the property and the room we only send it once.


Hometogo will read content data every 20 hours. They will skip all rooms/properties which do not meet their criteria.  
<span style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span>  Make sure you add captions to your pictures. Please see the pictures help page for instructions.


== Cancellations ==
== Cancellations ==
If you or your guest needs to cancel a booking you/the guest will need to contact Hometogo support.  
If you or your guest needs to cancel a booking, open the booking in Beds24, Summary tab, set the Status = Cancelled.


== Updates ==
== Updates ==
Line 679: Line 674:


ROMANTIC
ROMANTIC


==Common Errors==
==Common Errors==
Line 687: Line 681:
     open https: //www.beds24.com/api/Hometogo.com/HA-3.4/unitRates?roomid=XXXXX&show=novalidation '''
     open https: //www.beds24.com/api/Hometogo.com/HA-3.4/unitRates?roomid=XXXXX&show=novalidation '''
  Please check you have selected the Channel (Hometogo) in your RATES (Channel Tab) or Daily Prices (Enable)
  Please check you have selected the Channel (Hometogo) in your RATES (Channel Tab) or Daily Prices (Enable)
</div>
Retrieved from "https://wiki.beds24.com/index.php/Hometogo_Mapping"