투숙객 혜택 사용 및 추적

빠른 확인

카드를 태그한 다음 Consume 1을 클릭하세요. 클릭하는 순간 사용 기록이 저장되며 PMS의 응답을 기다리지 않습니다.

이 가이드는 레스토랑 입구나 프런트 데스크에서 수행하는 일상 업무를 다룹니다. 조식처럼 요금에 포함된 혜택을 투숙객이 사용했음을 기록하고, 허용량을 이미 모두 사용한 투숙객을 처리하며, 실수를 바로잡고, 이번 달 집계 수치를 내보내는 방법을 설명합니다.

찾는 위치

이동: Main Menu → Entitlements

사용 기록이 아니라 설정을 찾으시나요?

혜택 카탈로그를 연결하거나 혜택을 생성하거나 요금제에 연결하려면 이용 혜택 지원 설정을 참고하세요. 카드를 스캔하고 예약 데이터를 새로 고치려면 투숙객 이용 혜택 스캔을 참고하세요.

빠른 참고

동작	위치	기능
Consume 1	혜택 카드의 Scan 탭	선택한 객실 허용량에 1회 사용을 기록
Consume selected quantity	2개 이상의 단위가 남아 있을 때 혜택 카드	선택한 수량을 허용량에 기록
Manager override	허용량을 모두 사용하면 Consume 1을 대체	사유를 입력한 감사 대상 예외 처리 기록
Undo	Activity 탭	사용 기록을 상쇄하는 취소 항목 추가
Retry	Activity 탭의 실패한 행	사용 기록을 PMS로 다시 전송
Export XLSX	Activity 탭	요약 및 거래 내역 워크북 다운로드

혜택 사용 기록

1. Main Menu → Entitlements로 이동해 Scan 탭에 머무릅니다

2. 온라인 상태의 인코더를 선택하고 Start scanning을 클릭합니다

   카드가 읽히지 않는다면 이 단계는 건너뛰세요 — 수동 조회에는 인코더가 필요하지 않습니다

3. 투숙객의 키카드를 태그하거나 Look up by room 또는 확인 번호로 찾습니다

4. 혜택 카드를 확인합니다 — 허용량, 사용량, 다음 사용 가능 시점이 표시됩니다

5. Consume 1을 클릭합니다

   ✓ 초록색 Saved in Streamliner 배지와 함께 Activity 탭에 사용 기록이 즉시 표시됩니다

6. Done을 클릭해 투숙객 정보를 지우고 다음 카드를 받을 수 있도록 리더를 준비 상태로 되돌립니다

먼저 저장하고, 그다음 동기화합니다

Streamliner는 모든 사용 기록을 자체 원장에 즉시 저장한 뒤 백그라운드에서 PMS로 전송합니다. PMS가 느리거나 사용할 수 없어도 입구에서 투숙객을 기다리게 하지 않으며 사용 기록도 유실되지 않습니다.

오늘 사용 대상이 아닌 경우

버튼 대신 해당 사유가 카드에 표시됩니다. 흔한 사유로는 해당 혜택이 투숙 기간 중 다른 날짜에 해당하거나, PMS에서 일정을 확인하지 못했거나, 투숙객의 요금제에 해당 혜택이 없는 경우가 있습니다.

Opera 조식 날짜

Opera는 다음 날 패키지를 이전 투숙일에 저장할 수 있습니다. AVA는 Opera의 일정 플래그를 사용해 실제 사용 날짜에 혜택을 표시합니다. 호텔 영업일이 사용 가능 여부를 결정하고, 일치하는 PMS 날짜가 허용량 행을 결정합니다. 예를 들어 8월 28일에 사용한 조식이 Opera의 8월 27일 일정 행을 사용할 수 있습니다. 명시적인 투숙일 기준이 없는 일정은 계속 호텔 영업일을 사용합니다.

Mews 조식 날짜

Mews는 일반적으로 점유한 투숙일에 혜택을 등록합니다. 8월 27일 등록 내역이 8월 28일 조식으로 표시될 수 있습니다. Mews 제품 카탈로그를 사용할 수 없을 때 AVA는 이 기본 동작을 유지합니다. PostingTimeUnit을 포함한 명시적인 당일 일정은 제공된 사용 날짜를 사용합니다.

PMS 날짜가 오늘 날짜와 다른 경우

일부 PMS 혜택은 점유한 투숙일을 일정 날짜로 사용합니다. 이 날짜는 오늘의 호텔 영업일보다 이전일 수 있습니다.

• AVA는 사용 가능 여부를 오늘의 영업일 기준으로 확인합니다.
• AVA는 일치하는 PMS 일정 행을 읽고 업데이트합니다.
• PMS에서 유효 날짜를 가져오는 투숙 기간별 혜택도 같은 기준을 따릅니다.

혜택 카드에 사용 가능하다고 표시되면 정상적으로 사용 기록을 남길 수 있습니다. 호텔 영업일을 조정할 필요는 없습니다.

공유 객실 및 그룹 예약

AVA는 같은 객실에 연결된 예약을 하나의 객실 단위 결과로 합칩니다. PMS가 점유 인원을 제공하는 경우 결과에 예약된 점유 인원이 표시됩니다. 또한 Primary, Sharer, Accompany 또는 Guest 라벨이 있는 투숙객 명단도 표시됩니다.

AVA는 정규화된 PMS 가족 메타데이터를 사용해 이 명단을 구성합니다. 업체별 공유 투숙객 식별자를 해석할 필요는 없습니다. Opera 가족 예약은 Primary, Sharer 또는 Member 역할을 사용합니다. Mews 동반자 기록은 Main 또는 Accompany 역할을 사용합니다.

AVA는 연결된 허용량을 합산하지 않습니다. 가장 높은 허용량을 선택하고 허용량이 같으면 Primary를 선택합니다. 사용 기록은 해당 허용량을 제공한 예약에 연결된 상태로 유지됩니다.

혜택을 사용 처리하기 전에 명단으로 투숙객을 확인하세요.

사용 처리 전에 투숙객을 확인하세요

사용 처리하기 전에 투숙객의 명단 라벨과 예약 세부 정보를 확인하세요. 이렇게 하면 잘못된 연결 예약에 사용 기록이 남는 것을 방지할 수 있습니다.

여러 단위를 한 번에 사용하기

단위가 2개 이상 남아 있으면 Quantity to consume 값을 선택합니다. 선택 가능한 수량은 남은 허용량을 초과하지 않습니다.

1. 혜택 카드에서 남은 허용량을 확인합니다.
2. 사용할 단위 수를 선택합니다.
3. 선택한 수량이 표시된 Consume 버튼을 클릭합니다.

✓ Streamliner가 선택한 수량을 하나의 사용 기록으로 기록합니다.

허용량을 모두 사용한 경우

투숙객이 해당 기간의 허용량을 모두 사용하면 Consume 1이 Manager override로 바뀝니다.

1. 예외 처리에 대해 관리자 승인을 받습니다 — 생략할 수 없는 단계입니다

2. Manager override를 클릭합니다

3. Reason for override를 입력합니다 — 최대 300자이며 필수입니다

4. 확인합니다

   ✓ Activity 행에 Manager override가 표시되고 입력한 사유가 함께 기록됩니다

오버라이드는 꼭 필요할 때만 사용하세요

오버라이드는 추가 제공이 아니라 감사 대상 예외 처리입니다. 사유는 사용 기록에 영구 저장되며 내보낸 보고서에도 표시됩니다. 오버라이드에는 특정 권한이 필요하므로 대부분의 직원에게는 이 옵션이 표시되지 않습니다.

실수 바로잡기

1. Activity 탭을 엽니다

2. 사용 기록을 찾습니다

3. Undo를 클릭합니다

   ✓ 항목이 빨간색 취소선으로 표시됩니다

Undo는 어떤 것도 삭제하지 않습니다. 원본을 상쇄하는 취소 항목이 추가되므로 두 기록이 모두 남습니다. 이것이 감사 추적을 정확하게 유지하는 방식이며, 취소 항목 자체를 다시 취소할 수 없는 이유이기도 합니다. 잘못 취소했다면 사용 기록을 다시 남기면 됩니다.

동기화 배지 읽기

모든 Activity 행에는 초록색 Saved in Streamliner 배지가 표시됩니다. 두 번째 배지는 PMS 쪽 진행 상황을 알려줍니다.

배지	의미	조치
PMS sync pending	대기열에 있으며 아직 전송되지 않음	없음 — 자동으로 지워집니다
PMS sync retrying	첫 시도가 실패해 다른 시도가 진행 중	없음 — 기다리세요
PMS synced	PMS에도 기록됨	없음
Ledger only	현재 영업일에 PMS가 이 사용 기록을 받을 수 없음	없음. Streamliner 원장이 기록입니다
PMS sync failed	모든 시도가 실패함	Retry를 클릭하세요. 계속 실패해도 수치는 유효하므로 보고서를 내보내 수동으로 반영하세요

동기화 문제는 투숙객에게 영향을 주지 않습니다

다섯 가지 상태 모두 입구의 투숙객에게는 동일한 의미입니다. 혜택은 사용 처리되었고 허용량도 반영되었습니다. 동기화 상태는 해당 요금이 PMS에 복제되었는지만 나타냅니다.

사용 내역 보고서 내보내기

월말 정산, F&B 청구 또는 오버라이드 확인에 사용하세요.

1. Activity 탭을 엽니다

2. Export consumption report를 찾습니다

3. Start date와 End date를 설정합니다 — 둘 다 기본값은 오늘입니다

4. Export XLSX를 클릭합니다

   ✓ 두 개의 시트가 있는 Vouch 브랜드 워크북이 다운로드됩니다

시트	내용
Summary	영업일과 혜택별로 묶은 합계 — 관리자용 화면
Transactions	오버라이드와 취소를 포함한 모든 개별 사용 기록 — 감사용 화면

기간을 정하기 전에 알아둘 제한 사항:

• 보고서는 최대 90일을 포함할 수 있습니다
• 보고서에는 최대 50,000건의 거래가 포함됩니다
• 미래 영업일은 허용되지 않습니다
• 해당 기간에 사용 기록이 없어도 머리글만 있고 행은 없는 워크북이 다운로드됩니다

알아두면 좋은 점

• 스캔 결과는 약 20분이 지나면 오래된 결과가 됩니다. 사용 제안은 스캔 시점에 표시된 허용량에 연결됩니다. 긴 조식 서비스 동안 카드를 화면에 열어 두면 사용이 거부되므로 다시 스캔하면 정상적으로 처리됩니다.
• Activity에는 오늘 기록만 표시됩니다. 이전 기록은 내보내기를 사용하세요.
• 클릭 1회는 1개 단위를 기록하므로 투숙객의 실제 권한을 확인하세요. 카드에는 남은 허용량과 함께 혜택이 Per guest인지 Per room인지 표시됩니다. 객실별 조식은 인원수와 관계없이 객실 전체에 적용되므로 사람마다 한 번씩 클릭하면 과다 사용됩니다. 제공한 단위마다 Consume 1을 한 번 클릭하고 남은 수량이 없으면 중단하세요.

문제 해결

카드를 화면에 오래 둔 뒤 사용이 거부됨

현상: Consume 1을 클릭하면 만료되었거나 유효하지 않은 자격 확인이라는 메시지와 함께 실패합니다.

원인: 스캔 결과가 약 20분보다 오래되었거나 그 이후 투숙객 데이터가 변경되었습니다.

해결: 카드를 다시 스캔하거나 수동 조회를 다시 실행한 뒤 새 결과에서 사용 처리하세요.

"Failed to record consumption"

현상: 사용 기록이 저장되지 않습니다.

확인:

• 동일한 사용 기록을 이미 저장하지 않았는지 확인 — 다시 시도하기 전에 Activity를 확인하세요
• 새로 스캔했을 때도 혜택이 사용 가능으로 표시되는지 확인하세요
• 역할에 사용 기록 권한이 있는지 확인하세요 — 혜택 조회와 사용 처리는 별도 권한입니다

공유 객실에 잘못된 투숙객이 표시됨

현상: 객실 조회에 여러 투숙객이 포함된 그룹 결과가 표시됩니다.

해결:

1. 명단의 이름과 라벨을 투숙객 세부 정보와 비교합니다.
2. 표시되는 경우 예약된 점유 인원을 확인합니다.
3. Consume 1 또는 수량 버튼을 클릭하기 전에 허용량을 확인합니다.
4. 명단이 잘못되었다면 지원팀에 PMS 예약 검토를 요청합니다.

오버라이드 창을 제출할 수 없음

현상: 오버라이드를 확인해도 아무 일도 일어나지 않습니다.

확인:

• 사유를 입력했는지 확인 — 필수 항목입니다
• 사유가 300자 이하인지 확인합니다
• 허용량이 실제로 모두 소진되었는지 확인합니다 — 오버라이드는 소진된 허용량에만 적용됩니다
• 역할에 오버라이드 권한이 있는지 확인합니다

행에 Undo가 없음

원인: 해당 행 자체가 취소 항목입니다. 취소 항목은 다시 취소할 수 없습니다.

해결: 혜택을 되살리려면 Scan 탭에서 사용 기록을 다시 남기세요.

내보내기가 실행되지 않음

현상: 다운로드 대신 날짜 관련 메시지 중 하나가 표시됩니다.

메시지	해결
"Select a start and end date"	두 필드를 모두 입력하세요
"The start date must be on or before the end date"	날짜를 바꾸세요
"Reports cannot include future business dates"	오늘 또는 이전 날짜로 종료하세요
"Choose a date range of 90 days or fewer"	더 짧은 기간으로 나누세요
"This report has too many transactions"	기간을 줄이세요 — 상한은 50,000행입니다

여전히 해결되지 않나요?

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

• ❌ 여러 번 재시도한 뒤에도 사용 기록이 PMS sync failed 상태로 유지되는 경우
• ❌ 새로 스캔해도 투숙객의 허용량이 잘못 표시되는 경우
• ❌ 내보낸 합계가 팀에서 기록한 내용과 일치하지 않는 경우

함께 보내주시면 좋은 정보:

• 투숙객의 객실 번호 또는 확인 번호
• 사용 기록의 날짜와 시각
• 배지를 포함한 Activity 행의 스크린샷

관련 가이드

• 투숙객 이용 혜택 스캔
• 이용 혜택 지원 설정
• 요금제 관리