Difference between revisions of "Jomres"

From Beds24 Wiki
Jump to navigation Jump to search
Beds24>IuriRosa
(→‎Set up)
 
m (1 revision imported)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Category:How to]]
 
[[Category:How to]]
−
[[Category:Channel Manager]]
+
[[Category:Apps]]
−
[[Category:Channel_Manager_and_API]]
 
−
[[Category:Error Messages from Channels]]
 
 
[[Category:Set up Instructions]]
 
[[Category:Set up Instructions]]
−
  ''This page explains how to use the channel manager with Jomres''
+
[[Category:Troubleshooting]]
−
The Jomres plugin gives you an interface to the channel manager which you can use to synchronise your booking channels. Jomres creates the properties in Beds24. You set up the channel manager in Beds24 to connect to the channels.
+
[[Category:PMS_Integrations]]
 +
<div class="heading">Jomres</div>
 +
This page is about the menu This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > JOMRES and explains how to set up an integration with Jomres. For the Jomres plugin use [[Jomres_Plugin|these instructions]]
  
 +
=Capabilities=
 +
*Beds24.com can export inventory.
 +
*Beds24.com can export prices (tariffs).
 +
*Beds24.com can import bookings.
  
−
[[Image:jomres.jpg|center|500px]]
+
=Limitations=
 +
*Inventory exports are currently limited to single room properties.
 +
*Only Jomres SRP properties can be connected, Jomres MRP properties are not yet supported.
  
−
==Capabilities==
+
=Set Up=
−
The capabilities of the connection depend on the channel. With booking.com and many others we have a two way XML connection so Beds24.com can export inventory and prices and import bookings and modifications to bookings. [[Channel_Manager_Capabilities|Check the capabilities of the channels you want to use]]
 
  
−
*Jomres can send multiple prices and one minimum stay for each room for each date.
+
==Jomres plugins==
−
*If you need more complex pricing (e.g multiple channels with different prices for each)  you have the option to create them in Beds24.
+
Your version of Jomres must be v9.22.0 or greater.
−
*Beds24 sends  bookings back to Jomres.
 
  
−
==What you will need==
+
You will need to install the following plugin, it can be found under the 'Core plugins' tab in your Jomres installation.
−
*Accounts with the booking channels you want to use
+
*Channelmanagement Framework - v1.7 or greater.
−
*A Beds24 account. You can sign up  [http://beds24.com/join.html here].
 
−
*The Jomres  [https://www.jomres.net/ plugin]
 
  
−
==Where to get help==
+
You will also need to install the following plugins which can be found under the 'Core API plugins' tab.
−
For issues regarding the interchange of data between Jomres and Beds24 please refer to your Jomres plugin support.
+
*Api Feature Cmf - v0.9 or greater.
 +
*Api Feature Tariffs - v1.0 or greater.
 +
*Api Feature Webhooks - v0.6 or greater.
  
−
For issues regarding the setup and data interchange between Beds24 and Channels please contact Beds24 support.
+
==Jomres API keys==
 +
You will need to get two sets of credentials from Jomres:
 +
*Jomres API Client ID/Secret
 +
*Jomres API System Client ID/Secret
  
−
==Set up==
+
=== Jomres API Client ID/Secret ===
 +
To get your Jomres API Client ID and Secret:
 +
# Navigate to the Manage Properties section of your Jomres installation and click Account Details then App Key Management.
 +
# Click the View button next to the API client you wish to use or click the New button to create a new client.
 +
# You will need the Client ID and Secret from this page to synchronise the inventory, prices and bookings of your Jomres properties with Beds24.
 +
# Ensure that property permissions ('Get property', 'Set property', 'Channel Management' and 'Get data as part of a webhook communication') are ticked.
  
−
<div style="display:none">
+
[[Image:jomres_api_client_id.png|400px|link=]]
 +
[[Media:jomres_api_client_id.png|view large]]
  
−
By default Jomres is designed to be a multi-vendor booking platform. Managers who have their own beds24 accounts can import their properties to and from beds24 securely.  
+
=== Jomres API System Client ID/Secret ===
 +
To get your Jomres API System Client ID and Secret:
 +
# Log into Jomres.
 +
# Click Tools then REST API test.
 +
# You will need the System Client ID and Secret from this page to connect your Jomres properties to Beds24.
  
−
There are two-ways you can make the connection,
+
[[Image:jomres_system_api_key.png|700px|link=]]
 +
[[Media:jomres_system_api_key.png|view large]]
  
−
1. Single Connection
+
==Beds24==
−
  - Jomres is connected to one master account in Beds24, every manager in Jomres that has access to a connected property can send updated to Beds24. The API key in jomres needs to be set on the administration area in Jomres under Settings > Site configuration > Integration
 
  
−
2. Multiple connections
+
'''Step 1: Enter your Jomres credentials'''
−
  - Each manager will have to connect using the api key, in this connection please leave the "above" setting "Blank"
+
#Enter your Jomres URL.
 +
#Enter your API Key (Jomres API Client ID).
 +
#Enter your API Secret (Jomres API System Client ID
 +
#Click the Save button
  
−
</div>
+
'''Step 2: Create channel'''
−
*The connection is initiated from Jomres. Please follow the instructions for the Jomres plugin.  
+
#Click the View all listings button.
 +
#You will see a message stating "Channel does not exist".
 +
#If you wish to simply connect all properties in your Jomres installation, enter your Jomres System Client ID and Secret and click the Create channel and connect all properties button. You may skip step 3.
 +
#If you wish to select which properties to connect, click the Create channel button.
  
−
<embedvideo service="youtube">https://youtu.be/-bWOoJsZXIg</embedvideo>
+
'''Step 3: Connect your Jomres properties'''
  
−
Test the connection is working by:
+
After your channel has been created, you will see a table of all properties in your Jomres installation.
−
* 1) Checking the prices/availability have been sent to Beds24 correctly.
+
#Enter your Jomres System Client ID and Secret.
−
* 2) Making a test booking in Beds24 and check it imports to Jomres
+
#Click the Connect button in the Status column of properties you wish to connect.
 +
You may also connect all properties at once by clicking the Connect all button.
 +
The links in the More info column will retrieve additional information about the property from your Jomres installation.
  
−
Enable the prices for Channel Management
+
Return to the Jomres setup page in Beds24.com.
−
*You can enable the Jomres price rows for channel management at the menu Settings  >  Properties  > Rooms  > Daily Prices .
+
# Enter the Property ID of the now connected Jomres property.
 +
[[Image:jomres_api_setup.png|700px|link=]]
 +
[[Media:jomres_api_setup.png|view large]]
  
−
Connect to the Channels
+
'''Step 4: Connect rooms and synchronise inventory, prices and bookings'''
−
*Go to SETTINGS->CHANNEL MANAGER in the Beds24 control panel and connect the channels you want to use. You will find specific set up instructions for each channel when you click on HELP or habe a look [[:category:Channel_Manager|here]].
+
#Enter the Jomres room type ID into the Room ID field. Clicking the get codes button will display a list of room types for this property.
 +
#Enter the Jomres tariff type ID into the Tariff ID field. Clicking the get codes button will display a list of tariff types for this room.
 +
#Tick the inventory, prices and bookings boxes to synchronise them.
 +
[[Image:jomres_room_codes.png|700px|link=]]
 +
[[Media:jomres_room_codes.png|view large]]
  
−
Set up in Beds24 is free and you can do it yourself. Beds24 is designed as a self service system with context sensitive help, extensive documentation and a free-of-charge ticket support system.
+
=Viewing updated tariffs and availability in Jomres=
 +
#Navigate to the property page in Jomres.
 +
#Click Properties, then Preview.
 +
#Scroll down to the blue tabs and click the Availability or Accommodation Prices tab.
  
−
==Bookings==
 
−
Bookings can only import into Jomres if there is a price in the price field. If the channel did not send a price Beds24 will use the the min price for the room. Make sure your setting for SETTINGS->ROOMS->SETUP "Minimum Price" is greater than 0 so these bookings can import
 
  
−
=== Why did a booking not import?===
+
[[Image:jomres_ui_prices.png|700px|link=]]
−
*When checking why bookings fail to go from Jomres to Beds24 it is best to start with the Jomres log, please log-into your Jomres (administrator back-end) > Jomres > Tools > Log Files > Beds24v2.application.log
+
[[Media:jomres_ui_prices.png|view large]]
  
−
You should be able to see the exact reason why a booking did not import or export.
+
=Tariff Settings=
 +
The following tariff settings can be changed by logging into Jomres:
  
−
==Redirect to Jomres Booking page==
+
*Tariff name/description
−
You can use the Booking Redirect URL setting to redirect traffic from the Beds24 booking page to your Jomres booking page.
+
*Max days (Maximum days of the visit)
−
This can be used with tripconnect, the facebook app etc. so the guest does not see the Beds24 page.
+
*Min/max people (Minimum/maximum number of people for a tariff to be valid)
 +
*Day of week (Check-in day of week allowed)
 +
*Ignore PPPN (charge per person per night)
 +
*Allow weekend (Allow bookings that span weekend days)
 +
*Min/max rooms already selected (room/tariff combinations that are only offered if the guest has already selected another room in the booking form)
  
−
To pass collected dates to Jomres add the following to the end of your Jomres booking page URL
 
−
 
−
&start=[FIRSTNIGHTDD/MM/YYYY]&end=[LEAVINGDAYDD/MM/YYYY]
 
  
−
To show your Jomres booking page within the facebook app it will need to be hosted with a secure certificate and the URL must start with '''https://'''
+
=Common Errors=
 +
*You will need two different API keys that can be found in different locations in your Jomres installation.
 +
*Properties must have their tariff configuration set to 'micromanage'. Beds24 will automatically change this configuration if necessary when a property is connected. If the tariff configuration of a connected property is manually changed to something other than 'micromanage', prices will not be able to be synchronised.
 +
*Bookings are not being imported - check the plugin 'Api Feature Webhooks' is installed and up to date.
  
−
== Managing Bookings ==
+
=Disconnect=
−
Do not delete bookings from Beds24. Deleted bookings can not be updated. Instead set the status to "Cancelled". Beds24 will then send the "Cancelled" status to Jomres.
+
To disconnect a property:
−
 
+
#Click the View all listings button.
−
 
+
#In the status column, click the Disconnect button for the property you wish to disconnect.
−
Bookings which have been manually added in Beds24 will also be sent to Jomres. If not open the booking go to the "Logs" tab and click on "Resend Notify".
 

Latest revision as of 01:33, 19 May 2021

Jomres
This page is about the menu  This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > JOMRES and explains how to set up an integration with Jomres. For the Jomres plugin use these instructions

Capabilities

  • Beds24.com can export inventory.
  • Beds24.com can export prices (tariffs).
  • Beds24.com can import bookings.

Limitations

  • Inventory exports are currently limited to single room properties.
  • Only Jomres SRP properties can be connected, Jomres MRP properties are not yet supported.

Set Up

Jomres plugins

Your version of Jomres must be v9.22.0 or greater.

You will need to install the following plugin, it can be found under the 'Core plugins' tab in your Jomres installation.

  • Channelmanagement Framework - v1.7 or greater.

You will also need to install the following plugins which can be found under the 'Core API plugins' tab.

  • Api Feature Cmf - v0.9 or greater.
  • Api Feature Tariffs - v1.0 or greater.
  • Api Feature Webhooks - v0.6 or greater.

Jomres API keys

You will need to get two sets of credentials from Jomres:

  • Jomres API Client ID/Secret
  • Jomres API System Client ID/Secret

Jomres API Client ID/Secret

To get your Jomres API Client ID and Secret:

  1. Navigate to the Manage Properties section of your Jomres installation and click Account Details then App Key Management.
  2. Click the View button next to the API client you wish to use or click the New button to create a new client.
  3. You will need the Client ID and Secret from this page to synchronise the inventory, prices and bookings of your Jomres properties with Beds24.
  4. Ensure that property permissions ('Get property', 'Set property', 'Channel Management' and 'Get data as part of a webhook communication') are ticked.

400px view large

Jomres API System Client ID/Secret

To get your Jomres API System Client ID and Secret:

  1. Log into Jomres.
  2. Click Tools then REST API test.
  3. You will need the System Client ID and Secret from this page to connect your Jomres properties to Beds24.

700px view large

Beds24

Step 1: Enter your Jomres credentials

  1. Enter your Jomres URL.
  2. Enter your API Key (Jomres API Client ID).
  3. Enter your API Secret (Jomres API System Client ID
  4. Click the Save button

Step 2: Create channel

  1. Click the View all listings button.
  2. You will see a message stating "Channel does not exist".
  3. If you wish to simply connect all properties in your Jomres installation, enter your Jomres System Client ID and Secret and click the Create channel and connect all properties button. You may skip step 3.
  4. If you wish to select which properties to connect, click the Create channel button.

Step 3: Connect your Jomres properties

After your channel has been created, you will see a table of all properties in your Jomres installation.

  1. Enter your Jomres System Client ID and Secret.
  2. Click the Connect button in the Status column of properties you wish to connect.

You may also connect all properties at once by clicking the Connect all button. The links in the More info column will retrieve additional information about the property from your Jomres installation.

Return to the Jomres setup page in Beds24.com.

  1. Enter the Property ID of the now connected Jomres property.

700px view large

Step 4: Connect rooms and synchronise inventory, prices and bookings

  1. Enter the Jomres room type ID into the Room ID field. Clicking the get codes button will display a list of room types for this property.
  2. Enter the Jomres tariff type ID into the Tariff ID field. Clicking the get codes button will display a list of tariff types for this room.
  3. Tick the inventory, prices and bookings boxes to synchronise them.

700px view large

Viewing updated tariffs and availability in Jomres

  1. Navigate to the property page in Jomres.
  2. Click Properties, then Preview.
  3. Scroll down to the blue tabs and click the Availability or Accommodation Prices tab.


700px view large

Tariff Settings

The following tariff settings can be changed by logging into Jomres:

  • Tariff name/description
  • Max days (Maximum days of the visit)
  • Min/max people (Minimum/maximum number of people for a tariff to be valid)
  • Day of week (Check-in day of week allowed)
  • Ignore PPPN (charge per person per night)
  • Allow weekend (Allow bookings that span weekend days)
  • Min/max rooms already selected (room/tariff combinations that are only offered if the guest has already selected another room in the booking form)


Common Errors

  • You will need two different API keys that can be found in different locations in your Jomres installation.
  • Properties must have their tariff configuration set to 'micromanage'. Beds24 will automatically change this configuration if necessary when a property is connected. If the tariff configuration of a connected property is manually changed to something other than 'micromanage', prices will not be able to be synchronised.
  • Bookings are not being imported - check the plugin 'Api Feature Webhooks' is installed and up to date.

Disconnect

To disconnect a property:

  1. Click the View all listings button.
  2. In the status column, click the Disconnect button for the property you wish to disconnect.
Retrieved from "http://co-reception.com/wiki/index.php?title=Jomres&oldid=16810"