키카드 인코더 문제 해결

빠른 조치

먼저 네트워크와 전원을 확인한 뒤 카드 1장을 다시 인코딩해 보세요. 약 2분이면 됩니다.

이 가이드는 키카드 인코더에서 자주 발생하는 문제를 해결하는 방법을 안내합니다. 아래 표에서 증상과 원인을 먼저 확인한 뒤, 해당 해결 절차로 이동하세요.

빠른 참고

보이는 현상	발생 이유	조치
인코더가 응답하지 않음	전원 또는 네트워크 문제	연결 상태 확인
카드가 인코딩되지 않음	카드 유형 또는 장치 문제	카드 및 장치 확인
"UserCredentialsNotProvided.NotApplicable"	Saflok 자격 증명이 누락되었거나 불완전함	Saflok 자격 증명 추가
Saflok/Ambiance 인코딩이 실패하거나 시간 초과됨	Windows Agent, Ambiance 인코더 서비스 또는 장치가 오프라인입니다	Saflok/Ambiance 인코더 다시 시작
"Please create a new keycard first, then use Duplicate for any extra cards."	Saflok가 해당 예약의 기존 활성 등록을 찾지 못합니다	첫 키카드 누락 해결
인코더 유형 변경이 유지되지 않음	이전 저장으로 인코더 상태가 섞였습니다	인코더 유형 다시 저장
"Test Connection" 실패 (Be-Tech)	Base URL 또는 서비스에 문제가 있습니다	Be-Tech 연결 수정
"Test Connection" 실패 (GreatLocks)	저장된 GreatLocks 서버 세부 정보가 없거나 오래되었습니다	GreatLocks 연결 수정
"Service URL is required" (LockSDK)	Direct 모드에서는 인코더마다 Service URL이 필요합니다	LockSDK 서비스 URL 추가
LockSDK 에이전트가 Not registered로 표시됨	아직 인코더별 에이전트 장치가 없습니다	LockSDK 에이전트 등록
Heartbeat Monitor가 저장 후 꺼짐	현재 호텔 세션에 저장이 유지되지 않았습니다	Heartbeat Monitor 다시 저장
Heartbeat가 unreachable로 표시됨	Agent가 오프라인이거나 터널에 문제가 있습니다	Agent 상태 확인
인코더가 계속 사용 불가로 표시됨	동적 목록이 여전히 Agent를 연결 끊김 상태로 봅니다	실시간 인코더 상태 확인
Windows Agent가 Not connected로 표시됨	Agent가 실행되지 않았거나 설치가 불완전합니다	Agent 다시 연결

인코더가 응답하지 않음

보이는 현상: AVA에서 인코더가 오프라인이거나 응답하지 않습니다.

해결 방법:

1. 인코더의 전원과 케이블을 확인합니다.
2. 키오스크와 인코더 사이의 네트워크 연결을 확인합니다(Direct Connection 전용).
3. 서버 IP와 포트가 올바른지 확인합니다.
4. 인코더 소프트웨어를 다시 시작합니다.

카드가 인코딩되지 않음

보이는 현상: 키카드 쓰기가 실패하거나 빈 카드가 나옵니다.

해결 방법:

1. 카드 유형이 인코더와 일치하는지 확인합니다.
2. 카드를 다시 넣고 재시도합니다.
3. 새 빈 카드로 시험해 봅니다.
4. Enable guest selection이 꺼져 있으면 키오스크가 올바른 인코더로 라우팅되는지 확인합니다.
5. Enable guest selection이 켜져 있으면 키오스크에서 게스트가 온라인 인코더를 선택하는지 확인합니다.

Saflok/Ambiance 인코딩이 작동하지 않음

보이는 현상: 키카드 인코딩이 실패하거나 시간 초과가 발생하거나, 키오스크가 Saflok/Ambiance 인코더로부터 응답이 없다고 보고합니다.

해결 방법: 아래 세 가지 점검을 순서대로 진행합니다. 각 단계는 다음 단계로 넘어가기 전에 흔한 원인을 하나씩 배제합니다.

1. Windows Agent가 AVA에 연결되어 있는지 확인합니다

1. Settings → Room Access → Keycard Encoding로 이동합니다.

2. 이 인코더의 Windows Agent 카드를 찾습니다.

3. 상태가 Connected로 표시되고 Last Seen 시간이 최근인지 확인합니다.

   

4. Agent가 Not connected이면 계속하기 전에 Windows Agent not connected를 따릅니다.

2. Ambiance에서 인코더가 온라인인지 확인합니다

Agent는 연결되어 있는데도 인코딩이 실패하면 Ambiance 서버에 로그인해 인코더 장치를 확인합니다.

1. Ambiance를 열고 Device Management → Encoders로 이동합니다.

2. 이 키오스크의 인코더(예: Vouch 인코더)를 찾습니다.

3. Status가 Online인지 확인합니다.

   

4. 인코더가 Offline이면 3단계로 넘어가 인코더 서비스를 다시 시작합니다.

3. Ambiance Encoder Service를 다시 시작합니다

Ambiance에서 인코더가 오프라인이면 Ambiance 서버가 설치된 컴퓨터에서 인코더 서비스를 다시 시작합니다.

1. Ambiance 서버가 실행 중인 컴퓨터에서 Windows 키를 누르거나 Start 메뉴를 클릭합니다.

2. services manager를 입력하고 결과에서 Ambiance Services Manager를 엽니다.

3. 서비스 목록에서 Ambiance Encoder Service를 선택합니다.

   

4. Stop(빨간 사각형) 버튼을 클릭합니다.

5. 서비스 상태가 Stopped로 바뀔 때까지 몇 초 기다립니다.

6. Start(빨간 재생) 버튼을 클릭합니다.

7. State가 다시 Running으로 돌아오는지 확인합니다.

8. Ambiance의 Device Management → Encoders로 돌아가 인코더가 Online인지 확인합니다.

9. 키오스크에서 테스트 카드를 인코딩해 봅니다.

다시 시작하면 효과가 있는 이유

인코더 서비스는 짧은 네트워크 끊김이나 장시간 유휴 상태 이후 물리 인코더와의 연결을 잃을 수 있습니다. 서비스를 중지했다가 다시 시작하면 연결을 강제로 재수립합니다.

Saflok 복제 키카드에는 첫 키카드가 필요함

보이는 현상: AVA에 "Please create a new keycard first, then use Duplicate for any extra cards."가 표시됩니다.

원인: Saflok가 해당 예약에 대한 활성 등록 또는 키카드 기록을 찾지 못했습니다. 복제 카드는 AVA가 추가 카드를 만들기 전에 먼저 한 장의 키카드가 성공적으로 생성되어야 합니다.

해결 방법:

1. 해당 예약의 첫 번째 키카드를 생성합니다.
2. 첫 번째 인코딩이 성공적으로 완료될 때까지 기다립니다.
3. 첫 번째 키카드가 생성된 뒤에만 Duplicate를 선택합니다.
4. 오류가 다시 나타나면 예약에 여전히 Ambiance의 활성 등록이 있는지 확인합니다.
5. 복제 요청을 다시 시도합니다.

표시되면 안 되는 내용

메시지에 원시 ReservationNotFound 또는 SOAP fault 세부 정보가 표시되면 안 됩니다.

Saflok 자격 증명이 제공되지 않음

보이는 현상: 키카드 인코딩 중 "UserCredentialsNotProvided.NotApplicable"가 표시됩니다.

해결 방법:

1. Settings → Room Access → Keycard Encoding로 이동합니다.
2. Encoder Type을 Saflok으로 설정합니다.
3. Encoder Credentials에 Username과 Password를 입력합니다.
4. Direct communication이 켜져 있으면 PMSI Server URL을 입력합니다.
5. Save를 클릭합니다.
6. Test Connection을 클릭한 뒤 테스트 카드 1장을 인코딩합니다.

인코더 유형 변경이 유지되지 않음

보이는 현상: 한 인코더 유형을 선택했는데 다른 인코더가 계속 활성 상태로 남습니다.

해결 방법:

1. Settings → Room Access → Keycard Encoding로 이동합니다.
2. Keycard Encoder Settings에서 원하는 인코더 유형을 선택합니다.
3. Save를 한 번 클릭하고 성공 메시지를 기다립니다.
4. 페이지를 새로고침해 해당 인코더 유형만 활성화되어 있는지 확인합니다.
5. 문제가 반복되면 유형을 바꿔 저장한 뒤 다시 원래 유형으로 돌아가 저장합니다.

Be-Tech 연결 테스트 실패

보이는 현상: "Test Connection"이 실패로 표시되거나 버튼이 비활성화된 상태로 남습니다.

해결 방법:

1. Base URL이 http:// 또는 https://로 시작하는지 확인합니다.
2. 인코더 워크스테이션에서 Be-Tech 서비스가 실행 중인지 확인합니다.
3. 워크스테이션과 키오스크가 같은 네트워크에 있는지 확인합니다.
4. Hotel Name, Chain No, Workstation, Reader No를 다시 입력합니다.
5. Test Connection을 다시 클릭합니다.

GreatLocks 연결 테스트 실패

보이는 현상: GreatLocks 서버 세부 정보를 수정한 뒤 Test Connection이 실패합니다.

해결 방법:

1. Settings → Room Access → Keycard Encoding로 이동합니다.
2. GreatLocks 서버에 XHLSI Server IP Address와 TCP Port가 있는지 확인합니다.
3. Save를 다시 클릭합니다.
4. 이전 설정을 업데이트한 경우 기존 서버 레코드를 유지합니다.
5. Test Connection을 다시 클릭합니다.

LockSDK 서비스 URL이 필요함

보이는 현상: 저장이 차단되거나 인코더 양식에 "Service URL is required."가 표시됩니다.

해결 방법:

1. Settings → Room Access → Keycard Encoding로 이동합니다.
2. LockSDK를 선택합니다.
3. Physical Encoder Devices를 열고 인코더를 편집합니다.
4. http://127.0.0.1:8092처럼 유효한 Service URL을 입력합니다.
5. Save를 클릭한 다음 Test Connection을 실행합니다.

LockSDK 에이전트가 등록되지 않음

보이는 현상: LockSDK 인코더 카드의 Windows Agent에 Not registered가 표시됩니다.

해결 방법:

1. Physical Encoder Devices에 LockSDK 인코더가 있는지 확인합니다.
2. Windows Agent로 이동해 인코더 카드를 찾습니다.
3. 카드가 새 카드라면 Download Windows Agent를, 이미 존재한다면 Reinstall을 클릭합니다.
4. 패키지를 압축 해제한 뒤 연결된 Windows PC에서 .bat 파일을 실행합니다.
5. 상태를 새로고침해 카드가 Not registered에서 Connected 또는 Not connected로 바뀌는지 확인합니다.
6. Advanced options에서는 View Logs, Rotate Secret, 또는 Delete만 사용합니다.

Heartbeat Monitor가 저장 후 꺼짐

보이는 현상: Heartbeat Monitor를 켠 뒤 Save를 클릭하면 다시 꺼집니다.

해결 방법:

1. Settings → Room Access → Keycard Encoding로 이동합니다.
2. Encoding Options → Advanced options를 엽니다.
3. Heartbeat Monitor를 켭니다.
4. Save를 한 번 클릭하고 성공 메시지를 기다립니다.
5. 페이지를 새로고침해 Heartbeat Monitor가 계속 켜져 있는지 확인합니다.
6. 그래도 꺼지면 Settings Not Saving After Switching Hotels을 따릅니다.

Heartbeat 실패

보이는 현상: Heartbeat Monitor에 unreachable이 표시됩니다.

해결 방법:

1. Agent가 키오스크/PC에서 실행 중인지 확인합니다.
2. Registered Agents에서 온라인 상태와 터널 도달 가능 여부를 확인합니다.
3. Agent 로그에서 오류를 확인합니다.
4. 필요하면 Agent를 다시 설치합니다.

실시간 인코더 상태가 일치하지 않음

보이는 현상: 인코더는 설정된 것처럼 보이지만 AVA에서는 여전히 예약 모달에서 사용 불가로 표시됩니다.

원인: AVA는 Agent가 연결되어 있고 터널에 도달 가능할 때만 online을 표시합니다. 이 동일한 상태가 이제 동적 인코더 선택을 제어합니다.

해결 방법:

1. Registered Agents에서 인코더 카드를 확인합니다.
2. 장치가 연결되어 있고 터널에 도달 가능한지 확인합니다.
3. 먼저 Agent 또는 네트워크 문제를 해결합니다.
4. Settings → Room Access를 새로고침합니다.
5. 다시 인코딩을 시도합니다.
6. 설정 페이지의 Status: 줄을 다시 확인합니다.

Windows Agent가 연결되지 않음

보이는 현상: 상태가 Not connected 또는 "Never online."으로 표시됩니다.

해결 방법:

1. 다운로드한 zip을 열고 download-installer.bat를 실행합니다.
2. 설치 프로그램 .exe가 다운로드되도록 한 뒤 그 파일을 실행합니다.
3. Windows PC에 인터넷 연결이 있는지 확인합니다.
4. 필요하면 Windows Agent의 에이전트 카드에서 Reinstall을 클릭합니다.
5. Registered Agents 상태를 새로고침합니다.
6. Settings → Room Access로 돌아가 **Status:**가 online으로 바뀌었는지 확인합니다.

동적 인코더 목록

Agent가 연결되어 있고 터널에 도달 가능하면 동적 인코더 목록에 Online이 표시되어야 합니다. 하위 인코더 카드가 여전히 오프라인처럼 보이면 먼저 페이지를 새로고침하고 Agent를 확인합니다.

Kiosk 라우팅 규칙이 표시되지 않음

보이는 현상: Kiosk to Encoder Routing 아래에서 라우팅 규칙을 찾을 수 없습니다.

해결 방법:

1. Enable guest selection이 켜져 있는지 확인합니다.
2. 수동 라우팅 규칙을 보이게 하려면 이 옵션을 끕니다.
3. Physical Encoder Devices에 장치를 최소 1개 추가합니다.

계속 문제가 있나요?

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

• ❌ 전원과 네트워크를 확인한 뒤에도 인코더가 오프라인 상태
• ❌ 여러 키오스크에서 카드 인코딩 실패
• ❌ Heartbeat가 30분 이상 비정상 상태

함께 보내면 좋은 정보:

• 인코더 유형과 모델
• Registered Agents와 Heartbeat Monitor 스크린샷
• 문제가 시작된 시간

관련 가이드

• 키카드 인코더 개요
• 키카드 인코더 설정
• 키카드 게스트 안내