Connect Hometogo to Beds24 with an XML connection to create your listings at Hometogo, send your prices and availability, and import bookings. Your listings also show on other Hometogo brands, such as e-domizil, Atraveo, Wimdu, Tripping and Casamundo. For working with Hometogo itself, see the Hometogo Property Manager Handbook.
Quick Guide
- Check your content in Settings > Channel Manager > Hometogo > View Content and fix anything highlighted in red.
- In Settings > Channel Manager > Hometogo > Mapping, tick Enable for the rooms and check View Actual Data.
- Click Connect to Hometogo, fill in the form and click Submit.
- Wait for Hometogo's email with the link to your live listings.
Table of Contents
- Capabilities and limitations
- Before you connect
- Connect Hometogo
- Minimum content requirements
- Prices, fees and taxes
- Listing content
- Bookings, cancellations and updates
- Hometogo feature codes
- Troubleshooting
Capabilities and limitations
- Beds24 exports listing content (creates listings at Hometogo), prices and availability.
- Beds24 imports bookings.
- Beds24 sends date changes made in Beds24, and status changes to Cancelled, to Hometogo.
- Hometogo emails cancellations to the property. Update them manually in Beds24: open the booking and, on the Summary tab, set Status = Cancelled.
- Hometogo prioritises onboarding by number of properties. With only a few properties, Hometogo may take several weeks or even months to get back to you.
For the full list, see Channel Manager Capabilities.
Before you connect
- Beds24 only sends availability when you have prices that are active for Hometogo. See Setting Prices for Booking Channels.
- Hometogo pulls the data from Beds24, so your changes may not show in their extranet straight away. Hometogo always requests live availability before it allows a booking.
- Beds24 imports and manages only bookings made after you connect. Import existing bookings by iCal or enter them manually, see Existing bookings.
- Hometogo sends confirmation messages to guests. To send your own confirmation too, set up an Auto Action in Settings > Guest Management > Auto Actions.
- The connection works per Beds24 account or subaccount. Make all properties you want to connect available in the account that is connected to Hometogo.
- Each Beds24 account can connect to one Hometogo account. If you have several Hometogo accounts, contact Beds24.
Connect Hometogo
Step 1: Check what Beds24 will send
Go to Settings > Channel Manager > Hometogo > View Content. Settings that don't meet Hometogo's requirements are highlighted in red; click the links to fix them. See Minimum content requirements.
Step 2: Activate your rooms
Go to Settings > Channel Manager > Hometogo > Mapping and tick Enable for all rooms you want to send to Hometogo.
Step 3: Check the prices Beds24 will send
Click View Actual Data. If you see no prices or availability, check that you have prices active for Hometogo.
Step 4: Onboard to Hometogo
- In Settings > Channel Manager > Hometogo > Mapping, click Connect to Hometogo.
- Fill in the form and click Submit.
Expected result: Beds24 sends all activated listings that meet Hometogo's requirements. Hometogo starts the integration and contacts you if needed. When you're live, Hometogo emails you a personal link to check your properties on Hometogo.
Minimum content requirements
To send a listing to Hometogo, enter all of these in Beds24:
- Property name and property type
- Maximum number of guests
- An accurate address, latitude and longitude for each property
- At least 10 pictures for each listing, recommended resolution 1920x1080
- Headlines with at least 20 characters
- At least one bedroom and one bathroom per listing
- At least 10 amenities
- Prices and inventory
Languages: English content is required. If you have content in other languages, Hometogo uses the language that matches the Hometogo site you signed up with. To activate languages, go to Settings > Booking Engine > Internationalisation.
Prices, fees and taxes
Choose the price type in Settings > Channel Manager > Hometogo > Specific Room Content.
| Price type | What Beds24 sends |
|---|---|
| Per Occupancy Pricing | A price for each occupancy defined in Beds24, and prices for different lengths of stay. With fixed prices: 1 person, 2 person and room price (room price for the specified occupancy); several prices with different occupancies can be sent; extra person and extra child prices, and discounts on the Discounts tab, can't be sent. With daily prices: the daily price including occupancy; several occupancy prices can be sent; the extra person price is sent. Max Stay set in the calendar or prices can be sent. Minimum stays are supported up to 30 days. |
| Per Day Pricing | One room price per date. With several prices active for Hometogo with different minimum stays, Beds24 sends the price with the lowest minimum stay. You can also set the number of guests the price applies to, an extra person price, and a long stay discount (applied to the room price only, not extras; Hometogo stay discounts are cumulative). |
- With Per Day Pricing, Hometogo applies the minimum stay to the arrival date only, not to every night of the booking.
- If you use daily prices with an extra person price, set the daily price for the maximum occupancy and add the extra person price as a negative value, so the price for full occupancy can be sent.
- Pricing Policy in Specific Room Content: with Guaranteed, Hometogo uses the price Beds24 sent for the booking. With Quoted, Hometogo requests the price for the dates and number of guests from Beds24.
- Click View Actual Data in Settings > Channel Manager > Hometogo > Mapping to check the prices and availability Beds24 will send.
Price multiplier
Enter the multiplier in the Price Multiplier field in Settings > Channel Manager > Hometogo > Mapping, for example *1.23. It applies to all prices and fees Beds24 sends. See Price multiplier for all options, including currency conversion.
Fees and taxes
- Add taxes and fees under Custom in Settings > Channel Manager > Hometogo > Specific Room Content. They can apply as a flat fee, a percentage, per day or per guest. The context help next to the setting explains the details.
- Taxes and fees set as stay collected aren't added to the booking price.
- Hometogo requires a cleaning fee. If you don't set one, Beds24 sends a cleaning fee of zero. You can enter it in Settings > Channel Manager > Property Content > Room Content.
- If you don't use Hometogo's payment solutions, set the payment methods you accept in Settings > Channel Manager > Hometogo > Specific Property Content.
Listing content
Children, pets and policies
- Children: if you allow children, set Maximum Children to the number allowed, or to Dont ask, in Settings > Properties > Rooms > Setup.
- Pets: if you don't allow pets, choose the feature Pets not allowed in Settings > Properties > Description. Set pet fees as custom values in Settings > Channel Manager > Hometogo > Specific Room Content.
- Minimum age: set it as a Custom value in Settings > Channel Manager > Hometogo > Specific Room Content.
- Cancellation policy: Hometogo requires one. Beds24 sends the policies set in Settings > Booking Engine; choose which applies in Settings > Channel Manager > Hometogo > Specific Room Content. For a custom policy, enter it in Custom there. The context help explains the details.
Bedrooms and bathrooms
- Go to Settings > Properties > Rooms > Set Up and click edit bedrooms or edit bathrooms.
- Set the type and use the selectors to define the facilities in each. Define every bedroom and bathroom.
- Close the pop-up and click Save.
Amenities, features and location type
Set up amenities and location type for the property in Settings > Properties > Description, or per room in Settings > Properties > Rooms > Setup. Property settings apply to all rooms in the property, so use them for what all rooms share, and room settings for what only one room has. Don't enter the same item in both. For example, if all units have Wi-Fi, set it once for the property; if only one unit has Wi-Fi, set it for that room.
- Click Edit next to the Features field.
- In the pop-up, click Amenities and tick the amenities you provide.
- Close the pop-up and click Save.
Tip: Cleaning features and a location type matter a lot for your performance on Hometogo. Add them by hand with feature codes. Hometogo doesn't support every Beds24 feature.
Permit and national identification code
Beds24 sends the value of the property permit setting to Hometogo as the National Identification Code. To send different values to Hometogo for a room, enter custom parameters, one per line, in Settings > Channel Manager > Hometogo > Specific Room Content > Custom. They override your general values.
| Parameter | Example | What it sends |
|---|---|---|
PERMIT |
PERMIT AB01244 |
AB01244 as the National Identification Code for this room, instead of the property value. If you only set PERMIT, the same value goes to both fields. |
PERMITREGIONAL |
PERMITREGIONAL AB01244 |
AB01244 as the Registration Number for this room. Without it, the PERMIT value is sent. |
Pictures
- External pictures must be in .jpg format.
- If the same picture is on both the property and the room, Beds24 sends it once.
- Add captions to your pictures, see Pictures.
Bookings, cancellations and updates
- Cancellations: if you or your guest cancels, open the booking in Beds24 and, on the Summary tab, set Status = Cancelled.
- Updates: Beds24 sends changes to availability and prices instantly. Hometogo pulls other changes with its next poll.
Hometogo feature codes
You can type these codes into the Features field exactly as shown, separated by spaces. Put the bedroom or bathroom type first, then the codes for what is in that room. Add one type code for each room.
| Example | Features field |
|---|---|
| One bedroom with a double bed and a crib | BEDROOM BED_DOUBLE BED_CRIB |
| Three bathrooms with different features | BATHROOM BIDET COMBO_TUB_SHOWER BATHROOM BIDET BATHROOM_HALF TOILET |
| Television, internet and beach view | TELEVISION INTERNET BEACH_VIEW |
Bathroom types
Add one code for each bathroom, followed by its amenity codes.
BATHROOM BATHROOM_HALF BATHROOM_SHOWER
Bathroom amenities
Put these after the bathroom type they belong to. Add one code for each feature.
BIDET COMBO_TUB_SHOWER JETTED_TUB OUTDOOR_SHOWER SHOWER TOILET TUB
Bedroom types
Add one code for each bedroom, followed by its bed codes.
BEDROOM BEDROOM_LIVING_SLEEPING_COMBO BEDROOM_OTHER_SLEEPING_AREA
Bedroom amenities
Put these after the bedroom type they belong to. Add one code for each bed.
BED_BUNK BED_CHILD BED_CRIB BED_DOUBLE BED_KING BED_MURPHY BED_QUEEN BED_SOFA BED_SINGLE
Nearest features
Join three parts with underscores: the feature type, the distance unit and the number, for example NEAREST_BEACH_KILOMETERS_3 or NEAREST_BAR_METERS_200.
Feature types:
NEAREST_AIRPORT NEAREST_BEACH NEAREST_GOLF NEAREST_RESTAURANT NEAREST_TRAIN NEAREST_BAR NEAREST_FERRY NEAREST_HIGHWAY NEAREST_SKI
Distance units:
KILOMETRES METRES MILES MINUTES
Location type
BEACH BEACH_FRONT BEACH_VIEW DOWNTOWN GOLF_COURSE_FRONT GOLF_COURSE_VIEW LAKE LAKE_FRONT LAKE_VIEW MOUNTAIN MOUNTAIN_VIEW NEAR_OCEAN OCEAN_FRONT OCEAN_VIEW RESORT RIVER RURAL SKI_IN SKI_OUT TOWN VILLAGE WATER_VIEW WATERFRONT
Other features
LIVING_ROOM FIREPLACE WOOD_STOVE HEATING AIR_CONDITIONING ELEVATOR TELEPHONE HAIR_DRYER ICEMAKER IRON_BOARD LINENS TOWELS DRYER WASHER BALCONY DECK_PATIO_UNCOVERED LANAI_GAZEBO_COVERED GARDEN GRILL GAME_ROOM VERANDA GARAGE PARKING_POSSIBLE PARKING_PAID EV_CHARGER BOOKS DVD FOOSBALL GAMES MUSIC_LIBRARY TABLE_TENNIS POOL_TABLE CABLE SATELLITE STEREO TV TOYS VIDEO_GAMES VIDEO_LIBRARY BREAKFAST_NONE BREAKFAST_POSSIBLE BREAKFAST_INCLUDED PRIVATE_CHEF INTERNET KITCHEN DINING_AREA DINING_ROOM COFFEE_MAKER DISHES_UTENSILS DISHWASHER HIGHCHAIR MICROWAVE OVEN REFRIGERATOR SPICES STOVE TOASTER OUTDOOR_LIGHTING OUTDOOR_FIREPLACE FIRE_EXTINGUISHER FIRST_AID_KIT MEDICAL_EMERGENCY_CONTACT POLICE_EMERGENCY_CONTACT FIRE_EMERGENCY_CONTACT SMOKE_DETECTOR CO_DETECTOR DEADBOLT_LOCK EMERGENCY_EXIT_ROUTE PETS_CONSIDERED PETS_NOT_ALLOWED HOT_TUB MASSAGE POOL POOL_HEATED POOL_INDOOR POOL_PRIVATE SAUNA B_AND_B CAR_AVAILABLE CHAUFFEUR CHECK_IN_OUT_SELF CLEANING_DISINFECTANT CLEANING_ENHANCED CLEANING_INCLUDED CLEANING_POSSIBLE CONCIERGE GUEST_HOUSE HOTEL SHOP BASKETBALL_COURT BICYCLE BOAT CROSS_COUNTRY_SKIING FISHING FITNESS_ROOM GOLF HIKING HORSE_RIDING HUNTING ICE_SKATING JET_SKIING KAYAK_CANOE KAYAKING MOUNTAIN_BIKING MOUNTAIN_CLIMBING MOUNTAINEERING PARASAILING RAFTING SAILING SPORTS_SNORKELING_DIVING SKIING SKIING_WATER SNOW_SPORTS_GEAR SNOWBOARDING SNOWMOBILING SPELUNKING SURFING SWIMMING TUBING_WATER WATER_SPORTS WHITEWATER_RAFTING WIND_SURFING CAR_NECESSARY CAR_RECOMMENDED CAR_NOT_NECESSARY CHILDREN_NOT_ALLOWED CHILDREN_WELCOME EVENTS_ALLOWED SMOKING_ALLOWED SMOKING_NOT_ALLOWED WHEELCHAIR_YES WHEELCHAIR_NO BAY COIN_LAUNDRY DUTY_FREE HEALTH_BEAUTY_SPA MARINA MUSEUMS THEME_PARKS WATER_PARKS WINERY_TOURS ZOO ANTIQUING BIRD_WATCHING ECO_TOURISM GAMBLING OUTLET_SHOPPING PADDLE_BOATING SHOPPING SLEDDING WHALE_WATCHING WILDLIFE_VIEWING FITNESS_CENTER HOSPITAL LAUNDROMAT FAMILY HISTORIC ROMANTIC
Troubleshooting
Errors Hometogo reports show when you check the links in the Hometogo settings.
| Error | Likely cause | Resolution |
|---|---|---|
| internal error constructing XML | The Hometogo channel isn't selected in your prices | Select Hometogo on the Channel tab of your rates, or under Enable in your daily prices. To see the faulty XML, open the URL below with your room ID. |
https://www.beds24.com/api/Hometogo.com/HA-3.4/unitRates?roomid=XXXXX&show=novalidation
For general causes and fixes, see Troubleshooting in How the Channel Manager works.