본문으로 건너뛰기

키카드 객실 매핑

빠른 설정

매핑을 켜고 PMS 객실을 선택한 뒤 인코더 객실 이름을 입력하세요. 약 5분이면 끝납니다.

이 안내서는 PMS 객실을 인코더 시스템에서 사용하는 정확한 객실 이름에 맞추는 방법을 설명합니다. AVA는 매핑 페이지를 지역화하므로, 레이블과 알림이 선택한 언어를 따릅니다. 벤더가 재고 동기화를 지원하면 객실, 건물, 층 데이터를 검토 목록으로 불러올 수 있습니다. 선택한 인코더는 저장된 건물과 층 값을 리프트 접근에 재사용할 수 있습니다. PMS 객실, 매핑, 구성 파일이 로드되는 동안에는 먼저 로딩 상태가 표시됩니다. 로딩이 끝난 뒤에만 빈 상태 메시지를 확인하세요.

리프트 접근 지원

선택한 인코더가 리프트 접근을 지원하면 Settings → Room Access에서 Enable lift access를 켭니다. 그다음 Lift access mode를 선택합니다.

  • Room floor mapping은 객실 매핑에 있는 건물과 층 값을 사용합니다.
  • Access code groups는 공유 문이나 리프트 그룹용 Common access codes를 사용합니다.

AVA는 한 번에 한 모드만 전송합니다. Access code groups를 사용하면 AVA는 한 자리 코드를 두 자리 코드로 저장합니다. 1,2,3 또는 01,02,03처럼 입력할 수 있습니다. 코드는 벤더가 지원하는 범위 안에 유지하세요.

ACSHotel 객실 번호

ACSHotel을 사용하는 경우 SDK 또는 객실 매핑에 있는 정확한 잠금 번호를 입력하세요. AVA는 6~8자의 영숫자 값을 허용하며 그대로 전송합니다. 앞자리 0은 그대로 유지하고, 수동으로 채워 넣지 마세요.

결합 객실은 별도입니다

이 페이지는 인코더 객실 이름이 PMS 객실 이름과 다를 때 사용합니다. 한 PMS 객실이 여러 물리 객실을 열어야 한다면 Combined Rooms를 사용하세요. 별칭을 편집해야 할 때는 페이지 헤더에서 Combined Rooms를 엽니다. 결합 객실은 객실 목록에서 Combined 배지와 Opens N rooms 레이블이 표시됩니다. 선택한 인코더가 다중 객실 키카드를 지원하지 않으면, 별칭이 이미 있을 때 Combined Rooms가 Reset only로 바뀔 수 있습니다. 지원되지 않는 벤더에서는 인코더를 바꾼 뒤 기존 별칭을 제거할 수는 있지만, 새 별칭은 추가할 수 없습니다.

빠른 참고​

작업수행 기능클릭 위치
Enable mapping매핑 켜기/끄기Keycard Encoder Room Mapping → Enabled/Disabled
Select a room매핑할 PMS 객실 선택PMS Rooms 목록
Enter encoder name정확한 인코더 객실 이름 저장Encoder Room Name 필드
Sync from vendor객실, 건물, 층 데이터를 검토 모드로 불러오기Sync from vendor
Edit or remove매핑 수정 또는 삭제Edit 또는 Remove 아이콘
Combined rooms한 PMS 객실이 여러 물리 객실을 열게 함Set Up Combined Rooms

Combined Rooms 버튼 상태​

상태가능한 작업표시 시점
Full별칭 추가, 수정, 초기화선택한 인코더가 다중 객실 키카드를 지원함
Reset only기존 별칭만 제거선택한 인코더가 다중 객실 키카드를 지원하지 않지만 별칭이 이미 있음
Disabled결합 객실 작업 없음선택한 인코더가 다중 객실 키카드를 지원하지 않고 별칭도 없음

찾는 위치​

Settings → Room Access → Keycard Encoder Room Mapping

keycard:mapping 권한과 Keycard Encoding 객실 접근 방식이 필요합니다.

1단계: 객실 매핑 켜기​

  1. Keycard Encoder Room Mapping을 엽니다.

  2. Enabled를 켭니다.

    ✓ 객실 목록을 사용할 수 있습니다.

2단계: PMS 객실 선택​

  1. 필요하면 **Search rooms...**를 사용합니다.

  2. PMS Rooms 목록에서 객실을 클릭합니다.

    ✓ 오른쪽 패널에 **Encoder Mapping for: [Room Name]**가 표시됩니다.

3단계: 인코더 객실 이름 입력​

  1. Encoder Room Name에 인코더가 사용하는 정확한 이름을 입력합니다(예: 101, SUITE-A).

  2. 필요하면 Building, Floor, Description을 추가합니다.

  3. Active를 켜거나 끕니다.

  4. Save Mapping을 클릭합니다.

    ✓ 객실이 목록에서 Mapped로 표시됩니다. ✓ 선택한 인코더가 Room floor mapping 모드일 때는 Building과 Floor를 사용합니다.

306 → 306A, 306B 같은 결합 객실을 설정하는 경우 실제 대상 객실을 매핑하세요. 보통 306 자체에는 인코더 매핑이 필요하지 않습니다.

벤더에서 동기화​

동기화가 보이는 경우

재고 동기화를 지원할 때만 Sync from vendor가 보입니다. 직접 통신이 켜져 있으면 숨겨집니다.

  1. Sync from vendor를 클릭합니다.

  2. 제안된 각 행을 검토합니다.

  3. 객실, 건물, 층, 설명, 활성값을 수정합니다.

  4. Confirm mapping을 클릭합니다.

    ✓ AVA가 추가, 수정, 삭제된 매핑을 함께 저장합니다.

4단계: 매핑 수정 또는 삭제​

  1. 매핑된 객실을 선택합니다.
  2. 인코더 이름을 바꾸려면 Edit, 삭제하려면 Remove를 클릭합니다.

문제 해결​

객실 매핑이 비활성화되어 있습니다​

보이는 현상: 객실 목록이 회색으로 비활성화됩니다.

해결: 페이지 상단의 Enabled를 켭니다.

객실이 보이지 않습니다​

보이는 현상: 목록이 비어 있습니다.

해결: 로딩이 끝났다면 AVA에서 PMS 객실이 불러와지는지 확인한 뒤 페이지를 새로고칩니다.

객실 목록이 계속 로드 중입니다​

보이는 현상: 객실 목록이 로딩 상태로 유지됩니다.

해결: PMS 객실, 매핑, 구성 파일이 모두 로드될 때까지 기다립니다. 계속 해결되지 않으면 페이지를 새로고치고 PMS 연결을 확인합니다.

사용할 수 있는 PMS 객실이 없습니다​

보이는 현상: "No PMS rooms available yet."가 표시됩니다.

해결:

  1. Settings → Essentials로 이동합니다.

  2. PMS Integration 설정을 엽니다.

  3. PMS를 연결한 뒤 이 페이지로 돌아옵니다.

    ✓ AVA가 PMS 객실을 표시해 인코더 이름을 매핑할 수 있습니다.

Combined Rooms가 Reset only로 표시됩니다​

보이는 현상: Combined Rooms 버튼에 Reset only만 표시됩니다.

이유: 선택한 키카드 인코더가 다중 객실 인코딩을 지원하지 않지만, 기존 별칭은 아직 저장되어 있습니다.

해결:

  1. Combined Rooms를 엽니다.
  2. 더 이상 필요 없는 오래된 별칭을 제거합니다.
  3. 새 결합 객실이 필요하면 Settings → Room Access에서 지원되는 인코더로 바꿉니다.

GreatLocks 재고가 로드되지 않습니다​

보이는 현상: GreatLocks에서 건물, 층, 객실 목록이 비어 있습니다.

해결:

  1. Settings → Room Access → Keycard Encoding으로 이동합니다.
  2. GreatLocks 서버 레코드가 저장되어 있는지 확인합니다.
  3. Windows Agent 또는 직접 터널이 온라인인지 확인합니다.
  4. Test Connection을 다시 클릭합니다.
  5. 연결이 정상화되면 이 페이지를 새로고칩니다.

Sync from vendor가 없습니다​

보이는 현상: Sync from vendor가 보이지 않습니다.

이유: 인코더가 재고 동기화를 지원하지 않거나 직접 통신이 켜져 있습니다.

해결:

  1. Settings → Room Access → Keycard Encoding으로 이동합니다.
  2. 지원되는 벤더를 선택했는지 확인합니다.
  3. 벤더 재고 동기화가 필요하면 Enable direct communication을 끕니다.
  4. 저장한 뒤 이 페이지를 다시 불러옵니다.

아직 막혔나요?​

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

  • ❌ 매핑은 저장되지만 적용되지 않음
  • ❌ 객실 목록이 전혀 로드되지 않음

포함하면 좋은 정보:

  • 매핑 페이지 스크린샷
  • 인코더 벤더와 모델
  • 문제가 시작된 시각