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 wird der Benutzer automatisch 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

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

AusgangBeschreibung
Check-In ImpulsImpuls, wenn das PMS einen Check-In meldet
Check-Out ImpulsImpuls, wenn das PMS einen Check-Out meldet
Check-In Status0 = ausgecheckt, 1 = eingecheckt
ReservierungsnummerAktive Reservierungsnummer
Gast-Nachname / Gast-Vorname / Gast-AnredeIdentität des Gastes
Gast-SpracheSprachpräferenz des Gastes
Gast-Anreisedatum / Gast-AbreisedatumAufenthaltsdaten als Loxone-Zeitstempel (Sekunden seit 2009‑01‑01; Gast-Anreisedatum: 0:00 Uhr des Anreisetages; Gast-Abreisedatum: 24:00 Uhr des Abreisetages)

Unterstützte PMS-Befehle

BefehlBeschreibung
Guest Check-In (GI)Empfang von Check-In-Meldungen inkl. aller Gastdaten
Guest Check-Out (GO)Empfang von Check-Out-Meldungen
Database Refresh (DR)Synchronisation aller Räume nach Verbindung
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)

Konfiguration

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

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

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

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.

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.

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

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. pro Etage, an der Rezeption,...


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.
    - Check-Out: Benutzer werden beim Check-Out automatisch gelöscht. Löschung nur, wenn das Check-Out-Event sowohl Raum-ID als auch Reservierungsnummer enthält.

  • Fallback Check-Out: Gäste werden automatisch um 23:00 Uhr am geplanten Abreisedatum ausgecheckt, falls kein GO-Event empfangen wurde. Die Uhrzeit 23:00 ist standardmäßig, kann aber über die Einstellungen angepasst werden.

  • Konsistenz: Plugin-Namen, Benutzernamen oder Gruppennamen 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: Abrechnung erfolgt über den Miniserver (z. B. Wallbox / Ladung von Elektrofahrzeugen über Loxone).


Diagnose-Eingänge

KurzbeschreibungBeschreibungEinheitWertebereich
Onlinestatus FIAS PMS ConnectorGibt an, ob das Gerät für den Miniserver erreichbar ist.
Diagnose bei Air Geräten
Diagnose bei Tree Geräten
Diagnose bei Extensions
Digital0/1




Eigenschaften

KurzbeschreibungBeschreibungWertebereichStandardwert
ServeradresseAdresse des PMS-Servers.--
ServerportPort des PMS-Servers.0...65535-
Serverport Key ServicesPort, der für Key Services verwendet wird. Wenn dieser vom 'Serverport' abweicht, wird eine zweite TCP-Verbindung aufgebaut. 0 = Key Services deaktiviert.0...65535-
Check-Out Fallback-ZeitZeitpunkt am Abreisetag, zu dem der Benutzer automatisch entfernt wird. Standardwert: 23:00 Uhr.--
Database RefreshWenn aktiviert, wird nach der Verbindung ein Database Refresh (DR) durchgeführt, um alle Rauminformationen zu synchronisieren. Benutzer werden nicht hinzugefügt, wenn ein Check-in Event (GI) verpasst wurde.--
Check-Out-Warnungen ausblendenWenn aktiviert, wird keine Systemstatuswarnung erzeugt, wenn ein Checkout fehlschlägt (z. B. wenn die Reservierungsnummer fehlt).--
Dienst überwachenWenn angehakt, werden Sie über den Systemstatus oder über den Cloud Mailer benachrichtigt, wenn dieser Dienst nicht mehr erreichbar bzw. offline ist.--
BenutzerDas Plugin erhält Zugriff auf dieselbe Visualisierung, wie der gewählte Benutzer--