FIAS PMS konektor

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, all user groups are removed from the user, revoking every access right. The user itself is deleted by the Miniserver at the checkout fallback time.
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.

Obsah

• Room Outputs
• Supported PMS Commands
• Topology
• Configuration
• Functionality & Limitations
• NFC Tags (Key Services)
• Vstupy, výstupy, vlastnosti

Room Outputs↑

Each configured room provides the following outputs:

Supported PMS Commands↑

Topology↑

The FIAS PMS Connector plugin is configured on one Miniserver and connected to the PMS. Guest users are created on this Miniserver and their permissions are managed there.
The permissions are then distributed to additional Miniservers in the building via Trust or Gateway Client.

Configuration↑

Přidejte plugin FIAS PMS Connector do síťových periferií:

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

The plugin automatically connects and maintains synchronization with the PMS.

The connection to the PMS does not require a login (no username or password required). The Miniserver establishes an unencrypted TCP connection to the configured PMS server address and port. Connection handling and maintaining the connection are performed automatically in the background.
The plugin does not continuously poll the PMS. It listens on the existing connection for incoming messages and periodically sends an keep-alive message to verify that the connection is still active.

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.

Key Options must be coordinated with the PMS system. The Key Options configured in the PMS determine which user group must be assigned on the LOXONE side.

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.

The room ID corresponds to the room identifier stored in the PMS (usually the room number). It is defined when adding the room via CSV import, PMS search, or manually, and must match the PMS identifier to correctly assign check-in and check-out notifications to the corresponding room.
For each room ID, the plugin automatically creates a user group with the same name. Guests are assigned to this group during check-in, and their permissions are managed through this group.

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

The Keycoder must be connected directly to the Miniserver. Keycoders connected to a Client (Extension or Client Miniserver) are not supported.

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., multiple keycoders at reception, self-service terminals, or other locations).

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. The user's Debitor field is filled with <Room ID>#<Reservation Number> (e.g. U15#32733).
  - Check-Out: All user groups are removed from the user at check-out, so every access right is revoked immediately. The user record itself is kept and is deleted by the Miniserver at the checkout fallback time on the departure date. Group removal only occurs if the check-out event contains both room ID and reservation number.

• Fallback Check-Out: Guests are automatically checked out on their scheduled departure date at the checkout fallback time if no check-out event is received. At that time the Miniserver also deletes the guest user. The default time is 23:00 and can be changed in the settings.

• Consistency: Do not manually change plugin names, user names, or user 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 can be handled via the Miniserver or LOXONE Exosphere (e.g., Wallbox / EV charging via LOXONE).

Vstupy pro diagnostiku↑

Vlastnosti↑