본문으로 건너뛰기

eZee PMS 연결

빠른 설정

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

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

더러운 객실 규칙

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

점유 객실 보호

AVA는 eZee의 Arrived 및 Dayuse 상태를 점유 상태로 처리합니다. 객실이 깨끗하더라도 점유된 객실은 배정에서 제외합니다. 자동 배정 시 AVA는 Confirmed, Confirmed Reservation, Unconfirmed Reservation, Dayuse Reservation 또는 Reserved 예약이 보유한 객실도 건너뜁니다. 하우스키핑에서 깨끗한 객실로 보고하더라도 이러한 상태는 충돌하는 배정으로부터 객실을 보호합니다. 현재 예약이 보유 객실을 소유하고 있다면 Assisted Check-In에서 해당 객실을 정확히 검증할 수 있습니다. 다른 예약에는 여전히 해당 보유 객실을 자동으로 배정할 수 없습니다.

eZee 시간대별 자리 표시자

eZee는 roomid: "0"이 포함된 Morning 및 Night 행을 보낼 수 있습니다. 물리적 객실이 아니므로 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를 연결하면 다음 기능을 사용할 수 있습니다.

  • 자동 예약 동기화: 예약이 Streamliner에 즉시 표시됩니다
  • 게스트 프로필 업데이트: 체크인 데이터와 신원 필드가 PMS로 다시 전달됩니다
  • 객실 상태 동기화: 하우스키핑 업데이트(Clean/Dirty)가 eZee에 반영됩니다
  • 물리적 하우스키핑 객실만 사용: Morning 및 Night와 같은 시간대별 자리 표시자는 객실로 표시되지 않습니다
  • 객실 매칭: 정확히 일치하는 roomID 값이 우선하고, 그다음 대체 기준인 unitID 일치가 사용됩니다
  • 숙박 전체에 사용 가능한 객실: Assisted Check-In은 숙박 기간의 모든 밤에 이용 가능한 객실을 제공합니다
  • 최초 배정 정확성: 확인된 미배정 단일 객실 예약의 경우 ACI 객실 카드에 Find ready rooms가 표시되며 선택한 실제 객실이 배정됩니다
  • 배정 복구: eZee가 결과를 확인하지 않으면 다시 검색하기 전에 객실 배정을 새로고침합니다
  • 배정 확인: AVA는 선택한 객실을 확인하기 전에 예약을 다시 읽습니다
  • eZee 배정 제한: 객실 이동, 교체, 업그레이드 및 이미 배정된 예약의 변경은 AVA에서 계속 사용할 수 없습니다
  • 예약 정리: Streamliner는 도착 전에 eZee 예약을 취소합니다
  • 다중 객실 예약: eZee 그룹 예약 하나를 생성하며, 각 객실에 별도의 객실 유형과 요금을 적용합니다
  • 그룹 취소: 도착 전 그룹 예약을 취소하면 상위 확인 번호를 사용하여 해당 예약의 모든 객실이 취소됩니다
  • 그룹 복구: eZee의 단일 예약 조회에서 eZee 그룹 목록보다 적은 객실을 반환하더라도 AVA는 전체 그룹을 유지합니다
  • eZee 기본 업셀: 활성화된 eZee Extra Charges를 견적에 포함하고 체크인 중 예약에 연결할 수 있습니다
  • 중복 방지 업셀: 동일한 업셀 연결을 다시 시도해도 eZee에 중복 요금이 생성되지 않습니다
  • 결제 완료 금액이 청구서와 카드에 표시됨: 결제가 완료된 eZee 예약에는 AVA에 결제 완료 금액과 남은 잔액이 표시됩니다. 잔액에는 해당되는 추가 요금이 포함됩니다.
  • 소스 라벨 가독성 유지: 사용할 수 있는 경우 AVA는 eZee 비즈니스 소스 이름을 사용합니다.
  • 소스 수금 기본값은 호텔 수금: AVA는 eZee 예약 소스를 호텔 수금으로 처리합니다.
  • eZee 한도에 따른 객실 수용 인원: eZee가 max occupancy를 비워 두면 AVA는 객실의 기본 수용 인원을 고려하면서 성인 또는 아동 한도 중 더 큰 값을 사용합니다.
  • eZee는 보고된 객실 수용 인원을 초과하는 게스트를 지원하지 않음: AVA는 Assisted Check-In을 계산된 eZee 한도 이내로 유지합니다.
성인 및 아동 한도

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

문제 해결​

"Invalid Credentials" 오류​

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

해결 방법:

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

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

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

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

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

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

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

해결 방법:

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

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

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

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

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

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

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

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

확인할 사항:

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

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

보이는 현상: 예약 또는 Analytics 범위에 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는 전체 예약 기간 동안 계속 이용 가능한 적격 객실만 제공합니다. 또한 하우스키핑 상태, 블록, 객실 유형 및 예약 보유 상태를 확인합니다. 오늘 이용 가능한 객실도 다른 예약이 이후 날짜에 보유하고 있으면 제외될 수 있습니다.

해결 방법:

  1. Housekeeping을 엽니다.

  2. eZee에서 일치하는 객실을 보유한 Confirmed, Confirmed Reservation, Unconfirmed Reservation, Dayuse Reservation 또는 Reserved 예약을 확인합니다.

  3. 충돌하는 예약을 해결하거나 eZee에서 다른 객실을 선택합니다.

  4. 필요한 경우 일치하는 다른 객실을 Clean으로 표시합니다.

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

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

    ✓ 객실 선택기에 적어도 하나의 적격 객실이 표시되어야 합니다.

선택한 후 객실이 사라짐​

보이는 현상: 선택한 객실을 게스트의 전체 숙박 기간에 더 이상 사용할 수 없습니다.

발생 이유: 객실 목록이 로드된 후 eZee의 이용 가능 여부가 변경되었습니다. AVA는 배정을 기록하기 전에 숙박 기간의 모든 밤을 다시 확인합니다.

해결 방법:

  1. AVA에서 예약을 새로고침합니다.

  2. eZee에서 모든 숙박 날짜의 객실 이용 가능 여부를 확인합니다.

  3. 객실의 하우스키핑 상태와 블록 상태를 확인합니다.

  4. 예약된 객실 유형에서 다른 적격 객실을 선택합니다.

    ✓ eZee가 전체 숙박 기간을 확인한 후에만 AVA가 객실을 배정합니다.

AVA가 선택한 객실을 확인할 수 없음​

보이는 현상: AVA에서 배정을 확인할 수 없다고 표시합니다.

발생 이유: 기록 작업 또는 후속 예약 조회에서 최종 객실을 입증하지 못했습니다.

해결 방법:

  1. 즉시 다른 객실을 선택하지 마세요.

  2. AVA에서 예약을 새로고침합니다.

  3. eZee에 표시된 객실을 확인합니다.

  4. 예약이 아직 미배정 상태일 때만 다시 시도합니다.

    ✓ 새로고침된 예약에 계속 진행하기 전에 실제 객실이 표시됩니다.

결과가 계속 불분명하면 지원팀에 문의하세요.

eZee가 이 객실 변경을 허용하지 않음​

보이는 현상: AVA가 배정된 예약의 이동, 교체, 업그레이드 또는 변경을 거부합니다.

발생 이유: eZee는 이 AVA 흐름을 최초 배정에만 지원합니다. 예약은 확인된 미배정 단일 객실 예약이어야 합니다.

해결 방법:

  1. 예약에 이미 객실이 있다면 eZee에서 직접 객실을 변경합니다.

  2. AVA에서 예약을 새로고침합니다.

  3. 확인된 미배정 단일 객실 예약에만 객실 선택기를 사용합니다.

    ✓ AVA에 eZee가 예약에 대해 확인한 객실이 표시됩니다.

직접 사전 배정한 객실이 점유된 것으로 표시됨​

보이는 현상: Assisted Check-In에서 게스트의 사전 배정 객실에 대해 Room occupied라고 표시합니다.

발생 이유: eZee는 안전을 위해 도착 전 예약 보류를 점유 상태로 보고합니다. AVA는 동일한 예약의 도착 게스트와 해당 보류를 구분할 수 있습니다.

해결 방법:

  1. 객실 번호가 현재 eZee 예약과 일치하는지 확인합니다.

  2. AVA에서 예약을 새로고침합니다.

  3. 동일한 예약에 대해 Assisted Check-In을 다시 시도합니다.

  4. 다른 객실이 필요할 때만 Find ready rooms를 사용합니다.

    ✓ AVA는 다른 예약으로부터 객실을 보호하면서 게스트가 보유한 객실을 유지할 수 있습니다.

잘못된 객실이 표시되면 지원팀에 eZee 객실 매핑 검토를 요청하세요. eZee의 roomid와 unitid 값은 실제 객실 간에 겹칠 수 있습니다.

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는 7이 아니라 4를 사용합니다. 객실의 기본 수용 인원이 더 높다면 AVA는 그 더 높은 기본값을 유지합니다.

보이는 현상: eZee에는 결제 완료가 표시되지만 AVA 예약 카드 또는 청구서에는 결제가 표시되지 않거나 잔액이 지나치게 높게 표시됩니다.

발생 이유: eZee에서 결제 기록을 완료한 후 AVA에서 예약을 새로고침해야 할 수 있습니다.

해결 방법:

  1. eZee의 예약 청구서에 결제가 표시되는지 확인합니다.

  2. AVA에서 예약 세부 정보를 새로고침합니다.

  3. Payments 섹션을 다시 열고 Balance Due를 eZee와 비교합니다.

  4. eZee에 결제 완료로 표시된 경우 결제를 다시 수금하지 마세요.

    ✓ 카드와 청구서에 결제 완료 금액과 남은 잔액이 표시되어야 합니다.

새로고침 후에도 값이 다르면 지원팀에 문의하세요.

eZee 그룹 취소에서 일시적인 PMS 오류가 보고됨​

보이는 현상: 도착 전 그룹을 취소할 때 503 또는 PMS를 일시적으로 사용할 수 없다는 메시지가 표시됩니다. 메시지에는 취소되지 않은 객실과 이미 취소된 객실 목록이 표시됩니다.

발생 이유: eZee의 취소 서비스가 요청을 완료하지 못했습니다. AVA는 그룹 객실을 개별적으로 취소하며 eZee에 오류가 발생하면 부분 진행 상황을 보고합니다.

해결 방법:

  1. eZee에서 그룹 예약을 엽니다.

  2. 모든 객실의 취소 상태를 확인합니다.

  3. eZee가 정상적으로 응답할 때까지 기다립니다.

  4. AVA에서 예약을 새로고침합니다.

  5. 취소를 한 번 다시 시도합니다.

  6. eZee에서 모든 객실이 취소되었는지 확인합니다.

    ✓ AVA는 상위 확인 번호를 유지하며 완료되지 않은 취소를 성공으로 처리하지 않습니다.

아직 대체 예약을 생성하지 마세요

대체 예약을 생성하기 전에 eZee에서 모든 객실을 확인하세요. 일부 객실은 성공적으로 취소되었지만 다른 객실은 여전히 활성 상태일 수 있습니다.

그래도 해결되지 않나요?​

다음 상황에 해당하면 success@vouch-technologies.com으로 문의하세요.

  • ❌ 30분 후에도 동기화 결과가 비어 있음
  • ❌ Auth Code가 반복적으로 거부됨
  • ❌ eZee가 복구된 후에도 그룹 취소가 완료되지 않음

함께 보내면 도움이 되는 정보:

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