ACSHotel 키카드 인코딩 설정
대부분의 호텔은 약 15분이면 끝낼 수 있습니다. ACSHotel 호텔 ID와 인코더 세부 정보가 필요합니다.
이 가이드는 AVA에서 ACSHotel 키카드 인코딩을 설정하는 방법을 안내합니다. 인코더 레코드, 키오스크 라우팅, Windows Agent, 테스트 카드까지 다룹니다. ACSHotel은 이제 Be-Tech처럼 공유 Windows Agent 라우팅을 사용합니다. 인코더마다 Agent 카드를 따로 만들 필요는 없습니다.
객실 매핑 또는 ACSHotel SDK의 정확한 lock 번호를 사용하세요. AVA는 6~8자의 영숫자 lock 번호를 그대로 받아 전송합니다. 앞의 0을 추가하거나 제거하지 마세요.
ACSHotel은 동적 모드에서 Windows Agent 패키지를 사용합니다. ACSHotel 설치 프로그램이 로컬 서비스 URL을 요구하는 경우에만 직접 통신을 사용하세요.
빠른 참고
| 설정 | 제어 항목 | 설정 위치 |
|---|---|---|
| Hotel ID | AVA를 ACSHotel 숙소와 연결 | ACSHotel Configuration |
| USB / proUSB | 리더 모드 선택 | ACSHotel Configuration |
| 카드 기본값 | 카드 번호, DAI, 부저, 잠금 해제 동작 설정 | ACSHotel Configuration |
| 인코더 레코드 | 하나의 Windows Agent를 공유하는 ACSHotel 인코더 등록 | Physical Encoder Devices |
| Service URL | 직접 통신 모드에서만 사용 | Encoder details |
| Enable guest selection | 키오스크에서 게스트가 인코더를 선택할 수 있음 | Kiosk to Encoder Routing |
| 키오스크 라우팅 | 키오스크를 특정 인코더에 매핑 | Kiosk to Encoder Routing |
| Windows Agent | 로컬 Agent 패키지를 다운로드하고 등록 | Windows Agent |
| Test Connection | 첫 번째로 구성된 인코더 확인 | ACSHotel Configuration |
위치
Settings → Room Access → Keycard Encoding1단계: ACSHotel 선택
-
Settings → Room Access로 이동합니다.
-
Keycard Encoding을 선택합니다.
-
인코더 유형으로 ACSHotel을 선택합니다.
-
Save를 클릭합니다.
✓ AVA가 ACSHotel을 선택된 인코더 유형으로 표시합니다.
2단계: ACSHotel 세부 정보 설정
-
ACSHotel Configuration을 엽니다.
-
Hotel ID를 입력합니다.
-
리더에 맞게 USB 또는 proUSB를 설정합니다.
-
ACSHotel 팀이 제공한 카드 기본값을 입력합니다.
-
잠금 해제 및 부저 설정이 하드웨어와 맞는지 확인합니다.
-
Save를 클릭합니다.
✓ AVA는 저장 전에 호텔 ID를 확인합니다.
ACSHotel이 USB 모드를 요구하면 USB에는 0, proUSB에는 1을 사용합니다.
3단계: 각 인코더 장치 추가
-
Physical Encoder Devices를 엽니다.
-
ACSHotel 장치마다 인코더 레코드를 하나씩 추가합니다.
-
각 장치에 명확한 Name을 지정합니다.
-
더 알아보기 쉬운 라벨이 필요하면 Location을 추가합니다.
-
직접 통신을 사용하는 경우 Service URL을 추가합니다.
-
Save를 클릭합니다.
✓ 하나의 Windows Agent가 여러 인코더를 담당할 때, 각 ACSHotel 장치는 여러 encoder ID를 포함할 수 있습니다.
LockSDK는 여전히 장치당 정확히 1개의 encoder ID가 필요합니다. 각 LockSDK 인코더를 별도의 Windows Agent 등록에 유지하세요.
하나의 Windows Agent가 여러 ACSHotel 인코더를 처리할 수 있습니다.
ACSHotel이 직접 통신을 요구할 때만 로컬 Service URL을 사용하세요. 이 URL은 인코더가 연결된 컴퓨터에서 도달 가능해야 합니다.
4단계: 라우팅 동작 선택
-
Kiosk to Encoder Routing을 엽니다.
-
키오스크에서 게스트가 인코더를 선택해야 하면 Enable guest selection을 켭니다.
-
직원이 키오스크를 수동으로 배정하려면 끕니다.
-
수동 라우팅일 때는 Kiosk Management에서 가져온 kiosk ID를 추가합니다.
-
Save를 클릭합니다.
✓ 게스트 선택이 켜져 있으면 AVA가 라우팅 표를 숨깁니다. ✓ 게스트 선택이 꺼져 있으면 라우팅 표가 키오스크 동작을 제어합니다.
5단계: Windows Agent 설정
-
Windows Agent로 이동합니다.
-
Download Windows Agent를 클릭해 Agent 등록을 생성합니다.
-
인코더에 연결된 Windows PC에 패키지를 설치합니다.
-
Agent가 이미 있으면 대신 Reinstall을 사용합니다.
-
로그, 시크릿 회전, 삭제는 Advanced options에서 엽니다.
✓ Agent가 등록되면 AVA는 활성 ACSHotel 설정에 대해 Windows Agent 카드 하나를 표시합니다. ✓ 직접 통신은 Windows Agent 섹션을 우회합니다.
6단계: 연결과 카드 테스트
-
ACSHotel Configuration으로 돌아갑니다.
-
Test Connection을 클릭합니다.
-
테스트 예약을 열고 카드 1장을 인코딩합니다.
-
문에 카드를 태웁니다.
✓ AVA는 첫 번째로 구성된 인코더를 테스트합니다. ✓ 올바른 객실에서 문이 열려야 합니다.
문제 해결
호텔 ID가 거부됨
보이는 현상: AVA가 호텔 ID를 저장하지 못하거나 테스트가 바로 실패합니다.
해결 방법:
- 호텔 ID가 ACSHotel 숙소와 일치하는지 확인합니다.
- 추가 공백을 제거합니다.
- 설정을 다시 저장합니다.
- Test Connection을 한 번 더 실행합니다.
인코더가 표시되지 않음
보이는 현상: Physical Encoder Devices에 인코더가 없거나 라우팅이 비어 있습니다.
해결 방법:
- 먼저 인코더 레코드를 최소 1개 추가합니다.
- 직접 통신을 사용하는 경우 Service URL을 추가합니다.
- 인코더를 다시 저장합니다.
- Settings → Room Access를 새로고침합니다.
Windows Agent가 계속 오프라인임
보이는 현상: Agent가 연결되지 않은 상태로 보이거나 다운로드 버튼이 계속 다시 나타납니다.
해결 방법:
- Windows PC가 ACSHotel 서비스에 도달할 수 있는지 확인합니다.
- Windows Agent 패키지를 다시 설치합니다.
- Agent가 인코더 컴퓨터에서 실행 중인지 확인합니다.
- Settings → Room Access를 새로고침합니다.
테스트 카드가 실패함
보이는 현상: 카드는 쓰이지만 문이 열리지 않습니다.
해결 방법:
- USB 또는 proUSB가 리더와 일치하는지 확인합니다.
- ACSHotel의 카드 기본값을 확인합니다.
- 객실 매핑이 ACSHotel lock 번호와 일치하는지 확인합니다.
- 다른 빈 카드로 시도합니다.
유효한 카드가 감지되지 않음
보이는 현상: AVA가 -3과 함께 "No valid card detected on reader."를 반환합니다.
이유: 인코딩을 시작하기 전에 리더가 유효한 ACSHotel 카드 마커를 감지하지 못했습니다.
해결 방법:
- 인코딩을 시작하기 전에 카드를 리더 위에 완전히 올려둡니다.
- AVA가 쓰기를 끝낼 때까지 카드를 움직이지 않습니다.
- 같은 메시지가 다시 나타나면 다른 카드를 사용해 봅니다.
- 리더가 올바른 USB 또는 proUSB 모드인지 확인합니다.
lock 번호가 거부됨
보이는 현상: AVA 또는 Windows Agent가 객실 매핑 lock 번호를 거부합니다.
해결 방법:
- lock 번호가 6~8자 길이인지 확인합니다.
- lock 번호에는 문자와 숫자만 남깁니다.
- 앞의 0을 포함해 ACSHotel SDK 값과 정확히 일치하게 사용합니다.
- 매핑을 저장하기 전에 수동 패딩을 제거합니다.
계속 막히나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ ACSHotel 인코더가 끝내 연결되지 않음
- ❌ 설정을 확인했는데도 테스트 카드가 실패함
- ❌ AVA가 ACSHotel DLL 누락을 보고함
포함하면 도움이 되는 정보:
- ACSHotel 호텔 ID
- ACSHotel Configuration 스크린샷
- 문제가 시작된 시간