FIAS PMS Connector

FIAS (Fidelio Interface Application Specification) maakt integratie met Fidelio Hotel PMS-systemen mogelijk.

De plug-in beheert hotelgasten als gebruikers op de LOXONE Miniserver en synchroniseert deze met het PMS.
Bij check-in wordt er een gebruiker voor de gast aangemaakt en toegewezen aan de groep die overeenkomt met het kamer-ID. Bij check-out worden alle gebruikersgroepen van de gebruiker verwijderd, waardoor alle toegangsrechten worden ingetrokken. De gebruiker zelf wordt door de Miniserver verwijderd op het moment dat de uitcheck-fallback-tijd is verstreken.
Wanneer Key Services zijn ingeschakeld, kunnen NFC-sleutels worden gecodeerd en aan de gast worden toegewezen voor toegang tot de kamer of externe diensten (bijv. het opladen van elektrische voertuigen).

Deze plug-in ondersteunt het FIAS-protocol versie 2.10.
Miniserver Gen. 1 wordt niet ondersteund.

Inhoudsopgave


Kameruitgangen↑

Elke geconfigureerde kamer biedt de volgende uitgangen:

UitgangBeschrijving
Puls bij incheckenPuls wanneer het PMS een incheck meldt
Puls bij uitcheckenPuls wanneer het PMS een uitcheck meldt
Incheckstatus0 = uitgecheckt, 1 = ingecheckt
ReserveringsnummerActief reserveringsnummer
Naam Gast / Voornaam Gast / Titel GastIdentiteit Gast
Taal GastTaalvoorkeur Gast
Aankomstdatum Gast / Vertrekdatum GastVerblijfsdata als LOXONE tijdstempels (seconden sinds 1 januari 2009; aankomstdatum gast: 0:00 uur op de dag van aankomst; vertrekdatum gast: 24:00 uur op de dag van vertrek)

Ondersteunde PMS-commando's↑

CommandoBeschrijving
Gast Inchecken (GI)Ontvangt incheck-meldingen, inclusief de volledige gastgegevens
Gast Uitchecken (GO)Ontvangt uitcheckmeldingen
Database Vernieuwen (DR)Synchroniseert alle kamers na verbinding
Linkbeheer
- Linkstart (LS)
- Link actief (LA)
- Linkeinde (LE)
- Linkconfiguratie (LC)
- Linkbeschrijving (LD)
- Linkrecord (LR)
Automatische verbinding en keepalive-afhandeling
Key Management
- Key Request (KR)
- Key Answer (KA)
- Key Delete (KD)
- Key Read (KZ)
Afhandeling van key services
Door de gebruiker te definiëren velden A0–A9Op dit moment wordt alleen het e-mailadres automatisch geparseerd

Topologie↑

De FIAS PMS Connector-plug-in wordt op één Miniserver geconfigureerd en met het PMS verbonden. Gastgebruikers worden op deze Miniserver aangemaakt en hun rechten worden daar beheerd.
De rechten worden vervolgens via Trust of Gateway Client doorgegeven aan andere Miniservers in het gebouw.


Configuratie↑

Voeg de FIAS PMS Connector-plugin toe aan de netwerkperiferie:

Voer in de eigenschappen van de plug-in het adres en de poort van de PMS-server in.

De plug-in maakt automatisch verbinding met het PMS en zorgt ervoor dat de gegevens gesynchroniseerd blijven.

Voor de verbinding met het PMS is geen aanmelding nodig (geen gebruikersnaam of wachtwoord vereist). De Miniserver brengt een onversleutelde TCP-verbinding tot stand met het geconfigureerde adres en de poort van de PMS-server. Het tot stand brengen en in stand houden van de verbinding gebeurt automatisch op de achtergrond.
De plug-in vraagt niet continu de status van het PMS op. Hij luistert via de bestaande verbinding naar inkomende berichten en verstuurt periodiek een keep-alive-bericht om te controleren of de verbinding nog actief is.

Selecteer een gebruiker met de rechten voor gebruikersbeheer. Deze gebruiker wordt door de plug-in gebruikt om gasten en hun NFC Tags automatisch te beheren.

Key Services

Met Key Services kunnen sleutels via NFC worden gecodeerd en uitgelezen via het PMS.
Wanneer deze functie is ingeschakeld, brengt de plug-in een speciale verbinding tot stand met de Key Service poort van het PMS.

  • Activeren: Stel „Serverpoort Key Services” in op de poort van de PMS Key Service. Als deze poort afwijkt van de hoofdpoort, wordt er een tweede TCP-verbinding tot stand gebracht.

  • Deactiveren: Stel „Serverpoort Key Services” in op 0.

Key Options (1–20): Elke optie is toegewezen aan een LOXONE gebruikersgroep.
Als het PMS een sleutel met een specifieke optie aanvraagt, wordt de gastgebruiker toegevoegd aan de bijbehorende groep.
Rechten die via Key Options worden toegewezen, kunnen alleen worden toegevoegd, niet verwijderd, en bieden extra bevoegdheden bovenop die van de kamergroep.

Key Options moeten worden afgestemd op het PMS-systeem. De in het PMS geconfigureerde Key Options bepalen welke gebruikersgroep aan de LOXONE zijde moet worden toegewezen.

1. Kamers Toevoegen

Wanneer er kamers worden toegevoegd via een CSV-import of via de kamerzoekfunctie, maakt de plug-in automatisch een bijbehorende gebruikersgroep aan met dezelfde naam als de kamer-ID.

De kamer-ID komt overeen met de kameridentificatie die in het PMS is opgeslagen (meestal het kamernummer). Deze wordt vastgesteld bij het toevoegen van de kamer via CSV-import, PMS-zoekopdracht of handmatig, en moet overeenkomen met de PMS-identificatie om in- en uitcheckmeldingen correct aan de betreffende kamer toe te wijzen.
Voor elke kamer-ID maakt de plug-in automatisch een gebruikersgroep met dezelfde naam aan. Gasten worden tijdens het inchecken aan deze groep toegewezen en hun rechten worden via deze groep beheerd.

Via CSV-import:
Klik op "Configuratie laden" en selecteer een CSV-bestand met de kamerlijst. Alle kamers in het CSV-bestand worden automatisch aangemaakt in de plug-in.

CSV Voorbeeld:

De informatie over de verdieping is optioneel.

Via PMS-zoekfunctie:
Als het PMS het vernieuwen van de database toestaat, kunnen kamers rechtstreeks worden toegevoegd via de knop "Kamers zoeken”.

Handmatig:
Klik op "Kamer toevoegen” en voer de kamer-ID in het venster met eigenschappen in (bijvoorbeeld "101” of "E37”).

Wijzig de namen van plug-ins, gebruikersnamen of gebruikersgroepsnamen niet handmatig – dit leidt tot een storing in de synchronisatie.

2. Keycoders toevoegen

Keycoders zijn fysieke NFC-apparaten die worden gebruikt voor het coderen en uitlezen van NFC Tags van gasten. Elke keycoder in het PMS moet in de plug-in worden geregistreerd.

De Keycoder moet rechtstreeks op de Miniserver worden aangesloten. Keycoders die op een Client (Extension of Client Miniserver) zijn aangesloten, worden niet ondersteund.

Klik op "Keycoder toevoegen”, voer de ID in (identificatiecode uit het PMS, bijv. "Encoder 1”) en wijs de bijbehorende NFC Code Touch toe (apparaat dat fysiek op deze locatie is geïnstalleerd).

Er kunnen meerdere keycoders worden toegevoegd (bijvoorbeeld meerdere keycoders bij de receptie, bij zelfbedieningsterminals of op andere locaties).


Functionaliteit & Beperkingen↑

  • Gebruikersbeheer
    - Inchecken: Controleert of een gebruiker al bestaat → werkt de gegevens bij of maakt een nieuwe gebruiker aan. Automatische groepsindeling op basis van de kamer-ID. Het veld ‘Debiteur’ van de gebruiker wordt ingevuld met <Kamer-ID>#<Reserveringsnummer> (bijv. U15#32733).
    - Uitchecken: Bij het uitchecken worden alle gebruikersgroepen van de gebruiker verwijderd, waardoor alle toegangsrechten onmiddellijk worden ingetrokken. Het gebruikersrecord zelf blijft bewaard en wordt door de Miniserver op de uitcheck-fallbacktijd op de vertrekdatum verwijderd. Het verwijderen van groepen vindt alleen plaats als de uitcheckgebeurtenis zowel het kamer-ID als het reserveringsnummer bevat.

  • Fallback Uitchecken: Gasten worden op hun geplande vertrekdatum automatisch uitgecheckt op het fallback-tijdstip voor het uitchecken, indien er geen uitcheckmelding is ontvangen. Op dat moment verwijdert de Miniserver ook de gastgebruiker. Het standaardtijdstip is 23:00 en kan in de instellingen worden gewijzigd.

  • Consistentie: Wijzig de namen van plug-ins, gebruikers of gebruikersgroepen niet handmatig – dit verstoort de synchronisatie.


NFC Tags (Key Services)↑

  • Timeout Standaard 10 seconden voor leer- en leesbewerkingen.

  • Tag Types: Er kunnen zowel versleutelde als onversleutelde NFC Tags worden gebruikt.

  • Externe facturering via FIAS: Er worden alleen niet-versleutelde tags ondersteund (bijvoorbeeld het opladen van elektrische voertuigen). De fysieke NFC-ID wordt teruggestuurd naar het PMS/FIAS-systeem.

  • Versleutelde tags: De facturering kan worden afgehandeld via de Miniserver of LOXONE Exosphere (bijvoorbeeld Wallbox / het opladen van elektrische voertuigen via LOXONE).


Diagnose-ingangen↑

Korte beschrijvingBeschrijvingEenheidWaardebereik
Online status FIAS PMS ConnectorGeeft aan of het apparaat door de Miniserver kan worden bereikt.
Diagnose voor Air apparaten
Diagnose voor Tree apparaten
Diagnose voor Extensions
Digitaal0/1




Eigenschappen↑

Korte beschrijvingBeschrijvingWaardebereikStandaardwaarde
ServeradresAdres van de PMS-server.--
ServerpoortPoort van de PMS-server.0...65535-
Serverpoort Key ServicesPoort die wordt gebruikt voor key services. Als deze poort afwijkt van de 'Serverpoort', wordt er een tweede TCP-verbinding tot stand gebracht. 0 = Key Services uitgeschakeld.0...65535-
Check-Out Fallback TijdTijdstip op de dag van vertrek waarop de gastgebruiker automatisch door de Miniserver wordt verwijderd. Standaard 23:00.--
Database VernieuwenWanneer databasevernieuwing (DR) is ingeschakeld, wordt deze na het tot stand brengen van de verbinding gebruikt om alle kamergegevens te synchroniseren. Gebruikers worden niet toegevoegd als een incheckgebeurtenis (GI) is gemist.--
Verberg Check-Out MeldingenAls deze optie is ingeschakeld, wordt er geen systeemstatuswaarschuwing gegenereerd wanneer uitchecken mislukt (bijvoorbeeld wanneer het reserveringsnummer ontbreekt).--
Dienst bewakenIndien aangevinkt, word je via de systeemstatus of via de cloud mailer verwittigd indien deze dienst niet langer beschikbaar of offline is.--
GebruikerDe plugin krijgt toegang tot dezelfde visualisatie als de geselecteerde gebruiker--