Pemecahan Masalah Keycard Encoder

Perbaikan Cepat

Periksa jaringan dan daya terlebih dahulu, lalu coba encode ulang satu kartu. Ini memerlukan waktu sekitar 2 menit.

Panduan ini membantu Anda mengatasi masalah umum pada encoder keycard.

Referensi cepat

Yang Anda lihat	Mengapa ini terjadi	Lakukan ini
Encoder tidak merespons	Masalah daya atau jaringan	Periksa konektivitas
"We could not determine the room for this reservation."	Pencarian kamar PMS tidak menghasilkan kamar yang dapat digunakan	Coba lagi menentukan kamar
Kartu tidak dapat di-encode	Masalah jenis kartu atau device	Verifikasi kartu dan device
Kegagalan keycard dalam bahasa biasa	AVA menormalkan error vendor, kamar, atau session	Baca pesannya
"UserCredentialsNotProvided.NotApplicable"	Kredensial Saflok hilang atau belum lengkap	Tambahkan kredensial Saflok
Encoding Saflok/Ambiance gagal atau mengalami timeout	Windows Agent, service encoder Ambiance, atau device sedang 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 ada untuk reservasi tersebut	Perbaiki keycard pertama yang hilang
Kartu Saflok/Ambiance multi-room memerlukan ID tingkat kamar	Kamar yang dipilih belum memiliki sub-reservation sendiri	Periksa kamar yang dipilih
"The keycard encoder is temporarily offline. Please approach the Front Desk for assistance."	Encoder tidak memiliki session aktif	Periksa session encoder
Teks mentah DoorLock generate fail atau internal error muncul	Payload teknis room-access bocor ke modal	Gunakan jalur retry generik
"Request timezone does not match the hotel timezone" atau "Hotel timezone configuration is invalid"	Zona waktu hotel tidak ada, tidak valid, atau bertentangan dengan metadata request	Periksa pengaturan zona waktu Opera
Perubahan jenis encoder tidak bertahan	Save sebelumnya meninggalkan state encoder yang tercampur	Simpan ulang jenis encoder
"Test Connection" gagal (Be-Tech) atau agent tetap offline	Masalah Base URL, adapter, atau service	Perbaiki koneksi Be-Tech
Client atau service Be-Tech berhenti setelah restart atau dihentikan manual	Agent sedang memulihkan client vendor lokal	Tunggu pemulihan Be-Tech
"Make sure the Be-Tech client program is running on the encoder computer."	Windows Agent mengembalikan respons vendor-unavailable 502	Periksa program client Be-Tech
"Test Connection" gagal (GreatLocks)	Detail server GreatLocks yang tersimpan hilang atau sudah usang	Perbaiki koneksi GreatLocks
GreatLocks meminta Anda memilih encoder	Beberapa server atau agent GreatLocks tersedia	Pilih encoder GreatLocks
Inventaris GreatLocks tidak dimuat	Masalah tunnel agent, record server, atau sumber inventaris	Periksa sinkronisasi inventaris GreatLocks
Discovery encoder PMS tidak menemukan hasil	Vendor PMS salah, atau PMS tidak mengekspos terminal	Periksa discovery PMS
Rute Opera ambigu atau tidak lengkap	Opera mengembalikan detail routing Door Lock yang duplikat atau hilang	Perbaiki detail rute Opera
"OPERAWS-FOF01920" muncul saat membaca kartu	Nilai interface lama atau tidak valid dikirim ke Opera	Segarkan rute Opera
"OPERAWS-FOF00199" muncul saat membaca kartu	Opera tidak dapat menjangkau Door Lock System yang dikonfigurasi	Periksa konektivitas Door Lock
Pembacaan kartu PMS tidak tersedia	Pengaturan pembacaan, kapabilitas PMS, atau masalah encoder aktif	Periksa pembacaan kartu PMS
Jenis kartu tidak didukung	Kartu ada, tetapi encoder tidak mengenali jenisnya	Gunakan kartu yang didukung
Kartu tidak dapat dibaca	Kartu ada, tetapi encoder tidak dapat membaca datanya	Coba kartu lain
Kartu tidak terdeteksi	Reader tidak menemukan kartu yang dapat dibaca	Masukkan kembali kartu
Pembacaan kartu Opera menampilkan kegagalan umum	Opera mengembalikan respons kartu yang kosong atau tidak valid	Periksa respons kartu Opera
Kiosk PMS tidak dapat menentukan encodernya	Mapping Device Model dan mapping kiosk lama menggunakan label berbeda	Periksa mapping kiosk PMS
"Service URL is required" (LockSDK)	Mode direct memerlukan Service URL untuk setiap encoder	Tambahkan Service URL LockSDK
Agent LockSDK menampilkan Not registered	Belum ada device agent untuk encoder tersebut	Daftarkan agent LockSDK
Heartbeat Monitor mati setelah disimpan	Save tidak tersimpan dalam session hotel Anda saat ini	Simpan ulang Heartbeat Monitor
Heartbeat menampilkan unreachable	Agent offline atau ada masalah tunnel	Periksa status agent
Heartbeat menampilkan unknown	AVA tidak dapat memverifikasi state encoder	Periksa status unknown
Heartbeat melaporkan error status atau tunnel	Pemeriksaan diagnostik atau tunnel agent gagal	Periksa error yang dilaporkan
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 selesai	Sambungkan kembali agent
"This Windows Agent is too old to read keycards"	Agent yang terpasang tidak menyertakan Read Keycard	Perbarui Windows Agent
"The encoder tunnel is offline"	Tunnel Universal Encoder Agent tidak tersedia	Sambungkan kembali tunnel encoder
Windows meminta izin	Kontrol service tray memerlukan elevasi	Setujui prompt UAC

Kamar reservasi tidak dapat ditentukan

Yang Anda lihat: Setelah memilih encoder, AVA menampilkan "We could not determine the room for this reservation."

Mengapa ini terjadi: Pencarian PMS terautentikasi tidak menghasilkan identitas kamar yang dapat digunakan.

Perbaikan:

1. Segarkan reservasi atau Operations View.
2. Pastikan reservasi memiliki kamar yang ditetapkan di PMS Anda.
3. Mulai kembali alur reservasi, check-in, atau pengelolaan keycard.
4. Pilih encoder online saat diminta AVA.
5. Hubungi support jika pesan kembali muncul setelah kamar ditetapkan di PMS.

AVA menerima identitas kamar PMS yang valid, termasuk identifier AVA PMS yang panjang. Jangan memperpendek atau mengedit identitas kamar PMS secara manual.

Encoder tidak merespons

Yang Anda lihat: Encoder terlihat 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 sudah benar.
4. Restart software encoder.

Kartu tidak dapat di-encode

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

Perbaikan:

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

Kegagalan encode yang dinormalisasi

Yang Anda lihat: Modal reservasi menampilkan pesan singkat dalam bahasa biasa, bukan string vendor mentah.

Mengapa ini terjadi: AVA kini mempertahankan kegagalan Saflok, Be-Tech, Opera, dan session internal yang sudah dinormalisasi sebelum menampilkannya. AVA memprioritaskan pesan terstruktur, lalu kembali ke parsing string vendor lama jika diperlukan. Timeout room-access HTTP 504 tetap menggunakan jalur ini dengan KEYCARD_VENDOR_TIMEOUT. Notifikasi staf dan detail log terkait menggunakan kategori kegagalan yang dinormalisasi yang sama. Misalnya, error saat kartu ada tidak dilaporkan sebagai No card detected.

Perbaikan:

1. Baca pesan singkat terlebih dahulu.
2. Cari userMessage, errorCode, retriable, nama vendor, dan detail upstream yang aman di tampilan support.
3. Gunakan detail tersebut saat menghubungi support.
4. Cocokkan pesan dengan perbaikan yang paling mungkin di bawah ini:
   • Kamar terisi: Segarkan reservasi, lalu coba lagi.
   • Encoder offline: Periksa daya, jaringan, atau status agent.
   • Tidak ada kartu yang terdeteksi: Masukkan kembali kartu dan periksa posisinya.
   • Jenis kartu tidak didukung: Gunakan jenis kartu yang didukung oleh encoder ini.
   • Kartu tidak dapat dibaca: Coba kartu lain dan periksa apakah ada kerusakan.
   • Tidak ada session aktif: Sambungkan kembali session encoder.
   • Mapping hilang: Pastikan mapping kamar sudah benar.
   • Kamar atau tanggal tidak valid: Verifikasi tanggal menginap dan penetapan kamar.
   • Auth, gateway, atau timeout vendor: Periksa akses vendor atau coba lagi nanti.
   • Timeout HTTP 504: Coba lagi setelah menunggu sebentar.
   • Request tidak valid: Buka kembali reservasi yang benar lalu coba lagi.
5. Jika retriable bernilai true, coba lagi setelah melakukan refresh.
6. Jika retriable bernilai false, perbaiki mapping atau masalah vendor terlebih dahulu.

Fallback lama tetap aktif

Respons lama masih dapat menampilkan string vendor lama. AVA mempertahankan jalur parsing tersebut agar log historis dan integrasi lama tetap terbaca dengan benar.

Ketidakcocokan zona waktu Opera

Yang Anda lihat: Alur keycard berhenti sebelum PMS mengembalikan kunci kamar. Anda mungkin melihat "Request timezone does not match the hotel timezone" atau "Hotel timezone configuration is invalid."

Mengapa ini terjadi: AVA memformat validitas keycard Opera sebagai waktu lokal properti, bukan UTC. AVA menghentikan proses dengan aman ketika zona waktu hotel tidak ada atau tidak valid. AVA juga menghentikan proses ketika data zona waktu request bertentangan.

Perbaikan:

1. Buka Settings → Essentials → Hotel Basic Details.
2. Pastikan Timezone valid dan sesuai dengan waktu lokal properti.
3. Simpan perubahan jika Anda memperbaruinya.
4. Segarkan reservasi atau buka kembali alur keycard.
5. Coba request keycard lagi.

Encoding Saflok/Ambiance tidak berfungsi

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

Perbaikan: Lakukan tiga pemeriksaan berikut secara berurutan. Masing-masing mengesampingkan penyebab umum sebelum Anda lanjut ke pemeriksaan berikutnya.

Pemulihan Saflok otomatis

Jika Saflok PMSI mulai dengan lambat atau restart kemudian, AVA memeriksa ulang kesiapan setiap 10 detik. Tunggu sebentar, lalu segarkan sebelum menginstal ulang agent.

1. Periksa koneksi Windows Agent di AVA

1. Buka Settings → Room Access → Keycard Encoding.

2. Temukan kartu Windows Agent untuk encoder ini.

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

   

4. Jika agent Not connected, ikuti Windows Agent tidak terhubung sebelum melanjutkan. Jika Saflok PMSI masih dalam proses mulai, tunggu 10 detik dan segarkan sekali sebelum menginstal ulang apa pun.

2. Periksa encoder online di Ambiance

Jika agent terhubung tetapi encoding masih gagal, login ke server Ambiance dan verifikasi device encoder.

1. Buka Ambiance dan buka Device Management → Encoders.

2. Temukan encoder untuk kiosk ini, misalnya encoder Vouch.

3. Pastikan Status menampilkan Online.

   

4. Jika encoder menampilkan Offline, lanjutkan ke langkah 3 untuk merestart service encoder.

3. Restart Ambiance Encoder Service

Jika encoder offline di Ambiance, restart service encoder di komputer tempat server Ambiance terpasang.

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

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

3. Dalam daftar service, pilih Ambiance Encoder Service.

   

4. Klik tombol Stop (kotak merah).

5. Tunggu beberapa detik sampai state service berubah menjadi Stopped.

6. Klik tombol Start (tombol play merah).

7. Pastikan State kembali menjadi Running.

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

9. Coba encode test card dari kiosk.

Mengapa restart berhasil

Service encoder dapat kehilangan koneksi ke encoder fisik setelah gangguan jaringan atau periode idle yang lama. Menghentikan lalu memulai service memaksanya membangun kembali koneksi.

Duplicate keycard Saflok memerlukan keycard pertama

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 record keycard untuk reservasi tersebut. Kartu duplikat memerlukan satu keycard pertama yang berhasil sebelum AVA dapat menambahkan kartu lainnya.

Perbaikan:

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

Hal yang seharusnya tidak Anda lihat

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

Keycard multi-room Saflok/Ambiance memerlukan ID reservasi tingkat kamar

Yang Anda lihat: Anda mencoba encode kartu untuk satu kamar dalam masa inap multi-room, lalu AVA menghentikan alurnya.

Mengapa ini terjadi: Kartu duplikat Saflok/Ambiance menggunakan ID sub-reservation milik kamar yang dipilih. Jika kamar tersebut belum memiliki ID sendiri, Anda akan melihat error fail-fast.

Perbaikan:

1. Buka reservasi dan pilih baris kamar yang tepat.
2. Tunggu sinkronisasi PMS jika kamar baru saja dipisah atau dipindahkan.
3. Pastikan kamar tersebut ada sebagai sub-reservation tersendiri di PMS Anda.
4. Coba Encode Keycard lagi.

Encoder tidak memiliki session aktif

Yang Anda lihat: AVA menampilkan "The keycard encoder is temporarily offline. Please approach the Front Desk for assistance."

Mengapa ini terjadi: Encoder saat ini tidak memiliki session aktif. AVA memperlakukannya sebagai masalah kesiapan offline.

Perbaikan:

1. Pastikan encoder menyala dan terhubung.
2. Segarkan Settings → Room Access → Keycard Encoding.
3. Periksa apakah encoder menampilkan Online atau Connected.
4. Coba encode lagi setelah session tersambung kembali.
5. Jika masih gagal, gunakan encoder lain atau hubungi support.

Payload room-access mentah tampil di modal

Yang Anda lihat: Modal menampilkan teks mentah seperti DoorLock generate fail! atau internal error.

Mengapa ini terjadi: AVA menangkap blob room-access teknis. AVA kini kembali ke pesan retry generik, bukan menampilkan payload mentah.

Perbaikan:

1. Tutup modal.
2. Tunggu beberapa detik.
3. Coba encode keycard lagi.
4. Jika pesan yang sama muncul lagi, pastikan encoder online.
5. Jika masih gagal, beralih ke encoder lain atau hubungi support.

Kredensial Saflok belum tersedia

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

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Atur 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 test card.

Perubahan jenis encoder tidak bertahan

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. Segarkan halaman dan pastikan hanya jenis encoder tersebut yang aktif.
5. Jika masalah berulang, ganti jenis, simpan, lalu ganti kembali dan simpan lagi.

Discovery encoder PMS tidak menemukan hasil

Yang Anda lihat: Anda mengeklik Load Encoders, tetapi AVA tidak menampilkan terminal PMS.

Mengapa ini terjadi: Pengaturan vendor PMS tidak sesuai dengan properti Anda, atau PMS Anda tidak mengekspos terminal encoder.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Pastikan PMS vendor sesuai dengan properti Anda.
3. Klik Save lagi.
4. Kembali ke Physical Encoder Devices dan klik Load Encoders.
5. Jika daftar masih kosong, pastikan integrasi PMS Anda aktif.
6. Jika PMS masih tidak mengekspos terminal, hubungi support dengan nama vendor dan nama properti Anda.

Pembacaan kartu PMS tidak tersedia

Yang Anda lihat: Entitlements tidak menampilkan Start scanning, atau menampilkan bahwa pembacaan keycard fisik tidak tersedia.

Mengapa ini terjadi: Pembacaan dinonaktifkan, adapter PMS tidak mendukungnya, atau pencarian kapabilitas untuk sementara tidak tersedia. Pembacaan kartu PMS juga memerlukan encoder PMS yang aktif.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Pilih PMS Integration.
3. Pastikan Enable PMS Encoder Integration aktif.
4. Pastikan vendor PMS sesuai dengan properti Anda.
5. Pastikan encoder yang ditemukan berstatus Active.
6. Aktifkan Enable physical keycard reading, lalu klik Save.
7. Muat ulang Entitlements dan cari Start scanning.
8. Gunakan Look up by room atau Look up by confirmation number saat pembacaan tidak tersedia.

Pembacaan kartu PMS menggunakan transportasi PMS secara langsung. Pembacaan tersebut tidak memerlukan session Universal Encoder Agent. Jika peringatan tetap muncul, adapter PMS Anda mungkin belum mengumumkan dukungan pembacaan.

Rute Opera ambigu atau tidak lengkap

Yang Anda lihat: Pembacaan kartu Opera tetap tidak tersedia setelah Anda memuat encoder.

Mengapa ini terjadi: Opera mengembalikan detail workstation, encoder, interface, atau outbound-code yang duplikat atau tidak lengkap. AVA menghentikan proses dengan aman alih-alih mengirim pembacaan kartu ke rute Door Lock yang salah.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Pastikan PMS vendor adalah Opera.
3. Pastikan encoder yang dimaksud berstatus Active.
4. Klik Load Encoders, lalu Add Selected saat terminal yang benar muncul.
5. Minta administrator Opera memperbaiki detail interface Door Lock yang duplikat atau hilang.
6. Muat ulang Entitlements setelah katalog encoder diperbaiki.
7. Sementara itu, gunakan Look up by room atau Look up by confirmation number.

Hubungi support jika rute tetap tidak tersedia setelah Opera mengonfirmasi satu rute yang tepat.

Error validasi interface Opera

Yang Anda lihat: Pembacaan kartu menampilkan OPERAWS-FOF01920 atau error validasi nomor interface.

Mengapa ini terjadi: Opera menolak nilai interface dari request. Hal ini dapat terjadi ketika rute lama tetap tersimpan di cache setelah detail encoder berubah.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Pastikan workstation dan ID encoder Opera sesuai dengan device fisik.
3. Klik Load Encoders, lalu Add Selected untuk terminal saat ini.
4. Pastikan encoder berstatus Active.
5. Muat ulang Entitlements, lalu coba Start scanning lagi.
6. Gunakan Look up by room atau Look up by confirmation number jika pembacaan masih gagal.

AVA menggunakan nilai seperti SL01 untuk memilih rute Door Lock. AVA menggunakan outbound code numerik rute tersebut untuk pembacaan fisik. Jangan mengonversi atau mengedit nilai interface sendiri.

Hubungi support jika OPERAWS-FOF01920 muncul lagi setelah Anda memuat ulang encoder saat ini.

Timeout Opera Door Lock System

Yang Anda lihat: Pembacaan kartu menampilkan OPERAWS-FOF00199 atau timeout Door Lock System.

Mengapa ini terjadi: Opera menerima request, tetapi tidak dapat menjangkau Door Lock System yang dikonfigurasi. Ini adalah masalah konektivitas operasional, bukan hasil kartu yang hilang.

Perbaikan:

1. Pastikan interface Saflok dan encoder menyala.
2. Periksa koneksi jaringan properti ke Door Lock System.
3. Pastikan interface Door Lock Opera sedang online.
4. Masukkan kembali kartu dan coba Start scanning satu kali.
5. Gunakan Look up by room atau Look up by confirmation number saat interface offline.
6. Minta administrator Opera memeriksa konektivitas Door Lock System dan encoder.

Jangan menganggap error ini sebagai No card detected. Hubungi support jika interface tetap online tetapi pembacaan terus mengalami timeout.

Jenis kartu tidak didukung

Yang Anda lihat: AVA menyatakan bahwa jenis kartu tidak didukung atau tidak dikenali.

Mengapa ini terjadi: Kartu ada, tetapi encoder ini tidak mengenali jenisnya. Ini berbeda dari kartu yang tidak ada.

Perbaikan:

1. Keluarkan kartu dari encoder.
2. Pastikan Anda menggunakan jenis kartu yang disetujui untuk encoder ini.
3. Letakkan kartu kosong yang didukung pada encoder.
4. Coba encode keycard lagi.
5. Jika pesan kembali muncul, minta manajer Anda memastikan pengaturan encoder dan kartu.

Jangan terus mengubah posisi kartu ketika AVA mengidentifikasi jenis kartu yang tidak didukung.

Kartu tidak dapat dibaca

Yang Anda lihat: AVA menyatakan bahwa kartu tidak dapat dibaca atau pembacaan kartu gagal.

Mengapa ini terjadi: Kartu ada, tetapi encoder tidak dapat membaca datanya. Kartu mungkin rusak, tidak kompatibel, atau ditempatkan dengan tidak benar.

Perbaikan:

1. Keluarkan kartu dari encoder.
2. Periksa apakah ada kerusakan yang terlihat pada kartu.
3. Masukkan kembali kartu dengan sisi yang benar menghadap ke atas.
4. Coba kartu lain yang didukung jika error kembali muncul.
5. Hubungi support jika beberapa kartu yang diketahui tidak dapat dibaca.

Tidak ada kartu yang terdeteksi

Yang Anda lihat: AVA melaporkan tidak ada kartu yang terdeteksi setelah Anda memulai pemindaian kartu PMS.

Mengapa ini terjadi: Reader tidak menemukan kartu pada encoder. Ini berbeda dari jenis kartu yang tidak didukung atau kartu yang tidak dapat dibaca.

Perbaikan:

1. Keluarkan kartu dari reader.
2. Masukkan kembali kartu dengan sisi yang benar menghadap ke atas.
3. Tunggu reader selesai, lalu coba pemindaian lagi.
4. Gunakan Look up by room atau Look up by confirmation number jika kartu masih tidak terbaca.
5. Hubungi support jika beberapa kartu yang diketahui valid sama-sama tidak terdeteksi.

Pembacaan kartu Opera menampilkan kegagalan umum

Yang Anda lihat: AVA menampilkan kegagalan umum pembacaan keycard PMS setelah Opera mengembalikan HTTP 200.

Mengapa ini terjadi: Opera mungkin mengembalikan rentang tanggal dan waktu keberangkatan, bukan field validitas lama. AVA menerima rentang yang tidak kosong dan menggunakan akhirnya sebagai waktu checkout kartu. Rentang yang kosong atau formatnya rusak tetap tidak valid.

Perbaikan:

1. Pastikan kartu dikodekan oleh Opera dan terkait dengan reservasi yang diharapkan.

2. Masukkan kembali kartu dan pilih Start scanning lagi.

3. Jika AVA membaca kartu tanpa kamar, gunakan Look up by room atau Look up by confirmation number.

4. Jika kegagalan umum terus terjadi, gunakan pencarian manual dan minta administrator Opera memeriksa data kartu.

5. Hubungi support dengan waktu pemindaian, properti, dan nama encoder.

   ✓ Kartu Opera yang valid seharusnya muncul sebagai data yang terbaca, meskipun Opera tidak menyertakan kamar.

Mapping encoder kiosk PMS tidak dapat ditentukan

Yang Anda lihat: Kiosk PMS tidak dapat meng-encode kartu, meskipun encoder terlihat di Physical Encoder Devices.

Mengapa ini terjadi: Mapping Device Model kiosk dan mapping kiosk lama dapat menggunakan label yang berbeda. AVA menggunakan mapping Device Model terlebih dahulu, lalu beralih ke mapping lama jika diperlukan.

Perbaikan:

1. Buka Settings → Kiosk → Device Routing.

2. Temukan kiosk yang terdampak dan periksa mapping encoder targetnya.

3. Buka Settings → Room Access → Keycard Encoding.

4. Pastikan encoder PMS yang sesuai berstatus Active di Physical Encoder Devices.

5. Jika target berubah, simpan mapping menggunakan nama PMS encoder saat ini.

6. Coba encode satu test card dari kiosk.

   ✓ AVA seharusnya mengarahkan kiosk ke encoder PMS aktif dan mengirim request.

Jika encoder tidak ada di Physical Encoder Devices, ikuti Discovery encoder PMS tidak menemukan hasil.

Tes koneksi Be-Tech gagal

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

Gunakan bagian ini ketika Anda memang mengonfigurasi Base URL direct atau melihat kegagalan request Be-Tech umum. Jika Anda melihat pesan program client, gunakan Program client Be-Tech tidak tersedia.

Pemeriksaan keterjangkauan Be-Tech

AVA menganggap respons 405 dapat dijangkau karena beberapa deployment Be-Tech tidak mendukung metode pemeriksaan tersebut. AVA menganggap respons 401, 404, dan 5xx tidak tersedia.

Perbaikan:

1. Pastikan Base URL dimulai dengan http:// atau https://.
2. Pastikan service Be-Tech berjalan di workstation encoder.
3. Periksa apakah workstation dan kiosk berada di jaringan yang sama.
4. Jika Anda menggunakan Windows Agent, pastikan kartu agent berstatus Connected.
5. Masukkan kembali Hotel Name, Chain No, Workstation, dan Reader No.
6. Klik Test Connection lagi.

Client atau service Be-Tech berhenti setelah restart atau dihentikan manual

Yang Anda lihat: Client atau service Be-Tech berhenti setelah Windows direstart atau dihentikan secara manual. AVA mungkin menampilkan encoder sebagai tidak tersedia untuk sementara.

Mengapa ini terjadi: Client Be-Tech dapat dimulai secara terpisah dari Windows Agent. Tray kini mendeteksi client yang terpasang dan memulihkan servicenya secara otomatis.

Perbaikan:

1. Biarkan service Windows Agent tetap berjalan di komputer encoder.
2. Tunggu sebentar sampai tray menampilkan notifikasi pemulihan Be-Tech.
3. Tunggu notifikasi yang menyatakan service client Be-Tech kembali berjalan.
4. Segarkan Settings → Room Access → Keycard Encoding.
5. Pastikan agent dan encoder menampilkan Connected atau Online.
6. Coba kembali operasi keycard.

Retry otomatis

Jika pemulihan gagal, tray akan mencoba lagi secara otomatis. Gunakan tindakan Restart di tray hanya jika pemulihan terus gagal.

Jika hotel memiliki beberapa instalasi Be-Tech, tanyakan kepada admin deployment Anda tentang BETECH_CLIENT_PATH. Path tersebut harus mengarah ke instalasi Program Files yang tepercaya.

Program client Be-Tech tidak tersedia

Yang Anda lihat: AVA menampilkan "Make sure the Be-Tech client program is running on the encoder computer."

Mengapa ini terjadi: Windows Agent tidak dapat menjangkau service client Be-Tech lokal. Tray mungkin sudah memulihkan client atau service tersebut.

Perbaikan:

1. Buka komputer encoder.
2. Periksa notifikasi pemulihan Be-Tech di tray Windows.
3. Tunggu sebentar, lalu segarkan Settings → Room Access → Keycard Encoding.
4. Jika agent tetap offline, gunakan tindakan Restart di tray.
5. Klik Test Connection lagi.

Kegagalan Be-Tech lainnya

Jika Anda melihat Be-Tech request failed, ikuti Tes koneksi Be-Tech gagal. Pesan program client langsung hanya berlaku untuk respons vendor-unavailable 502.

Tes koneksi GreatLocks gagal

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

Perbaikan:

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

Pemilihan encoder GreatLocks diperlukan

Yang Anda lihat: Tindakan status atau konfigurasi GreatLocks meminta Anda memilih encoder.

Mengapa ini terjadi: Setiap Universal Encoder Agent melayani satu encoder GreatLocks. AVA tidak dapat memilih target dengan aman ketika tersedia beberapa server atau agent.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Buka Physical Encoder Devices.
3. Pastikan setiap baris GreatLocks memiliki tepat satu Encoder ID. Gunakan ID yang berbeda untuk setiap encoder fisik.
4. Pilih encoder yang terhubung ke PC Windows yang Anda perlukan.
5. Pastikan agent-nya Online.
6. Simpan, lalu ulangi tindakan status, konfigurasi, atau test.

Status encoder terpisah

Setiap encoder GreatLocks memiliki status live-nya sendiri. Satu agent online tidak membuat encoder lain menjadi online.

Inventaris GreatLocks tidak dimuat

Yang Anda lihat: Inventaris gedung, lantai, atau kamar untuk GreatLocks tetap kosong.

Mengapa ini terjadi: Tunnel GreatLocks sedang offline, atau sumber inventaris tidak dapat dijangkau.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Pastikan record server GreatLocks sudah disimpan.
3. Jika ada beberapa encoder GreatLocks, pilih encoder yang tertaut ke inventaris ini.
4. Periksa apakah tunnel agent-nya menunjukkan koneksi yang sehat.
5. Klik Test Connection lagi.
6. Segarkan halaman setelah koneksi kembali.

Service URL LockSDK diperlukan

Yang Anda lihat: Save terblokir atau formulir encoder menampilkan "Service URL is required."

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Pilih LockSDK.
3. Buka Physical Encoder Devices dan edit encoder tersebut.
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 tersebut.
3. Klik Download Windows Agent jika kartunya baru, atau Reinstall jika sudah ada.
4. Ekstrak paket dan jalankan file .bat di PC Windows yang terhubung.
5. Segarkan 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. Rotate Secret membuka dialog konfirmasi sebelum AVA memutuskan agent saat ini.

Heartbeat Monitor mati setelah disimpan

Yang Anda lihat: Anda mengaktifkan Heartbeat Monitor, mengeklik Save, lalu fitur tersebut mati lagi.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Buka Encoding Options → Advanced options.
3. Aktifkan Heartbeat Monitor.
4. Klik Save sekali dan tunggu pesan sukses.
5. Segarkan 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 mencari error.
4. Instal ulang agent jika diperlukan.

Arti status

Online berarti AVA memverifikasi encoder dan tunnel. Offline berarti AVA memverifikasi bahwa encoder tidak tersedia. Unknown berarti AVA tidak dapat memverifikasi state encoder. Unknown tidak otomatis berarti encoder offline.

Status encoder menampilkan unknown

Yang Anda lihat: Heartbeat Monitor menampilkan unknown, tetapi session agent dan tunnel sehat.

Mengapa ini terjadi: Diagnostik vendor opsional mungkin tidak tersedia. Kredensial Saflok Ambiance opsional yang hilang dapat menghasilkan status yang belum terverifikasi.

Perbaikan:

1. Periksa Registered Agents dan pastikan agent terhubung.
2. Pastikan Last Seen masih baru dan tunnel dapat dijangkau.
3. Jangan merestart atau menginstal ulang agent hanya berdasarkan unknown.
4. Uji satu keycard jika Anda perlu memastikan encoder masih berfungsi.
5. Hubungi support jika error status berlanjut atau encoding gagal.

Error status atau tunnel pada heartbeat

Yang Anda lihat: Heartbeat melaporkan error status atau kegagalan tunnel.

Perbaikan:

1. Baca pesan lengkap dan catat apakah pesan menyebut status encoder atau tunnel.
2. Untuk status error, periksa diagnostik vendor dan catat pesan persisnya.
3. Untuk tunnel failure, pastikan agent berjalan dan Last Seen masih baru.
4. Segarkan Settings → Room Access dan periksa status lagi.
5. Hubungi support jika error tetap muncul atau encoding keycard gagal.

Status live encoder tidak sesuai

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

Mengapa ini terjadi: AVA hanya menampilkan Online setelah memverifikasi agent dan tunnel. Hasil Unknown berarti state encoder belum terverifikasi, bukan dipastikan offline. Status yang sama kini mengatur pemilihan encoder dinamis. Untuk GreatLocks, status hanya berlaku untuk encoder yang terkait dengan agent tersebut.

Perbaikan:

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

Windows Agent terlalu usang untuk membaca keycard

Yang Anda lihat: Read Keycard gagal dengan pesan "This Windows Agent is too old to read keycards. Update the Universal Encoder Agent, then try again."

Mengapa ini terjadi: Build Universal Encoder Agent yang lebih lama tidak mengekspos API baca Saflok. AVA kemudian mengakses halaman web default PC hotel, bukan agent.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Jika Windows Agent menampilkan outdated, klik Update sebelum Reinstall.
3. Tunggu sampai agent tersambung kembali.
4. Coba Read Keycard lagi.

Tunnel encoder offline

Yang Anda lihat: Read Keycard menampilkan "The encoder tunnel is offline. Start the Universal Encoder Agent, then try again."

Mengapa ini terjadi: Komputer encoder tidak dapat menjangkau AVA melalui tunnel Universal Encoder Agent-nya. Ini berbeda dari agent yang usang, yang memerlukan pembaruan.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoding.
2. Temukan kartu Windows Agent Saflok.
3. Jalankan Universal Encoder Agent di komputer encoder.
4. Tunggu sampai agent menampilkan Connected dan waktu Last Seen-nya masih baru.
5. Coba Read Keycard lagi.
6. Jika agent tetap offline, ikuti Windows Agent tidak terhubung.

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 tersebut mengunduh installer .exe, lalu jalankan file itu.
3. Pastikan PC Windows memiliki akses internet.
4. Klik Reinstall pada kartu agent di Windows Agent jika diperlukan.
5. Jika ini setup Be-Tech, pastikan juga service adapter lokal berjalan. Status Be-Tech dapat memerlukan waktu hingga 5 menit untuk diperbarui setelah restart.
6. Segarkan status Registered Agents.
7. 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, segarkan halaman dan periksa agent terlebih dahulu.

Tindakan service Windows Agent memerlukan izin

Yang Anda lihat: Windows meminta izin administrator saat Anda mengeklik Start, Stop, atau Restart.

Mengapa ini terjadi: Tombol tray memerlukan akses yang ditinggikan untuk mengontrol service Windows.

Perbaikan:

1. Klik Yes pada prompt UAC.
2. Jika Anda bukan admin, minta seseorang yang memiliki hak admin untuk menyetujuinya.
3. Coba tindakan tersebut lagi jika Anda sebelumnya membatalkan prompt.

Aturan routing kiosk tidak ditampilkan

Yang Anda lihat: Anda tidak dapat menemukan aturan routing di bawah Room Access atau bagian lama Kiosk to Encoder Routing.

Perbaikan:

1. Buka Settings → Kiosk.
2. Buka Device Routing.
3. Matikan Enable guest selection untuk menampilkan aturan routing manual.
4. Tambahkan setidaknya satu device di Physical Encoder Devices.

Masih buntu?

Hubungi success@vouch-technologies.com jika:

• ❌ Encoder tetap offline setelah pemeriksaan daya dan jaringan
• ❌ Program client Be-Tech terus berhenti
• ❌ Encoding kartu gagal di beberapa kiosk
• ❌ Heartbeat tetap tidak sehat selama lebih dari 30 menit

Sebaiknya sertakan:

• Jenis dan model encoder
• Pesan error Be-Tech yang persis
• Apakah Anda menggunakan Windows Agent atau Base URL direct
• Screenshot Registered Agents dan Heartbeat Monitor
• Waktu masalah mulai terjadi

Panduan terkait

• Ringkasan Keycard Encoders
• Menyiapkan Keycard Encoders
• Petunjuk Keycard untuk Tamu