체크인 차단 빠른 진단
대부분의 프런트 데스크 차단 문제는 2분 이내에 해결됩니다.
투숙객이 데스크에 와서 체크인을 진행할 수 없을 때 이 가이드를 사용하세요.
60초 진단
- 올바른 예약을 열었는지 확인합니다.
- 표에서 차단 원인을 찾습니다.
- 조치를 적용합니다.
- 체크인을 다시 진행합니다.
| 차단 원인 | 보이는 현상 | 조치 |
|---|---|---|
| 예약을 찾을 수 없음 | 스캔에 실패하거나 결과가 없음 | 확인번호로 검색하고 도착일을 확인합니다(체크인 완료 방법 참고) |
| 예약 조회가 너무 오래 걸림 | 조회가 대기한 후 일시적인 서비스 오류가 표시됨 | 몇 분 기다리고 AVA를 새로고침한 다음 예약 조회를 다시 시도합니다 |
| 조회 중 예약이 변경됨 | 확인된 직원 조회 후 "Reservation changed while it was being saved. Try again."이 표시됨 | 예약을 새로고침한 다음 조회를 한 번 다시 시도합니다 |
| 숙소가 구성되지 않음 | 게스트 또는 직원에게 설정이 필요하다는 체크인 메시지가 표시됨 | 관리자에게 PMS 연결 또는 숙소 설정 완료를 요청합니다 |
| 서류와 이름 불일치 | 예약 이름이 법적 신분증/여권의 이름과 다름 | 체크인 차단: 이름 불일치를 따릅니다 |
| 게스트 보호 예약 차단 | 잔액, 숙박 기간 또는 예약 유형 문제에 대한 짧은 현지화 차단 힌트가 게스트에게 표시됨 | Command Center → View Details를 열고 구조화된 사유, 경고 패널 및 잔액 세부 정보를 확인합니다 |
| 호텔 결제 필요 | 예약 조회 후 게스트에게 호텔 정책 메시지가 표시됨 | Command Center → View Details를 열고 호텔 결제 사유를 검토한 다음 결제를 완료하거나 프런트 데스크 절차를 사용합니다 |
| 조회 시 Mews 청구 검토 | 예약 조회 후 게스트가 프런트 데스크로 안내됨 | 객실 요금을 받기 전에 전체 Mews 청구서를 검토합니다 |
| 필수 단계 미완료 | Proceed to Check-In이 비활성화됨 | 각 게스트의 필수 단계를 모두 완료합니다(체크인 완료 방법 참고) |
| EVA 확인 필요 | 체크인에 다시 시도할 수 있는 EVA 메시지가 표시됨 | EVA를 완료하거나 다시 시도한 후 체크인을 다시 시도합니다. EVA를 사용할 수 없으면 호텔의 EVA 설정을 확인합니다. |
| 수동 ACI 객실에 대표 게스트 없음 | 추가로 그룹화된 객실에서 Proceed to Check-In이 계속 비활성화됨 | 해당 객실의 대체 게스트에게 등록을 완료하고 서명하도록 요청합니다. 서명한 대체 게스트 한 명이 객실을 대표할 수 있게 되면 AVA가 체크인을 활성화합니다. |
| 객실 출입 필요 | 구성된 키카드 인코더로 인해 체크인이 완료되지 않음 | 키카드를 인코딩하고 Room Access에 Success가 표시되는지 확인한 다음 체크인을 완료합니다 |
| 결제/보증금 미완료 | 결제 요구사항이 아직 보류 중임 | Reservation Requirements에서 결제를 받습니다(체크인 완료 방법 참고) |
| 객실 상태로 체크인 차단 | "Room not ready" 또는 이용 가능한 객실이 없음 | 객실 배정과 상태를 확인합니다. Opera component suite라면 연결된 모든 객실을 확인합니다. eZee를 사용한다면 Housekeeping에서 일치하는 객실 하나를 정리한 뒤 새로고침하고 다시 시도합니다. |
| 객실 배정 실패 | Information 모달에 원시 백엔드 텍스트가 아닌 사용자 친화적인 객실 사용 불가 메시지가 표시됨 | PMS 객실 배정을 확인하고 충돌을 해결한 다음 다시 시도합니다 |
| Opera 게이트웨이 중단 | Opera 객실 배정에 시간이 더 걸린 후 성공하거나 일시적인 PMS 사용 불가 메시지가 표시됨 | 다시 시도하기 전에 AVA가 자동 복구를 완료할 때까지 기다립니다 |
| 객실 배정 중 PMS를 사용할 수 없음 | AVA에 일시적인 PMS 사용 불가 메시지가 표시됨 | PMS를 확인하고 잠시 기다린 후 한 번 다시 시도합니다. 이는 객실 준비 상태 결과가 아닙니다. |
| 예약 조회, 객실 배정 또는 최종 체크인 중 PMS 요청 한도 초과 | AVA가 잠시 멈춘 후 계속 진행되거나 이해하기 쉬운 오류를 표시함 | AVA가 재시도를 완료할 때까지 기다립니다. 계속 차단되면 PMS를 확인하고 한 번 다시 시도합니다 |
| PMS 예약 변경 진행 중 | 객실 배정 또는 최종 체크인 중 PMS_RESERVATION_MUTATION_IN_PROGRESS가 표시됨 | 잠시 기다린 후 AVA를 새로고침하고 해당 단계를 한 번 다시 시도합니다 |
| PMS 체크인 결과가 불명확함 | 첫 시도가 멈춘 것처럼 보이거나 PMS가 게스트를 체크인했을 수 있는데 객실 배정이 차단됨 | PMS에서 예약을 확인하고 AVA를 새로고침한 뒤 도착 결정을 검토합니다. 영향을 받은 단계만 한 번 다시 시도합니다. 이후 PMS 점유 조회가 실패하더라도 AVA는 완료된 체크인을 유지합니다. |
| 객실 작업 대기 중 | "A room operation is pending. Refresh the room assignment to recover its result before continuing."이 표시됨 | 이동을 다시 시도하거나 출입 권한을 발급하지 않습니다. 객실 배정을 새로고침하고 PMS에서 확인된 결과를 기다린 후 계속 진행합니다. 계속 대기 중이면 지원팀에 문의합니다. |
| 공유 객실 게스트가 계속 대기 중으로 표시됨 | Opera 객실 공유에서 한 게스트는 도착 처리되었지만 다른 게스트 레코드는 계속 대기 중임 | Opera에서 게스트가 투숙 중인지 확인하고 AVA를 새로고침한 뒤 현재 확인된 직원 기기 또는 예약 세션에서 다시 시도합니다 |
| 늦게 도착한 Opera 객실 공유 게스트가 해결되지 않음 | 주 게스트가 체크인한 후 "Guest reservation membership is unresolved"가 표시됨 | Opera에서 해당 공유 게스트의 예약을 열고, 투숙 중인 주 예약과 연결되어 있으며 활성 상태인지 확인한 뒤 AVA를 새로고침하고 한 번 다시 시도합니다 |
| Opera 게스트 프로필이 교체됨 | 도착 또는 체크인 중 "Guest reservation membership is unresolved"가 표시됨 | 예약을 새로고침한 후 한 번 다시 시도합니다. Opera가 해당 예약에서 교체를 확인하면 AVA가 폐기된 주 게스트 프로필을 다시 연결할 수 있습니다. |
| Cloudbeds 객실 충돌 | "cannot check this reservation in until ... assigned to this room is checked out" | 진행 중인 숙박을 체크아웃하거나 Cloudbeds에서 객실을 재배정한 뒤 AVA를 새로고침하고 다시 시도합니다 |
| Cloudbeds 공유 folio 루프 | "Unable to find the reservation. Please try again or contact support."가 표시되거나 Proceed with Selected Reservation을 선택하면 같은 오류로 돌아감 | 예약을 새로고침한 다음 다시 시도합니다. 계속 반복되면 지원팀에 문의합니다. |
| Cloudbeds 게스트 국가 필요 | GUEST_COUNTRY_REQUIRED 또는 "Nationality required" | 동반자 체크인 전에 Nationality 또는 Country of Residence를 입력한 뒤 다시 시도합니다 |
| Cloudbeds 게스트 신원 검토 | GUEST_BOOKING_MATCH_REVIEW_REQUIRED 또는 게스트 검토 메시지가 표시됨 | Cloudbeds에서 예약 게스트 신원을 확인하고 AVA를 새로고침한 뒤 한 번 다시 시도합니다 |
| Cloudbeds 이용 가능 여부 거부 | PMS_OCCUPANCY_UNAVAILABLE_FOR_DATES 또는 날짜를 변경하거나 객실 수를 줄이라는 메시지가 표시됨 | Cloudbeds 이용 가능 여부를 확인하고 이용 가능한 옵션으로 변경한 뒤 AVA를 새로고침하고 한 번 다시 시도합니다 |
| Cloudbeds 객실 이용 가능 여부 변경 | 자동 객실 배정 중 오래된 이용 가능 정보, 점유 객실 또는 배정 시간 초과 메시지가 표시됨 | Cloudbeds에서 현재 예약의 점유 상태와 하우스키핑 상태를 확인하고 AVA를 새로고침한 뒤 한 번 다시 시도합니다 |
| 게스트 수 동기화 재시도 한도 | 일시적인 동기화 실패가 반복된 후 게스트에게 직원 지원 안내가 표시됨 | 게스트의 재시도를 중지하고 직원 절차를 계속 진행한 뒤 PMS의 게스트 수를 확인합니다 |
| 반복 조회 후 단일 기기 ACI 여정 오류 | 예약을 다시 검색한 후에도 ACI가 계속 진행되지 않음 | Staff Access에서 조회를 한 번 다시 수행합니다. 계속 차단되면 AVA를 새로고침하고 지원팀에 문의합니다 |
| 기존 PMS 그룹이 다른 확인번호 아래에 표시됨 | 객실 수준 검색에서 PMS 그룹의 기본 확인번호가 열림 | 복구된 그룹으로 계속 진행합니다. 이미 그룹에 포함된 형제 예약은 다시 선택하지 않습니다 |
| 수동 그룹화에 특정 오류가 표시됨 | AVA에 "Reservation not found" 대신 충돌 또는 대체 메시지가 표시됨 | 메시지를 따르고 나열된 충돌을 해결한 뒤 다시 시도합니다. 메시지가 계속 표시되면 지원팀에 문의합니다 |
| 오래된 체크인 화면 | "This screen is out of date" 또는 "Review who is arriving before checking in"이 표시됨 | AVA를 새로고침하고 도착 결정을 검토한 뒤 체크인을 다시 시도합니다 |
| 도착 검토가 변경됨 | AVA가 잠시 다시 시도하거나 체크인 중 변경 사항이 있었다는 현지화 메시지가 표시됨 | AVA가 재시도를 완료할 때까지 기다립니다. 다시 요청하면 도착 선택을 검토하고 Check In을 한 번 선택합니다 |
| ACI 직원 작업을 사용할 수 없음 | 직원 검색, 예약 목록 또는 상태 변경 작업을 사용할 수 없음 | ACI 직원 기기를 확인하고 최신 목록이 로드될 때까지 기다린 후 다시 시도합니다 |
| 조기 ACI 체크인 확인 | 확인된 ACI 직원 기기에 조기 체크인 경고가 표시됨 | 허용된 날짜와 시간을 검토한 다음 Override and check in 또는 Cancel을 선택합니다. Self Check-In 및 Pre-arrival은 계속 차단됩니다. |
| 0박 완료 차단 | 당일 예약은 조회되지만 객실 배정이 Day Use 메시지와 함께 중지됨 | Settings → Check-In에서 Day use를 켜고 저장한 후 예약을 새로고침하고 다시 시도합니다 |
| 수동 ACI 그룹화에 직원 확인 필요 | 같은 이름의 예약을 그룹화하는 중 직원 기기 확인 메시지가 표시됨 | ACI 직원 기기를 확인한 후 그룹화를 다시 시도합니다. 이는 예약 조회 실패가 아닙니다 |
| 게스트 이동 조정 실패 | Guest is not attached to the source reservation | 예약을 새로고침하고 원본 및 대상 객실을 확인한 뒤 게스트를 다시 이동합니다 |
| 이동한 주 게스트로 인해 객실이 차단됨 | 주 게스트가 다른 객실로 이동한 후 객실에서 체크인할 수 없음 | 대상 객실에서 이동한 게스트의 등록과 서명을 완료한 후 새로고침하고 차단된 객실을 다시 시도합니다 |
| SiteMinder 다중 객실 게스트 목록이 중복되어 보임 | 연결된 Opera 객실 전체에 동반 게스트가 반복되거나 추가 게스트 슬롯이 표시됨 | 예약을 새로고침합니다. Opera에서 SiteMinder 예약 그룹과 성인 점유 수를 확인한 뒤 한 번 다시 시도합니다 |
| 체크인 후 객실 출입 불가 | 키카드/PIN/코드가 표시되지 않음 | 체크인 완료 방법의 객실 출입 문제 해결을 사용합니다 |
EVA 확인으로 체크인이 차단됨
보이는 현상: AVA에 다시 시도할 수 있는 EVA 메시지가 표시되고 체크인이 완료되지 않습니다.
발생 원인: 호텔에서 PMS 체크인 전에 현재 유효한 EVA 성공 결과를 요구합니다.
해결 방법:
- 올바른 도착 게스트와 예약을 처리하고 있는지 확인합니다.
- 현재 체크인 여정에서 EVA 단계를 다시 시도합니다.
- EVA에 성공 결과가 표시될 때까지 기다립니다.
- 결과가 성공하면 Proceed to Check-In을 한 번 다시 시도합니다.
메시지에 EVA가 대기 중이거나 실패했거나 누락되었거나 오래되었거나 비활성화되었거나 사용할 수 없다고 표시되면 PMS 체크인을 반복하지 않습니다. Government Compliance → Singapore → STB EVA를 확인하고 호텔의 환경과 자격 증명을 확인합니다.
얼굴 인증이 면제된 어린이는 EVA가 필요하지 않습니다. 같은 예약의 성인은 계속해서 성공한 EVA 결과가 필요합니다. 호텔 요구사항이 활성화되어 있으면 직원의 얼굴 인증 재정의에도 EVA가 필요합니다. 이 요구사항이 활성화되어 있어도 사전 도착 등록은 계속 사용할 수 있습니다.
AVA는 첫 PMS 체크인 전에 그룹의 모든 객실을 확인합니다. 그룹을 다시 시도하기 전에 해당되는 모든 게스트의 EVA 결과를 해결합니다.
게스트 프로필 선택이 대기 중임
보이는 현상: 게스트 행에 Profile choice needed가 표시됩니다. 객실 카드에 황색 배너가 표시되고 Proceed to Check-In이 비활성화됩니다.
발생 원인: Opera가 가능한 게스트 프로필을 여러 개 반환했습니다. AVA는 직원이 올바른 프로필을 확인할 때까지 기다립니다.
해결 방법:
-
객실 배너 또는 게스트 행에서 Choose profile을 선택합니다.
-
각 후보를 게스트가 확인한 신원 정보와 비교합니다.
-
올바른 프로필을 선택하거나 Create new를 선택합니다.
-
선택을 확인합니다.
-
대기 중 배지가 사라지면 체크인을 계속합니다.
✓ 게스트가 저장한 서명을 계속 사용할 수 있습니다.
대기 중인 선택이 완료된 후 게스트가 다시 서명해서는 안 됩니다. 등록이 직원 검토를 기다리는 경우에도 게스트는 서명 후 Thank you를 봅니다.
프로필 조회 또는 결정이 차단됨
보이는 현상: 프로필 검토를 불러올 수 없거나 AVA가 프런트 데스크에 도움을 요청합니다.
해결 방법:
- AVA에서 제공하는 경우 Retry를 한 번 선택합니다.
- Opera에서 게스트의 신원 정보와 예약을 확인합니다.
- 게스트의 서명이나 체크인을 반복해서 제출하지 않습니다.
- 게스트 이름, 예약, 시각 및 표시된 메시지를 포함하여 Vouch 지원팀에 문의합니다.
지원팀에는 PROFILE_LOOKUP_INCOMPLETE 또는 PROFILE_DECISION_BLOCKED가 표시될 수 있습니다.
이 상태에서는 등록을 계속하기 전에 지원팀의 검토가 필요합니다.
체크인 중 연결 복구
보이는 현상: 네트워크, 로그인 또는 API 오류가 잠시 발생한 뒤 AVA가 응답하지 않습니다.
발생 원인: 브라우저가 온라인 상태여도 AVA 요청은 실패할 수 있습니다.
해결 방법:
-
같은 기기에서 AVA를 열어 둡니다.
-
기기가 인터넷에 연결되어 있는지 확인합니다.
-
AVA가 다시 연결되어 서비스 복구를 확인할 때까지 기다립니다.
-
AVA에 버튼이 표시될 때만 Retry를 선택합니다.
-
복구 후에도 페이지가 차단된 상태라면 한 번 새로고침합니다.
-
AVA가 로그인 화면으로 돌아가면 다시 로그인합니다.
✓ 인증이 유효해지면 AVA가 현재 흐름을 재개합니다.
AVA는 페이지를 새로 로드한 후에도 복구 타이밍을 유지합니다. 또한 로그인이 유효해질 때까지 보호된 작업을 일시 중지합니다. 이렇게 하면 유효하지 않은 세션으로 불완전한 요청이 실행되는 것을 방지할 수 있습니다.
인시던트 보고가 활성화되어 있으면 AVA는 기기에 간단한 인시던트 기록을 저장합니다. 복구 후 제한된 기술 증거를 보고합니다. 보고서에는 게스트 세부 정보, 자격 증명, 쿼리 값 및 응답 본문이 포함되지 않습니다. 연결 인시던트 알림은 가능한 경우 현재 호텔의 이름과 시간대를 사용합니다. 프로필 메타데이터를 사용할 수 없으면 알림에는 가맹점 ID가 유지되고 UTC가 사용됩니다.
30초 미만의 복구는 확인 후 승인되고 폐기됩니다. 인시던트 기록을 만들거나 Google Chat 알림을 보내지 않습니다. 30초 이상의 복구는 보존되며 알림을 생성할 수 있습니다. 지속 시간은 최초 실패부터 전체 인증 복구까지를 포함합니다. 상태 복구만으로는 인시던트가 종료되지 않습니다.
자동화된 E2E 테스트용으로 구성된 숙소는 Google Chat 알림 없이 조건을 충족하는 인시던트를 보존할 수 있습니다. 이를 통해 테스트 트래픽으로 인해 직원 알림이 불필요하게 생성되는 것을 방지합니다.
복구가 완료되지 않음
보이는 현상: AVA가 계속 다시 연결되거나 다시 시도한 후에도 같은 오류가 돌아옵니다.
해결 방법:
- 같은 작업을 반복해서 다시 시도하지 않습니다.
- 기기가 승인된 호텔 네트워크를 사용하는지 확인합니다.
- AVA 탭을 전면으로 가져옵니다.
- 복구 시도가 완료될 때까지 기다립니다.
- AVA가 응답하면 작업을 한 번 시도합니다.
- 게스트가 기다릴 수 없으면 직원 지원 체크인을 사용합니다.
문제가 계속되면 정확한 시각과 표시된 요청 ID를 기록합니다. 지원팀은 해당 ID를 백엔드 요청 로그와 대조할 수 있습니다.
복구 중 페이지가 새로 로드됨
보이는 현상: 다시 연결하는 동안 AVA가 새로 로드되거나 페이지를 다시 연 후에도 복구가 계속됩니다.
해결 방법:
-
처음 복구를 시도하는 동안에는 브라우저 데이터를 삭제하지 않습니다.
-
같은 브라우저 탭을 열어 둡니다.
-
AVA가 복구 일정을 복원할 때까지 기다립니다.
-
페이지가 준비되면 Retry를 한 번 선택합니다.
✓ 페이지를 새로 로드해도 인시던트의 재시도 시점이나 ID는 유지되어야 합니다.
Cloudbeds가 동반자 생성을 거부하면 AVA는 동일한 GUEST_COUNTRY_REQUIRED 오류를 표시합니다.
Nationality 또는 Country of Residence를 입력한 다음 동반자 체크인을 다시 시도합니다.
PMS 객실 배정이 실패하면 게스트에게 Information 모달의 사용자 친화적인 메시지가 표시됩니다. PMS가 5xx를 반환하더라도 게스트에게는 "Internal server error" 대신 사용자 친화적인 메시지가 표시됩니다. AVA는 원시 백엔드 텍스트, 게스트 이름 및 기술 세부 정보를 게스트 화면에서 숨깁니다.
객실 배정 중 PMS가 응답하지 않으면 AVA는 일시적인 서비스 문제를 보고합니다. 이 시도에서는 객실을 준비되지 않은 상태로 표시하거나 객실 미준비 알림을 보내지 않습니다. 배정을 다시 시도하기 전에 PMS를 확인합니다.
예약 조회, 객실 배정 또는 최종 체크인 중 PMS가 일시적으로 429를 반환하면 AVA가 자동으로 재시도합니다. AVA가 PMS가 요청을 수락할 때까지 기다리므로 작업에 몇 초가 더 걸릴 수 있습니다. 재시도가 실패하면 AVA는 해당 단계의 일반적인 오류를 표시합니다. 작업이 완료될 때까지 기다린 후 Retry를 선택하거나 게스트에게 단계를 반복하도록 요청합니다.
AVA는 자동 객실 배정 전에 최신 Cloudbeds 예약, 미배정 객실 및 하우스키핑 데이터를 읽습니다. 이 결과가 오래되었거나 서로 너무 차이가 나거나 배정 시간 제한을 초과하면 중지합니다. AVA는 최종 배정 쓰기를 자동으로 재생하지 않으므로 다시 시도하기 전에 Cloudbeds를 확인하세요.
Cloudbeds에서 객실이 빈 객실로 표시되지만 AVA가 배정하지 않음
보이는 현상: Cloudbeds 하우스키핑에는 객실이 빈 객실로 표시되지만 AVA가 객실을 건너뛰거나 투숙 중 객실 이동을 차단합니다.
발생 원인: 체크인된 예약이 여전히 객실을 점유하고 있습니다. Cloudbeds에서는 기한이 지난 예약의 체크아웃 날짜가 지나면 하우스키핑에 빈 객실로 표시될 수 있습니다.
해결 방법:
-
Cloudbeds에서 해당 객실의 현재 예약을 엽니다.
-
다른 예약이 아직 체크인 상태가 아닌지 확인합니다.
-
필요한 경우 기한이 지난 예약의 체크아웃 상태를 수정합니다.
-
Cloudbeds가 업데이트된 후 AVA를 새로고침합니다.
-
객실 배정 또는 객실 이동을 한 번 다시 시도합니다.
✓ Cloudbeds가 현재 빈 객실임을 확인한 후에만 AVA가 객실을 사용해야 합니다.
Cloudbeds가 완전한 점유 데이터를 반환하지 않으면 AVA는 해당 객실을 계속 사용할 수 없는 상태로 유지합니다. 예약이 체크아웃되었는데도 AVA가 객실을 계속 건너뛰면 지원팀에 문의합니다.
Cloudbeds 객실 ID 체크인 검토 필요
보이는 현상: 객실을 이동한 후 체크인 또는 체크아웃이 중지됩니다. 요청에 Cloudbeds 객실 ID가 사용되었지만 AVA가 해당 예약 또는 현재 객실을 확인할 수 없습니다.
발생 원인: Cloudbeds가 불완전하거나 충돌하는 객실 세부 정보를 반환했습니다. AVA는 예약을 변경하기 전에 중지합니다.
해결 방법:
-
Cloudbeds에서 예약을 엽니다.
-
객실이 예상한 예약에 배정되어 있는지 확인합니다.
-
객실을 이동한 후 현재 객실 상태와 배정을 확인합니다.
-
AVA를 새로고침합니다.
-
체크인 또는 체크아웃을 한 번 다시 시도합니다.
✓ AVA는 현재 Cloudbeds 객실 배정을 사용합니다.
객실이 이미 체크인된 경우 AVA는 체크인을 반복하지 않고 현재 객실을 반환합니다. Cloudbeds에 올바른 객실이 표시되는데도 AVA가 이를 확인하지 못하면 지원팀에 문의합니다.
Opera는 객실 준비 상태 확인 중 유효하지만 비어 있는 서비스 중단 결과를 반환할 수 있습니다. AVA는 이를 차단된 객실이 없는 것으로 처리하고 배정 절차를 계속합니다. AVA에 "PMS service is unavailable"가 표시되면 Opera가 누락되었거나 잘못된 결과를 반환한 것입니다. 다시 시도하기 전에 Opera 연결과 객실 데이터를 확인합니다.
키오스크 적격성 확인이 실패하면 게스트에게 짧은 현지화 메시지가 표시됩니다. 정확한 차단 원인과 일치한 값은 Command Center에 남습니다.
잔액 없음 및 장기 숙박 조회 차단에는 이제 게스트에게 안전한 현지화 힌트가 표시됩니다. AVA는 게스트 모달에 백엔드 정책 텍스트를 표시하지 않고 직원 오류 코드는 유지합니다. 향후 추가될 알 수 없는 예약 차단 코드는 일반적인 호텔 정책 메시지로 대체됩니다. 잔액 없음 차단은 Command Center에 예약도 기록합니다. Show Details를 열면 잔액 진단 정보를 확인할 수 있습니다. 0박 예약은 계속 조회할 수 있으며, 객실 배정 중 Day Use 규칙이 적용됩니다.
예약이 RESERVATION_BLOCKED_EMPTY_BALANCE로 차단되면 Show Details가 경고 패널과 함께 열립니다.
이를 사용해 PMS 잔액을 Outstanding balance, Payment waived, Billing routed elsewhere, Reservation status와 비교합니다.
Outstanding balance에 Not reported by the PMS가 표시되면 PMS가 사용할 수 있는 잔액을 반환하지 않은 것입니다.
예약 조회 차단 시 직원에게 알림
보이는 현상: 예약 조회 후 게스트에게 프런트 데스크 검토 메시지가 표시됩니다.
예약은 조회 실패 이벤트와 함께 Command Center에도 표시됩니다.
알림이 활성화되어 있으면 직원에게 Check-in issue 푸시 알림이 전송됩니다.
알림 제목에는 Check-in issue at Entry와 같이 실패한 단계가 표시됩니다.
메시지에는 직원이 이해하기 쉬운 언어로 사유가 포함됩니다.
Google Chat 카드에는 단계의 in_progress 상태가 아닌 Status: FAILED가 표시됩니다.
AVA는 다음 예약 조회 차단에 대해 이 알림을 보냅니다.
| 차단 코드 | 직원 알림 사유 | 프런트 데스크 조치 |
|---|---|---|
RESERVATION_BLOCKED_BY_KIOSK | 호텔 정책 또는 호텔 결제 규칙으로 인해 키오스크 체크인이 차단됩니다. | 직원 전용 사유를 검토한 다음 결제를 받거나 프런트 데스크에서 게스트를 체크인합니다. |
RESERVATION_BLOCKED_EMPTY_BALANCE | 예약에 미결제 folio 잔액이 있습니다. | 체크인 전에 잔액을 정산합니다. |
RESERVATION_BLOCKED_UNVERIFIED_BILLING | 예약의 청구를 확인할 수 없습니다. | 체크인 전에 folio를 검토합니다. |
RESERVATION_BLOCKED_LONG_STAY | 숙박 기간이 키오스크 장기 숙박 한도를 초과합니다. | 프런트 데스크에서 게스트를 체크인합니다. |
해결 방법:
- 직원 알림을 열거나 Command Center로 이동합니다.
- 예약을 선택하고 View Details를 선택합니다.
- Detailed Event Log를 엽니다.
- 실패한 조회 이벤트에서 Show Details를 선택합니다.
- 프런트 데스크에서 체크인을 완료하기 전에 사유를 검토합니다.
장기 숙박 차단의 경우 Show Details에 숙박일 수, 임계값 및 숙박 날짜가 포함됩니다.
임계값은 활성화된 Pre-arrival, Self Check-In 또는 Assisted Check-In 정책에서 가져옵니다.
호텔 결제 차단의 경우 Command Center에 직원 전용 hotel_payment 사유가 표시됩니다.
게스트에게 표시되는 메시지는 안전한 호텔 정책 힌트로 유지됩니다.
이 진단 정보는 직원 전용이며 게스트에게 표시되는 메시지에는 절대 나타나지 않습니다.
알림에 원시 내부 텍스트가 표시되면 스크린샷을 저장하고 지원팀에 문의합니다.
0박 예약은 이 조회 알림을 생성하지 않습니다. 완료가 중지되면 Day use를 활성화하고 객실 배정을 다시 시도합니다.
예약 조회가 너무 오래 걸림
보이는 현상: 예약 조회가 대기한 후 일시적인 서비스 오류가 표시됩니다.
발생 원인: AVA가 응답이 느린 PMS 예약 창을 새로 고치는 중입니다. AVA가 요청 대기를 중지한 후에도 새로 고침이 계속될 수 있습니다. 완료하는 데 최대 5분이 걸릴 수 있습니다.
해결 방법:
-
새로 고침이 완료될 때까지 몇 분 기다립니다.
-
AVA를 새로고침합니다.
-
예약 조회를 다시 시도합니다.
-
조회가 계속 실패하면 PMS에서 예약을 확인합니다.
-
PMS가 응답한 후에도 같은 오류가 다시 표시되면 지원팀에 문의합니다.
✓ AVA가 완료된 새로 고침을 사용하고 예약을 표시해야 합니다.
이 메시지는 예약이 없다는 뜻이 아닙니다. 새로 고침이 진행 중인 동안 두 번째 예약을 생성하지 마세요.
조기 ACI 체크인에 확인 메시지가 표시됨
보이는 현상: 확인된 ACI 직원 기기에 Override check-in time? 경고가 표시됩니다. 허용되는 체크인 날짜와 시간이 적용된 기준으로 표시됩니다.
해결 방법:
- 예약 및 객실 세부 정보를 확인합니다.
- 허용되는 체크인 날짜와 시간을 검토합니다.
- 이른 도착을 승인하려면 Override and check in을 선택합니다.
- 게스트가 기다려야 하면 Cancel을 선택합니다.
확인된 ACI 직원만 이 재정의를 승인할 수 있습니다. 허용된 시간까지 Self Check-In 및 Pre-arrival은 계속 차단됩니다.
조회 후 0박 체크인이 중지됨
보이는 현상: AVA가 당일 예약을 찾았지만 객실 배정이 중지됩니다.
이유: Day use가 비활성화되어 있습니다.
해결 방법:
- Settings → Check-In을 엽니다.
- Day use를 켭니다.
- 구성된 day-use 시간을 확인합니다.
- Save를 클릭합니다.
- 예약을 새로고침하고 체크인을 다시 시도합니다.
조기 ACI 확인으로 비활성화된 Day Use 정책을 우회할 수 없습니다.
같은 이름의 예약 그룹화에 기기 확인 필요
보이는 현상: 같은 이름의 예약 그룹화를 계속할 수 없습니다. AVA는 예약을 찾을 수 없음 모달을 여는 대신 인라인으로 직원 기기 확인 메시지를 표시합니다.
이유: 수동 그룹화에는 확인된 ACI 직원 자격 증명이 필요합니다.
해결 방법:
- 직원 Assisted Check-In (ACI) 페이지를 열었는지 확인합니다.
- 브라우저가 사용하려는 직원 기기인지 확인합니다.
- Settings → Kiosk를 열고 일치하는 키오스크 행을 선택합니다.
- Re-verify staff device를 선택합니다.
- 동일한 실제 기기에서 확인을 완료합니다.
- ACI를 새로고침하고 그룹화를 다시 시도합니다.
확인 메시지는 자격 증명이 없거나 유효하지 않거나 잘못된 역할에 할당되었거나 다른 merchant에 연결된 경우 표시될 수 있습니다. 그룹화 요청은 보호된 상태로 유지되며 확인되지 않은 자격 증명으로 재시도되지 않습니다. 활성 ACI 예약 목록을 불러오거나 새로고침하기 전에 직원 기기를 확인해야 합니다. 상태를 변경하는 ACI 체크인 작업에도 정확히 확인된 직원 자격 증명이 필요합니다.
체크인을 위해 숙소가 구성되지 않음
보이는 현상: 게스트에게 "Self check-in is not available at this property right now."가 표시됩니다. 직원에게는 "This property is not configured for check-in yet."가 표시됩니다.
이유: 숙소에 merchant 레코드 또는 활성 PMS 통합이 없습니다. 이는 예약 누락이 아니라 숙소 설정 문제입니다.
해결 방법:
-
AVA에서 올바른 호텔을 선택했는지 확인합니다.
-
Settings → Essentials → PMS Integration을 엽니다.
-
숙소의 PMS를 연결하거나 AVA PMS 설정을 완료합니다.
-
연결이 성공적으로 저장된 후 예약 조회를 다시 시도합니다.
✓ 설정이 완료되면 게스트에게 일반적인 예약 조회 화면이 표시되어야 합니다.
숙소가 이미 구성되어 있어야 한다면 AVA 관리자에게 문의합니다.
반복 조회 후 단일 기기 ACI 여정 오류
보이는 현상: 예약을 다시 검색한 후 단일 기기 ACI가 중지됩니다. "Unable to bind the assisted check-in journey to this staff device."가 표시될 수 있습니다.
해결 방법:
- Staff Access에서 예약 조회를 한 번 다시 수행합니다.
- 객실 카드가 다시 로드될 때까지 기다립니다.
- 확인된 직원 기기에서 체크인을 계속합니다.
- 여정이 계속 차단되면 AVA를 새로고침합니다.
오류가 계속되면 예약 번호와 시간을 적어 지원팀에 문의합니다.
조회 저장 중 예약이 변경됨
보이는 현상: 확인된 직원 데스크에 "Reservation changed while it was being saved. Try again."이 표시됩니다.
발생 원인: PMS 조회 중 다른 데스크 또는 작업이 예약을 변경했습니다.
AVA는 더 최신의 체크인, 게스트 또는 객실 출입 정보를 보호합니다. 이전 조회 결과는 해당 정보 위에 저장되지 않습니다.
해결 방법:
-
다른 데스크에서 현재 작업을 완료할 때까지 기다립니다.
-
AVA에서 예약을 새로고침합니다.
-
Staff Access에서 조회를 다시 시작합니다.
-
체크인을 계속하기 전에 최신 예약 세부 정보를 검토합니다.
✓ 새 조회는 최신 예약 및 PMS 정보를 확인합니다.
이 보호 기능은 확인된 Check-in Connect 직원 데스크에 적용됩니다. Self Check-In 및 게스트 웹 조회는 기존 조회 동작을 유지합니다.
한 번 다시 시도한 후에도 메시지가 다시 표시되면 지원팀에 문의합니다. 예약 번호, 데스크 이름, 시간 및 전체 오류 메시지를 포함합니다.
체크인 화면이 오래됨
보이는 현상: "This screen is out of date."와 함께 체크인이 중지됩니다. "Review who is arriving before checking in."도 표시될 수 있습니다.
발생 원인: 직원 브라우저 탭에 이전 AVA 버전이 로드되었습니다. 배포 중 탭이 열린 채로 있으면 발생할 수 있습니다.
해결 방법:
-
현재 게스트의 작업을 완료하거나 안전하게 일시 중지합니다.
-
AVA 페이지를 새로고침합니다.
-
도착하는 게스트를 검토합니다.
-
Check In을 선택하기 전에 도착 검토를 완료합니다.
-
체크인을 다시 시도합니다.
✓ 최신 화면이 로드되고 도착 검토가 완료되면 체크인이 계속되어야 합니다.
새 버전 배너가 표시되면 현재 게스트가 안전해진 후 새로고침합니다. 직원의 선택 또는 도착 세부 정보가 아직 진행 중일 때는 새로고침하지 않습니다.
체크인 중 도착 검토가 변경됨
보이는 현상: "Something changed while you were checking in. Please try checking in again."이라는 현지화된 메시지가 표시됩니다.
발생 원인: 다른 게스트, PMS 또는 이전 탭에서 도착 선택이 변경되었습니다.
실패한 시도에서는 게스트 데이터가 저장되지 않으며 PMS로 체크인이 전송되지 않습니다. 이 충돌이 발생하면 AVA가 도착 선택을 한 번 자동으로 검토합니다. 재시도에는 최신 객실 및 도착 정보가 포함됩니다.
해결 방법:
-
AVA가 자동 재시도를 완료할 때까지 기다립니다.
-
AVA가 다시 요청하면 도착하는 게스트를 검토합니다.
-
선택한 객실과 도착 세부 정보를 확인합니다.
-
Check In을 한 번 다시 선택합니다.
✓ 대부분의 오래된 도착 충돌은 직원의 추가 조치 없이 계속 진행됩니다. ✓ 도착 범위가 변경되면 AVA가 업데이트된 선택을 확인하도록 요청합니다.
재시도 후에도 같은 메시지가 표시되면 Check In을 계속 누르지 않습니다. 예약을 새로고침하고 현재 도착 선택을 검토합니다. 수동으로 한 번 다시 시도한 후에도 오류가 돌아오면 지원팀에 문의합니다.
번역이 제공되는 경우 게스트가 선택한 체크인 언어로 메시지가 표시됩니다. 다시 시도한 후에는 현재 탭을 사용하고, 오래된 중복 탭은 닫습니다.
PMS 체크인 결과가 불명확함
보이는 현상: 첫 체크인 시도가 멈춘 것처럼 보입니다. PMS가 체크인을 완료했을 수 있는데 객실 배정이 차단되는 경우도 있습니다.
발생 원인: PMS 응답이 중단되었거나 불명확했습니다. AVA가 응답을 받기 전에 PMS가 체크인을 완료했을 수 있습니다.
해결 방법:
-
PMS에서 예약을 엽니다.
-
게스트가 이미 체크인했는지 확인합니다.
-
AVA에서 예약을 새로고침합니다.
-
도착 결정과 선택한 객실을 검토합니다.
-
Proceed to Check-In을 다시 선택합니다.
✓ AVA는 계속 진행하기 전에 기존 PMS 체크인을 조정합니다. ✓ AVA는 해당 객실의 객실 배정을 반복하지 않습니다.
PMS에 게스트가 아직 체크인하지 않은 것으로 표시되면 AVA는 일반적인 객실 배정 흐름을 계속합니다. PMS를 사용할 수 없으면 복구될 때까지 기다린 후 다시 시도합니다.
공유 객실 게스트가 계속 대기 중으로 표시됨
보이는 현상: 공유 Opera 객실의 한 게스트는 도착 처리되었지만 다른 게스트는 계속 대기 중으로 표시됩니다.
이유: 게스트들이 하나의 객실 공유에 대해 서로 다른 PMS 레코드를 사용합니다. AVA는 이제 해당 레코드 전체에서 확인된 도착 상태를 조정합니다.
해결 방법:
-
Opera에서 객실 공유를 엽니다.
-
예상되는 모든 게스트가 In House인지 확인합니다.
-
AVA에서 예약을 새로고침합니다.
-
현재 확인된 직원 기기 또는 예약 범위 세션에서 다시 시도합니다.
✓ AVA는 PMS 체크인을 반복하지 않고 일치하는 게스트 도착 레코드를 업데이트합니다.
Opera에 게스트가 In House로 표시되지 않으면 먼저 PMS 도착 처리를 완료합니다. 객실 공유는 다중 객실 그룹으로 결합되지 않습니다.
예약 조회는 성공했지만 등록을 계속할 수 없음
보이는 현상: AVA가 예약을 찾았지만 이후 등록이 중지됩니다.
확인 오류 또는 403 메시지가 표시될 수 있습니다.
이유: 예약 조회 후 여정 확인에 실패했습니다. AVA는 예약 결과를 유지하지만 등록에 실패한 자격 증명은 신뢰하지 않습니다.
해결 방법:
- 화면에 표시된 예약을 선택된 상태로 유지합니다.
- AVA에서 요청하면 현재 직원 기기를 확인합니다.
- 차단된 등록 작업을 한 번 다시 시도합니다.
- 남아 있는 서류, 이름, Company 또는 기기 요구사항을 완료합니다.
자격 증명이 오래되었거나 폐기되었거나 다른 호텔에 연결되어 있으면 기기를 다시 확인합니다. Company 정책이 달라도 확인된 여정 출처가 필요합니다. 예약 조회는 성공했지만 등록이 계속 차단되면 지원팀에 문의합니다.
오래된 세션 후 두 기기 서류 재시도
보이는 현상: 두 기기 ACI 서류 업로드가 이전에 실패했습니다.
다른 직원 세션에서 다시 시도하면 403 여정 오류가 표시됩니다.
이유: 이전 브라우저 세션 또는 키오스크 귀속 정보가 오래되었습니다. AVA는 보존된 업로드가 요청과 일치하면 실패한 서류 작업을 복구할 수 있습니다.
해결 방법:
-
영향을 받은 예약을 선택된 상태로 유지합니다.
-
확인된 ACI 직원 기기에 로그인되어 있는지 확인합니다.
-
현재 직원 세션에서 동일한 서류 할당을 다시 시도합니다.
-
복구하는 동안 연결된 게스트 태블릿을 사용할 수 있도록 준비해 둡니다.
✓ AVA는 현재 두 기기 여정을 복원하기 전에 보존된 실패 업로드를 확인합니다. ✓ AVA는 복구된 할당을 저장하기 전에 서류 적격성을 다시 확인합니다.
다른 직원 세션이 현재 태블릿을 사용 중이면 해당 체크인이 완료될 때까지 기다립니다. 다른 게스트 또는 직원 세션이 사용 중인 태블릿을 옮기지 않습니다. 서류가 더 이상 적격하지 않으면 일반적인 흐름을 통해 서류를 다시 업로드합니다.
체크인 전에 청구 검토 필요
보이는 현상: 예약 조회 후 게스트에게 프런트 데스크 검토 메시지가 표시됩니다. 게스트는 객실 또는 결제 단계로 계속 진행할 수 없습니다.
이유: Mews 숙박 정책이 일치했지만 Mews가 요금을 분류하지 못했습니다. AVA는 저장된 잔액을 사용하거나 확인되지 않은 금액을 받지 않습니다.
해결 방법:
- Staff Access를 통해 예약을 엽니다.
- Mews 요금, 포함 상품 및 전체 청구서를 검토합니다.
- Settings → Payment → Accommodation Charge Policies에서 일치하는 값을 확인합니다.
- Mews 동기화가 완료된 후 예약을 새로고침합니다.
- 전체 Mews 청구서로 결제 금액을 확인합니다.
- 검토가 계속 필요하면 프런트 데스크 직원에게 체크인을 완료하도록 요청합니다.
이 조회 차단은 호텔이 체크인 시 객실 요금을 받는 경우에 표시됩니다. 등록 전용 및 키 발급 흐름은 이 확인으로 차단되지 않습니다.
Mews 포함 상품 검토 필요
보이는 현상: 객실 패키지 면제가 일치한 후 Mews 청구 검토가 필요합니다.
이유: AVA가 상품 분류를 입증할 수 없습니다.
객실 숙박 상품에 연결된 서비스 요금은 Mews가 Once로 보고했다는 이유만으로 검토를 유발하지 않아야 합니다. 검토가 계속되면 분류되지 않은 다른 상품이나 청구서 불일치를 확인합니다.
해결 방법:
- Staff Access를 통해 예약을 엽니다.
- Mews에서 요금, 포함 상품 및 전체 청구서를 검토합니다.
- Settings → Payment → Accommodation Charge Policies에서 일치하는 값을 확인합니다.
- Mews 동기화가 완료된 후 예약을 새로고침합니다.
- 확인되지 않은 금액을 받지 않습니다.
- 프런트 데스크 직원에게 전체 Mews 청구서를 검토하도록 요청합니다.
Opera 추가 게스트 결제 거부
보이는 현상: Insert Guests가 실패하고 AVA에 게스트에게 안전한 결제 방법 메시지가 표시됩니다. 직원은 오류 정보에서 Opera의 결제 방법 세부 정보를 확인할 수 있습니다.
이유: 결제 방법이 예약에 활성화되어 있지 않아 Opera가 추가 게스트를 거부했습니다.
해결 방법:
- Opera에서 예약 및 결제 방법 설정을 엽니다.
- 예약에 사용할 결제 방법을 활성화하거나 활성화된 방법을 선택합니다.
- AVA로 돌아가 영향을 받은 서류 할당을 다시 시도합니다.
- 체크인을 계속하기 전에 예약에 게스트가 표시되는지 확인합니다.
Opera 동반 게스트가 연결되지 않음
보이는 현상: 서류 할당 후 동반 게스트가 표시되지 않습니다.
이유: AVA는 프로필을 생성하기 전에 최신 Opera 예약을 확인합니다. 정확히 하나의 명시적 주 게스트와 사용할 수 있는 프로필 ID가 있어야 합니다. Opera는 연결을 확인하기 전에 프로필을 생성할 수도 있습니다. AVA는 생성된 프로필을 기록하므로 정상적인 재시도로 중복이 생성되지 않습니다.
해결 방법:
-
AVA에서 예약을 새로고침합니다.
-
예약에 주 게스트가 표시되는지 확인합니다.
-
Opera에 프로필 ID가 있는 주 게스트가 정확히 한 명 표시되는지 확인합니다.
-
서류 할당을 한 번 다시 시도합니다.
-
프로필을 수동으로 만들기 전에 Opera를 확인합니다.
✓ 기존 주 예약 아래에 게스트가 표시되어야 합니다.
주 게스트가 없거나 중복되거나 일치하지 않으면 Opera 관리자에게 문의합니다. Opera에서 게스트가 계속 누락되거나 두 번 이상 표시되면 지원팀에 문의합니다.
Opera가 프로필 생성을 확인할 수 없어 AVA에 충돌이 표시되면 반복해서 재시도하지 마세요. Opera를 확인한 다음 조정을 위해 지원팀에 문의합니다.
Opera 게스트 프로필이 교체됨
보이는 현상: 도착 또는 체크인 중 AVA에 "Guest reservation membership is unresolved"가 표시됩니다.
이유: 다른 Opera 시스템이 예약의 주 게스트 프로필을 교체했습니다. 이전 프로필 ID가 더 이상 예약을 소유하지 않습니다.
Opera가 다음 조건을 모두 확인하면 AVA가 이 상황을 복구할 수 있습니다.
- 이전 프로필이 선택한 예약에 속함
- 예약에 주 게스트가 정확히 한 명 있음
- 교체 프로필이 미할당 주 게스트 프로필 중 유일함
- Opera 활동 로그에 이전 프로필이 교체 프로필로 변경된 기록이 있음
이 조건이 명확하지 않으면 AVA는 추측하지 않습니다. 게스트 신원과 체크인 안전을 보호하기 위해 예약을 미해결 상태로 유지합니다.
해결 방법:
- AVA에서 예약을 새로고침합니다.
- Proceed to Check-In을 다시 선택합니다.
- AVA가 Opera 확인을 완료할 때까지 기다립니다.
- 계속 진행하기 전에 예약 및 게스트 세부 정보를 확인합니다.
- 오류가 계속되면 Opera에서 예약을 엽니다.
- Opera 관리자에게 활동 로그에서 프로필 교체를 확인하도록 요청합니다.
- 예약 번호와 오류 스크린샷을 첨부하여 지원팀에 문의합니다.
Opera를 확인하기 전에 다른 게스트 프로필을 만들거나 일괄 체크인을 진행하지 않습니다. 체크인 중에도 동일한 해결 절차가 다시 실행되며 안전하지 않은 프로필 재연결을 방지합니다.
이 복구는 주 게스트 프로필 교체에만 적용됩니다. 동반 게스트 프로필 교체는 여전히 지원팀 검토가 필요합니다.
SiteMinder 다중 객실 게스트 목록이 중복되어 보임
보이는 현상: 연결된 Opera 객실에 동반 게스트가 반복되거나 예상보다 많은 게스트 슬롯이 표시됩니다.
이유: SiteMinder는 다중 객실 예약에서 동반 프로필 하나를 반복할 수 있습니다. Opera는 각 사본에 서로 다른 프로필 ID를 부여할 수 있습니다.
해결 방법:
- AVA에서 예약을 새로고침합니다.
- 객실이 동일한 명시적 SiteMinder 예약 그룹에 속하는지 확인합니다.
- Opera에서 각 객실에 선언된 성인 점유 수를 비교합니다.
- 게스트 서류 할당을 한 번 다시 시도합니다.
- 반복된 게스트를 대신할 프로필을 수동으로 만들지 않습니다.
AVA는 정확하고 모호하지 않은 SiteMinder 패턴만 조정합니다. 어린이, 객실 공유 게스트, 종료 객실, 일부만 반복된 항목 또는 충돌하는 신원 정보가 있으면 원래 게스트 목록을 유지합니다. 새로고침 후에도 조치 가능한 중복 슬롯이 남아 있으면 지원팀에 문의합니다.
이름 불일치: 먼저 할 일
- 여행 서류로 게스트의 신원을 확인합니다.
- 지원되는 편집 흐름 또는 PMS에서 예약 이름을 법적 이름으로 수정합니다.
- 변경 내용이 AVA에 동기화되는지 확인합니다.
- 이름이 일치하면 체크인을 계속합니다.
전체 절차 열기: 체크인 차단: 이름 불일치
사용자 친화적인 메시지로 객실 배정 실패
보이는 현상: 게스트가 Information 모달에서 사용자 친화적인 객실 사용 불가 메시지를 봅니다.
이유: AVA가 PMS에서 요청한 객실을 배정하지 못했습니다. 객실 충돌 또는 지속적인 PMS 오류일 수 있습니다.
해결 방법:
- PMS에서 예약을 엽니다.
- 객실이 이미 예약되었거나 차단되어 있는지 확인합니다.
- 객실을 다시 배정하거나 충돌을 해제합니다.
- AVA로 돌아가 체크인을 다시 시도합니다.
✓ PMS 충돌이 계속되는 경우에만 게스트에게 같은 사용자 친화적인 메시지가 다시 표시됩니다.
Opera의 경우 AVA는 일시적인 502, 503 또는 504 이후 배정이 적용되었는지 확인합니다. 객실이 이미 배정되어 있으면 AVA는 추가 요청을 보내지 않고 이를 수락합니다. 아직 배정되지 않았다면 AVA가 기다린 후 자동으로 배정을 다시 시도합니다.
현재 작업이 완료될 때까지 기다린 후 Retry를 선택합니다.
객실 배정 중 PMS를 일시적으로 사용할 수 없음
보이는 현상: 객실을 배정하는 동안 AVA에 PMS를 일시적으로 사용할 수 없다는 메시지가 표시됩니다.
이유: PMS가 시간 내에 객실 배정 요청에 응답하지 않았습니다. Opera의 경우 AVA가 안전한 복구 시도를 완료한 후 이 메시지가 표시될 수 있습니다. AVA는 이를 실제 객실 준비 문제와 별도로 처리합니다.
해결 방법:
-
PMS를 사용할 수 있는지 확인합니다.
-
PMS에서 예약과 객실 배정이 변경되지 않았는지 확인합니다.
-
PMS가 응답한 후 AVA를 새로고침합니다.
-
객실 배정을 한 번 다시 시도합니다.
✓ AVA가 배정을 완료하거나 새롭고 구체적인 사유를 표시해야 합니다.
AVA는 이 일시적인 중단에 대해 객실 미준비 알림을 보내지 않습니다. 이후 확인에서 객실이 실제로 준비되지 않았다고 판단되면 해당 알림을 사용할 수 있습니다.
PMS 예약 변경 진행 중
보이는 현상: 객실 배정 또는 최종 체크인에 PMS_RESERVATION_MUTATION_IN_PROGRESS가 표시됩니다.
이유: PMS 업데이트가 아직 예약을 변경하는 중입니다. 게스트 확인, 서류 업로드 또는 다른 예약 업데이트와 잠시 겹칠 수 있습니다. Opera의 경우 레코드 잠금이 최종 체크인에 영향을 주기 전에 객실 배정이 이미 성공했을 수 있습니다. AVA는 객실 배정 및 최종 체크인 중 이 정확한 일시적 충돌을 최대 네 번 다시 시도합니다.
해결 방법:
-
PMS 업데이트가 완료될 때까지 잠시 기다립니다.
-
AVA에서 예약을 새로고침합니다.
-
영향을 받은 단계를 한 번 다시 시도합니다.
✓ PMS가 예약을 해제하면 영향을 받은 단계가 계속 진행되어야 합니다.
네 번의 시도 후에도 코드가 남아 있으면 AVA는 쓰기를 중지하고 다시 시도할 수 있는 충돌을 표시합니다. 객실을 이용할 수 없다고 판단하지 마세요. 최종 체크인을 반복하기 전에 Opera를 확인합니다. 예약 번호와 오류 스크린샷을 첨부해 지원팀에 문의합니다.
체크인 중 PMS 요청 한도 초과
보이는 현상: 객실 배정 또는 최종 체크인에 시간이 더 걸린 후 계속 진행되거나 사용자 친화적인 오류가 표시됩니다.
이유: PMS가 일시적으로 요청량을 제한했습니다. AVA는 해당 작업 중 이 일시적인 거부를 자동으로 다시 시도합니다.
해결 방법:
-
현재 작업이 완료될 때까지 기다립니다.
-
체크인이 계속되면 남은 단계를 완료합니다.
-
AVA에 사용자 친화적인 오류가 표시되면 PMS에서 예약과 객실 배정을 확인합니다.
-
AVA를 새로고침한 다음 해당 단계를 한 번 다시 시도합니다.
✓ 짧은 PMS 요청 한도 초과는 게스트를 프런트 데스크로 보내지 않아도 해소되어야 합니다.
PMS가 다른 요청을 수락한 후에도 오류가 계속 반환되면 지원팀에 문의합니다.
Opera 구성 스위트가 준비되지 않음
보이는 현상: Opera suite가 준비되지 않았거나 사용 가능한 객실이 없어 체크인이 중지됩니다.
이유: Opera는 연결된 구성 객실로 스위트를 나타냅니다. AVA는 스위트를 배정하기 전에 연결된 모든 객실을 확인합니다.
해결 방법:
- Opera에서 suite를 엽니다.
- 모든 구성 객실의 점유 상태와 준비 상태를 확인합니다.
- Opera 또는 Housekeeping에서 점유 중이거나 더럽거나 이용할 수 없는 구성 객실을 해결합니다.
- Opera에서 스위트가 정확한 구성 객실 매핑을 사용하는지 확인합니다.
- AVA로 돌아가 Refresh를 클릭하고 체크인을 다시 시도합니다.
AVA가 스위트를 자동으로 선택했지만 정확한 구성을 확인할 수 없다면 Opera 관리자에게 매핑 수정을 요청합니다.
구성 객실 하나가 점유 중이면 AVA는 해당 상태를 주된 사유로 유지합니다. 이를 통해 직원이 다른 준비 문제보다 먼저 진행 중인 숙박을 해결할 수 있습니다.
늦게 도착한 Opera 객실 공유 게스트에게 객실 미준비가 표시됨
보이는 현상: 주 게스트가 체크인한 후 연결된 객실 공유 게스트가 도착합니다. AVA에 Room not ready 또는 No rooms available이 표시됩니다.
이유: Opera는 점유 중인 객실이 동일한 숙박에 속하는지 확인해야 합니다. 연결이 확인되면 AVA는 다른 객실을 검색하지 않고 해당 객실을 유지합니다.
해결 방법:
- AVA에서 예약을 새로고침합니다.
- Opera에서 주 게스트와 객실 공유 게스트의 연결을 확인합니다.
- Opera 또는 Housekeeping에서 객실 상태를 확인합니다.
- 체크인을 다시 시도합니다.
이 점유 객실 사례에서는 Pickup, Clean, Inspected 및 Dirty를 허용합니다. Out of Order 및 Out of Service는 계속 차단됩니다. 다른 숙박이 객실을 점유하고 있다면 다시 시도하기 전에 Opera에서 객실 배정을 해결합니다.
eZee Assign-Room에 사용 가능한 객실이 없음
보이는 현상: 객실 선택기가 비어 있거나 assign-room 후에도 게스트가 계속 진행할 수 없습니다.
이유: AVA는 eZee에서 깨끗한 객실만 제공합니다. 일치하는 객실이 모두 더러우면 아무것도 표시되지 않습니다.
해결 방법:
- Housekeeping을 엽니다.
- 일치하는 객실 하나를 Clean으로 표시합니다.
- 예약으로 돌아가 Refresh를 클릭합니다.
- Assign Room을 다시 시도합니다.
✓ 객실 선택기에 적합한 객실이 하나 이상 표시되어야 합니다.
키오스크에서 게스트 보호 거부가 표시됨
보이는 현상: 키오스크에 짧은 거부 메시지는 표시되지만 상세 규칙 이름은 표시되지 않습니다.
이유: AVA는 게스트 화면에서 정확한 적격성 세부 정보를 숨깁니다.
해결 방법:
-
Command Center에서 예약을 엽니다.
-
View Details를 선택합니다.
-
Detailed Event Log를 엽니다.
-
실패한 예약 이벤트에서 Show Details를 선택합니다.
-
표시된 구조화된 사유를 확인하고 다음 단계를 결정합니다.
✓ 정확한 사유는 직원 도구에만 남고 키오스크에는 계속 게스트 보호 문구가 표시됩니다.
직원 기기에서 자세한 ACI 오류 보기
보이는 현상: Assisted Check-In 작업이 실패하지만 게스트에게 표시되는 메시지는 간단합니다.
이유: AVA는 내부 운영 세부 정보를 게스트에게 노출하지 않습니다.
해결 방법:
-
직원 기기에 Ready 또는 확인 완료 상태가 표시되는지 확인합니다.
-
해당 직원 기기에서 실패한 ACI 작업을 열어 둡니다.
-
직원 오류 패널에서 정확한 코드, 사유 및 메시지를 확인합니다.
-
메시지 아래에 표시된 안전한 운영 세부 정보를 검토합니다.
-
표시된 PMS, 객실, 예약 또는 키카드 문제를 해결합니다.
-
실패한 작업을 한 번 다시 시도합니다.
✓ 게스트 기기에는 계속 게스트 보호 메시지가 표시됩니다.
AVA는 확인된 직원 자격 증명에 대해서만 이러한 세부 정보를 표시합니다. 해당 자격 증명은 활성 호텔 및 키오스크와 일치해야 합니다. 이 세부 정보는 객실 배정, 게스트 처리, 키카드, 체크아웃 및 예약 새로고침 오류에 표시될 수 있습니다.
2개 기기를 사용하는 ACI에서는 연결된 게스트 태블릿으로 직원 세부 정보가 전달되지 않습니다. 게스트 태블릿에만 표시되는 오류는 직원 기기에 복제되지 않습니다.
직원 패널에 세부 정보가 표시되지 않으면 직원 기기를 다시 확인합니다. 그런 다음 직원 기기에서 작업을 다시 수행합니다.
Cloudbeds 객실 충돌
보이는 현상: "cannot check this reservation in until ... assigned to this room is checked out" 오류로 체크인이 실패합니다.
해결 방법:
- Cloudbeds에서 해당 예약을 엽니다.
- 같은 객실에 여전히 배정된 예약을 찾습니다.
- 해당 숙박을 체크아웃하거나 예약 중 하나를 빈 객실로 옮깁니다.
- AVA로 돌아가 Operations View에서 Refresh를 클릭합니다.
- 체크인을 다시 시작합니다.
✓ 객실 충돌이 제거되면 체크인을 계속할 수 있어야 합니다.
Cloudbeds 이용 가능 여부 거부
보이는 현상: PMS_OCCUPANCY_UNAVAILABLE_FOR_DATES와 함께 체크인이 중지됩니다.
메시지에서 날짜를 변경하거나 객실 수를 줄이라고 요청합니다.
이유: Cloudbeds가 선택한 날짜 또는 객실 이용 가능 여부를 수용할 수 없습니다. 이는 게스트의 성인 또는 아동 구분이 잘못되었다는 뜻이 아닙니다.
해결 방법:
-
같은 체크인 요청을 반복해서 재시도하지 않습니다.
-
Cloudbeds에서 예약 날짜, 객실 유형 및 이용 가능 여부를 확인합니다.
-
적절하다면 Cloudbeds에서 이용 가능한 옵션으로 변경합니다.
-
AVA를 새로고침하고 체크인을 한 번 다시 시도합니다.
✓ Cloudbeds가 이용 가능한 옵션을 승인하면 체크인이 계속 진행되어야 합니다.
AVA는 이를 일시적인 서비스 오류가 아닌 Cloudbeds 이용 가능 여부 거부로 보고합니다. 전체 복구 절차는 Cloudbeds 점유 가이드를 사용하세요.
게스트 수 동기화 재시도 한도
보이는 현상: 일시적인 게스트 수 실패가 반복된 후 게스트에게 직원 지원 안내가 표시됩니다.
직원에게 PMS_GUEST_COUNT_RETRY_EXHAUSTED가 표시될 수 있습니다.
이유: 게스트에게 표시되는 네 번의 시도 후에도 PMS 또는 네트워크가 복구되지 않았습니다.
해결 방법:
-
게스트에게 같은 단계를 다시 시도하도록 요청하지 않습니다.
-
직원 지원 또는 수동 체크인 절차를 계속 진행합니다.
-
등록된 게스트 수와 PMS 예약을 비교합니다.
-
수가 일치하지 않으면 PMS 예약을 수정합니다.
-
직원 흐름에서 허용하는 경우 보류 중인 게스트 수 변경을 재개합니다.
✓ 끝없는 재시도 루프 없이 직원 지원을 통해 체크인을 계속할 수 있습니다.
Cloudbeds 공유 folio 루프
보이는 현상: 예약 조회에 "Unable to find the reservation. Please try again or contact support."가 표시됩니다. Proceed with Selected Reservation을 선택하면 같은 오류로 돌아갑니다.
이유: Cloudbeds가 공유 숙박에 사용할 객실별 folio 하나를 선택하지 못했습니다. AVA는 이제 체크인을 중지하는 대신 예약 전체 folio로 대체합니다.
해결 방법:
- 예약을 새로고침합니다.
- Proceed with Selected Reservation을 다시 시도합니다.
- 루프가 반복되면 예약이 여전히 Cloudbeds에서 활성 상태인지 확인합니다.
- 예약이 계속 실패하면 지원팀에 문의합니다.
✓ 예약이 정상적으로 새로고침되면 체크인을 계속할 수 있어야 합니다.
게스트 이동 조정 실패
보이는 현상: 게스트를 객실 사이로 이동한 뒤 체크인이 멈추고 AVA에 Guest is not attached to the source reservation가 표시됩니다.
이유: AVA의 게스트 이동이 원본 또는 대상 예약의 PMS 상태와 더 이상 일치하지 않습니다.
해결 방법:
- 예약을 새로고침합니다.
- PMS에서 원본 예약을 엽니다.
- 게스트가 여전히 그곳에 연결되어 있는지 확인합니다.
- 대상 객실이 여전히 올바른지 확인합니다.
- 필요하면 게스트를 다시 이동합니다.
- 체크인을 다시 시도합니다.
✓ PMS 상태가 다시 일치하면 게스트 이동이 정상적으로 진행됩니다.
이동한 주 게스트로 인해 객실이 차단됨
보이는 현상: 주 게스트가 다른 객실로 이동한 후 객실이 계속 차단됩니다.
발생 원인: AVA는 이동한 게스트가 원래 객실을 대표할 때까지 기다립니다. 이동한 게스트는 먼저 대상 객실에서 등록과 서명을 완료해야 합니다.
해결 방법:
- 대상 객실을 엽니다.
- 이동한 게스트가 등록과 서명을 완료했는지 확인합니다.
- 대상 객실이 준비되었는지 확인합니다.
- 예약을 새로고침합니다.
- 게스트가 떠난 객실의 체크인을 다시 시도합니다.
✓ AVA는 이동한 게스트를 해당 객실의 대표 게스트로 사용해야 합니다.
모든 객실을 함께 체크인하는 경우 AVA는 동일한 체크인 중에 대표 게스트 처리를 적용합니다. 대상 객실이 준비되지 않았거나 이동한 게스트가 아직 대기 중이면 먼저 해당 단계를 완료합니다.
향후 교대를 위한 예방
게스트에게 도착 전에 별명/별칭으로 예약한 경우 알려 달라고 요청합니다.
여전히 해결되지 않나요?
다음 중 하나에 해당하면 success@vouch-technologies.com으로 문의합니다.
- ❌ 충돌을 해결하고 다시 시도한 후에도 객실 배정 메시지가 계속 표시됨
- ❌ Cloudbeds에서 활성 숙박을 확인할 수 없음
- ❌ 체크인이 15분 넘게 계속 차단됨
- ❌ 안정적인 호텔 네트워크에서도 연결 복구가 계속 실패함
공유하면 도움이 되는 정보:
- 전체 오류 메시지 스크린샷
- 예약 확인번호
- 문제가 시작된 시간
- 이미 시도한 조치
- AVA에 표시되는 경우 요청 ID