PMS 연결 오류
PMS(자산 관리 시스템) 연결 문제 해결 가이드.
일반적인 오류 메시지
| 오류 | 의미 |
|---|---|
| "Please fill all required PMS fields" | 필수 자격 증명 누락 |
| "Failed to save PMS Integration" | 연결 또는 인증 오류 |
| "Unable to communicate with the property management system" | 네트워크 또는 API 문제 |
연결 실패
증상: 연결을 클릭할 때 오류 메시지가 표시됨
먼저 확인해야 할 사항
-
자격 증명이 올바른지 확인
- API 키 또는 클라이언트 자격 증명을 다시 확인하세요.
- 자격 증명 앞뒤에 공백이 없는지 확인하세요.
- 자격 증명이 만료되지 않았는지 확인하세요.
-
API 권한 확인
- PMS 관리 포털에 로그인합니다.
- 계정에 대한 API 액세스가 활성화되어 있는지 확인합니다.
- 통합 권한이 부여되었는지 확인합니다.
-
인터넷 연결 확인
- 페이지 새로 고침을 시도하세요.
- AVA의 다른 부분을 테스트하여 연결을 확인하세요.
시도해 볼 사항
- 설정 → 필수 사항으로 이동합니다.
- 연결 끊기를 클릭합니다 (연결된 경우).
- 30초 기다립니다.
- 자격 증명을 다시 입력합니다.
- 연결을 다시 클릭합니다.
예약 동기화 안 됨
증상: 연결 후 예약이 나타나지 않거나 예약이 누락됨
빠른 수정
- 운영 보기에서 새로 고침을 클릭합니다.
- 초기 동기화가 완료될 때까지 5-10분 기다립니다.
- 오늘 날짜에 대한 예약이 PMS에 존재하는지 확인합니다.
PMS 설정 확인
- 설정 → 필수 사항으로 이동합니다.
- PMS 통합 섹션으로 스크롤합니다.
- 연결 상태가 "연결됨"으로 표시되는지 확인합니다.
- 동기화 설정이 올바르게 구성되었는지 확인합니다.
여전히 작동하지 않나요?
- 예약 날짜가 AVA에서 보고 있는 날짜와 일치하는지 확인하세요.
- PMS의 예약 상태가 동기화를 허용하는지 확인하세요 (확정됨, 취소되지 않음).
- 투숙객 수가 0보다 큰지 확인하세요.
동기화 지연
증상: 예약이 지연되어 나타남
정상적인 동작
대부분의 PMS 시스템은 5-15분마다 동기화됩니다. 실시간 동기화 가용성은 다음에 따라 다릅니다:
- PMS 요금제 수준
- 특정 PMS 제공업체
지연 줄이기
- 필요할 때 수동 새로 고침 사용
- 실시간 API 액세스에 대해 PMS 제공업체에 문의
- 활동이 적은 기간에 동기화 예약
인증 오류
증상: "유효하지 않은 자격 증명" 또는 "인증 실패"
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)
- 문제 시작 시간
- 이미 시도한 단계