키카드 객실 매핑
매핑을 켜고 PMS 객실을 선택한 뒤 인코더 객실명을 입력하세요. 약 5분이면 됩니다.
이 가이드는 PMS 객실을 인코더 시스템에서 사용하는 객실명으로 정확히 매핑하는 방법을 설명합니다. AVA는 매핑 페이지를 현지화하므로 레이블과 알림이 선택한 언어를 따릅니다.
ACSHotel을 사용하는 경우 SDK 또는 객실 매핑에 나온 정확한 lock 번호를 입력하세요. AVA는 6~8자의 영숫자 값을 그대로 받아 전송합니다. 앞의 0은 유지하고 수동 패딩은 피하세요.
인코더 객실명이 PMS 객실명과 다를 때는 이 페이지를 사용하세요. 하나의 PMS 객실이 여러 실제 객실을 열어야 할 때는 Combined Rooms를 사용하세요. 편집이 필요하면 페이지 헤더에서 Combined Rooms를 엽니다. 결합 객실은 목록에서 Combined 배지와 Opens N rooms 라벨로 표시됩니다. 선택한 인코더가 다중 객실 키카드를 지원하지 않으면, 별칭이 이미 있을 때 Combined Rooms가 Reset only로 바뀔 수 있습니다. 인코더를 바꾼 뒤 기존 별칭은 제거할 수 있지만, 지원되지 않는 벤더에는 새 별칭을 추가할 수 없습니다.
빠른 참고
| 작업 | 기능 | 클릭 위치 |
|---|---|---|
| 매핑 활성화 | 매핑 켜기/끄기 | Keycard Encoder Room Mapping → Enabled/Disabled |
| 객실 선택 | 매핑할 PMS 객실 선택 | PMS Rooms 목록 |
| 인코더명 입력 | 인코더 객실명 저장 | Encoder Room Name 필드 |
| 편집/삭제 | 매핑 수정 또는 삭제 | Edit 또는 Remove 아이콘 |
| 결합 객실 | 하나의 PMS 객실이 여러 실제 객실을 열게 함 | Set Up Combined Rooms |
Combined Rooms 버튼 상태
| 상태 | 할 수 있는 일 | 표시 시점 |
|---|---|---|
| Full | 별칭 추가, 편집, 초기화 | 선택한 인코더가 다중 객실 키카드를 지원할 때 |
| Reset only | 기존 별칭만 제거 가능 | 선택한 인코더가 다중 객실 키카드를 지원하지 않지만 별칭이 이미 있을 때 |
| Disabled | 결합 객실 작업 없음 | 선택한 인코더가 다중 객실 키카드를 지원하지 않고 별칭도 없을 때 |
위치
Settings → Room Access → Keycard Encoder Room Mappingkeycard:mapping 권한과 객실 출입 방식으로 Keycard Encoding이 필요합니다.
1단계: 객실 매핑 활성화
-
Keycard Encoder Room Mapping을 엽니다.
-
Enabled를 켭니다.
✓ 객실 목록이 표시됩니다.
2단계: PMS 객실 선택
-
필요하면 **Search rooms...**를 사용합니다.
-
PMS Rooms 목록에서 객실을 클릭합니다.
✓ 오른쪽 패널에 **Encoder Mapping for: [Room Name]**가 표시됩니다.
3단계: 인코더 객실명 입력
-
Encoder Room Name에 인코더에서 사용하는 정확한 명칭을 입력합니다(예:
101,SUITE-A). -
선택 사항으로 Description을 추가합니다.
-
Save Mapping을 클릭합니다.
✓ 목록에서 객실이 Mapped로 표시됩니다.
306 → 306A, 306B 같은 결합 객실을 설정한다면 실제 대상 객실을 매핑하세요.
보통 306 자체에는 인코더 매핑이 필요하지 않습니다.
4단계: 매핑 편집 또는 제거
- 매핑된 객실을 선택합니다.
- 인코더명을 수정하려면 Edit, 삭제하려면 Remove를 클릭합니다.
문제 해결
객실 매핑이 비활성화됨
현상: 객실 목록이 회색으로 표시됩니다.
해결 방법: 페이지 상단에서 Enabled를 켭니다.
객실이 표시되지 않음
현상: 목록이 비어 있습니다.
해결 방법: PMS 객실이 AVA에 로드되는지 확인한 뒤 페이지를 새로 고칩니다.
사용할 수 있는 PMS 객실이 없음
현상: "No PMS rooms available yet."가 표시됩니다.
해결 방법:
-
Settings → Essentials로 이동합니다.
-
PMS Integration 설정을 엽니다.
-
PMS를 연결한 뒤 이 페이지로 돌아옵니다.
✓ AVA가 PMS 객실을 표시하므로 인코더 이름을 매핑할 수 있습니다.
Combined Rooms가 Reset only로 표시됨
현상: Combined Rooms 버튼에 Reset only만 표시됩니다.
이유: 선택한 키카드 인코더가 다중 객실 인코딩을 지원하지 않지만, 기존 별칭은 아직 저장되어 있습니다.
해결 방법:
- Combined Rooms를 엽니다.
- 더 이상 필요 없는 기존 별칭을 제거합니다.
- 새 결합 객실이 필요하면 Settings → Room Access에서 지원되는 인코더로 전환합니다.
계속 막히나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 매핑은 저장되지만 적용되지 않음
- ❌ 매핑 목록에 객실이 로드되지 않음
포함하면 도움이 되는 정보:
- 매핑 페이지 스크린샷
- 인코더 벤더 및 모델
- 문제가 시작된 시간