본문으로 건너뛰기

eZee PMS 연결

빠른 설정

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

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

더러운 객실 규칙

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

점유 객실 보호

AVA는 eZee의 Arrived 및 Dayuse 상태를 점유 상태로 처리합니다. 따라서 객실이 깨끗하더라도 점유된 객실은 배정 대상에서 제외합니다. Confirmed Reservation과 같은 예약 전용 상태는 게스트가 객실에 있다는 뜻이 아닙니다.

eZee day-part 자리 표시자

eZee는 Morning 및 Night 행을 roomid: "0"과 함께 보낼 수 있습니다. 물리적 객실이 아니므로 AVA는 이러한 자리 표시자를 제외합니다. 하우스키핑 업데이트와 객실 배정에는 실제 공실 객실을 사용하세요.

게스트 신원 매핑

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

빠른 참고​

설정설명
Hotel CodeeZee에서 숙소를 식별하는 고유 ID
Auth Code인증을 위한 비밀 API 키(쓰기 전용)
Use Demo Environment샌드박스 환경과 실제 환경 간 전환
API Base URL 사용

eZee에서 사용자 지정 API 엔드포인트를 제공한 경우가 아니라면 Base URL을 비워 두세요. eZee 마케팅 웹사이트를 입력하지 마세요. AVA가 해당 사이트에서 예약을 읽을 수 없습니다.

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. 실제 운영에서는 Use Demo Environment가 OFF인지 확인합니다.

  6. Save를 클릭합니다.

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

보안 참고

저장하면 Auth Code가 *****로 마스킹됩니다. 정상적인 동작입니다. 변경하려면 필드에 새 코드를 입력해 기존 값을 덮어쓰세요.

기능​

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

  • Automatic Reservation Sync: 예약이 Streamliner에 즉시 표시됩니다
  • Guest Profile Updates: 체크인 데이터와 신원 필드가 PMS로 다시 전달됩니다
  • Room Status Sync: 하우스키핑 업데이트(Clean/Dirty)가 eZee에 반영됩니다
  • 물리적 하우스키핑 객실만 사용: Morning 및 Night와 같은 day-part 자리 표시자는 객실로 표시되지 않습니다
  • Room Matching: 정확히 일치하는 roomID 값이 우선하고, 그다음 대체 기준인 unitID 일치가 사용됩니다
  • Reservation Cleanup: Streamliner는 도착 전에 eZee 예약을 취소합니다
  • Multi-room reservations: eZee 그룹 예약 하나를 생성하며, 각 객실에 별도의 객실 유형과 요금을 적용합니다
  • Group cancellation: 도착 전 그룹 예약을 취소하면 해당 예약의 모든 객실이 취소됩니다
  • Source labels stay readable: 사용할 수 있는 경우 AVA는 eZee 비즈니스 소스 이름을 사용합니다.
  • Source collect defaults to hotel collect: AVA는 eZee 예약 소스를 hotel collect로 처리합니다.
  • Room capacity follows eZee limits: eZee가 max occupancy를 비워 두면 AVA는 객실의 기본 수용 인원을 고려하면서 성인 또는 아동 한도 중 더 큰 값을 사용합니다.
성인 및 아동 한도

eZee의 maximum adults와 maximum children 값은 동일한 객실에 적용되는 별도의 한도입니다. AVA는 전체 객실 수용 인원을 계산할 때 두 값을 합산하지 않습니다. eZee가 명시적인 max occupancy 값을 제공하면 해당 값이 우선합니다.

문제 해결​

"Invalid Credentials" 오류​

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

해결 방법:

  1. Hotel Code가 정확히 일치하는지 확인합니다.

  2. Auth Code를 다시 입력합니다(코드가 변경되었을 수 있습니다).

  3. 붙여넣은 값 끝에 공백이 없는지 확인합니다.

    ✓ 다음 PMS 작업부터 AVA가 업데이트된 자격 증명을 사용합니다.

자격 증명을 변경한 후 eZee code 611이 표시됨​

보이는 현상: 값을 변경한 후 eZee가 611, "Invalid Auth Code or Hotel Code"를 반환합니다.

발생 이유: 이전 PMS 요청이 이전 자격 증명으로 아직 처리 중일 수 있습니다.

해결 방법:

  1. Hotel Code와 Auth Code가 동일한 eZee 숙소에 해당하는지 확인합니다.

  2. Settings → Essentials → PMS Integration에서 Save를 클릭합니다.

  3. 저장 확인이 표시될 때까지 기다립니다.

  4. 예약 또는 하우스키핑 작업을 한 번만 다시 시도합니다.

    ✓ 다음 작업부터 새 자격 증명을 사용합니다.

저장이 성공한 후에도 code 611이 계속되면 지원팀에 문의하세요.

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

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

확인할 사항:

  • Use Demo Environment가 OFF로 설정되어 있습니다
  • eZee에 오늘 또는 내일 도착 예정인 유효한 예약이 있습니다
  • 초기 동기화 주기가 완료될 때까지 15분 기다립니다

eZee가 API 응답 오류를 반환함​

보이는 현상: 예약 또는 Analytics coverage에 eZee 응답 오류가 표시됩니다.

발생 이유: Base URL이 웹사이트 또는 다른 비API 주소를 가리킵니다.

해결 방법:

  1. Settings → Essentials → PMS Integration을 엽니다.

  2. eZee를 선택합니다.

  3. 표준 eZee 클라우드 연결에서는 Base URL을 비워 둡니다.

  4. eZee에서 제공한 경우에만 사용자 지정 URL을 사용합니다.

  5. Save를 클릭한 다음 예약 또는 Analytics를 새로고침합니다.

    ✓ 예약이 없는 실제 날짜도 유효한 0건 결과로 표시됩니다.

객실 상태가 점유 상태와 일치하지 않음​

보이는 현상: 객실이 예상과 다르게 Occupied 또는 Vacant로 표시됩니다.

발생 이유: eZee는 현재 호텔 날짜를 기준으로 점유 상태를 보고합니다. AVA는 Arrived 및 Dayuse를 점유 상태로 매핑합니다.

해결 방법:

  1. eZee에서 객실의 게스트 상태와 호텔 날짜를 확인합니다.

  2. 필요한 경우 eZee에서 게스트의 체크인 또는 체크아웃을 완료합니다.

  3. AVA에서 Housekeeping을 열고 객실 목록을 새로고침합니다.

  4. 상태가 계속 잘못 표시되면 지원팀에 문의합니다.

    ✓ 새로고침된 점유 상태에 따라 객실 배정이 처리되어야 합니다.

eZee가 하우스키핑 업데이트를 거부함​

보이는 현상: 상태 업데이트가 Fail 또는 Unit Id(s) not found in the system과 함께 실패합니다.

발생 이유: eZee가 해당 객실을 하우스키핑 단위로 추적하지 않습니다. AVA는 이제 eZee가 반환한 이유를 유지합니다.

해결 방법:

  1. 오류에 표시된 객실 번호를 기록합니다.

  2. eZee에서 해당 객실이 하우스키핑 단위로 구성되어 있는지 확인합니다.

  3. eZee에서 객실 매핑을 수정하거나 추적되는 다른 객실을 업데이트합니다.

  4. Housekeeping으로 돌아가 객실 목록을 새로고침합니다.

    ✓ 추적되는 하우스키핑 단위의 상태 업데이트가 성공해야 합니다.

객실 배정 중 "No rooms available" 표시​

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

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

해결 방법:

  1. Housekeeping을 엽니다.

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

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

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

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

eZee 객실 수용 인원이 이전보다 낮아 보임​

보이는 현상: Assisted Check-In에서 객실의 남은 게스트 슬롯이 줄어들었습니다.

발생 이유: AVA는 더 이상 eZee의 성인 및 아동 한도를 합산하지 않습니다. 해당 값들은 서로 다른 수용 인원 풀이 아니라 동일한 침대에 적용되는 한도입니다.

해결 방법:

  1. eZee에서 객실의 maximum adults, maximum children, 기본 수용 인원을 비교합니다.

  2. eZee가 명시적인 max occupancy 값을 제공하는지 확인합니다.

  3. 남은 게스트 슬롯과 Assisted Check-In 한도에는 AVA에 표시된 객실 수용 인원을 사용합니다.

  4. AVA가 eZee에 구성된 값과 일치하지 않으면 지원팀에 문의합니다.

    ✓ 기존 예약은 예약된 게스트 수를 수용할 수 있는 상태로 유지됩니다.

수용 인원 예시

eZee가 maximum adults 4 및 maximum children 3을 보고하면 AVA는 4를 사용하며 7로 합산하지 않습니다. 객실의 기본 수용 인원이 더 높다면 AVA는 그 더 높은 기본값을 유지합니다.

아직 해결되지 않았나요?​

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

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

함께 보내면 유용한 정보:

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