키카드 수동 인코딩
인코더가 온라인 상태라면 대부분의 수동 키카드는 약 2분이면 끝납니다.
이 가이드는 예약을 열지 않고 Operations View에서 키카드를 인코딩하는 방법을 안내합니다.
이동: Operations View → Encode Keycard

Settings → Room Access가 **Key Card Encoding (Kiosk)**로 설정되어 있을 때만 Encode Keycard가 표시됩니다.
헤더 수준 vs 예약 수준 인코딩
AVA는 키카드를 인코딩하는 두 가지 방법을 제공합니다. 차이를 이해하면 설정을 바꾸지 않고도 복제 카드나 추가 카드를 발급할 수 있습니다.
| 방법 | 위치 | 키카드 수 |
|---|---|---|
| 헤더 수준(초록 버튼) | Operations View 상단, Help 옆 | 설정과 무관하게 항상 1-10장 |
| 예약 수준 | 예약 카드 또는 행의 key 아이콘 버튼 | Room Access 설정에 따름 |
- 예약 수준 버튼은 Settings → Room Access에 구성된 키카드 수를 따릅니다. 이 값이 1이면 복제 카드 옵션은 보이지 않습니다.
- 헤더의 초록색 Encode Keycard 버튼은 설정이 1장이어도 언제든 추가 키카드를 인코딩할 수 있습니다.
게스트에게 두 번째 키카드가 필요하지만 룸 액세스 설정이 1장뿐이라면, Operations View 상단의 초록색 Encode Keycard 버튼을 사용하세요. 설정을 바꿀 필요가 없습니다.
빠른 참고
| 필드 | 필수 | 기본값 또는 참고 |
|---|---|---|
| Select Keycard Encoder | 예 | 온라인 인코더가 1대면 AVA가 자동 선택합니다. 온라인은 장치와 터널 상태가 모두 양호하다는 뜻입니다. |
| Room Number | 예 | PMS 객실 번호를 선택합니다. 인코더 객실 이름은 보조 텍스트로 표시됩니다. |
| Guest Name | 아니요 | 선택 사항입니다. |
| Valid From | 예 | 현재 시간으로 기본 설정됩니다. |
| Valid Until | 예 | 기본적으로 다음 날, 설정된 키카드 만료 시간으로 설정됩니다. 설정이 없으면 11:00 AM이 사용됩니다. |
| Number of Keycards | 아니요 | 기본값은 2장입니다. 1-10장 중 선택할 수 있습니다. |
객실 목록은 PMS에 보이는 객실 번호를 먼저 표시합니다. 다른 이름이 매핑되어 있으면 AVA가 괄호 안에 인코더 객실 이름을 보여줍니다.
AVA는 Settings → Room Access → Keycard Expiration Time을 Valid Until의 기본 시각으로 사용합니다. 이 설정이 없거나 유효하지 않으면 AVA는 11:00 AM을 사용합니다.
키카드 수동 인코딩
-
Operations View로 이동합니다.
-
Encode Keycard를 선택합니다.
✓ Manual Keycard Encoding 모달이 열립니다.
-
온라인 인코더가 1대면 AVA가 자동으로 선택합니다.
-
온라인 인코더가 여러 대면 Online 상태인 것을 선택합니다. 이 상태는 실시간 에이전트 연결을 따릅니다.
-
드롭다운 목록에서 Room Number를 선택합니다.
✓ PMS 객실 번호가 기본 라벨로 보입니다. 매핑되어 있으면 보조 텍스트로 **(Encoder: ...)**도 보입니다.
-
선택 사항으로 Guest Name을 입력합니다.
-
Valid From과 Valid Until을 설정합니다.
-
Number of Keycards를 선택합니다.
-
Encode Keycard를 클릭합니다.
✓ 키카드 인코딩 흐름이 열립니다.
문제 해결
예약 수준에서 복제 카드 옵션이 없음
보이는 현상: 예약을 열고 key 아이콘을 눌러 키카드를 인코딩했지만 두 번째 또는 복제 카드 옵션이 없습니다.
이유: Room Access 설정이 체크인당 1장만 인코딩하도록 되어 있습니다. 예약 수준 버튼은 이 제한을 따릅니다.
해결 방법:
- 대신 Operations View 상단의 초록색 Encode Keycard 버튼을 사용합니다. 이 버튼은 항상 1-10장을 선택할 수 있습니다.
- 예약 수준에서도 항상 2장을 허용하고 싶다면, AVA 관리자에게 Settings → Room Access에서 설정을 2장 허용으로 바꿔 달라고 요청합니다.
Encode Keycard 버튼이 없음
보이는 현상: Operations View에 Encode Keycard 버튼이 없습니다.
해결 방법:
- Settings → Room Access로 이동합니다.
- Room Access Method를 **Key Card Encoding (Kiosk)**로 설정합니다.
- Operations View로 돌아갑니다.
Encode Keycard 버튼이 비활성화됨
보이는 현상: 버튼이 회색이거나 "Missing merchant ID. Configure your account in Settings."가 표시됩니다.
해결 방법:
- Settings에서 계정 설정을 완료합니다.
- 페이지를 새로고침합니다.
"No encoders found"
보이는 현상: 인코더 목록에 "No encoders found."가 표시됩니다.
이유: AVA는 실시간 온라인 상태의 인코더만 표시합니다.
해결 방법:
- Settings → Room Access로 이동합니다.
- 인코더를 추가하거나 활성화합니다.
- Encode Keycard로 돌아갑니다.
인코더 선택기를 건너뜀
보이는 현상: 인코더 선택 없이 인코딩 화면이 열립니다.
해결 방법:
- 온라인 인코더가 1대뿐인지 확인합니다.
- 계속 인코딩합니다. 이 동작은 정상입니다.
- 직접 선택이 필요하면 다른 인코더를 온라인으로 올립니다.
객실 번호는 맞는데 다른 객실 코드로 인코딩됨
보이는 현상: 101을 선택했지만 인코더 로그에는 다른 객실 값이 표시됩니다.
해결 방법:
- Settings → Room Access → Keycard Encoder Room Mapping으로 이동합니다.
- 선택한 PMS 객실을 찾습니다.
- 매핑된 Encoder Room Name이 올바른지 확인합니다.
- 매핑을 저장한 뒤 다시 인코딩합니다.
계속 문제가 있나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- 수동 인코딩 모달을 열 수 없음
- 모든 시도에서 인코딩이 실패함
- 설정 후에도 인코더가 보이지 않음
함께 보내면 좋은 정보:
- 인코더 유형과 위치
- 사용한 객실 번호와 날짜
- 오류 스크린샷