권한 지원 설정
대부분의 숙소는 PMS 지원과 관리자 계정 하나만 준비되면 약 5분이면 끝납니다.
이 가이드는 Entitlements에 아침 식사 같은 예약 혜택이 보이도록 설정할 때 사용합니다. 또한 이러한 혜택을 요금제에 연결하고, 게스트가 언제 사용할 수 있는지 정하는 데도 도움이 됩니다.
이동 경로: Settings → Essentials
설정할 항목
| 작업 | 제어 항목 | 사용하는 위치 |
|---|---|---|
| PMS entitlement support | 스캔, 혜택, 활동 기능을 표시 | Entitlements 페이지 |
| Benefit catalog | 혜택 정의 생성 또는 수정 | Entitlements → Benefits |
| Rate plan assignments | 혜택을 요금제에 연결 | Rates & Availability → Rate Plans |
| Redemption timing | 게스트가 혜택을 사용할 수 있는 시점 설정 | Entitlements → Benefits |
| Ledger sync | 먼저 사용 내역을 기록하고, 이후 PMS로 동기화 | Entitlements → Activity |
같은 혜택 목록이 휴대폰과 데스크톱에 모두 나타납니다. 레이아웃만 달라집니다.
시점이 동작하는 방식
AVA는 business date, allocation, accrual, redemption timing, 그리고 필요하면 PMS 일정까지 함께 사용해 사용 가능 여부를 판단합니다. PMS가 일정을 제공하면 AVA는 그 일정을 먼저 따릅니다. PMS 데이터가 불완전하면 AVA는 규칙을 안전하게 해석할 수 있을 때만 시점을 계산합니다. Streamliner는 권한 판정 결과에 서명하고, Entitlements 페이지는 그 서명된 결과를 사용해 사용 내역을 처리합니다.
이렇게 하면 아침 식사 같은 혜택이 달력 날짜가 아니라 호텔 운영 날짜에 맞춰 유지됩니다.
시작하기 전에
다음 항목이 준비되어 있는지 확인하세요:
- Settings → Essentials를 열 수 있습니다.
- PMS가 예약 혜택을 지원합니다.
- PMS가 혜택 카탈로그 접근 또는 요금제 연결을 지원합니다.
- 어떤 혜택이 투숙객 숙박에 보여야 하는지 알고 있습니다.
- 설정 또는 요금제를 수정할 권한이 있습니다.
Entitlements 페이지가 비활성화되어 있으면 PMS 지원이 없거나 비활성 상태입니다.
PMS 지원 확인
-
Settings → Essentials → PMS Integration을 엽니다.
-
PMS가 연결되어 있고 활성 상태인지 확인합니다.
-
Entitlements를 엽니다.
-
Scan, Benefits, Activity 탭이 보이는지 확인합니다.
✓ 지원되는 PMS에서는 권한 관련 탭이 표시됩니다.
탭이 보이지 않는다면 PMS가 해당 기능을 노출하지 않는 것입니다. 일부 숙소는 스캔과 사용만 가능할 수 있습니다.
혜택 카탈로그 관리
-
Entitlements → Benefits를 엽니다.
-
혜택을 만들 수 있으면 New benefit를 클릭합니다.
-
Code와 Name을 입력합니다.
-
Each guest 또는 Each room으로 수령 대상을 정합니다.
-
Every night 또는 Once per stay로 적립 주기를 정합니다.
-
게스트가 언제 사용할 수 있는지 선택합니다.
-
Save benefit를 클릭합니다.
✓ 혜택이 카탈로그 목록에 표시됩니다.
카탈로그가 PMS에서 관리되면 여기에서는 혜택을 보기만 할 수 있습니다. 변경 사항은 PMS 동기화가 업데이트된 뒤 반영됩니다.
혜택을 요금제에 연결
-
Rates & Availability → Rate Plans를 엽니다.
-
원하는 요금제를 찾습니다.
-
Manage benefits 또는 View benefits를 클릭합니다.
-
카탈로그에 있는 기존 혜택을 선택합니다.
-
각 혜택의 포함 수량을 설정합니다.
-
Save assignments를 클릭합니다.
✓ 해당 요금제로 예약된 게스트가 선택한 혜택을 받습니다.
요금제는 이제 혜택 카탈로그에서 선택합니다. 요금제 모달 안에서 혜택 정의를 새로 만들지 않습니다. 할당, 적립, 사용 시점을 바꾸려면 혜택 자체를 수정하세요.
장부 확인
-
Entitlements → Activity를 엽니다.
-
최신 사용 내역 행을 확인합니다.
-
다음 상태 중 하나가 보이는지 확인합니다.
- Saved in Streamliner
- PMS sync pending
- PMS synced
- Ledger only
- PMS sync failed
-
실패한 동기화는 Retry를 사용합니다.
✓ Streamliner가 먼저 사용 내역을 기록합니다. ✓ 지원되는 경우 이후 PMS 동기화가 진행됩니다.
문제 해결
"An active PMS connection is required"가 표시됨
보이는 현상: Settings → Essentials → PMS Integration에 연결된 PMS가 보이는데도 Entitlements 페이지에 An active PMS connection is required가 표시됩니다.
해결:
- PMS 연결을 확인한 뒤 Entitlements를 다시 불러옵니다.
- 방금 호텔을 전환했다면 올바른 호텔을 다시 열고 재시도합니다.
- 메시지가 계속되면 로그아웃한 뒤 다시 로그인합니다.
Entitlements는 이제 현재 호텔의 활성 PMS 구성을 읽습니다. 그렇게 하면 페이지가 PMS Integration에서 보이는 연결과 일치합니다.
Entitlements 페이지가 비활성화됨
보이는 현상: Entitlements 페이지에 비활성 배너가 표시됩니다.
해결:
- 관리자에게 요금제를 확인해 달라고 요청합니다.
- PMS 통합이 활성 상태인지 확인합니다.
- Entitlements 페이지를 다시 불러옵니다.
Benefits 탭이 읽기 전용임
보이는 현상: 혜택은 볼 수 있지만 만들거나 수정할 수는 없습니다.
해결:
- PMS가 카탈로그를 관리하는지 확인합니다.
- 관리자에게 설정 쓰기 권한을 요청합니다.
- Entitlements를 다시 불러옵니다.
요금제 혜택이 저장되지 않음
보이는 현상: 혜택 드로어는 닫히지만 요금제에는 이전 혜택이 그대로 남아 있습니다.
해결:
- 설정 쓰기 권한이 있는지 확인합니다.
- PMS가 요금제 연결을 지원하는지 확인합니다.
- 요금제를 다시 열고 한 번 더 저장합니다.
동기화가 계속 대기 중이거나 실패함
보이는 현상: 활동 행이 계속 대기 상태이거나 동기화 실패로 표시됩니다.
해결:
- 실패한 행에서 Retry를 클릭합니다.
- 재시도가 계속 실패하면 PMS 연결을 확인합니다.
- 그동안은 Streamliner 장부를 계속 사용합니다.
혜택이 오늘 사용할 수 없어 보임
보이는 현상: 혜택은 카탈로그에 보이지만 오늘 숙박에는 사용할 수 없습니다.
해결:
- 예약 날짜와 호텔의 business date를 확인합니다.
- 혜택을 열고 시점 규칙을 확인합니다.
- PMS가 카탈로그를 관리한다면 그쪽 일정도 확인합니다.
PMS가 일정을 보내면 AVA는 혜택을 사용 가능하다고 표시하기 전에 그 일정을 먼저 따릅니다. 혜택이 다음 날부터 시작되면 AVA는 도착일 사용을 차단합니다.
아직 해결되지 않았나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 새로 동기화해도 Entitlements 페이지가 계속 비활성화됨
- ❌ 혜택이 카탈로그에 전혀 나타나지 않음
- ❌ 요금제 연결이 저장되지 않음
- ❌ 활동 행이 대기 상태에서 벗어나지 않음
함께 보내면 좋은 정보:
- PMS 이름
- 혜택 코드 하나 또는 요금제 이름 하나
- 페이지나 드로어 스크린샷