Jomres

From Beds24 Wiki
Revision as of 16:14, 21 December 2020 by Annette (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Jomres
This page is about the menu  This page is about the menu  (SETTINGS) APPS & INTEGRATIONS > JOMRES and explains how to set up an integration with Jomres. For the Jomres plugin use these instructions.

1 Capabilities

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

2 Limitations

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

3 Set Up

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

3.2 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

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

Jomres api client id.png view large

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

Jomres system api key.png view large

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

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

4 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

5 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)


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

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