Outbound System Types and Respective Configurations
You can create an Outbound Code at the Global (Chain) level or Property level with the available Outbound Types as explained below.
- CRM Legacy for OXI Profile Lookup/Download
- CRM Generic for REST API Profile Lookup/Download
- CRM for IATA
- Experian QAS Address Validation
- GBG LOQATE Address Validation
- Gaming Custom
- Gaming Generic
- RMS Yield Market Lookup
- Room Key Encoding (Door Lock Systems)
- Dashboard Tile for External Content
- Profile Residency
- Generic Phone Number Validation
- Generic Email Address Validation
Parent topic: Configuring Outbound Systems
CRM Legacy for OXI Profile Lookup/Download
CRM_LEGACY is used when integrating
with OPERA Room Reservations Cloud Service for Profile Lookup and
Download and OPERA Customer Loyalty Tracking Cloud Service for membership
and award management; along with other legacy OXI integrations.
-
Outbound Code can be created at the Global (Chain) or Property level context based on the CRM system integration requirement.
Note:
It is recommended that you create outbound codes at the Global level if all the properties in the chain use the same external system. For more information, see Configuring Profile Lookup and Download for OPERA Room Reservations. -
Select Outbound Type
CRM_LEGACY. -
Enter a unique outbound code, for example:
CRMORSCHAIN1. -
Enter a description for the CRM Legacy System summary.
-
Protocol is defaulted with XML for CRM_LEGACY integration.
-
Select the Authorization Type for CRM Legacy integration:
-
Select NONE for Non-SSD OPERA V5 ORS.
-
Select BASIC for SSD OPERA V5 ORS.
-
-
Enter the Application Key. You must obtain the value from 05 ORS Setup > External Database > Local JNDI. Skip for non-O5-ORS applications.
-
Add a new row, select GetExternalProfiles, and enter the service path to fetch profiles. Configure https://{host}/...
-
Configure https://{host}/Operajserv/OperaWebSvcs/Lookup for O5 ORS application lookup.
-
Configure https://{host}/Operajserv/OXIServlets/ORSLookup for non-ORS application lookup using OXI XML specifications (plquery & plresult).
-
-
Click New to add a service.
-
Service Name: Select
DownloadExternalProfilefrom the list -
Service Path: Enter the URL for download profile. For example: https://host/Operajserv/OXIServlets/ORSLookup
-
-
Click New to add a service.
-
Service Name: Select
GetMembershipDetailsfrom the list -
Service Path: Enter the URL for get membership details of the profile. For example: https://host/Operajserv/OperaWebSvcs/MemberInfo
-
-
Click New to add a service.
-
Service Name: Select
PostMembershipNumberfrom the list -
Service Path: Enter the URL for get membership details of the profile. For example: https://host/Operajserv/OperaWebSvcs/NewMemberCard
-
-
Click New to add a service.
-
Service Name: Select
RedeemAwardfrom the list -
Service Path: Enter the URL for get membership details of the profile. For example: https://host/Operajserv/OXIServlets/ORSLookup
-
-
Save the Outbound Code configuration.
-
If an existing OXI external system (for example ORS) is used for Profile Lookup and Download, ensure the Lookup check box is selected for the External System.. See Configuring External Systems.
-
Associate the Outbound code with the External Database code of the OXI Interface. See Configuring External Databases.
-
Define Interface Mappings for Profile Types group for the OXI Interface. See Configuring Interface Mapping.
-
If you are trying to configure an OXI interface for the first time:
-
Refer Exchange Interface Setup.
-
Profile Lookup/Download from OPERA Cloud Central
Outbound Type CRM_LEGACY is used for Profile
Lookup and Download initiated from OPERA Cloud to OPERA Cloud Central
Services.
Create Outbound Code with CRM_LEGACY with Basic Auth type and configure the following Service Base path
URLs respectively.
-
Click New to add a service.
-
Service Name: Select
GetExternalProfilesfrom the list -
Service Path: Enter the URL for Profile Lookup. For example: https://{host}/OPERAIA/OPERA_ORS/OperaWebSvcs/LookupService
-
-
Click New to add a service.
-
Service Name: Select
DownloadExternalProfilefrom the list -
Service Path: Enter the URL for download profile. For example: https://{host}/OPERAIA/OPERA_ORS/OperaWebSvcs/LookupService
-
-
Click New to add a service.
-
Service Name: Select
GetMembershipDetailsfrom the list -
Service Path: Enter the URL for get membership details of the profile. For example: https://{host}/Operajserv/OperaWebSvcs/MemberInfo
-
-
Click New to add a service.
-
Service Name: Select
PostMembershipNumberfrom the list -
Service Path: Enter the URL for get membership details of the profile. For example: https://{host}/OPERAIA/OPERA_ORS/OperaWebSvcs/NewMemberCardService
-
-
Click New to add a service.
-
Service Name: Select
RedeemAwardfrom the list -
Service Path: Enter the URL for get membership details of the profile. For example: https://{host}/OPERAIA/OPERA_OXI/ORSLookup
-
Note:
Create or Request for an Interface User with Interface type IFC from OPERA Cloud Central, go to Role Manager, Manage Interface User and use it as Basic Authorization for the Outbound Code created.Parent topic: Outbound System Types and Respective Configurations
CRM Generic for REST API Profile Lookup/Download
Note:
For more information, see Configuring Profile Lookup and Download from External Systems.-
Context:
-
Global: Select to create outbound system for all properties.
-
Property: Select to create outbound system for a specific property.
-
Property: Select a property from the list.
-
-
-
Outbound Type: Select CRM from list.
-
Outbound Code: Enter a unique outbound code, for example: CRMCHAIN1.
-
Description: Enter a description for the outbound system.
-
Select Enable External System checkbox.
-
An Configuring External Systems matching the outbound code is automatically created, with Lookup checkbox selected.
-
An External Database matching the outbound code is automatically created, and the same code is available for Profile Lookup.
-
-
Select Enable Conversions checkbox to enable data value mapping.
-
Enter External Property Code.
-
Protocol defaults to REST (read only).
-
Authorization Type: Select Basic or Oauth and enter respective authorization details provided for the external system.
-
Service Details:
-
Service Path: Enter the REST API Base URL provided by the external system: for example, https://api.mycrmsystem.com/apis/
-
-
Save the Outbound Code configuration.
Table 26-2 List of APIs supported for CRM Generic Integration:
| API Module | API Name | OperationID | Method | API Service URL |
|---|---|---|---|---|
|
Customer Relationship Management Outbound |
Retrieve profiles from external system |
getExternalProfile |
Get |
|
|
Customer Relationship Management Outbound |
Download a Profile from external system |
downloadExternalProfile |
Get |
|
|
Customer Relationship Management Outbound |
Create an Enrollment |
postEnrollment |
Post |
|
|
Customer Relationship Management Outbound |
Redeem an award that exists on a profile. |
redeemAward |
Put |
|
|
Customer Relationship Management Outbound |
Retrieve membership details on a profile. |
getMembershipDetails |
Get |
|
|
Customer Relationship Management Outbound |
Generate a new membership number. |
postMembershipNumber |
Post |
|
Note:
Refer the API specification versions with respect to the OPERA Cloud version.Parent topic: Outbound System Types and Respective Configurations
CRM for IATA
-
The outbound code should be created at the Property level.
-
Select Outbound Type CRM_IATA.
-
Enter a unique Outbound Code, for example: IATAP1.
-
Enter a Description such as IATA Validation System.
-
Protocol is defaulted with REST for CRM_IATA integration.
-
Select Authorization Type TOKEN.
-
Enter the Token value provided by IATA.
-
Enter the Application Key provided by IATA.
-
Enter the REST API Base URL Service Path provided by the IATA organization:
-
Save the Outbound Code configuration.
Parent topic: Outbound System Types and Respective Configurations
Experian QAS Address Validation
-
Outbound Code can be created at the Global (Chain) or Property level context based on the Address Validation integration requirement.
-
Select the Outbound Type ADDRESS_QAS.
-
Enter a unique outbound code, for example: ADDQASCHAIN1.
-
Enter a description of the Address Validation System summary.
-
Protocol is defaulted with REST for ADDRESS_QAS integration.
-
Select the Authorization Type TOKEN.
-
Enter the Token details provided by Experian.
-
Enter the RESP API Base URL Service Path provided by Experian.
-
For example, https://api.experianaperture.io/docs/index.html.
-
-
Save the Outbound Code configuration.
-
Add Custom Headers. For more information, see Custom Headers.
-
Header name: Add-Components.
-
Header value: True.
-
-
Add Data Value Mappings. For more information, see Data Value Mappings.
-
Define the conversion codes forState Code (be sure to include the Country Code field in State Code mapping), Country Code (Experian uses ISO3 codes).
-
Parent topic: Outbound System Types and Respective Configurations
GBG LOQATE Address Validation
-
The Outbound Code can be created at the global (Chain) or property level context based on the Address Validation integration requirement.
-
Select Outbound Type ADDRESS_GBG.
-
Enter a unique outbound code, for example: GBGCHAIN1.
-
Enter a description for the Address Validation System summary.
-
Protocol is defaulted with REST for ADDRESS_GBG integration.
-
Select Authorization Type TOKEN.
-
Enter the Token details provided by GBG.
-
Enter the RESP API Base URL Service Path provided by GBG.
-
For example, https://api.addressy.com/Capture/Interactive/.
-
-
Save the Outbound Code configuration.
Parent topic: Outbound System Types and Respective Configurations
Gaming Custom
Outbound Type GAMING_CUSTOM is used to integrate OPERA Cloud functionality,
such as Profile Lookup, Download, Create Enrollment, Player Offers, Player Statistics, Comp
Postings and Comp Redemption with the Casino Gaming Player Tracking System (PTS) which follows
the Vendor specific API specifications and standards.
Note:
Refer Enterprise Integrations for Gaming custom integrations supported by various Gaming Vendor Systems.-
Outbound Code should be created for the Property which requires Gaming integration.
-
Select Outbound Type GAMING_CUSTOM.
-
Enter a unique outbound code in the format of gaming system code and property code.
-
Enter and description for the gaming system name.
-
Enable External System, Enable Conversions, and External Property Code.
-
Protocol is defaulted with REST for custom gaming integration.
-
Select Authorization Type OAUTH and provide OAuth Token URL, for example: https://gaminghost.com/v1/oauth.
-
Select Grant Type Client Credentials, and enter Client Id & Client Key and Application Key provided by the Gaming/Player Tracking System.
-
Enter the RESP API Base URL Service Path provided by gaming vendor, for example: https://gaminghost.com/v1.
-
Save the Outbound Systemconfiguration.
-
Add Data Value Mappings. For more information, see Data Value Mappings.
-
Define the Conversion Codes for Address Type, Gender, Phone Type, State Code, Country Code, Language Code, Profile Type, Title, Membership Level, and Membership Type.
-
Gaming Generic
GAMING_GENERIC is used to integrate OPERA Cloud
functionality, such as Profile Lookup, Download, Create Enrollment, Player Offers, Player
Statistics, Comp Postings and Comp Redemption with the Casino Gaming Player Tracking System (PTS)
that follows OPERA Cloud REST APIs specification and standards. See Outbound API Specifications on GitHub.
-
Outbound Code should be created for the property which requires gaming integration.
-
Select the Outbound Type GAMING_GENERIC.
-
Enter a unique Outbound Code, for example:
GAMGENPPROP3. -
Enter a Description for the gaming system.
-
Enable External System, Enable Conversions, and External Property Code.
-
Protocol is defaulted with REST for gaming integration.
-
Select Authorization Type OAUTH and provide the OAuth Token URL, for example: https://gaminghost.com/v1/oauth.
-
Select Grant Type Client Credentials, and enter Client Id & Client Key and Application Key provided by the Gaming/Player Tracking System.
-
Enter the RESP API Base URL Service Path provided by gaming system, for example: https://gaminghost.com/v1.
-
Save the Outbound configuration.
-
Add Data Value Mappings. For more information, see Data Value Mappings.
-
Define the Conversion Codes for Address Type, Gender, Phone Type, State Code, Country Code, Language Code, Profile Type, Title, Membership Level, and Membership Type.
- Custom Headers are optional and can be defined when outbound system expects any standard headers and values in the request.
-
Table 26-3 List of APIs supported for Gaming Generic Integration
| Module | Function | How it works | OperationID | Method | API Service URL |
|---|---|---|---|---|---|
| Customer Relationship Management Outbound | Request for Player Profiles Lookup |
|
getExternalProfile | Get | /crm/v1/externalSystems/{extSystemCode}/chains/{chainCode}/externalProfiles |
| Customer Relationship Management Outbound | Request for the selected Player Profile Download |
|
downloadExternalProfile | Get |
|
| Customer Relationship Management Outbound | Request for Create Player Profile Enrollment |
|
postEnrollment | Post |
|
| Customer Relationship Management Outbound | Request for Player Statistics |
|
getPlayerStatistics | Get |
|
| Customer Relationship Management Outbound | Request for Player Offers |
|
getGamingOffers | Get |
|
| Cashiering Outbound | Request for Complimentary Postings Approval |
|
|
|
|
| Cashiering Outbound | Request for Complimentary Posting Journal (single / multiple) which Staged or Declined for Approval |
|
|
|
|
| Cashiering Outbound | Request for Complimentary Redemptions value for a Player having PTS Membership Type |
|
getCompRedemptions | Get |
|
| Cashiering Outbound | Request for Complimentary Redemptions for a player having PTS Membership Type |
|
postCompRedemption | Post |
|
| Cashiering Outbound | Request for Reverse Complimentary Redemptions for a Player having PTS Membership Type |
|
compRedemptionReversals | Post |
|
Note:
Refer the API specification versions with respect to the OPERA Cloud version.RMS Yield Market Lookup
- Configure Yield Market Code for the Property.
- Configure Room Type as Yieldable.
- Configure Rate Code as Yieldable and select Yield Market Code.
- Activate the Yield Management from OPERA Controls - Rates for Yield Market lookup functionality.
Outbound Type RMSYIELD is used to integrate OPERA Cloud yield market lookup functionality to fetch Yield Market Code and Customer value from a Revenue / Yield Management System that conforms to the OPERA Cloud REST APIs specifications.
-
Outbound Code should be created for the Property which requires Yield Market lookup integration.
-
Select Outbound Type RMSYIELD.
-
Enter a unique outbound code in the format of gaming system code and property code. For example:
YMLPROP1. -
Enter a description for the Yield management system name.
-
Protocol is defaulted with REST for Yield Market Lookup integration.
-
Select Authorization Type OAUTH and provide OAuth Token URL. For example:
https://rmsyield.com/v1/oauth. -
Select Grant Type Password and enter Client Id & Client Key provided by Yield Market Lookup vendor.
-
Enter the RESP API Base URL Service Path provided by Yield Market Lookup vendor, for example:
https://rmsyield.com/v1. -
Save the Outbound Code configuration.
| Module | Function | How it works | OperationID | Method | API Service URL |
|---|---|---|---|---|---|
| Price Availability Rates | Request for Yield Market Codes from External System and then Search the OPERA Rate Codes for the Yield Market Code |
|
getExternalYieldMarketType | Get | /par/v1/hotels/{hotelId}/yieldMarketType?membershipId={membershipId} |
Related Topics
Parent topic: Outbound System Types and Respective Configurations
Room Key Encoding (Door Lock Systems)
Outbound Type GUESTKEY_GENERIC is used to integrate OPERA Cloud room key Door Lock functionality with any external system that follows OPERA Cloud REST APIs specification and standards. Refer Front Desk Operations Outbound API specifications on the OHIP Developer Portal.
To configure Door Lock System integration using Outbound communication three configuration steps are necessary:
- Outbound Configuration Using GUESTKEY_GENERIC Type
- Outbound Code can be created at Property level context.
- Select Outbound Type GUESTKEY_GENERIC.
- Enter a unique Outbound Code, for example:
GUESTKEYVENDOR1. - Enter a Description for the Door Lock system summary.
- Protocol is defaulted with Rest for Door Lock System integration.
- Select one of the available Authorization Type with respective authorization details based on the Door Lock System system details provided.
- Enter the REST API Base URL Service Path provided by the Door Lock system. For example, https://api.mydlssystem.com/apis/
- Save the Outbound Code configuration.
- Outbound Domain Allowlist Configuration
For more information, see Configuring Outbound Domain Allow Listings
- Property Interface Configuration for DLS TypeFor more information, see Configuring Property Interface
- You must do the specific configurations for DLS Systems in the related sections:
Table 26-4 List of APIs supported for CRM Generic Integration:
| API Module | API Name | OperationID | Method | API Service URL |
|---|---|---|---|---|
|
Front Desk Operations Outbound |
Request to create/activate Room Key |
postRoomKeysOutbound |
Post |
|
Note:
Refer the API specification versions with respect to the OPERA Cloud version.Related Topics
Parent topic: Outbound System Types and Respective Configurations
Dashboard Tile for External Content
-
Context:
-
Global: Select to create outbound system for all properties.
-
Property: Select to create outbound system for a specific property.
-
Property: Select a property from the list.
-
-
-
Outbound Type: Select DASHBOARDTILE from list.
-
Outbound Code: Enter a unique outbound code, for example:
CH1_EXT_KPIS. -
Description: Enter a description for the outbound system.
-
Protocol: Defaults to REST (read only).
-
Authorization Type: Select Basic, OAUTH, TOKEN and enter respective authorization details provided for the external system.
-
Grant Type: Select Password, and enter Client Id & Client Key provided by the external content system.
-
Service Details:
-
Service Path: Enter the REST API Base URL provided by the external system: for example, https://api.mycrmsystem.com/apis/
-
-
Save the Outbound Code configuration.
Related Topics
Parent topic: Outbound System Types and Respective Configurations
Profile Residency
Configure the PROFILE_RESIDENCY Outbound Type to route both the Create Profile and Edit Profile API requests based on the nationality selected in the Data Residency Profile Nationality OPERA Control to the Profile Residency solution integrated using Service Locator Profiles with the specified nationality are first created in the Profile Residency Store, and then in OPERA Cloud.
-
Context:
-
Global: Select to create outbound system for all properties.
-
Property: Select to create outbound system for a specific property.
-
Property: Select a property from the list.
-
-
-
Outbound Type: Select Profile Residency from list.
-
Outbound Code: Enter a unique outbound code, for example:
SLTNG -
Outbound Description: Enter a description for the outbound system, for example: Profile Data Residency.
-
Protocol defaults to REST (read only).
-
Select Enable External System check box.
-
An Configuring External Systems matching the outbound code is automatically created, with Lookup check box selected.
-
An Configuring External Databases matching the outbound code is automatically created, and the same code is available for Profile Lookup.
-
-
Select Enable Conversions check box to enable Data Value Mappings.
-
Authorization Type: Select OAuth and provide the OAuth Token URL.
Note:
Token URL should suffix with Property value as a parameter. - Enter respective authorization details provided by the Profile Residency system.
-
Service Account: Enter the Service Account.
-
Service Account Key: Enter the Service Account Key.
-
Grant Type: Select the Password.
-
Client Id: Enter your client identifier.
-
Client Key: Enter your client key.
-
Scope: Enter your scope.
-
-
Service Details
-
Service Path: Enter the REST API Base URL provided by the external system: for example, https://url.com/integration-ohip/
-
-
Save the Outbound Code configuration.
Related Topics
Parent topic: Outbound System Types and Respective Configurations
Generic Phone Number Validation
- Context
- Global: Select to create outbound system for all properties.
- Property: Select to create outbound system for a specific
property.
- Property: Select a property from the list.
- Outbound Type: Select PHONE_GENERIC from list.
- Outbound Code: Enter a unique outbound code, for example: PHONEVALIDATE
- Outbound Description: : Enter a description for the outbound system, for example: Profile Phone Number Validation.
- Protocol defaults to REST (read only).
- Select Enable External System check box.
- An Configuring External Systems matching the outbound code is automatically created, with Lookup check box selected.
- An Configuring External Databases matching the outbound code is automatically created, and the same code is available for Profile Lookup.
- Select Enable Conversions check box to enable Data Value Mappings.
- Authorization Type: Select Basic, OAUTH, TOKEN and enter respective authorization details provided by the external phone number validation system.
- Service Details
- Service Path: Enter the RESP API Base URL Service Path provided by the external phone number validating system.
- Save the Outbound Code configuration.
Table 26-5 List of APIs supported for Generic Phone Number Validation
| API Module | API Summary | OperationID | Method | API Service URL |
|---|---|---|---|---|
| Customer Relationship Management Outbound | Validate phone number from a third party vendor. | validatePhone | Post | /crm/v1/validatePhone |
Parent topic: Outbound System Types and Respective Configurations
Generic Email Address Validation
- Context
- Global: Select to create outbound system for all properties.
- Property: Select to create outbound system for a specific
property.
- Property: Select a property from the list.
- Outbound Type: Select EMAIL_GENERIC from list.
- Outbound Code: Enter a unique outbound code, for example: EMAILVALIDATE.
- Outbound Description: Enter a description for the outbound system, for example: Profile Email Address Validation.
- Protocol defaults to REST (read only).
- Select Enable External System check box.
- An Configuring External Systems matching the outbound code is automatically created, with Lookup check box selected.
- An Configuring External Databases matching the outbound code is automatically created, and the same code is available for Profile Lookup.
- Select Enable Conversions check box to enable Data Value Mappings.
- Authorization Type: Select Basic, OAUTH, TOKEN and enter respective authorization details provided by the external email address validation system.
- Service Details
- Service Path: Enter the RESP API Base URL Service Path provided by the external email address validating system.
- Save the Outbound Code configuration.
Table 26-6 List of APIs supported for Generic Email Address Validation
| API Module | API Summary | OperationID | Method | API Service URL |
|---|---|---|---|---|
| Customer Relationship Management Outbound | Validate email Id from a third party vendor. | validateEmail | Post | /crm/v1/validateEmail |
Parent topic: Outbound System Types and Respective Configurations