FIAS PMS Connector

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ń

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

WyjścieOpis
Impuls przy Check-InWysyła sygnał impulsowy, gdy system PMS zgłosi zameldowanie
Impuls Check-OutWykonuje sygnał impulsowy, gdy system PMS zgłosi wymeldowanie
Status Check-In0 = checked out, 1 = checked in
Numer rezerwacjiNumer aktywnej rezerwacji
Nazwisko gościa / Imię gościa / Tytuł gościaTożsamość gościa
Język gościaPreferencje językowe gości
Data przyjazdu gościa / Data wyjazdu gościaDaty 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

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

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 opisOpisJednostkaZakres wartości
Status online FIAS PMS ConnectorWskazuje, czy urządzenie jest dostępne przez Miniserver.
Diagnostyka urządzeń Air
Diagnostyka urządzeń Tree
Diagnostyka rozszerzeń
Cyfrowy0/1




Właściwości

Krótki opisOpisZakres wartościWartość standardowa
Adres serweraAdres serwera PMS.--
Port serweraPort serwera PMS.0...65535-
Key Services związane z portami serwerowymiPort 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 CheckoutGodzina w dniu wyjazdu, o której użytkownik zostanie automatycznie usunięty. Domyślnie 23:00.--
Odświeżanie bazy danychPo 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 CheckoutPo 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żytkownikPlugin ma dostęp do tej samej wizualizacji, co wybrany użytkownik--