데이터가 업데이트되지 않음
대부분의 경우 2~5분이면 끝납니다. 먼저 Refresh를 누르고, 목록이 여전히 비어 보이면 Settings를 확인하세요.
예약, 객실 상태, 또는 투숙객 정보가 AVA에서 최신이 아닌 것처럼 보일 때 이 가이드를 사용하세요.
AVA는 이제 일부 짧은 PMS 읽기 요청을 자동으로 다시 시도합니다. 한 번의 네트워크 오류가 보이지 않을 수도 있습니다.
여러 직원이 같은 Cloudbeds 데이터를 동시에 요청하면 AVA가 하나의 읽기 요청을 공유합니다. 같은 Cloudbeds 접근 오류가 반복되면 AVA는 다음 재시도를 잠시 멈춥니다. 새로고침이 백그라운드에서 끝나는 동안 현재 목록은 계속 보입니다.
| What you see | Why it happens | Do this |
|---|---|---|
| 페이지에 예약 대신 Settings 또는 Retry가 표시됨 | 목록을 불러오기 전에 PMS 설정이 필요함 | Settings → Essentials → PMS Integration에서 PMS 설정을 완료합니다 |
| 페이지에 PMS 자격 증명이 거부되었다고 표시됨 | AVA가 저장된 PMS 자격 증명을 사용할 수 없음 | Settings → Essentials → PMS Integration에서 PMS 자격 증명을 업데이트합니다 |
| 페이지에 429 또는 rate-limited 메시지가 표시됨 | PMS가 요청을 제한 중임 | 표시된 재시도 시간을 기다렸다가 새로고침 후 다시 시도합니다 |
| 같은 Cloudbeds 접근 오류가 바로 다시 나타남 | Cloudbeds가 숙소 또는 권한을 차단했고, AVA가 반복 재시도를 잠시 멈춤 | 올바른 Cloudbeds property를 확인한 뒤 1분 기다렸다가 새로고침합니다 |
| 한 번 실패한 뒤 새로고침하면 정상 작동함 | AVA가 짧은 PMS 네트워크 문제를 다시 시도함 | 한 번 새로고침합니다 |
| 이전 투숙객 체크아웃 뒤에도 객실이 여전히 점유 중처럼 보임 | Streamliner가 아직 최신 예약 snapshot을 다시 만들지 못함 | Refresh를 다시 클릭합니다 |
| 객실 이동 후 투숙객 정보가 이상함 | 객실 변경 동기화가 아직 끝나지 않음 | 이동이 끝난 뒤 예약을 새로고침하고 투숙객 업데이트를 다시 시도합니다 |
| ACI 문서 업로드는 끝났지만 대기 중인 투숙객이 여전히 guest limit에 걸리거나 Cloudbeds multi-room reservation의 투숙객 수가 잘못 표시되거나 객실이 사라짐 | PMS의 guest count가 로컬 객실 총수보다 뒤처졌거나, 부모 예약 업데이트 후 Cloudbeds에 새 새로고침이 더 필요함 | 예약을 새로고침한 뒤 몇 분 후 PMS를 다시 확인합니다 |
| PMS 동기화 실패 후 투숙객 문서나 셀카가 멈춤 | AVA가 나중 업로드를 진행하기 전에 유효한 PMS 투숙객 식별자를 기다림 | PMS 동기화 오류를 수정하고, 페이지를 새로고침한 뒤 업로드를 다시 시도합니다 |
| 목록이 오래돼 보임 | PMS가 최신 데이터를 아직 반환하지 않음 | Refresh를 클릭합니다 |
| 투숙객 또는 객실 변경이 나타나지 않음 | PMS 동기화가 지연됨 | 몇 분 기다린 뒤 다시 새로고침합니다 |
| 모든 것이 비어 보임 | 페이지 로딩이 끝나지 않음 | 페이지를 한 번 새로고침합니다 |
AVA는 이제 부모 Cloudbeds 예약을 업데이트하고 전체 객실 목록을 그대로 유지합니다. 그 덕분에 투숙객 수가 바뀌어도 다른 객실이 목록에서 빠지지 않습니다.
ACI에서는 AVA가 대기 중인 투숙객을 보내기 전에 PMS guest count를 새로고침합니다. 이렇게 하면 여러 투숙객 체크인 중 오래된 guest-limit 오류를 줄일 수 있습니다.
투숙객이 아직 PMS에 동기화되지 않았으면 AVA는 나중 문서와 사진 업로드를 잠시 멈춥니다. 이렇게 하면 파일이 잘못된 투숙객 프로필에 첨부되는 일을 막을 수 있습니다.
ACI 체크인 중 guest limit 도달
보이는 내용: 더 많은 투숙객을 추가하거나 ACI 흐름을 끝낼 때 "Guest limit reached"가 표시됩니다.
이유: PMS 예약의 guest count가 아직 AVA보다 낮습니다.
해결 방법:
-
몇 초 기다렸다가 한 번만 다시 시도합니다.
-
PMS 수치가 여전히 뒤처져 보이면 예약을 새로고침합니다.
-
객실이 이미 PMS 한도에 도달했다면 문서를 기존 투숙객에게 할당합니다.
✓ PMS의 투숙객 수가 객실 총수와 같아지면 guest limit이 해제되어야 합니다.
여기서 시작
-
페이지를 다시 엽니다.
-
Refresh를 클릭합니다.
-
최신 데이터가 나타나는지 확인합니다.
✓ 대부분의 작은 지연은 한 번 새로고침하면 사라집니다.
PMS 설정 누락 또는 거부됨
예약 데이터 대신 설정 메시지가 표시될 때 사용합니다.
보이는 내용: Settings 버튼, Retry 버튼, 설정 필요 메시지, 또는 저장된 PMS 자격 증명이 거부되었다는 메시지.
이유: 호텔에 PMS는 선택되어 있지만 AVA가 아직 자격 증명을 사용할 수 없습니다.
해결 방법:
-
Settings → Essentials → PMS Integration으로 이동합니다.
-
선택한 PMS가 올바른지 확인합니다.
-
누락된 자격 증명을 추가하거나, 거부된 자격 증명을 업데이트하거나, PMS를 다시 활성화합니다.
-
변경 사항을 저장합니다.
-
예약 페이지로 돌아갑니다.
-
Retry 또는 Refresh를 한 번 클릭합니다.
✓ PMS 설정이 끝나면 페이지가 다시 예약을 불러와야 합니다.
PMS 설정이 필요할 때 AVA는 자동 새로고침 루프를 멈춥니다. 그래야 페이지가 끝없이 다시 로드되지 않습니다.
전체 새로고침 강제 실행
정상 새로고침 후에도 페이지가 여전히 오래돼 보일 때 사용합니다.
- 하드 새로고침을 사용합니다.
- Windows:
Ctrl+F5 - Mac:
Cmd+Shift+R
- Windows:
- 페이지가 완전히 로드될 때까지 기다립니다.
- 데이터를 다시 확인합니다.
연결 확인
- 새 탭을 엽니다.
- 다른 웹사이트에 접속합니다.
- 다른 사이트도 느리다면 더 안정적인 연결로 바꿉니다.
로그아웃 후 다시 로그인
페이지가 여전히 업데이트되지 않을 때 사용합니다.
- 사용자 메뉴에서 로그아웃합니다.
- 브라우저를 닫습니다.
- 다시 로그인합니다.
- 페이지를 다시 확인합니다.
rate limit 복구
보이는 내용: 새로고침 후 429 오류나 rate-limited 메시지가 표시됩니다.
이유: PMS가 일시적으로 요청량을 제한하고 있습니다. PMS가 재시도 시간을 보내면 AVA가 그 타이밍을 유지합니다. Cloudbeds housekeeping 읽기는 PMS가 느릴 때 약 10초 후 대기를 멈춥니다. AVA는 오류를 보여주기 전에 그 읽기를 한 번 다시 시도합니다. Cloudbeds가 같은 접근 오류를 반복하면 AVA는 다음 재시도를 잠깐 멈춥니다. 바쁜 새로고침 작업이 체크인이나 객실 변경 작업을 막지는 않습니다.
해결 방법:
-
오류에 표시된 재시도 시간을 기다립니다.
-
그 시간이 지난 뒤 페이지를 새로고침합니다.
-
한 번 다시 시도합니다.
-
오류가 다시 나오면 몇 분 기다렸다가 재시도합니다.
-
재시도 시간이 보이지 않으면 잠깐 기다렸다가 다시 시도합니다.
✓ PMS가 새 요청을 받아들이면 AVA가 최신 데이터를 불러와야 합니다.
일시적인 연결 끊김
보이는 내용: 한 번의 연결 오류, 시간 초과, 또는 새로고침 후 사라지는 빈 상태.
이유: AVA가 일부 짧은 PMS 읽기 요청을 자동으로 다시 시도합니다.
해결 방법:
-
페이지를 한 번 새로고침합니다.
-
작업을 다시 시도합니다.
-
계속 실패하면 PMS 연결을 확인합니다.
-
같은 오류가 계속 나오면 지원팀에 문의합니다.
✓ 일회성 문제는 설정을 바꾸지 않아도 사라지는 경우가 많습니다.
객실이 아직 점유 중처럼 보임
보이는 내용: 이전 투숙객을 체크아웃했는데도 객실이 여전히 점유 중으로 표시됩니다.
이유: AVA가 아직 더 오래된 예약 snapshot을 보여주고 있을 수 있습니다.
해결 방법:
-
Refresh를 클릭합니다.
-
최신 PMS 상태가 반영될 때까지 몇 초 기다립니다.
-
객실을 다시 확인합니다.
✓ 체크아웃 동기화가 끝나면 객실이 업데이트되어야 합니다.
아직도 해결되지 않나요?
다음 경우에는 success@vouch-technologies.com으로 문의하세요:
- ❌ PMS 자격 증명을 저장했는데도 설정 메시지가 계속 표시됨
- ❌ 새로고침해도 예약이 비어 있음
- ❌ 같은 문제가 여러 탭에서 발생함
포함하면 좋은 정보:
- PMS 제공업체 이름
- 메시지 또는 빈 상태의 스크린샷
- 마지막으로 설정을 저장한 시간