본문으로 건너뛰기

Entitlement 지원 설정

빠른 설정

대부분의 호텔은 약 5분 안에 이 설정을 완료합니다. PMS 지원과 관리자 계정 하나만 있으면 됩니다.

Entitlements에 아침 식사와 같은 예약 혜택이 표시되도록 하려면 이 가이드를 사용하세요. 이러한 혜택을 요금 플랜에 연결하고 게스트가 언제 사용할 수 있는지 설정할 때도 도움이 됩니다.

이동 경로: Settings → Essentials

구성할 항목​

작업제어되는 항목사용하는 위치
PMS entitlement support스캔, 혜택, 활동 기능 표시Entitlements 페이지
PMS keycard readingEntitlements에서 실물 카드 스캔 허용Settings → Room Access
Benefit catalog혜택 정의 생성 또는 수정Entitlements → Benefits
Rate plan assignments혜택을 요금 플랜에 연결Rates & Availability → Rate Plans
Redemption timing게스트가 혜택을 사용할 수 있는 시점 설정Entitlements → Benefits
PMS consumption sync적격한 사용 내역을 선택적으로 PMS로 전송Entitlements → Settings
모바일 편집

동일한 혜택 카탈로그가 휴대폰과 데스크톱에 모두 표시됩니다. 달라지는 것은 레이아웃뿐입니다.

시점이 적용되는 방식​

AVA는 영업일, 할당, 적립, 사용 시점과 PMS 일정(있는 경우)을 사용해 혜택 사용 가능 여부를 결정합니다. PMS가 일정을 제공하면 AVA는 먼저 해당 일정을 따릅니다. PMS 데이터가 불완전하면 AVA는 규칙을 안전하게 해석할 수 있을 때만 시점을 계산합니다. Streamliner는 사용에 적용되는 자격 결과에 서명하고, Entitlements 페이지는 서명된 결과를 사용합니다.

따라서 아침 식사와 유사한 혜택이 단순한 달력 날짜가 아니라 호텔 영업일에 맞춰집니다.

영업일과 PMS 일정 날짜​

PMS 일정이 투숙 중인 숙박일을 사용할 때 AVA는 다음 두 날짜를 구분합니다.

  • 호텔 영업일은 직원이 오늘 혜택을 사용할 수 있는지를 결정합니다.
  • PMS 일정 날짜는 읽고 업데이트할 허용량 행을 식별합니다.

예를 들어 8월 28일에 사용한 아침 식사는 8월 27일 날짜의 PMS 행을 사용할 수 있습니다. 명시적인 투숙일 기준이 없는 일정은 계속 호텔 영업일을 사용합니다. 같은 규칙이 일일 혜택과 투숙당 혜택의 유효 날짜에도 적용됩니다.

Mews 게시 날짜​

Mews는 일반적으로 투숙 중인 숙박일에 혜택을 게시합니다. 예를 들어 8월 27일 게시가 8월 28일 아침 식사로 표시될 수 있습니다. Mews 제품 카탈로그를 사용할 수 없을 때도 AVA는 이 숙박일 기준을 유지합니다. 명시적인 당일 일정은 제공된 사용 날짜를 대신 사용합니다. 여기에는 PostingTimeUnit, 도착일 및 출발일 일정이 포함됩니다.

Opera 다음 날 일정

Opera는 투숙 중인 숙박일에 다음 날 패키지를 저장할 수 있습니다. AVA는 Opera의 일정 플래그를 읽고 혜택을 실제 사용 날짜에 배치합니다. 또한 일치하는 PMS 일정 행에 사용 내역을 기록합니다. 예를 들어 8월 28일에 사용한 아침 식사는 Opera의 8월 27일 행을 사용할 수 있습니다.

시작하기 전에​

다음 항목이 준비되어 있는지 확인하세요.

  • Settings → Essentials를 열 수 있습니다.
  • PMS가 예약 혜택을 지원합니다.
  • PMS가 혜택 카탈로그 액세스 또는 요금 플랜 연결을 지원합니다.
  • 카드 스캔이 필요하다면 PMS 제공업체가 실물 키카드 읽기를 검증했습니다.
  • 게스트 숙박에 표시되어야 하는 혜택을 알고 있습니다.
  • 설정 또는 요금 플랜을 수정할 권한이 있습니다.
섹션이 보이지 않나요?

Entitlements 페이지가 비활성화되어 있다면 PMS 지원이 없거나 비활성 상태입니다.

PMS 사용 내역 동기화 선택​

적격한 혜택 사용 내역을 PMS에 반영하려면 이 호텔 수준 설정을 사용하세요. 이 설정은 AVA가 사용 내역을 기록하거나 보고하는 방식을 변경하지 않습니다.

  1. Entitlements → Settings를 엽니다.

  2. PMS consumption sync를 찾습니다.

  3. 스위치를 켜거나 끕니다.

    ✓ AVA가 설정을 자동으로 저장합니다.

Vouch가 PMS에 다시 기록하지 않고 사용 내역을 추적하도록 하려는 경우에는 스위치를 끄세요. 이 설정은 기본적으로 off입니다.

동기화되는 항목

설정이 켜져 있을 때는 적격하며 분할되지 않은 혜택만 동기화됩니다. PMS가 사용 내역 재기록을 지원해야 합니다. 현재 Opera와 AVA가 이 흐름을 지원합니다.

기존 로컬 사용 내역은 로컬에 유지됨

동기화를 켜도 이전의 로컬 전용 사용 내역이 소급 처리되지는 않습니다. 분할된 혜택은 항상 Vouch에 남습니다. 동기화를 비활성화하면 대기 중인 작업이 종료되지만 이미 전송된 요청은 완료될 수 있습니다.

PMS 지원 확인​

  1. Settings → Essentials → PMS Integration을 엽니다.

  2. PMS가 연결되어 있고 활성 상태인지 확인합니다.

  3. Entitlements를 엽니다.

  4. Scan, Benefits, Activity 탭이 보이는지 확인합니다.

    ✓ 지원되는 PMS에는 entitlement 탭이 표시됩니다.

Entitlements는 기능 기반입니다

탭이 보이지 않는다면 PMS가 해당 기능을 노출하지 않는 것입니다. 일부 고객은 스캔하고 사용 내역을 기록하는 기능만 사용할 수 있습니다.

PMS 키카드 스캔 활성화​

실물 카드 스캔에는 PMS 지원과 Room Access 읽기 기능이 모두 필요합니다. 카드 읽기 없이도 객실과 확인 번호를 수동으로 조회할 수 있습니다.

  1. Settings → Room Access → Keycard Encoding을 엽니다.

  2. PMS Integration을 선택합니다.

  3. PMS 공급업체와 인코더 장치가 올바른지 확인합니다.

  4. Enable physical keycard reading을 켭니다.

  5. Save를 클릭합니다.

  6. Entitlements로 돌아가 페이지를 새로 고칩니다.

    ✓ 준비된 스냅샷과 사용 가능한 인코더가 있으면 Start scanning이 표시됩니다.

검증 후에만 읽기를 활성화하세요

이 설정은 기본적으로 꺼져 있습니다. PMS 제공업체가 해당 숙박 시설의 읽기 API가 준비되었다고 확인한 후에만 활성화하세요. 읽기가 꺼져 있어도 인코딩은 계속됩니다.

혜택 카탈로그 관리​

  1. Entitlements → Benefits를 엽니다.

  2. 혜택을 생성할 수 있다면 New benefit를 클릭합니다.

  3. Code와 Name을 입력합니다.

  4. Each guest 또는 Each room으로 혜택을 받는 대상을 설정합니다.

  5. Every night 또는 Once per stay로 적립 빈도를 설정합니다.

  6. 게스트가 혜택을 사용할 수 있는 시점을 선택합니다.

  7. Save benefit를 클릭합니다.

    ✓ 혜택이 카탈로그 목록에 표시됩니다.

PMS 관리 카탈로그

카탈로그가 PMS에서 관리되는 경우 여기에서는 혜택을 보기만 할 수 있습니다. 변경 사항은 PMS 동기화가 업데이트된 후 표시됩니다.

혜택을 요금 플랜에 연결​

  1. Rates & Availability → Rate Plans를 엽니다.

  2. 원하는 요금 플랜을 찾습니다.

  3. Manage benefits 또는 View benefits를 클릭합니다.

  4. 카탈로그에서 기존 혜택을 선택합니다.

  5. 포함할 각 혜택의 수량을 설정합니다.

  6. Save assignments를 클릭합니다.

    ✓ 해당 플랜으로 예약한 게스트가 해당 혜택을 받습니다.

기존 혜택만 사용

이제 요금 플랜에서는 혜택 카탈로그의 항목을 선택합니다. 요금 플랜 모달 안에서는 혜택 정의를 생성하지 않습니다. 할당, 적립 또는 사용 시점을 변경해야 한다면 혜택 자체를 수정하세요.

가져온 혜택을 로컬 사용 항목으로 분할​

하나의 PMS 혜택을 AVA에서 별도의 사용 항목으로 나누어야 할 때 분할을 사용합니다. 예를 들어 가져온 하나의 패키지가 아침 식사와 저녁 라운지 이용을 제공할 수 있습니다.

혜택을 분할하기 전에

분할해도 PMS의 패키지는 변경되지 않습니다. AVA는 분할 사용 내역을 자체 장부에만 기록합니다.

  1. Entitlements → Benefits를 엽니다.

  2. 가져온 PMS 혜택을 찾습니다.

  3. 해당 혜택의 Split 아이콘을 클릭하거나 카탈로그 위의 Add split을 클릭합니다.

  4. Imported PMS benefit code를 선택합니다.

  5. 각 사용 항목에 대해 고유한 Local code와 Display name을 입력합니다.

  6. 각 사용 항목에 대해 Same day 또는 Following day를 선택합니다.

  7. Save split을 클릭합니다.

    ✓ PMS가 정확한 원본 코드를 반환하면 AVA가 하위 사용 항목을 별도로 표시합니다.

하위 사용 항목은 2개에서 10개까지 만들 수 있습니다. 원본 PMS 코드는 대소문자를 구분하며 PMS 응답과 정확히 일치해야 합니다. 각 하위 항목은 설정된 날짜에 원본 허용량을 받습니다.

분할 사용 규칙 이해​

  • AVA는 PMS의 원래 패키지를 그대로 유지합니다.
  • AVA는 각 하위 항목에 자체 로컬 허용량과 활동 항목을 부여합니다.
  • AVA는 하위 항목의 사용 내역을 PMS에 다시 기록하지 않습니다.
  • 다음 날 하위 항목은 원본 투숙 날짜 다음 날짜를 사용합니다.
  • 알 수 없는 원본 일정은 검증되지 않은 상태로 유지되며 사용할 수 없습니다.
기존 사용 내역 보호

하위 항목의 사용 내역이 생긴 후에는 분할을 수정하거나 삭제할 수 없습니다. 원본 혜택을 오늘 이미 사용했다면 새로운 영업일에 분할을 활성화하세요.

분할된 혜택에는 새 허용량이 부여되지 않음​

보이는 현상: 새 분할 하위 항목이 이미 사용되었거나 사용할 수 없는 상태로 표시됩니다.

발생 이유: 해당 날짜에 원본 혜택이 이미 PMS 또는 AVA에서 사용되었습니다.

해결 방법:

  1. PMS에서 원본 혜택의 사용 내역을 확인합니다.
  2. Entitlements → Activity에서 이전 AVA 사용 내역을 확인합니다.
  3. 다른 허용량을 활성화하는 대신 기존 사용 내역을 사용합니다.
  4. 원본 혜택을 오늘 사용했다면 새로운 영업일에 분할을 시작합니다.

장부 확인​

  1. Entitlements → Activity를 엽니다.

  2. 가장 최근의 사용 내역 행을 확인합니다.

  3. 다음 상태 중 하나가 표시되는지 확인합니다.

    • Saved in Streamliner
    • PMS sync pending
    • PMS synced
    • Ledger only
    • PMS sync failed

  4. 동기화에 실패한 항목에는 Retry를 사용합니다.

    ✓ Streamliner가 먼저 사용 내역을 기록합니다. ✓ 지원되는 경우 그 후 PMS 동기화가 진행됩니다.

문제 해결​

"An active PMS connection is required"가 표시됨​

보이는 현상: Settings → Essentials → PMS Integration에 연결된 PMS가 표시되는데도 An active PMS connection is required라는 메시지가 Entitlements 페이지에 표시됩니다.

해결 방법:

  1. PMS 연결을 확인한 후 Entitlements를 새로 고칩니다.
  2. 방금 호텔을 전환했다면 올바른 호텔을 다시 열고 재시도합니다.
  3. 메시지가 계속 표시되면 로그아웃한 후 다시 로그인합니다.

이제 Entitlements는 현재 호텔의 활성 PMS 구성을 읽습니다. 따라서 페이지에 표시되는 연결이 PMS Integration에서 확인하는 연결과 일치합니다.

Entitlements 페이지가 비활성화됨​

보이는 현상: Entitlements 페이지에 비활성화 배너가 표시됩니다.

해결 방법:

  1. 관리자에게 요금제를 확인해 달라고 요청합니다.
  2. PMS 통합이 활성 상태인지 확인합니다.
  3. Entitlements 페이지를 새로 고칩니다.

Benefits 탭이 읽기 전용임​

보이는 현상: 혜택을 볼 수는 있지만 생성하거나 수정할 수 없습니다.

해결 방법:

  1. 카탈로그를 PMS에서 관리하는지 확인합니다.
  2. 관리자에게 설정 쓰기 권한을 요청합니다.
  3. Entitlements를 새로 고칩니다.

요금 플랜 혜택이 저장되지 않음​

보이는 현상: 혜택 창이 닫히지만 플랜에 기존 혜택이 계속 표시됩니다.

해결 방법:

  1. 설정 쓰기 권한이 있는지 확인합니다.
  2. PMS가 요금 플랜 연결을 지원하는지 확인합니다.
  3. 요금 플랜을 다시 열고 한 번 더 저장합니다.

동기화가 계속 대기 중이거나 실패함​

보이는 현상: 활동 행이 계속 대기 중이거나 동기화 실패로 표시됩니다.

해결 방법:

  1. 실패한 행에서 Retry를 클릭합니다.
  2. 재시도가 계속 실패하면 PMS 연결을 확인합니다.
  3. 그동안 Streamliner 장부를 계속 사용합니다.

PMS에 새 사용 내역이 수신되지 않음​

보이는 현상: 사용 내역이 Activity에 표시되지만 PMS에는 전송되지 않습니다.

해결 방법:

  1. Entitlements → Settings를 엽니다.
  2. PMS consumption sync가 켜져 있는지 확인합니다.
  3. PMS가 사용 내역 재기록을 지원하는지 확인합니다.
  4. 혜택이 분할되지 않았는지 확인합니다.

이전에 Ledger only로 기록된 사용 내역은 스위치를 켜도 소급 처리되지 않습니다.

동기화 스위치가 저장되지 않음​

보이는 현상: 스위치가 이전 상태로 돌아가거나 오류가 표시됩니다.

해결 방법:

  1. 역할에 Entitlements 설정을 수정할 권한이 있는지 확인합니다.
  2. 호텔에 필요한 Room Access 결제 액세스 권한이 있는지 확인합니다.
  3. Entitlements를 새로 고친 후 다시 시도합니다.
  4. 오류가 계속되면 지원팀에 문의합니다.

혜택을 오늘 사용할 수 없는 것으로 표시됨​

보이는 현상: 혜택이 카탈로그에는 표시되지만 오늘 투숙에 사용할 수 없습니다.

해결 방법:

  1. 예약 날짜와 호텔 영업일을 확인합니다.
  2. 혜택을 열고 시점 규칙을 검토합니다.
  3. PMS에서 카탈로그를 관리한다면 그곳의 일정을 확인합니다.

PMS가 일정을 보내면 AVA는 혜택을 사용할 수 있는 것으로 표시하기 전에 해당 일정을 따릅니다. 혜택이 다음 날부터 시작되면 AVA는 도착일 사용을 차단합니다.

Opera 또는 Mews에서 오늘 아침 식사를 이용할 수 없다면 투숙 중인 숙박일의 행을 확인하세요.

혜택이 잘못된 일정 날짜를 사용함​

보이는 현상: 혜택은 오늘 사용할 수 있지만 PMS 일정은 이전 숙박일에 표시됩니다.

해결 방법:

  1. 호텔의 현재 영업일을 확인합니다.

  2. 투숙 중인 숙박일의 PMS 행을 확인합니다.

  3. PMS에서 혜택의 일정 기준을 확인합니다.

  4. 다시 시도하기 전에 Entitlements를 새로 고칩니다.

    ✓ AVA는 오늘의 영업일을 기준으로 사용 내역을 기록하고 일치하는 PMS 행을 업데이트해야 합니다.

아직 해결되지 않았나요?​

다음 상황이면 success@vouch-technologies.com으로 문의하세요.

  • ❌ 새로 동기화한 후에도 Entitlements 페이지가 계속 비활성화되어 있습니다.
  • ❌ 혜택이 카탈로그에 전혀 표시되지 않습니다.
  • ❌ 요금 플랜 연결이 저장되지 않습니다.
  • ❌ 활동 행이 대기 상태를 벗어나지 않습니다.

다음 정보를 포함하세요.

  • PMS 이름
  • 혜택 코드 하나 또는 요금 플랜 이름 하나
  • 페이지나 창의 스크린샷