데이터가 업데이트되지 않음

빠른 해결

대부분의 경우 2~5분이면 해결됩니다. 먼저 Refresh를 누르고, 목록이 여전히 비어 보이면 Settings를 확인하세요.

예약, 객실 상태 또는 게스트 정보가 AVA에서 오래된 것처럼 보일 때 이 가이드를 사용하세요.

자동 재시도

AVA는 일부 짧은 PMS 읽기 요청을 자동으로 다시 시도합니다. 한 번만 발생한 네트워크 오류가 표시되지 않을 수도 있습니다.

Cloudbeds 읽기 공유

여러 직원이 같은 Cloudbeds 데이터를 동시에 요청하면 AVA는 읽기 요청 하나를 공유합니다. 같은 Cloudbeds 접근 오류가 반복되면 AVA는 다음 재시도를 잠시 멈춥니다. 새로고침이 백그라운드에서 끝나는 동안 현재 목록은 계속 표시됩니다.

공유 예약 캐시

예약 목록, Calendar, 체크인/체크아웃 로그는 이제 같은 예약 캐시에서 새로고침됩니다. 체크인, 체크아웃 또는 호텔 전환 후 한 번 새로고침하면 세 화면이 모두 업데이트됩니다.

보이는 현상	원인	조치
예약 대신 Settings 또는 Retry가 표시됨	목록을 불러오기 전에 PMS 설정이 필요함	Settings → Essentials → PMS Integration에서 PMS 설정을 완료함
PMS 자격 증명이 거부되었다고 표시됨	AVA가 저장된 PMS 자격 증명을 사용할 수 없음	Settings → Essentials → PMS Integration에서 PMS 자격 증명을 업데이트함
429 또는 속도 제한 메시지가 표시됨	PMS가 요청을 제한하고 있음	표시된 재시도 시간까지 기다린 뒤 새로고침하고 다시 시도함
429가 발생하는 동안 객실 배정 또는 최종 체크인이 오래 걸림	AVA가 일시적인 PMS 속도 제한을 다시 시도하고 있음	작업이 끝날 때까지 기다립니다. 실패하면 PMS를 확인하고 AVA를 새로고친 뒤 한 번 다시 시도함
같은 Cloudbeds 접근 오류가 바로 다시 나타남	Cloudbeds가 숙소 또는 권한을 차단했고 AVA가 반복 재시도를 늦추고 있음	올바른 Cloudbeds 숙소인지 확인한 뒤 1분 기다렸다가 새로고침함
페이지가 한 번 실패한 뒤 새로고침하면 정상 작동함	AVA가 짧은 PMS 네트워크 문제를 다시 시도함	한 번 새로고침함
예약 작업에 다른 업데이트가 진행 중이라고 표시됨	다른 탭, 기기 또는 직원 업무 흐름에서 같은 예약을 변경하고 있음	해당 작업이 끝날 때까지 기다리고, 예약을 새로고친 뒤 한 번 다시 시도함
객실 배정 또는 최종 체크인에 PMS_RESERVATION_MUTATION_IN_PROGRESS가 표시됨	짧은 PMS 예약 업데이트가 체크인 작업과 겹침	잠시 기다리고 예약을 새로고친 뒤 영향을 받은 단계를 한 번 다시 시도함
이전 게스트 체크아웃 후에도 객실이 점유 중처럼 보임	Streamliner가 아직 최신 예약 스냅샷을 다시 만들지 못함	Refresh를 다시 클릭함
객실 이동 후 게스트 정보가 잘못 표시됨	객실 변경 동기화가 아직 끝나지 않음	이동이 완료된 후 예약을 새로고치고 게스트 업데이트를 다시 시도함
ACI 문서 업로드는 끝났지만 Registration 또는 최종 체크인에 게스트 한도가 표시되거나, Cloudbeds 다객실 예약의 게스트 수가 잘못 표시되거나 객실이 사라짐	PMS 게스트 수가 아직 로컬 객실 총수를 따라가지 못했거나, 부모 예약 업데이트 후 Cloudbeds에 새로고침이 필요함	예약을 새로고친 뒤 몇 분 후 PMS를 다시 확인함
Cloudbeds 점유 편집 또는 체크인에 PMS_RATE_PRESERVATION_SOURCE_TAX_UNSUPPORTED가 표시됨	AVA가 예약 소스의 세금 또는 수수료 규칙을 안전하게 모델링할 수 없어 변경을 종료 상태로 표시함	Cloudbeds에서 소스 규칙을 검토하고 AVA를 새로고친 뒤 수정 후 한 번 다시 시도함
Cloudbeds 점유 편집 또는 체크인에 PMS_OCCUPANCY_UNAVAILABLE_FOR_DATES가 표시됨	성인/아동 구분이 아니라 Cloudbeds가 선택한 날짜 또는 객실 가용성을 거부함	Cloudbeds 가용성을 확인하고 이용 가능한 옵션으로 변경한 뒤 AVA를 새로고치고 한 번 다시 시도함
Cloudbeds 예약 메모에 작은 반올림 차이가 표시됨	Cloudbeds가 예기치 않게 가격을 다시 계산했고 AVA가 대체 요금 보정을 확인함	수동 보정을 등록하지 말고, 반복되면 PMS 관리자에게 알림
게스트 정보 저장 또는 최종 체크인에 영구적인 PMS 게스트 수 거부가 표시됨	PMS가 이 성인/아동 수를 거부했고 AVA는 같은 변경을 다시 실행하지 않음	PMS 사유를 읽고 End session을 선택한 다음 예약 또는 PMS 설정을 수정하고 새 등록을 시작함
게스트 수 동기화가 재시도 한도에 도달함	게스트에게 표시되는 네 번의 시도 후에도 일시적인 PMS 오류가 계속됨	게스트에게 다시 시도하라고 하지 말고 직원 지원 절차를 진행하면서 PMS 게스트 수를 확인함
Mews 게스트 이동에서 동반자 수용량 오류가 보고됨	Mews가 응답을 반환하기 전에 게스트 추가를 적용했을 수 있음	예약을 새로고치고 Mews에서 게스트가 연결되었는지 확인한 뒤 게스트가 없을 때만 다시 시도함
PMS 동기화 실패 후 게스트 문서 또는 셀피가 멈춤	AVA가 이후 업로드를 계속하기 전에 유효한 PMS 게스트 식별자를 기다림	PMS 동기화 오류를 해결하고 페이지를 새로고친 뒤 업로드를 다시 시도함
등록 카드가 AVA에는 표시되지만 PMS에는 표시되지 않음	AVA가 카드를 로컬에 저장하고 비동기 방식으로 전송 중임	PMS 첨부 파일 전송을 열고, 가능해지면 새로고침하거나 Retry를 사용함
Refresh를 다시 클릭한 직후에도 목록이 오래돼 보임	마지막 수동 새로고침이 아직 완전히 안정되지 않음	5초 기다린 뒤 Refresh를 다시 클릭함
목록이 오래돼 보임	PMS가 아직 최신 데이터를 반환하지 않음	Refresh를 클릭함
캘린더 또는 체크인/체크아웃 로그가 오래돼 보임	공유 예약 캐시가 아직 새로고침되지 않음	영향을 받은 페이지에서 Refresh를 클릭함
게스트 또는 객실 변경이 표시되지 않음	PMS 동기화가 지연됨	몇 분 기다렸다가 다시 새로고침함
모든 항목이 비어 보임	페이지 로딩이 완료되지 않음	페이지를 한 번 새로고침함

예약 업데이트가 이미 진행 중임

보이는 현상: 예약 작업에 충돌이 표시되거나 다른 업데이트가 진행 중이라고 표시됩니다. 체크인, 게스트 업데이트, 객실 변경, 결제 또는 문서 업로드 중에 발생할 수 있습니다.

원인: 다른 탭, 기기 또는 직원 업무 흐름에서 같은 예약 컨텍스트를 변경하고 있습니다. AVA는 한 번에 하나의 예약 변경 작업만 허용합니다. 여기에는 하나의 체크인 또는 게스트 이동에 사용되는 연결된 예약도 포함됩니다. 같은 예약의 별칭도 인식합니다.

해결:

1. 같은 작업을 계속 클릭하지 마세요.

2. 다른 직원이나 기기에서 예약을 작업 중인지 확인하세요.

3. 해당 작업이 끝날 때까지 기다리세요.

4. AVA에서 예약을 새로고치세요.

5. PMS에서 예약을 확인한 다음 작업을 한 번 다시 시도하세요.

   ✓ 두 번째 PMS 업데이트를 만들지 않고 완료된 변경이 표시되어야 합니다.

지속적인 충돌을 계속 다시 시도하지 마세요

AVA는 첫 번째 변경이 조정될 때까지 이 보호 기능을 유지합니다. 활성 작업이 없는데 새로고친 후에도 충돌이 남아 있으면 지원팀에 문의하세요. 예약 업무 흐름을 복원하기 전에 지원팀에서 PMS 결과를 확인해야 할 수 있습니다.

객실 배정 충돌

체크인 중 PMS 여권 또는 게스트 업데이트가 객실 배정이나 최종 체크인과 잠시 겹칠 수 있습니다. AVA는 정확한 PMS_RESERVATION_MUTATION_IN_PROGRESS 충돌을 자동으로 다시 시도합니다. 재시도 시간이 끝나도 AVA는 충돌을 영구 실패로 처리하지 않고 다시 시도할 수 있는 상태로 유지합니다. 잠시 기다리고 예약을 새로고친 뒤 영향을 받은 단계를 한 번 다시 시도하세요.

Cloudbeds 다객실 게스트 수

AVA는 이제 부모 Cloudbeds 예약을 업데이트하고 전체 객실 목록을 그대로 유지합니다. 이렇게 하면 게스트 수를 변경하는 동안 다른 객실이 빠지는 것을 막을 수 있습니다. Cloudbeds가 저장을 거부하면 AVA는 재시도를 위해 보류 중인 성인/아동 구분을 유지합니다.

체크인 중 PMS 속도 제한

AVA는 객실 배정 및 최종 체크인 중 일시적인 PMS 429를 다시 시도합니다. PMS가 복구되는 동안 작업에 몇 초가 더 걸릴 수 있습니다. 재시도 예산이 끝나면 AVA는 429를 그대로 노출하는 대신 게스트에게 안전한 오류를 표시합니다. 작업이 끝날 때까지 기다린 다음 PMS를 확인하고 한 번 다시 시도하세요.

ACI 게스트 수 새로고침

ACI에서 AVA는 보류 중인 게스트를 보내기 전에 PMS 게스트 수를 새로고칩니다. 이렇게 하면 다중 게스트 체크인 중 오래된 게스트 한도 오류를 줄일 수 있습니다.

ACI 문서 처리 시점

ACI에서는 문서 스캔이 PMS 점유 상태를 업데이트하지 않습니다. AVA는 Registration 중 보류 중인 게스트가 생성되거나 동기화될 때 수용량을 확인합니다. 최종 체크인 전에 다시 확인합니다. 스캔 후 수용량 또는 요금 오류가 표시되어도 문서는 저장된 상태로 유지됩니다.

게스트 수 조정

일시적인 PMS 또는 전송 오류로 다시 시도할 수 있는 서비스 메시지가 표시될 수 있습니다. 저장 중 PMS가 PMS_RESERVATION_CONCURRENT_MODIFICATION을 반환하면 예약 변경 충돌도 다시 시도할 수 있습니다. AVA는 같은 게스트 수 변경에 대해 게스트에게 최대 네 번의 시도를 허용합니다. 네 번 실패하면 AVA는 재시도 루프를 중지하고 업무 흐름을 직원에게 넘깁니다. 특정 PMS 거부 또는 단순한 409는 해당 변경에 대해 영구적입니다. AVA는 PMS 사유를 보존하고 같은 변경을 다시 실행하지 않습니다. AVA에 게스트 수 조정 안내가 표시되면 End session을 선택하세요. 예약 또는 PMS 설정을 수정한 다음 새 등록을 시작하세요.

게스트 수 업데이트에 수동 검토 필요

보이는 현상: 게스트 정보 저장 또는 최종 체크인에 특정 PMS 거부가 표시됩니다.

원인: PMS가 이 예약의 성인 또는 아동 수를 거부했습니다.

해결:

1. AVA에 표시된 PMS 사유를 읽습니다.

2. PMS에서 예약을 엽니다.

3. 해당 사유에서 확인된 예약 또는 PMS 설정을 수정합니다.

4. AVA에서 End session을 선택합니다.

5. 새 등록을 시작합니다.

   ✓ AVA는 새 등록에서 수정된 게스트 수를 사용합니다.

같은 게스트 수 변경을 계속 다시 시도하지 마세요.

게스트 수 동기화 재시도 한도 도달

보이는 현상: 게스트 수 동기화가 반복해서 실패한 후 게스트에게 직원 지원 안내가 표시됩니다. 직원에게는 PMS_GUEST_COUNT_RETRY_EXHAUSTED가 표시될 수 있습니다.

원인: 게스트에게 표시되는 네 번의 시도 후에도 일시적인 PMS 또는 네트워크 오류가 계속되었습니다. 이것이 게스트 수가 잘못되었다는 뜻은 아닙니다.

해결:

1. 게스트에게 같은 단계를 다시 시도하라고 하지 마세요.

2. 직원 지원 또는 수동 체크인 절차를 계속 진행합니다.

3. 등록된 게스트 수를 PMS의 예약과 비교합니다.

4. 수가 일치하지 않으면 PMS 예약을 수정합니다.

5. 직원 흐름에서 허용할 때 보류 중인 게스트 수 변경을 재개합니다.

   ✓ 게스트 업무 흐름이 일시적인 오류를 반복하지 않습니다.

PMS를 사용할 수 있게 된 후에도 직원 흐름을 재개할 수 없으면 지원팀에 문의하세요.

Cloudbeds 가용성 거부에는 다른 옵션 필요

보이는 현상: Cloudbeds 점유 편집 또는 체크인에 PMS_OCCUPANCY_UNAVAILABLE_FOR_DATES가 표시됩니다. 메시지에서 날짜를 변경하거나 객실 수를 줄이라고 안내합니다.

원인: Cloudbeds가 선택한 날짜 또는 객실 가용성을 수용할 수 없습니다. 게스트 수 자체는 올바를 수 있습니다.

해결:

1. 같은 요청을 계속 다시 시도하지 마세요.

2. Cloudbeds에서 예약 날짜, 객실 유형 및 가용성을 확인합니다.

3. 적절하다면 Cloudbeds에서 이용 가능한 옵션으로 변경합니다.

4. AVA를 새로고치고 한 번 다시 시도합니다.

   ✓ Cloudbeds가 이용 가능한 옵션을 수락하면 점유 변경이 계속되어야 합니다.

일시적인 연결 오류가 아닙니다

AVA는 이 Cloudbeds 거부를 서비스 실패와 별도로 분류합니다. Cloudbeds가 게스트 구분에 대한 요금을 찾을 수 없다고 보고하면 Cloudbeds 점유 상태를 예약할 수 없음을 사용하세요.

Mews 게스트 이동에서 수용량 오류 보고

보이는 현상: Mews 게스트 이동에서 동반자 수용량 오류가 보고됩니다.

원인: Mews는 응답을 반환하기 전에 게스트 추가를 적용할 수 있습니다. AVA가 오류를 표시할 때 게스트가 이미 연결되어 있을 수 있습니다.

해결:

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

2. Mews에서 예약을 확인합니다.

3. 게스트가 연결되어 있으면 다시 추가하지 말고 계속합니다.

4. 게스트가 없으면 이동을 한 번 다시 시도합니다.

5. 한 번 다시 시도한 후에도 게스트가 없으면 지원팀에 문의합니다.

   ✓ 중복 동반자 없이 게스트가 올바른 Mews 예약에 표시되어야 합니다.

Cloudbeds 소스 정책 확인

AVA는 점유 변경 중 Cloudbeds에 객실별 가격 재계산 금지 설정을 보냅니다. AVA는 대체 보정을 사용하기 전에 예약의 정확한 예약 소스를 확인합니다. 완전 포함 백분율 소스 요금에는 여러 요금을 포함한 정확한 총액 재계산 차이가 사용됩니다. 혼합, 고정, 누락 또는 판독 불가 소스 규칙은 점유 변경 전에 계속 중단됩니다. 지원되지 않는 소스 세금 또는 수수료 규칙은 가격 재계산 전에 편집을 중단합니다. Cloudbeds에서 소스를 검토하고 AVA를 새로고친 뒤 수정 후 한 번 다시 시도하세요. AVA는 이 실패에 대한 종료 상태 표시를 저장합니다. 이후 재시도에서는 같은 안내를 유지하며 다른 점유 요청을 보내지 않습니다.

Cloudbeds 반올림 차이에는 수동 보정 불필요

보이는 현상: Cloudbeds 예약 메모에 작은 반올림 차이가 설명되어 있습니다. 메모에는 총액이 변하지 않았다고 표시되거나 예약 금액의 5센트 이내로 정산된 총액이 표시될 수 있습니다.

원인: Cloudbeds가 예기치 않게 가격을 다시 계산한 후 세금 계산을 센트 단위로 반올림했습니다. 이로 인해 객실 매출과 세금 사이에서 센트가 이동하거나 작은 총액 잔액이 남을 수 있습니다.

해결:

1. 예약 메모를 읽습니다.

2. 대체 보정으로 예약 총액이 정산되었는지 확인합니다.

3. 수동 보정을 등록하지 마세요.

4. 반복되면 PMS 관리자에게 알립니다.

   ✓ 차이가 반올림 범위임을 확인한 후 AVA가 예약을 수락합니다.

대체 보정으로 게스트에게 표시되는 총액이 바뀌지 않으면 AVA는 분할 반올림 최대 10센트를 수락합니다. 소스를 고려한 업데이트는 최종 확인 재시도 후 일관된 총액 잔액이 최대 5센트이면 수락할 수 있습니다. 더 크거나 일관되지 않은 차이는 계속 수동 검토가 필요합니다.

PMS 게스트 식별자 보호

게스트가 아직 PMS에 동기화되지 않았다면 AVA는 이후 문서 및 사진 업로드를 잠시 멈춥니다. 이렇게 하면 파일이 잘못된 게스트 프로필에 연결되는 것을 막을 수 있습니다.

로컬 저장과 PMS 전송은 별개

PMS 전송이 완료되기 전에 AVA에 저장된 여행 문서, 게스트 사진 또는 등록 카드가 표시될 수 있습니다. Command Center → View Details에서 첨부 파일별 상태를 확인하세요. 사용 가능한 작업에 표시된 첨부 파일 종류만 다시 시도하세요.

ACI 체크인 중 게스트 한도 도달

보이는 현상: 게스트를 더 추가하거나 ACI 흐름을 완료할 때 "Guest limit reached"가 표시됩니다.

원인: PMS 예약의 게스트 수가 아직 AVA보다 적습니다.

해결:

1. 몇 초 기다렸다가 단계를 한 번 다시 시도합니다.

2. PMS 수가 여전히 뒤처져 보이면 예약을 새로고칩니다.

3. 객실이 이미 PMS 한도에 도달했다면 문서를 기존 게스트에게 배정합니다.

   ✓ PMS 수가 객실 총수와 일치하면 게스트 한도가 해제되어야 합니다.

여기서 시작하기

1. 페이지를 다시 엽니다.

2. Refresh를 클릭합니다.

3. 최신 데이터가 표시되는지 확인합니다.

   ✓ 대부분의 사소한 지연은 한 번 새로고치면 해결됩니다.

PMS 설정 누락 또는 거부됨

AVA가 예약 데이터 대신 설정 메시지를 표시할 때 사용하세요.

보이는 현상: Settings 버튼, Retry 버튼, 설정 필요 메시지 또는 저장된 PMS 자격 증명이 거부되었다는 메시지가 표시됩니다. Opera 숙소의 경우 설정 메시지에 "Opera is not configured for this operation."이 표시될 수 있습니다.

원인: 호텔에서 PMS를 선택했지만 AVA가 아직 해당 자격 증명을 사용할 수 없습니다.

해결:

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

2. 선택한 PMS가 올바른지 확인합니다.

3. 누락된 자격 증명을 추가하거나, 거부된 자격 증명을 업데이트하거나, PMS를 다시 활성화합니다.

4. 변경 사항을 저장합니다.

5. 예약 페이지로 돌아갑니다.

6. Retry 또는 Refresh를 한 번 클릭합니다.

   ✓ PMS 설정이 완료되면 페이지에서 예약을 다시 불러와야 합니다.

새로고침이 멈추는 이유

PMS 설정이 필요하면 AVA는 자동 새로고침 루프를 멈춥니다. 이렇게 하면 페이지가 무한히 다시 로드되는 것을 막을 수 있습니다.

전체 새로고침 강제 실행

일반 새로고침 후에도 페이지가 오래돼 보일 때 사용하세요.

1. 강력 새로고침을 사용합니다.
   • Windows: Ctrl+F5
   • Mac: Cmd+Shift+R
2. 페이지가 완전히 로드될 때까지 기다립니다.
3. 데이터를 다시 확인합니다.

연결 확인

1. 새 탭을 엽니다.
2. 다른 웹사이트를 방문합니다.
3. 다른 사이트도 느리다면 더 안정적인 연결로 전환합니다.

로그아웃 후 다시 로그인

페이지가 여전히 업데이트되지 않을 때 사용하세요.

1. 사용자 메뉴에서 로그아웃합니다.
2. 브라우저를 닫습니다.
3. 다시 로그인합니다.
4. 페이지를 다시 확인합니다.

속도 제한 복구

보이는 현상: 새로고침 후 429 오류 또는 속도 제한 메시지가 표시됩니다.

원인: PMS가 일시적으로 요청량을 제한하고 있습니다. PMS가 재시도 시간을 보내면 AVA는 해당 시간을 유지합니다. 일부 게스트용 체크인, 체크아웃 및 하우스키핑 호출은 짧은 로컬 폭주가 발생하면 몇 초 기다립니다. 이 기능은 AVA 자체 버킷이 잠시 비어 있을 때만 적용됩니다. PMS가 느리면 Cloudbeds 하우스키핑 읽기는 약 10초 후 대기를 멈춥니다. AVA는 오류를 표시하기 전에 해당 읽기를 한 번 다시 시도합니다. Cloudbeds가 같은 접근 오류를 반복해서 반환하면 AVA는 다음 재시도를 잠시 멈춥니다. 벤더 쿨다운은 여전히 빠르게 실패합니다. 새로고침 작업이 몰려도 체크인 또는 객실 변경 작업은 차단되지 않습니다.

해결:

1. 오류에 표시된 재시도 시간까지 기다립니다.

2. 해당 시간이 지난 후 페이지를 새로고칩니다.

3. 한 번 다시 시도합니다.

4. 오류가 다시 표시되면 몇 분 기다렸다가 재시도합니다.

5. 재시도 시간이 표시되지 않으면 잠시 기다렸다가 다시 시도합니다.

   ✓ PMS가 새 요청을 수락하면 AVA가 최신 데이터를 불러와야 합니다.

일시적인 연결 끊김

보이는 현상: 한 번만 발생한 연결 오류, 시간 초과 또는 새로고침 후 사라지는 빈 상태가 표시됩니다.

원인: AVA가 일부 짧은 PMS 읽기 요청을 자동으로 다시 시도합니다.

해결:

1. 페이지를 한 번 새로고칩니다.

2. 작업을 다시 시도합니다.

3. 계속 실패하면 PMS 연결을 확인합니다.

4. 같은 오류가 계속 나타나면 지원팀에 문의합니다.

   ✓ 일회성 문제는 설정을 변경하지 않아도 해결되는 경우가 많습니다.

객실이 아직 점유 중으로 보임

보이는 현상: 이전 게스트를 체크아웃했지만 객실이 여전히 점유 중으로 표시됩니다.

원인: AVA가 아직 이전 예약 스냅샷을 표시하고 있을 수 있습니다.

해결:

1. Refresh를 클릭합니다.

2. 최신 PMS 상태를 기다립니다.

3. 객실을 다시 확인합니다.

   ✓ 체크아웃 동기화가 완료되면 객실이 업데이트되어야 합니다.

여전히 멈춰 있나요?

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

• ❌ PMS 자격 증명을 저장한 후에도 설정 메시지가 계속 표시됨
• ❌ 새로고침해도 예약이 계속 비어 있음
• ❌ 같은 문제가 여러 탭에서 발생함

다음 정보를 함께 보내면 도움이 됩니다.

• PMS 제공업체 이름
• 메시지 또는 빈 상태의 스크린샷
• 마지막으로 설정을 저장한 시각

관련 가이드

• PMS 연결
• PMS 연결 오류
• 예약 보기