투숙객 혜택 사용 및 추적

빠른 확인

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

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

찾는 위치

이동: Main Menu → Entitlements

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

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

PMS 사용량 동기화 제어

모든 사용 기록은 먼저 Vouch에 저장됩니다. 적격 사용량을 PMS에도 보낼지 선택할 수 있습니다.

1. Entitlements → Settings를 엽니다.
2. PMS consumption sync를 찾습니다.
3. 스위치를 켜거나 끕니다.

스위치는 기본적으로 off입니다. 꺼져 있으면 사용 기록은 Vouch에 남고 Activity 및 보고서에도 계속 표시됩니다. 켜져 있으면 동기화 가능한 미분할 혜택이 지원되는 PMS로 다시 기록할 대기열에 들어갑니다.

동기화를 켜도 이전 기록은 보충되지 않습니다

동기화를 켜도 이전에 로컬에만 저장된 사용 기록이 PMS로 전송되지는 않습니다. 분할 혜택은 동기화가 켜져 있어도 로컬에만 남습니다. 동기화를 끄면 대기 중인 작업이 종료되지만, 이미 전송된 요청은 완료될 수 있습니다.

빠른 참고

동작	위치	기능
Consume 1	혜택 카드의 Scan 탭	선택한 객실 허용량에 1회 사용을 기록
Consume selected quantity	2개 이상의 단위가 남아 있을 때 혜택 카드	선택한 수량을 허용량에 기록
Add benefit	혜택 카드	PMS가 부여를 지원하는 경우 구매 또는 무료 조식 추가
Void unused mornings	예약 혜택 세부 정보	감사 사유와 함께 부여된 미사용 조식을 제거
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에서 가져온 하나의 패키지에서 별도의 하위 혜택이 표시될 수 있습니다. 예를 들어 Breakfast와 Evening Lounge가 별도로 표시될 수 있습니다.

1. 투숙객의 카드를 스캔하거나 수동 조회를 사용합니다.

2. 각 하위 혜택과 사용 가능한 날짜를 확인합니다.

3. 투숙객과 남은 허용량을 확인합니다.

4. Consume 1을 클릭하거나 수량을 선택합니다.

   ✓ AVA가 Streamliner 원장에 하위 혜택 사용 기록을 남깁니다.

분할된 하위 혜택 사용 기록은 설계상 Ledger only입니다. PMS가 원본 패키지를 계속 관리하므로 AVA는 이를 PMS에 다시 기록하지 않습니다. Activity 탭과 내보내기 결과에는 하위 혜택 이름과 로컬 코드가 표시됩니다.

당일 및 다음 날 사용

설정된 날짜 규칙에 따라 각 하위 혜택이 표시되는 시점이 결정됩니다. 다음 날 하위 혜택은 다음 사용 가능 날짜가 될 때까지 사용할 수 없습니다. AVA 패키지에서는 다음 날 날짜가 사용 기록 날짜입니다. AVA는 해당 하위 혜택을 확인하고 Activity 및 상세 내역 보고서에 허용량을 포함할 수 있습니다.

관리자가 결과를 열어 둔 상태에서 분할 설정을 변경하면 AVA는 예약을 다시 조회하도록 요청합니다. 이를 통해 오래된 원본 패키지에 사용 기록이 남는 것을 방지합니다.

오늘 사용 대상이 아닌 경우

버튼 대신 해당 사유가 카드에 표시됩니다. 흔한 사유로는 해당 혜택이 투숙 기간 중 다른 날짜에 해당하거나, 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가 선택한 수량을 하나의 사용 기록으로 기록합니다.

혜택 추가

투숙객에게 추가 조식이나 다른 지원 혜택이 필요할 때 Add benefit을 사용합니다. 이 작업은 PMS가 부여를 지원하고 사용자 역할에 권한이 있을 때만 표시됩니다.

1. 투숙객의 카드를 스캔하거나 예약을 조회합니다.

2. 혜택 카드를 찾아 Add benefit을 클릭합니다.

3. 객실, 혜택, 투숙객 수, 서비스 조식 수를 선택합니다.

4. Purchased 또는 Complimentary를 선택합니다.

5. AVA에 표시된 정산 방법을 선택합니다.

6. 요청된 결제, 채널 또는 승인 세부 정보를 추가합니다.

7. Add benefit을 클릭합니다.

   ✓ AVA가 예약을 새로 고친 후 새 허용량이 표시됩니다.

구매한 혜택은 지원되는 경우 객실 폴리오에 등록될 수 있습니다. 직접 결제 및 OTA 선불 부여에는 일치하는 참조가 필요합니다. 무료 및 이전 날짜 부여에는 사유와 관리자 권한이 필요합니다.

저장하기 전에 합계를 확인하세요

합계에는 여러 투숙객과 여러 조식이 포함될 수 있습니다. Add benefit을 클릭하기 전에 객실, 날짜, 수량 및 정산을 확인하세요.

미사용 조식 무효화

투숙객이 일찍 퇴실했거나 더 이상 조식이 필요하지 않을 때 부여된 조식을 무효화합니다. 사용하지 않은 부여 항목만 무효화할 수 있습니다.

1. 투숙객의 예약 혜택 세부 정보를 엽니다.

2. Void unused mornings를 클릭합니다.

3. 제거할 미사용 조식을 선택합니다.

4. 최소 3자를 입력한 사유를 입력합니다.

5. Void selected를 클릭합니다.

   ✓ AVA가 허용량을 업데이트하고 활동 기록에 무효화를 기록합니다.

유료 부여 항목은 수동 환불이 필요할 수 있습니다

무효화한 조식이 이미 결제된 경우 AVA에 환불 금액이 표시됩니다. 호텔에서 승인한 절차에 따라 투숙객에게 수동으로 환불하세요.

AVA는 PMS에 무효화를 확인하는 동안 잠시 스캔과 사용 기록을 중지합니다. PMS가 명확하게 응답하지 않으면 새로 읽어 확인할 때까지 AVA는 더 낮은 허용량을 유지합니다. 다음 조식을 제공하기 전에 카드를 스캔하거나 예약을 다시 조회하세요.

허용량을 모두 사용한 경우

투숙객이 해당 기간의 허용량을 모두 사용하면 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 consumption sync가 꺼져 있으면 새로 발생한 적격 사용 기록은 로컬에 남고 PMS 대기열에 들어가지 않습니다.

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

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

사용 내역 보고서 내보내기

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

1. Activity 탭을 엽니다

2. Export consumption report를 찾습니다

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

4. Export XLSX를 클릭합니다

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

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

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

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

일일 조식 시트 인쇄

PMS에서 일일 이용 혜택 보고서를 제공하는 경우 Daily breakfast를 사용합니다. 주방에서 오늘 또는 내일 준비해야 할 혜택을 보여줍니다.

1. Daily breakfast 탭을 엽니다.

2. Today 또는 Tomorrow를 선택합니다.

3. 검토할 혜택 코드를 선택합니다.

4. In-house, Departed today 또는 Expected별로 투숙객을 검토합니다.

5. 요금제, 구매 및 무료 출처별 합계를 확인합니다.

6. Print kitchen sheet를 클릭합니다.

   ✓ AVA가 주변 제어 요소 없이 주방용 시트만 인쇄합니다.

보고서에는 객실 이름, 투숙객 이름, 확인 번호, 허용량 및 사용량이 포함됩니다. 배정되지 않은 객실에는 대신 객실 유형이 표시됩니다.

사용 기록, 반전, 부여 및 무효화에는 로그인한 직원의 프로필 이름이 포함될 수 있습니다. AVA는 표시되는 직원 이름에서 이메일 주소를 제외합니다. AVA가 작업자 이름을 소급해 채우지 않으므로 이전 작업은 변경되지 않습니다.

보고서 날짜는 호텔 시간대를 사용합니다

AVA는 현재 영업일과 다음 날을 지원합니다. 조식을 제공하기 전에 시간대 경고를 확인하세요.

일일 시트 경고

표시 내용: 시간대 또는 불완전한 보고서 경고가 표시됩니다.

해결:

1. PMS와 AVA 호텔 시간대가 일치하는지 확인합니다.
2. 보고서를 새로 고칩니다.
3. 날짜가 계속 다르면 관리자에게 호텔 시간대를 수정해 달라고 요청합니다.
4. 불완전한 보고서는 잠정적인 것으로 보고 영향을 받는 예약을 확인합니다.

알아두면 좋은 점

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

문제 해결

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

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

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

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

"Failed to record consumption"

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

확인:

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

"The entitlement allowance for this period has already been used"

현상: 카드에는 아직 사용 가능한 허용량이 표시되지만 이 메시지와 함께 Consume 1이 거부됩니다.

해결:

1. 허용량이 실제로 소진되지 않았다면 Manager override를 사용하지 마세요.
2. 카드를 다시 스캔하거나 새로 수동 조회를 실행합니다.
3. 허용량이 여전히 사용 가능으로 표시되는지 확인합니다.
4. Consume 1을 다시 한 번 시도합니다.

새 결과에도 사용 가능한 허용량이 표시되고 오류가 다시 발생하면 지원팀에 문의하세요.

분할 하위 혜택을 사용할 수 없거나 원본 패키지가 사용된 것으로 표시됨

현상: 분할 하위 혜택에 허용량이 표시되지 않거나 모든 하위 혜택이 사용된 것으로 표시됩니다.

원인: 해당 날짜에 원본 패키지에 이미 PMS 또는 AVA 사용 기록이 있습니다.

해결:

1. PMS에서 원본 패키지 사용량을 확인합니다.
2. 같은 날짜에 더 이른 사용 기록이 있는지 Activity에서 확인합니다.
3. 새 카드 스캔 또는 수동 조회로 예약을 새로 고칩니다.
4. 날짜가 계속 잘못 표시되면 관리자에게 분할 규칙을 검토해 달라고 요청합니다.

분할 사용 기록이 Ledger only로 표시됨

현상: Activity 행에 PMS synced 대신 Ledger only가 표시됩니다.

해결: 조치를 취하기 전에 사유를 확인하세요.

• 분할 하위 혜택은 의도적으로 AVA에만 기록됩니다.
• 사용 기록이 저장될 때 동기화가 꺼져 있었습니다.
• PMS가 사용량을 다시 기록하는 기능을 지원하지 않습니다.

동기화를 켠 뒤에도 이전 기록은 보충되지 않습니다. PMS의 원본 패키지는 변경되지 않습니다.

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

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

해결:

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

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

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

확인:

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

예약이 변경되는 중임

표시 내용: AVA가 변경 확인 중이라고 표시하거나 혜택이 최근에 변경되었다고 표시합니다.

해결:

1. PMS 확인이 완료될 때까지 잠시 기다립니다.
2. 카드를 다시 스캔하거나 예약을 다시 조회합니다.
3. 새 허용량을 확인한 후 사용 처리합니다.

이전 스캔 결과를 계속 제출하지 마세요.

AVA에서 조식을 무효화할 수 없음

현상: AVA가 조식이 이미 사용되었거나 혜택이 분할되었다고 표시합니다.

해결:

• 이미 사용한 수량보다 낮게 무효화할 수 없습니다.
• 오늘 또는 내일 날짜의 분할 혜택은 하나의 원본 패키지로 무효화할 수 없습니다.
• 분할 조식의 선택을 해제하고 나중에 사용 가능한 조식을 별도로 무효화합니다.
• 다른 직원이 변경했다면 다시 시도하기 전에 예약을 새로 고칩니다.

행에 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 행의 스크린샷

관련 가이드

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