본문으로 건너뛰기

Mews PMS 연동 설정

빠른 설정

대부분의 숙소는 Access Token만 있으면 됩니다. 약 10분 정도 걸립니다.

이 가이드는 AVA를 Mews에 연결해 예약과 투숙객 정보가 올바르게 동기화되도록 돕습니다.

위치 확인​

Settings → Essentials → Property Management System (PMS) Integration

빠른 참고​

설정제어 항목사용할 때
Access TokenAVA와 Mews를 연결합니다항상
Advanced → Client Token고급 연결 자격 증명지원팀이 요청할 때만
Advanced → Client IDMews에서의 숙소 식별자지원팀이 요청할 때만
Advanced → Demo Mode테스트용 샌드박스 엔드포인트를 사용합니다테스트 환경에서만
Reservation commentsMews 서비스 주문 메모를 AVA로 가져옵니다AVA가 예약을 읽을 때
Room payment waiver반환된 인보이스를 사용해 면제 여부를 판단합니다인보이스가 객실 결제 면제를 표시할 때
Payment waiver keywordsAVA 결제 설정에서 면제 키워드 필드를 표시합니다Mews 연결이 키워드 면제 지원을 노출할 때만

시작하기 전에​

다음이 필요합니다.

  • Mews 관리자 영역 접근 권한
  • AVA 연동용 Access Token / Token ID
  • AVA에서 PMS 설정을 업데이트할 관리자 권한
정보

Access Token이 없다면 Mews 관리자나 AVA 지원팀에 문의하세요.

Mews Access Token 가져오기​

Mews에서 다음 단계를 따르세요.

  1. Mews PMS에 로그인합니다.

  2. 사이드바에서 Marketplace를 클릭합니다.

    Mews Marketplace Search

  3. My Subscriptions를 클릭합니다.

    Mews Subscriptions

  4. Vouch AVA Front Desk Agent를 찾습니다.

  5. Edit를 클릭합니다.

  6. Access Token 섹션을 엽니다.

  7. Token ID를 복사합니다.

    Mews Access Token

팁

토큰을 잃어버리지 않도록 바로 AVA에 붙여넣으세요.

설정 단계​

1단계: Mews 선택​

  1. Settings → Essentials → PMS Integration로 이동합니다.
  2. Mews 카드를 클릭합니다.
  3. Mews 설정 양식이 나타납니다.

2단계: Access Token 입력​

  1. Mews의 Token ID를 Access Token 필드에 붙여넣습니다.
  2. 보안을 위해 저장 후 토큰은 숨김 처리됩니다.
마스킹된 값은 안전합니다

나중에 돌아와서 마스킹된 문자가 보여도 그대로 두고 Save를 클릭하세요. AVA는 저장된 Access Token, Client Token, Client ID를 유지합니다.

Advanced Mews 설정이 필요한 경우(지원팀 전용)
  1. Advanced를 클릭합니다.
  2. 지원팀이 제공한 값을 입력합니다.
    • Client Token
    • Client ID
  3. 선택 사항: 샌드박스 엔드포인트로 테스트 중이라면 Demo Mode를 켭니다.
경고

지원팀이 지시하지 않는 한 Advanced 값을 변경하지 마세요. 잘못된 값은 동기화를 중단할 수 있습니다.

3단계: 저장​

  1. 페이지 하단에서 Save를 클릭합니다.
  2. 성공 메시지를 확인합니다.
  3. 비밀 정보를 보호하기 위해 Access Token 필드에는 자리표시자가 표시됩니다.

연결 후 발생하는 일​

  • ✅ AVA가 예약과 투숙객 정보에 Mews 데이터를 사용하기 시작합니다
  • ✅ Access Token 필드에 마스킹된 문자가 표시됩니다
  • ✅ 나중에 토큰을 업데이트해야 하면 Edit Token을 사용합니다
  • ℹ️ 다른 Mews 필드를 저장할 때도 AVA는 현재 Demo Mode 값을 유지합니다.
  • ℹ️ 운영 환경에서는 Demo Mode를 자동으로 OFF로 바꾸지 않습니다.
  • ✅ AVA가 예약 소스 레이블을 해석할 수 있으면 Mews 회사 이름을 채워 넣습니다.
  • ✅ AVA의 Mews 예약은 호텔 수납(hotel collect)으로 처리됩니다.
  • ✅ Do Not Move 객실 잠금 상태가 Mews와 동기화됩니다.
  • ✅ AVA는 자동 배정 중에 차단된 Mews 객실을 건너뛰고, 가능하면 다른 깨끗한 객실을 다시 시도합니다.
  • ✅ AVA가 Mews 서비스 주문 메모를 예약 댓글로 가져옵니다.
  • ✅ 일치하는 메모는 인보이스에 면제 표시가 있으면 객실 결제를 면제할 수 있습니다.
  • ✅ AVA는 단일 예약 조회에서 면제를 확인하기 전에 전체 인보이스 세부 정보를 불러옵니다.
  • ✅ AVA는 다중 객실 예약에서 배정되지 않은 Mews 객실을 계속 표시합니다.

게스트 및 직원에게 미치는 영향​

  • 게스트 양식은 Mews 규칙에 맞게 조정됩니다. 필수 필드와 숨김 필드는 Mews 설정에 따라 달라지므로, 게스트는 필요한 항목만 보게 됩니다.
  • 예약 조회는 Mews를 사용합니다. Mews가 설정되지 않으면 게스트 조회 단계가 실패합니다.
  • 예약 소스 레이블에 Mews 회사 이름이 표시될 수 있습니다. AVA가 회사 이름을 해석할 수 있으면 원시 회사 ID 대신 그 이름을 사용합니다.
  • Mews 소스 collect는 이제 기본적으로 hotel collect입니다. 이렇게 하면 소스 레이블이 AVA가 받는 예약 계약과 일치합니다.
  • 잠긴 객실은 AVA에서도 잠김 상태로 유지됩니다. Mews가 예약을 잠금 상태로 표시하면, Streamliner는 객실 변경 화면에서 잠금 아이콘을 보여줍니다.
  • 서비스 주문 메모는 예약 댓글이 됩니다. 직원은 예약 조회 중에 메모 텍스트를 검토할 수 있습니다.
  • 면제된 객실 결제는 계속 설명 가능합니다. Mews가 인보이스를 면제로 표시하면 AVA는 메모 텍스트를 면제 사유로 보여 줍니다.
  • 결제 면제 키워드는 기능 지원 여부에 따라 달라집니다. Mews가 이를 노출하면 AVA는 결제 설정에 면제 키워드 필드를 표시합니다.

다중 객실 예약은 그대로 유지됩니다​

AVA는 Mews가 실제 객실을 배정하기 전에도 예약된 각 Mews 객실을 계속 표시합니다. 주 객실은 목록의 맨 앞에 유지됩니다. 이렇게 하면 직원이 조회와 체크인 중에 전체 예약을 확인할 수 있습니다.

공유 예약 이메일은 별도 게스트를 만듭니다​

두 게스트가 같은 예약 이메일을 공유하면 AVA는 별도의 Mews 고객을 만듭니다. AVA는 문서 번호가 기존 기록과 일치할 때만 고객을 재사용합니다. AVA가 이미 직접 Mews 게스트 참조를 가지고 있으면, 그 게스트를 계속 업데이트합니다.

정확한 일치

AVA는 waiver keyword를 단어 전체로 일치시킵니다. PAID는 UNPAID와 일치하지 않습니다.

문제 해결​

"액세스 토큰이 필요합니다" 오류​

보이는 내용: "액세스 토큰이 필요합니다"

해결:

  1. Mews의 Token ID를 붙여넣습니다.
  2. Save를 다시 클릭합니다.
  3. ✓ 저장되면 오류가 사라집니다.

토큰은 저장됐지만 데이터가 동기화되지 않음​

보이는 내용: 토큰은 저장했지만 예약이 나타나지 않습니다.

해결:

  1. 첫 동기화를 위해 10-15분 기다립니다.
  2. 페이지를 새로고침하고 Mews가 계속 선택되어 있는지 확인합니다.
  3. Mews 관리자에게 AVA 구독이 활성 상태인지 확인해 달라고 요청합니다.
  4. 문제가 계속되면 AVA 지원팀에 문의합니다.

새로고침 후 마스킹된 필드가 다시 표시됨​

보이는 내용: 페이지를 새로고침하면 Access Token 또는 고급 필드에 마스킹된 문자가 표시됩니다.

해결:

  1. 마스킹된 값은 그대로 둡니다.
  2. Save를 다시 클릭합니다.
  3. ✓ AVA가 저장된 Mews 자격 증명을 유지합니다.

Client Token, Client ID, Demo Mode를 찾을 수 없음​

보이는 내용: Client Token, Client ID, Demo Mode 필드가 보이지 않습니다.

해결:

  1. Advanced를 클릭합니다.
  2. ✓ 고급 필드가 Advanced 섹션 안에 나타납니다.

Demo Mode가 켜져 있는데 동기화가 이상함​

보이는 내용: 예약이 누락되거나 예상치 못한 테스트 데이터가 표시됩니다.

해결:

  1. Demo Mode를 끕니다.
  2. Save를 클릭합니다.
  3. 페이지를 새로고침하고 연결 상태를 확인합니다.
  4. 문제가 계속되면 지원팀에 문의합니다.

Demo Mode가 저장 후 일치하지 않음​

보이는 내용: 새로고침 후 Demo Mode 체크박스가 바뀌거나, 저장된 Mews 설정과 일치하지 않습니다.

해결:

  1. Advanced를 엽니다.
  2. Demo Mode 값을 확인합니다.
  3. 원하는 변경 사항만 저장합니다.
  4. 페이지를 새로고침합니다.
  5. 체크박스가 여전히 저장된 Mews 설정과 다르면 지원팀에 문의합니다.

객실 변경 화면에서 객실이 보이지 않음​

보이는 내용: 객실이 Allow move room에 표시되지 않습니다.

해결:

  1. Mews에서 해당 예약을 확인합니다.
  2. 객실을 이동 가능하게 해야 한다면 객실 잠금을 해제합니다.
  3. AVA에서 예약을 새로고침합니다.
  4. 객실 변경을 다시 시도합니다.

객실 결제가 아직 청구 가능함​

보이는 내용: Mews 예약에서 여전히 객실 결제를 요구합니다.

해결:

  1. Mews에서 해당 예약을 엽니다.
  2. 서비스 주문 메모를 확인합니다.
  3. 메모에 정확한 면제 문구가 사용되었는지 확인합니다.
  4. AVA에서 예약을 새로고칩니다.
  5. 결제가 계속 표시되면 지원팀에 문의합니다.

Mews 차단 객실 배정​

보이는 내용: 체크인 또는 객실 변경에서 "공간이 차단됨" 또는 "객실을 사용할 수 없음"이 표시됩니다.

해결:

  1. AVA가 다른 깨끗한 객실을 시도할 때까지 기다립니다.
  2. 깨끗한 객실이 없으면 Mews에서 다른 객실을 배정합니다.
  3. AVA를 새로고침하고 다시 시도합니다.

면제 사유가 잘못 보임​

보이는 내용: AVA가 객실 결제를 면제했지만, 사유 텍스트가 예상과 다릅니다.

해결:

  1. 일치한 Mews 서비스 주문 메모를 확인합니다.
  2. 메모 텍스트가 예상한 내용인지 확인합니다.
  3. AVA는 단어 전체로만 일치시킨다는 점을 기억합니다.
  4. 면제 사유가 여전히 이상하면 지원팀에 문의합니다.

확인 체크리스트​

  • Mews가 Select PMS Provider에서 선택됨
  • Access Token이 오류 없이 입력되고 저장됨
  • 새로고침 후 Access Token 필드에 마스킹된 문자가 표시됨
  • 예약이 Mews에서 동기화되기 시작함

아직도 막혔나요?​

다음에 해당하면 success@vouch-technologies.com으로 문의하세요.

  • ❌ 15분이 지나도 동기화가 시작되지 않음
  • ❌ 해결할 수 없는 저장 오류가 표시됨
  • ❌ Advanced 설정이 필요한데 값이 없음

함께 보내면 좋은 정보:

  • PMS Integration 섹션 스크린샷
  • 사용 중인 PMS 제공사(Mews)
  • 정확한 오류 문구가 있다면 그 내용