키카드 인코더 설정
빠른 설정
인코더 유형을 선택하고(해당 시) 연결 방식을 고른 다음 인코더를 추가하세요. 약 15분이 소요됩니다.
이 가이드는 키오스크 또는 프런트 데스크용 키카드 인코딩을 구성하는 방법을 설명합니다.
빠른 참고
| 작업 | 무엇을 하는가 | 클릭 위치 |
|---|---|---|
| 방법 선택 | 키카드 인코딩 활성화 | Room Access → Key Card Encoding (Kiosk) |
| 인코더 유형 선택 | 락 시스템 선택 | Encoder Type |
| 연결 방식 선택 | 직접 연결 vs Windows Agent (Saflok/GreatLocks) | Connection Method |
| 인코더 구성 | 서버/자격 증명 입력 | 유형별 필드 |
| 인코더 추가 | 물리 장치 등록(Saflok/PMS) | Physical Encoder Devices |
| Windows Agent 등록 | 로컬 인코더 연결(동적) | Register Windows Agent |
| 기본 인코딩 설정 | 카드 수 + 만료 시간 | Encoding Options |
위치
Settings → Room Access → Key Card Encoding (Kiosk)1단계: 키카드 방식 선택
- Settings → Room Access로 이동합니다.
- 객실 출입 방식으로 **Key Card Encoding (Kiosk)**을 선택합니다.
- Save를 클릭합니다.
2단계: 인코더 유형 선택
- Keycard Encoder Settings로 스크롤합니다.
- Saflok, GreatLocks, 또는 PMS Integration을 선택합니다.
3단계: 연결 방식 선택(Saflok + GreatLocks만 해당)
- Direct Connection 또는 Via Windows Agent를 선택합니다.
- PMS Integration을 선택했다면 이 단계는 건너뜁니다.
4단계: 인코더 시스템 구성
Saflok을 사용하는 경우
- Direct Connection
- PMSI Server URL, Username, Password를 입력합니다.
- Test Connection을 클릭합니다.
- Via Windows Agent
- Username과 Password를 입력합니다.
- PMSI URL과 연결 테스트는 에이전트가 처리합니다.
- Physical Encoder Devices에 인코더 장치를 추가합니다(Encoder ID 필요).
- 선택 사항으로 각 인코더에 Location을 설정합니다.
- 여러 키오스크가 인코더를 공유하면 Kiosk to Encoder Routing 규칙을 추가합니다(키오스크 ID는 Kiosk Management에서 확인).
GreatLocks를 사용하는 경우
- Direct Connection
- Server Name(선택), XHLSI Server IP Address, TCP Port를 입력합니다.
- Test Connection을 클릭합니다.
- Via Windows Agent
- 서버 정보는 에이전트가 처리하므로 IP/포트가 필요하지 않습니다.
PMS Integration을 사용하는 경우
- PMS 연동이 활성화되어 있는지 확인합니다(Cloudbeds 또는 Opera).
- Physical Encoder Devices에서 다음 중 하나를 수행합니다:
- Load Encoders → Add Selected 클릭, 또는
- Add Encoder 클릭 후 Encoder ID와 PMS Encoder ID 입력.
- Active 토글로 사용하지 않을 인코더를 비활성화합니다.
5단계: Windows Agent 등록(동적 연결만 해당)
Via Windows Agent를 선택했다면 에이전트를 등록합니다:
-
Register Windows Agent로 이동합니다.
-
Agent Name(선택)과 담당할 Kiosk IDs를 입력합니다.
-
Register Agent를 클릭합니다.
-
장치 시크릿을 복사하고 Download Agent를 클릭합니다.
-
인코더가 연결된 Windows PC에 에이전트를 설치합니다.
✓ Registered Agents에 상태와 함께 표시됩니다.
6단계: 기본 인코딩 설정
- Number of Cards to Encode를 설정합니다(보통 1~2장).
- Keycard Expiration Time을 설정합니다(기본값: 오전 11:00).
선택 사항: Advanced options를 펼쳐 Heartbeat Monitor를 활성화할 수 있습니다.
선택 사항: PMS 객실명을 인코더 명칭으로 매핑
인코더에 표시되는 객실명이 PMS와 다르면:
- 키카드 객실 매핑을 사용하세요.
문제 해결
인코더가 응답하지 않거나 카드 인코딩이 실패하면 다음 체크리스트를 사용하세요:
아직 해결이 안 되나요?
다음 경우에는 success@vouch-technologies.com으로 문의하세요:
- ❌ 인코더 설정이 저장되지만 장치가 오프라인입니다
- ❌ 어떤 객실에서도 카드가 인코딩되지 않습니다
- ❌ Registered Agents에 에이전트가 온라인으로 표시되지 않습니다
함께 보내면 좋은 정보:
- 인코더 유형 및 모델
- Keycard Encoder Settings 스크린샷
- 문제가 시작된 시간