Difference between revisions of "Jomres"

From Booking Automation Wiki
Jump to: navigation, search
m
m
 
Line 4: Line 4:
 
[[Category:Troubleshooting]]
 
[[Category:Troubleshooting]]
 
<div class="heading">Jomres</div>
 
<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.
+
  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]]
 
 
<div class="warning">{{#fas:exclamation-triangle}} '''Coming soon!''' For the Jomres plugin use [[Jomres_Plugin|these instructions]].</div> 
 
  
 
=Capabilities=
 
=Capabilities=
Line 15: Line 13:
 
=Limitations=
 
=Limitations=
 
*Inventory exports are currently limited to single room properties.
 
*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=
 
=Set Up=

Latest revision as of 13:46, 26 June 2020

Jomres
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

  • BookingAutomation can export inventory.
  • BookingAutomation can export prices (tariffs).
  • BookingAutomation 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 BookingAutomation.
  4. Ensure that property permissions ('Get property', 'Set property', 'Channel Management' and 'Get data as part of a webhook communication') are ticked.

Jomres api client id.png view large

Jomres API System Client ID/Secret

To get your Jomres API System Client ID and Secret:

  1. Log into Wordpress and navigate to the Jomres tab on the sidebar.
  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 BookingAutomation.

Jomres system api key.png view large

BookingAutomation

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

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

Jomres api setup.png 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.

Jomres room codes.png 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.

Jomres ui prices.png view large


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