Onity for Mews Operations

Front Office OperationsIntegrations SetupMews MarketplaceMews Operations

Connecting your key encoders to Mews Operations is a great way to cut down on check-in time and simplify processes. After you set up the Onity integration, you can cut keys directly in Mews Operations without ever needing to use the Onity Interface System. 

 

ⓘ
Note
  • For properties using the older Onity system, the manufacturer no longer supports this product. You can still connect, but Mews cannot assist and therefore recommends upgrading your door lock solution to a more recent version.
  • If you have any problems, contact the Mews Support Team by submitting a support ticket through the Mews Digital Assistant.



In this article you can learn about:

 

Pre-requisites for the set up

  • To use the Onity integration, you need to install the Onity Interface System and Mews Connector on the same computer at your property.
  • If you don't have Mews Connector installed at your property yet, you can see our help article for instructions on how to install it here.
 

How to set up the Onity integration

Step 1: Install and create the Onity integration

Before you can set up the Onity integration, you must have the Onity Interface System, either Onity or Onity OnPortal installed on a computer at your property. To run the Onity Interface System:

  1. Open the Onity Interface System on your computer.
  2. Go to Configuration > Station Configuration, and:
  • Make sure to select Enable PMS Communication.
  • Note down the Service Number (Onity) or Port (Onity OnPortal), which you need when creating the Onity integration in Mews Operations.
  • Make sure to select TCP under Type.

 

Step 2: Set up the integration in Mews Connector

 

  1. In Mews Connector, go to Settings.
  2. Select Fias settings.
  3. In the Fias server port field, enter the port number taken from the Onity application, for example, 2887.
  4. Leave Client mode unticked.
  5. Select Enabled.
  6. Click Save.

 

Mews Connector FIAS port settings

 

Step 3: Create the integration in Mews Operations


To create the integration:

  1. Open Mews Operations .
  2. Go to the main menu Main menu in Mews Operations  > Marketplace.
  3. In the Facility management category, under Key cutter integration click Explore.
  4. Then click Connect integration.
  5. In the Name field, enter “Onity.”
  6. In the API URL field, enter the IP address 127.0.0.1 and the Service Number, found in the Onity Interface System, or Port number, only for Onity OnPortal, in the following format: http://127.0.0.1:[Service or Port number]. For example, if your Service/Port number is 6666, enter http://127.0.0.1:6666 in this field.
  7. Leave the Username and Password fields blank.
  8. Click Create. Then, click OK.

 

Step 4: Set up the Onity key cutters

After you create the Onity integration in Mews Operations, you can set up your key cutters.

  1. In the Onity integration settings, click Key cutters.
  2. Click the + button.
  3. In the Name field, enter a name that reflects the cutter's location or is easy for staff to identify. 
  4. In the Identifier field, for Onity, or Station ID field, for Onity OnPortal, enter the Address Number found in the Onity Interface System. Note: To find the Address Number, go to the Client tab in the Onity Interface System. 
  5. In the Data JSON field, enter one of the following configurations based on your property type and key preferences:

 

Option A: Standard hotel setup (physical or mobile keys)

Use this option if your property issues one set of keys per reservation and does not allow multiple guests to check into the same space independently.

 

To create mobile and physical keys:



{
 "Type":"IndustryStandardProtocol", 
 "MobileKeyType":"Onity",
 "EncoderKeys": "true" 
}



To create only mobile keys:


{
 "Type":"IndustryStandardProtocol", 
 "MobileKeyType":"Onity",
 "EncoderKeys": "false" 
}


Note: Guests receive mobile keys by email. Always check that the guest's email address is correct in their customer profile.


 


Option B: Hostel setup (physical keys, multiple guests for one space)


Use this if your property allows different guests to check into the same space at different times and you need to issue separate keys for each person.


{
 "Type":"IndustryStandardProtocol", 
 "DuplicateKeyAllowed":"True"
}


 


Option C: Hostel setup with mobile keys


Use this if you operate a hostel and issue both mobile and physical keys for the same space to multiple guests.


 


To create mobile and physical keys:


{
 "Type":"IndustryStandardProtocol", 
 "DuplicateKeyAllowed":"True",
 "MobileKeyType":"Onity",
 "EncoderKeys": "true"
}


 


To create only mobile keys:


{
 "Type":"IndustryStandardProtocol", 
 "DuplicateKeyAllowed":"True",
 "MobileKeyType":"Onity",
 "EncoderKeys": "false"
}


 


Note: Duplicate keys do not mean copies of the same key. They allow different keys to unlock the same door for the duration of a guest's stay. This setup does not apply to standard hotels where each reservation corresponds to a single room or space.
 


  1. Click Create.


Repeat steps 1 - 6 for every Onity key cutter that you use at your property.



 


Step 5: Map Onity key cutters in Mews Operations


If your space numbers in Mews Operations and the Onity Interface System do not match exactly. For example, "004" and "4" is not an exact match, you must create key cutter mappings for all of your spaces.


  1. In the Onity integration settings, click Key cutter mappings.
  2. Click the + button.
  3. Under Room, select a space number from the drop-down list.
  4. In the Lock identifier field, enter the corresponding space number as listed in the Onity Interface System.
  5. Click Create.


Repeat steps 1 - 5 for every space that you need to map in Mews Operations.



 


Step 6: Activate your key cutters


  1. Go to the main menu Main menu in Mews Operations  > Marketplace > My subscriptions.
  2. Locate the Key cutter integration, and click on Edit to go to the settings page. 
  3. Select the Enabled checkbox.
  4. Click Save.


 


Step 7: Enable Return MIFARE card UID option for keys


  1. Go to the Configuration menu.
  2. Click on PMS set up button.
  3. Click on the RETURN MIFARE CARD UID check box to enable it. 


 


Troubleshooting


If your encoder isn't creating keys,


  • check the Device Commands Queue to find out the reason.
  • copy the link in the Notes or search by the response message.




 

 




 


Was this article helpful?
00



Feedback