Oracle HGBU F&B Software Documentation

Simphony – PMS Enhanced Interface

OCTOBER 2017

V2.92
Document Use
The following is intended to outline our general product direction. It is intended for information purposes only, and
may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and
should not be relied upon in making purchasing decision. The development, release, and timing of any features or
functionality described for Oracle’s products remains at the sole discretion of Oracle.

DOCUMENT VERSION

Version Date Changes

1.00 April 2013 Initial release

1.01 April 2013 Minor changes
1.02 September 2013 Disable “Enable offline Posting” – page 8
1.03 October 2013 Added 64 Tax Support
1.04 October 2013 Removed SIM File Access
2.01 February 2014 iOS support and setup
2.10 April 2015 Updated Configuration section with new options
2.70 June 2015 Service Charges breakdown enhancements (3.4)
March 2016 Support for multi tenant environments, support for
2.80
extension application content.
2.90 January 2017 Added Android support, removed IOS support
October 2017 Added additional posting information around
2.92
POSTING_ADD_INFO

Simphony – PMS Enhanced Interface

Table of Contents

Document Use 1
1 Features and Requirements 1
1.1 Posting 1
1.2 Inquiries 1
1.3 Setup 2
1.4 Update 2
2 EMC Configuration 3
2.1 Extension Application 3
2.1.1 Create a record 3
2.1.2 Insert the content 4
2.1.3 Configure the content 4
2.1.4 Multi Tenant Environments 5
2.2 Content Information 6
2.2.1 Posting related configuration 7
2.2.2 Guest-Locator and Guest-Message related configuration 8
2.3 Interfaces 9
2.3.1 Extension application Interface option 11
2.4 Revenue Center Configuration 12
2.5 Data Extensions – Add the Tender Media Extra Column 12
2.6 Tender Medias 13
2.6.1 Room Charge Payment setup 14
2.6.2 Enable the Room Charge option 15
2.7 Page Design 15
2.8 Features and Revisions as of version 2.70 and higher 17

SIMPHONY – PMS ENHANCED INTERFACE

 1 Features and Requirements

Hardware/Software:

 Simphony version 2.8 or higher

 Opera Interface v8.7.3.7 or higher
 Supported POS Client Devices as of Simphony 2.8 Release Notes running
the Service Host application.
o Oracle MICROS PC Workstation 2015
o Oracle MICROS Tablet E-Series 8 (OS 1.5), 11 (OS 1.4) inch.
o Oracle MICROS Workstation 6
o Oracle MICROS Workstation 5A (POSReady 2009/7)
o Android 4.4 tablets
 Samsung Galaxy 7,8,11 inch
 Google Nexus
o Zebra MC40 – Android 4.4
o DT Reaserach DT365
o Microsoft Windows 7 and 8.1 devices

1.1 Posting
 Up to 16 Sales Itemizer
 Up to 64 Tax Itemizer
 16 Discount Itemizer if "Full Discount and Service Charge breakdown" is configured accordingly, otherwise 1
Discount Itemizer
 Up to 14 Service Charge Itemizer if "Full Discount and Service Charge breakdown" is configured accordingly,
otherwise 2 Service Charge Itemizer
 Check Details in the final tender event.

1.2 Inquiries
 Enhanced inquiry by name or room number returning the following information (varies and depends on the
setup on the PMS):
 Guest last name, first name and title
 Arrival and departure dates
 Room number and room type
 Display of guest reservation detail
 Display of guest history
 Display / printing of guest messages
 Entry of guest messages
 Display of guest locator
 Entry of guest locator

1 | SIMPHONY – PMS ENHANCED INTERFACE

 1.3 Setup
The setup application is distributed as a file named SIMPH2_ENH_IFCXXX.exe where XXX is the version number.

Start the setup application on the Simphony Application Server and follow the instructions shown. This will verify
the Simphony installation and copy the required files into the folder \MICROS\Custom\EnhancedInterface.

If you are unable to run the setup application on the Simphony Application Server because of access or user right
limitations but if you can access EMC from your local PC you will also be able to start the setup application with the
parameter /LOCAL, i.e. assuming version number 270:
SIMPH2_ENH_IFC270.exe /LOCAL
This will not verify the Simphony installation and it is your responsibility to ensure that the Simphony requirements
are met. This will copy the required files into the sub-folder Custom\EnhancedInterface below the folder you
selected in the setup application.

Files:
1. CONTENT_EnhIFC_Config.txt
2. McrsExtDialogsML.dll
3. MF_ENH.isl
4. MF_ENH_Android.isl
5. android.htm

1.4 Update
To update an available installation, it is required to execute the provided setup application on the Simphony server.
The application will update/create the custom folder under \MICROS.

 Follow step 2.1.3 to reimport the ISL and DLL files into the extension application
(Only the import file procedure).

 Double check the installation manual, if additional data extensions are required
(step 2), if yes create this/them.

 Do a full workstation reload of the workstations affected and restart them.

2 | SIMPHONY – PMS ENHANCED INTERFACE

 2 EMC Configuration

2.1 Extension Application

2.1.1 Create a record

Follow the steps below to configure and install the SIM Opera Interface within the Enterprise Management Console
(EMC).

1. Navigate to the EMC | Setup tab | under Custom Content | Extension Application
2. Select the 'Insert' icon and add a record (record number of your choice).
3. For the record name, any name will suffice. In this example, the record was named Opera.
4. Select the 'OK' button.

3 | SIMPHONY – PMS ENHANCED INTERFACE

 2.1.2 Insert the content

Open the new record in Form view (by double-clicking the record).
Select the 'Insert Application Content' button. It is required to insert 4 application content records:

2.1.3 Configure the content

Enter the text reflecting the file names within the 'ZoneableKey' and 'Description' fields and click the 'OK' button.

Select the 'Content Type: 19 - SimScript' and click on the 'Import from a file' link.

Select the SIM file MF_ENH.isl (*.isl), press the OPEN button.
Set the target to WIN32.

4 | SIMPHONY – PMS ENHANCED INTERFACE

 Insert a new application content for the second SIM file named MF_ENH_Android.isl, content type “19 - SIM
Script”. Zoneable Key, Description = “MF_ENH_ANDROID”.
Set the target to the Android platforms.

Insert a new application content for the DLL file named McrsExtDialogsML.dll, content type “3 - DLL”. Zoneable
Key, Description = “McrsExtDialogsML”.

Insert a new application content for the Android form file named android.htm, content type “23 - Text”. Zoneable
Key, Description = “html”.

For the SIM files MF_ENH.isl and MF_ENH_ANDROID.isl records, click on the ellipsis (...) symbol under the
'Options Bits' column and enable Option [2 - Main SIM Content] and click the 'OK' button.
For each file, type in their entire file name under the 'Disk File Name' column and Save all changes.

Set the related target for each file:

 MF_ENH.isl target equal WIN32

 MF_ENH_ANDROID.isl target equals Android
 McrsExtDialogsML.dll equal WIN32
 Android.htm target equals Android

NOTES:
The Disk File Name must match (Case sensitive) the name of the SIM scripts and DLL file names!

The Zoneable Key for the android.htm file must match “html”, case sensitive!

The version column is currently not required.

2.1.4 Multi Tenant Environments with Version smaller 2.9

For multi-tenant environments it is required to configure the content information (outlined in chapter 2.2) as
Extension Application content as in such environments the content feature cannot be used.

Create a new Application Content for the enhanced interface, selecting the “Insert Application Content” button.
The ZoneableKey must be set to “EnhIFC_Config” (case sensitive), the description must be set to
“EnhIFC_Config” (case sensitive).

Select the content type “23 –Text”, insert the content information as outlined in chapter 2.2 Content Information.
Apply the configuration settings as required.

5 | SIMPHONY – PMS ENHANCED INTERFACE

 2.2 Content Information
Navigate to the EMC | Setup | Content and insert a record for the 'PMS' configuration.
The name of the new entry must be “EnhIFC_Config” (Case sensitive), type “STRING”.
Please enter the strings as outlined below (the content text file is delivered with the other files), change the options
when needed.

#-----------------------------
# Posting related settings
#-----------------------------
#Magnetic Card required for Posting (0 or 1)
MAGCARDONLY=0
#if above enabled, excl. RVC Numbers (separated by comma)
MAGCARDOVRWRT=
#Suppress Guest-Messages during Postings
SUPPRESSGSTMSG=1
#Suppress References of non-Roomcharge Tenders
SUPPRESSNFOREF=0
# Do not display Guest Confirmation during Postings
NO_CONFIRM_GST=0
#Send negative Guest Count if payment is negative
REVERSEGST=1
#Full Discount and Service Charge breakdown
FULL_DSVC=1
#Use 64 Taxes for posting (0 or 1) or just 8 Taxes
POST_64TAXES=1
#Determines which information to be posted, 0 = Serving Period, 1 = Trans.Cashier,
# 2 = Order-Type, 3 = Custom for Philippines ONLY. Default = Serving Period
POSTING_ADD_INFO=0
# Send all CheckDetails on non-Roomcharge Tenders
SendAllDtls=0
#-----------------------------
# Locator related settings
#-----------------------------
#Use RVC Name as Locator Line #1
RVCNAMELOC=1
#Default Locator Validity in Minutes
LOCVALIDMIN=30
#--------------------------------
# Guest Message related settings
#--------------------------------
#Populate first line of Message using Date/Time, RVC# and Trans.Employee#
EMPLINFO_IN_MSG=1
#-----------------------------
# Restricted Posting for Kiosk Environment
#-----------------------------
RESTRICTED_POSTING=1
#Must match the ISL Employee Option in Employee Class
RESTR_POSTING_EMPL=8

6 | SIMPHONY – PMS ENHANCED INTERFACE

 2.2.1 Posting related configuration

Configuration String Configuration Value

MAGCARDONLY Set to 1 (one) if you want to limit the entries in the Room-Charge event to
magnetic cards, or set to 0 (zero) to allow both magnetic cards and keyboard
as input
MAGCARDOVRWRT When MAGCARDONLY is enabled, the setting can be overwritten for certain
RVC's by entering a list of RVC numbers (separated by comma)
SUPPRESSGSTMSG When set to 1 (one) this will suppress the message indicator during the
posting. For high-volume sites this should be enabled.
SUPPRESSNFOREF Non-Room-Charge Tenders will show the Department Code they were posted
to. When set to 1 (one) this will suppress this reference
REVERSEGST Set to 1 (one) if the guest count should be negative in case the payment is
negative (i.e. the payment is voided). Please note that this feature requires
specific setup on the Front-Office interface to work correctly

Configuration String Configuration Value

FULL_DSVC If set to 1 (one) the full breakdown of the discounts will be send. This requires
a specific version of the Front-Office interface. An additional full breakdown of
the service charges requires this set to 2, this will include the full breakdown of
discounts.
NO_CONFIRM_GST Set to 1 (one) if the guest name should not be confirmed when posting. Unless
magnetic cards are used to identify the guest, this option should be disabled
and set to 0 (zero).
POST_64TAXES If set to 1 (one) up to 63 Tax Itemizers are send to the Front-Office interface.
Please note that this requires IFC8 V.8.7.1.2 or higher as well as a certain
version of the Front-Office itself. If set to 0 (zero) only 8 Tax Itemizers are
send to the Front-Office interface.
POSTING_ADD_INFO This determines which information value to be used for any posting. Currently
the following values are supported:
0 = Serving Period Number (Default)
1 = Transaction Cashier
2 = Order-Type Number
3 = Custom value for Philippines ONLY.
SendAllDtls When set to 0 (zero) only the check details of Room-Charges are send to the
Front-Office interface. If set to 1 (one) also the check details of non-Room-
Charges are send.

7 | SIMPHONY – PMS ENHANCED INTERFACE

 RESTRICTED_POSTING
RESTR_POSTING_EMPL
2.2.2 Guest-Locator and Guest-Message related configuration
Configuration String
RVCNAMELOC
LOCVALIDMIN
The Content can be overwritten per Zone, Location or RVC. If overwritten, please ensure that you select the
Option "Use Existing Record":
8 | SIMPHONY – PMS ENHANCED INTERFACE
Select if you want to restrict the response returned from the Front-Office
Interface in the Room-Charge event. Please note that this only works in
combination with the option RESTR_POSTING_EMPL is configured correctly.
Currently there are two values supported:
Setting this to 1:
Both the Room# and at least 3 characters of the Surname (last-
name) need to be provided in order to post the room-charge. If less
than 3 characters are provided an error is shown. If the response
from the PMS contains more than one record an error is shown and
the operator needs to enter additional characters to provide a unique
identifier.
Setting this to 3:
This assumes that an external device will provide the input as
keyboard data. There is no touchscreen keyboard shown when this
option is used, the operator (or guest) has only the option to abort
the input.
If the response from the PMS contains more than one record an
error is shown and the posting is aborted. There will be no
confirmation of the guest-name shown, irrelevant of the setting in
NO_CONFIRM_GST.
Please note that this will not work if input is restricted to magnetic cards, so
either the restriction must be disabled or the RVC in question must be added
to the excluded RVC's.
Specify the ISL Option that should be used with the above option (see EMC |
Employee Maintenance | Employee Class | ISL Options). As such the valid
value for this configuration is between 1 and 8.
Configuration Value
If set to 1 (one) the first line of the locator will contain the RVC name, otherwise
it will be blank. The operator can overwrite this value when entering the locator
information
Each new locator is only valid for a certain time. Enter the default time in
minutes here. The waiter can overwrite this value when entering the locator
information
 2.3 Interfaces

Navigate to the EMC on the Enterprise level under the Setup tab | Hardware/Interfaces | Interfaces and insert a
record for the Opera 'PMS' interface.

* The screenshot above is an example, please utilize a name which outlines the property using the interface.
To avoid double postings the PING Frequency must be 0 (Zero), it is required to create an interface for each
property.
Click on the 'Options' tab and enable the desired options and enter the Opera PMS application server's
connection information under the 'TCP Communications' header and Save all changes.

9 | SIMPHONY – PMS ENHANCED INTERFACE

 Only options 1, 2, 3, 5 must be checked, enabling option 8 will cause double posting.

Click on the 'Properties' tab and enable the Opera PMS interface for each desired Property and Save all changes.

Click on the 'Service Host' tab and select the desired Service Host for the Opera PMS interface and click the 'OK'
button and Save all changes.

Note: The service host can be any workstation that has enough power to handle the incoming queries.

10 | SIMPHONY – PMS ENHANCED INTERFACE

 2.3.1 Extension application Interface option

Navigate to the EMC Enterprise level | Setup tab | Custom Content | Extension Application file and under the
'Interface' column, select the PMS interface to link it to the Opera Extension Application record and Save all
changes.

This configuration normally happens at property level (PMS Interface on property).

11 | SIMPHONY – PMS ENHANCED INTERFACE

 2.4 Revenue Center Configuration
Navigate to the EMC | Revenue Center | Setup tab | Parameters | RVC Parameters | Interfaces tab and select the
PMS interface to enable the interface for the RVC(s). Navigate to and perform this step for every desired RVC
(using the same PMS link for each RVC) and Save all changes throughout the process.

2.5 Data Extensions – Add the Tender Media Extra Column

Navigate to EMC | Configuration | Data Extensions

1. Select the 'Insert' icon and add a record.

2. Enter the following information:
1. Table: #71 Tender Media
2. Extra Column name: “RoomCharge”
3. Type: #4 Boolean
4. Data Constraints: N/A
5. Sort Priority: N/A
6. Display Width: 150
7. Translatable Name: “Enh.IFC – Room Charge” (translatable)
8. Translatable Help: “Enable this for Room-Charge Payments” (translatable)
9. Enable all of the three checkboxes.

12 | SIMPHONY – PMS ENHANCED INTERFACE

 2.6 Tender Medias

Navigate to the Property level | Configuration tab | Sales | Tender/Media | and create a Room Charge Tender
Media record. Configure the generic options as required.

13 | SIMPHONY – PMS ENHANCED INTERFACE

 2.6.1 Room Charge Payment setup

Click on the 'Options' tab | Interface Options tab and select the PMS interface from the 'Interface Link' dropdown
menu (The name of the interface link and the option “View Interafce Names for RVC” are only available when the
Tender Media configuration has been done at property level.

The following options must be enabled:

 [29 – ON=Post 0.00 Transactions to PMS; OFF=Do Not Post]

 [31 – ON=PMS and Credit Cards Use 19 Digit Acct Number;
OFF=16 Digits]
 [38 - Use ISL TMED Procedure Instead of PMS Interface]
Additionally, click on the 'Ops Behavior' tab and under the 'General Options' header and ensure that Option [5 -
Reference Entry Required] is not enabled.

Save all changes.

The Interface link must be set for all of the payments that need to be auto balanced (e.g. Cash, Credit
Cards, .etc)

14 | SIMPHONY – PMS ENHANCED INTERFACE

 2.6.2 Enable the Room Charge option
Click on the Data Extensions tab and check the Box “Enh.IFC – Room Charge”

The value must be checked for the room charge tender media(s) (see above), uncheck for all of the other tender
medias. But not greyed out, see sample screenshot below.

2.7 Page Design

Navigate to the EMC | Configuration | User Interface | Content header | Page Design file and ensure that the
previously reviewed 'Room Charge' tender media is configured correctly on the payment tab/page (see sample
below).

Add the inquire buttons on any required page/tab, normally the inquire buttons are created on the payment and/or
function page/tab.

15 | SIMPHONY – PMS ENHANCED INTERFACE

 Definition:
 Type: function
 Sim inquire
 Argument: <EXTENSION APPLICATION NAME>:<INQUIRY NUMBER>
Inquire Inquire Number
Room Inquire 1
Info Room Inquire 2
Short Inquire 5
Info Line Inquire 6
View Reservation Inquire 7
Extended Inquire 8
PMS Interface Information Inquire 911

Do a full reload of all of the workstations and

restart the service hosts!

16 | SIMPHONY – PMS ENHANCED INTERFACE

 2.8 Features and Revisions as of version 2.70 and higher

This includes sending a more detailed breakdown of Service-Charges with 14 Itemizers:

Itemizer
1 Service-Charge based on SVC Itemizer 1 See remark (1) below
2 Service-Charge based on SVC Itemizer 2 See remark (1) below
3 Service-Charge based on SVC Itemizer 3 See remark (1) below
4 Service-Charge based on SVC Itemizer 4 See remark (1) below
5 Service-Charge based on SVC Itemizer 5 See remark (1) below
6 Service-Charge based on SVC Itemizer 6 See remark (1) below
7 Service-Charge based on SVC Itemizer 7 See remark (1) below
8 Service-Charge based on SVC Itemizer 8 See remark (1) below
9 OPEN Amount Service-Charge with no SVC Itemizer enabled See remark (2) below
10 PRESET Amount Service-Charge with no SVC Itemizer enabled See remark (2) below
11 Stored Value Transaction Service Charge SVC Option Bit 14 ON
12 Non-Revenue Service Charge SVC Option Bit 7 ON
13 Charged Tip
14 Auto Service-Charge

remark (1): Amount of any PERCENTAGE based Service-Charges based on the SVC Itemizer (1-8) and the
Menu-Items present on the check. For AMOUNT based Service-Charge based on the FIRST active SVC Itemizer
found (if any).
remark (2): Only used with AMOUNT based Service-Charges with no SVC Itemizer enabled.

Please note that enabling a more detailed breakdown of Service-Charges will require related changes on the
PMS/IFC8 side. As such coordinate any change with the PMS team.

This version includes any previously published changes, i.e.

 Fixed issue with check-details being send to multiple interfaces
 Fixed issue with error-messages displayed when posting check-details and PMS interface being down.
There should be NO error-messages displayed in this case. Error-messages are only displayed during
any INQ’s and the actual tender process.
 Fixed logging issues during FINAL_TENDER.
 Fixed resolution issue on HHT (MC40) devices

17 | SIMPHONY – PMS ENHANCED INTERFACE


CONNECT W ITH US
blogs.oracle.com/oracle
facebook.com/oracle
twitter.com/oracle
oracle.com
18 | SIMPHONY – PMS ENHANCED INTERFACE
Oracle Corporation, World Headquarters Worldwide Inquiries
500 Oracle Parkway Phone: +1.650.506.7000
Redwood Shores, CA 94065, USA Fax: +1.650.506.7200
Copyright © 2015, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without our prior written permission.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0615