This guide walks you through the required Opera Cloud configuration to enable the Oaky – Opera Cloud OHIP 2‑way integration.
Overview of the Setup Process
The configuration consists of four parts:
Part 1 | Basic OHIP Information |
Part 2 | External System, External Database, Business Events & Publisher |
Part 3 | OPERA Setup for Room Upgrade Package |
Part 4 | OPERA Setup for Service Package |
Part 1: Basic OHIP Information
In this step, you’ll gather the essential Opera Cloud and OHIP details required to establish the integration.
There are two supported connection methods:
SSD
OCIM
Please follow only one method, based on your Opera Cloud setup.
Method 1: SSD Connection
The SSD method requires details from the chain administrator so Oaky can request an OHIP username and WSACCESS.
This is required only once per chain.
Chain Code
Click Select Location then change the location to Hub and copy the displayed Chain Code.
Hotel Code
Found at the top‑right corner of the Opera Cloud home page
SSD URL
This is the URL used to access the Opera Cloud Admin Panel.
Steps:
• Click the Main Menu icon (☰) on the top left corner
• Go to Identity Management
• A new window will open
• Copy the URL shown in the address bar
Trace Department ID
Oaky sends upsell‑related notifications to one default trace department.
• Only one department ID is supported
• Common examples: FO (Front Office), RES (Reservations), REC (Reception)
Please confirm which department should receive Oaky traces.
BAR Rate Code
Used by Oaky to calculate dynamic pricing for room upgrades.
Requirements:
• Must be a BASE rate
• Cannot be a calculated, discount or derived rate (including dynamic base rate)
• Examples: BAR, BARB, BARRO, BARDAILY
Method 2: OCIM Connection
With the OCIM method, the hotel or chain provides the details below. Oaky will request OHIP access via the OHIP Partner Developer Portal, and the chain admin will approve the request.
Please provide:
Home Region / Environment
Enterprise ID
Chain Code
Property Code
Part 2: External System, External Database, Business Events & Publisher
This section configures how Opera Cloud exchanges data with Oaky.
Create External System
Go to Administration → Interfaces → External System
Click New
Fill in the following:
• Code:OAKY1
• Description: OAKY OHIP 2-Way Integration
• Sequence: First available
• Property: Select the correct property
• Active: ✔ Checked
IfOAKY1already exists, useOAKY1_<hotelcode>instead.
Click Save
📺 Video tutorial:
Create External Database
Go to Toolbox → System Setup → External Databases → New
Fill in:
• Code: OAKY1
• Description: OAKY OHIP 2 Way Integration
• External System: Select OAKY1
• Property: Move the correct property from Available to Selected
Click Save
📺 Video tutorial:
Configure Business Events
Go to Administration → Interfaces → Business Events → Business Event Configuration
Select:
External System: OAKY1
Module: As listed below
Business Event: As listed below
Data Elements: ALL
Click Save
Repeat the steps for each Business Event listed below.
📺 Video tutorial:
Business Events Required for OAKY OHIP 2‑Way Integration
External System: OAKY
Module: AVAILABILITY
Business Event: SUMMARY TOTALS
Data Elements: *ALL*
Module: RESERVATION
Business Event: CANCEL
Data Elements: *ALL*
Business Event: CHECKIN
Data Elements: *ALL*
Business Event: CHECKOUT
Data Elements: *ALL*
Business Event: JOIN GUEST
Data Elements: *ALL*
Business Event: NEW RESERVATION
Data Elements: *ALL*
Business Event: NO SHOW
Data Elements: *ALL*
Business Event: SEPARATE GUEST FROM SHARE
Data Elements: *ALL*
Business Event: UPDATE RESERVATION
Data Elements: *ALL*
Module: RATE
Business Event: APPLY DAILY RATES
Data Elements: *ALL*
Business Event: DELETE DAILY RATES
Data Elements: *ALL*
Business Event: DELETE PRODUCT
Data Elements: *ALL*
Business Event: DELETE RATE HEADER
Data Elements: *ALL*
Business Event: DELETE RATE SET
Data Elements: *ALL*
Business Event: NEW PRODUCT
Data Elements: *ALL*
Business Event: NEW RATE HEADER
Data Elements: *ALL*
Business Event: NEW RATE SET
Data Elements: *ALL*
Business Event: RATE RESTRICTIONS
Data Elements: *ALL*
Business Event: UPDATE PRODUCT
Data Elements: *ALL*
Business Event: UPDATE RATE HEADER
Data Elements: *ALL*
Business Event: UPDATE RATE SET
Data Elements: *ALL*
Configure External System Publishers
Publishers subscribe to (receive) business event messages from another external system.
Steps:
Go to Administration → Interfaces → Business Events → External Systems
Select the external system
Open the Actions (⋮) menu and select Publisher
Click New
Fill in:
• Publisher: Select the originating external system
• Property: Select the property
Click Save
⚠️ Important: Subscriptions must be configured 2‑way for business events to sync correctly.
Example:
OAKY ➝ CRS
CRS ➝ OAKY
📺 Video tutorial:
Part 3: OPERA Setup for Room Upgrade Package
Follow the package creation and mapping steps outlined HERE.
Part 4: OPERA Setup for Service Package
Follow the package creation and mapping steps outlined HERE.
📺 Video tutorial for both room upgrade and service package creation in Opera Cloud:
If you have questions or run into issues during setup, please contact Oaky Support via chat.
