본문으로 건너뛰기

PMS 연결 오류

빠른 확인

대부분의 연결 문제는 확인하는 데 5~10분이 걸립니다. 429가 표시되면 다시 시도하기 전에 재시도 시간을 기다리세요.

AVA가 연결하지 못하거나 일시적인 제한을 표시하거나 PMS 거부를 보고할 때 이 가이드를 사용하세요.

자동 재시도

AVA는 이제 예약 조회 속도 제한 한 건을 포함하여 일부 짧은 PMS 읽기 요청을 자동으로 다시 시도합니다. 408을 반환하는 Mews 읽기 요청도 읽기 재시도 경로를 사용합니다. Mews 요청은 제한된 재시도 창을 사용하므로 느린 PMS 때문에 Housekeeping이 무기한 대기하지 않습니다. Opera OAuth도 일시적인 시간 초과 또는 게이트웨이 오류를 한 번 다시 시도합니다. 체크인 중에는 AVA가 예약 조회, 객실 배정 및 최종 체크인에서 발생하는 일시적인 예약 충돌과 PMS 속도 제한을 다시 시도합니다. Opera 게스트 업데이트도 일시적인 예약 잠금을 다시 시도합니다. Mews 복구 요청도 일시적인 작업 충돌 403을 자동으로 다시 시도합니다. 이러한 재시도로 인해 AVA가 오류를 표시하기 전에 몇 초가 더 걸릴 수 있습니다. 일회성 네트워크 오류가 표시되지 않을 수 있습니다. Cloudbeds 웹훅 자격 증명 실패는 자동으로 다시 시도되지 않습니다.

보존되는 PMS 메시지

새로고침 중 AVA가 특정 PMS 오류를 표시하면 해당 메시지를 사용하세요. Streamliner는 원본 PMS 응답을 일반적인 기술 오류로 바꾸지 않고 유지합니다.

일반적인 오류 메시지​

오류의미조치
"Please fill all required PMS fields"선택한 PMS에 필요한 필드가 누락됨해당 제공업체에 표시된 필수 필드를 입력합니다
"Failed to save PMS Integration"연결 또는 인증 오류PMS 계정과 권한을 다시 확인합니다
"Failed to save settings before connecting"OAuth가 시작되기 전에 다른 Essentials 설정 저장에 실패함전체 메시지를 읽고 해당 설정을 수정한 다음 다시 연결합니다
"Unable to communicate with the property management system"네트워크 또는 API 문제한 번 새로고침한 다음 연결을 다시 테스트합니다
PMS_TEMPORARILY_UNAVAILABLE객실 배정 중 PMS가 응답하지 않음PMS를 확인하고 잠시 기다린 다음 객실 배정을 한 번 다시 시도합니다
PMS_ROOM_UNAVAILABLE선택한 객실을 해당 투숙에 사용할 수 없음다른 객실 또는 날짜를 선택하고 AVA를 새로고침한 다음 한 번 다시 시도합니다
PMS_RESERVATION_NO_AVAILABILITY해당 투숙에 선택한 유형의 객실이 남아 있지 않음다른 객실 유형 또는 날짜를 선택하고 AVA를 새로고침한 다음 한 번 다시 시도합니다
"Self check-in is not available at this property right now"해당 숙소가 게스트 체크인을 사용할 수 있도록 프로비저닝되지 않음관리자에게 PMS를 연결하거나 AVA PMS 설정을 완료해 달라고 요청합니다
"429" 또는 "rate limited"PMS 또는 AVA 자체의 요청 예산에서 나중에 다시 시도하도록 요청함AVA가 체크인 작업을 다시 시도하는 동안 기다리거나 표시된 재시도 시간을 따릅니다
"409" 또는 "Conflict"예약 상태 또는 요청이 허용되지 않아 PMS가 작업을 거부함PMS 사유를 읽고 예약을 수정한 다음 한 번 다시 시도합니다
"403" 및 "Conflicting operation is being performed"Mews가 일시적으로 다른 작업을 처리 중임AVA가 다시 시도하는 동안 잠시 기다린 다음 필요한 경우 영향을 받은 단계를 다시 시도합니다
PMS_RESERVATION_MUTATION_IN_PROGRESS짧은 PMS 예약 업데이트가 객실 배정 또는 최종 체크인과 겹침잠시 기다리고 예약을 새로고침한 다음 영향을 받은 단계를 한 번 다시 시도합니다
PMS_ROOM_ASSIGNMENT_OUTCOME_UNKNOWNPMS에서 객실을 변경했을 수 있지만 AVA가 최종 배정을 확인할 수 없음다시 시도하지 말고 PMS에서 객실과 요금을 확인한 다음 키를 전달하기 전에 명시적인 객실 새로고침을 사용합니다
"Cannot check in reservation because assigned space is blocked"Mews가 배정된 공간을 차단함Mews에서 사용 가능한 공간을 배정한 다음 체크인을 다시 시도합니다
"Assigned space is not available for check-in"Mews는 체크인 전에 점검된 공간을 요구함Mews에서 점검된 공간을 배정한 다음 체크인을 다시 시도합니다
"502" 또는 "Bad Gateway"읽기 또는 쓰기 중 Cloudbeds, Opera 또는 다른 PMS에서 오류가 발생함원인을 읽고 한 번 새로고침한 다음 작업을 다시 시도합니다
"ava-pms returned 500 with an HTML error page"업스트림 게이트웨이가 PMS 응답 대신 일시적인 웹페이지를 반환함한 번 새로고침한 다음 PMS를 확인하고, 다시 표시되면 지원팀에 문의합니다
"503" 또는 "Service Unavailable"PMS 또는 네트워크 서비스가 일시적으로 요청을 완료하지 못함PMS 상태를 확인하고 한 번 새로고침한 다음 작업을 다시 시도합니다
Mews API Error: Transaction has timed out.재시도 창이 끝날 때까지 Mews가 재고 읽기를 완료하지 못함Mews를 확인하고 Housekeeping을 새로고침한 다음 계속되면 지원팀에 문의합니다
504 Mews view-billing deadline exceededAVA의 결제 읽기 제한 시간 전에 Mews 결제 세부 정보가 도착하지 않음저장된 잔액을 검토하고 Mews와 비교한 다음 한 번 새로고침합니다
"non-reservations payload"eZee가 예약 데이터 대신 웹사이트 또는 다른 응답을 반환함eZee Base URL을 확인하고 표준 API를 사용할 때는 비워 둡니다
"Unsupported Cloudbeds version"요청에서 폐기된 Cloudbeds v1 또는 v2를 선택함버전 고정을 제거한 다음 새 연결을 시작합니다
"You don't have access to property ID"Cloudbeds가 숙소를 차단함올바른 Cloudbeds 숙소를 확인한 다음 액세스가 복구되면 다시 시도합니다
앱 연결 해제 메시지가 없는 "success:false"Cloudbeds가 제공업체별 실패를 반환함전체 메시지를 읽은 다음 관련 Cloudbeds 복구 단계를 따릅니다
"Application is not available to be connected"Cloudbeds에서 숙소가 AVA 앱의 연결을 해제함해당 숙소에서 Cloudbeds를 다시 승인한 다음 다시 시도합니다
"webhook credentials rejected"Cloudbeds가 로그인은 수락했지만 웹훅 설정을 거부함Cloudbeds를 다시 연결하고 설정을 다시 저장합니다
"PMS cache unavailable" 또는 캐시 무효화 오류AVA가 서비스 전체에서 새 PMS 설정을 확인하지 못함1분 기다린 다음 다시 저장하고, 반복되면 지원팀에 문의합니다
설정 저장 중 일부 작업이 완료된 후 실패함다른 쓰기가 완료된 후 종속 단계 또는 캐시 새로고침이 실패함다시 시도하기 전에 PMS를 확인한 다음 AVA를 새로고침합니다
"Configuration is temporarily unavailable"Command Center가 호텔의 전체 구성을 가져오지 못함새로고침하고 요청되면 다시 로그인한 다음 관리자에게 액세스 권한을 확인해 달라고 요청합니다
611 또는 "Invalid Auth Code or Hotel Code"자격 증명을 변경한 후 eZee가 이전 자격 증명 스냅샷을 거부함일치하는 Hotel Code와 Auth Code를 저장한 다음 한 번 다시 시도합니다
"reservationOverlapTo must be greater than reservationOverlapFrom"PMS가 스테이오버 중첩 창을 거부함PMS에서 중첩 값을 업데이트한 다음 새로고침합니다

일시적인 연결 문제​

보이는 내용: 한 번만 발생하는 연결 오류, 시간 초과 또는 빈 응답이 표시됩니다.

원인: AVA는 일부 짧은 PMS 읽기 요청을 자동으로 다시 시도합니다. 일시적인 Opera OAuth 실패도 한 번 다시 시도합니다. AVA가 재시도하는 동안 시간 초과 또는 게이트웨이 오류가 표시되기까지 시간이 걸릴 수 있습니다. Mews 재시도는 긴 재시도 단계로 계속되지 않고 제한된 창 안에서 중지됩니다. Opera에서는 하우스키핑 읽기 또는 쓰기 연결이 끊기면 502로 표시될 수 있습니다.

해결:

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

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

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

  4. 같은 오류가 계속 반환되면 지원팀에 문의합니다.

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

Command Center가 구성을 확인하지 못함​

보이는 내용: Command Center에 Configuration is temporarily unavailable이 표시됩니다.

원인: AVA가 호텔의 전체 구성을 가져오지 못했습니다. 액세스 권한이 없거나 업스트림 구성 서비스가 일시적으로 중단된 것이 원인일 수 있습니다. AVA는 이 실패를 PMS 설정이 완료되지 않은 것으로 처리하지 않습니다.

해결:

  1. Command Center를 한 번 새로고침합니다.

  2. AVA에서 요청하면 다시 로그인합니다.

  3. 관리자에게 호텔 구성에 대한 액세스 권한을 확인해 달라고 요청합니다.

  4. 서비스를 일시적으로 사용할 수 없다면 나중에 다시 시도합니다.

  5. 알림이 계속 표시되면 지원팀에 문의합니다.

    ✓ AVA가 전체 구성을 가져온 후에만 PMS 설정 메시지가 표시됩니다.

객실 배정 중 PMS를 일시적으로 사용할 수 없음​

보이는 내용: 객실 배정에 PMS를 일시적으로 사용할 수 없다는 메시지가 표시됩니다.

원인: PMS가 제한 시간 내에 객실 배정 요청에 응답하지 않았습니다. Cloudbeds의 경우 AVA는 일치하는 각 객실과 투숙 날짜 구간의 실시간 점유 상태도 검증합니다. AVA는 이 시도를 재시도 가능한 상태로 기록하며 변경 작업을 자동으로 다시 실행하지 않습니다.

해결:

  1. PMS 상태를 확인하고 그곳에서 예약을 엽니다.

  2. 다시 시도하기 전에 객실 배정이 완료되지 않았는지 확인합니다.

  3. AVA에서 예약을 새로고침합니다.

  4. 객실 배정을 한 번 다시 시도합니다.

    ✓ AVA가 객실을 배정하거나 구체적인 객실 준비 상태 사유를 표시해야 합니다.

Cloudbeds 다중 객실 예약에서는 예약과 객실 상태가 올바르게 보일 때만 일시적인 오류 후 다시 시도하세요. 그런 다음 AVA는 객실을 배정하기 전에 영향을 받은 객실과 투숙 날짜를 평가합니다.

AVA는 이 장애에 대해 객실이 준비되지 않았다는 이메일을 보내지 않습니다. 나중에 확인한 결과 객실이 준비되지 않은 경우 알림 슬롯은 계속 사용할 수 있습니다.

불분명한 쓰기 작업을 반복하지 마세요

결과가 불분명한 작업을 다시 시도하기 전에 PMS에서 예약을 확인하세요.

PMS 요청이 너무 오래 걸림​

보이는 내용: PMS 작업이 대기한 후 시간 초과 또는 연결 오류를 표시합니다.

원인: 더 짧은 제한 시간이 없는 요청에 대해 AVA는 60초 후 대기를 중지합니다. 일부 예약 및 기능 읽기에는 더 짧은 제한 시간이 적용됩니다. Mews 결제 읽기에는 40초 제한 시간과 더 짧은 시도가 적용됩니다. 이렇게 하면 느린 PMS 응답 하나 때문에 예약 작업이 무기한 열린 상태로 남는 것을 방지할 수 있습니다.

해결:

  1. 시간 초과 메시지가 표시될 때까지 기다립니다.

  2. 다시 시도하기 전에 예약 또는 페이지를 새로고침합니다.

  3. 쓰기 작업을 반복하기 전에 PMS에서 예약을 확인합니다.

  4. 작업을 한 번 다시 시도합니다.

  5. 시간 초과가 다시 발생하면 지원팀에 문의합니다.

    ✓ PMS 작업은 약 1분 이내에 완료되거나 명확한 오류를 반환해야 합니다.

다시 시도하기 전에 확인

결과가 불분명한 상태에서 예약 업데이트를 반복하지 마세요. 먼저 PMS에서 예약 상태를 확인한 다음 한 번 다시 시도하세요.

Mews 결제 새로고침이 제한 시간에 도달함​

보이는 내용: 셀프 체크인 또는 결제 새로고침 중 AVA에 504 Mews view-billing deadline exceeded가 표시됩니다.

원인: 결제 읽기 제한 시간이 끝나기 전에 Mews가 최신 결제 세부 정보를 반환하지 않았습니다. AVA는 체크인 흐름이 무기한 대기하지 않도록 저장된 결제 스냅샷을 표시할 수 있습니다.

해결:

  1. 표시된 잔액을 Mews의 전체 청구서와 비교합니다.

  2. AVA에서 예약을 한 번 새로고침합니다.

  3. Mews가 확인하지 않은 금액을 수금하지 마세요.

  4. 잔액이 계속 불분명하면 프런트 데스크 직원에게 체크인을 완료해 달라고 요청합니다.

  5. 시간 초과가 계속 반환되면 지원팀에 문의합니다.

    ✓ 일시적인 Mews 결제 지연은 체크인을 대기 상태로 남기지 않고 명확한 결과를 반환해야 합니다.

Mews 하우스키핑 읽기 시간이 초과됨​

보이는 내용: Housekeeping에 Transaction has timed out. 같은 Mews 시간 초과가 표시됩니다.

원인: AVA의 제한된 재시도 창이 끝나기 전에 Mews가 재고 읽기를 완료하지 못했습니다. AVA는 이제 빈 객실 목록이나 오해를 일으키는 객실 목록 대신 Mews의 원인을 표시합니다.

해결:

  1. Mews Commander에서 활성 장애 또는 느린 응답을 확인합니다.

  2. Mews가 정상적으로 응답한 후 Housekeeping을 새로고침합니다.

  3. 빈 객실 목록을 객실을 사용할 수 없다는 증거로 간주하지 마세요.

  4. Mews가 복구된 후에도 시간 초과가 계속되면 지원팀에 문의합니다.

    ✓ Mews 읽기가 성공하면 Housekeeping에 최신 객실 재고가 로드되어야 합니다.

직접 판매 결제 게시 결과가 불분명함​

보이는 내용: 직접 판매 결제가 시간 초과되거나 AVA가 PMS 게시를 확인하지 못합니다.

원인: 시간 초과가 표시되기 전에 PMS가 요청을 받았을 수 있습니다. AVA는 전송된 결제와 결과가 불분명한 결제가 중복 게시되지 않도록 보호합니다.

해결:

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

  2. 결제가 올바른 폴리오에 이미 표시되는지 확인합니다.

  3. 결과가 불분명한 동안 결제를 다시 제출하지 마세요.

  4. PMS 결과를 확인한 후 AVA를 새로고침합니다.

  5. 결제가 없거나 결과가 불분명하면 조정을 위해 지원팀에 문의합니다.

    ✓ 전송 전에 발생한 확인된 준비 실패는 나중에 결제 완료 알림을 통해 복구될 수 있습니다.

두 번째 결제를 수동으로 게시하지 마세요

PMS 응답이 불분명하다고 해서 결제가 실패했다는 의미는 아닙니다. 다시 시도하기 전에 조정이 완료될 때까지 기다리세요.

PMS 읽기에서 대체 경로를 사용함​

보이는 내용: PMS 읽기에 너무 오래 걸린 후 AVA가 더 적은 세부 정보로 계속 진행합니다.

원인: 선택한 읽기는 게스트 또는 직원 흐름이 계속될 수 있도록 실패를 허용합니다. 대체 경로에서는 보강되지 않은 예약이나 더 단순한 검색 결과가 표시될 수 있습니다. 기능 읽기에서는 기능을 일시적으로 사용할 수 없다고 보고할 수 있습니다.

보이는 내용원인해결
예약 세부 정보가 불완전해 보임객실 유형 세부 정보가 제때 반환되지 않음예약을 새로고침하고 다시 시도합니다
직원 검색에 게스트 세부 정보가 더 적게 표시됨프로필 검색에서 예약 이름 대체 경로를 사용함페이지를 새로고침한 후 다시 검색합니다
날짜에 따라 달라지는 흐름에 잘못된 날짜가 표시됨PMS 영업일이 제때 반환되지 않음새로고침한 다음 PMS에서 영업일을 확인합니다
Group Checkout이 표시되지 않음읽는 동안 기능 데이터를 사용할 수 없었음새로고침한 다음 PMS 연결을 확인합니다
지원되는 객실 이동이 거부됨AVA가 필요한 기능을 확인하지 못함새로고침한 다음 한 번 다시 시도합니다
쓰기를 반복하기 전에 PMS 확인

이러한 대체 경로는 읽기에 적용됩니다. 쓰기 시간이 초과되면 다시 시도하기 전에 PMS를 확인하세요.

Opera 오류에 업스트림 원인이 표시됨​

보이는 내용: Opera 작업에 "Bad Gateway" 또는 "Service Unavailable (503)"이 표시됩니다.

원인: Opera 또는 해당 게이트웨이가 JSON이 아닌 오류 응답을 반환했습니다. AVA는 가능한 경우 짧은 응답 텍스트를 표시하고, 비어 있으면 HTTP 상태를 표시합니다.

해결:

  1. 전체 오류 메시지를 읽고 상태 코드를 기록합니다.
  2. 셰어러를 추가하는 경우 다시 시도하기 전에 Opera를 확인합니다.
  3. 다른 작업은 AVA를 한 번 새로고침한 다음 다시 시도합니다.
  4. 같은 오류가 다시 발생하면 Opera와 AVA를 확인합니다.
  5. 오류가 계속되면 지원팀에 문의합니다.
다시 시도하기 전에 셰어러 확인

AVA는 Opera 셰어러 생성 진행 상황을 기록합니다. 모든 게스트가 체크인되었고 대기 중인 객실 이동이 없으면 AVA는 추가 Opera 업데이트 없이 결과를 반환합니다. 대기 중인 객실 이동은 조정 대상 상태로 유지됩니다. 잠시 기다리고 AVA를 새로고침한 다음 다시 시도하기 전에 Opera를 확인하세요. 결과가 불분명한 상태에서 셰어러를 수동으로 추가로 생성하지 마세요.

Opera 셰어러의 결제 수단 복사 결과가 불분명함​

보이는 내용: 셰어러는 존재하지만 AVA가 복사된 결제 수단을 확인하지 못합니다.

원인: Opera의 결제 수단 복사 요청은 셰어러 예약에 추가됩니다. 시간 초과 또는 네트워크 오류가 표시되기 전에 요청이 Opera에 도달할 수 있습니다. AVA는 전송 전에 실패한 것으로 확인된 경우와 Opera가 명시적으로 거부한 경우만 다시 엽니다. 결과가 불분명한 경우 중복 결제 수단을 방지하기 위해 격리된 상태로 유지됩니다.

해결:

  1. AVA를 한 번 새로고침합니다.

  2. Opera에서 셰어러 예약을 엽니다.

  3. 복사된 결제 수단이 있는지 확인합니다.

  4. Opera의 결과가 불분명할 때 결제 수단 복사를 반복하지 마세요.

  5. 예약 세부 정보와 전체 오류 메시지를 첨부하여 지원팀에 문의합니다.

    ✓ 확인된 실패는 이후 셰어러 작업에서 안전하게 다시 시도할 수 있습니다.

다시 시도하기 전에 Opera 확인

시간 초과 후 결제 수단을 수동으로 추가하지 마세요. Opera가 원래 요청을 수락했을 수 있습니다.

AVA-PMS에 HTML 오류 요약이 표시됨​

보이는 내용: AVA에 ava-pms returned 500 with an HTML error page: 502 Bad Gateway 같은 메시지가 표시됩니다.

원인: PMS 요청 중 업스트림 게이트웨이가 HTML 오류 페이지를 반환했습니다. AVA는 페이지 제목은 유지하지만 웹페이지 마크업은 오류에서 제거합니다.

해결:

  1. AVA를 한 번 새로고침합니다.

  2. 예약 업데이트를 반복하기 전에 예약과 PMS를 확인합니다.

  3. PMS 상태를 확인한 후 작업을 한 번 다시 시도합니다.

  4. 메시지가 다시 표시되면 지원팀에 문의합니다.

    ✓ 오류에는 웹페이지 대신 짧은 요약이 표시되어야 합니다.

PMS 거부가 충돌로 표시됨​

보이는 내용: 작업에 409, "Conflict" 또는 구체적인 PMS 거부가 표시됩니다. 더 이상 일반적인 서버 오류로 표시되지 않습니다.

원인: 예약 규칙이 실패하여 PMS가 작업을 거부했습니다. AVA는 원인을 수정할 수 있도록 업스트림 상태와 메시지를 유지합니다. 대부분의 409 응답은 해당 요청에 대해 영구적입니다. PMS_RESERVATION_MUTATION_IN_PROGRESS 코드는 게스트 업데이트, 객실 배정 또는 최종 체크인 중 발생하는 일시적인 예외입니다.

해결:

  1. 전체 PMS 메시지를 읽습니다.

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

  3. 메시지에서 확인된 문제를 수정합니다.

  4. 취소 거부인 경우 투숙 상태가 체크인, 체크아웃 예정 또는 체크아웃 완료인지 확인합니다.

  5. 투숙 중인 예약을 취소하기 전에 PMS에서 필요한 체크아웃 단계를 완료합니다.

  6. AVA를 새로고침합니다.

  7. 작업을 한 번 다시 시도합니다.

  8. PMS가 계속 거부하면 PMS에서 작업을 완료하고 지원팀에 문의합니다.

    ✓ PMS가 작업을 수락하면 AVA에 업데이트된 예약 상태가 표시되어야 합니다.

PMS가 객실 가용성을 거부함​

보이는 내용: 객실 이동 또는 예약 수정에서 객실이나 객실 유형을 사용할 수 없다고 표시합니다. 메시지에 PMS_ROOM_UNAVAILABLE 또는 PMS_RESERVATION_NO_AVAILABILITY가 포함될 수 있습니다.

원인: PMS에서 현재 가용성 충돌을 발견했습니다. 다른 예약, 사용 불가 차단 또는 진행 중인 예약이 해당 객실을 사용하고 있을 수 있습니다. 또한 전체 투숙 기간에 객실 유형의 재고가 남아 있지 않을 수 있습니다.

해결:

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

  2. 투숙 날짜, 배정된 객실 및 객실 유형을 확인합니다.

  3. 필요한 경우 사용 가능한 객실 또는 객실 유형을 선택합니다.

  4. Streamliner를 새로고침합니다.

  5. 객실 이동 또는 예약 수정을 한 번 다시 시도합니다.

    ✓ PMS가 목적지 객실을 거부하면 AVA는 원래 배정을 유지합니다.

AVA는 객실 변경 모달, 예약 세부 정보 및 체크인 로그에 현지화된 설명을 표시합니다. 교환의 경우 AVA는 원래 예약을 복원하기 전에 목적지 예약을 원래 객실로 되돌립니다. 따라서 교환에 실패해도 어느 예약도 잘못된 객실에 남지 않습니다.

사용할 수 없는 변경을 반복하지 마세요

사용할 수 없는 동일한 날짜 또는 객실을 반복해서 전송하면 같은 거부가 발생할 수 있습니다. 먼저 PMS에서 가용성을 수정한 다음 한 번 다시 시도하세요.

Cloudbeds 배정 결과를 알 수 없음​

보이는 내용: Cloudbeds 객실 이동 또는 업그레이드에서 배정 결과를 알 수 없다고 표시됩니다.

원인: Cloudbeds가 전체 응답을 반환하지 않고 객실 이동을 수락했을 수 있습니다. AVA는 확인되지 않은 객실 및 액세스 상태를 이전 배정을 표시하는 대신 삭제합니다. 명시적인 새로고침으로 PMS 결과를 확인할 때까지 백그라운드 읽기를 일시 중지합니다.

해결:

  1. 같은 객실이나 교환 계획을 다시 선택하지 마세요.

  2. Cloudbeds에서 영향을 받은 각 예약을 엽니다.

  3. 객실 번호, 객실 유형, 날짜, 1박 요금 및 전체 투숙 금액을 확인합니다.

  4. AVA에서 명시적인 객실 새로고침을 사용합니다.

  5. AVA에 PMS에서 확인된 객실이 표시될 때까지 키를 전달하지 마세요.

  6. 객실 또는 금액 정보가 여전히 불분명하면 지원팀에 문의합니다.

    ✓ PMS 상태가 확인되면 AVA가 오래된 배정을 삭제할 수 있습니다.

알 수 없는 결과를 다시 시도하지 마세요

다시 시도하면 첫 번째 객실 이동이 아직 해결되지 않은 상태에서 또 다른 객실 이동이 생성될 수 있습니다. 먼저 Cloudbeds를 확인한 다음 명시적인 객실 새로고침을 사용하세요.

예약 변경이 아직 진행 중임​

보이는 내용: 게스트 업데이트, 객실 배정 또는 최종 체크인에 PMS_RESERVATION_MUTATION_IN_PROGRESS가 표시됩니다.

원인: PMS 예약 업데이트가 일시적으로 예약을 점유하고 있습니다. 게스트 확인, 여권 업로드 또는 다른 예약 업데이트 후에 발생할 수 있습니다. Opera 최종 체크인에서는 잠금이 표시되기 전에 객실 배정이 이미 성공했을 수 있습니다. AVA는 짧은 백오프를 적용하여 이 정확한 충돌을 최대 네 번 다시 시도합니다.

해결:

  1. PMS 업데이트가 완료될 때까지 잠시 기다립니다.

  2. AVA에서 예약을 새로고침합니다.

  3. 영향을 받은 단계를 한 번 다시 시도합니다.

    ✓ 예약 업데이트가 완료되면 영향을 받은 단계가 계속 진행되어야 합니다.

네 번 시도한 후에도 코드가 남아 있으면 AVA는 쓰기를 중지하고 재시도 가능한 충돌을 반환합니다. 다시 시도하기 전에 PMS에서 예약을 확인하세요. 충돌이 계속되면 지원팀에 문의하세요. 예약 번호, PMS 제공업체 및 전체 오류 메시지를 포함하세요.

Mews 작업 충돌이 다시 시도되는 중​

보이는 내용: Mews가 403과 함께 "Conflicting operation is being performed at this time."을 반환합니다.

원인: 다른 작업 중에 Mews가 잠시 예약을 잠급니다. 이 응답은 Mews가 거부된 작업을 적용했다는 의미가 아닙니다. AVA는 잠시 기다린 후 복구 요청을 자동으로 다시 시도합니다.

해결:

  1. 현재 AVA 작업이 완료될 때까지 기다립니다.

  2. 작업에 오류가 계속 표시되면 Mews에서 예약을 확인합니다.

  3. AVA를 새로고침한 다음 영향을 받은 체크인 단계를 한 번 다시 시도합니다.

    ✓ Mews가 잠금을 해제하면 게스트 이동 또는 체크인 복구가 계속 진행되어야 합니다.

다시 시도한 후에도 같은 메시지가 계속 표시되면 지원팀에 문의하세요.

Mews 체크인 상태가 변경됨​

보이는 내용: 예약이 더 이상 Confirmed 상태가 아니어서 Mews가 체크인을 거부합니다.

원인: AVA가 체크인을 시작하는 동안 다른 Mews 업데이트가 예약을 변경했습니다. AVA는 작업 실패 여부를 결정하기 전에 정확한 예약을 한 번 확인합니다.

해결:

  1. 현재 AVA 작업이 완료될 때까지 기다립니다.

  2. 예약이 Started 상태이고 객실이 배정되어 있으면 표시된 객실로 계속 진행합니다.

  3. 예약이 Started 상태가 아니면 AVA를 새로고침하고 Mews에서 예약을 확인합니다.

  4. Mews에 예약이 준비되었다고 표시될 때만 체크인을 다시 시도합니다.

    ✓ Mews가 이미 예약을 시작한 경우 AVA는 체크인을 반복하지 않습니다.

예약에 객실이 배정되어 있는데도 AVA가 계속 오류를 보고하면 지원팀에 문의하세요.

Mews가 배정된 공간을 거부함​

보이는 내용: Mews에서 배정된 공간이 차단되었거나 체크인에 사용할 수 없다고 표시합니다.

원인: Mews는 체크인 중 객실 준비 상태 규칙을 적용합니다. 배정된 공간이 차단되었거나 점검되지 않았을 수 있습니다.

해결:

  1. Mews에서 예약을 엽니다.

  2. 사용 가능한 공간을 배정합니다.

  3. Mews에서 요구하는 경우 해당 공간이 점검되었는지 확인합니다.

  4. AVA에서 예약을 새로고침합니다.

  5. 체크인을 한 번 다시 시도합니다.

    ✓ Mews가 배정된 공간을 수락하면 AVA에서 체크인이 완료되어야 합니다.

Mews에 사용 가능하고 점검된 공간이 표시되는데도 체크인을 거부하면 지원팀에 문의하세요.

Opera가 알 수 없는 성별 값을 거부함​

보이는 내용: Opera에 이전에 Value N/A for field Gender exceeds the maximum length allowed.가 표시되었습니다.

원인: Opera의 성별 코드는 숙소마다 다릅니다. 일부 숙소에서는 N/A 같은 값이 유효한 코드가 아닙니다.

해결:

  1. AVA에서 게스트 업데이트를 다시 시도합니다.

  2. AVA는 업데이트를 보내기 전에 알 수 없는 자리표시자를 제거합니다.

  3. 새 값이 알 수 없거나 누락된 경우 AVA는 저장된 유효한 성별 값을 유지합니다.

  4. Opera가 게스트 업데이트를 계속 거부하면 지원팀에 문의합니다.

    ✓ 실제 코드를 입력하지 않는 한 저장된 유효한 Opera 성별 값은 변경되지 않아야 합니다.

PMS 새로고침 중 검증 오류​

보이는 내용: reservationOverlapTo must be greater than reservationOverlapFrom 같은 PMS 메시지가 스테이오버 새로고침 중 표시됩니다.

원인: PMS의 검증 규칙 중 하나가 실패하여 PMS가 요청을 거부했습니다.

해결:

  1. 정확한 PMS 메시지를 읽습니다.

  2. PMS에서 관련 설정을 확인합니다.

  3. 검증에 실패한 값을 수정합니다.

  4. AVA를 한 번 새로고침합니다.

    ✓ PMS 데이터가 수정될 때까지는 원본 PMS 메시지만 표시됩니다.

연결 실패​

보이는 내용: Connect를 클릭할 때 오류 메시지가 표시됩니다.

먼저 확인할 사항​

  1. 자격 증명이 올바른지 확인

    • API 키 또는 클라이언트 자격 증명을 다시 확인합니다.
    • 자격 증명 앞뒤에 공백이 없는지 확인합니다.
    • 자격 증명이 만료되지 않았는지 확인합니다.

  2. API 권한 확인

    • PMS 관리자 포털에 로그인합니다.
    • 계정에 API 액세스가 활성화되어 있는지 확인합니다.
    • 통합 권한이 부여되었는지 확인합니다.

  3. 인터넷 연결 확인

    • 페이지를 새로고침합니다.
    • AVA의 다른 부분을 테스트하여 연결을 확인합니다.

다음 조치​

  1. Settings → Essentials로 이동합니다.
  2. 연결되어 있다면 Disconnect를 클릭합니다.
  3. 30초 기다립니다.
  4. 자격 증명을 다시 입력합니다.
  5. Connect를 다시 클릭합니다.

OAuth 전에 Cloudbeds 저장이 실패함​

보이는 내용: "Failed to save settings before connecting: ..."이 표시됩니다.

원인: AVA는 Cloudbeds OAuth를 시작하기 전에 저장되지 않은 다른 Essentials 변경 사항을 저장합니다. 자세한 메시지에서 실패한 설정을 확인할 수 있습니다.

해결:

  1. 전체 오류 배너를 읽습니다.

  2. 메시지에 표시된 설정을 수정합니다.

  3. AVA에 저장 작업이 표시되면 설정을 저장합니다.

  4. Connect to Cloudbeds를 다시 선택합니다.

    ✓ 사전 연결 저장에 성공하면 Cloudbeds가 열립니다.

Cloudbeds OAuth 교환 실패​

보이는 내용: 연결에 Version is required가 표시되거나 인증 코드 교환이 거부됩니다.

원인: Cloudbeds 인증 코드는 한 번만 사용할 수 있습니다. 실패한 콜백은 다시 재생할 수 없습니다. AVA는 생략된 Cloudbeds OAuth 버전을 이제 기본적으로 v3으로 설정합니다.

해결:

  1. Settings → Essentials로 이동합니다.

  2. Connect to Cloudbeds를 선택합니다.

  3. Cloudbeds에 로그인하고 Authorize 또는 Allow를 선택합니다.

  4. 연결을 완료합니다. Cloudbeds가 새 인증 코드를 생성합니다.

  5. 새 연결도 다시 실패하면 지원팀에 문의합니다.

    ✓ Cloudbeds 연결은 버전을 입력하라는 요청 없이 완료되어야 합니다.

Cloudbeds v1 또는 v2가 거부됨​

보이는 내용: AVA에 지원되지 않는 Cloudbeds 버전 오류가 표시됩니다.

원인: Cloudbeds v1 및 v2 어댑터는 폐기되었습니다. 버전을 지정하지 않는 Cloudbeds 라우팅은 v3을 사용합니다.

해결:

  1. 명시적인 Cloudbeds 버전 설정 또는 고정을 삭제합니다.

  2. 통합 관리자에게 v1 또는 v2 호출자 고정을 제거해 달라고 요청합니다.

  3. Settings → Essentials로 이동합니다.

  4. Connect to Cloudbeds를 선택하고 인증을 다시 완료합니다.

    ✓ 새 연결은 Cloudbeds v3을 사용합니다.

PMS 설정 저장이 완료되지 않음​

보이는 내용: AVA가 PMS 세부 정보를 수락한 후 캐시 또는 서비스 오류를 표시합니다.

원인: AVA는 관련 설정을 종속된 단계로 저장합니다. 한 단계가 완료된 후 다른 단계 또는 캐시 새로고침이 실패할 수 있습니다. AVA가 오류를 보고하더라도 PMS는 쓰기를 수락했을 수 있습니다.

해결:

  1. PMS를 열고 변경된 자격 증명 또는 제공업체 설정이 수락되었는지 확인합니다.

  2. 다시 시도하기 전에 1분 기다립니다.

  3. Settings → Essentials → PMS Integration을 새로고침합니다.

  4. 교체하는 경우가 아니라면 마스킹된 자격 증명을 수정하지 않습니다.

  5. PMS에 여전히 변경이 필요할 때만 Save를 다시 클릭합니다.

  6. PMS 기반 흐름을 사용하기 전에 성공 메시지를 확인합니다.

    ✓ 저장에 성공하면 새 자격 증명이 AVA 서버 전체에서 작동해야 합니다.

다시 시도하기 전에 확인

AVA는 모든 설정 쓰기를 자동으로 되돌리거나 다시 시도하지 않습니다. PMS를 확인하지 않고 저장을 반복하면 업스트림에서 이미 수락한 변경이 다시 적용될 수 있습니다.

세 번 시도한 후에도 같은 오류가 표시되면 지원팀에 문의하세요. 전체 오류 메시지, PMS 제공업체, 저장에 실패한 시간 및 PMS에 표시되는 내용을 포함하세요.

자격 증명 변경 후 eZee 코드 611​

보이는 내용: PMS 자격 증명을 업데이트한 후 eZee가 611, "Invalid Auth Code or Hotel Code"를 반환합니다.

원인: 이전 PMS 요청이 이전 자격 증명 스냅샷으로 아직 완료 중일 수 있습니다. AVA는 저장 후 해당 스냅샷을 더 이상 사용하지 않는 것으로 표시합니다.

해결:

  1. Hotel Code와 Auth Code가 동일한 eZee 숙소에 속하는지 확인합니다.

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

  3. 업데이트된 자격 증명을 저장합니다.

  4. 성공 메시지가 표시될 때까지 기다립니다.

  5. PMS 작업을 한 번 다시 시도합니다.

    ✓ 다음 PMS 작업은 새 자격 증명을 사용해야 합니다.

성공적으로 저장한 후에도 코드 611이 남아 있으면 지원팀에 문의하세요.

속도 제한 도달​

보이는 내용: 429 오류, 속도 제한 메시지 또는 재시도 시간이 포함된 요청이 표시됩니다.

원인: Cloudbeds 또는 AVA 자체의 요청 예산이 일시적으로 요청을 제한하고 있습니다. AVA는 가능한 경우 어느 쪽에서든 제공한 재시도 시간을 유지합니다. AVA는 기능 영역별로 별도의 요청 예산도 유지하므로 한 바쁜 페이지가 다른 페이지를 느리게 만들 가능성이 줄어듭니다. 객실 배정 및 최종 체크인에서도 일시적인 PMS 429를 자동으로 다시 시도합니다. 이러한 작업은 계속 진행되거나 오류를 표시하기 전에 몇 초가 더 걸릴 수 있습니다. 일부 게스트 대상 호출은 AVA 자체 버킷이 비어 있을 때 잠시 기다립니다. 이는 짧은 로컬 요청 폭주에만 적용되며 제공업체의 대기 시간에는 적용되지 않습니다. Cloudbeds가 같은 접근 오류를 여러 번 반환하면 AVA는 다음 재시도를 잠시 중지합니다.

속도 제한 격리

한 페이지에서 429가 계속 표시되면 문제는 대개 해당 페이지 또는 기능 영역에 한정됩니다. 기다리는 동안 AVA의 다른 부분은 정상적으로 작동할 수 있습니다.

예약 조회 재시도

예약 조회 중 재시도 시간이 5초 이하이면 AVA가 429를 한 번 자동으로 다시 시도합니다. 더 긴 대기 시간과 최종 응답에는 아래의 일반적인 새로고침 및 재시도 단계가 여전히 필요합니다.

해결:

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

  2. 페이지를 한 번 새로고침합니다.

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

  4. 문제가 반복되면 몇 분 기다렸다가 다시 시도합니다.

  5. 재시도 시간이 표시되지 않으면 짧은 일시적 제한으로 보고 나중에 다시 시도합니다.

    ✓ 재시도 시간이 지나고 요청 예산을 사용할 수 있게 되면 요청이 성공해야 합니다.

객실 배정 또는 최종 체크인 중

현재 작업이 완료될 때까지 Retry를 선택하지 말고 기다리세요. AVA에 친숙한 객실 배정 오류가 계속 표시되면 PMS에서 예약을 확인하세요. 그런 다음 AVA를 새로고침하고 영향을 받은 단계를 한 번 다시 시도하세요.

Cloudbeds 접근 오류​

보이는 내용: Cloudbeds 접근 메시지가 계속 반환됩니다. 예를 들면 You don't have access to property ID와 Application is not available to be connected가 있습니다.

원인: 숙소 접근 권한이 없거나 숙소에서 AVA 앱의 연결을 해제했습니다. AVA는 같은 실패가 Cloudbeds에 반복적으로 쏟아지지 않도록 재시도를 일시 중지합니다.

해결:

  1. 올바른 Cloudbeds 숙소에 로그인했는지 확인합니다.

  2. Cloudbeds 관리자에게 숙소 접근 권한과 권한을 확인해 달라고 요청합니다.

  3. Cloudbeds에서 앱 연결이 해제되었다고 표시하면 AVA를 다시 승인합니다.

  4. 다시 시도하기 전에 1분 기다립니다.

  5. 접근 문제가 해결된 후 한 번 새로고침합니다.

    ✓ Cloudbeds가 요청을 수락하면 다음 연결 시도가 성공해야 합니다.

보이는 내용 → 해결

보이는 내용해결
오류가 한 번 표시됨재시도 시간을 기다린 다음 다시 시도합니다
오류가 계속 반환됨몇 분 기다린 다음 다시 시도합니다
예약이 계속 로드되지 않음Sync Issues를 확인합니다

Cloudbeds 웹훅 자격 증명이 거부됨​

보이는 내용: Cloudbeds는 계속 연결을 수락하지만 설정을 저장한 후 웹훅 복구에 실패합니다.

원인: Cloudbeds는 로그인을 수락했지만 AVA에 필요한 웹훅 권한은 수락하지 않았습니다.

해결:

  1. Settings → Essentials에서 Cloudbeds를 다시 연결합니다.

  2. Cloudbeds 인증 안내를 다시 완료합니다.

  3. 활성 사전 도착 설정을 다시 저장합니다.

  4. 계속 실패하면 Cloudbeds 관리자에게 앱 권한을 검토해 달라고 요청합니다.

    ✓ 권한이 새로 고쳐지면 웹훅 복구가 정상적으로 완료되어야 합니다.

예약이 동기화되지 않음​

보이는 내용: 연결 후 예약이 나타나지 않거나 예약이 누락됩니다.

빠른 해결​

  1. Operations View에서 Refresh를 클릭합니다.
  2. 초기 동기화가 완료될 때까지 5~10분 기다립니다.
  3. PMS에서 오늘 날짜의 예약이 존재하는지 확인합니다.

PMS 설정 확인​

  1. Settings → Essentials로 이동합니다.
  2. PMS Integration 섹션으로 스크롤합니다.
  3. 연결 상태가 "Connected"로 표시되는지 확인합니다.
  4. 동기화 설정이 올바르게 구성되어 있는지 확인합니다.

여전히 작동하지 않나요?​

  • 예약 날짜가 AVA에서 보고 있는 날짜와 일치하는지 확인합니다.
  • PMS의 예약 상태가 동기화를 허용하는지 확인합니다(확정됨, 취소되지 않음).
  • 게스트 수가 0보다 큰지 확인합니다.

동기화 지연​

보이는 내용: 예약이 지연되어 표시됩니다.

정상적인 동작​

대부분의 PMS 시스템은 5~15분마다 동기화됩니다. 실시간 동기화 가능 여부는 다음에 따라 달라집니다.

  • PMS 요금제 수준
  • 특정 PMS 제공업체

지연 줄이기​

  1. 필요할 때 수동 새로고침을 사용합니다.
  2. 실시간 API 액세스에 대해 PMS 제공업체에 문의합니다.
  3. 활동이 적은 시간대에 동기화를 예약합니다.

인증 오류​

보이는 내용: "Invalid credentials" 또는 "Authentication failed"가 표시됩니다.

Cloudbeds의 경우​

  1. Cloudbeds에 로그인합니다.
  2. Settings → Integrations → API로 이동합니다.
  3. 새 API 자격 증명을 생성합니다.
  4. 자격 증명을 정확히 복사합니다(가능하면 복사 버튼 사용).
  5. 수정하지 않고 AVA에 붙여넣습니다.

Opera Cloud의 경우​

  1. AVA가 자동 재시도를 완료할 때까지 최대 30초 기다립니다. 일시적인 OAuth 시간 초과 또는 게이트웨이 오류 한 번을 처리합니다.

  2. 오류가 남아 있을 때만 작업을 다시 시도합니다.

  3. 환경 URL이 올바른지 확인합니다(테스트와 프로덕션 중 해당 환경).

  4. 클라이언트 ID, 클라이언트 시크릿, 호텔 ID 및 enterpriseId를 확인합니다.

  5. Settings → Essentials → PMS Integration에서 자격 증명을 다시 입력한 다음 Save를 클릭합니다.

  6. 오류가 계속 표시되면 Oracle 담당자에게 문의합니다.

    ✓ 일회성 일시 오류 또는 캐시된 자격 증명 오류는 Opera 연결을 끊지 않고도 복구될 수 있습니다.

Mews의 경우​

  1. Mews Commander에 로그인합니다.
  2. Settings → Integrations로 이동합니다.
  3. Vouch AVA를 찾아 액세스 토큰을 재생성합니다.
  4. AVA 설정에서 토큰을 업데이트합니다.

지원팀에 문의해야 할 때​

Cloudbeds 요금 또는 요금제가 사용 불가함​

보이는 내용: Cloudbeds가 연결되지만 캘린더 또는 요금제 작업이 표시되지 않습니다.

원인: 캘린더 읽기와 요금제 변경은 별도의 기능을 사용합니다.

해결:

  1. Operations → Rates & Availability를 새로고침합니다.

  2. Cloudbeds 숙소가 여전히 활성 PMS인지 확인합니다.

  3. 필요한 Cloudbeds 기능이 활성화되어 있는지 AVA 관리자에게 문의합니다.

  4. 판매 가능한 새 요금제는 AVA가 아닌 Cloudbeds에서 만듭니다.

    ✓ Cloudbeds 카탈로그가 표시된다고 해서 모든 작업을 사용할 수 있는 것은 아닙니다.

Cloudbeds ARI 저장이 아직 대기 중임​

보이는 내용: AVA가 요금 또는 제한 변경을 수락했지만 캘린더에는 여전히 이전 값이 표시됩니다.

해결:

  1. Cloudbeds 작업 상태가 완료될 때까지 기다립니다.

  2. 캘린더를 한 번 새로고침합니다.

  3. 같은 날짜와 요금 행을 확인합니다.

  4. 대기 중인 동안 같은 변경 사항을 반복해서 제출하지 마세요.

  5. 게시된 값이 계속 변경되지 않으면 지원팀에 문의합니다.

    ✓ AVA는 Cloudbeds 캘린더에서 값을 확인한 후에만 성공을 표시합니다.

다음과 같은 경우 지원팀에 문의하세요.

  • 모든 문제 해결 단계를 시도했습니다.
  • 오류 메시지에 시스템 오류 또는 기술적 문제가 언급됩니다.
  • 30분 후에도 PMS 변경 사항이 반영되지 않습니다.

이메일: success@vouch-technologies.com

다음 정보를 포함하세요.

  • 오류 메시지 스크린샷
  • PMS 유형 (Cloudbeds/Opera/Mews)
  • 문제가 시작된 시간
  • 이미 시도한 단계