FIAS PMS Connector

FIAS (Fidelio Interface Application Specification) umożliwia integrację z systemami PMS Fidelio Hotel.

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

Ta wtyczka obsługuje protokół FIAS w wersji 2.10. Urządzenie Miniserver Gen. 1 nie jest obsługiwane.

Spis treści

• Wyjścia dla pomieszczeń
• Obsługiwane polecenia PMS
• Topology
• Konfiguracja
• Funkcjonalność i ograniczenia
• NFC Tags (Key Services)
• Wejścia, wyjścia, właściwości

Wyjścia dla pomieszczeń↑

Każde skonfigurowane pomieszczenie zapewnia następujące wyjścia:

Obsługiwane polecenia PMS↑

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.

Konfiguracja↑

Dodaj wtyczkę FIAS PMS Connector do urządzeń peryferyjnych sieci:

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

Wtyczka automatycznie łączy się z systemem PMS i utrzymuje z nim synchronizację.

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.

Wybierz użytkownika posiadającego uprawnienia do zarządzania użytkownikami. Wtyczka wykorzystuje tego użytkownika do automatycznego zarządzania gośćmi i ich tagami NFC.

Key Services

Key Services umożliwiają kodowanie i odczyt kluczy w technologii NFC za pośrednictwem systemu PMS.
Po włączeniu wtyczka nawiązuje dedykowane połączenie z portem usługi kluczy systemu PMS.

• Aktywacja: Ustaw opcję 'Server Port Key Services' na port usługi kluczy PMS. Jeśli różni się on od portu głównego, nawiązywane jest drugie połączenie TCP.

• Deaktywacja: Ustaw "Server Port Key Services" na 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. Dodawanie pokoi

Gdy pokoje są dodawane poprzez import pliku CSV lub wyszukiwanie pokoi, wtyczka automatycznie tworzy odpowiednią grupę użytkowników o nazwie zgodnej z identyfikatorem pokoju.

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.

Poprzez import z pliku CSV:
Kliknij „Załaduj konfigurację” i wybierz plik CSV zawierający listę pomieszczeń. Wszystkie pomieszczenia z pliku CSV zostaną automatycznie utworzone w wtyczce.

Przykład pliku CSV:

Podanie informacji o piętrze jest opcjonalne.

Wyszukiwanie za pośrednictwem systemu PMS:
Jeśli system PMS umożliwia odświeżanie bazy danych, pokoje można dodawać bezpośrednio za pomocą przycisku „Wyszukaj pokoje”.

Ręcznie:
Kliknij „Dodaj pokój” i wprowadź identyfikator pokoju w oknie właściwości (np. „101” lub „E37”).

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

2. Dodawanie koderów kluczy

Koder kluczy to fizyczne urządzenie NFC służące do kodowania i odczytu tagów NFC gości. Każdy kodownik w systemie PMS musi zostać zarejestrowany w wtyczce.

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

Kliknij „Dodaj kodownik”, wprowadź identyfikator (z systemu PMS, np. „Encoder 1”) i przypisz odpowiedni kod NFC Touch (urządzenie fizycznie zainstalowane w tej lokalizacji).

Multiple keycoders can be added (e.g., multiple keycoders at reception, self-service terminals, or other locations).

Funkcjonalność i ograniczenia↑

• 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 Domyślnie 10 sekund dla operacji uczenia się i odczytu.

• Rodzaje tagów: Można stosować zarówno zaszyfrowane, jak i niezaszyfrowane tagi NFC.

• Rozliczenia zewnętrzne za pośrednictwem FIAS: Obsługiwane są wyłącznie niezaszyfrowane tagi (np. ładowanie pojazdów elektrycznych). Fizyczny identyfikator NFC jest zwracany do systemu PMS/FIAS.

• Encrypted Tags: Billing can be handled via the Miniserver or LOXONE Exosphere (e.g., Wallbox / EV charging via LOXONE).

Wejścia diagnostyczne↑

Właściwości↑