12.3.15.8

Integration with IGP

IG OnDemand has been enhanced to integrate with Intelligent Guest Profile (IGP), a product that allows properties to seamlessly manage guest profiles across multiple Agilysys applications available in a property. Once a guest profile is created in any application where the IGP feature is supported, the profile is automatically shared with all the other Agilysys applications integrated at the customer-level, eliminating the need for the guest to provide the same data for other bookings at the property.

This integration supports the following functionality:

Post dining revenue to IGP
Post refunds to IGP

Contact Agilysys to support this integration at your property.

Prerequisites

The following values must be obtained from Agilysys Platform:

Tenant ID
Context ID
Subscription Key
Client ID
API Username
Nonce

Important Points

The profile merging functionality is not supported.
The language must be configured for the enterprise from the Language drop-down list (Kiosk/OnDemand Configuration ➜ Administration ➜ Enterprise ➜ Language) and the time zone for the store from the Time Zone drop-down list (Kiosk/OnDemand Configuration ➜ Administration ➜ Store ➜ Basic Details).
The currency configured in InfoGenesis must match the currency in Agilysys Platform.
If a new site is created in IGCM after configuring IGP at the enterprise level, Agilysys Platform configurations in the site level (Kiosk/OnDemand Configuration ➜ Administration ➜ Site ➜ Site Platform) gets autofilled from the configuration available at the enterprise level. For existing sites, the values do not get autofilled.
Existing customers using site-level Platform configurations with the Default context can also use enterprise-level Platform configurations with the Default context. To use a custom context at the enterprise-level, properties must contact Agilysys.
If Platform configurations are available at both site and enterprise level, the enterprise level configurations take precedence.

Changes Made in IGCM

To support this, the following changes have been made:

A new checkbox, Enable Guest Profiling, has been added to the Settings submenu in the Enterprise menu.
- When enabled, guest profiles can be created and maintained within InfoGenesis. Also, the IGP Platform Configuration submenu in the Enterprise menu is enabled.
- When disabled, guest profiles cannot be created within InfoGenesis. Also, the IGP Platform Configuration submenu in the Enterprise menu is displayed as a read-only submenu.
A new submenu, IGP Platform Configuration has been added to the Enterprise menu.
The name of the terminal option 1489 has been modified, Terminal Option 1489 (Enable IGP Integration).

Supported Functionality

Post Dining Revenue to IGP

When an order is closed successfully using the PMS payment method in IG OnDemand, the dining revenue is posted to the appropriate guest profile in IGP. The profile is updated with the dining revenue and aggregated revenue details. IG OnDemand identifies the guest profile in IGP using the profile details received from PMS

If no guest profile is found or if multiple guest profiles are found, IG OnDemand does not post the revenue to IGP. Users can view the posted revenue under the Itinerary section in the guest profile in 12UX terminal only. Earlier, revenue posting to IGP was supported only for credit card payment methods.

This functionality is supported only for the following PMS integrations that integrate with IG OnDemand through IAS (Global IAS only):

Agilysys Versa

If an order is closed with multiple payments, the revenue is posted to the guest profile associated with the payment method used last to complete the order.

Post Refunds to IGP

Posting refunds to IGP is supported and refunds can be processed through 12UX terminal only.

When an order is refunded, the dining revenue previously posted to the guest profile in IGP is adjusted. This ensures that guest’s spending history and aggregated revenue totals remain accurate and up to date. Refunds, item returns, and other revenue adjustments are linked to the same guest profile associated with the parent check.

The refund or return can be processed using the following functions:

Refund Check (#48)
Refund Cls Check (#441)
Item Return (#239)
Reopen Check (#160)

Integration Setup

Configurations in IGCM

Configure Terminal Option

Navigate to Kiosk/OnDemand Configuration ➜ Terminals ➜ Terminal Option Group.

Select the appropriate record and select Edit.

Navigate to the Terminal Options submenu.

Enable the following terminal options:

Terminal Option 1489 (Enable IGP Integration)
Terminal Option 1505 (Send IAS configuration from the client for post processing IAS events)

Select Save.

Configure IGP

Navigate to Kiosk/OnDemand Configuration ➜ Administration ➜ Enterprise.

Select the appropriate record and select Edit.

Navigate to the Settings submenu.

Enable the Enable Guest Profiling checkbox.

Navigate to the IGP Platform Configuration submenu.

Refer to the following table and fill in the fields:

Field	Description
Enable IGP	Enable this checkbox to support IGP integration.
Display Guest Details on Every Inquiry	Not applicable to IG OnDemand. Enable this checkbox to display the IGP iFrame, where the guest profile details retrieved from IGP are displayed in 12UX Terminal. Note - This checkbox is enabled by default if the Enable IGP checkbox is enabled.
Platform URL	Enter https://api.rguest.com.
iFrame URL	Ener the platform URL where IGP is hosted. US - https://core.rguest.com APAC - https://core.rguest.sg EMEA - https://core.rguest.eu
Tenant ID	Enter the Platform tenant ID of the customer.
Context ID	Enter the Platform context ID of the customer.
Subscription Key	Enter the subscription key obtained from Agilysys Platform.
Client ID	The client ID obtained from Agilysys Platform.
API Username	The API username obtained from Agilysys Platform.
Nonce	The nonce obtained from Agilysys Platform.
Register	Select Register after entering all the above details to register the product. Note - Whenever the enterprise record is in the edit mode, this option becomes enabled.
IGP Registered	A read-only checkbox that is automatically enabled when the registration is successful. The checkbox remains disabled if the registration fails.

Select Save.

Configure IGP for Profit Center

This configuration allows profit centers to post the dining revenue to IGP.

Navigate to Kiosk/OnDemand Configuration ➜ Business ➜ Profit Center.

Select the appropriate record and select Edit.

Navigate to the IGP Platform Configuration menu.

Refer to the following table and fill in the fields:

Field	Description
Enable Revenue Posting to IGP	Enable this checkbox to allow revenue posting for a profit center.
Context ID	Enter the Platform context ID of the customer. This must be a valid ID to allow revenue posting, and it cannot have the value, Default. Note - This field is enabled only when the Enable Revenue Posting to IGP checkbox is enabled.

Field

Description

Enable Revenue Posting to IGP

Enable this checkbox to allow revenue posting for a profit center.

Context ID

Enter the Platform context ID of the customer. This must be a valid ID to allow revenue posting, and it cannot have the value, Default.

Note - This field is enabled only when the Enable Revenue Posting to IGP checkbox is enabled.

Select Save.