본문으로 건너뛰기

키카드 수동 인코딩

빠른 인코딩

인코더가 온라인이면 대부분의 수동 키카드는 약 2분이면 끝납니다.

이 안내서는 예약을 열지 않고 Operations View에서 키카드를 인코딩하는 방법을 설명합니다.

이동 경로: Operations View → Encode Keycard

Operations View 헤더의 Encode Keycard 버튼

사용 가능 여부

Settings → Room Access가 Keycard Encoding으로 설정된 경우에만 Encode Keycard가 보입니다.

헤더 수준과 예약 수준 인코딩​

AVA는 키카드를 인코딩하는 두 가지 방법을 제공합니다. 차이를 이해하면 설정을 바꾸지 않고도 중복 또는 추가 키카드를 발급할 수 있습니다.

방법위치키카드 수
헤더 수준(초록 버튼)Operations View 상단, Help 옆설정과 무관하게 항상 1-10
예약 수준예약 카드 또는 행의 카드 아이콘 버튼Room Access 설정에 따라 제어
  • 예약 수준 버튼은 Settings → Room Access에서 설정한 키카드 수를 따릅니다. 이 값이 1이면 중복 카드 옵션이 보이지 않습니다.
  • 상단의 초록색 Encode Keycard 버튼은 설정이 1이어도 언제든 추가 키카드를 인코딩할 수 있게 해줍니다.
중복 또는 추가 키카드 인코딩

게스트가 두 번째 키카드를 필요로 하지만 객실 접근 설정이 1개만 허용한다면, Operations View 상단의 초록색 Encode Keycard 버튼을 사용하세요. 설정을 바꿀 필요가 없습니다.

추가 게스트 체크인

객실이 이미 체크인된 상태라면, 추가 게스트가 나중에 중복 키카드 흐름을 다시 열 수 있습니다. 이 경우에도 화면은 한 장짜리 모달처럼 보입니다. 주 게스트의 카드 수를 바꾸지 않고 추가 게스트의 카드를 인코딩할 수 있습니다.

빠른 참고​

항목필수 여부기본값 또는 참고
Select Keycard Encoder예인코더가 하나만 온라인이면 AVA가 자동으로 선택합니다. 온라인은 장치와 터널 상태가 양호하다는 뜻입니다.
Room Number예PMS 객실 번호를 선택합니다. 인코더 객실 이름은 도움말 텍스트로 표시됩니다.
Guest Name아니오선택 사항입니다.
Valid From예기본값은 현재 시각입니다.
Valid Until예기본값은 구성한 키카드 만료 시각의 다음 날입니다. 없으면 11:00 AM으로 대체됩니다.
Number of Keycards아니오기본값은 2입니다. 1-10 사이를 선택합니다.
Room Number 표시

객실 목록에는 PMS 기준 객실 번호가 먼저 표시됩니다. 다르다면 AVA가 인코더 객실 이름을 괄호로 보여줍니다.

인코더 가용성

동적 인코더 목록은 실시간 에이전트 연결을 기준으로 합니다. 에이전트가 연결되어 있고 터널에 접근 가능하면 AVA는 이를 Online으로 표시합니다. 정적 또는 직접 연결 목록은 기존 동작을 유지합니다.

Valid Until 기본값

AVA는 기본 Valid Until 시간으로 Settings → Room Access → Keycard Expiration Time을 사용합니다. 이 설정이 없거나 잘못되면 AVA는 11:00 AM을 사용합니다.

키카드 수동 인코딩​

  1. Operations View로 이동합니다.

  2. Encode Keycard를 선택합니다.

    ✓ Manual Keycard Encoding 모달이 열립니다.

  3. 인코더가 하나만 온라인이면 AVA가 자동으로 선택합니다.

  4. 여러 인코더가 온라인이면 Online 상태인 것을 선택합니다. 이 상태는 실시간 에이전트 연결을 따릅니다.

  5. 드롭다운 목록에서 Room Number를 선택합니다.

    ✓ PMS 객실 번호가 기본 레이블로 표시됩니다. 매핑되어 있으면 **(Encoder: ...)**도 도움말 텍스트로 표시됩니다.

  6. 필요하면 Guest Name을 입력합니다.

  7. Valid From과 Valid Until을 설정합니다.

  8. Number of Keycards를 선택합니다.

  9. Encode Keycard를 클릭합니다.

    ✓ 키카드 인코딩 흐름이 열립니다.

문제 해결​

예약 수준에서 중복 카드 옵션이 없습니다​

보이는 현상: 예약을 열고 카드 아이콘으로 키카드를 인코딩하려고 했지만 두 번째 또는 중복 카드 옵션이 없습니다.

이유: Room Access 설정이 체크인당 키카드 1장만 인코딩하도록 되어 있습니다. 예약 수준 버튼은 이 제한을 따릅니다.

해결:

  1. 대신 Operations View 상단의 초록색 Encode Keycard 버튼을 사용합니다. 이 버튼에서는 항상 1-10장의 키카드를 선택할 수 있습니다.
  2. 예약 수준에서도 항상 2장을 허용하려면 AVA 관리자에게 Settings → Room Access에서 2장 허용으로 설정을 바꾸라고 요청합니다.

Encode Keycard 버튼이 없습니다​

보이는 현상: Operations View에 Encode Keycard 버튼이 없습니다.

해결:

  1. Settings → Room Access로 이동합니다.
  2. Room Access Method를 Keycard Encoding으로 설정합니다.
  3. Operations View로 돌아갑니다.

Encode Keycard 버튼이 비활성화됩니다​

보이는 현상: 버튼이 회색이거나 "Missing merchant ID. Configure your account in Settings."가 표시됩니다.

해결:

  1. Settings에서 계정 설정을 완료합니다.
  2. 페이지를 새로고칩니다.

"No encoders found"​

보이는 현상: 인코더 목록에 "No encoders found"가 표시됩니다.

이유: AVA는 실시간 온라인 상태가 있는 동적 인코더만 표시합니다. 이 상태는 연결된 에이전트와 접근 가능한 터널에서 가져옵니다.

해결:

  1. Settings → Room Access로 이동합니다.
  2. 인코더를 추가하거나 활성화합니다.
  3. Encode Keycard로 돌아갑니다.

인코더 선택기가 건너뛰어집니다​

보이는 현상: AVA가 인코더 선택 없이 인코딩 화면을 엽니다.

해결:

  1. 온라인 인코더가 하나뿐인지 확인합니다.
  2. 계속 인코딩합니다. 이 동작은 정상입니다.
  3. 수동 선택이 필요하면 다른 인코더를 온라인으로 전환합니다.

모달에서 인코더가 오프라인으로 보입니다​

보이는 현상: 예약 키카드 모달에서는 인코더가 오프라인으로 보이는데, Settings → Room Access에서는 연결됨으로 표시됩니다.

이유: 모달이 이제 설정 페이지와 같은 에이전트 연결 상태를 사용합니다. 에이전트가 연결되어 있고 터널이 접근 가능하면 두 화면은 같아야 합니다.

해결:

  1. Settings → Room Access와 예약 모달을 새로고칩니다.
  2. 인코더 카드의 Registered Agents를 확인합니다.
  3. 두 화면 중 하나라도 오프라인이면 에이전트 연결 또는 터널을 복구합니다.
  4. 다시 인코딩을 시도합니다.

객실 번호는 맞는데 다른 객실 코드로 인코딩됩니다​

보이는 현상: 객실 101을 선택했는데 인코더 로그에는 다른 객실 값이 보입니다.

해결:

  1. Settings → Room Access → Keycard Encoder Room Mapping으로 이동합니다.
  2. 선택한 PMS 객실을 찾습니다.
  3. 매핑된 Encoder Room Name이 올바른지 확인합니다.
  4. 매핑을 저장한 뒤 다시 인코딩합니다.

아직 막혔나요?​

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

  • ❌ 수동 인코딩 모달을 열 수 없음
  • ❌ 모든 시도에서 인코딩이 실패함
  • ❌ 설정 후에도 인코더가 표시되지 않음

포함하면 좋은 정보:

  • 인코더 유형과 위치
  • 사용한 객실 번호와 날짜
  • 오류 스크린샷

관련 안내​