Telephone Interface (FIAS)
Casablanca Hotelsoftware has implemented the FIAS (Fidelio Interface and Application Specification) interface. Casablanca can take on the role of client or server.
The FIAS interface description can be download under the following link:
The following commands are possible via the interface in use with a phone system:
In the following examples, Casablanca takes on the role of server.
Link Status
Establish connection
At the start of the connection it is defined which fields are to be initialised via the connection:
Example:
- Request (IN):
[STX]LD|DA200313|TI064807|IFPB|V#100|RT52|[ETX] - Request2 (IN):
[STX]LR|RIGI|FLDATIRNGSG#GAGDGLGNCSNPSF|[ETX][STX]LR|RIGC|FLDATIRNGSG#GAGDGLGNCSNP|[ETX][STX]LR|RIGO|FLDATIRNGSG#SF|[ETX][STX]LR|RIPS|FLDATIPTDDDUMPMAM#RNP#SOTA|[ETX][STX]LR|RIPA|FLDATIASRNSOP#|[ETX][STX]LR|RIRE|FLRNCTMLPPRSVMCS|[ETX][STX]LR|RIWR|FLDATIRN|[ETX][STX]LR|RIWC|FLDATIRN|[ETX][STX]LR|RIWA|FLDATIRNAS|[ETX][STX]LA|DA200313|TI064807|[ETX] - Response (OUT):
[STX]LA|DA200313|TI065006|[ETX]
Check connection
A check whether the link is still upright is performed by the client every X minutes after the start of the connection.
Example:
- Request (IN):
[STX]LS|DA200313|TI073022|[ETX] - Response (OUT):
[STX]LA|DA200313|TI073221|[ETX]
Close connection
Example:
- Request (IN):
[STX]LE|DA200313|TI065759|[ETX]
Checkin
If a guest is checked in to the hotel software, the check-in command is triggered.
Example:
- Request (OUT):
[STX]GI|DA200313|TI071221|RN117|GS|G#24685|GA200311|GD200314|GLde|GNBrust|CS|NP|SF|[ETX]
Checkout
If a guest is checked out in the hotel software, the checkout command is triggered.
Example
- Request (OUT):
[STX]GO|DA200313|TI071221|RN117|GS|G#6712|SF|[ETX]
RoomStatus
The room status whether a room is "dirty" or "clean" can be sent via the interface.
Dirty
The room status can be set to dirty using the following commands: RS1, RS2
Example:
- Request (IN):
[STX]RE|RN315|RS1|[ETX]
Clean
All different commands set the room status clean.
Example:
- Request (IN):
[STX]RE|RN315|RS3|[ETX]
Casablanca offers the additional option of setting the room to "dirty" directly at check-in. This means that the status would only have to be set to "clean" when the guest changes, e.g. by the chambermaid, if the room is ready for check-in. At check-in, the status of the room in the hotel software automatically changes to "dirty" again.
In Casablanca, the room status appears directly on the room plan.
Dirty:
Clean:
Wakeup
It is possible to set or delete wake-up calls via the interface.
Set wakeup-call
Example:
- Request (OUT):
[STX]WR|DA200926|TI064500|RN317|[ETX]
Confirm wake-up call
Whether the wake-up call was carried out correctly or whether there were errors is confirmed by the telephone system to Casablanca.
Example:
- Request (IN):
[STX]WA|DA200926|TI064500|RN317|ASOK|[ETX]
Delete a wake-up call
Example
- Request (OUT):
[STX]WC|DA200926|TI064500|RN317|[ETX]
Transmission of fees
Any charges incurred are transmitted from the telephone system to Casablanca.
Example:
- Request (IN):
[STX]PS|DA200313|TI064746|RN308|DD00492832973877|DU000911|MP28|PTT|SO10000|P#156|[ETX] - Response(OUT):
[STX]PA|DA200313|TI065858|ASOK|RN|SO|P#156|[ETX]
Error-Codes
Here you will find the error codes for the FIAS interface. These can be returned via the interface as an answer.
| Code | Supported Interface Types | Meaning |
|---|---|---|
| AA | PBX - DID-Response | Virtual Number already assigned |
| AN | PBX - DID-Response | Virtual Number not found |
| BM | VSS/remote check-out | Balance mismatch |
| BY | Wakeup/Key Services | Telephone / Encoder Busy |
| CD | VSS/remote check-out | Check-out date is not today |
| DN | EFT | Request denied |
| FX | Guest related requests | Guest not allowed this feature |
| IA | Guest related requests | Invalid account |
| NA | All systems | Night Audit |
| NF | VSS/remote check-out | Feature not enabled or Check-out process not running |
| NG | All information requests | Guest not found |
| NM | Message/Locator request | Message/Locator not found |
| NR | Wakeup | No Response |
| OK | All systems | Command or request completed successfully |
| RF | EFT | Referral |
| RY | All systems | Retry |
| UR | All systems | Unprocessable request, this request cannot be carried out , no retry |