การเชื่อมต่อ Opera PMS (OHIP)
เชื่อมต่อ AVA กับระบบจัดการที่พัก Opera Cloud ของ Oracle ผ่าน OHIP (Oracle Hospitality Integration Platform) เมื่อกำหนดค่าแล้ว AVA จะซิงก์การจอง สินค้าคงคลังของห้องพัก และข้อมูลผู้เข้าพักจาก Opera โดยตรง โปรไฟล์ผู้เข้าพักจะเปิดในเลย์เอาต์แชร์ร่วมของ AVA v2
ตั้งค่าแบบเร็ว
โรงแรมส่วนใหญ่ทำขั้นตอนนี้เสร็จใน 10 ถึง 15 นาที ถ้าคุณใช้ OCIM ให้ขอ enterpriseId จาก Oracle ล่วงหน้า
จะหาได้ที่ไหน
Settings → Essentials → Property Management System (PMS) Integrationก่อนที่คุณจะเริ่ม
รับข้อมูลรับรองเหล่านี้จากทีมไอทีหรือผู้ดูแลระบบ Oracle/Opera ของคุณ:
| ข้อมูลรับรอง | คำอธิบาย |
|---|---|
| OHIP Host Name | URL พื้นฐานของ API (เช่น ohip.oraclecloud.com) |
| OHIP Application Key | รหัสแอปพลิเคชันสำหรับการเข้าถึง API |
| OHIP Hotel ID | ตัวระบุที่พักของคุณใน Opera |
| OHIP Client ID | ตัวระบุไคลเอนต์ OAuth |
| OHIP Client Secret | ความลับไคลเอนต์ OAuth |
| enterpriseId | ตัวระบุองค์กรของ Oracle สำหรับ OCIM ใช้เมื่อ OHIP Identity Management เป็น OCIM |
คำเตือน
การเชื่อมต่อ Opera OHIP ต้องมีการตั้งค่าทางเทคนิคโดย Oracle หรือทีมไอทีของคุณ พวกเขาจะให้ข้อมูลรับรอง API หลังจากเปิดใช้งานการเข้าถึง OHIP สำหรับที่พักของคุณ
OCIM ต้องใช้ค่าเพิ่มอีกหนึ่งค่า
หากคุณเลือก OCIM AVA จะต้องใช้ enterpriseId ก่อนขอโทเค็น
เก็บค่านี้ไว้กับข้อมูลรับรอง OHIP อื่น ๆ ของคุณ
ขั้นตอนการกำหนดค่า
ขั้นตอนที่ 1: เลือก Opera เป็น PMS ของคุณ
- ไปที่ Settings → Essentials
- เลื่อนไปที่ PMS Integration
- คลิกการ์ด Opera
- เครื่องหมายถูก (✓) ปรากฏขึ้นเพื่อยืนยันการเลือก
ขั้นตอนที่ 2: ป้อนการกำหนดค่า OHIP
กรอกข้อมูลในแต่ละฟิลด์:
- OHIP Host Name: URL พื้นฐานของอินสแตนซ์ OHIP API ของคุณ (เช่น
ohip.oraclecloud.com) - OHIP Application Key: รหัสแอปพลิเคชันของคุณสำหรับการเข้าถึง API (คลิก Edit Secret เพื่ออัปเดต)
- OHIP Hotel ID: รหัสโรงแรม Opera ของที่พักของคุณ
- OHIP Identity Management: เลือก OCIM (Oracle Cloud Identity) หรือ SSD (Direct Credentials)
- OHIP Client ID: ตัวระบุไคลเอนต์ OAuth
- OHIP Client Secret: คีย์ความลับ OAuth (คลิก Edit Secret เพื่ออัปเดต)
- enterpriseId: ตัวระบุองค์กร OCIM ของ Oracle ใช้เฉพาะเมื่อ OHIP Identity Management เป็น OCIM
หากคุณเลือก SSD สำหรับการจัดการข้อมูลประจำตัว ให้ป้อนด้วย:
- OHIP Username: ชื่อผู้ใช้สำหรับเข้าสู่ระบบโดยตรง
- OHIP Password: รหัสผ่านสำหรับเข้าสู่ระบบโดยตรง
ขั้นตอนที่ 3: บันทึกและตรวจสอบ
- คลิก Save
- ตรวจสอบสถานะ:
- 🟢 "Opera Integration Configured" = ป้อนข้อมูลที่จำเป็นทั้งหมดแล้ว
- 🟡 "Opera Integration Not Configured" = ข้อมูลที่จำเป็นขาดหายไป
สิ่งที่ซิงก์จาก Opera
เมื่อเชื่อมต่อแล้ว AVA จะได้รับ:
- ✅ การจองและ folio ของผู้เข้าพัก
- ✅ ความพร้อมและสถานะของห้องพัก
- ✅ ข้อมูลโปรไฟล์ผู้เข้าพัก
- ✅ ธุรกรรมการเช็กอิน/เช็กเอาต์
- ✅ ข้อมูลการปิดกั้นห้อง
- ✅ สถานะ Do Not Move ของห้อง
ผลกระทบต่อผู้เข้าพักและพนักงาน
- แบบฟอร์มผู้เข้าพักปรับตามกฎของ Opera ฟิลด์ที่จำเป็นและฟิลด์ที่ซ่อนอยู่จะเปลี่ยนไปตามการกำหนดค่า Opera ดังนั้นผู้เข้าพักจะเห็นเฉพาะสิ่งที่จำเป็นเท่านั้น
- โปรไฟล์ผู้เข้าพักใช้เลย์เอาต์ AVA แบบใช้ร่วมกัน รายละเอียดผู้เข้าพักจาก Opera จะเปิดในโครงสร้างฟิลด์เดียวกับ AVA v2
- การค้นหาการจองใช้ Opera หากไม่ได้กำหนดค่า Opera ขั้นตอนการค้นหาผู้เข้าพักจะล้มเหลว
- การจองที่ยังใช้งานอยู่จะแสดงตามค่าเริ่มต้น การจองที่ยกเลิกจะไม่แสดงในผลการค้นหาปกติ เว้นแต่โฟลว์งานจะร้องขอโดยตรง
- การจองหลายห้องยังคงผูกห้องที่ค้นหาไว้กับการ์ดห้องด้านขวา AVA จะคงการจองที่คุณค้นหาไว้ แม้ Opera จะรวม family ให้เป็น confirmation หลักหรือใช้ internal ID ต่างกัน
- การเพิ่มผู้เข้าพักในห้องยังซิงก์ต่อ หากพนักงานเพิ่มผู้เข้าพักระหว่างเช็กอิน AVA จะอัปเดต Opera เพื่อให้ผู้เข้าพักเพิ่มยังคงผูกกับห้องนั้น
- การเช็กอินแบบมีพนักงานช่วยอาจแสดงรหัสราคา เมื่อ Opera ส่งรหัสราคา AVA จะแสดงรหัสดังกล่าวบนการ์ดการจองที่เลือกในระหว่างเช็กอินแบบมีพนักงานช่วย
- การลงรายการชำระเงินอาจเพิ่มหมายเหตุ หลังการชำระเงินหรือการฝากเงินใน Opera สำเร็จ AVA จะเพิ่มหมายเหตุการจองใน Opera
- ห้องที่ล็อกไว้จะยังล็อกอยู่ใน AVA หาก Opera ตั้งการจองเป็น Do Not Move Streamliner จะแสดงไอคอนล็อกในมุมมองเปลี่ยนห้อง
การแก้ไขปัญหา
สถานะ "Integration Not Configured"
ฟิลด์ที่จำเป็นขาดหายไป ตรวจสอบให้แน่ใจว่าคุณได้ป้อน:
- OHIP Host Name
- OHIP Application Key
- OHIP Hotel ID
- OHIP Client ID
enterpriseIdหากคุณเลือก OCIM
ข้อผิดพลาดในการเชื่อมต่อ API
- ตรวจสอบว่า OHIP Host Name ถูกต้อง
- ตรวจสอบว่าการสมัครสมาชิก OHIP ของคุณใช้งานได้
- ยืนยันว่า
enterpriseIdถูกบันทึกไว้เมื่อใช้ OCIM - ติดต่อไอทีเพื่อยืนยันการเข้าถึงไฟร์วอลล์/เครือข่าย
- ตรวจสอบข้อมูลรับรองกับฝ่ายสนับสนุนของ Oracle
OCIM ล้มเหลวทันทีที่บันทึก
สิ่งที่คุณเห็น: AVA ปฏิเสธการเชื่อมต่อทันทีเมื่อคุณเลือก OCIM
วิธีแก้:
- ขอ
enterpriseIdที่ถูกต้องจาก Oracle - กรอกข้อมูลรับรอง OCIM ใน AVA ใหม่
- บันทึกอีกครั้ง
- หากยังล้มเหลว ให้ยืนยัน client ID และ client secret กับ Oracle
ไม่พบการจอง
- รอ 15-30 นาทีสำหรับการซิงก์ครั้งแรก
- ตรวจสอบสิทธิ์ผู้ใช้ OHIP ใน Opera
- ตรวจสอบว่ามีการจองอยู่ใน Opera
- ติดต่อซัพพอร์ตพร้อมบันทึกข้อผิดพลาด
การ์ดห้องหลายห้องดูว่าง
สิ่งที่เห็น: เปิดการ์ดห้องแล้ว แต่ guest หลักหายไป
วิธีแก้:
- ยืนยันว่าคุณโหลดการจองด้วยหมายเลขยืนยัน
- รีเฟรชหน้าจอเช็กอินแล้วเปิดห้องนั้นอีกครั้ง
- หาก guest ยังไม่ขึ้น ให้ติดต่อซัพพอร์ตพร้อมหมายเลขยืนยันและวันที่เข้าพัก
ห้องไม่แสดงในเมนูเปลี่ยนห้อง
สิ่งที่เห็น: ห้องหายไปจาก Allow move room
วิธีแก้:
- ตรวจการจองใน Opera
- ลบล็อก Do Not Move หากห้องนั้นควรย้ายได้
- รีเฟรชการจองใน AVA
- ลองเปลี่ยนห้องอีกครั้ง
แนวทางปฏิบัติที่ดีที่สุดด้านความปลอดภัย
- 🔒 เก็บรักษาข้อมูลรับรองอย่างปลอดภัย (ข้อมูลเหล่านี้ถูกเข้ารหัสใน AVA)
- 🔒 ใช้ OCIM เมื่อทำได้เพื่อความปลอดภัยที่ดีขึ้น
- 🔒 เก็บ
enterpriseIdไว้กับข้อมูลรับรอง OCIM อื่น ๆ - 🔒 หมุนเวียนความลับของไคลเอนต์เป็นระยะ
- 🔒 จำกัดสิทธิ์ผู้ใช้ OHIP ให้น้อยที่สุดเท่าที่จำเป็น
การรับข้อมูลรับรอง OHIP
หากคุณไม่มีข้อมูลรับรอง:
- ติดต่อฝ่ายสนับสนุน Oracle Hospitality หรือผู้ดูแลระบบ Opera ของคุณ
- ขอสิทธิ์เข้าถึง OHIP API สำหรับการเชื่อมต่อ AVA
- พวกเขาจะให้:
- OHIP Host Name
- Application Key
- Client ID และ Secret
- Hotel ID
enterpriseIdสำหรับ OCIM
- บันทึกข้อมูลรับรองที่ได้รับอย่างปลอดภัย
ยังติดอยู่?
ติดต่อ success@vouch-technologies.com หาก:
- ❌ การเชื่อมต่อ OCIM ยังล้มเหลวหลังเพิ่ม
enterpriseId - ❌ การจองไม่ปรากฏหลังผ่านหน้าต่างซิงก์แรก
- ❌ Oracle ยืนยันว่าข้อมูลรับรองถูกต้อง แต่ AVA ยังปฏิเสธ
แนบ:
- ภาพหน้าจอของข้อผิดพลาด
- โหมด identity management ของ Opera
- เวลาที่ปัญหาเริ่มเกิดขึ้น
- ขั้นตอนที่คุณลองไปแล้ว