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

Obsah


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)Po připojení synchronizuje všechny místnosti
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

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.

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


Vstupy pro diagnostiku

Krátký popisPopisJednotkyRozsah hodnot
Online status FIAS PMS konektorUvádí, zda je zařízení dostupné pro Miniserver.
Diagnostika Air zařízení
Diagnostika Tree zařízení
Diagnostika Extensionu
Digital0/1




Vlastnosti

Krátký popisPopisRozsah hodnotVýchozí hodnota
Adresa serveruAdresa serveru PMS.--
Port serveruPort PMS-serveru.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).--
Monitorovat službuPokud je tato možnost zaškrtnuta, budete o nedostupnosti nebo offline stavu této služby informováni prostřednictvím Stavu Systému nebo Cloud Maileru.--
UživatelPlugin má přístup ke stejné vizualizaci jako vybraný uživatel--