Hometogo Mapping: Difference between revisions

Jump to navigation Jump to search
← Older edit
Lesley (talk | contribs)
3,945 edits
 
(35 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.


==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 16: 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 26: Line 30:


'''Bookings'''
'''Bookings'''
Hometogo may not allow same day bookings.


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.


Hometogo does not send confirmation messages. They require these to be sent from Beds24. The confirmation message you have set up in {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT >CONFIRMATION MESSAGES will be sent to the guest.
<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.


== Set up ==


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.


=== Multiple Hometogo accounts ===
'''Properties'''
Each Beds24 account can be connected to one Hometogo account.


*The Homtetogos XML activation is per Beds24 account/subaccount. All properties visible in the account can be connected.
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 .
*If you have different Hometogo accounts you have to make sure that in each Beds24 account activated for Hometogo only the accommodations that belong to the connecting Hometogo account are avaible.


=== Languages ===
== Set up ==
Hometogo will inform you which language is compulsory. It is the language of the Hometogo site you are listed.  If this language is different from the language you use as default language for your booking page you can set it in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER  > HOMETOGO  > SPECIFIC CONTENT.
'''Step 1 - Check which information will send '''


If you need to activate languages go to{{#fas:cog}} (SETTINGS) BOOKING ENGINE > INTERNATIONALISATION.
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > VIEW CONTENT and check what will send.


=== Listings ===
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.
*With a single-unit listing (Listing per = Room - the recommended setting for new connections) a listing is created for every room in Beds24.  
**The "Headline" for the listing comes from "Room Headline" in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > ROOM CONTENT. If this field is empty the "Headline" in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > PROPERTY CONTENT will be used.
**The "Property Name" comes from the "Name" in {{#fas:cog}} (SETTINGS)  PROPERTIES > DESCRIPTION. If you want to give each listing its own property name even though they are in one property in Beds24 you can enter a unique "Name"  for each in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER >HOMETOGO > SPECIFIC ROOM CONTENT.
*With a multi-unit listings (Listing per = Property  NOT RECOMMENDED, only use this option after consulting with your activation specialist) one property in Beds24 is a listing in Hometogo. Rooms are units in this listing.  


If you want to change between listing types you can do this in {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > Hometogo > SPECIFIC PROPERTY CONTENT. Before you change the setting you will need to talk to Hometogo because certain data will get lost.
'''Step 2 - Activate rooms '''


Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > VIEW CONTENT to check if you content meets Hometogos requirements. Any settings which do not meet Hometogos requirements are highlighted on red. Click on the links in the "Settings" column to go to the settings where you can fix the problems.  
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > MAPPING and tick "Enable" for all rooms you want to send to Hometogo.


==== Minimum Requirements ====
'''Step 3 - Check which prices will send '''
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 type
*Maximum number of guests
*Accurate address for each property
*Latitude and longitude for each property
*At least 6 pictures for each listing recommended resolution of 1920x1080.
*Headlines with at least 20 characters
*Each listing must have at least one bedroom and one bathroom
*For online bookings you will need prices and inventory


==== Room Configurations - Define Bedrooms and Bathrooms====
Click on  "View Actual Data"  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 Hometogo.  
Bedrooms and bathrooms 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.
'''Step 4 - Self-onboard to Hometogo'''
*Criteria which only applies to one room should be entered in the room. 


<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.
*Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO > MAPPING and click on "Connect to Homtogo"


<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}}  </span> Do not send additional bathroom amenities if you have a  full bathrooom.
*Fill in the form and press "Submit"


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


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.
When you are  live Hometogo will send you an Email with your personal link to check their properties on HomeToGo.


Bedrooms and bathrooms are configured by feature codes which are entered in the "Features" field.
=== Multiple Hometogo accounts ===
Each Beds24 account can be connected to one Hometogo account.  


*Click on the "Edit " button next to the "Features" field.
Contact us if you have different Hometogo accounts.
*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.
=== Languages ===
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.  


<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.
If you need to activate languages go to {{#fas:cog}} (SETTINGS) BOOKING ENGINE > INTERNATIONALISATION.


==== Amenities, Features and Location Type====
=== Minimum Requirements ===
Amenities and Location Type can be set up for the property (SETTING->PROPERTIES->DESCRIPTION) or per room (SETTING->PROPERTIES->ROOMS->SET UP).
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
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.  
*Property type
 
*Maximum number of guests
Criteria which only applies to one room should be entered in the room.
*Accurate address for each property
 
*Latitude and longitude for each property
Make sure you do not create duplicates.
*At least 10 pictures for each listing recommended resolution of 1920x1080.  
*Headlines with at least 20 characters
*Each listing must have at least one bedroom and one bathroom
*At least 10 amenities
*You will need prices and inventory


 
=== Prices ===
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 161: 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 171: 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.  


=== Payments ===


=== Pictures===
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.
Hometogo supports property pictures and room pictures.
*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.
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.


If you need to change a picture, add or change it's caption text to ensure it gets re-imported by Hometogo.


*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.
Features and amenities are configured by feature codes which are entered in the "Features" field.
*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.
*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 ===
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.


<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 / National Identification Code ===
The value in the property permit setting is sent to Home To Go as the National Identification Code value.


== Activation ==
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.
'''Step 1: Check content ''' 


Go to{{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO  > VIEW CONTENT.
Go to {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > HOMETOGO  > SPECIFIC ROOM CONTENT > CUSTOM and enter the appropriate values.  


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


To update the listing content click on the links on this page.
Available parameters are:


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.
PERMIT - sends National Identification Code. If you only have the PERMIT value, the same value will be sent to both


'''Checklist  - these factors are important for the performance  of your listings'''
PERMITREGIONAL - sends the Registration Number to Hometogo.
*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'''
Examples:


Go to {{#fas:cog}} (SETTINGS)  CHANNEL MANAGER > HOMETOGO > MAPPINGG and tick "Enable".
PERMIT AB01244


== Cancellations ==
This will send AB01244 as National Identification Code for this room to this channel instead of the one defined per property.
If you set a booking to "Cancelled" we will send it as "Cancelled by guest" to Hometogo. If the booking is cancelled by the owner you can set this as a "substatus" via the second selector next to the "Cancelled" status in the "Summary" tab of the booking.


If a different reason for the cancellation applies you can set this by adding one of the following info codes in to "Info" tab of the booking:
PERMITREGIONAL AB01244


CANCELLED_BY_OWNER
This will send AB01244 as Registration Number for this room. Otherwise the value in PERMIT will be sent.


CANCELLED_BY_OWNER_INVALID_CARD
=== Pictures===
If you use external pictures you need to make sure they are .jpg format.


CANCELLED_BY_OWNER_NO_PAYMENT
When the same pictures is in the property and the room we only send it once.


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


<div class="warning">{{#fas:exclamation-triangle}} Never delete bookings from Hometogo because Hometogo expect to read the booking status even if they are cancelled.
== Cancellations ==
</div> 
If you or your guest needs to cancel a booking, open the booking in Beds24, Summary tab, set the Status = Cancelled.


== Updates ==
== Updates ==
Line 686: Line 674:


ROMANTIC
ROMANTIC


==Common Errors==
==Common Errors==
Retrieved from "https://wiki.beds24.com/index.php/Hometogo_Mapping"