FIAS PMS Connector

FIAS (Fidelio Interface Application Specification) ermöglicht die Integration von Fidelio-Hotel-PMS-Systemen.

Das Plugin verwaltet Hotelgäste als Benutzer auf dem LOXONE Miniserver und synchronisiert diese mit dem PMS.
Beim Check-In wird ein Benutzer für den Gast erstellt und der Gruppe entsprechend der Raum-ID zugewiesen. Beim Check-Out werden dem Benutzer alle Benutzergruppen entzogen, wodurch er sämtliche Zugriffsrechte verliert. Der Benutzer selbst wird vom Miniserver zur Check-Out Fallback-Zeit gelöscht.
Wenn Key Services aktiviert sind, können NFC-Schlüssel codiert und dem Gast für Türzugang oder externe Dienste (z. B. Ladung von Elektrofahrzeugen) zugewiesen werden.

Dieses Plugin unterstützt FIAS Protokoll Version 2.10. Der Miniserver Gen. 1 wird nicht unterstützt.

Inhaltsverzeichnis

• Raum-Ausgänge
• Unterstützte PMS-Befehle
• Topologie
• Konfiguration
• Funktionalität & Einschränkungen
• NFC-Tags (Key Services)
• Eingänge, Ausgänge, Eigenschaften

Raum-Ausgänge↑

Jeder konfigurierte Raum stellt die folgenden Ausgänge zur Verfügung:

Unterstützte PMS-Befehle↑

Topologie↑

Das FIAS PMS Connector-Plugin wird auf einem Miniserver eingerichtet und mit dem PMS verbunden. Auf diesem Miniserver werden auch die Gäste-Benutzer angelegt und deren Berechtigungen verwaltet.
Die Berechtigungen werden anschließend über Trust oder Gateway Client an alle weiteren Miniserver im Objekt weitergegeben.

Konfiguration↑

Fügen Sie das FIAS PMS Connector-Plugin zur Netzwerkperipherie hinzu:

Tragen Sie im Eigenschaftenfenster des Plugins die Adresse und den Port des PMS-Servers ein.

Das Plugin stellt automatisch die Verbindung her und hält die Synchronisation mit dem PMS aufrecht.

Die Verbindung zum PMS erfolgt ohne Login (kein Benutzername/Passwort erforderlich). Der Miniserver baut die unverschlüsselte TCP-Verbindung mit dem Port aktiv zum PMS auf (Serveradresse). Verbindungsauf- und -abbau sowie das Aufrechterhalten der Verbindung laufen danach automatisch im Hintergrund.
Dabei wird nicht permanent gepollt: Der Miniserver lauscht auf der bestehenden Verbindung lediglich, ob Nachrichten vom PMS eintreffen. Periodisch wird zusätzlich ein Alive gesendet, um zu prüfen, ob die Verbindung noch besteht.

Wählen Sie anschließend einen Benutzer mit der Berechtigung Benutzerverwaltung aus. Dieser wird vom Plugin für die automatische Verwaltung von Gästen und deren NFC-Tags genutzt.

Key Services

Key Services ermöglichen die NFC-basierte Schlüsselcodierung und -abfrage über das PMS.
Bei aktivierten Key Services stellt das Plugin eine eigene Verbindung zum PMS Key Service-Port her.

• Aktivieren: "Serverport Key Services" auf den PMS Key Service-Port einstellen. Bei abweichendem Port wird eine zweite TCP-Verbindung aufgebaut.

• Deaktivieren: "Serverport Key Services" auf 0 setzen.

Key Options (1–20): Jede Option wird einer LOXONE -Benutzergruppe zugeordnet.
Sendet das PMS eine Schlüsselanforderung mit einer bestimmten Option, wird der Gast-Benutzer der entsprechenden Gruppe hinzugefügt.
Rechte über Key Options können nur hinzugefügt, aber nicht entfernt werden und stellen zusätzliche Rechte neben der Raum-Benutzergruppe dar.

Die Key Options müssen mit dem PMS-System abgestimmt werden: Welche Key Options PMS-seitig hinterlegt sind, bestimmt, wie die entsprechende Benutzergruppe auf LOXONE -Seite gesetzt werden muss.

1. Räume hinzufügen

Werden Räume über CSV-Import oder die Raumsuche hinzugefügt, erstellt das Plugin automatisch eine Benutzergruppe mit dem gleichen Namen wie die Raum-ID.

Die Raum-ID entspricht der Raumkennung, wie sie im PMS für dieses Zimmer hinterlegt ist (üblicherweise die Zimmernummer). Sie wird beim Anlegen des Raums festgelegt – per CSV-Import, PMS-Suche oder manuell – und muss mit der PMS-seitigen Kennung übereinstimmen, damit Check-In/Check-Out-Meldungen dem richtigen Zimmer zugeordnet werden.
Für jede Raum-ID legt das Plugin automatisch eine gleichnamige Benutzergruppe an. Gäste werden bei Check-In dieser Gruppe zugewiesen; darüber werden ihre Berechtigungen gesteuert.

Via CSV importieren:
Klicken Sie auf "Konfiguration laden" und wählen Sie eine CSV-Datei mit der Raumliste aus. Alle Räume in der CSV-Datei werden automatisch im Plugin angelegt.

CSV-Beispiel:

Die Angabe der Etage (Floor) ist optional.

Via PMS-Suche:
Wenn im PMS-System Database Refresh erlaubt ist, können Räume direkt über den Button "Raumsuche" hinzugefügt werden.

Manuell hinzufügen:
Klicken Sie auf "Raum hinzufügen" und tragen Sie im Eigenschaftenfenster die Raum-ID ein (z. B. "101" oder "E37").

Plugin-Namen, Benutzer oder Benutzergruppenname dürfen nicht manuell geändert werden, sonst wird die Synchronisation unterbrochen.

2. Keycoder hinzufügen

Keycoder sind physische NFC-Geräte, die zum Kodieren und Auslesen von NFC-Tags für Gäste verwendet werden. Jeder Keycoder im PMS muss im Plugin hinterlegt sein.

Der Keycoder muss direkt am Miniserver angeschlossen sein. Als Gerät an einem Client (Extension/Client-Miniserver) funktioniert das nicht.

Fügen Sie über den Button in der Menüleiste einen Keycoder hinzu und tragen Sie die ID ein (Identifikator aus PMS, z. B. "Encoder 1"). Wählen Sie anschließend den entsprechenden NFC Code Touch aus (Gerät, das physisch an diesem Standort installiert ist):

Mehrere Keycoder können angelegt werden, z. B. mehrere an Rezeption, Self Service, ...

Funktionalität & Einschränkungen↑

• Benutzerverwaltung
  - Check-In: Prüft, ob der Benutzer bereits existiert → Aktualisierung der Daten oder Anlage eines neuen Benutzers. Automatische Gruppenzuordnung gemäß Raum-ID. Das Feld Debitor des Benutzers wird mit <Raum-ID>#<Reservierungsnummer> befüllt (z. B. U15#32733).
  - Check-Out: Beim Check-Out werden dem Benutzer alle Benutzergruppen entzogen, sämtliche Zugriffsrechte sind damit sofort entfernt. Der Benutzer selbst bleibt erhalten und wird vom Miniserver zur Check-Out Fallback-Zeit am Abreisetag gelöscht. Das Entfernen der Gruppen erfolgt nur, wenn das Check-Out-Event sowohl Raum-ID als auch Reservierungsnummer enthält.

• Fallback Check-Out: Gäste werden am geplanten Abreisedatum zur Check-Out Fallback-Zeit automatisch ausgecheckt, falls kein Check-Out-Event empfangen wurde. Zu diesem Zeitpunkt löscht der Miniserver auch den Gast-Benutzer. Standardwert ist 23:00 Uhr, die Zeit kann in den Einstellungen geändert werden.

• Konsistenz: Plugin-Namen, Benutzernamen oder Benutzergruppennamen nicht manuell ändern – sonst wird die Synchronisation unterbrochen.

NFC-Tags (Key Services)↑

• Timeout Standardmäßig 10 Sekunden für Einlern- und Leseoperationen.

• Tag-Typen: Verschlüsselte und unverschlüsselte Tags können verwendet werden.

• Externe Abrechnung über FIAS: Nur unverschlüsselte Tags werden unterstützt (z. B. Ladung von Elektrofahrzeugen). Die physische NFC-ID wird an das PMS/FIAS-System zurückgemeldet.

• Verschlüsselte Tags: Die Abrechnung kann über den Miniserver bzw. LOXONE Exosphere gemacht werden. (z. B. Wallbox / Ladung von Elektrofahrzeugen über LOXONE).

Diagnose-Eingänge↑

Eigenschaften↑