Integrating Oracle Opera Cloud

Capabilities

DataGrail's Oracle Opera Cloud integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access, Deletion Identifier Categories Email, Phone Number

Before You Start

To successfully configure this integration, please ensure you have sufficient privileges:

• DataGrail User Role: Super Admin, Connections Manager
• Oracle Opera Cloud User Role: Admin

Create an Oracle Sales Cloud User

1. Log in to Oracle Hospitality Integration Platform (OPERA Cloud resources are available only via this platform)
2. Navigate Registered / Application.
3. Select Create Application.

Application Configuration

• Enter name/description: DataGrail
• Assign scopes/services: CRM (profiles)
• Generate credentials.
• Save the Client ID, Client Secret and Application Key in a secure, temporary location.

4. Navigate to API Catalog.
5. Open any endpoint and look at the Base URL shown for Try It: https://{tenant}.hospitality-api.{region}.ocs.oc[-test].com. Copy the following fields from the URL.

Fields to Copy

• Tenant: the hotel’s tenant code used to target the right tenant especially in OPERA Cloud environments that host multiple tenants.
• Region: the region in which the hotel’s OPERA Cloud environment is running.
• Environment: if domain ends with oc-test.com it's a Test environment, if oc.com - Production.

6. Navigate Properties under administration and open the target property. The JSON (via Network tab) or page URL shows both propertyId and enterpriseId.
7. Save the propertyId numeric value as a Hotel ID (the OPERA internal ID of a hotel in your tenant).
8. Save the enterpriseId numeric value as a Enterprise ID (the unique identifier for the enterprise).
9. Activate the Profile Anonymization feature to support the deletion capability.

Connect to DataGrail

1. In DataGrail, navigate to Integrations and select Configure New Integration to search for Oracle Opera Cloud.
2. Enter the Client ID, Client Secret, Application Key, Enterprise ID, Hotel ID and Tenant.
3. Select Region and Environment.
4. Select Configure Integration.

Next Steps

Now that you've successfully connected the integration, check out the following resources:

• Access Request Lifecycle
• Deletion Request Lifecycle
• Request Manager Overview
• Customizing Intake Forms

Troubleshooting

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details

The Oracle Opera Cloud integration uses the Oracle Hospitality API v1:

Access Type	Synchronous
Deletion Type	Synchronous

API Documentation

Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.