본문으로 건너뛰기

PMS 연결

Property Management System(PMS)을 AVA Streamliner에 연결하여 예약을 자동으로 동기화합니다.

빠른 설정

Opera Cloud 연결에는 OCIM 모드와 SSD 모드 모두 enterpriseId가 필요합니다. 먼저 Oracle에 요청하세요.

AVA PMS를 사용 중인가요?

AVA PMS를 사용 중이면 이 페이지를 건너뛰고 설정 체크리스트를 계속 진행할 수 있습니다.

먼저 "AVA"가 보이나요?

Settings → Essentials → PMS Integration에서 Select PMS Provider 아래에 AVA 카드가 먼저 표시되는 것은 정상입니다. 연결할 PMS를 선택하세요.

제공업체별 필드

각 PMS 카드에는 해당 제공업체에 적용되는 필드만 표시됩니다. 일부 값은 직접 입력하지 않고 OAuth 또는 배포 설정을 통해 전달됩니다.

제공업체별 필드​

설정 페이지와 Assisted Check-In Setup은 동일한 제공업체 필드 규칙을 사용합니다. 카드를 선택하면 AVA는 해당 PMS에 필요한 필드만 표시합니다.

제공업체입력 또는 확인주요 동작
CloudbedsCloudbeds 계정 연결OAuth가 Property ID와 API key를 제공합니다.
OperaOHIP 연결 필드OHIP Enterprise ID는 OCIM과 SSD에서 모두 필요합니다. SSD에는 username과 password도 필요합니다.
MewsAccess TokenClient Token과 Client ID는 일반적으로 AVA 배포 설정에서 가져옵니다.
Furama iPMSBase URL, Organisation Unit, User Code, API KeyControl Unit과 Business User Code는 선택 사항입니다.
eZeeHotel Code와 Auth CodeBase URL과 Use Demo Environment는 선택 사항입니다.
AVA없음AVA가 숙소 설정을 사용합니다.

저장된 자격 증명 안전하게 유지하기​

AVA는 저장된 보안 값을 다시 표시하는 대신 마스킹합니다.

  1. 다른 설정을 저장할 때 마스킹된 값은 변경하지 않고 그대로 둡니다.

  2. 저장된 자격 증명을 교체하려면 Edit Secret 또는 Edit Token을 선택합니다.

  3. Opera OHIP Password를 유지하려면 필드를 비워 둡니다.

    ✓ 교체 값을 입력하지 않으면 AVA가 저장된 자격 증명을 유지합니다.

웹훅 자동 복구

활성화된 도착 전 설정을 저장하면 AVA가 백그라운드에서 PMS 웹훅 구독을 확인합니다. Cloudbeds 웹훅이 누락되었거나 손상된 경우 다시 저장하면 복구됩니다. Mews 웹훅 구독은 통합 수준에서 계속 관리됩니다.

Cloudbeds 웹훅 자격 증명

Cloudbeds가 웹훅 자격 증명을 거부하면 AVA는 해당 복구를 다시 시도하지 않습니다. Cloudbeds를 다시 연결한 다음 활성화된 도착 전 설정을 다시 저장하세요.

저장 후 설정 새로 고침

PMS 자격 증명 또는 제공업체 변경이 성공하면 AVA가 모든 활성 서버에서 연결을 새로 고칩니다. 자동 캐시 시간 초과를 기다리거나 브라우저를 다시 시작할 필요가 없습니다. 이전 새로 고침이 아직 실행 중이더라도 다음 PMS 작업에는 새 설정이 사용됩니다.

지원되는 시스템​

PMS동기화 유형설정 시간
Cloudbeds실시간10분
Opera Cloud실시간15분
Mews실시간10분
eZee실시간2분
Furama iPMS실시간10분

시작하기 전에​

다음이 필요합니다.

  • PMS 관리자 접근 권한
  • PMS 제공업체에서 승인한 통합 접근 권한
  • AVA Streamliner 관리자 접근 권한
  • Opera 숙소에 사용할 Oracle의 enterpriseId

소요 시간: 10~15분

Cloudbeds 연결​

1단계: AVA에서 연결​

  1. Settings → Essentials로 이동합니다.
  2. PMS Integration 섹션을 찾습니다.
  3. Select PMS Provider 아래에서 Cloudbeds를 클릭합니다.
  4. Connect Cloudbeds Account를 클릭합니다.
  5. Cloudbeds 인증 흐름을 완료합니다.
  6. AVA로 돌아와 상태에 Cloudbeds Account Linked가 표시되는지 확인합니다.

2단계: 연결 확인​

  1. 동기화가 완료될 때까지 2~3분 기다립니다.
  2. Operations View로 이동합니다.
  3. 예약이 표시되는지 확인합니다.

✅ 성공: 오늘 날짜의 Cloudbeds 예약이 표시됩니다.

Opera Cloud 연결​

1단계: OHIP 접근 요청​

  1. Oracle OPERA 담당자에게 연락합니다.
  2. AVA 통합에 사용할 OHIP 자격 증명을 요청합니다.
  3. 다음을 받게 됩니다.
    • OHIP Host Name
    • Application Key
    • Hotel ID
    • Identity Management mode(OCIM 또는 SSD)
    • Client ID
    • Client Secret
    • OCIM 또는 SSD 중 어느 모드에서든 사용할 enterpriseId
    • SSD를 사용하는 경우 Username 및 Password

2단계: AVA에서 연결​

  1. Settings → Essentials로 이동합니다.
  2. PMS Integration 섹션을 찾습니다.
  3. Select PMS Provider 아래에서 Opera를 클릭합니다.
  4. OHIP 자격 증명을 입력합니다.
    • 어느 identity mode를 사용하든 enterpriseId를 포함합니다.
  5. Save를 클릭합니다.
  6. 상태에 Opera Integration Configured가 표시되는지 확인합니다.

Mews 연결​

1단계: Mews 자격 증명 받기​

  1. Mews Commander에 로그인합니다.
  2. Settings → Integrations로 이동합니다.
  3. 마켓플레이스에서 Vouch AVA를 찾습니다.
  4. Access Token을 복사합니다.
마스킹된 값도 안전합니다

나중에 돌아왔을 때 필드가 마스킹되어 보이면 그대로 두고 다시 저장하세요.

2단계: AVA에서 연결​

  1. Settings → Essentials로 이동합니다.
  2. PMS Integration 섹션을 찾습니다.
  3. Select PMS Provider 아래에서 Mews를 클릭합니다.
  4. Access Token을 입력합니다.
  5. Connect를 클릭합니다.

eZee 연결​

1단계: eZee 자격 증명 받기​

  1. eZee 지원팀에 Hotel Code와 Auth Code를 요청합니다.
  2. 숙소에서 사용자 지정 엔드포인트를 사용하는 경우 Base URL을 확인합니다.

2단계: AVA에서 연결​

  1. Settings → Essentials로 이동합니다.
  2. PMS Integration 섹션을 찾습니다.
  3. Select PMS Provider 아래에서 eZee를 클릭합니다.
  4. 다음을 입력합니다.
    • Hotel Code
    • Auth Code
    • Base URL(선택 사항)
  5. 라이브 운영에서는 Use Demo Environment가 OFF인지 확인합니다.
  6. Save를 클릭합니다.

✅ 성공: 상태가 "Connected"로 업데이트됩니다.

더 자세한 내용은 Connect eZee PMS를 참조하세요.

Furama iPMS 연결​

Furama iPMS는 Furama 담당자가 제공한 숙소 자격 증명을 사용합니다.

  1. Settings → Essentials로 이동합니다.

  2. PMS Integration을 찾습니다.

  3. Select PMS Provider 아래에서 Furama iPMS를 클릭합니다.

  4. 필요한 연결 정보를 입력합니다.

  5. Save PMS Settings를 클릭합니다.

    ✓ 상태가 Furama Integration Configured로 변경됩니다.

필드 세부 정보는 Connect Furama iPMS를 참조하세요.

문제 해결​

연결 실패​

보이는 현상: Connect를 클릭할 때 오류 메시지가 표시됩니다.

해결 방법:

  1. 자격 증명을 다시 확인합니다.
  2. Oracle이 사용 중인 identity mode에 맞는 enterpriseId를 제공했는지 확인합니다.
  3. PMS에서 API 권한이 있는지 확인합니다.
  4. 인터넷 연결을 확인합니다.
  5. 몇 분 후 다시 시도합니다.

예약이 동기화되지 않음​

보이는 현상: 연결 후 예약이 표시되지 않습니다.

해결 방법:

  1. Operations View에서 Refresh를 클릭합니다.
  2. 초기 동기화가 완료될 때까지 5분 기다립니다.
  3. PMS에 예약이 존재하는지 확인합니다.
  4. Settings에서 연결 상태를 확인합니다.

동기화 지연​

보이는 현상: 예약 표시가 지연됩니다.

참고: 초기 동기화에는 PMS와 API 부하에 따라 몇 분이 걸릴 수 있습니다.

여전히 해결되지 않나요?​

다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.

  • ❌ 필수 필드를 입력한 후에도 계속 다시 표시됩니다.
  • ❌ 저장 후에도 PMS 연결이 끊어진 상태로 남아 있습니다.
  • ❌ 첫 번째 동기화 시간 이후에도 예약이 표시되지 않습니다.