Knowledge Base
Learn about top features of our solutions. Get help whenever you need.
How to work with VingCard locks in Exely PMS
Integrate VingCard and Exely PMS to easily assign an electronic key to a specific room.
Once the integration is set up, you can quickly issue a key card for a room directly in Exely PMS when a guest checks in.
The WebSocket protocol, which is used to exchange data, officially supports Windows 8 and higher. If your Windows operating system version is lower than 8, update your OS to work with electronic keys.
Pay attention: the steps provided in this article must be performed on a computer in a key management software provided by VingCard — VISIONLINE. However, this software should be turned off before installing and using Exely Agent.
Install and configure Exely Agent
Exely Agent is an app for Windows which is used for data exchange between VISIONLINE and Exely PMS. Exely Agent allows coding electronic keys in Front Desk.
1. In the Exely extranet, go to “Property management” > “Settings” > “Electronic keys” and download Exely Agent.
Note: Windows 7 does not support websocket. Exely Agent does not work on Windows 7 or below. It is available on Windows 8 and 10.
2. To get access to the file, go to “Downloads” on your computer, right-click the downloaded file and select “Extract All”. In the opened window, select the folder which the files will be extracted to, tick the “Show extracted files when complete” check-box and click the “Extract All” button.
3. Open the extracted file and follow the setup wizard instructions.
4. After successfully installing Exely Agent, launch the application.
5. Once the application is launched, a notice that the application cannot connect to the server without a key will be shown in the lower right-hand corner. You need to enter the key.
For this, go to “Property management” > “Settings” > “Electronic keys” and select VingCard in the “System” drop-down field. Then, copy the key indicated in the “Key for integration with external system” field.
6. Find Exely Agent in the taskbar, right-click the icon and select “Settings”.
7. In the opened window, enter the property ID in the “Property ID in Exely” field. Paste the integration key from the “Key for integration with external system” field into the “Secret access key” field.
Set up VISIONLINE
1. Open VISIONLINE and enter the login and password. Go to “Lists” > “Devices” and click “Add”.
2. A new window will be opened:
in the “Name” field, enter any name;
the “Description” field can be left empty;
in the “Type” drop-down list, select “PMS Plus (TCP/IP)”;
indicate 127.0.0.1 in the “IP address” field;
in the “Port” field, set 4000;
click “New”.
Pay attention: If you plan starting Exely Agent on a different computer, enter the IP address of that computer and make sure the Firewall settings on the computer where VISIONLINE is installed allow incoming TCP-connection via the port indicated in the “Port” field.
3. Make sure the card encoder in VISIONLINE has the “Server” mode set up and not the “Computer” mode.
If you already have the device set up with the “Computer” location, duplicate it with the “Server” location or delete it and set up a new device with the “Server” location. To create a new device:
go to “Lists” > “Devices” and click “Add”.
indicate any name;
select the “Mifare/RFID” type;
in the “Reader name” drop-down list, select the encoder;
indicate the PMS address: enter any number from 1 to 99. Make sure there are no other devices with the same PMS address in VISIONLINE;
click “New”.
Set up Exely PMS
1. In the Exely extranet, go to “Property management” > “Settings” > the “Electronic keys” tab.
2. In the “Name of computer with VISIONLINE” field, enter the name or IP address of a computer with VISIONLINE installed. If Exely Agent and VISIONLINE work on the same computer, indicate 127.0.0.1 address.
3. In the “VISIONLINE TCP-port” field, enter 4000.
4. In the “Code of the cards reading/coding device”, enter the same number indicated in the “PMS address” field in the VISIONLINE settings (see point 3 in the “Set up VISIONLINE” instructions above).
5. Go to “Property management” > “Room Inventory” > the “Rooms” tab and make sure all rooms in the “Lock system nubmer” column are indicated the same way as in the "Doors" section in VISIONLINE.
If these names do not match, you will not be able to code the keys from Exely PMS.
Click the room number in the list. Use the numbers from the "Doors" section in VISIONLINE to fill in the "Lock system number" field.
Click the "Save" button at the top of the page. Integration with VingCard electronic keys is set up.
Issue keys
To issue a key to the guest’s booked room, left-click the required booking in the Front Desk and click the “Key card issuance” button in the opened sidebar.
Or open the booking details page and click "Create key".
The key validity period is automatically set according to the guest’s check-in and check-out time. Select the number of keys and click “Confirm”.
Place the key card onto the VingCard encoder device to program the key.
View the list of keys provided
To see the room and the date for the issued key, go to “Property management” > “Settings” > the “Electronic keys” tab and scroll to “List of keys provided”.