Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Html
<div id="fb-root"></div>
<script>(function(d, s, id) {
  var js, fjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = 'https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.11';
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>

...

Info

In this Guide you will find information about integration with Oracle / Fidelio PMS and other hotel management systems that support FIAS protocol.

Wildix communication system integrates with FIAS protocol (Fidelio Interface Application Specification). Thanks to this integration, the PBX can interact with the hotel management software and exchange the information about such events as check-ins, check-outs, wake up calls, room status, charging of services.

In addition to this, Wildix PBX can interact with XOpen software which enables the integration with Bticino / Legrand hardware such as key card programmers and “do not disturb” / “make up room” indicators.

WMS Version: 3.87

Updated: March 2018

Permalink: https://confluence.wildix.com/x/rAc8AQ

Table of Contents

Introduction

Among the hotel management systems that integrate with Wildix PBX:

...

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

Installation

FIAS module

Step 1. Enable Hotel Integration:

...

    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

...

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

...

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

...

  • 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:

...

It is possible to skip CoS (Hotel ACLs) via authentication, which can be useful to allow some authorized hotel staff to make calls from the rooms which are vacant. Read the next chapter for more info.

To disable ACL checking on the PMS side and always use standard PBX ACL: set up Global Dialplan variable (WMS Dialplan -> General Settings): CHECKFIASACL = no.

...

Take into consideration, that you can set up caller ID name to some static value, otherwise real guest’s name is displayed while making a call through trunk. Example:


Skip call barring via authentication

In this chapter it is explained how to skip hotel ACL (CoS) in case call barring is enabled for the room which is in status “vacant”. This scenario can be useful to allow authorized hotel staff to place calls from vacant rooms after successful authentication.

...

Warning

Limitation: account length must be the same for all the staff who is using this feature (for example, three digits).

Sync of events between FIAS PMS and PBX

PBX can communicate with PMS to sync the following events:

...

Below we will see in detail how each event is processed.

Guest check in / check out / change data

Events must be sent from FIAS-PMS.

...

  • Room is marked as "occupied" / "vacant"
  • User name is updated in WMS -> Users
  • User language is updated in WMS -> Users
  • When the status changes to “occupied”, any command can be executed such as setting DND, wake up call, minibar charging
  • When the status changes to “vacant”, all wake up calls are removed for this room and guest data is removed from the internal database

DND

Event must be sent from FIAS-PMS.

...

  • User status is updated
  • Status on the phone is updated

MuR / Call inspection

Events must be sent from PBX via Feature codes on the phone by hotel staff (see the chapter Hotel Feature Codes).

MuR statuses:

  • Dirty / Vacant
  • Dirty / Occupied
  • Clean / Vacant
  • Clean / Occupied

...

  • Inspected / Vacant
  • Inspected / Occupied

Call billing

Call billing is sent only for external outgoing calls (calls via trunks) with duration more than 0 seconds.

...

Billing type parameter can be modified in Hotel Integration -> General, “Billing type”: Duration only / Duration and cost.

Minibar charges

Minibar charges must be sent via feature codes on the phone by hotel staff (see the chapter Hotel Feature Codes).

Minibar charges information can be sent with different mapping:

...

Minibar type parameter can be modified in Hotel Integration -> General, “Minibar type”: Article only / Cost only.

Wake Up Call

This service is available only for rooms with “occupied” status.

...

On PBX side: wake up call can be set up by guest via feature code on the phone (see the chapter Hotel Feature Codes).

Note

Note: it is allowed to set up only one alarm during one day.

...

The call timeout, the number of tries and the audio file to be played in case the call is answered, can be specified in Hotel Integration -> PBX Services.

Sync of events with XOpen integration (Bticino / Legrand equipment)

In case xOpen integration is enabled, additionally to the scenarios of events sync described in the previous chapters, new scenarios are supported in order to sync the events sent from Bticino / Legrand equipment installed in the hotel.

DND from xOpen

Note

Note: on Oracle/Fidelio PMS “DND” events can be sent only from PMS itself.

...

To make it possible, it is necessary to make sure the ACL rule “cannot set” -> “Status DND / Away” is not present in the ACL group configuration assigned to rooms.

MuR and Call Inspection from xOpen

MuR events can be sent both from PBX via Feature codes or from Bticino/Legrand equipment via xOpen interface.

Hotel Feature Codes

Feature Codes can be looked up and changed in WMS Dialplan -> Feature Codes.

Hotel Feature Codes (FC) allow users (guests / hotel staff) to manage different services by placing a call from the hotel room number to a specified Feature Code and following audio instructions.

MuR and Room Inspecting FC

Make Up Room FC (771 by default) should be used by hotel staff (maids, housekeepers), to set the room status to:

...

Note

Note: Room Inspecting FC + 1 is used as notification about guests who leave the hotel without check-out procedure.

Minibar service FC

Minibar FC (772 by default) should be used by hotel staff (maids, waiters) to send a minibar charge posting. Depending on the configuration on the Hotel Integration page -> FIAS-PMS, the service can be implemented in two different ways:

...

The caller is invited to enter the product article / the total amount and the amount of items.

Wake Up call service FC

FC Wake up call FC  (773 by default) should be used by guests to set / clear alarm clock for their rooms.

...

  • 1 – to check the information about the nearest wake up call
  • XXXX – enter the time for the wake up call in four digit format
  • 0 – to remove the nearest wake up call

Other PMS integration matrix

As stated at the beginning of this Guide, the document describes the integration with FIAS / Oracle PMS, however other PMSs supporting FIAS protocol can be integrated with Wildix PBX.

...