Integrasi Opera PMS (OHIP)

Hubungkan AVA ke sistem property management Opera Cloud milik Oracle melalui OHIP (Oracle Hospitality Integration Platform). Setelah dikonfigurasi, AVA menyinkronkan reservasi, inventaris kamar, dan informasi tamu langsung dari Opera. Profil tamu kini terbuka dalam tata letak profil bersama AVA.

Pengaturan Cepat

Sebagian besar hotel selesai dalam 10 sampai 15 menit. Jika Anda memakai OCIM, minta Oracle untuk enterpriseId terlebih dahulu.

Lokasinya

Settings → Essentials → Property Management System (PMS) Integration

Sebelum Memulai

Siapkan kredensial ini dari tim IT Anda atau administrator Oracle/Opera:

Credential	Deskripsi
OHIP Host Name	URL dasar API (misalnya, ohip.oraclecloud.com)
OHIP Application Key	Kunci aplikasi untuk akses API
OHIP Hotel ID	Identifier properti Anda di Opera
OHIP Client ID	Identifier client OAuth
OHIP Client Secret	Secret client OAuth
enterpriseId	Identifier enterprise OCIM milik Oracle. Wajib saat OHIP Identity Management adalah OCIM.

peringatan

Integrasi Opera OHIP memerlukan penyiapan teknis oleh Oracle atau tim IT Anda. Mereka akan memberikan kredensial API setelah mengaktifkan akses OHIP untuk properti Anda.

OCIM memerlukan satu nilai tambahan

Jika Anda memilih OCIM, AVA sekarang membutuhkan enterpriseId sebelum bisa meminta token. Simpan nilai itu bersama kredensial OHIP lainnya.

Langkah Konfigurasi

Langkah 1: Pilih Opera sebagai PMS Anda

1. Buka Settings → Essentials
2. Gulir ke PMS Integration
3. Klik kartu Opera
4. Tanda centang (✓) muncul untuk mengonfirmasi pilihan

Langkah 2: Masukkan Konfigurasi OHIP

Isi setiap field:

• OHIP Host Name: URL dasar instance API OHIP Anda (misalnya, ohip.oraclecloud.com)
• OHIP Application Key: Kunci aplikasi Anda untuk akses API (klik Edit Secret untuk memperbarui)
• OHIP Hotel ID: Kode hotel Opera milik properti Anda
• OHIP Identity Management: Pilih OCIM (Oracle Cloud Identity) atau SSD (Direct Credentials)
• OHIP Client ID: Identifier client OAuth
• OHIP Client Secret: Kunci secret OAuth (klik Edit Secret untuk memperbarui)
• enterpriseId: Identifier enterprise OCIM milik Oracle. Gunakan ini hanya saat OHIP Identity Management adalah OCIM.

Jika Anda memilih SSD untuk identity management, isi juga:

• OHIP Username: Username login langsung
• OHIP Password: Password login langsung

Langkah 3: Simpan dan Verifikasi

1. Klik Save
2. Periksa indikator status:
   • 🟢 "Opera Integration Configured" = Semua field yang diperlukan sudah diisi
   • 🟡 "Opera Integration Not Configured" = Ada field wajib yang belum diisi

Apa yang Disinkronkan dari Opera

Setelah terhubung, AVA menerima:

• ✅ Reservasi dan folio tamu
• ✅ Ketersediaan dan status kamar
• ✅ Informasi profil tamu dalam format AVA bersama
• ✅ Transaksi check-in/out
• ✅ Informasi pemblokiran kamar
• ✅ Status kunci kamar Do Not Move
• ✅ Pembaruan ETA reservasi melalui alur reservasi standar

Dampak untuk Tamu & Staf

• Form tamu menyesuaikan aturan Opera. Field wajib dan field tersembunyi berubah berdasarkan konfigurasi Opera, jadi tamu hanya melihat yang diperlukan.
• Profil tamu memakai tata letak AVA bersama. Detail tamu Opera kini terbuka dalam struktur field yang sama seperti AVA v2.
• Lookup reservasi memakai Opera. Jika Opera tidak dikonfigurasi, langkah lookup tamu akan gagal.
• Reservasi aktif muncul secara default. Reservasi yang dibatalkan tetap tidak masuk hasil lookup normal kecuali workflow secara eksplisit memintanya.
• Reservasi multi-room tetap mempertahankan kamar yang dicari di kartu kanan. AVA mempertahankan konfirmasi yang Anda cari, bahkan saat Opera menormalkan family ke konfirmasi utama atau memakai ID internal yang berbeda.
• Charged room type tetap stabil. Saat AVA menetapkan kamar di Opera, AVA menjaga charged room type tetap sama, meskipun kamar fisik punya tipe berbeda.
• Menambah tamu ke kamar tetap tersinkron. Jika staf menambah tamu lain saat check-in, AVA memperbarui Opera agar tamu tambahan tetap terhubung ke kamar itu.
• Assisted check-in dapat menampilkan rate code. Saat Opera mengirim rate code, AVA menampilkannya di kartu reservasi yang dipilih selama assisted check-in oleh staf.
• Label agen perjalanan tetap terlihat. Opera dapat meneruskan nama agensi ke sourceName. Itu memungkinkan pencocokan waiver melihat label seperti Booking.com (VCC).
• Posting pembayaran dapat menambahkan komentar. Setelah pembayaran atau deposit Opera berhasil, AVA menambahkan komentar reservasi di Opera. AVA memakai Default Comment Type / Location yang sudah Anda konfigurasikan di Settings → Payment.
• ETA reservasi tetap sinkron. AVA menulis perkiraan waktu kedatangan kembali ke Opera dan membacanya ke Streamliner. Anda dapat melihat ETA berbasis PMS di kartu dan baris reservasi.
• Aturan billing dapat membentuk tagihan tamu. Opera adalah PMS pertama yang menyembunyikan baris khusus tamu.
• Baris room dan tax yang di-waive tetap terlihat. AVA lalu menghitung ulang total yang harus dibayar.
• Kamar yang terkunci tetap terkunci di AVA. Jika Opera menandai reservasi Do Not Move, Streamliner menampilkan ikon lock di tampilan perubahan kamar.

Pemecahan Masalah

Status "Integration Not Configured"

Field wajib belum diisi. Pastikan Anda sudah memasukkan:

1. OHIP Host Name
2. OHIP Application Key
3. OHIP Hotel ID
4. OHIP Client ID
5. enterpriseId jika Anda memilih OCIM

Error Koneksi API

1. Verifikasi OHIP Host Name sudah benar
2. Periksa bahwa langganan OHIP Anda aktif
3. Konfirmasi enterpriseId tersimpan saat memakai OCIM
4. Hubungi IT untuk memastikan akses firewall/jaringan
5. Verifikasi kredensial dengan dukungan Oracle

OCIM gagal segera setelah Anda menyimpan

Yang Anda lihat: AVA langsung menolak koneksi saat Anda memilih OCIM.

Perbaikan:

1. Minta Oracle memberikan enterpriseId yang benar.
2. Masukkan ulang kredensial OCIM di AVA.
3. Simpan lagi.
4. Jika masih gagal, konfirmasi client ID dan client secret ke Oracle.

Tidak Ada Reservasi yang Muncul

1. Tunggu 15-30 menit untuk sinkronisasi awal
2. Verifikasi izin user OHIP di Opera
3. Periksa bahwa reservasi memang ada di Opera
4. Hubungi support dengan log error

ETA tidak diperbarui

Yang Anda lihat: Reservasi masih menampilkan waktu kedatangan lama di Streamliner.

Perbaikan:

1. Konfirmasi ETA sudah disimpan pada reservasi di Opera.
2. Refresh Operations View setelah sinkronisasi pembaruan selesai.
3. Jika masih belum muncul, periksa koneksi Opera lalu coba lagi beberapa menit kemudian.

Kartu kamar multi-room terlihat kosong

Yang Anda lihat: Kartu kamar terbuka, tetapi tamu utama hilang.

Perbaikan:

1. Pastikan Anda memuat reservasi berdasarkan confirmation number.
2. Refresh layar check-in dan buka kamar lagi.
3. Jika tamu masih hilang, hubungi support dengan confirmation number dan arrival date.

Sebuah kamar tidak muncul di room changes

Yang Anda lihat: Kamar hilang dari Allow move room.

Perbaikan:

1. Periksa reservasi di Opera.
2. Hapus lock Do Not Move jika kamar seharusnya bisa dipindah.
3. Muat ulang reservasi di AVA.
4. Coba room change lagi.

Praktik Terbaik Keamanan

• 🔒 Simpan kredensial dengan aman (semuanya dienkripsi di AVA)
• 🔒 Gunakan OCIM bila memungkinkan untuk keamanan yang lebih baik
• 🔒 Simpan enterpriseId bersama kredensial OCIM lainnya
• 🔒 Rotasi client secret secara berkala
• 🔒 Batasi izin user OHIP hanya pada yang minimum diperlukan

Mendapatkan Kredensial OHIP

Jika Anda belum memiliki kredensial:

1. Hubungi Oracle Hospitality Support atau administrator sistem Opera Anda
2. Minta akses OHIP API untuk integrasi AVA
3. Mereka akan memberikan:
   • OHIP Host Name
   • Application Key
   • Client ID dan Secret
   • Hotel ID
   • enterpriseId untuk OCIM
4. Dokumentasikan kredensial yang diterima dengan aman

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Koneksi OCIM masih gagal setelah Anda menambahkan enterpriseId
• ❌ Reservasi tidak muncul setelah jendela sinkron pertama
• ❌ Oracle mengatakan kredensial valid, tetapi AVA tetap menolaknya

Sertakan:

• Screenshot error
• Mode manajemen identitas Opera Anda
• Waktu masalah dimulai
• Langkah yang sudah Anda coba

Panduan Terkait

• Koneksi PMS
• Error Koneksi PMS
• Masalah Sinkronisasi