본문으로 건너뛰기

투숙객 권한 스캔

빠른 확인

대부분의 스캔은 1분 이내에 끝납니다. 증분 새로고침은 전체 재생성보다 보통 더 빠릅니다.

투숙객 카드 스캔, 예약 데이터 새로고침, 또는 수동 조회가 필요할 때 이 가이드를 사용하세요. 일반 새로고침은 변경되지 않은 예약을 다시 사용합니다. 이렇게 하면 대부분의 업데이트가 더 빨라지고 PMS 읽기 수도 줄어듭니다.

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

페이지 열기​

  1. Entitlements를 엽니다.

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

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

    ✓ 스냅샷이 준비되면 Start scanning 버튼이 활성화됩니다.

PMS 기반 Keycard Reader

연결이 Keycard Reading을 지원하면 AVA가 PMS 기반 Reader로 스캔할 수 있습니다. 해당 Reader는 다른 사용 가능한 Encoder와 함께 표시됩니다.

예약 데이터 새로고침​

이 페이지는 숙소의 현재 영업일에 대한 로컬 스냅샷을 유지합니다. 일반 새로고침은 증분 방식입니다. PMS 개정 번호가 바뀌지 않은 최신 항목은 다시 사용합니다.

  1. 일반 업데이트는 Refresh를 클릭합니다.

  2. 스냅샷이 오래됐거나 전체 재생성이 필요하면 Force full을 클릭합니다.

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

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

자동 새로고침

활성 스냅샷이 없으면 AVA가 첫 새로고침을 자동으로 시작합니다. 새로고침이 당일 일부 데이터만 반환해도 사용 가능한 행은 계속 화면에 남습니다. 기존 스냅샷 전용 스캔은 새로고침 중에도 사용할 수 있습니다.

새로고침 개수 읽기​

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

개수의미중요한 이유
FetchedPMS에서 새로 읽은 예약 수많을수록 새롭거나 변경된 행이 많다는 뜻
Reused이전 스냅샷에서 이어받은 예약 수높을수록 더 빠른 새로고침이라는 뜻
Pages새로고침 중 읽은 체크인 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. 스캔 결과와 같은 방식으로 권한 카드를 사용합니다.
실시간 대체

수동 조회가 캐시를 놓치면 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가 허용하면 Benefits에서 요금제 연결도 유지됩니다.

문제 해결​

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

해결:

  1. Refresh를 클릭합니다.
  2. 준비 상태가 될 때까지 기다립니다.
  3. 필요하면 Force full을 클릭합니다.
  4. 배너가 바뀌지 않으면 Entitlements를 다시 엽니다.

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

해결:

  1. 여전히 사용 가능하면 현재 스냅샷을 사용합니다.
  2. 관리자에게 PMS를 다시 연결하거나 기능 접근을 복구해 달라고 요청합니다.
  3. PMS 문제가 해결된 뒤 다시 새로고칩니다.

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

해결:

  1. 예약에 유효한 숙박 날짜가 있는지 확인합니다.
  2. 객실 번호 또는 예약번호가 맞는지 확인합니다.
  3. PMS에서 예약을 새로고친 뒤 다시 시도합니다.
  4. 스냅샷이 여전히 오래된 것처럼 보이면 Force full을 사용합니다.

보이는 현상: 스캔 결과가 여러 개이거나 일치하지 않음​

해결:

  1. 여러 예약이 일치하면 올바른 투숙객을 선택합니다.
  2. 선택한 인코더가 온라인인지 확인합니다.
  3. Look up by room 또는 Look up by confirmation number를 사용합니다.
  4. 그래도 일치하지 않으면 지원팀에 예약 매핑을 확인해 달라고 요청합니다.

보이는 현상: 물리 Keycard Reading이 활성화되지 않음​

해결:

  1. Look up by room 또는 Look up by confirmation number를 사용합니다.
  2. 관리자에게 호텔의 객실 액세스 기능을 확인하도록 요청합니다.
  3. Settings → Room Access에서 Reader가 설정되었는지 확인합니다.
  4. 연결을 변경한 후 Entitlements를 다시 불러옵니다.
수동 조회는 계속 사용 가능

연결이 카드를 읽을 수 없으면 AVA는 카드 스캔을 비활성화합니다. 객실 및 예약번호 조회는 계속 사용할 수 있습니다.

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

해결:

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

계속 해결되지 않나요?​

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

  • ❌ 스냅샷이 끝내 준비 상태가 되지 않음
  • ❌ 카드 스캔이 유효한 예약을 계속 놓침
  • ❌ 새로고침 후에도 실시간 대체가 계속 나타남

함께 보내면 좋은 정보:

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