FIAS PMS Connector

FIAS (Fidelio Interface Application Specification) enables integration with Fidelio Hotel PMS systems.

The plugin manages hotel guests as users on the Loxone Miniserver and synchronizes them with the PMS.
On check-in, a user is created for the guest and assigned to the group corresponding to the room ID. On check-out, the user is automatically deleted.
When Key Services are enabled, NFC keys can be encoded and assigned to the guest for door access or external services (e.g., charging electric vehicles).

This plugin supports FIAS Protocol Version 2.10.
Miniserver Gen. 1 is not supported.

Table of Contents


Room Outputs

Each configured room provides the following outputs:

OutputDescription
Check-In PulsePulse when the PMS reports a check-in
Check-Out PulsePulse when the PMS reports a check-out
Check-In Status0 = checked out, 1 = checked in
Reservation NumberActive reservation number
Guest Name / Guest First Name / Guest TitleGuest identity
Guest LanguageGuest language preference
Guest Arrival Date / Guest Departure DateStay dates as Loxone timestamps (seconds since 2009-01-01; Guest Arrival Date: 0:00 of the arrival day; Guest Departure Date: 24:00 of the departure day)

Supported PMS Commands

CommandDescription
Guest Check-In (GI)Receives check-in notifications including full guest data
Guest Check-Out (GO)Receives check-out notifications
Database Refresh (DR)Synchronizes all rooms after connection
Link Management (LS/LA/LE/LD/LR)Automatic connection and keepalive handling
User-definable fields A0-A9Currently only the email address is automatically parsed; other fields can be used manually
Key ServicesKey Request (KR), Key Answer (KA), Key Delete (KD), Key Read (KZ)

Configuration

Add the FIAS PMS Connector plugin to the network periphery:

In the plugin properties, enter the PMS server address and port.

The plugin automatically connects and maintains synchronization with the PMS.

Select a user with User Management permissions. This user is used by the plugin to automatically manage guests and their NFC tags.

Key Services

Key Services enable NFC-based key encoding and reading via the PMS.
When enabled, the plugin establishes a dedicated connection to the PMS Key Service port.

  • Activate: Set "Server Port Key Services" to the PMS Key Service port. If different from the main port, a second TCP connection is established.

  • Deactivate: Set "Server Port Key Services" to 0.

Key Options (1–20): Each option is assigned to a Loxone user group.
If the PMS requests a key with a specific option, the guest user is added to the corresponding group.
Rights assigned via Key Options can only be added, not removed, and provide additional permissions beyond the room user group.

1. Adding Rooms

When rooms are added via CSV import or room search, the plugin automatically creates a corresponding user group with the same name as the room ID.

Via CSV import:
Click "Load Configuration" and select a CSV file with the room list. All rooms in the CSV file are automatically created in the plugin.

CSV Example:

The floor information is optional.

Via PMS Search:
If the PMS allows Database Refresh, rooms can be added directly via the "Search rooms" button.

Manually:
Click "Add Room" and enter the room ID in the properties window (e.g., "101" or "E37").

Do not manually change plugin names, user names, or group names – synchronization will be broken.

2. Adding Keycoders

Keycoders are physical NFC devices used to encode and read guest NFC tags. Each keycoder in the PMS must be registered in the plugin.

Click "Add Keycoder", enter the ID (identifier from PMS, e.g., "Encoder 1"), and assign the corresponding NFC Code Touch (device physically installed at this location).

Multiple keycoders can be added (e.g., one per floor or at the reception).


Functionality & Limitations

  • User Management
    - Check-In: Checks if a user already exists → updates data or creates a new user. Automatic group assignment according to room ID.
    - Check-Out: Users are automatically deleted at check-out. Deletion only occurs if the check-out event contains both room ID and reservation number.

  • Fallback Check-Out: Guests are automatically checked out at 23:00 on their scheduled departure date if no GO event is received. The default time is 23:00 but can be overridden in the settings.

  • Consistency: Do not manually change plugin names, user names, or group names – this will break synchronization.


NFC Tags (Key Services)

  • Timeout Default 10 seconds for learning and reading operations.

  • Tag Types: Both encrypted and unencrypted NFC tags can be used.

  • External Billing via FIAS: Only unencrypted tags are supported (e.g., charging electric vehicles). The physical NFC ID is returned to the PMS/FIAS system.

  • Encrypted Tags: Billing is handled via the Miniserver (e.g., Wallbox / EV charging via Loxone).


Diagnostic Inputs

SummaryDescriptionUnitValue Range
Online Status FIAS PMS ConnectorIndicates whether the device can be reached by the Miniserver.
Diagnostics for Air devices
Diagnostics for Tree devices
Diagnostics for Extensions
Digital0/1




Properties

SummaryDescriptionValue RangeDefault Value
Server AddressAddress of the PMS-Server.--
Server PortPort of the PMS-Server.0...65535-
Server Port Key ServicesPort which is used for key services. When different to 'Server Port', a second TCP Connection is established. 0 = Key Services disabled.0...65535-
Checkout Fallback TimeTime of departure day at which the user will be automatically removed. Default 23:00.--
Database RefreshWhen enabled database refresh (DR) is used after connection to sync all room informations. Users are not added if an Check-in Event was missed (GI).--
Hide Checkout WarningsWhen enabled, no system status warning is generated when a checkout fails (e.g. when reservation number is missing).--
Monitor serviceIf checked, you will be notified by the System Status or Cloud Mailer if this service is no longer available or offline.--
UserThe plugin gains access to the same user interface as the selected user--