Menyiapkan Encoder Keycard

Penyiapan Cepat

Pilih jenis encoder, pilih metode koneksi jika diperlukan, lalu tambahkan encoder. Siapkan waktu sekitar 15 menit.

Panduan ini membantu Anda mengonfigurasi encoding keycard berbasis encoder untuk penggunaan kiosk atau meja depan. Panduan ini kini juga mencakup penyiapan Be-Tech Windows Agent. Secara default, Be-Tech menggunakan Windows Agent kecuali Anda mengonfigurasi Base URL langsung. Routing kiosk kini berada di Settings → Kiosk. Keycard yang terintegrasi dengan PMS kini menemukan terminal encoder dari vendor PMS sebelum Anda menambahkannya. Penyiapan Be-Tech Windows Agent dapat memulihkan client atau service yang berhenti setelah Windows dimulai ulang atau dihentikan secara manual.

Referensi cepat

Tugas	Fungsinya	Di mana Anda mengeklik
Select method	Mengaktifkan encoding keycard	Room Access → Keycard Encoding
Choose encoder type	Memilih sistem kunci Anda	Encoder Type
Choose connection method	Direct vs. Windows Agent (Saflok/Be-Tech/GreatLocks)	Advanced options → Enable direct communication
Configure encoder	Menambahkan detail server atau kredensial	Kolom khusus tipe
Add encoders	Mendaftarkan perangkat fisik dengan ID encoder yang sebenarnya	Physical Encoder Devices
Load PMS encoders	Mengambil terminal yang tersedia dari PMS Anda	Physical Encoder Devices → Load Encoders
Enable PMS card reading	Memungkinkan Entitlements membaca keycard PMS fisik	Enable physical keycard reading
Choose kiosk routing	Mengontrol aturan routing khusus kiosk	Settings → Kiosk → Device Routing
Download Windows Agent	Mengunduh paket bootstrap untuk agent	Windows Agent
Check agent version	Menampilkan status versi yang terpasang dan terbaru	Windows Agent
Update agent	Membuka modal petunjuk pembaruan	Update
Manage agent cards	Kartu utama menampilkan tindakan install, update, atau reinstall	Windows Agent
Advanced agent actions	Melihat log, merotasi secret, atau menghapus agent	Advanced options
Set encoding defaults	Jumlah kartu per masa inap + waktu kedaluwarsa	Encoding Options

Tempat menemukannya

Settings → Room Access → Keycard Encoding

Langkah 1: Pilih metode keycard

1. Buka Settings → Room Access.
2. Pilih Keycard Encoding sebagai metode akses kamar.
3. Klik Save.

Langkah 2: Pilih jenis encoder

1. Gulir ke Keycard Encoder Settings.

2. Pilih Saflok, Be-Tech, LockSDK, GreatLocks, atau PMS Integration.

   ✓ AVA hanya mempertahankan jenis encoder yang Anda pilih tetap aktif.

Langkah 3: Pilih metode koneksi

1. Di Select Encoder Type, buka Advanced options.
2. Untuk Saflok, GreatLocks, atau LockSDK, aktifkan Enable direct communication untuk melewati Windows Agent.
3. Biarkan nonaktif untuk menggunakan Windows Agent (default).
4. Be-Tech menggunakan Windows Agent kecuali Anda sudah mengonfigurasi Base URL langsung.
5. PMS Integration hanya menggunakan komunikasi langsung, jadi langkah ini dilewati.

Langkah 4: Konfigurasikan sistem encoder

Judul Kredensial Encoder

Jika Anda menggunakan beberapa encoder, judul bagian akan menampilkan Encoder Credentials & Devices.

Jika Anda menggunakan Saflok

• Direct communication
  • Masukkan PMSI Server URL, Username, dan Password.
  • Server PMSI harus dapat dijangkau dari internet.
  • Klik Test Connection.
• Windows Agent
  • Masukkan hanya Username dan Password.
  • URL PMSI dan pengujian koneksi ditangani oleh agent.
  • AVA terus memeriksa kesiapan PMSI Saflok, sehingga proses boot dan mulai ulang yang lambat biasanya pulih secara otomatis.
• Tambahkan perangkat encoder di Physical Encoder Devices (Encoder ID wajib diisi).
• Opsional: atur Location untuk setiap encoder.
• Jika beberapa kiosk menggunakan encoder yang sama, tambahkan routing dari Settings → Kiosk → Device Routing.

Jika Anda menggunakan Be-Tech

• Direct communication
  • Masukkan Base URL untuk service Be-Tech.
  • Service harus dapat dijangkau dari internet.
  • Masukkan Hotel Name, Chain No, Workstation, dan Reader No.
  • Atur Category dan Card Type jika penyiapan Be-Tech Anda memerlukannya.
  • Jika Base URL disimpan, AVA mempertahankan Be-Tech dalam mode direct.
  • Klik Test Connection untuk memastikan encoder merespons.
• Windows Agent
  • Instal agent di PC Windows yang terhubung ke workstation Be-Tech.
  • Masukkan Hotel Name, Chain No, Workstation, dan Reader No.
  • Agent menangani adaptor Be-Tech lokal dan mem-proxy trafik vendor.
  • AVA memeriksa agent di /check setiap 5 menit.
  • Setelah Windows dimulai ulang atau dihentikan secara manual, tray dapat memulai client dan service Be-Tech secara otomatis.
  • Tray memperbarui kesiapan Be-Tech setelah pemulihan tanpa memerlukan mulai ulang agent secara manual.
  • Jika tidak ada Base URL yang disimpan, AVA beralih ke alur Windows Agent.
• Tambahkan perangkat encoder di Physical Encoder Devices.
• Opsional: tambahkan routing dari Settings → Kiosk → Device Routing jika Anda menggunakan beberapa encoder.

Beberapa instalasi Be-Tech

Agent menemukan instalasi Be-Tech biasa secara otomatis. Minta admin deployment Anda mengatur BETECH_CLIENT_PATH hanya jika beberapa instalasi terlindungi menyebabkan ambiguitas. Override tersebut harus mengarah ke dalam folder Windows Program Files yang terlindungi.

Jika Anda menggunakan GreatLocks

• Direct communication
  • Masukkan Server Name (opsional), XHLSI Server IP Address, dan TCP Port.
  • Server harus dapat dijangkau dari internet.
  • GreatLocks mendukung satu encoder per server.
  • Klik Test Connection.
• Windows Agent
  • Detail server ditangani oleh agent; IP/port tidak diperlukan.
  • Instal satu Universal Encoder Agent di PC yang terhubung ke setiap encoder GreatLocks.

Satu agent GreatLocks per encoder

Tambahkan satu baris di Physical Encoder Devices untuk setiap encoder GreatLocks. Masukkan tepat satu Encoder ID di setiap baris. Gunakan ID unik untuk setiap baris, seperti front-desk atau lobby-pc. AVA mempertahankan ID yang ada saat Anda mengedit baris yang tersimpan. Baris lama tanpa ID akan menerima ID stabil saat AVA memuatnya. Kemudian instal satu Universal Encoder Agent di PC Windows yang sesuai. Setiap agent hanya melayani encoder yang terkait dengannya.

Catatan: AVA menggunakan catatan server GreatLocks yang Anda simpan di Room Access. Jika Anda memperbarui penyiapan lama, klik Save sebelum Test Connection. Jika sinkronisasi inventaris diaktifkan, AVA membaca data gedung, lantai, dan kamar melalui tunnel agent yang aktif. Biarkan agent online agar daftar kamar tetap mutakhir. Jika penyiapan GreatLocks Anda mendukung akses lift, aktifkan Enable lift access. Lalu pilih mode yang didukung vendor Anda:

• Room floor mapping menggunakan nilai gedung dan lantai dari pemetaan kamar Anda.
• Access code groups menggunakan Common access codes untuk pintu bersama atau grup lift.

AVA hanya mengirim satu jenis opsi lift per kartu. Saat menggunakan grup kode akses, AVA menyimpan digit tunggal sebagai kode dua digit. Anda dapat mengetik 1,2,3 atau 01,02,03. Pastikan kode berada dalam rentang yang didukung vendor Anda.

Jika Anda menggunakan LockSDK

• Direct communication
  • Tambahkan setiap encoder LockSDK di Physical Encoder Devices.
  • Masukkan Encoder ID dan Service URL untuk setiap encoder.
  • Klik Test Connection setelah menambahkan entri encoder.
• Windows Agent
  • Tambahkan setiap encoder LockSDK di Physical Encoder Devices.
  • Daftarkan satu Windows Agent per encoder LockSDK.
  • Kartu agent menampilkan encoder yang sesuai dan status live.
• Opsional: tambahkan routing dari Settings → Kiosk → Device Routing jika Anda menggunakan beberapa encoder.
• Untuk kamar gabungan, LockSDK mendukung hingga 4 kamar dan memerlukan jenis kunci RF50/Mifare lock type 5.

Jika Anda menggunakan PMS Integration

• Pastikan integrasi PMS aktif (Cloudbeds atau Opera).
• Atur PMS vendor agar sesuai dengan properti Anda sebelum memuat encoder.
• Aktifkan Enable PMS Encoder Integration.
• Di Physical Encoder Devices, lakukan salah satu tindakan berikut:
  • Klik Load Encoders lalu Add Selected, atau
  • Klik Add Encoder dan masukkan Encoder ID serta PMS Encoder ID.
• Perangkat yang dimuat kini menyimpan provider encoder ID secara langsung.
• Penemuan ulang menyimpan workstation, encoder, interface, dan detail kode outbound yang diperlukan untuk pembacaan kartu PMS.
• Pembacaan Opera hanya berfungsi jika detail tersebut mengidentifikasi satu rute Door Lock yang tepat.
• Gunakan Active untuk menonaktifkan encoder yang tidak ingin digunakan.
• Aktifkan Enable physical keycard reading hanya setelah API pembacaan PMS divalidasi.
• Klik Save setelah mengubah pengaturan pembacaan.
• Jika daftarnya kosong, periksa pengaturan vendor PMS terlebih dahulu.
• Jika encoder masih tidak terlihat, baca Penemuan encoder PMS tidak menghasilkan apa pun.

Pembacaan kartu PMS terpisah dari encoding

Encoding PMS dapat terus berjalan saat pembacaan kartu fisik dinonaktifkan. Entitlements menyembunyikan kontrol pemindaian sampai kemampuan PMS dan Room Access mengizinkan pembacaan. Biarkan pembacaan nonaktif sampai provider PMS Anda mengonfirmasi bahwa API pembacaan berfungsi untuk properti Anda.

Dukungan pembacaan kartu PMS

Vendor PMS	Pembacaan kartu fisik	Yang harus Anda lakukan
Opera Cloud (OHIP)	Didukung jika adaptor mengiklankan kemampuan tersebut	Selesaikan penerimaan perangkat keras sebelum mengaktifkan pembacaan
Vendor PMS lainnya	Tidak tersedia kecuali vendor mengiklankan dukungan	Gunakan pencarian kamar atau konfirmasi secara manual

AVA menonaktifkan pembacaan secara aman jika PMS Anda tidak mengiklankan pembacaan kartu fisik. Alur encoding keycard yang ada tetap tersedia.

Aktifkan pembacaan kartu PMS

Pembacaan kartu PMS menggunakan transport PMS secara langsung. Pembacaan ini tidak memerlukan sesi Universal Encoder Agent. AVA mengaktifkan pemindaian hanya jika pengaturan merchant dan kemampuan PMS Anda sama-sama mengizinkannya.

1. Pilih PMS Integration di bagian Encoder Type.

2. Pastikan Enable PMS Encoder Integration aktif.

3. Pastikan setidaknya satu encoder yang ditemukan berstatus Active.

4. Aktifkan Enable physical keycard reading.

5. Klik Save.

6. Buka Entitlements dan muat ulang halaman.

   ✓ Start scanning muncul saat PMS melaporkan dukungan pembacaan kartu fisik. ✓ Pencarian kamar dan konfirmasi secara manual tetap tersedia saat pemindaian tidak tersedia.

Pemetaan kiosk PMS

Untuk PMS Integration, AVA terlebih dahulu menyelesaikan pemetaan Device Model kiosk terhadap perangkat encoder PMS yang aktif. Jika pemetaan tersebut tidak tersedia atau tidak cocok, AVA menggunakan pemetaan kiosk lama. Pertahankan encoder target dalam keadaan Active dan gunakan nama encoder PMS saat ini di Device Routing.

Pencocokan rute Opera harus tepat

Pembacaan kartu Opera memerlukan satu workstation, ID encoder, interface, dan kode outbound Door Lock yang cocok. Jika Opera mengembalikan rute yang duplikat atau tidak lengkap, AVA menonaktifkan pembacaan dan tidak menebak. Minta administrator Opera Anda memperbaiki katalog encoder, lalu klik Load Encoders lagi.

Nilai interface Saflok

Opera mungkin menampilkan nilai interface encoder seperti SL01. AVA menggunakan nilai tersebut untuk memilih rute Door Lock yang cocok. Permintaan pembacaan menggunakan kode outbound numerik yang ditemukan. Anda tidak perlu mengubah nilainya secara manual.

Routing dipindahkan

AVA kini mengelola routing kiosk di Settings → Kiosk → Device Routing. Halaman Room Access tetap menyimpan pengaturan encoder dan mengarahkan Anda ke sana untuk routing.

Langkah 5: Atur routing kiosk (opsional)

Gunakan bagian ini hanya untuk perilaku routing khusus kiosk:

1. Buka Settings → Kiosk.

2. Buka Device Routing.

3. Aktifkan Enable guest selection agar tamu dapat memilih encoder di kiosk.

4. Biarkan nonaktif untuk menambahkan aturan routing bagi setiap kiosk.

5. AVA menyimpan aturan kiosk tersebut berdasarkan Mini MDM Device ID.

6. Pemetaan ID perangkat lama diperbarui secara otomatis saat Anda menyimpan.

   ✓ Saat pemilihan tamu aktif, AVA menyembunyikan aturan routing manual. ⚠️ Anda tetap perlu menambahkan setidaknya satu perangkat encoder di Physical Encoder Devices. ✓ AVA dapat mengirim permintaan encode menggunakan encoderId tanpa pemetaan kiosk.

Perilaku pemilihan encoder dalam operasional

• Jika tepat satu encoder online, AVA memilihnya secara otomatis.
• Jika beberapa encoder online, staf harus memilih satu secara eksplisit.
• Untuk GreatLocks, gunakan baris yang sesuai untuk tindakan status dinamis atau konfigurasi.
• AVA tidak dapat menentukan target ketika beberapa server atau agent GreatLocks tersedia.

Status online langsung

Online berarti AVA telah memverifikasi encoder dan tunnel agent-nya. Unknown berarti AVA tidak dapat memverifikasi status encoder. Unknown tidak mengonfirmasi bahwa encoder sedang offline. Baris Status: menampilkan online hanya setelah koneksi tersebut aktif. Jika encoder terputus, perbaiki agent atau tunnel terlebih dahulu.

Langkah 6: Siapkan Windows Agent (hanya Windows Agent)

Jika Anda tidak mengaktifkan Direct communication, instal Windows Agent:

1. Buka Windows Agent.

2. Klik Download Windows Agent pada kartu baru, atau Reinstall pada kartu yang sudah ada.

3. Instal agent di PC Windows yang terhubung ke encoder.

4. Jika kartu menampilkan Not connected atau Never online, ekstrak zip yang diunduh, lalu jalankan download-installer.bat.

5. Setelah unduhan selesai, jalankan installer .exe yang disimpannya.

   ✓ Agent muncul di Registered Agents dengan detail status. ✓ AVA menggunakan status live ini saat menentukan apakah encoder tersedia. ✓ Setiap kartu menampilkan Installed version dan, jika tersedia, Latest version. ✓ Jika agent sudah terbaru, Anda akan melihat Latest version installed. ✓ Jika agent sudah usang, klik Update sebelum Reinstall.

Be-Tech, Saflok, GreatLocks, dan LockSDK semuanya dapat menggunakan Windows Agent. Untuk GreatLocks, ulangi penyiapan agent untuk setiap encoder yang dikonfigurasi dan PC yang terhubung. Pastikan setiap agent menggunakan Encoder ID yang sesuai. Saat agent sudah usang, Update muncul sebelum Reinstall pada kartu utama. Buka Advanced options untuk View Logs, Rotate Secret, atau Delete. Rotate Secret kini membuka dialog konfirmasi sebelum AVA memutuskan agent saat ini.

Kontrol service

Pemulihan Be-Tech biasanya memulai client atau service yang berhenti secara otomatis. Gunakan Start, Stop, atau Restart di tray Windows Agent saat Anda perlu mengontrol service secara manual. Jika Windows meminta izin, setujui prompt UAC untuk melanjutkan. Jika Anda membatalkan prompt, ulangi tindakan tersebut dan setujui.

Yang terlihat saat versi sudah usang

Yang Anda lihat: Kartu menampilkan Outdated, atau menyatakan bahwa versi yang terpasang tidak dilaporkan oleh heartbeat.

Perbaikan:

1. Klik Update.
2. Baca modal pembaruan.
3. Buka aplikasi Windows Agent.
4. Klik Check for Update.
5. Instal pembaruan yang ditawarkan.
6. Segarkan Settings → Room Access dan pastikan status versi sudah terbaru.

Status versi yang sama juga muncul pada kartu agent LockSDK.

Langkah 7: Atur default encoding

1. Atur Number of Cards to Encode (biasanya 1–2).
2. Atur Keycard Expiration Time (default: 11:00 AM). Waktu ini akan otomatis terisi ke Valid Until saat encoding keycard manual.

Reservasi day-use

Jika reservasi secara eksplisit merupakan day use dan day use diaktifkan, AVA menggunakan waktu checkout yang telah ditetapkan. Reservasi menginap tetap menggunakan Keycard Expiration Time.

Opsional: perluas Advanced options untuk mengaktifkan Heartbeat Monitor.

Opsional: Petakan kamar PMS ke nama encoder

Jika encoder Anda menggunakan nama kamar yang berbeda dari PMS:

• Gunakan Pemetaan Kamar Keycard.

Pemecahan masalah

Jika encoder tidak merespons atau kartu gagal di-encode, gunakan daftar pemeriksaan lengkap:

• Pemecahan Masalah Encoder Keycard

Masih terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Pengaturan encoder tersimpan tetapi perangkat tetap offline
• ❌ Kartu tidak dapat di-encode untuk kamar mana pun
• ❌ Agent tidak pernah tampil online di Registered Agents

Sebaiknya sertakan:

• Jenis dan model encoder
• Screenshot Keycard Encoder Settings
• Waktu masalah dimulai

Panduan terkait

• Ikhtisar Encoder Keycard
• Pemetaan Kamar Keycard
• Petunjuk Keycard untuk Tamu
• Pemecahan Masalah Encoder Keycard