Fias
Oracle's FIAS (Fidelio Interface Application Specification) is a protocol specification used by different hospitality PMS systems to exchange data.
This driver interprets check-in and check-out events and optionally exposes all received raw FIAS messages to be used in custom logic.
HSYCO Configuration
Section titled “HSYCO Configuration”Add a FIAS I/O Server in the I/O Servers section of the Settings and set its parameters:
Communication
Section titled “Communication”- IP Address: the IP address of the FIAS server instance;
- Port: TCP port of the FIAS server instance;
High Availability
Section titled “High Availability”- Shutdown when inactive: defaults to true.
Options
Section titled “Options”| ID | Default | Values | Description |
|---|---|---|---|
| rawmessages | false | true | generate the "msg" datapoint |
| false | do not generate the "msg" datapoint |
Datapoints
Section titled “Datapoints”| ID | Value | R/W | Description |
|---|---|---|---|
| connection | online | R | connection established |
| offline | R | HSYCO can't connect to the system | |
| guest.in | <JSON object> | R | Guest check-in event with reported details (see below) |
| guest.in.dbswap | <JSON object> | R | Past check-in event generated because of a database synchronisation request |
| guest.out | <JSON object> | R | Guest check-out event with reported details (see below) |
| guest.out.dbswap | <JSON object> | R | Past check-out event generated because of a database synchronisation request |
| guest.change | <JSON object> | R | Guest booking change event with reported details (see below) |
| guest.change.dbswap | <JSON object> | R | Past booking change event generated because of a database synchronisation request |
| msg.<type> | <JSON object> | R | FIAS message of type <type> received from the system with reported parameters formatted as JSON object (requires "rawmessages" option set to "false") |
| msg | <message> | R | Raw FIAS message received from the system (requires "rawmessages" option set to "true") |
| W | Send the specified raw FIAS message to the system |
JSON objects format
Section titled “JSON objects format”The following sections show the format of the "guest.*" datapoints' JSON values. The textual and numeric values of the attributes are implementation-dependant and vary from system to system. The only required attributes are "reservationNumber", "room", and "share"; all other attributes are optional.
Guest check-in and booking change
Section titled “Guest check-in and booking change”{
"reservationNumber": <number>,
"room": <text>,
"name": <text>,
"firstName": <text>,
"date": <date - YYMMDD>,
"time": <time - HHMMSS>,
"share": <true|false>,
"arrivalDate": <date - YYMMDD>,
"departureDate": <date - YYMMDD>,
"classOfService": <0-3>,
"profileNumber": <text>,
"groupNumber": <text>,
"language": <text>,
"title": <text>,
"vip": <number>,
"minibarRights": <text>,
"tvRights": <text>,
"videoRights": <text>,
"workstationId": <text>
}
Guest check-out
Section titled “Guest check-out”{
"reservationNumber": <number>,
"room": <text>,
"date": <date - YYMMDD>,
"time": <time - HHMMSS>,
"share": <true|false>,
"workstationId": <text>
}
Release Notes
Section titled “Release Notes”- initial release
Oracle is a registered trademark of Oracle Corporation