Hotel Integration - FIAS protocol - Admin Guide - English

Introduction and requirements

License requirements:

• One Premium license to activate the service system-wide
• A Basic license (or higher) assigned to each user 

Among the hotel management systems that integrate with Wildix PBX:

• Micros Opera (FIAS is supported by the following PMS: Fidelio Suite 6, Fidelio Suite 7, Fidelio Suite 8 & OPERA PMS (not supported by Fidelio Xpress)
• Protel - Serenissima
• ASA Hotel
• Direct Holiday
• Hotsoft8 of HoistGroup
• Ericsoft

and other hotel management systems that support the FIAS protocol.

Supported Oracle and FIAS versions:

• Oracle Hospitality OPERA Version: 5.0.05.00
• Oracle Hospitality Interface IFC8 Version: 8.10.2.20
• FIAS Version: 2.20.12

Integration consists of two parts.

Part 1: FIAS module

FIAS module or FIAS connector is used to connect to FIAS PMS (Property Management System), also known as Hotel Operating System (Hotel OS). Thanks to this module, it is possible to sync the following events between the Wildix PBX and the FIAS PMS:

• Room Inspecting; MuR – make up the room; DND – do not disturb
• Minibar
• Wake-up service
• Call billing
• Check-in / Check-out / call barring

Part 2 (optional): Bticino / Legrand hardware with xOpen software

Additionally, it is possible to enable xOpen integration for interaction with Bticino / Legrand hardware used in the hotel, such as guest keycard room access and power switches, and “DND / MUR” indicators. In this case it will be possible to sync the following events received from Bticino / Legrand terminals with Wildix PBX:

• DND
• MuR and Room inspecting
• Guest keycard service integration

Installation

FIAS module

Step 1. Enable Hotel Integration:

• Go to WMS Settings -> PBX -> Hotel Integration
• FIAS PMS Integration -> click Install
  
  

• After installation, there appear three new tabs: Rooms / FIAS-PMS / PBX Services:
  
  

Step 2. Auto generate rooms

Autogeneration is based on WMS -> Users configuration.

• Go to Rooms tab
  
  

• Click Sync rooms to auto-recreate rooms configuration based on users data (like extension)
  
  

Explanation of fields:

1. FIAS RN – room number identificator used in commands from FIAS interface

2. Extension – internal extension number inside the PBX, shown on the phone

3. Description / Building / Floor / Category – room description, location and category for hotel staff

4. ID – identificator used by XOpen interface (described in the next chapter)

• Click Apply to save and confirm changes

Step 3. Set up connection to Fidelio software (FIAS interface)

On this page you enable the integration with Fidelios software for all the commands, except for key / badge commands.

• Go to FIAS-PMS tab and enable "Telephony interface" option
• Enter the configuration parameters where required:

Configuration parameters:

• PMS Status – status of connection to Fidelio software
• Host – address for connection to software
• Port – port for connection to software
• Delimiter – delimiter used inside commands from FIAS interface
• Billing Type – billing type used: Duration Only / Duration and cost (see the chapter Call Billing)
• Minibar Type – minibar charging by Cost only / Article only (see the chapter Minibar Charges)

Step 4. Wake up service settings (optional)

Go to tab PBX Services and enter the following parameters:

Parameters:

• Timeout – period of time during which the wake up call must be answered (in seconds)
• Number of tries – number of repetitive calls in case wake up call was not answered
• Sound – audio file to be played to the guest who answered a wake up call

(See the chapter Wake Up Call for more information).

Step 5. Restart WHotel daemon

• Go to General tab 
• "Service" option -> click Restart

XOpen SW for integration with Bticino / Legrand HW 

For processing of key / badge programming and sync of events from Bticino/Legrand terminals, such as DND / MuR statuses, it is necessary to enable XOpen integration.

Step 1. Enable xOpen integration

Go to General tab -> xOpen integration, click Enable.

In Hotel Integration menu there appear additional tabs which serve to enable connection to Legrand software by XOpen protocol:

• Common Areas
• Workstations
• Xopen

Step 2. Enable connection to the software

Go to Xopen tab and enter the related data:

Configuration parameters:

• Status – the status of the connection to Hotel Supervision Server
• Host –  address for connection to software
• Port – a port for connection to software
• FC – function code as parameter for Hotel Supervision Client
• UC – univocal code as parameter for Hotel Supervision Client
• Secret – the secret for authorization with Hotel Supervision Server
• Badges control – enable/disable badges processing

Step 3. Upload XOpen project file

• Go to Rooms tab
• Click Choose file to load a config file from Hotel Supervision software (file with extension *.hsprj) with actual information about device identifier
   
  
• Common areas data (Common Areas tab) can be loaded from described above config from Hotel Supervision software:
  
  

Step 3. Set up the mapping between PMS key generators and XOpen key generators

• Go to Workstations tab
• Add workstation instance (like Hotel Supervision GUI) with following data:

1. 1. FIAS WS – an identifier on the FIAS side

   2. Client UC – an identifier on the XOpen side (retrieved from HS Client)

   3. Client IP – an IP address of the workstation PC:

Step 4. Extend configuration for Fidelio software by data for key service client (FIAS PMS Automation interface)

Go to FIAS-PMS tab.

There appears an additional section Automation interface.

Now it is possible to set up two FIAS-PMS interfaces:

• Telephony interface (PBX)
• Automation interface (DLS – door-lock system)
  
  

Step 5. Restart WHotel daemon

• Go to General tab 
• "Service" option -> click Restart

Hotel ACLs (CoS) and call barring for vacant room

There are two types of ACL in the Wildix Hotel Integration:

• Standard PB