Entitlement 지원 설정

빠른 설정

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

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

이동 경로: Settings → Essentials

구성할 항목

작업	제어되는 항목	사용하는 위치
PMS entitlement support	스캔, 혜택, 활동 기능 표시	Entitlements 페이지
PMS keycard reading	Entitlements에서 실물 카드 스캔 허용	Settings → Room Access
Benefit catalog	혜택 정의 생성 또는 수정	Entitlements → Benefits
Rate plan assignments	혜택을 요금 플랜에 연결	Rates & Availability → Rate Plans
Redemption timing	게스트가 혜택을 사용할 수 있는 시점 설정	Entitlements → Benefits
Ledger sync	사용 내역을 먼저 기록한 다음 PMS와 동기화	Entitlements → Activity

모바일 편집

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

시점이 적용되는 방식

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 지원 확인

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를 클릭합니다.

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

기존 혜택만 사용

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

장부 확인

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 장부를 계속 사용합니다.

혜택을 오늘 사용할 수 없어 보임

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

해결 방법:

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

PMS가 일정을 보내면 AVA는 혜택을 사용 가능하다고 표시하기 전에 해당 일정을 우선 적용합니다. 혜택이 다음 날부터 시작된다면 AVA는 도착일 사용을 차단합니다.

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

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

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

해결 방법:

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

2. 투숙 중인 숙박일에 해당하는 PMS 행을 확인합니다.

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

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

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

아직 해결되지 않았나요?

다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.

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

다음 정보를 함께 보내세요.

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

관련 가이드

• 게스트 Entitlements 확인 및 사용
• 요금 플랜 관리
• Opera PMS Integration
• Mews PMS Integration