Pemecahan Masalah Encoder Kartu

Perbaikan Cepat

Periksa jaringan dan daya terlebih dahulu, lalu coba encode ulang satu kartu. Langkah ini biasanya memakan waktu sekitar 2 menit.

Panduan ini membantu Anda menyelesaikan masalah umum pada encoder keycard.

Referensi Cepat

Yang Anda lihat	Mengapa ini terjadi	Lakukan ini
Encoder tidak merespons	Masalah daya atau jaringan	Periksa konektivitas
Kartu tidak ter-encode	Masalah jenis kartu atau perangkat	Verifikasi kartu dan perangkat
"UserCredentialsNotProvided.NotApplicable"	Credential Saflok tidak ada atau belum lengkap	Tambahkan credential Saflok
Encoding Saflok/Ambiance gagal atau time out	Windows Agent, layanan encoder Ambiance, atau perangkat offline	Restart encoder Saflok/Ambiance
"Please create a new keycard first, then use Duplicate for any extra cards."	Saflok tidak dapat menemukan registrasi aktif yang sudah ada untuk reservasi	Perbaiki keycard pertama yang hilang
Perubahan jenis encoder tidak tersimpan	Save sebelumnya meninggalkan status encoder campuran	Simpan ulang jenis encoder
"Test Connection" gagal (Be-Tech)	Base URL atau masalah layanan	Perbaiki koneksi Be-Tech
"Test Connection" gagal (GreatLocks)	Detail server GreatLocks yang tersimpan hilang atau usang	Perbaiki koneksi GreatLocks
"Service URL is required" (LockSDK)	Mode direct memerlukan Service URL per encoder	Tambahkan Service URL LockSDK
Agent LockSDK menampilkan Not registered	Belum ada perangkat agent per encoder	Daftarkan agent LockSDK
Heartbeat Monitor mati setelah save	Save tidak tersimpan di sesi hotel Anda saat ini	Simpan ulang Heartbeat Monitor
Heartbeat menampilkan unreachable	Agent offline atau masalah tunnel	Periksa status heartbeat
Encoder tetap tidak tersedia	Daftar dinamis masih melihat agent sebagai disconnected	Periksa status encoder live
Windows Agent menampilkan Not connected	Agent tidak berjalan atau instalasi belum lengkap	Sambungkan ulang agent

Encoder tidak merespons

Yang Anda lihat: Encoder tampak offline atau tidak merespons di AVA.

Perbaikan:

1. Periksa daya dan kabel encoder.
2. Verifikasi konektivitas jaringan antara kiosk dan encoder (hanya Direct Connection).
3. Pastikan IP dan port server benar.
4. Restart software encoder.

Kartu tidak ter-encode

Yang Anda lihat: Penulisan keycard gagal atau menghasilkan kartu kosong.

Perbaikan:

1. Pastikan jenis kartu sesuai dengan encoder Anda.
2. Masukkan ulang kartu lalu coba lagi.
3. Uji dengan kartu kosong baru.
4. Jika Enable guest selection mati, verifikasi kiosk diarahkan ke encoder yang benar.
5. Jika Enable guest selection aktif, pastikan tamu memilih encoder online di kiosk.

Encoding Saflok/Ambiance tidak berfungsi

Yang Anda lihat: Encoding keycard gagal, time out, atau kiosk melaporkan tidak ada respons dari encoder Saflok/Ambiance.

Perbaikan: Ikuti tiga pemeriksaan berikut secara berurutan. Masing-masing mengeliminasi penyebab umum sebelum Anda lanjut ke langkah berikutnya.

1. Periksa Windows Agent terhubung di AVA

1. Buka Settings → Room Access → Keycard Encoding.

2. Temukan kartu Windows Agent untuk encoder ini.

3. Pastikan status menunjukkan Connected dan waktu Last Seen masih baru.

   

4. Jika agent Not connected, ikuti Windows Agent not connected sebelum melanjutkan.

2. Periksa encoder online di Ambiance

Jika agent terhubung tetapi encoding masih gagal, masuk ke server Ambiance dan verifikasi perangkat encoder.

1. Buka Ambiance lalu buka Device Management → Encoders.

2. Cari encoder untuk kiosk ini (misalnya encoder Vouch).

3. Pastikan Status menampilkan Online.

   

4. Jika encoder menampilkan Offline, lanjut ke langkah 3 untuk me-restart layanan encoder.

3. Restart Ambiance Encoder Service

Jika encoder offline di Ambiance, restart layanan encoder di komputer tempat server Ambiance diinstal.

1. Pada komputer yang menjalankan server Ambiance, tekan tombol Windows atau klik menu Start.

2. Ketik services manager lalu buka Ambiance Services Manager dari hasil pencarian.

3. Di daftar layanan, pilih Ambiance Encoder Service.

   

4. Klik tombol Stop (kotak merah).

5. Tunggu beberapa detik hingga status layanan berubah menjadi Stopped.

6. Klik tombol Start (segitiga merah).

7. Pastikan State kembali menjadi Running.

8. Kembali ke Ambiance Device Management → Encoders dan pastikan encoder Online.

9. Coba encode kartu uji dari kiosk.

Mengapa restart berhasil

Layanan encoder bisa kehilangan koneksi ke encoder fisik setelah gangguan jaringan atau periode idle yang panjang. Menghentikan dan memulai layanan memaksanya membangun ulang koneksi.

Saflok duplicate keycard needs a first keycard

Yang Anda lihat: AVA menampilkan "Please create a new keycard first, then use Duplicate for any extra cards."

Mengapa ini terjadi: Saflok tidak dapat menemukan registrasi aktif atau catatan keycard untuk reservasi tersebut. Duplicate card memerlukan satu keycard pertama yang berhasil sebelum AVA dapat menambahkan kartu tambahan.

Perbaikan:

1. Buat keycard pertama untuk reservasi.
2. Tunggu hingga encoding pertama selesai dengan sukses.
3. Pilih Duplicate hanya setelah keycard pertama ada.
4. Jika error muncul lagi, pastikan reservasi masih memiliki registrasi aktif di Ambiance.
5. Coba permintaan duplicate lagi.

Yang seharusnya tidak Anda lihat

Anda tidak seharusnya melihat ReservationNotFound mentah atau detail SOAP fault di pesan.

Credential Saflok belum disediakan

Yang Anda lihat: "UserCredentialsNotProvided.NotApplicable" muncul selama encoding keycard.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Set Encoder Type ke Saflok.
3. Masukkan Username dan Password di Encoder Credentials.
4. Jika direct communication aktif, masukkan PMSI Server URL.
5. Klik Save.
6. Klik Test Connection, lalu encode satu kartu uji.

Perubahan jenis encoder tidak tersimpan

Yang Anda lihat: Anda memilih satu jenis encoder, tetapi encoder lain tetap aktif.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Di Keycard Encoder Settings, pilih jenis encoder yang Anda inginkan.
3. Klik Save sekali dan tunggu pesan sukses.
4. Refresh halaman dan pastikan hanya jenis encoder itu yang aktif.
5. Jika masalah berulang, ganti jenis, simpan, lalu kembali lagi dan simpan ulang.

Test connection Be-Tech gagal

Yang Anda lihat: "Test Connection" menampilkan kegagalan atau tombol tetap nonaktif.

Perbaikan:

1. Pastikan Base URL diawali http:// atau https://.
2. Verifikasi layanan Be-Tech berjalan di workstation encoder.
3. Periksa workstation dan kiosk berada pada jaringan yang sama.
4. Masukkan ulang Hotel Name, Chain No, Workstation, dan Reader No.
5. Klik Test Connection lagi.

Test connection GreatLocks gagal

Yang Anda lihat: Test Connection gagal setelah Anda mengubah detail server GreatLocks.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Pastikan server GreatLocks memiliki XHLSI Server IP Address dan TCP Port.
3. Klik Save lagi.
4. Jika Anda memperbarui penyiapan lama, pertahankan catatan server yang ada.
5. Klik Test Connection lagi.

Service URL LockSDK wajib diisi

Yang Anda lihat: Save diblokir atau form encoder menampilkan "Service URL is required."

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Pilih LockSDK.
3. Buka Physical Encoder Devices lalu edit encoder.
4. Masukkan Service URL yang valid seperti http://127.0.0.1:8092.
5. Klik Save, lalu jalankan Test Connection.

Agent LockSDK belum terdaftar

Yang Anda lihat: Kartu encoder LockSDK menampilkan Not registered di Windows Agent.

Perbaikan:

1. Pastikan encoder LockSDK ada di Physical Encoder Devices.
2. Buka Windows Agent dan temukan kartu encoder.
3. Klik Download Windows Agent jika kartunya baru, atau Reinstall jika sudah ada.
4. Ekstrak paket dan jalankan file .bat pada PC Windows yang terhubung.
5. Refresh status dan pastikan kartu berubah dari Not registered menjadi Connected atau Not connected.
6. Gunakan Advanced options hanya untuk View Logs, Rotate Secret, atau Delete.

Heartbeat Monitor mati setelah save

Yang Anda lihat: Anda mengaktifkan Heartbeat Monitor, klik Save, lalu statusnya mati lagi.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Buka Encoding Options → Advanced options.
3. Nyalakan Heartbeat Monitor.
4. Klik Save sekali dan tunggu pesan sukses.
5. Refresh halaman dan pastikan Heartbeat Monitor masih aktif.
6. Jika masih mati, ikuti Settings Not Saving After Switching Hotels.

Kegagalan Heartbeat

Yang Anda lihat: Heartbeat Monitor menampilkan unreachable.

Perbaikan:

1. Pastikan agent berjalan di kiosk/PC.
2. Periksa Registered Agents untuk status online dan keterjangkauan tunnel.
3. Tinjau log agent untuk error.
4. Instal ulang agent jika diperlukan.

Status encoder live tidak cocok

Yang Anda lihat: Encoder tampak sudah dikonfigurasi, tetapi AVA tetap menandainya tidak tersedia di modal reservasi.

Mengapa ini terjadi: AVA hanya menampilkan online ketika agent terhubung dan tunnel dapat dijangkau. Status yang sama kini menjadi dasar pemilihan encoder dinamis.

Perbaikan:

1. Periksa Registered Agents untuk kartu encoder.
2. Pastikan perangkat terhubung dan tunnel dapat dijangkau.
3. Perbaiki masalah agent atau jaringan terlebih dahulu.
4. Refresh Settings → Room Access.
5. Coba encode lagi.
6. Periksa ulang baris Status: di halaman pengaturan.

Windows Agent tidak terhubung

Yang Anda lihat: Status menampilkan Not connected atau "Never online."

Perbaikan:

1. Buka zip yang diunduh dan jalankan download-installer.bat.
2. Biarkan file installer .exe selesai diunduh, lalu jalankan file tersebut.
3. Pastikan PC Windows memiliki akses internet.
4. Klik Reinstall pada kartu agent di Windows Agent jika perlu.
5. Refresh status Registered Agents.
6. Kembali ke Settings → Room Access dan pastikan Status: berubah menjadi online.

Daftar encoder dinamis

Saat agent terhubung dan tunnel dapat dijangkau, daftar encoder dinamis seharusnya menampilkan Online. Jika kartu encoder bertingkat masih terlihat offline, refresh halaman dan periksa agent terlebih dahulu.

Aturan routing kiosk tidak muncul

Yang Anda lihat: Anda tidak menemukan aturan routing di bawah Kiosk to Encoder Routing.

Perbaikan:

1. Periksa apakah Enable guest selection aktif.
2. Nonaktifkan agar aturan routing manual ditampilkan.
3. Tambahkan minimal satu perangkat di Physical Encoder Devices.