Opera PMS 통합 (OHIP)
OHIP(Oracle Hospitality Integration Platform)을 통해 AVA를 Oracle의 Opera Cloud 숙소 관리 시스템에 연결하세요. 구성이 완료되면 AVA는 예약, 객실 재고, 투숙객 정보를 Opera에서 직접 동기화합니다.
위치
설정 → 기본 → 숙소 관리 시스템 (PMS) 통합시작하기 전에
IT 팀이나 Oracle/Opera 관리자로부터 다음 자격 증명을 받으세요.
| 자격 증명 | 설명 |
|---|---|
| OHIP Host Name | API 기본 URL (예: ohip.oraclecloud.com) |
| OHIP Application Key | API 액세스를 위한 애플리케이션 키 |
| OHIP Hotel ID | Opera의 숙소 식별자 |
| OHIP Client ID | OAuth 클라이언트 식별자 |
| OHIP Client Secret | OAuth 클라이언트 시크릿 |
경고
Opera OHIP 통합에는 Oracle 또는 IT 팀의 기술 설정이 필요합니다. 숙소에 대한 OHIP 액세스를 활성화한 후 API 자격 증명을 제공할 것입니다.
구성 단계
1단계: PMS로 Opera 선택
- 설정 → 기본으로 이동
- 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(직접 자격 증명) 선택
- OHIP Client ID: OAuth 클라이언트 식별자
- OHIP Client Secret: OAuth 시크릿 키 (Edit Secret을 클릭하여 업데이트)
ID 관리를 위해 SSD를 선택한 경우 다음도 입력하세요.
- OHIP Username: 직접 로그인 사용자 이름
- OHIP Password: 직접 로그인 비밀번호
3단계: 저장 및 확인
- Save를 클릭합니다.
- 상태 표시기를 확인합니다.
- 🟢 "Opera Integration Configured" = 모든 필수 필드 입력됨
- 🟡 "Opera Integration Not Configured" = 필수 필드 누락됨
Opera에서 동기화되는 항목
연결되면 AVA는 다음을 수신합니다.
- ✅ 투숙객 예약 및 폴리오
- ✅ 객실 가용성 및 상태
- ✅ 투숙객 프로필 정보
- ✅ 체크인/아웃 트랜잭션
- ✅ 객실 블로킹 정보
투숙객 및 직원 영향
- 투숙객 양식은 Opera 규칙에 적응합니다. 필수 필드와 숨겨진 필드는 Opera 구성에 따라 변경되므로 투숙객은 필요한 것만 봅니다.
- 예약 조회는 Opera를 사용합니다. Opera가 구성되지 않은 경우 투숙객 조회 단계가 실패합니다.
- 활성 예약은 기본으로 표시됩니다. 취소된 예약은 별도 흐름에서 명시적으로 요청하지 않는 한 일반 조회 결과에 나타나지 않습니다.
- 다중 객실 예약은 주 게스트가 올바른 객실 카드에 유지됩니다. AVA는 confirmation number로 객실을 일치시키므로 Opera에서 내부 ID가 달라도 게스트 연결이 유지됩니다.
- 도움이 필요한 체크인에서는 요금 코드가 표시될 수 있습니다. Opera가 요금 코드를 보내면 직원 지원 체크인 중 선택한 예약 카드에 표시됩니다.
- 결제 전기는 메모를 추가할 수 있습니다. Opera 결제 또는 보증금이 성공하면 AVA가 Opera에 예약 메모를 추가합니다.
- 잠금된 객실은 AVA에서도 잠금 상태로 유지됩니다. Opera가 예약을 Do Not Move로 표시하면 Streamliner가 객실 변경 보기에서 잠금 아이콘을 보여 줍니다.
문제 해결
"Integration Not Configured" 상태
필수 필드가 누락되었습니다. 다음을 입력했는지 확인하세요.
- OHIP Host Name
- OHIP Application Key
- OHIP Hotel ID
- OHIP Client ID
API 연결 오류
- OHIP Host Name이 올바른지 확인
- OHIP 구독이 활성 상태인지 확인
- IT에 문의하여 방화벽/네트워크 액세스 확인
- Oracle 지원팀에 자격 증명 확인
예약이 나타나지 않음
- 초기 동기화를 위해 15-30분 기다리기
- Opera에서 OHIP 사용자 권한 확인
- Opera에 예약이 존재하는지 확인
- 오류 로그와 함께 지원팀에 문의
다중 객실 카드가 비어 보임
보이는 내용: 객실 카드가 열리지만 주 게스트가 보이지 않습니다.
해결:
- confirmation number로 예약을 불러왔는지 확인합니다.
- 체크인 화면을 새로고침하고 객실을 다시 엽니다.
- 그래도 게스트가 보이지 않으면 confirmation number와 도착일을 포함해 지원팀에 문의합니다.
보안 모범 사례
- 🔒 자격 증명을 안전하게 저장하세요(AVA에서는 암호화됨)
- 🔒 더 나은 보안을 위해 가능한 경우 OCIM을 사용하세요
- 🔒 클라이언트 시크릿을 주기적으로 교체하세요
- 🔒 OHIP 사용자 권한을 필요한 최소한으로 제한하세요
OHIP 자격 증명 얻기
자격 증명이 없는 경우:
- Oracle Hospitality 지원팀 또는 Opera 시스템 관리자에게 문의
- AVA 통합을 위한 OHIP API 액세스 요청
- 다음을 제공할 것입니다.
- OHIP Host Name
- Application Key
- Client ID 및 Secret
- Hotel ID
- 받은 자격 증명을 안전하게 기록하세요
도움이 필요하신가요?
- Oracle 지원: support.oracle.com
- AVA 지원: success@vouch-technologies.com
- 귀사의 IT 부서: 자격 증명 및 네트워크 액세스 관련