PMS 연결 오류
대부분의 연결 문제는 확인하는 데 5~10분이면 충분합니다. 429가 보이면 다시 시도하기 전에 재시도 시간을 기다리세요.
AVA가 PMS에 연결하지 못하거나 일시적인 속도 제한 오류를 표시할 때 이 가이드를 사용하세요.
AVA는 이제 일부 짧은 PMS 읽기 요청을 자동으로 다시 시도합니다. 한 번만 발생하는 네트워크 오류는 보이지 않을 수도 있습니다.
새로고침 중 AVA가 특정 PMS 오류를 표시하면 그 메시지를 그대로 사용하세요. Streamliner는 일반적인 기술 오류로 바꾸지 않고 원본 PMS 응답을 유지합니다.
일반적인 오류 메시지
| 오류 | 의미 | 조치 |
|---|---|---|
| "Please fill all required PMS fields" | 필수 자격 증명 누락 | 누락된 PMS 자격 증명을 추가합니다 |
| "Failed to save PMS Integration" | 연결 또는 인증 오류 | PMS 계정과 권한을 다시 확인합니다 |
| "Unable to communicate with the property management system" | 네트워크 또는 API 문제 | 한 번 새로고침한 뒤 연결을 다시 테스트합니다 |
| "429" 또는 "rate limited" | PMS가 AVA에 속도를 늦추고 나중에 다시 시도하라고 요청했으며, 가능할 때 재시도 시간이 표시됨 | 재시도 시간을 기다린 뒤 다시 시도합니다 |
| "reservationOverlapTo must be greater than reservationOverlapFrom" | PMS가 stayover overlap 창을 거부함 | PMS에서 overlap 값을 업데이트한 뒤 새로고침합니다 |
일시적 연결 문제
보이는 내용: 한 번만 발생하는 연결 오류, 시간 초과, 또는 빈 응답.
원인: AVA는 일부 짧은 PMS 읽기 요청을 자동으로 다시 시도합니다.
해결:
-
페이지를 한 번 새로고침합니다.
-
작업을 다시 시도합니다.
-
계속 실패하면 PMS 연결을 확인합니다.
-
같은 오류가 계속 돌아오면 지원팀에 문의합니다.
✓ 일회성 문제는 설정을 바꾸지 않아도 사라지는 경우가 많습니다.
새로고침 중 PMS 검증 오류
보이는 내용: 예를 들어 reservationOverlapTo must be greater than reservationOverlapFrom 같은 PMS 메시지가 stayover 새로고침 중 나타납니다.
원인: PMS가 검증 규칙 중 하나가 실패했기 때문에 요청을 거부했습니다.
해결:
-
정확한 PMS 메시지를 읽습니다.
-
PMS에서 관련 설정을 확인합니다.
-
검증에 실패한 값을 수정합니다.
-
AVA를 한 번 새로고침합니다.
✓ PMS 데이터가 수정될 때까지는 원본 PMS 메시지만 표시됩니다.
연결 실패
보이는 내용: 연결을 클릭할 때 오류 메시지가 표시됨
먼저 확인해야 할 사항
-
자격 증명이 올바른지 확인
- API 키 또는 클라이언트 자격 증명을 다시 확인하세요
- 자격 증명 앞뒤에 공백이 없는지 확인하세요
- 자격 증명이 만료되지 않았는지 확인하세요
-
API 권한 확인
- PMS 관리 포털에 로그인하세요
- 계정에 API 액세스가 활성화되어 있는지 확인하세요
- 통합 권한이 부여되었는지 확인하세요
-
인터넷 연결 확인
- 페이지를 새로고침해 보세요
- AVA의 다른 부분을 테스트해 연결을 확인하세요
시도해 볼 사항
- Settings → Essentials로 이동합니다.
- 연결된 경우 Disconnect를 클릭합니다.
- 30초 기다립니다.
- 자격 증명을 다시 입력합니다.
- Connect를 다시 클릭합니다.
속도 제한 도달
보이는 내용: 429 오류, 속도 제한 메시지, 또는 재시도 시간이 포함된 요청.
원인: PMS가 일시적으로 요청 수를 제한하고 있습니다. AVA는 PMS가 재시도 시간을 보내면 그 시간을 유지합니다.
해결:
-
오류에 표시된 재시도 시간을 기다린 뒤 한 번 더 시도합니다.
-
페이지를 한 번 새로고침합니다.
-
작업을 다시 시도합니다.
-
문제가 반복되면 몇 분 기다렸다가 다시 시도합니다.
-
재시도 시간이 보이지 않으면 짧은 일시적 제한으로 보고 나중에 다시 시도합니다.
✓ PMS가 새 요청을 허용하면 요청이 성공합니다.
보이는 내용 → 조치
| 보이는 내용 | 조치 |
|---|---|
| 오류가 한 번만 나타남 | 재시도 시간을 기다린 뒤 다시 시도 |
| 오류가 계속 반복됨 | 몇 분 기다렸다가 다시 시도 |
| 예약이 여전히 로드되지 않음 | Sync Issues 확인 |
예약 동기화 안 됨
보이는 내용: 연결 후 예약이 나타나지 않거나 예약이 누락됨
빠른 수정
- Operations View에서 Refresh를 클릭합니다.
- 초기 동기화가 완료될 때까지 5~10분 기다립니다.
- 오늘 날짜의 예약이 PMS에 존재하는지 확인합니다.
PMS 설정 확인
- Settings → Essentials로 이동합니다.
- PMS Integration 섹션으로 스크롤합니다.
- 연결 상태가 "Connected"로 표시되는지 확인합니다.
- 동기화 설정이 올바르게 구성되었는지 확인합니다.
여전히 작동하지 않나요?
- 예약 날짜가 AVA에서 보고 있는 날짜와 일치하는지 확인하세요
- PMS의 예약 상태가 동기화를 허용하는지 확인하세요(확정됨, 취소되지 않음)
- 투숙객 수가 0보다 큰지 확인하세요
동기화 지연
보이는 내용: 예약이 지연되어 나타남
정상적인 동작
대부분의 PMS 시스템은 5~15분마다 동기화됩니다. 실시간 동기화 가능 여부는 다음에 따라 달라집니다.
- PMS 요금제 수준
- 특정 PMS 제공업체
지연 줄이기
- 필요할 때 수동 새로고침을 사용합니다
- 실시간 API 액세스에 대해 PMS 제공업체에 문의합니다
- 활동이 적은 시간대에 동기화를 예약합니다
인증 오류
보이는 내용: "Invalid credentials" 또는 "Authentication failed"
Cloudbeds의 경우
- Cloudbeds에 로그인합니다
- Settings → Integrations → API로 이동합니다
- 새 API 자격 증명을 생성합니다
- 자격 증명을 정확히 복사합니다(가능하면 복사 버튼 사용)
- 수정 없이 AVA에 붙여넣습니다
Opera Cloud의 경우
- Oracle 담당자에게 문의합니다
- API 자격 증명 갱신을 요청합니다
- 환경 URL이 올바른지 확인합니다(테스트 vs 프로덕션)
Mews의 경우
- Mews Commander에 로그인합니다
- Settings → Integrations로 이동합니다
- Vouch AVA를 찾아 액세스 토큰을 재생성합니다
- AVA 설정에서 토큰을 업데이트합니다
지원 팀에 문의해야 할 때
다음과 같은 경우 지원팀에 문의하세요.
- 모든 문제 해결 단계를 시도했습니다.
- 오류 메시지가 시스템 오류 또는 기술적 문제를 나타냅니다.
- 30분 후에도 PMS 변경 사항이 반영되지 않습니다.
이메일: success@vouch-technologies.com
포함 사항:
- 오류 메시지의 스크린샷
- PMS 유형 (Cloudbeds/Opera/Mews)
- 문제 시작 시간
- 이미 시도한 단계