Fidelio Cruise Software GmbH

Borselstrasse 16c
22765 Hamburg, Germany
Tel: +49(0) 40 39807 0
Fax: +49(0) 40 39807 300
e-Mail: [email protected]

Universal Interface
Quick User Guide
Version 7.30

Copyright
2011 Fidelio Cruise Software GmbH. All rights reserved. No part of this publication may be reproduced, photocopied,
stored on a retrieval system, or transmitted without the express prior written consent of the publisher. Fidelio Cruise
Software GmbH retains the right to update or change the contents of this document without prior notice Fidelio Cruise
Software GmbH assumes no responsibility for the contents of this document. Information in this document is subject to
change without notice. Fidelio Cruise Software GmbH makes no warranty of any kind with regard to this material,
including but not limited to the implied warranties of marketability and fitness for a particular purpose. Fidelio Cruise
Software GmbH shall not be liable for errors contained herein or for incidental or consequential damages in connection
with the furnishing, performance, or use of this material.

Universal Interface – Quick User Guide Page 1 of 46

 Revision History

Version Date Description Author

7.3.139 30/JUN/08 TT 3666, TT 3665, TT 3144, TT 3599, TT 4808, Kelvin Chan

7.3.132 TT 4506, TT 4224, TT 4218,
7.3.126
7.3.123
7.3.122
7.3.121

7.3.228 25/JUN/08 TT 5288, TT 4333, TT 1855, TT 3896 PY Lee

7.3.300 18/JUN/08 TT 4931 Kelvin Chan

7.3.400 15/AUG/08 TT 5549 Kelvin Chan

7.3.501 04/JUN/09 TT 5725 PY Lee

7.3.503 15/SEP/2009 TT 6660 PY Lee

7.3.600 03/JAN/10 TT 7181, TT 7182, TT 7293 PY Lee

7.3.602 10/MAR/10 TT 8045, TT 8085 PY Lee

7.3.602 08/APR/10 TT 7798 Chooi Peng

7.3.610 14/OCT/2010 TT 9381 YK Lim

7.3.700 14/OCT/2010 TT 8354 YK Lim

Universal Interface – Quick User Guide Page 2 of 46

 General Overview

Universal Interface now offers new features and enhancements. This document introduces these
features and enhancements by providing a brief summary of each.

Fix
TT No. Version Description

8354 7.3.700 Add option to retrieve information for User Definable Fields

7.3.510
9381 7.3.610 Fixed printing boardcard sends check in message to PBX
7.3.702
7.3.700
7798 Ability to handle Events booking.
7.3.601

8085 7.3.700 Add "Excuse from Safety Drill" flag in Inquiry Response message.
7.3.601

8045 7.3.700 Add more safety information in Inquiry Response message.

7.3.601

7293 7.3.600 Added new field for Inquire Message type to display onboard or shoreside status.

7182 7.3.600 Added new field for Inquire Message type to display muster station information.

7181 7.3.600 Added new field for Inquire Message type to display handicapped information.

6673 7.3.502 Add user definable label for the Dining Room option.

6666 7.3.502 Add option to allow posting go through even account is disabled or credit limit is
exceeded.

6660 7.3.502 Ability to send Group ID and cabin steward name to PBX system.

5725 7.3.401 Ability to disable casino posting from external system for guest account without
credit card registered.

5549 7.3.400 Ability to send picture to external system in InquireResponse message.

Universal Interface – Quick User Guide Page 3 of 46

 4931 7.3.300 SPA booking added to Universal Interface.

5288 7.3.150 Add Nationality and Booking ID into ExtCheckIn message.

7.3.228
7.3.300

4333 7.3.1264 Additional fields for message type InquireResponse and ExtCheckIn.

3896 7.3.138 Number of Printed Tickets as part of the ExcFolioResponse Message Type.
7.3.201
7.3.300

4808 7.3.139 Remove searching of PIN Code for all message type with ACE=P.

1855 7.3.138 Ability to define 4 Account ID Entry Type for Clock In Message Type.
7.3.201
7.3.300

4508 7.3.132 Ability to support 3 additional interactive excursion ITV parameters.

4506 7.3.132 Do not send “No Print” status postings to external system.

4224 7.3.126 Additional fields in Universal Interface to cater for HAL Slot Machine.

4218 7.3.126 New field to specify language when booking excursions.

3599 7.3.123 “Air Conditioning” Interface.

3666 7.3.121 Include adult or child tag in Excursion Folio response message.

3665 7.3.121 Interface trigger and update external systems when reservation fields changed in
Management and Quick Check-In module.

3144 7.3.121 Include cruise id field in Posting response message.

ACTION: Action item

Universal Interface – Quick User Guide Page 4 of 46

 NOTE: Note of interest

TIP: Tip

WARNING: Warning

Universal Interface – Quick User Guide Page 5 of 46

TT 8354
Add Option to retrieve information for User Definable Fields
Universal Interface is capable to retrieve and update User Definable Filed (UDF) for Account.

 UDFRead
 UDFReadResponse
 UDFUpdate
 UDFUpdateResponse

• UDFRead is send to the FCUI to read the user define type of a passenger.
• UDFReadResponse is sent by the FCUI to retrieve the user define field.

Action Message

Example <STX>UDFRead<US>REF=TV#1<US>RQN=1214<US>DTE=1997-09-11
Message
14:10:45<US>ACI=2089734<ETX><CHECKSUM>
Receive

Example <STX>UDFUpdateResponse<US>REF=TV#1<US>RQN=1217<US>DTE=1997-09-11
Message 14:10:49<US>ACI= 2089734<ETX><CHECKSUM>
Send

• UDFUpdate is sent to the FCUI to update the user define type of a passenger.
• UDFUpdateResponse is sent by the FCUI to acknowledge the successfully of updating user
define fields.

Action Message

<STX>UDFUpdate<US>REF=TV#1<US>RQN=1214<US>DTE=1997-09-11
Example 14:10:45<US>ACI=2089734<US>UID=1<US>UVL=Test 1<ETX><CHECKSUM>
Message
Receive <STX>UDFUpdate<US>REF=TV#1<US>RQN=1214<US>DTE=1997-09-11
14:10:45<US>ACI=2089734<US>UID1=1<US>UVL1=Test
1<US>UID2=1<US>UVL2=Testing 1<ETX><CHECKSUM>

Example <STX>UDFUpdateResponse<US>REF=TV#1<US>RQN=1217<US>DTE=1997-09-11
Message 14:10:49<US>ACI= 2089734<ETX><CHECKSUM>
Send

Universal Interface – Quick User Guide Page 6 of 46

TT 9381
Fixed printing boardcard sends check in message to PBX
• This is to fixed the problem where the expected guest still sending the changePID message to
PBX
• The new handling as below:
➔ Expected Guest
1. When Print/Reset Board Card, the ChangePID message will not send to PBX
2. During Check in, only CheckIN message will send to PBX if you choose to print the
existing card. Else it will send ChangePID to PBX for printing the card with new PID.

➔ For Check in Guest

1. When Print Board Card with existing PID, ChangePID will not send to PBX
2. When Print with new PID, ChangePID(Old PID) will send to PBX
3. Reset Board Card will send ChangePID to PBX

Universal Interface – Quick User Guide Page 7 of 46

TT 7798
Ability to handle Event booking

Universal Interface is capable to accept Events booking from an external system. There are 7
message types to be sent from the external system.

 Events
 ExtEvents
 EventsResponse
 Eventbooking
 EventbookingResponse
 EventFolio
 EventFolioResponse

1. Events and ExtEvents message type are used to request a list of events available from the
FCSPMS. EventsResponse message type is sent by the FCUI to supply list of events that fall
within starting and ending date or time specified by external system.

Action Message

Example <STX>Events<US>REF=TV#1<US>RQN=121<US>DTE=1997-09-11
Message 14:10:29<US>SDT=1997-09-12 00:00:00<US>EDT=1997-09-12
Receive 23:59:59<ETX><CHECKSUM>

<STX>ExtEvents<US>REF=TV#1<US>RQN=121<US>DTE=1997-09-11
14:10:29<US>BDT=1997-09-12
00:00:00<US>TYP=L<US>COD=Cinema<ETX><CHECKSUM>

<STX>ExtEvents<US>REF=TV#1<US>RQN=121<US>DTE=1997-09-11
14:10:29<US>BDT=1997-09-12
00:00:00<US>TYP=N<US>COD=HAM0012<ETX><CHECKSUM>

<STX>ExtEvents<US>REF=TV#1<US>RQN=121<US>DTE=1997-09-11
14:10:29<US>BDT=1997-09-12
00:00:00<US>TYP=I<US>COD=73928740<ETX><CHECKSUM>

Universal Interface – Quick User Guide Page 8 of 46

 <STX> EventsResponse <US>REF=Comp1<US>RQN=125<US>DTE=1997-09-
11 14:11:34<US>EID1=1<US>ENO1=TEST<US>NAM1=Test<US>SDT1=2009-
04-06 00:00:01<US>EDT1=2009-04-07
00:00:00<US>STA1=F<US>PCT1=TEST<US>PCN1=Test<US>PGT1=TEST<US
>PGN1=Test<US>PCA1=10<US>INF1=Test<US>SIK1=Yes<US>BIK1=Yes<US>
Example
MAX1=0<US>CUR1=0<US>LOC1=Test<US>SIT1=Yes<US>BIT1=Yes<US>DSC
Message
1=Test<US>EID2=2<US>ENO2=TEST<US>NAM2=Test<US>SDT2=2008-11-28
Send
00:00:01<US>EDT2=2008-11-29
00:00:00<US>STA2=O<US>PCT2=TEST<US>PCN2=Test<US>PGT2=TEST<US
>PGN2=Test<US>PCA2=11<US>INF2=Test<US>SIK2=Yes<US>BIK2=Yes<US>
MAX2=0<US>CUR2=3<US>LOC2=Test<US>SIT2=Yes<US>BIT2=Yes<US>DSC
2=Test<ETX><CHECKSUM>

2. EventBooking message type is sent to the FCUI to insert event booking and post event charge.
EventBookingResponse message type is sent by the FCUI to confirm posting made.

Action Message

Example <STX>EventBooking<US>REF=TV#1<US>RQN=1214<US>DTE=1997-09-11
Message 14:10:45<US>ACI=0123<US>ACE=A<US>ACS=C<US>BOI=Booking: A23
Receive <US>EID=13<US>PCT=Gold<US>PGT=Adult<US>QTY=1<US>INF=VIP
Tickets<US>PIN=12345<US>SRC=Shorex Kiosk 12<ETX><CHECKSUM>

<STX>EventBooking<US>REF=TV#1<US>RQN=1214<US>DTE=1997-09-11
14:10:45<US>ACI=0123<US>ACE=A<US>ACS=C<US>BOI=Booking: A23
<US>EID1=13<US>PCT1=Gold<US>PGT1=Adult<US>QTY1=1<US>EID2=14<U
S>PCT2=SilverUS>PGT2=Adult<US>QTY2=1<US>INF=VIP
Tickets<US>PIN=12345<US>SRC=Shorex Kiosk 12<ETX><CHECKSUM>

Example <STX>EventBookingResponse<US>REF=TV#1<US>RQN=1217<US>DTE=199
Message 7-09-11 14:10:49<US>ACI1= 9001201<US>ACT1=P<US>NAM1=John Malkovitch
Send <US>CAB1=0123<US>EMB1=1997-09-10<US>DIS1=1997-09-12
<US>BAL1=123.45<US>CRU1=0<US>ACI2=9001202<US>ACT2=P<US>NAM2=
Jane Malkovitch<US>CAB2=0123 <US>EMB2=1997-09-11<US>DIS2=1997-09-
13<US>BAL2=24.12<US>CRU2=0<ETX><CHECKSUM>

<STX>EventBookingResponse<US>REF=TV#1<US>RQN=
1218<US>DTE=1997-09-
1114:10:59<US>ACI=9001201<US>ACT=P<US>NAM=John
Malkovitch<US>CAB=0123<US>EMB=1997-09-10<US>DIS=1997-09-12
<US>BAL=145.79<US>CRU=12345<ETX><CHECKSUM>

Universal Interface – Quick User Guide Page 9 of 46

3. EventFolio message type is used to request list of events booked on a specific account in
FCSPMS. EventFolioResponse message type is sent by the FCUI to supply the list of events
currently booked for the account specified by an external system. The message returns the
same list of events that are visible through FCSPMS system.

Action Message

Example <STX>EventFolio<US>REF=TV#1<US>RQN=1209<US>DTE=1997-09-11
Message 14:10:23<US>ACI=9001201<ETX><CHECKSUM>
Receive

Example <STX>EventFolioResponse<US>REF=TV#1<US>RQN=120<US>DTE=1997-09-
Message 11 14:11:12<US>EID1=12<US>ENO1=2<US>NAM1=Dining with
Send crocodiles<US>SDT1=1997-09-12 17:30:00<US>EDT1=1997-09-12
20:30:00<US>STA1=A<US>BDT1=1997-09-13 12:34:21<US>
PCT1=TEST<US>PCN1=Test<US>PGT1=TEST<US>PGN1=Test<US>
LOC1=Ciname<US>QTY1=1<US>BOV1=12.10<US> INF1=Keep warm<US>
PCN1=1<US>EID2=12<US>ENO2=2<US>NAM2=Dining with
crocodiles<US>SDT2=1997-09-12 17:30:00<US>EDT2=1997-09-12
20:30:00<US>STA2=A<US>BDT2=1997-09-13 12:34:21<US>
PCT2=TEST<US>PCN2=Test<US>PGT2=TEST<US>PGN2=Test<US>
LOC2=Ciname<US>QTY2=1<US>BOV2=12.10<US> INF2=Keep
warm<USPCN2=1<ETX><CHECKSUM>

Universal Interface – Quick User Guide Page 10 of 46

TT 8085
Add "Excuse from Safety Drill" flag in Inquiry Response message

• Universal interface is now including the crew “Excuse from Safety Drill” flag while sending
Inquire message to external system.

• The new field “NDR” is added to display crew “Excuse from Safety Drill” flag in Inquire
Response message.

• If NDR = No, “Excuse from Safety Drill” in Safety Info tab is un-checked.

• If NDR = Yes, “Excuse from Safety Drill” in Safety Info tab is checked.

Universal Interface – Quick User Guide Page 11 of 46

TT 8045
Add more safety information in Inquiry Response message

• Universal interface is now including the safety information while sending Inquire message to
external system.

• Below fields are added to display crew safety information in Inquire Response message.

- SFT= Safety Number

- SMC= Muster Station Code
- SMN= Muster Station Name
- EC1 until EC6 = Muster Station code of Emergency Duties
- EN1 until EN6 = Muster Station name of Emergency Duties

Universal Interface – Quick User Guide Page 12 of 46

TT 7293
Added new field for Inquire Message type to display onboard or shoreside status

• Universal interface is now including the passenger onboard status or ashore status while
sending Inquire message to external system.

• The new field “SHR” is added to display passenger onboard or shoreside status in Inquire
Response message.

• If SHR =0, passenger is at onboard status.

Universal Interface – Quick User Guide Page 13 of 46

• If SHR=1, passenger is at shoreside status.

Universal Interface – Quick User Guide Page 14 of 46

TT 7182
Added new field for Inquire Message type to display muster station information

• Universal interface is now including the muster station while sending Inquire message to
external system.

• The new field “MST” is added to display muster station that associated with passenger cabin in
Inquire Response message.

Universal Interface – Quick User Guide Page 15 of 46

TT7181
Added new field for Inquire Message type to display handicapped information

• Universal interface is now including the handicapped information while sending Inquire message
to external system.

• The passenger who have handicapped assigned will display Handicapped Code (HAD) and
Handicapped Description (HAR) in Inquire Response.

Universal Interface – Quick User Guide Page 16 of 46

TT6673
Add user definable label for the Dining Room option

• FCUI is ability to allow user customize the label of Dining Room Interface setup. Customize the
label name at Administration module → System Setup → Label Setup → DINING.

• The user definable label will display on FCUI setting screen.

Universal Interface – Quick User Guide Page 17 of 46

• The user definable label will show in the offline message that pops up when logging into SPMS
modules.

TT6666
Add option to allow posting go through even account is disabled or credit limit is
exceeded

• FCUI is added a flag to allow user add the posting to account even account’s credit limit is
exceeded or buyer posting is disabled.

<STX>Posting<US>REF=POS#2<US>RQN=122<US>DTE=1997-09-11
Example 14:10:35<US>ACI=9001201<US>ACE=I<US>ACS=R<US>POI=10982<US>POO1=22<US>P
OV1=12.34<US>POD1=2.1<US>POC1=0.12
Message <US>POT1=1<US>POO2=24<US>POV2=10<US>INF=VIP<US>PIN=123455<US>FLG=Y
<ETX><CHECKSUM>

• If FLG=Y, posting will go through even Credit Limit is exceeded or Buyer Posting is Disabled.

• If FLG=N or FLG not defined, posting is not allow to go through when Credit Limit is exceeded or
Buyer Posting is Disabled.

Universal Interface – Quick User Guide Page 18 of 46

TT 6660
Ability to send Group ID and cabin steward name to PBX system

• If guest is linked to the group, FCUI will send the group ID to PBX system when guest check in
or enable phone. This is to enable the PBX system to send the same text message or voicemail
to all members of a group.

Universal Interface – Quick User Guide Page 19 of 46

• The FCUI will pass the cabin steward name to the PBX system so that the name of the cabin
keeper that has been assigned to the housekeeping section will display in part of the welcome
message when passenger first check in.

• If cabin keeper (CAB_KEEPER) is not existed, FCUI will send housekeeper (HKS_KEEPER)
and send to PBX system.

Universal Interface – Quick User Guide Page 20 of 46

TT 5725
Ability to disable casino posting from external system for guest account without
credit card registered

• Universal Interface is now looking at the parameter “PAR > Casino > Allow Posting For Cash
Payment” while user posting the casino posting through Universal Interface.

• If parameter is disabled (parameter value = 0), FCUI is not allow to do casino posting if payer
account without credit card registered.

• Below screenshot show, the FCUI simulator display the negative response if system detected
the payer account do not have credit card registered and parameter is disabled.

• FCUI is allows to payer account without credit card registered to post the casino posting if the
system parameter is enabled.

Universal Interface – Quick User Guide Page 21 of 46

TT 5549
Ability to send picture to external system in InquireResponse message

1. Go to Universal Interface Settings tab, tick the checkbox “Send Guest Picture for
InquireResponse”.

Universal Interface – Quick User Guide Page 22 of 46

2. From the external system or FCUI simulator program, send an “Inquire” message to the
interface.

3. The new field PIC in the InquireReponse message identifies the guest picture. The data format
will be in Hex.

4. Below is a single response message reply from the interface.

Action Message

Receive <STX>Inquire<US>REF=POS#1<US>RQN=120<US>DTE=2008-08-15
14:10:23<US>ACI=9841000239483100<US>ACE=C<US>ACS=C<ETX><EOT>

Send <STX>InquireResponse<US>REF=POS#1<US>RQN=120<US>DTE=2008-08-15
14:10:23<US>ACI=2403859<US>ACT=P<US>ENB=1<US>NAM=KELVIN
CHAN<US>CAB=00000<US>EMB=2008-07-07 00:00:00<US>DIS=2008-07-14
00:00:00<US>DOB=1972-11-13
00:00:00<US>BAL=0<US>FST=KELVIN<US>LST=CHAN<US>SAL=<US>TTL=<US>GND=M<US>MIN=N<
US>LAN=EN<US>STA=C<US>PIN=<US>AKY=4831<US>BID=<US>SID=<US>VGD=8WXDXW01U810<U
S>AWD=<US>BCC=9841000239483100<US>NAT=MY<US>PIC=FFD8FFE000104A464946000102000
00100010000FFE1000B50494300020A0A0100FFC000110801E0017103012200021101031101FFDB
……………………………………………..D92D90FFB21FFD9<ETX><

5. Below is the multiple response messages reply from the interface.

Action Message

Receive <STX>Inquire<US>REF=POS#1<US>RQN=120<US>DTE=2008-08-15
14:10:23<US>ACI=00000<US>ACE=A<US>ACS=C<ETX>4

Send <STX>InquireResponse<US>REF=POS#1<US>RQN=120<US>DTE=2008-08-15
14:10:23<US>ACI1=2403859<US>ACT1=P<US>ENB1=1<US>NAM1=KELVIN
CHAN<US>CAB1=00000<US>EMB1=2008-07-07 00:00:00<US>DIS1=2008-07-14
00:00:00<US>DOB1=1972-11-13
00:00:00<US>BAL1=0<US>FST1=KELVIN<US>LST1=CHAN<US>SAL1=<US>TTL1=<US>GND1=M<US>
MIN1=N<US>LAN1=EN<US>STA1=C<US>PIN1=<US>AKY1=4831<US>BID1=<US>SID1=<US>VGD1=8
WXDXW01U810<US>AWD1=<US>BCC1=9841000239483100<US>NAT1=MY<US>PIC1=FFD8FFE000
104A464946000102000001000………..AD2D92D90FFB21FFD9<US>ACI2=2403860<US>ACT2=P<US>
ENB2=1<US>NAM2=VICKY TAI<US>CAB2=00000<US>EMB2=2008-07-07 00:00:00<US>DIS2=2008-
07-14 00:00:00<US>DOB2=1974-06-03
00:00:00<US>BAL2=0<US>FST2=VICKY<US>LST2=TAI<US>SAL2=<US>TTL2=<US>GND2=F<US>MIN2
=N<US>LAN2=EN<US>STA2=C<US>PIN2=8866<US>AKY2=4832<US>BID2=<US>SID2=<US>VGD2=8
WXDXW02U810<US>AWD2=<US>BCC2=9841000239483200<US>NAT2=MY<US>PIC2=FFD8FFE000
104A4649460001………………………..C6E3FFD9<ETX>Y

Universal Interface – Quick User Guide Page 23 of 46

TT 5288
Add Nationality and Booking ID into ExtCheckIn message

1. Run the Universal Interface. (Ensure the Universal Interface is running on same database
server). In Management module, check in the expected guest.

2. While user checks in the expected guest, the Universal Interface will return the guest information
in ExtCheckIn message.

Above screenshot show the Nationality (NAT) and Booking ID (BID) is being sent while guest do
the check-in in Management module

Universal Interface – Quick User Guide Page 24 of 46

TT 4931
SPA booking added to Universal Interface.

1. Universal Interface is capable to accept SPA booking from an external system. There are 5
message types to be sent from the external system, each must be sending in the following
sequence.

 SPALocation
 SPATreatmentGroup
 SPATreatmentItem
 SPATreatmentAvailability
 SPABooking

2. SPALocation message type is used to request the SPA Location from the FCSPMS.
SPALocationResponse message type is sent by the FCUI to supply the information in
response to an inquiry request from an external system. The message returns SPA Location
configure in FCSPMS.

Action Message

Receive <STX>SPALocation<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22 14:10:32<ETX><ACK>

Send <STX>SPALocationResponse<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22
14:10:32<US>LID1=1001<US>LNM1=Beauty<US>LID2=1000<US>LNM2=Hairdresser<US>LID3=1002
<US>LNM3=Health<ETX>}

3. SPATreatmentGroup message type is used to request the SPA Treatment Group from the
FCSPMS. SPATreatmentGroupResponse message type is sent by the FCUI to supply the
information in response to an inquiry request from an external system. The message returns
SPA Treatment Group configure in FCSPMS. The purpose of treatment group is use to filter
treatment items.

Action Message

Receive <STX>SPATreatmentGroup<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22 14:10:32<ETX>

Send <STX>SPATreatmentGroupResponse<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22
14:10:32<US>TGC1=Hand &<US>TGN1=Hand &
Fuß<US>TGC2=Men<US>TGN2=Men<US>TGC3=Paket<US>TGN3=Paket<US>TGC4=S -
Cl<US>TGN4=S - Classics<US>TGC5=S - Ex<US>TGN5=S - Extras<US>TGC6=S - Fa<US>TGN6=S -
Farbe & Welle<US>TGC7=S - Ha<US>TGN7=S - Haslauer<US>TGC8=S - Hi<US>TGN8=S -
Highlights<US>TGC9=S - Ki<US>TGN9=S - Kids<US>TGC10=S - Ko<US>TGN10=S - Kosmetik
Einzel<US>TGC11=S - Le<US>TGN11=S - Leistungstest / PT<US>TGC12=S - Li<US>TGN12=S - Ligne
St. Barth<US>TGC13=S - Ma<US>TGN13=S - Maria Galland<US>TGC14=S - Pa<US>TGN14=S -
Paket<US>TGC15=S - Th<US>TGN15=S - Thalasso<US>TGC16=S - Wo<US>TGN16=S -
Workshops<US>TGC17=WSF<US>TGN17=WSF<US>TGC18=Worksh<US>TGN18=Workshops<ETX>Ê

Universal Interface – Quick User Guide Page 25 of 46

4. SPATreatmentItem message type is used to request the SPA Treatment Item from the
FCSPMS. SPATreatmentItemResponse message type is sent by the FCUI to supply the
information in response to an inquiry request from an external system. The message returns
SPA Treatment Item configure in FCSPMS.

Action Message

Receive <STX>SPATreatmentItem<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22
14:10:32<US>TGC=Men<US>ACI=617099<US>LID=1001<ETX>t

Send <STX>SPATreatmentItemResponse<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22
14:10:32<US>TID1=410<US>TIC1=1001505711<US>TIN1=SPA-T, Anfeuchten, Schneiden,
Fertig<US>TDR1=39<US>MIN1=15<US>MAX1=15<US>TID2=295<US>TIC2=1001502611<US>TIN2=S
PA-T, Fassonschnitt
Herren<US>TDR2=30<US>MIN2=15<US>MAX2=15<US>TID3=316<US>TIC3=1001502711<US>TIN3=
SPA-T, Maschinenschnitt
Herren<US>TDR3=30<US>MIN3=15<US>MAX3=15<US>TID4=321<US>TIC4=1001502811<US>TIN4=
SPA-T,
Schnurrbart<US>TDR4=15<US>MIN4=8<US>MAX4=8<US>TID5=409<US>TIC5=1001505611<US>TIN
5=SPA-T, Vollbart
kürzen<US>TDR5=15<US>MIN5=15<US>MAX5=15<US>TID6=327<US>TIC6=1001505311<US>TIN6=
SPA-T, Waschen/Foenen
Herren<US>TDR6=30<US>MIN6=15<US>MAX6=15<US>TID7=336<US>TIC7=1001502911<US>TIN7=
SPA-T, Waschen/Schneiden/Foehnen Herren<US>TDR7=30<US>MIN7=25<US>MAX7=25<ETX>•

5. SPATreatmentAvailability message type is used to request the SPA Treatment Availability

(time slot) from the FCSPMS. SPATreatmentAvailabilityResponse message type is sent by
the FCUI to supply the information in response to an inquiry request from an external system.
The message returns what is the date and time the SPA Treatment is Availability in FCSPMS.

Action Message

Receive <STX>SPATreatmentAvailability<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22
14:10:32<US>LID=1001<US>TID=233<US>ACI=617097<ETX><ETX>

Send <STX>SPATreatmentAvailabilityResponse<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22
14:10:32<US>TDT1=2008-05-22 10:00:00<US>TPC1=20<US>TDT2=2008-05-22
10:15:00<US>TPC2=20<US>TDT3=2008-05-22 10:30:00<US>TPC3=20<US>TDT4=2008-05-22
10:45:00<US>TPC4=20<US>TDT5=2008-05-22 11:00:00<US>TPC5=20<US>TDT6=2008-05-22
11:15:00<US>TPC6=20<US>TDT7=2008-05-22 11:30:00<US>TPC7=20<US>TDT8=2008-05-22
11:45:00<US>TPC8=20<US>TDT9=2008-05-22 12:45:00<US>TPC9=20<US>TDT10=2008-05-22
13:00:00<US>TPC10=20<US>TDT11=2008-05-22 13:15:00<US>TPC11=20<US>TDT12=2008-05-22
13:30:00<US>TPC12=20<US>TDT13=2008-05-22 13:45:00<US>TPC13=20<US>TDT14=2008-05-22
14:00:00<US>TPC14=20<US>TDT15=2008-05-22 14:15:00<US>TPC15=20<US>TDT16=2008-05-22
14:30:00<US>TPC16=20<US>TDT17=2008-05-22 14:45:00<US>TPC17=20<US>TDT18=2008-05-22
15:00:00<US>TPC18=20<US>TDT19=2008-05-22 15:15:00<US>TPC19=20<US>TDT20=2008-05-22
15:30:00<US>TPC20=20<US>TDT21=2008-05-22 15:45:00<US>TPC21=20<US>TDT22=2008-05-22
16:00:00<US>TPC22=20<US>TDT23=2008-05-22 16:15:00<US>TPC23=20<US>TDT24=2008-05-22
16:30:00<US>TPC24=20<US>TDT25=2008-05-22 16:45:00<US>TPC25=20<US>TDT26=2008-05-22
17:00:00<US>TPC26=20<US>TDT27=2008-05-22 17:15:00<US>TPC27=20<US>TDT28=2008-05-22
17:30:00<US>TPC28=20<US>TDT29=2008-05-22 17:45:00<US>TPC29=20<US><ETX>G

Universal Interface – Quick User Guide Page 26 of 46

 NOTE: If there is no availability on that day, the failure message “No Treatment Available”
returns by FCUI to the external system.

6. SPABooking message type is used to make a SPA Booking. SPABookingResponse message

type is sent by the FCUI to indicate success of the SPA Booking.

Action Message

Receive <STX>SPABooking<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22
14:10:32<US>LID=1001<US>TID=233<US>ACI=617097<US>TDT=2008-05-22 17:45:00<ETX>q

Send <STX>SPABookingResponse<US>REF=FCUI#1<US>RQN=121<US>DTE=2008-05-22 14:10:32<ETX>Q

7. The SPA bookings are appear in Guest Handling | Itinerary Planner.

Universal Interface – Quick User Guide Page 27 of 46

TT 4333
Additional fields for message type InquireResponse and ExtCheckIn

• 4 more new fields are needed for the INQUIRERESPONSE message type. There are
RES_SHOREID, RES_BOOKNR, RES_V_GUESTID and RES_AWARD_LEVEL.

o BID = RES_BOOKNR
o SID = RES_SHOREID
o VGD = RES_V_GUESTID
o AWD = RES_AWARD_LEVEL

• 1 new field is needed for the EXTCHECKIN message type which is RES_AWRD_LEVEL.

Action Message

Receive InquireResponseREF=POS#1RQN=120DTE=2007-04-12 14:10:23ACI=2403258ACT=P-

ENB=1NAM=KELVIN CHANCAB=00000EMB=2007-04-12 00:00:00DIS=2007-04-14
00:00:00DOB=1972-11-13 00:00:00BAL=0FST=KELVINLST=CHANSAL=TTL=GND=M-
MIN=NLAN=ENSTA=CPIN=0AKY=4349BID=SC008SID=X8899VGD=QQQ001-
AWD=A1 s

Above is the InquireResponse message that replies to the external system

Action Message

Receive ExtCheckIn<US>REF=KELVINXP<US>RQN=2403306<US>DTE=2007-04-12
15:43:30<US>ACI=2403306<US>ACT=P<US>ENB=0<US>NAM=,VICKY
TAI<US>CAB=00000<US>EMB=2007-04-12 00:00:00<US>DIS=2007-04-14
00:00:00<US>DOB=1974-06-04
00:00:00<US>BAL=0<US>FST=VICKY<US>LST=TAI<US>SAL=<US>TTL=<US>GND=F<
US>MIN=N<US>LAN=EN<US>PIN=<US>AKY=4388<US>BCC=9841000239438800<US>
AWD=A1<ETX>K

Below is the ExtCheckIn message that replies to the external system

Universal Interface – Quick User Guide Page 28 of 46

TT 3896
Number of Printed Tickets as part of the ExcFolioResponse Message Type

• PCNx is new information added in ExcFolioResponse Message Type. The PCNx identifies how
many times the tickets had been printed out.

• The Universal Interface will send a response message about the list of excursions currently
booked as well as the number of printed tickets. Ex: PCN1=2 means 1st booking tour had been
printed as 2 times.

Below is a sample message sent out through ExcFolio

Universal Interface – Quick User Guide Page 29 of 46

TT 4808
Remove searching of PIN Code for all message type with ACE=P

• The message type with ACE=P is identified the type of entry in Personal Pin Code number. The
Universal Interface will return nothing if the message type defined by ACE=P.

• The affected the message type are included:

o Inquiry
o Posting
o Payment
o Booking
o Call

Example 1: Inquiry Message Type which is defined by ACE=I. FCUI is received the Inquiry
Response message whereby return null when defined ACE=P

Universal Interface – Quick User Guide Page 30 of 46

 Example 2: Posting Message Type that defined by ACE=I. FCUI is able to post the
message. Whereby Posting Message Type that defined by ACE=P, received message is
return nothing.

Example 3: Call Message Type that defined by ACE=P, it will post to Internal Errors
Account.

Universal Interface – Quick User Guide Page 31 of 46

TT 1855
Ability to define 4 Account ID Entry Type for Clock In Message Type

• Universal Interface received the ClockIn message from external system with ACE type defined.

• The ACE identifies the type of entry in the Account ID field. The following Account ID Entry
Types are defined: The default value is H if this field is omitted or invalid.

C → Card identification number

I → Internal identification number (FCSPMS account ID)
E → External identification number (e.g. reservation number)
H → Internal Id number

Above is the sample Clock In Message Type defined by ACE

Universal Interface – Quick User Guide Page 32 of 46

TT 4508
Ability to support 3 additional interactive excursion ITV parameters

• A new parameter “Control ITV Parameter in FCUI” is added to enable or disable the control of
ITV parameters in either the Universal Interface or the external interactive TV system.

1 - Control the ITV Parameter in FCUI

0 - ITV system have to control the parameter

• In Shore Excursion, go to Bookable Tours Setup and configure the external interactive TV
system configuration. All the settings checkbox are enabled by default.

• If the external interactive TV system wants the selected tour information to be able to send
across then the setting “Show in Interactive TV” checkbox must be checked (enabled).

• The setting “Make Bookable in Interactive TV” is indicates that the selected tour can be booked
from the external interactive TV system.

• The setting “Enable Child Booking in Interactive TV” is indicates that the selected tour can be
booked by child from the external interactive TV system.

Universal Interface – Quick User Guide Page 33 of 46

• When the ITV system sends a message to request a list of the bookable excursions available
within the specified date range from Fidelio Cruise, then the Universal Interface will response
with the available excursions that meet the requirements. Below is the request message from
external ITV system.

ExcursionsREF=TV#1RQN=001DTE=2007-05-24 12:15:29SDT=2007-05-24 00:00:00-

EDT=2007-05-24 23:59:59 G

• The Universal Interface will send a response message according to the external interactive TV
system configurations and all bookable excursions within the specified date range. Below is the
response message from the Universal Interface.

ExcursionsResponseREF=TV#1RQN=001DTE=2007-05-24
12:15:29EID1=49722ENO1=VPEN-001NAM1=Trishaw Ride In The Pearl Of The Orient-
SDT1=2007-05-24 10:00:00EDT1=2007-05-24 16:00:00STA1=APAD1=40PCH1=35-
MDT1=2007-05-24 10:00:00SIK1=YesBIK1=YesMAX1=2000CUR1=0PRT1=Penang (new)-
SIT1=YesBIT1=YesBCT1=NoEID2=49724ENO2=VPEN-001 PNAM2=Trishaw Ride ( Prepaid
)SDT2=2007-05-24 10:00:00EDT2=2007-05-24 16:00:00STA2=APAD2=0PCH2=0-
MDT2=2007-05-24 09:45:00SIK2=YesBIK2=YesMAX2=100CUR2=0PRT2=Penang (new)-
SIT2=YesBIT2=NoBCT2=YesEID3=49726ENO3=VPEN-002NAM3=Heritage and Temple-
SDT3=2007-05-24 10:00:00EDT3=2007-05-24 16:00:00STA3=APAD3=30PCH3=25-
MDT3=2007-05-24 10:00:00SIK3=YesBIK3=YesMAX3=2000CUR3=0PRT3=Penang (new)-
SIT3=YesBIT3=YesBCT3=Yes w

• If the “Show in Interactive TV” setting for the bookable tour is disabled then the excursion
information will not be sent across to the external system otherwise the excursion information
will be sent to the external system.
• If the “Show in Interactive TV” setting for the bookable tour is enabled and then the field “SIT”,
“BIT” and “SIT” will be added to the ExcursionsResponse message. The default value for “SIT”
field is “YES”.

• The “BIT” value is depends on the “Make Bookable in Interactive TV” setting. If the “Make
Bookable in Interactive TV” setting is enabled then the value for “BIT” is “YES” otherwise value
is “NO” when is disabled.

• The “SIT” value is depends on the “Enable Child Booking in Interactive TV” setting. If the
“Enable Child Booking in Interactive TV” setting is enabled then the value for “SIT” is “YES”
otherwise value is “NO” when is disabled.

Universal Interface – Quick User Guide Page 34 of 46

TT 4506
Do not send “No Print” status postings to external system

• FolioResponse message will send without “No Print” postings (POS_NOPRINT=1) to the
external system. Below is the folio enquiry message from the external system.

FolioREF=TV#1RQN=120DTE=2007-05-24 14:10:23ACI=2404009 {

• Below is the FolioResponse message without any “No Print” postings and the posting should
indicates the field NPR=NO.

FolioResponseREF=TV#1RQN=120DTE=2007-05-24 14:10:23DPI1=9000DPT1=C-
DPN1=Cash - Ship CurrencyPDT1=2007-05-14 00:00:00VDT1=0VCT1=1800CLS1=No-
NPR1=NoWIN1=0DPI2=9000DPT2=CDPN2=Cash - Ship CurrencyPDT2=2007-05-23
00:00:00VDT2=0VCT2=900CLS2=NoNPR2=NoWIN2=0DPI3=9011DPT3=CDPN3=Visa-
PDT3=2007-05-23 00:00:00VDT3=0VCT3=500CLS3=NoNPR3=NoWIN3=0DPI4=2012-
DPT4=DDPN4=SamuraiPDT4=2007-05-23 00:00:00VDT4=450VCT4=0CLS4=NoNPR4=No-
WIN4=0DPI5=8000DPT5=DDPN5=CasinoPDT5=2007-05-14 00:00:00VDT5=900VCT5=0-
CLS5=NoNPR5=NoWIN5=0DPI6=8000DPT6=DDPN6=CasinoPDT6=2007-05-14 00:00:00-
VDT6=900VCT6=0CLS6=NoNPR6=NoWIN6=0DPI7=8000DPT7=DDPN7=CasinoPDT7=2007-
05-14 00:00:00VDT7=900VCT7=0CLS7=NoNPR7=NoWIN7=0 s

Universal Interface – Quick User Guide Page 35 of 46

TT 4224
Additional fields in Universal Interface to cater for HAL Slot Machine

• When change birth date in Management, Management will send “DataChange” message to
Universal Interface. The Universal Interface will send “PhoneCheckIn” message to PBX system
and send “ExtCheckIn” message to ITV and Dining Reservation.

NOTE: The message “DataChange” must be setup in the parameter “PBX Messages”, “Dining
Room Messages” and “TV Messages”.

• New field “BCC” is added to the message type “ExtCheckIn” to include the board card number
(RES_BOARDCC).

• Below is the “ExtCheckIn” message that included the board card number (BCC):

<STX>ExtCheckIn<US>REF=KELVINXP<US>RQN=2403104<US>DTE=2007-03-13
11:54:07<US>ACI=2403104<US>ACT=P<US>ENB=1<US>NAM=MR,WILLIAN
ZHAO<US>CAB=05005<US>EMB=2007-03-08 00:00:00<US>DIS=2007-03-12
00:00:00<US>DOB=1975-02-28
00:00:00<US>BAL=0<US>FST=WILLIAN<US>LST=ZHAO<US>SAL=MR<US>TTL=DR<US>GND=M
<US>MIN=N<US>LAN=EN<US>ADD=Address
1<US>CTY=City<US>ZIP=3537<US>STT=State<US>CTR=HK<US>PIN=0<US>AKY=100<US>BCC=
9699900004100<ETX>!

• On Guest Handling screen, select a guest and click Print Board Card.

• Click No to reset the board card number. Management will send “ChangePid” message to
Universal Interface. The Universal Interface will send “PhoneCheckIn” message to the PBX
system and send “ExtCheckIn” message to ITV and Dining Reservation system.

NOTE: The message “ChangePid” must be setup in the parameter “PBX Messages”, “Dining
Room Messages” and “TV Messages”.

• Below are the “ChangePid”, “PhoneCheckIn” and “ExtCheckIn” messages:

<CR>ChangePid "9841000239410602" 2402954 "04522"<LF>

Universal Interface – Quick User Guide Page 36 of 46

 PhoneCheckIn<US>REF=KELVINXP<US>RQN=2402954<US>DTE=2007-03-13
12:34:22<US>ACI=2402954<US>NAM=,STEVE
LIM<US>LAN=EN<US>TYP=A<US>NUM=4522<US>AKY=4106<US>FST=STEVE<US>LST
=LIM<ETX>0

<STX>ExtCheckIn<US>REF=KELVINXP<US>RQN=2402954<US>DTE=2007-03-13
12:34:22<US>ACI=2402954<US>ACT=P<US>ENB=1<US>NAM=,STEVE
LIM<US>CAB=04522<US>EMB=2007-03-08 00:00:00<US>DIS=2007-03-12
00:00:00<US>DOB=1980-01-01
00:00:00<US>BAL=0<US>FST=STEVE<US>LST=LIM<US>SAL=<US>TTL=<US>GND=M<US
>MIN=N<US>LAN=EN<US>PIN=<US>AKY=4106<US>BCC=9841000239410603<ETX>E

• The above handling will apply to the following process.

✓ Print board card in Crew Handling screen.
✓ Reset board card (Reset BoardCard button) in Guests Handling.
✓ Reset board card (Reset Board Card button) in Crew Handling.

• The start of current cruise (CSD) and end of current cruise (CED) are added to the message
type “SysMsg”.

<STX>SysMsg<US>REF=Comp1<US>RQN=125<US>DTE=2007-03-13
11:14:12<US>SHP=Demo<US>SDT=2007-03-09<US>SCR=8121-28/02/07 TO
31/03/07<US>ITN=<US>CUR=90033-Malaysian Ringgit<US>VER=7.30.126<US>CSD=2007-
02-28<US>CED=2007-03-31<ETX>T

Universal Interface – Quick User Guide Page 37 of 46

TT 4218
New field to specify language when booking excursions

• The language (LAN) field is added to the message “ExcursionsResponse” when external system
request for a list of the bookable excursion from FCSPMS. The language for the excursion will
only return if the language for the excursion is setup in Shore Excursion module otherwise the
field (LAN) does not include in the message.

• Below is the “ExcursionsResponse” message included the language (LAN) field that returns
from FCSPMS.

<STX>ExcursionsResponse<US>REF=ExcursionInquiry<US>RQN=001<US>DTE=2007-02-05
12:30:00<US>EID1=49016<US>ENO1=LAN-5GP<US>NAM1=Boat tour with lunch - Green
Planet<US>SDT1=2007-03-11 10:00:00<US>EDT1=2007-03-11
17:00:00<US>STA1=A<US>PAD1=100<US>PCH1=50<US>MDT1=2007-03-11
10:00:00<US>MPL1=Grand
Ballroom<US>SIK1=Yes<US>BIK1=Yes<US>MAX1=200<US>CUR1=91<US>PRT1=Langkawi
(new)<US>LAN1=ZH-Chinese,ZM-Mandarin,ZN-Cantonese<US>

• The language (LAN) field is added to the message “Booking” when external system send a
excursion posting to FCSPMS.

• Below is the “Booking” message included the language (LAN) field that sent from the external
system.

<STX>Booking<US>REF=ITV#002<US>RQN=001<US>DTE=2007-03-8
12:30:00<US>ACI=00000<US>ACE=A<US>ACS=C<US>BOI=Booking:
A88<US>EID=49016<US>QAD=1<US>QCH=0<US>PRO=62<US>LAN=ZN<US>INF=Promotion
Tickets<ETX>i

• Below is the “BookingResponse” message that returned to the external system.

<STX>BookingResponse<US>REF=ITV#002<US>RQN=001<US>DTE=2007-03-8
12:30:00<US>ACI=2402854<US>ACT=P<US>NAM=MR KELVIN
CHAN<US>CAB=00000<US>EMB=2007-02-16 00:00:00<US>DIS=2007-03-31
00:00:00<US>BAL=90<US>CRU=8121<ETX>'

Universal Interface – Quick User Guide Page 38 of 46

TT 3599
"Air Conditioning" Interface

• The Universal Interface is able to send a new message type ChangeAirConState to turn on or
turn off a cabin air-conditioning system upon guest check-in or check-out via a PBX system
(Siemens).

• New column CAB_AIRCONENABLED is added to table CAB for storing the cabin air condition
status (1-Turn On, 0-Turn Off).

1. In the Universal Interface Settings tab, check the Enable Aircon Interface via PBX checkbox.
The Auto turn on aircon for reservation section will enable for setup.

2. Select the Start Time and Interval allows the interface trigger to check if there are expected
guest checking in to any cabin within the time frame which hasn’t got their air condition
activated. If found, then the interface will send the message to activate air-condition via the PBX
system.

3. The settings will be saved in the parameter file (FCSettings.par) together with the interface
trigger last run date and time.

[#FCUI.AIRCON.Last Run Time=17/01/2007 23:09:39#]

[#FCUI.Connection.Enable Aircon Interface via PBX=1#]
[#FCUI.Connection.Aircon Interface Start Time=22:00:00#]
[#FCUI.Connection.Aircon Interface Interval=1#]

4. If you manually check-in an expected guest in Management, the interface will send the message
to the PBX system in order to activate the guest cabin air-condition.

5. Below is the sample of the message:

<STX>ChangeAirConState<US>REF=KELVINXP<US>RQN=2402267<US>DTE=2007-01-17
21:33:07<US>CAB=08050<US>STA=1<ETX><ETX>

6. If the message is sent successfully to the PBX system then the interface will update the cabin
air-conditioning status. In this case, the new column CAB_AIRCONENABLED = 1 (Default will
be 0).

Universal Interface – Quick User Guide Page 39 of 46

7. If there are same person traveling with the same guest in the same cabin, the interface will only
send one message to the PBX system to activate the air condition.

8. If there is any cabin movement, the interface will send two messages to PBX system to
deactivate the air condition (from the original cabin) if it wasn’t anymore guest occupying that
cabin. Then, send another message to enable the air-conditioning for the new cabin.

9. Below is the sample of the messages:

If cabin movement still with guest occupying the same cabin. The interface will send a message
via the PBX system to deactivate the air condition for the new cabin and then send a message
to the PBX system to enable the phone for the new cabin.

Below is the sample of the messages:

<STX>ChangeAirConState<US>REF=KELVINXP<US>RQN=2403306<US>DTE=2007-04-29
10:25:10<US>CAB=05002<US>STA=1<ETX><ENQ>

<STX>PhoneCheckIn<US>REF=KELVINXP<US>RQN=2403306<US>DTE=2007-04-29
10:25:10<US>ACI=2403306<US>NAM=,VICKY
TAI<US>LAN=EN<US>TYP=A<US>NUM=5002<US>PIN=0<US>AKY=4388<US>FST=VICKY
<US>LST=TAI<ETX>z

10. If you check-out a guest, the interface will send a message via the PBX system to deactivate the
air condition for the check-out cabin.

Below is the sample of the message:

<STX>ChangeAirConState<US>REF=KELVINXP<US>RQN=2403356<US>DTE=2007-04-29
10:21:49<US>CAB=05000<US>STA=0<ETX><VT>

Universal Interface – Quick User Guide Page 40 of 46

TT 3666
Include adult or child tag in Excursion Folio response message

• The interface will include the ticket tag either for adult or child when the external system (i.e.
iTV) requests a list of excursions that booked for an onboard passenger.

ExcFolioREF=TV#1RQN=0001DTE=2006-10-28 18:45ACI=3867

Above is the request message

ExcFolioResponseREF=TV#1RQN=0001DTE=2006-10-28 18:45EID1=3-
ENO1=KLCTNAM1=Kuala Lumpur City TourSDT1=2006-10-28 10:00:00EDT1=2006-
10-28 14:00:00STA1=ABDT1=2006-10-28 00:00:00BOO1=1BOV1=100MDT1=2006-
10-28 09:30:00CTH1=CasualINF1=Hot WeatherTAG1=AEID2=3ENO2=KLCT-
NAM2=Kuala Lumpur City TourSDT2=2006-10-28 10:00:00EDT2=2006-10-28
14:00:00STA2=ABDT2=2006-10-28 00:00:00BOO2=1BOV2=50MDT2=2006-10-28
09:30:00CTH2=CasualINF2=Hot WeatherTAG2=C m

Above is the sample response message ExcFolioResponse. The field TAG indicates the Adult
(A) or Child (C) Ticket.

Universal Interface – Quick User Guide Page 41 of 46

TT 3665
Interface trigger and update external systems when reservation fields changed in
Management and Quick Check-In module

1. Ensure parameter PAR_NAME = "Dining Room Messages" and "TV Messages" in

PAR_GROUP = "InterfaceMessages" contains message type "DataChange".

2. Run Universal Interface. Enable either TV or Dining IP Port and Host in Settings tab.

3. Run Management and go to Cashier → Guests.

4. Select a checked-in guest and Edit Information.

5. Enter Onboard Email and click OK to save. In the Universal Interface Messages tab, the
message type "DataChange" is received and interface sends the following message to the
external system. The onboard email (SML) will be sent to the external system.

<STX>ExtCheckIn<US>REF=KELVINXP<US>RQN=4592<US>DTE=2006-10-30
12:15:40<US>ACI=4592<US>ACT=P<US>ENB=1<US>NAM=MR,REILLY STEPHEN
JAMES<US>CAB=10632<US>EMB=2006-10-13 00:00:00<US>DIS=2006-11-05
00:00:00<US>DOB=1966-02-10 00:00:00<US>BAL=118<US>FST=REILLY
STEPHEN<US>LST=JAMES<US>SAL=MR<US>TTL=<US>GND=M<US>MIN=N<US>LAN=
EN<US>[email protected]<US>PIN=0<US>AKY=1002<ETX>j

6. Select another checked-in guest and Edit Information.

7. Modify guest First Name or Last Name and click OK to save. In the Universal Interface
Messages tab, the message type "DataChange" is received and interface sends the following
message to the external system. The modified first name (FST) or last name (LST) will be sent
to external system.

<STX>ExtCheckIn<US>REF=KELVINXP<US>RQN=4592<US>DTE=2006-10-30
12:32:45<US>ACI=4592<US>ACT=P<US>ENB=1<US>NAM=MR,REILLY STEVEN
JAMES<US>CAB=10632<US>EMB=2006-10-13 00:00:00<US>DIS=2006-11-05
00:00:00<US>DOB=1966-02-10 00:00:00<US>BAL=118<US>FST=REILLY
STEVEN<US>LST=JAMES<US>SAL=MR<US>TTL=<US>GND=M<US>MIN=N<US>LAN=E
N<US>[email protected]<US>PIN=0<US>AKY=1002<ETX>j

8. Run Quick Check-In module and go to Check In.

9. Select a checked-in guest and click Additional Details tab.

10. Enter Onboard e-Mail and click Save to save the change. In the Universal Interface Messages
tab, the message type "DataChange" is received and interface sends the following message to
the external system. The onboard email (SML) will be sent to the external system.

Universal Interface – Quick User Guide Page 42 of 46

 <STX>ExtCheckIn<US>REF=KELVINXP<US>RQN=5155<US>DTE=2006-10-30
12:30:49<US>ACI=5155<US>ACT=P<US>ENB=1<US>NAM=MR,JIAN MING
ANG<US>CAB=08036<US>EMB=2006-10-13 00:00:00<US>DIS=2006-11-05
00:00:00<US>DOB=1991-03-22 00:00:00<US>BAL=99.5<US>FST=JIAN
MING<US>LST=ANG<US>SAL=MR<US>TTL=<US>GND=M<US>MIN=Y<US>LAN=EN<US
>[email protected]<US>PIN=<US>AKY=2203<ETX>|

11. Select another checked-in guest.

12. Modify guest Surname or Forename and click Save to save the change. In the Universal
Interface Messages tab, the message type "DataChange" is received and interface sends the
following message to the external system. The modified first name (FST) or last name (LST) will
be sent to external system.

<STX>ExtCheckIn<US>REF=KELVINXP<US>RQN=5155<US>DTE=2006-10-30
14:10:35<US>ACI=5155<US>ACT=P<US>ENB=1<US>NAM=MR,JIAN MENG
ANG<US>CAB=08036<US>EMB=2006-10-13 00:00:00<US>DIS=2006-11-05
00:00:00<US>DOB=1991-03-22 00:00:00<US>BAL=99.5<US>FST=JIAN
MENG<US>LST=ANG<US>SAL=MR<US>TTL=<US>GND=M<US>MIN=Y<US>LAN=EN<US
>[email protected]<US>PIN=<US>AKY=2203<ETX>s

TT 3144
Include cruise id field in Posting response message.

• The interface will provide the posted cruise id when the booking or posting is made by any
external system (i.e. iTV, PBX).

• Below are the sample response messages with the cruise id.

1. Message Type: Booking

Request

BookingREF=TV#1RQN=1111DTE=2006-08-24 12:00:00ACI=05516ACE=AACS=C-
BOI=Booking: 123EID=1242QAD=1QCH=0
Response

BookingResponseREF=TV#1RQN=1111DTE=2006-08-24 12:00:00ACI=3209642ACT=P-
NAM=PAX TESTCAB=05516EMB=2006-08-24 00:00:00DIS=2006-08-25 00:00:00BAL=280-
CRU=6401 !

Universal Interface – Quick User Guide Page 43 of 46

 2. Message Type: Posting1
Request

PostingREF=POS#1RQN=121DTE=2004-05-06 13:39:00ACI=05516ACE=AACS=C-
POI=Check: 02311, Terminal: 1POO=10POV=10.0
Response

PostingResponseREF=POS#1RQN=121DTE=2004-05-06 13:39:00ACI=3209642ACT=P-
NAM=PAX TESTCAB=05516EMB=2006-08-24 00:00:00DIS=2006-08-25 00:00:00BAL=290-
CRU=6401 I

3. Message Type: Posting2

Request

PostingREF=POS#2RQN=122DTE=2005-09-21 14:10:32ACI=05516ACE=AACS=CPTY=P-
POI=Check: 0984, Terminal: 1POO1=101POV1=15.0POC1=1.5POO2=111POV2=30.0-
POC2=3.0
Response

PostingResponseREF=POS#2RQN=122DTE=2005-09-21 14:10:32ACI=3209642ACT=P-
NAM=PAX TESTCAB=05516EMB=2006-08-24 00:00:00DIS=2006-08-25 00:00:00BAL=335-
CRU=6401 B

4. Message Type: Payment

Request

PaymentREF=PAY#1RQN=123DTE=2006-08-24 14:10:32ACI=05516ACE=AACS=C-
POI=Check: 0984, Terminal: 1POV=15.0
Response

PaymentResponseREF=PAY#1RQN=123DTE=2006-08-24 14:10:32ACI=3209642ACT=P-
NAM=PAX TESTCAB=05516EMB=2006-08-24 00:00:00DIS=2006-08-25 00:00:00BAL=320-
CRU=6401 E

Universal Interface – Quick User Guide Page 44 of 46

 Definitions, Acronyms, and Abbreviations

Term Description

Universal Interface – Quick User Guide Page 45 of 46

 References

Below find other documents and/or utilities referenced within, their respective purpose, and location:

• n/a

Universal Interface – Quick User Guide Page 46 of 46