본문으로 건너뛰기

eZee PMS 연결

빠른 설정

연결은 보통 2분 정도 걸립니다. eZee 지원팀에서 받은 Hotel Code와 Auth Code만 있으면 됩니다.

Streamliner는 eZee(Absolute / Centrix)와 직접 연결되어 예약, 게스트 정보, 객실 상태를 실시간으로 동기화합니다.

더러운 객실 규칙

AVA는 eZee 객실 배정을 깨끗한 객실에만 유지합니다. 일치하는 모든 객실이 더럽다면, Housekeeping에서 객실 하나를 정리한 뒤 새로고침하고 나서 배정하세요. eZee는 체크인 중에도 더러운 객실을 오류 117으로 거부할 수 있습니다.

게스트 신원 매핑

Streamliner는 중첩 문서 데이터, 최상위 documentNumber, 최상위 passportNumber를 eZee 신원 필드에 매핑합니다.

빠른 참고​

설정설명
Hotel CodeeZee에서 숙소를 식별하는 고유 ID
Auth Code인증용 비밀 API 키(쓰기 전용)
Demo Mode샌드박스와 실제 환경 전환

1. 자격 증명 준비​

연결하기 전에 다음 항목을 준비하세요.

  • Hotel Code: eZee 대시보드에서 확인
  • Auth Code: 특수 API 비밀값(eZee 또는 Vouch 지원팀에 요청)
  • Base URL(선택 사항): 사용자 지정 eZee 엔드포인트를 사용하는 경우에만 필요

2. 연결 활성화​

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

  2. Select PMS Provider에서 eZee 카드를 클릭합니다.

  3. ✓ eZee 카드가 선택된 상태로 표시됩니다.

  4. 자격 증명을 입력합니다.

    • Hotel Code: 예: EZ1234
    • Auth Code: 비밀 키를 입력합니다.
    • Base URL: 표준 클라우드에서는 비워 둡니다(기본값)

  5. 실제 운영에서는 Demo Mode를 OFF로 설정합니다.

  6. Save를 클릭합니다.

    ✓ 상태가 "Connected"로 업데이트되어야 합니다.

보안 참고

저장 후 Auth Code는 *****로 마스킹됩니다. 이는 정상입니다. 변경하려면 해당 필드에 새 코드를 덮어쓰면 됩니다.

기능​

eZee를 연결하면 다음 기능을 사용할 수 있습니다.

  • Automatic Reservation Sync: 예약이 Streamliner에 즉시 표시됩니다.
  • Guest Profile Updates: 체크인 데이터와 신원 필드가 PMS로 다시 전송됩니다.
  • Room Status Sync: 하우스키핑 업데이트(Clean/Dirty)가 eZee에 반영됩니다.
  • Room Matching: 정확한 roomID 값이 우선하며, 그다음 unitID 일치값으로 대체됩니다.
  • Reservation Cleanup: Streamliner가 eZee의 예약 수정 흐름을 통해 예약을 취소합니다.
  • Source labels stay readable: AVA는 eZee 비즈니스 소스 이름을 사용할 수 있으면 사용합니다.
  • Source collect defaults to hotel collect: AVA는 eZee 예약 소스를 hotel collect로 처리합니다.

문제 해결​

"Invalid Credentials" 오류​

보이는 현상: 저장할 때 오류 메시지가 표시되거나 동기화가 즉시 실패합니다.

해결:

  1. Hotel Code가 정확히 일치하는지 확인합니다.
  2. Auth Code를 다시 입력합니다. 코드가 변경되었을 수 있습니다.
  3. 붙여넣은 값 끝에 공백이 없는지 확인합니다.

연결은 성공했지만 예약이 없음​

보이는 현상: 상태는 "Connected"인데 예약 목록이 비어 있습니다.

확인:

  • Demo Mode가 OFF인지 확인
  • eZee에 오늘 또는 내일 도착 예정 예약이 있는지 확인
  • 초기 동기화 주기가 끝날 때까지 15분 정도 기다림

"Assign Room" 중 사용 가능한 객실이 없음​

보이는 현상: 객실 선택기가 비어 있거나 AVA가 사용 가능한 객실이 없다고 표시합니다.

이유: AVA는 eZee 객실 배정 흐름에서 깨끗한 객실만 제공합니다.

해결:

  1. Housekeeping을 엽니다.

  2. 일치하는 객실 하나를 Clean으로 표시합니다.

  3. 예약으로 돌아가 Refresh를 클릭합니다.

  4. Assign Room을 다시 시도합니다.

    ✓ 객실 선택기에 적어도 하나의 사용 가능한 객실이 표시되어야 합니다.

아직 막혔나요?​

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

  • ❌ 30분이 지나도 동기화가 비어 있음
  • ❌ Auth Code가 반복해서 거부됨

함께 보내면 좋은 정보:

  • Hotel Code
  • 오류 메시지 스크린샷
  • 문제가 시작된 시각