투숙객 권한 스캔

빠른 확인

대부분의 스캔은 1분 이내에 완료됩니다. 각 영업일의 첫 새로고침에서는 가벼운 예약 목록을 생성합니다. 권한 세부 정보는 예약을 선택한 후에만 로드됩니다.

투숙객 카드를 스캔하거나, 예약 데이터를 새로고침하거나, 수동 조회를 사용해야 할 때 이 가이드를 이용하세요. 일반 새로고침은 변경되지 않은 예약을 재사용합니다. 따라서 대부분의 업데이트가 더 빨라지고 PMS 읽기 작업이 줄어듭니다.

영역	기능	예상 결과
Scan	오늘의 스냅샷을 기준으로 투숙객 키카드를 읽음	일치하는 예약이 화면에 열림
Refresh	오늘의 예약 스냅샷을 다시 생성	배너에 진행률, 개수, 준비 상태가 표시됨
Manual lookup	객실 또는 확인 번호로 예약을 찾음	카드가 읽히지 않아도 계속 작업 가능
Benefits	혜택 정의 및 요금제 할당을 관리	PMS가 지원하는 작업만 표시
Activity	오늘의 사용 내역 및 동기화 상태를 표시	실패한 동기화를 취소하거나 다시 시도 가능

페이지 열기

1. Entitlements를 엽니다.

2. Scan 탭에서 시작합니다.

3. 카드 스캔이 필요하면 연결된 인코더를 선택합니다.

   ✓ 스냅샷이 준비되면 Start scanning 버튼을 사용할 수 있습니다.

PMS 기반 키카드 리더

해당 연결에서 키카드 읽기를 지원한다고 알리면 AVA는 PMS 기반 리더를 통해 스캔할 수 있습니다. 리더는 사용 가능한 다른 인코더와 함께 표시됩니다. 숙소의 Enable physical keycard reading 설정도 켜져 있어야 합니다.

Opera 카드 스캔

Opera 카드 스캔은 객실 및 유효성 세부 정보를 제공하지만 투숙객 이름은 제공하지 않습니다. 권한을 관리하기 전에 일치하는 예약 세부 정보로 투숙객을 확인하세요.

예약 데이터 새로고침

이 페이지는 호텔의 현재 영업일에 대한 로컬 스냅샷을 유지합니다. 일반 새로고침은 증분 방식으로 수행됩니다. PMS 예약 개정이 변경되지 않은 경우 성공적으로 읽은 세부 정보를 재사용합니다. 새로고침은 현재 투숙 중인 예약 목록만 읽습니다. 모든 예약의 권한 세부 정보를 로드하지는 않습니다. 오늘 체크아웃 예정인 투숙객도 객실에 머무는 동안에는 계속 대상에 포함됩니다. 일부 PMS는 이러한 숙박을 CHECKED_IN 대신 DUE_OUT 또는 Due Out으로 표시합니다.

1. 일반 업데이트를 하려면 Refresh를 클릭합니다.

2. 세부 정보가 오래되어 보이거나 전체 재생성이 필요하면 Refresh + clear cache를 클릭합니다.

3. 상태 배너가 준비 상태로 바뀔 때까지 기다립니다.

   ✓ 이제 페이지에서 카드를 다시 스캔할 수 있습니다.

자동 새로고침

활성 스냅샷이 없으면 AVA가 첫 새로고침을 자동으로 시작합니다. 새로고침이 당일 데이터 일부만 반환해도 AVA는 사용 가능한 행을 화면에 유지합니다. 기존 스냅샷 전용 스캔은 새로고침이 실행되는 동안에도 사용할 수 있습니다. PMS가 새로고침을 제한하기 시작하면 AVA는 해당 실행을 중지합니다. 마지막으로 사용할 수 있었던 스냅샷은 계속 표시합니다.

새로고침 개수 읽기

상태 배너에 이제 새로고침 진행 개수가 표시됩니다.

개수	의미	중요한 이유
Fetched	PMS에서 새로 읽은 예약	개수가 높을수록 새 예약 또는 변경된 행이 많음
Reused	이전 스냅샷에서 이어온 예약	재사용 개수가 높을수록 일반적으로 새로고침이 더 빠름
Deferred	고유한 선택을 기다리는 예약 세부 정보	아직 PMS 읽기 작업이 필요하지 않은 세부 정보
Hydrated	권한 세부 정보가 로드된 예약	AVA가 확인한 세부 정보의 양을 나타냄
Pages	새로고침 중 읽은 PMS 예약 목록 페이지	느리거나 비정상적으로 깊은 목록 스캔을 파악하는 데 도움

출발일 투숙객

PMS가 숙박을 체크아웃 처리할 때까지 AVA는 투숙객을 권한 대상 목록에 유지합니다. 아침 식사 또는 다른 출발일 혜택을 제공하기 전에 스냅샷을 새로고침하세요.

스냅샷은 hydrated 예약과 deferred 예약을 별도로 추적합니다. 세부 정보가 deferred 상태로 남아 있는 동안 권한 합계는 하한값일 수 있습니다. 모든 예약이 로드되거나 혜택이 없다고 반환된 후에 완전한 값이 됩니다.

예약 세부 정보 로드

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

2. 여러 객실 일치 항목이 나타나면 객실 결과를 선택합니다.

3. AVA가 해당 예약의 권한 세부 정보를 로드하는 동안 기다립니다.

   ✓ 혜택 없음 결과를 포함한 성공한 결과는 영업일 동안 캐시됩니다.

반복되는 스캔과 조회는 캐시된 결과를 재사용합니다. 세부 정보 읽기 실패는 선택한 예약에만 영향을 줍니다. AVA는 재시도하기 전에 대기하며, 속도 제한 응답이 이 대기 시간을 늘릴 수 있습니다.

Opera 익일 혜택

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

Mews 게시 날짜

Mews는 일반적으로 점유된 숙박일에 혜택을 게시합니다. 따라서 8월 27일 게시가 8월 28일 아침 식사로 표시될 수 있습니다. Mews 제품 카탈로그를 사용할 수 없을 때 AVA는 이 기본 동작을 유지합니다. PostingTimeUnit을 포함한 명시적 당일 일정은 제공된 사용 날짜를 사용합니다.

PMS 날짜가 오늘 날짜와 다를 때

일부 PMS 혜택은 점유된 숙박일을 일정 날짜로 사용합니다. 이는 익일 아침 식사 패키지에서 흔히 발생합니다.

• AVA는 투숙객이 오늘의 호텔 영업일에 혜택을 사용할 수 있는지 확인합니다.
• AVA는 일치하는 PMS 일정 날짜를 읽고 업데이트합니다.
• 숙박 기준으로 유효 날짜가 정해지는 숙박별 혜택도 일치하는 일정을 사용합니다.

호텔 영업일을 수동으로 변경할 필요는 없습니다.

가족 예약 처리

AVA는 같은 객실에 연결된 예약을 하나의 객실 수준 결과로 그룹화합니다. 여기에는 블록 예약, 여러 객실 예약, 동반 투숙객이 있는 예약이 포함됩니다.

AVA는 연결에서 제공하는 PMS 예약 패밀리를 사용합니다. 벤더별 공유 투숙객 코드를 사용해 연결된 투숙객을 식별할 필요는 없습니다. Opera 가족 예약은 정규화된 Primary, Sharer 또는 Member 역할을 사용합니다. Mews 동반자 레코드는 정규화된 Main 또는 Accompany 역할을 사용합니다.

결과에는 다음이 표시될 수 있습니다.

• PMS가 제공하는 경우 성인 및 아동을 포함한 Booked occupancy
• Primary, Sharer, Accompany 또는 Guest로 표시된 투숙객 목록
• 객실 예약 그룹에 선택된 허용량

AVA는 연결된 예약의 허용량을 합산하지 않습니다. 가장 높은 허용량을 사용하며, 허용량이 같으면 Primary를 선택합니다. 사용 내역은 허용량을 제공한 예약에 계속 연결됩니다.

혜택을 기록하기 전에 목록을 사용해 서비스를 제공할 투숙객을 확인하세요.

알 수 없는 점유율은 계속 알 수 없음

PMS가 예약 점유율을 제공하지 않으면 AVA는 해당 값을 비워 둡니다. 거짓된 0을 표시하지 않습니다.

제한된 새로고침 처리

새로고침이 완료될 것으로 예상한 시점보다 일찍 중지되면 이 절차를 사용하세요. 평소보다 적은 수의 예약이 fetched로 표시될 수도 있습니다.

1. 다시 시도하기 전에 1분 기다립니다.

2. Refresh를 다시 클릭합니다.

3. 현재 스냅샷이 오늘의 투숙객을 계속 포함한다면 이를 계속 사용합니다.

4. 계속 발생하면 관리자에게 PMS 속도 제한을 확인해 달라고 요청합니다.

   ✓ AVA는 PMS가 새로고침을 제한할 때 새로고침이 완료된 것처럼 가장하지 않습니다.

카드 스캔

1. Entitlements를 엽니다.
2. Scan 화면에 머뭅니다.
3. 온라인 인코더를 선택합니다.
4. Start scanning을 클릭합니다.
5. 투숙객 키카드를 태그합니다.
6. 일치하는 예약을 검토합니다.
7. 투숙객이 권한을 사용할 때 Consume 1을 클릭합니다.
8. 관리자가 예외를 승인한 경우에만 Manager override를 클릭합니다.
9. 해당 투숙객에 대한 작업을 마치면 Done을 클릭합니다.

✓ 배너에 잠시 Card scanned — ready for the next card in a moment가 표시됩니다. ✓ 그다음 스캔 상태가 Ready — tap the next card at any time로 돌아갑니다.

수동 조회 사용

카드가 읽히지 않거나 객실 기준 검색이 필요할 때 수동 조회를 사용합니다. AVA는 유료 권한 읽기를 시작하기 전에 숙박 날짜를 확인합니다. 날짜가 없거나 유효하지 않으면 먼저 예약을 수정하세요.

1. 객실 번호를 알고 있으면 Look up by room을 사용합니다.
2. 예약 참조 번호를 알고 있으면 Look up by confirmation number를 사용합니다.
3. 예약 카드가 나타날 때까지 기다립니다.
4. 스캔 결과와 같은 방식으로 권한 카드를 사용합니다.

수동 조회를 시작하면 검색이 시작되기 전에 활성 카드 읽기가 중지됩니다. 조회 중에는 Start scanning, 인코더 및 후보 컨트롤이 잠깁니다. 여러 객실 결과가 일치하면 하나를 선택해 카드 없이 조회를 계속할 수 있습니다.

실시간 대체

수동 조회가 캐시에서 결과를 찾지 못하면 AVA가 PMS를 실시간으로 확인할 수 있습니다. 해당 결과는 다음 새로고침에 포함될 때까지 메모와 함께 표시됩니다.

스냅샷 상태 읽기

배너 문구	의미	해야 할 일
in-house reservations ready	스냅샷이 스캔 준비됨	스캔 시작
Refreshing PMS reservations…	AVA가 스냅샷을 다시 생성하는 중	새로고침이 끝날 때까지 기다림
using earlier same-day data	당일 새로고침은 실패했지만 사용 가능한 데이터가 남아 있음	가능할 때 다시 새로고침
unavailable until the next refresh	해당 예약을 아직 사용할 수 없음	새로고침하거나 수동 조회 사용
Reservation data must be refreshed before scanning	준비된 스냅샷이 아직 없음	Refresh 클릭

페이지에 경고가 표시될 때

PMS 접근 권한이 없거나, 지원되지 않거나, 제한되거나, 사용할 수 없을 때 페이지에 경고가 표시됩니다. 이러한 경우에도 기존 스냅샷은 계속 표시될 수 있습니다.

혜택 및 활동

다른 탭도 계속 같은 방식으로 작동합니다.

• Benefits에는 PMS가 제공하는 경우 혜택 카탈로그가 표시됩니다.
• Activity에는 오늘의 사용 내역, 취소 작업 및 재시도 작업이 표시됩니다.
• PMS에서 허용하면 Rate plan assignments는 Benefits에 계속 표시됩니다.

취소하면 표시된 권한 개수가 즉시 업데이트됩니다. 활성 카드 스캔을 중단할 수 있는 후속 새로고침이 필요하지 않습니다.

문제 해결

보이는 현상: 스캔하기 전에 예약 데이터를 새로고쳐야 함

해결:

1. Refresh를 클릭합니다.
2. 준비 상태가 될 때까지 기다립니다.
3. 필요하면 Refresh + clear cache를 클릭합니다.
4. 배너가 업데이트되지 않으면 Entitlements를 다시 엽니다.

보이는 현상: 페이지에 PMS 경고가 표시됨

해결:

1. 현재 스냅샷을 계속 사용할 수 있으면 이를 사용합니다.
2. 관리자에게 PMS를 다시 연결하거나 기능 접근을 복구해 달라고 요청합니다.
3. PMS 문제가 해결된 후 다시 새로고침합니다.

보이는 현상: 새로고침이 일찍 중지되거나 제한 경고가 표시됨

해결:

1. 재시도 대기 시간이 지나갈 때까지 기다립니다.
2. 예약을 다시 선택합니다.
3. 다른 투숙객에게는 현재 스냅샷을 사용합니다.
4. 계속되면 관리자에게 PMS 속도 제한을 확인해 달라고 요청합니다.

보이는 현상: 권한 세부 정보를 아직 로드하는 중임

발생 이유: AVA는 고유한 예약을 선택한 후에만 세부 정보를 로드합니다. 예약 목록은 준비되어도 권한 세부 정보는 deferred 상태로 남을 수 있습니다.

해결:

1. 예약이 하나로 고유하게 선택되었는지 확인합니다.
2. 세부 정보 읽기가 끝날 때까지 기다립니다.
3. PMS 수정 내용이 더 최신이면 Refresh + clear cache를 클릭합니다.
4. 세부 정보를 계속 사용할 수 없으면 PMS 연결을 확인합니다.

보이는 현상: 수동 조회가 사용할 수 있는 결과를 반환하지 않음

해결:

1. 예약에 유효한 숙박 날짜가 있는지 확인합니다.
2. 객실 번호 또는 확인 번호가 올바른지 확인합니다.
3. PMS에서 예약을 새로고친 후 다시 시도합니다.
4. 스냅샷이 여전히 오래되어 보이면 Refresh + clear cache를 사용합니다.

보이는 현상: 수동 조회가 스캔을 다시 시작하거나 더 최신 결과를 대체함

발생 이유: 이전 스캔 또는 조회 응답이 아직 완료되는 중일 수 있습니다.

해결:

1. 현재 조회가 완료될 때까지 기다립니다.

2. 실행 중에는 인코더를 변경하거나 다른 후보를 선택하지 않습니다.

3. 올바른 객실 또는 확인 번호로 조회를 다시 시작합니다.

   ✓ AVA는 최신 결과를 유지하며 수동 조회 때문에 스캔을 다시 시작하지 않습니다.

보이는 현상: 스캔에 여러 예약이 표시되거나 일치하는 예약이 없음

해결:

1. 연결된 예약이 여러 개 일치하면 객실 수준 결과를 엽니다.
2. 선택한 인코더가 온라인인지 확인합니다.
3. Look up by room 또는 Look up by confirmation number를 사용합니다.
4. 목록의 역할 표시를 사용해 서비스를 제공할 투숙객을 확인합니다.
5. 결과가 여전히 이상하면 지원팀에 예약 매핑을 검토해 달라고 요청합니다.

보이는 현상: 객실 허용량이 너무 높아 보임

보이는 내용: 그룹화된 객실 결과에 연결된 여러 예약에 대해 하나의 허용량이 표시됩니다.

발생 이유: AVA는 가장 높은 예약 허용량을 선택합니다. 연결된 예약의 허용량을 절대 합산하지 않습니다.

해결: Primary, Sharer 및 Accompany 표시를 확인합니다. 선택된 허용량이 PMS와 다르면 지원팀에 문의하세요.

보이는 현상: 오늘 출발하는 투숙객이 누락됨

보이는 내용: 투숙객이 아직 객실에 있지만 객실 조회에서 일치하는 활성 예약이 없다고 표시됩니다.

발생 이유: PMS가 출발일 숙박을 DUE_OUT 또는 Due Out으로 표시할 수 있습니다.

해결:

1. 투숙객이 PMS에서 체크아웃하지 않았는지 확인합니다.

2. Entitlements에서 Refresh를 클릭합니다.

3. 객실 또는 확인 번호로 다시 검색합니다.

4. 투숙객이 계속 표시되지 않으면 Refresh + clear cache를 사용합니다.

   ✓ AVA는 체크아웃이 완료될 때까지 체크인 및 due-out 숙박을 대상에 포함합니다.

보이는 현상: 가족 예약에 잘못된 허용량이 표시됨

보이는 내용: 블록 예약, 여러 객실 예약 또는 동반 투숙객 예약에 예상한 혜택이 표시되지 않습니다.

해결:

1. PMS에서 예약을 새로고칩니다.
2. Entitlements에서 Refresh + clear cache를 클릭합니다.
3. 객실 또는 확인 번호로 다시 검색합니다.
4. 후보가 여러 개 나타나면 올바른 예약을 선택합니다.
5. 허용량이 계속 PMS와 다르면 지원팀에 문의합니다.

보이는 현상: 물리적 키카드 읽기가 활성화되지 않음

해결:

1. Look up by room 또는 Look up by confirmation number를 사용합니다.
2. Settings → Room Access → Keycard Encoding으로 이동합니다.
3. PMS Integration을 선택합니다.
4. PMS 벤더와 인코더 장치가 올바른지 확인합니다.
5. PMS 읽기 API가 검증된 후에만 Enable physical keycard reading을 켭니다.
6. Save를 클릭한 다음 Entitlements를 다시 로드합니다.
7. 저장 후에도 경고가 남아 있으면 지원팀에 문의합니다.

수동 조회는 계속 사용 가능

연결에서 카드를 읽을 수 없으면 AVA는 카드 스캔을 비활성화합니다. 객실 및 확인 번호 조회는 계속 사용할 수 있습니다. 경고는 읽기가 꺼져 있거나, 지원되지 않거나, 일시적으로 사용할 수 없다는 의미일 수 있습니다.

보이는 현상: 결과에 PMS에서 실시간으로 확인되었다고 표시됨

해결:

1. 현재 투숙객에게 해당 결과를 사용합니다.
2. 이후 스캔에서 업데이트된 스냅샷을 사용하도록 Refresh를 클릭합니다.
3. 실시간 결과도 이상해 보이면 예약을 다시 확인합니다.

여전히 해결되지 않나요?

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

• ❌ 스냅샷이 끝내 준비 상태가 되지 않음
• ❌ 카드 스캔이 유효한 예약을 계속 찾지 못함
• ❌ 새로고침 후에도 실시간 대체 결과가 계속 표시됨

함께 보내면 좋은 정보:

• 예약 ID 또는 확인 번호
• 객실 번호
• 상태 배너 스크린샷
• 문제가 시작된 시각

관련 안내

• Manage Access Codes
• Manual Keycard Encoding
• Smart Lock Problems