액세스 코드 관리

빠른 조회

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

이 가이드는 스마트 락, 키카드, 락커의 액세스 코드를 검토하고 공유하는 데 도움이 됩니다. 또한 Events 보기에서 키카드 이벤트 기록을 읽고 스마트 락 작업 상태를 추적하는 데도 도움이 됩니다.

이동 경로: Access Codes

빠른 참고

작업	클릭 위치	결과
코드 찾기	Reservation ID, Guest Name, 또는 Room	일치하는 코드가 표시됨
상태 또는 방식으로 필터링	More Filters	목록이 필터에 맞게 갱신됨
PIN 표시	Eye icon	PIN이 드러남
잠금 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, Keycard, Locker, ACI
   • Date Range: 시작/종료 날짜

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

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

페이지 이동

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

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

3. 10 per page를 열고 10, 25, 50, 100 중 하나를 선택합니다.

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

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초를 기다리므로, 한 번 더 새로고침이 필요할 수 있습니다.

스마트 락 작업 상태 이해

각 스마트 락 PIN 행은 표와 모바일 카드에서 고유한 작업 칩을 보여줍니다. 이 상태는 스마트 락 코드가 벤더 브리지 안에서 아직 처리 중일 때 사용합니다.

준비 상태를 기다리세요

Operation Status가 Successful로 표시되기 전에는 스마트 락 PIN을 공유하지 마세요. pending과 partial은 아직 접근이 완전히 준비되지 않았다는 뜻입니다.

상태	의미	조치
Pending	AVA가 벤더 작업 완료를 기다리는 중	잠시 기다렸다가 페이지 새로고침
Successful	잠금 작업 완료를 확인함	PIN을 투숙객과 공유
Failed	벤더 작업 실패	잠금 연결을 확인하고 다시 시도
Timed out	AVA가 계속 확인했지만 정해진 시간 안에 작업이 끝나지 않음	PIN 생성을 다시 시도하고 브리지 확인

시간 세부정보 검토

표를 사용해 코드의 시작, 종료, 생성 시점을 확인합니다.

항목	확인 위치	의미
Time remaining	Active 상태 배지 아래	만료까지 남은 시간
Valid Period	Valid Period 열	시작 및 종료 날짜/시간
Created	Created 열	코드가 생성된 시점

Valid Period 열

목록에 락커 코드만 보이면 Valid Period 열은 숨겨집니다.

키카드 이벤트 기록 검토

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

표시 상태	보이는 내용	의미
Encoded	성공한 카드 행	해당 시도에서 카드를 기록함
Failed	행 안의 오류 세부정보	카드 인코딩 실패
Expired	유효 기간이 지난 카드	더 이상 유효하지 않음
Revoked	취소된 카드 행	카드가 조기 비활성화됨
Superseded	대체 카드 행	더 새로운 카드가 이 카드를 대체함
Created	Created 열의 인코딩 시각	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으로 이 경로에 남습니다. 타임아웃을 비교할 때는 먼저 객실, 키 수, 유효 기간을 확인하세요. 그러면 실제 불일치와 시간대만 다른 확인 문제를 구분하는 데 도움이 됩니다.

Fault code는 계속 표시

AVA는 객실 액세스의 faultcode:<value> 값을 이벤트 메시지에 유지합니다. 전화번호, 이메일, 카드, 토큰에 대한 PII 마스킹도 계속 적용됩니다. 벤더 사고를 비교할 때 faultcode를 사용하세요.

Access Codes는 조회 전용

액세스를 설정하거나 변경해야 할 때는 예약에서 Manage PIN(스마트 락) 또는 Manage Locker Code(락커)를 사용하세요.

팁

• 락커 항목은 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 생성을 다시 시도합니다.

아직도 막히나요?

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

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

함께 보내면 좋은 정보:

• 예약 ID
• 객실 번호
• 상태 행 스크린샷

관련 가이드

• 객실 메타데이터 관리
• 스마트 락 문제
• Command Center