Oracle Opera Cloud (OHIP) PMS Integration Guide

Oracle Opera Cloud (OHIP) PMS Integration Guide

ORACLE OPERA CLOUD (OHIP) PMS INTEGRATION GUIDE



This guide explains how to connect a hotel's Oracle OPERA Cloud property to Takumo on the Production environment, following the OCIM (Oracle Customer Integration Management) onboarding flow.

Key Actors

HOTEL ADMIN: The hotel's Takumo Pro administrator. Starts the request in Takumo and approves the connection in the Oracle portal.

TECHNICAL SUPPORT: Takumo integrations team (integrations@takumo.jp). Registers the environment in the OHIP portal, generates the OAuth credentials, and finishes the setup in Takumo.

ℹ NOTE

Oracle onboarding happens in two stages. The hotel only enters three identifiers up front. The OAuth credentials and gateway/property details only exist AFTER the hotel approves the connection, so Technical Support add those afterwards


1. END-TO-END FLOW

mermaid-diagram-2026-06-11-150339.png

If Oracle rejects or revokes the request, the configuration simply stays Pending. To retry, delete it in Takumo and submit again from step 1.



2. PREREQUISITES

Hotel Side

  • An active OPERA Cloud Foundations license.

  • The following Oracle identifiers ready:

    • Enterprise ID

    • Chain Code

    • Region (the hotel's Oracle data-center region)

  • A Takumo Pro account with Administrator role.

Takumo Side

  • Access to the OHIP Developer Portal (Partner) with a certified Production app.

  • The shared Oracle application key configured in Takumo (a one-time setup; ask the dev/DevOps team if unsure).

3. STEP-BY-STEP INSTRUCTIONS

PHASE 1 — Hotel Admin Submits the Request (in Takumo Pro)

  1. Go to PMS Configuration => Add New PMS.

  2. Select Oracle as the provider.

  3. Fill in the three fields and click Submit:

    • Enterprise ID: The hotel's Oracle Enterprise ID.

    • Chain Code: Identifies the hotel chain within Oracle.

    • Region: The hotel's Oracle region. Choose from: Ashburn, Frankfurt, Sydney, Melbourne, Hyderabad, Singapore, Mumbai.

On submit:

  • The Oracle configuration is created with status Pending.

  • A notification email is sent to integrations@takumo.jp with the Hotel Name, submitter, Enterprise ID, Chain Code, and Region.

  • The new entry appears in the PMS list with status Pending.

PHASE 2 — Technical Support Registers the Environment (in the OHIP portal)

When the notification email arrives:

  1. In the OHIP Developer Portal, open the Environments tab.

  2. Click Add Environment.

  3. Enter the Enterprise ID, Chain Code, and Region from the email.

  4. Select Production and submit. The request shows as Pending in the portal.

PHASE 3 — Hotel Admin Approves (in the Oracle Customer Developer Portal)

This step happens entirely OUTSIDE Takumo. Oracle emails the hotel's account holder.

  1. The hotel's IT administrator logs into the Oracle Customer Developer Portal.

  2. Navigate to Environments => Partner Connections.

  3. Locate the pending request from Takumo.

  4. Select the specific properties (hotels) Takumo may access, and click Approve.

Expected turnaround for the Oracle email is within 24 hours of submission.

PHASE 4 — Technical Support Finishes the Setup

  1. Once approved, the environment status in the OHIP portal changes to Active.

  2. Open the environment and click Generate OAuth Credentials.

  3. Oracle outputs a Client ID and a Client Secret.

  4. Enter these details into the Oracle configuration in Takumo:

    • Gateway URL (the region-specific OHIP API base URL)

    • Client ID

    • Client Secret

    • Hotel ID (the property granted during approval)

Takumo verifies the connection with Oracle. If it succeeds, the status becomes Connected and the integration goes live. If it fails, the status stays Pending so it can be corrected and retried.

⚠ IMPORTANT

The Client Secret is shown only once. Store it securely

PHASE 5 — Verification

  • The Hotel Admin sees the configuration as Connected in the PMS list.

  • Guest search and other PMS-backed features now work for that hotel.

4. STATUS LIFECYCLE

  • Pending: Submitted by the hotel; awaiting Oracle approval and the credential setup. Not active yet.

  • Connected: Credentials configured and the connection verified - live.

⚠ IMPORTANT

[No Configuration] -- submit --> [Pending] -- finish setup (verified) --> [Connected]




    • Related Articles

    • Connecting Carriers and Your PMS

      Connecting Carriers and Your PMS ──────────────────────────────────────────────────────────────────────────────── Before you can create bookings, you need to connect at least one carrier and optionally connect your Property Management System (PMS). ...

    • How to Obtain Your B2 Cloud API Key

      How to Obtain Your B2 Cloud API Key ──────────────────────────────────────────────────────────────────────────────── To integrate Takumo with YBM (Yamato Business Members), you will need the B2 Cloud API key specific to your property. Please follow ...

    • Domestic Carriers — Service Guide and Size Reference

      Domestic Carriers — Service Guide and Size Reference ──────────────────────────────────────────────────────────────────────────────── This article covers the three domestic carriers available in Takumo Pro — Yamato Transport, Sagawa Express, and ...

    • Creating a New Booking — Complete Guide

      Creating a New Booking — Complete Guide ──────────────────────────────────────────────────────────────────────────────── This article walks through all six steps of the Takumo Pro booking flow. Staff create new bookings by clicking New Booking in the ...

    • Label Printing — Complete Guide

      Label Printing — Complete Guide ──────────────────────────────────────────────────────────────────────────────── This article covers everything about label management in Takumo Pro — what is on the label, how to print, reprint, and troubleshoot ...