본문으로 건너뛰기

액세스 코드 관리

빠른 조회

대부분의 팀은 Reservation ID, Guest Name 또는 Room으로 1분 이내에 코드를 찾습니다.

이 가이드는 PIN, QR 키, 키카드 및 락커 액세스를 검토하는 방법을 설명합니다. 또한 키카드 이벤트 기록과 QR 키 기록을 확인하는 방법도 설명합니다.

이동 경로: Access Codes

빠른 참고​

작업클릭 위치결과
코드 찾기Reservation ID, Guest Name 또는 Room일치하는 코드가 표시됨
상태 또는 방식으로 필터링More Filters선택한 필터에 맞게 목록이 갱신됨
PIN 표시Eye iconPIN이 표시됨
잠금 ID 보기Key icon도구 설명에 Lock ID가 표시됨
코드 복사Copy icon코드가 복사되고 Copied가 표시됨
페이지 이동Previous 또는 Next다른 페이지가 로드됨
페이지 크기 변경10 per page새 크기로 목록이 갱신됨
유효 날짜 확인Valid Period 열시작 및 종료 시간이 표시됨
남은 시간 확인Status 배지활성 코드의 남은 시간이 표시됨
작업 진행 확인Operation Status 배지각 스마트 락 PIN이 대기 중, 부분 성공, 성공, 실패 또는 시간 초과인지 표시됨
실패 세부정보 검토Access Details읽기 쉬운 키카드 오류와 사용 가능한 경우 userMessage, errorCode, retriable, vendor 및 안전한 업스트림 세부정보가 표시됨
키카드 기록 검토Events 보기각 키카드 인코딩 시도마다 한 행이 표시됨
필터 지우기Clear All 또는 Reset All기본 보기로 돌아감

액세스 코드 찾기​

  1. Access Codes로 이동합니다.

  2. Reservation ID, Guest Name 또는 Room을 입력합니다.

  3. 목록이 갱신될 때까지 잠시 기다립니다.

    ✓ 일치하는 코드가 목록에 표시됩니다.

목록 필터링​

  1. More Filters를 클릭합니다.

  2. 하나 이상의 필터를 선택합니다.

    • Status: Active, Expired, Generation Pending, Partial Success, Generation Failed, Revoked, Superseded
    • Access Method: Smart Lock, Digital Key, Keycard, Locker, ACI
    • Date Range: 시작일 및 종료일

  3. 이 패널의 모든 항목을 지우려면 Reset All을 클릭합니다.

    ✓ 선택한 항목에 맞게 목록이 갱신됩니다.

페이지 이동​

  1. 목록 아래로 스크롤합니다.

  2. Previous 또는 Next를 클릭합니다.

  3. 10 per page를 열고 10, 25, 50 또는 100을 선택합니다.

    ✓ 새 페이지 크기로 목록이 갱신됩니다.

QR 디지털 키 관리​

  1. QRLOCK 행을 찾습니다.

  2. Manage digital key를 엽니다.

  3. Issue, Copy guest link, Send 또는 Withdraw를 선택합니다.

  4. 철회가 아직 처리 중이면 Retry cancellation을 사용합니다.

  5. 취소가 확인된 후에만 Reissue를 선택합니다.

    ✓ 모달에 현재 키 상태와 예약으로 필터링된 기록이 표시됩니다.

여러 객실 예약의 경우 AVA는 선택한 객실을 확인합니다. 종료 상태로 선택된 객실에서는 발급, 재발급 및 전송을 사용할 수 없습니다. 객실 기록과 철회 컨트롤은 계속 사용할 수 있습니다.

게스트 전화번호가 없거나 오래된 경우 AVA는 저장된 보유자를 사용하여 기존 QR 키를 대조할 수 있습니다. AVA는 해당 키를 반환하기 전에 선택한 객실, 투숙, 매핑, 만료 및 철회 상태를 확인합니다.

이 복구 과정에서는 기존 키를 재사용합니다. 다른 QRLOCK 카드를 생성하거나 게스트의 PMS 전화번호를 업데이트하지 않습니다.

PIN 표시 및 복사​

  1. 필요한 행을 찾습니다.

  2. eye icon을 클릭하여 PIN을 표시합니다.

  3. copy icon을 클릭합니다.

    ✓ 아이콘이 잠시 Copied로 바뀝니다.

잠금 ID 보기​

  1. 필요한 스마트 락 행을 찾습니다.

  2. key icon을 선택합니다.

    ✓ 도구 설명에 Lock ID가 표시됩니다.

상태 라벨 이해​

상태의미조치
Active코드가 현재 유효함투숙객과 공유
Expired유효 기간이 끝남필요하면 새 코드 발급
pending스마트 락 작업이 아직 처리 중임공유하기 전에 기다렸다가 새로고침
partial일부 스마트 락 단계가 완료되었지만 작업은 끝나지 않음공유하기 전에 기다렸다가 새로고침
Failed제공업체가 코드를 생성하지 못함잠금 설정을 다시 확인하고 재시도
Revoked코드가 조기에 비활성화됨다시 발급하기 전에 관리자와 확인
Superseded더 새로운 코드가 이 코드를 대체함가장 최근 코드를 사용

More Filters → Status를 사용하면 이 행들을 Generation Pending 및 Partial Success로 찾을 수 있습니다.

새 PIN을 먼저 확인

AVA는 오래된 백로그 항목보다 새로운 스마트 락 작업을 먼저 확인합니다. 새 투숙객 PIN은 오래된 대기 행보다 먼저 처리되어야 합니다. AVA는 이전 브리지 필드가 남아 있더라도 오래된 기록의 만료된 Active 행은 건너뜁니다. 현재 Active 행은 액세스 기간이 열려 있는 동안 계속 대상이 됩니다. 체크인 및 조회 새로고침 중에 AVA는 결과를 반환하기 전에 대기 중인 스마트 락 작업을 다시 확인합니다. 또한 제공업체 확인 사이에 최소 2초를 기다리므로 한 번 더 새로고침해야 할 수 있습니다.

최종 체크인 전에 발급된 자격 증명

AVA는 객실 배정 중에 PIN, QR 키 또는 락커 자격 증명을 발급할 수 있습니다. 최종 체크인 후에는 성공한 자격 증명이 도착이 확인된 투숙객에게 계속 연결됩니다. 다른 자격 증명을 발급하기 전에 예약을 새로고침합니다.

스마트 락 작업 상태 이해​

각 스마트 락 PIN 행은 표와 모바일 카드에 자체 작업 칩을 표시합니다. 스마트 락 코드가 벤더 브리지를 통해 아직 처리 중일 때 이 상태를 사용합니다.

준비 상태를 기다리세요

Operation Status에 Successful이 표시될 때까지 스마트 락 PIN을 공유하지 마세요. pending 및 partial은 액세스가 아직 완전히 준비되지 않았다는 의미입니다.

상태의미조치
PendingAVA가 벤더 작업이 완료되기를 기다리는 중임잠시 기다린 후 페이지를 새로고침
SuccessfulAVA가 잠금 작업 완료를 확인함PIN을 투숙객과 공유
Failed벤더 작업이 실패함잠금 연결을 확인하고 다시 시도
Timed outAVA가 계속 확인했지만 작업이 제시간에 완료되지 않음PIN 생성을 재시도하고 브리지를 확인

시간 세부정보 검토​

표를 사용하여 코드의 시작 시각, 종료 시각 및 생성 시각을 확인합니다.

항목확인 위치의미
Time remainingActive 상태 배지 아래코드가 만료되기 전 남은 시간
Valid PeriodValid Period 열시작 및 종료 날짜/시간
CreatedCreated 열코드가 생성된 시점
Valid Period 열

목록에 락커 코드만 표시되면 Valid Period 열은 숨겨집니다.

숙소 달력 날짜

PMS 예약의 경우 AVA는 도착일과 출발일을 숙소 달력 날짜로 유지합니다. 각 유효 기간을 생성할 때 호텔의 시간대를 적용합니다. 따라서 Valid Period가 예약의 현지 날짜와 일치합니다.

키카드 이벤트 기록 검토​

키카드 인코딩 시도의 감사 추적이 필요할 때 Events 보기를 사용합니다.

표시 상태보이는 내용의미
Encoded성공한 카드 행AVA가 해당 시도에서 카드를 기록함
Failed행의 오류 세부정보카드가 인코딩되지 않음
Expired유효 기간이 지난 카드카드를 더 이상 사용할 수 없음
Revoked취소된 카드 행카드가 조기에 비활성화됨
Superseded교체 행더 새로운 카드가 이 카드를 대체함
CreatedCreated 열의 인코딩 시각AVA가 시도를 기록한 시점
키카드 행만

기본 목록은 여전히 예약별로 액세스 코드를 그룹화합니다. Events 보기에서는 키카드 행이 시도별 한 행으로 펼쳐집니다. 스마트 락 및 락커 행은 여전히 액세스 코드별 한 기록으로 표시됩니다.

Opera 키카드 타임스탬프

Opera 키카드의 경우 Created 시간은 확인된 PMS keyCreationTime을 사용합니다. 이 타임스탬프는 실제 키가 성공적으로 확인된 시점과 일치합니다. Opera가 호텔 현지 유효성 타임스탬프를 반환하면 AVA는 확인 진단을 위해 이를 유지합니다.

정규화된 실패 세부정보

실패한 키카드 행은 이제 구조화된 메시지를 먼저 저장합니다. 인코더가 false를 반환하면 AVA는 KEYCARD_ENCODE_FAILED를 유형이 지정된 실패로 기록합니다. 지원 시 userMessage, errorCode, retriable, vendor 및 안전한 upstream 세부정보도 볼 수 있습니다. 재시도가 도움이 될 가능성이 있는지 판단할 때 retriable을 사용합니다. HTTP 504 객실 액세스 타임아웃은 KEYCARD_VENDOR_TIMEOUT과 함께 이 경로에 남습니다. 타임아웃을 비교할 때는 먼저 객실, 키 수 및 유효 기간을 확인합니다. 이렇게 하면 실제 불일치와 시간대만 다른 확인 문제를 구분하는 데 도움이 됩니다.

오류 코드는 계속 표시됨

AVA는 객실 액세스 faultcode:<value> 값을 이벤트 메시지에 유지합니다. 전화번호, 이메일, 카드 및 토큰에는 PII 삭제가 계속 적용됩니다. 벤더 인시던트를 비교할 때 faultcode를 사용합니다.

디지털 키는 별도 컨트롤을 사용함

QRLOCK 행에는 Manage digital key를 사용합니다. 스마트 락에는 Manage PIN을, 락커에는 Manage Locker Code를 사용합니다.

Access Codes는 PIN, 키카드 및 락커 행에서 조회 전용입니다. QRLOCK 행을 열면 전용 관리 모달이 표시됩니다.

팁​

  • 락커 항목은 PIN 대신 Locker # 및 Code를 표시합니다.
  • ACI 필터는 지원 체크인 액세스 코드 기록을 필터링합니다.
  • 모든 시간은 페이지 하단에 표시된 시간대를 사용합니다.
  • 키카드 행은 인코딩 시각에 Created 열을 사용합니다.
  • Opera 키카드의 경우 Created 열은 확인된 PMS 타임스탬프를 사용합니다.
  • 객실 이름이 잘못 표시되면 Rooms에서 객실 매핑을 확인합니다.
  • 읽기 쉬운 메시지가 필요하면 표에서 바로 Access Details를 확인합니다.

문제 해결​

여러 키카드 행​

보이는 현상: Events에 같은 예약이 여러 번 표시됩니다.

해결 방법:

  1. Display status 열을 확인합니다.
  2. 가장 최근의 Created 시간을 사용합니다.
  3. 감사 추적이 필요할 때만 이전 행을 유지합니다.

액세스 코드를 찾을 수 없음​

보이는 현상: "No access codes found" 또는 빈 목록이 표시됩니다.

해결 방법:

  1. 모든 필터를 지웁니다.
  2. Reservation ID 또는 Room으로 검색합니다.
  3. 페이지를 새로고침합니다.

복사 아이콘이 작동하지 않음​

보이는 현상: 복사 아이콘이 Copied로 바뀌지 않습니다.

해결 방법:

  1. 먼저 PIN을 표시합니다.
  2. 브라우저 클립보드 액세스를 허용한 후 다시 시도합니다.

상태가 Failed로 표시됨​

보이는 현상: 상태가 Failed이고 오류 메시지가 표시됩니다.

해결 방법:

  1. 스마트 락 통합이 연결되어 있는지 확인합니다.
  2. 예약에서 PIN 생성을 다시 시도합니다.

작업 상태가 pending 또는 partial에 머무름​

보이는 현상: 생성 후에도 스마트 락 코드가 pending 또는 partial로 표시됩니다.

해결 방법:

  1. 최대 1분 기다린 후 예약 또는 Access Codes 페이지를 새로고침합니다.
  2. 새 PIN은 오래된 백로그 행보다 먼저 확인되므로 새 투숙객 코드는 먼저 처리되어야 합니다.
  3. 체크인 조회 중이라면 AVA는 결과를 표시하기 전에 대기 중인 작업을 다시 확인합니다.
  4. 행이 이미 만료되었다면 AVA는 의도적으로 건너뜁니다.
  5. 상태가 Successful로 바뀌면 PIN을 공유합니다.
  6. 현재 투숙 중인데 1분 넘게 pending 또는 partial로 남아 있으면 예약에서 PIN 생성을 재시도합니다.
  7. Timed out 또는 Failed로 바뀌면 다시 시도하기 전에 벤더 연결과 브리지 상태를 확인합니다.

키카드 실패 메시지가 일반 언어로 표시됨​

보이는 현상: 키카드 행에 원시 벤더 문자열 대신 짧은 메시지가 표시됩니다. userMessage, errorCode, retriable, vendor 또는 안전한 upstream 세부정보가 표시될 수도 있습니다.

해결 방법:

  1. 먼저 짧은 메시지를 읽습니다.
  2. 지원팀에 문의할 때 오류 코드, 재시도 가능 플래그 및 벤더 세부정보를 사용합니다.
  3. 예약 ID, 객실 및 투숙 날짜가 올바른지 확인합니다.
  4. 객실 매핑 또는 인코더 세션이 잘못되었다면 먼저 수정합니다.
  5. 변경 사항을 저장한 후 키카드 작업을 다시 시도합니다.

Valid Period 열이 없음​

보이는 현상: Valid Period 열이 표시되지 않습니다.

해결 방법:

  1. 모든 필터를 지웁니다.
  2. 락커 전용 코드를 보고 있지 않은지 확인합니다.

QR 키 작업을 사용할 수 없음​

보이는 현상: Issue, Reissue 또는 Send를 사용할 수 없습니다.

해결 방법:

  1. 예약으로 필터링된 QR 키 기록을 엽니다.
  2. 선택한 객실이 PMS에서 종료 상태가 아닌지 확인합니다.
  3. PMS 객실에 저장된 QRLOCK 매핑이 있는지 확인합니다.
  4. 이전 철회가 아직 처리 중이면 Retry cancellation을 사용합니다.

게스트 전화번호 변경 후 저장된 QR 키가 없음​

보이는 현상: 게스트 전화번호가 비어 있거나 변경되었지만 이전에 QR 키가 발급되었습니다.

해결 방법:

  1. 최신 PMS 데이터가 도착한 후 예약을 새로고침합니다.

  2. 선택한 객실과 투숙 날짜가 QR 키 기록과 일치하는지 확인합니다.

  3. Manage digital key를 다시 엽니다.

  4. 기존 키가 표시되면 Copy guest link 또는 Send를 사용합니다.

  5. 상태가 아직 로드 중일 때 반복해서 발급하지 않습니다.

    ✓ 투숙 정보와 객실 매핑이 계속 일치하면 AVA가 저장된 키를 재사용할 수 있습니다.

키를 계속 사용할 수 없으면 다시 발급하기 전에 지원팀에 문의합니다. 객실, 투숙, 매핑, 만료 또는 철회 상태가 변경된 경우 직원의 복구가 필요할 수 있습니다.

여전히 해결되지 않나요?​

다음 상황에서는 success@vouch-technologies.com으로 문의합니다.

  • ❌ 체크인 후에도 코드가 표시되지 않음
  • ❌ 재시도 후에도 상태가 Failed로 유지됨
  • ❌ Access Codes 페이지를 열 수 없음

함께 보내면 좋은 정보:

  • Reservation ID
  • 객실 번호
  • 상태 행의 스크린샷