Opera PMS 통합 (OHIP)
OHIP(Oracle Hospitality Integration Platform)를 통해 AVA를 Oracle의 Opera Cloud property management system에 연결합니다. 설정이 끝나면 AVA는 Opera에서 예약, 객실 재고, 투숙객 정보를 직접 동기화합니다. 투숙객 프로필은 이제 AVA의 공유 프로필 레이아웃에서 열립니다.
빠른 설정
대부분의 호텔은 10~15분이면 완료합니다. OCIM을 사용하는 경우 Oracle에 먼저 enterpriseId를 요청하세요.
위치
Settings → Essentials → Property Management System (PMS) Integration시작하기 전에
IT 팀이나 Oracle/Opera 관리자에게 다음 자격 증명을 받으세요:
| Credential | Description |
|---|---|
| OHIP Host Name | API 기본 URL(예: 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 또는 IT 팀의 기술 설정이 필요합니다. 해당 팀에서 숙소에 대한 OHIP 접근을 활성화한 뒤 API 자격 증명을 제공합니다.
OCIM은 추가 값이 하나 필요합니다
OCIM을 선택하면 AVA는 토큰을 요청하기 전에 enterpriseId가 필요합니다.
이 값은 다른 OHIP 자격 증명과 함께 보관하세요.
설정 단계
1단계: PMS로 Opera 선택
- Settings → Essentials로 이동합니다
- PMS Integration까지 스크롤합니다
- Opera 카드를 클릭합니다
- 선택을 확인하는 체크 표시(✓)가 나타납니다
2단계: OHIP 설정 입력
각 필드를 입력합니다:
- OHIP Host Name: OHIP API 인스턴스의 기본 URL(예:
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: Oracle의 OCIM 엔터프라이즈 식별자. OHIP Identity Management가 OCIM일 때만 사용합니다.
인증 방식으로 SSD를 선택한 경우 다음도 입력합니다:
- OHIP Username: 직접 로그인 사용자 이름
- OHIP Password: 직접 로그인 비밀번호
3단계: 저장하고 확인
- Save를 클릭합니다
- 상태 표시기를 확인합니다:
- 🟢 "Opera Integration Configured" = 필요한 필드가 모두 입력됨
- 🟡 "Opera Integration Not Configured" = 필요한 필드가 누락됨
Opera에서 동기화되는 항목
연결이 완료되면 AVA는 다음을 수신합니다:
- ✅ 투숙객 예약 및 folio
- ✅ 객실 가용성 및 상태
- ✅ 공유 AVA 형식의 투숙객 프로필 정보
- ✅ 체크인/체크아웃 거래
- ✅ 객실 차단 정보
- ✅ Do Not Move 객실 잠금 상태
투숙객 및 직원 영향
- 투숙객 양식은 Opera 규칙에 맞춰 조정됩니다. 필수 및 숨김 필드는 Opera 설정에 따라 바뀌므로, 투숙객은 필요한 항목만 보게 됩니다.
- 투숙객 프로필은 공유 AVA 레이아웃을 사용합니다. 이제 Opera 투숙객 세부 정보는 AVA v2와 같은 필드 구조로 열립니다.
- 예약 조회는 Opera를 사용합니다. Opera가 설정되지 않으면 투숙객 조회 단계가 실패합니다.
- 활성 예약이 기본으로 표시됩니다. 취소된 예약은 워크플로가 명시적으로 요청하지 않는 한 일반 조회 결과에 나타나지 않습니다.
- 여러 객실 예약은 검색한 객실을 오른쪽 카드에 유지합니다. Opera가 가족 예약을 메인 확인 번호로 정규화하거나 다른 내부 ID를 사용하더라도, AVA는 조회한 확인 번호를 보존합니다.
- 청구된 객실 유형은 유지됩니다. AVA가 Opera에서 객실을 배정할 때, 실제 객실 유형이 다르더라도 청구된 객실 유형은 그대로 유지합니다.
- 객실에 투숙객 추가는 계속 동기화됩니다. 직원이 체크인 중 다른 투숙객을 추가하면 AVA가 Opera를 업데이트하여 추가 투숙객이 그 객실에 계속 연결되도록 합니다.
- 도움이 필요한 체크인에서는 요금 코드를 표시할 수 있습니다. Opera가 요금 코드를 보내면 AVA는 직원 지원 체크인 중 선택한 예약 카드에 이를 표시합니다.
- 여행사 레이블은 계속 보입니다. Opera는 에이전시 이름을
sourceName으로 전달할 수 있습니다. 이를 통해 면제 매칭에서Booking.com (VCC)같은 레이블을 볼 수 있습니다. - 결제 게시물에 코멘트를 추가할 수 있습니다. Opera 결제 또는 보증금이 성공하면 AVA가 Opera 예약 코멘트를 추가합니다. 이때 Settings → Payment에서 설정한 Default Comment Type / Location을 사용합니다.
- 예약 메모는 Opera 편집 중에도 안전하게 유지됩니다. AVA는 Opera의 메모 업데이트 흐름을 사용하며, 다른 사용자가 예약을 수정 중이면 한 번 재시도합니다.
- 청구 규칙이 투숙객 청구서를 구성할 수 있습니다. Opera는 객실 전용 행을 숨기는 첫 번째 PMS입니다.
- 면제된 room and tax 행은 계속 표시됩니다. 이후 AVA가 지불 가능 총액을 다시 계산합니다.
- 잠긴 객실은 AVA에서도 잠금 상태를 유지합니다. Opera가 예약을 Do Not Move로 표시하면, Streamliner는 객실 변경 화면에서 잠금 아이콘을 보여줍니다.
문제 해결
"Integration Not Configured" 상태
필수 필드가 누락되었습니다. 다음 항목을 입력했는지 확인하세요:
- OHIP Host Name
- OHIP Application Key
- OHIP Hotel ID
- OHIP Client ID
- OCIM을 선택한 경우
enterpriseId
API 연결 오류
- OHIP Host Name이 올바른지 확인합니다
- OHIP 구독이 활성 상태인지 확인합니다
- OCIM을 사용하는 경우
enterpriseId가 저장되었는지 확인합니다 - 방화벽/네트워크 접근이 가능한지 IT 팀에 확인합니다
- Oracle 지원을 통해 자격 증명을 다시 확인합니다
저장하자마자 OCIM 실패
보이는 내용: OCIM을 선택하면 AVA가 즉시 연결을 거부합니다.
해결 방법:
- Oracle에 올바른
enterpriseId를 요청합니다. - AVA에 OCIM 자격 증명을 다시 입력합니다.
- 다시 저장합니다.
- 여전히 실패하면 Oracle에 클라이언트 ID와 클라이언트 비밀키를 다시 확인합니다.
예약이 표시되지 않음
- 초기 동기화를 위해 15~30분 기다립니다
- Opera에서 OHIP 사용자 권한을 확인합니다
- Opera에 예약이 존재하는지 확인합니다
- 오류 로그와 함께 지원팀에 문의합니다
여러 객실 예약 카드가 비어 보임
보이는 내용: 객실 카드가 열리지만 मुख्य 투숙객이 보이지 않습니다.
해결 방법:
- 확인 번호로 예약을 불러왔는지 확인합니다.
- 체크인 화면을 새로고침하고 객실을 다시 엽니다.
- 여전히 투숙객이 없다면 확인 번호와 도착 날짜를 포함해 지원팀에 문의합니다.
객실 변경에서 객실이 보이지 않음
보이는 내용: Allow move room에서 객실이 보이지 않습니다.
해결 방법:
- Opera에서 예약을 확인합니다.
- 객실을 이동할 수 있어야 한다면 Do Not Move 잠금을 해제합니다.
- AVA에서 예약을 새로고침합니다.
- 객실 변경을 다시 시도합니다.
보안 모범 사례
- 🔒 자격 증명은 안전하게 보관합니다(AVA에서 암호화됩니다)
- 🔒 가능하면 보안을 위해 OCIM을 사용합니다
- 🔒
enterpriseId는 다른 OCIM 자격 증명과 함께 보관합니다 - 🔒 클라이언트 비밀키는 주기적으로 교체합니다
- 🔒 OHIP 사용자 권한은 최소 필요 수준으로 제한합니다
OHIP 자격 증명 받기
자격 증명이 없다면:
- Oracle Hospitality Support 또는 Opera 시스템 관리자에게 문의합니다
- AVA 통합을 위한 OHIP API 접근을 요청합니다
- 다음 항목을 받게 됩니다:
- OHIP Host Name
- Application Key
- Client ID 및 Secret
- Hotel ID
- OCIM용
enterpriseId
- 받은 자격 증명은 안전하게 문서화합니다
아직도 해결되지 않나요?
다음 경우에는 success@vouch-technologies.com으로 문의하세요:
- ❌
enterpriseId를 추가해도 OCIM 연결이 계속 실패함 - ❌ 첫 동기화 창이 지난 뒤에도 예약이 나타나지 않음
- ❌ Oracle은 자격 증명이 유효하다고 하지만 AVA는 여전히 거부함
다음 정보를 포함하세요:
- 오류 스크린샷
- Opera의 identity management 모드
- 문제가 시작된 시간
- 이미 시도한 단계