FIAS (Fidelio Interface Application Specification) umożliwia integrację z systemami PMS Fidelio Hotel.
Wtyczka zarządza gośćmi hotelowymi jako użytkownikami na serwerze Loxone Miniserver i synchronizuje ich z systemem PMS.
Podczas check-in tworzony jest użytkownik dla gościa i przypisywany do grupy odpowiadającej identyfikatorowi pokoju. Podczas wymeldowania użytkownik jest automatycznie usuwany.
Gdy włączona jest funkcja Key Services, można zakodować klucze NFC i przypisać je gościowi w celu uzyskania dostępu do drzwi lub skorzystania z usług zewnętrznych (np. ładowania pojazdów elektrycznych).
![]() | 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
- 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:
| Wyjście | Opis |
|---|---|
| Impuls przy Check-In | Wysyła sygnał impulsowy, gdy system PMS zgłosi zameldowanie |
| Impuls Check-Out | Wykonuje sygnał impulsowy, gdy system PMS zgłosi wymeldowanie |
| Status Check-In | 0 = checked out, 1 = checked in |
| Numer rezerwacji | Numer aktywnej rezerwacji |
| Nazwisko gościa / Imię gościa / Tytuł gościa | Tożsamość gościa |
| Język gościa | Preferencje językowe gości |
| Data przyjazdu gościa / Data wyjazdu gościa | Daty pobytu w postaci znaczników czasu Loxone (liczone w sekundach od 1 stycznia 2009 r.; data przyjazdu gościa: godz. 0:00 dnia przyjazdu; data wyjazdu gościa: godz. 24:00 dnia wyjazdu) |
Obsługiwane polecenia PMS↑
| Polecenie | Opis |
|---|---|
| Rejestracja gości (GI) | Otrzymuje powiadomienia o zameldowaniu wraz z pełnymi danymi gości |
| Wymeldowanie gości (GO) | Otrzymuje powiadomienia o checks-out |
| Odświeżanie bazy danych (DR) | Po nawiązaniu połączenia synchronizuje wszystkie pokoje |
| Link Management (LS/LA/LE/LD/LR) | Automatic connection and keepalive handling |
| User-definable fields A0-A9 | Currently only the email address is automatically parsed; other fields can be used manually |
| Key Services | Key Request (KR), Key Answer (KA), Key Delete (KD), Key Read (KZ) |
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ę. |
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 Services (1–20): Każda opcja jest przypisana do jednej z grup użytkowników Loxone.
Jeśli system PMS zażąda Key z określoną opcją, użytkownik-gość zostanie dodany do odpowiedniej grupy.
Uprawnienia przypisane za pomocą Key Options można jedynie dodawać, a nie usuwać; zapewniają one dodatkowe uprawnienia wykraczające poza zakres uprawnień grupy użytkowników pokoju.
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.
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”).
![]() | Nie należy ręcznie zmieniać nazw wtyczek, nazw użytkowników ani nazw grup – spowoduje to zakłócenie synchronizacji. |

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.
Kliknij „Dodaj kodownik”, wprowadź identyfikator (z systemu PMS, np. „Encoder 1”) i przypisz odpowiedni kod NFC Touch (urządzenie fizycznie zainstalowane w tej lokalizacji).
![]() | Można dodać wiele urządzeń do kodowania kluczy (np. po jednym na każdym piętrze lub w recepcji). |

Funkcjonalność i ograniczenia↑
Zarządzanie użytkownikami
- Zameldowanie: Sprawdza, czy użytkownik już istnieje → aktualizuje dane lub tworzy nowego użytkownika. Automatyczne przypisanie do grupy na podstawie identyfikatora pokoju.
- Wymeldowanie: Użytkownicy są automatycznie usuwani podczas wymeldowania. Usunięcie następuje tylko wtedy, gdy zdarzenie wymeldowania zawiera zarówno identyfikator pokoju, jak i numer rezerwacji.Rezerwowy Check-Out: Goście są automatycznie odprawiani o godz. 23:00 w dniu planowanego wyjazdu, jeśli nie otrzymano żadnego zdarzenia typu GO. Domyślna godzina to 23:00, ale można ją zmienić w ustawieniach.
Spójność: Nie należy ręcznie zmieniać nazw wtyczek, nazw użytkowników ani nazw grup – spowoduje to zakłócenie synchronizacji.
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.
Zaszyfrowane tagi: Rozliczenia są obsługiwane przez Miniserver (np. stacja ładowania Wallbox / ładowanie pojazdów elektrycznych za pośrednictwem Loxone).
Wejścia diagnostyczne↑
| Krótki opis | Opis | Jednostka | Zakres wartości |
|---|---|---|---|
| Status online FIAS PMS Connector | Wskazuje, czy urządzenie jest dostępne przez Miniserver. Diagnostyka urządzeń Air Diagnostyka urządzeń Tree Diagnostyka rozszerzeń | Cyfrowy | 0/1 |
Właściwości↑
| Krótki opis | Opis | Zakres wartości | Wartość standardowa |
|---|---|---|---|
| Adres serwera | Adres serwera PMS. | - | - |
| Port serwera | Port serwera PMS. | 0...65535 | - |
| Key Services związane z portami serwerowymi | Port używany do obsługi Key Services. Jeśli różni się od „Portu serwera”, nawiązywane jest drugie połączenie TCP. 0 = Key Services wyłączone. | 0...65535 | - |
| Czas rezerwowy Checkout | Godzina w dniu wyjazdu, o której użytkownik zostanie automatycznie usunięty. Domyślnie 23:00. | - | - |
| Odświeżanie bazy danych | Po nawiązaniu połączenia, w przypadku włączonej funkcji odświeżania bazy danych (DR), następuje synchronizacja wszystkich informacji o pokojach. Użytkownicy nie są dodawani, jeśli nie odnotowano zdarzenia zameldowania (GI). | - | - |
| Ukryj ostrzeżenia dotyczące Checkout | Po włączeniu tej opcji w przypadku niepowodzenia Checkout (np. gdy brakuje numeru rezerwacji) nie jest generowane żadne ostrzeżenie o stanie systemu. | - | - |
| Monitoruj usługę | Jeśli zaznaczone, zostaniesz powiadomiony przez Status systemu lub Cloud Mailer, jeśli ta usługa nie jest już dostępna lub jest offline. | - | - |
| Użytkownik | Plugin ma dostęp do tej samej wizualizacji, co wybrany użytkownik | - | - |
