출입 코드 관리
대부분의 팀은 Reservation ID, Guest Name, 또는 Room으로 1분 이내에 코드를 찾습니다.
이 가이드는 스마트 락, 키카드, 락커의 출입 코드를 확인하고 공유하는 방법을 설명합니다. 또한 Events 화면에서 키카드 이벤트 기록을 읽고 스마트 락 작업 상태를 추적하는 데도 도움이 됩니다.
이동: Access Codes
빠른 참고
| 작업 | 클릭 위치 | 결과 |
|---|---|---|
| 코드 찾기 | Reservation ID, Guest Name, 또는 Room | 일치하는 코드 표시 |
| 상태나 방식으로 필터링 | More Filters | 조건에 맞게 목록 갱신 |
| PIN 표시 | Eye icon | PIN이 드러남 |
| Lock ID 보기 | Key icon | 툴팁에 Lock ID 표시 |
| 코드 복사 | Copy icon | 코드가 복사되고 Copied 표시 |
| 페이지 이동 | Previous 또는 Next | 다음 페이지 로드 |
| 페이지 크기 변경 | 10 per page | 새 크기로 목록 갱신 |
| 유효 기간 확인 | Valid Period 열 | 시작/종료 시간 표시 |
| 남은 시간 확인 | Status 배지 | 활성 코드의 남은 시간 표시 |
| 작업 진행 상태 확인 | Operation Status 배지 | 스마트 락 PIN의 pending, partial, successful, failed, timed out 여부 표시 |
| 실패 세부정보 확인 | Access Details | 사람이 읽기 쉬운 키카드 오류와 userMessage, errorCode, retriable, vendor, 안전한 upstream 세부정보 표시 |
| 키카드 기록 검토 | Events 화면 | 각 인코딩 시도마다 한 행 표시 |
| 필터 초기화 | Clear All 또는 Reset All | 기본 보기로 복귀 |
출입 코드 찾기
-
Access Codes로 이동합니다.
-
Reservation ID, Guest Name, 또는 Room을 입력합니다.
-
목록이 갱신될 때까지 잠시 기다립니다.
✓ 일치하는 코드가 목록에 표시됩니다.
목록 필터링
-
More Filters를 클릭합니다.
-
다음 필터 중 하나 이상을 선택합니다.
- Status: Active, Expired, Generation Pending, Partial Success, Generation Failed, Revoked, Superseded
- Access Method: Smart Lock, Keycard, Locker, ACI
- Date Range: 시작/종료 날짜
-
이 패널을 모두 지우려면 Reset All을 클릭합니다.
✓ 선택 사항에 맞게 목록이 갱신됩니다.
페이지 이동
-
목록 하단으로 스크롤합니다.
-
Previous 또는 Next를 클릭합니다.
-
10 per page를 열고 10, 25, 50, 100 중 하나를 선택합니다.
✓ 새 페이지 크기로 목록이 갱신됩니다.
PIN 표시 및 복사
-
필요한 행을 찾습니다.
-
eye icon을 클릭해 PIN을 표시합니다.
-
copy icon을 클릭합니다.
✓ 아이콘이 잠시 Copied로 바뀝니다.
Lock ID 보기
-
필요한 스마트 락 행을 찾습니다.
-
key icon을 선택합니다.
✓ 툴팁에 Lock ID가 표시됩니다.
상태 라벨 이해하기
| 상태 | 의미 | 할 일 |
|---|---|---|
| Active | 지금 유효함 | 게스트와 공유 |
| Expired | 유효 기간 종료 | 필요하면 새 코드 발급 |
| pending | 스마트 락 작업이 아직 처리 중 | 기다렸다가 새로고침 후 공유 |
| partial | 일부 단계는 끝났지만 작업이 아직 완료되지 않음 | 기다렸다가 새로고침 후 공유 |
| Failed | 공급업체가 코드 생성에 실패 | 락 설정을 다시 확인하고 재시도 |
| Revoked | 코드가 조기 비활성화됨 | 재발급 전 관리자 확인 |
| Superseded | 더 최신 코드가 이 코드를 대체함 | 가장 최신 코드 사용 |
More Filters → Status에서 이 행들은 Generation Pending과 Partial Success로 찾을 수 있습니다.
AVA는 오래된 항목보다 최신 스마트 락 작업을 먼저 확인합니다. 새 게스트 PIN은 예전 대기 행보다 먼저 정리되어야 합니다. 오래된 브리지 필드가 남아 있어도 만료된 과거 Active 행은 건너뜁니다. 현재 Active 행은 출입 창이 열려 있는 동안 계속 유효합니다. 체크인과 조회 새로고침 중에는 AVA가 결과를 돌려주기 전에 대기 중인 스마트 락 작업을 다시 확인합니다. 또한 공급업체 확인 사이에 최소 2초를 기다리므로 한 번 더 새로고침이 필요할 수 있습니다.
스마트 락 작업 상태 이해하기
각 스마트 락 PIN 행에는 표와 모바일 카드에 자체 작업 상태 칩이 표시됩니다. 이 상태는 스마트 락 코드가 공급업체 브리지에서 처리 중일 때 사용합니다.
Operation Status가 Successful로 표시되기 전에는 스마트 락 PIN을 공유하지 마세요. pending과 partial은 아직 출입이 완전히 준비되지 않았다는 뜻입니다.
| 상태 | 의미 | 할 일 |
|---|---|---|
| Pending | AVA가 공급업체 작업 완료를 기다리는 중 | 잠시 기다렸다가 새로고침 |
| Successful | 락 작업 완료를 AVA가 확인함 | 게스트와 PIN 공유 |
| Failed | 공급업체 작업 실패 | 락 연결을 확인하고 재시도 |
| Timed out | AVA가 계속 확인했지만 시간 내에 완료되지 않음 | PIN 생성을 다시 시도하고 브리지를 확인 |
시간 정보 확인
표를 사용해 코드의 시작, 종료, 생성 시점을 확인합니다.
| 항목 | 확인 위치 | 의미 |
|---|---|---|
| Time remaining | Active 상태 배지 아래 | 만료까지 남은 시간 |
| Valid Period | Valid Period 열 | 시작/종료 날짜 및 시간 |
| Created | Created 열 | 코드 생성 시점 |
목록에 락커 코드만 보이면 Valid Period 열은 숨겨집니다.
키카드 이벤트 기록 검토
키카드 인코딩 시도의 감사 추적이 필요할 때는 Events 화면을 사용합니다.
| 표시 상태 | 보이는 내용 | 의미 |
|---|---|---|
| Encoded | 성공한 카드 행 | AVA가 해당 시도에 카드를 기록함 |
| Failed | 행의 오류 세부정보 | 카드 인코딩 실패 |
| Expired | 유효 기간이 지난 카드 | 더 이상 유효하지 않음 |
| Revoked | 취소된 카드 행 | 카드가 조기 비활성화됨 |
| Superseded | 대체된 카드 행 | 더 최신 카드가 이 카드를 대체함 |
| Created | Created 열의 인코딩 시각 | AVA가 시도를 기록한 시점 |
기본 목록은 여전히 예약 단위로 출입 코드를 묶습니다. Events 화면에서는 키카드 행이 시도별 한 행으로 펼쳐집니다. 스마트 락과 락커 행은 여전히 출입 코드당 한 기록으로 표시됩니다.
실패한 키카드 행은 이제 구조화된 메시지를 먼저 저장합니다.
지원용으로 userMessage, errorCode, retriable, vendor, 안전한 upstream 세부정보가 보일 수도 있습니다.
retriable로 다시 시도할 가능성이 높은지 판단할 수 있습니다.
HTTP 504 객실 출입 타임아웃은 KEYCARD_VENDOR_TIMEOUT으로 이 경로에 남습니다.
AVA는 객실 출입 faultcode:<value> 값을 이벤트 메시지에 그대로 보존합니다.
PII 마스킹은 전화번호, 이메일, 카드, 토큰에 계속 적용됩니다.
벤더 사고를 비교할 때 faultcode를 사용하세요.
출입을 설정하거나 바꿔야 한다면 예약에서 Manage PIN(스마트 락) 또는 Manage Locker Code(락커)를 사용하세요.
팁
- 락커 항목은 PIN 대신 **Locker #**와 Code를 표시합니다.
- ACI는 보조 체크인 출입 코드 기록을 필터링합니다.
- 모든 시간은 페이지 하단에 표시된 시간대를 사용합니다.
- 키카드 행은 인코딩 시간을 Created 열로 표시합니다.
- 객실 이름이 이상해 보이면 Rooms에서 객실 매핑을 확인합니다.
- 사람이 읽기 쉬운 메시지가 필요할 때는 표에서 바로 Access Details를 읽습니다.
문제 해결
여러 키카드 행이 보임
보이는 현상: 같은 예약이 Events에 여러 번 표시됩니다.
해결:
- Display status 열을 확인합니다.
- 가장 최신 Created 시간을 사용합니다.
- 감사 추적이 필요할 때만 오래된 행을 유지합니다.
출입 코드를 찾을 수 없음
보이는 현상: "No access codes found"가 표시되거나 목록이 비어 있습니다.
해결:
- 모든 필터를 지웁니다.
- Reservation ID 또는 Room으로 검색합니다.
- 페이지를 새로고칩니다.
복사 아이콘이 동작하지 않음
보이는 현상: 복사 아이콘이 Copied로 바뀌지 않습니다.
해결:
- 먼저 PIN을 표시합니다.
- 브라우저 클립보드 권한을 허용한 뒤 다시 시도합니다.
상태가 Failed로 표시됨
보이는 현상: 상태가 Failed로 표시되고 오류 메시지가 있습니다.
해결:
- 스마트 락 통합 연결 상태를 확인합니다.
- 예약에서 PIN 생성을 다시 시도합니다.
작업 상태가 pending 또는 partial에 머묾
보이는 현상: 스마트 락 코드를 만든 뒤 pending 또는 partial이 표시됩니다.
해결:
- 최대 1분 기다린 뒤 예약 또는 Access Codes 페이지를 새로고칩니다.
- AVA는 오래된 대기 항목보다 최신 스마트 락 작업을 먼저 확인하므로 새 게스트 PIN이 먼저 정리되어야 합니다.
- 체크인 조회를 새로고침하면 AVA가 결과를 보여주기 전에 대기 작업을 다시 확인합니다.
- 만료된 과거 Active 행은 의도적으로 건너뜁니다.
- 현재 숙박의 경우, AVA가 백그라운드에서 공급업체 작업을 계속 확인하므로 추가 작업 없이 Successful로 바뀔 수 있습니다.
- 체크인 대기 중에도 AVA가 대기 중인 스마트 락 작업을 새로 확인하므로 준비된 PIN이 더 빨리 보일 수 있습니다.
- partial이 보이면 PIN을 공유하기 전에 상태가 끝날 때까지 기다립니다.
- 현재 숙박에서 pending이 1분 이상 계속되면 예약에서 PIN 생성을 다시 시도합니다.
- Timed out 또는 Failed로 바뀌면 공급업체 브리지와 연결 상태를 확인한 뒤 다시 시도합니다.
키카드 실패 메시지가 평문으로 보임
보이는 현상: 키카드 행에 원래 공급업체 문자열 대신 짧은 메시지가 표시됩니다.
userMessage, errorCode, retriable, vendor, 안전한 upstream 세부정보도 보일 수 있습니다.
해결:
- 먼저 짧은 메시지를 읽습니다.
- 지원팀에 연락할 때는 오류 코드, retriable 플래그, 벤더 세부정보를 함께 전달합니다.
- 예약 ID, 객실, 숙박 날짜가 맞는지 확인합니다.
- 객실 매핑이나 인코더 세션이 잘못되었다면 먼저 수정합니다.
- 변경 사항을 저장한 뒤 키카드 작업을 다시 시도합니다.
Valid Period 열이 없음
보이는 현상: Valid Period 열이 보이지 않습니다.
해결:
- 모든 필터를 지웁니다.
- 락커 전용 코드만 보고 있지 않은지 확인합니다.
아직 해결되지 않나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 체크인 후 코드가 표시되지 않음
- ❌ 여러 번 다시 시도해도 상태가 Failed로 유지됨
- ❌ Access Codes 페이지를 열 수 없음
같이 보내면 좋은 정보:
- 예약 ID
- 객실 번호
- 상태 행 스크린샷