Encode Keycard Secara Manual

Encode Cepat

Sebagian besar keycard manual memerlukan waktu sekitar 2 menit setelah encoder Anda online.

Panduan ini membantu Anda melakukan encoding keycard secara manual dan memilih pengaruh kartu baru terhadap kartu yang aktif.

Buka: Operations View → Encode Keycard

Ketersediaan

Anda hanya melihat Encode Keycard jika Settings → Room Access diatur ke Keycard Encoding.

Izin encoding

Staf yang dapat melakukan encoding keycard dapat menggunakan pemeriksaan kartu aktif. Mereka tidak memerlukan izin untuk melihat Access Codes.

Konfirmasi Opera

Jika Anda menggunakan Opera melalui encoder yang terintegrasi dengan PMS, AVA menganggap 201 tanpa keterangan sebagai penerimaan. AVA kemudian menunggu lima detik agar encoder menyelesaikan proses sebelum mengembalikan kontrol. AVA tidak menggunakan metadata roomKeys reservasi untuk membuktikan bahwa satu proses encoding fisik telah selesai. Status keberhasilan atau kegagalan terminal yang eksplisit tetap diteruskan tanpa perubahan. Jika Opera tidak mengirimkan hasil terminal, coba lagi permintaan yang sama satu kali. AVA memformat Valid From dan Valid Until sebagai nilai waktu lokal hotel sebelum mengirimkannya ke Opera. Hal ini bergantung pada zona waktu hotel yang valid. Jika zona waktu hotel tidak valid atau data zona waktu permintaan bertentangan, AVA berhenti sebelum melakukan encoding.

Diagnostik konfirmasi

Jika konfirmasi gagal, tim support dapat meninjau snapshot kamar yang telah disanitasi, nilai yang diharapkan, jeda settle, jumlah polling, dan hasil pencocokan. AVA tidak mencatat data tamu atau nilai PIN keycard dalam alur ini.

Encoding pada Header vs Level Reservasi

AVA menyediakan dua cara untuk melakukan encoding keycard. Memahami perbedaannya membantu Anda menerbitkan keycard duplikat atau tambahan tanpa mengubah pengaturan.

Metode	Lokasi	Jumlah Keycard
Header-level (tombol hijau)	Bagian atas Operations View, di samping Help	Selalu 1-10, terlepas dari pengaturan
Reservation-level	Tombol ikon kartu pada kartu atau baris reservasi	Dikendalikan oleh pengaturan Room Access Anda

• Tombol header-level memulai alur manual tanpa membuka reservasi.
• Tombol reservation-level memulai encoding untuk reservasi atau kamar yang dipilih.
• Kedua alur dapat menemukan kumpulan keycard manual yang aktif sebelum encoding dimulai.

Kartu tambahan tidak memerlukan encoding ulang

Pilih Encode DUPLICATE keycards saat Anda memerlukan kartu tambahan. Kartu yang sudah ada tetap aktif.

Check-in tamu tambahan

Jika sebuah kamar sudah di-check-in, tamu tambahan dapat membuka kembali alur keycard duplikat nanti. Gunakan Encode DUPLICATE keycards untuk melakukan encoding kartu tamu tambahan tanpa mengganti kumpulan kartu yang aktif.

Tentukan kamar reservasi sebelum encoding

Setelah Anda memilih encoder, AVA mengonfirmasi kamar yang ditetapkan melalui pencarian PMS yang diautentikasi. Jika kartu reservasi tidak memiliki nilai kamar yang dapat digunakan, AVA menggunakan pencarian tersebut secara otomatis. AVA menerima identitas kamar PMS yang tidak kosong, termasuk pengenal AVA PMS yang panjang. Kemudian AVA menggunakan identitas kamar dan nomor kamar yang telah ditemukan untuk pencarian dan encoding keycard.

Hal ini berlaku untuk akses kamar melalui reservasi, check-in, dan manajemen kunci. Pilihan NEW atau DUPLICATE Anda tetap tidak berubah.

Tidak perlu mengubah pemetaan kamar

Anda tidak perlu memendekkan atau mengedit identitas kamar PMS yang valid. Pemetaan kamar hanya diperlukan jika nama kamar encoder berbeda dari nomor kamar PMS.

Pilih Kartu Baru atau Duplikat

Saat AVA menemukan kumpulan keycard manual yang aktif, AVA menampilkan dua pilihan bertumpuk.

Pilihan	Gunakan saat	Hasil
Encode DUPLICATE keycards	Anda memerlukan kartu tambahan	Kartu saat ini tetap berfungsi.
Encode NEW keycards	Anda harus mengganti kumpulan kartu yang aktif	Kartu sebelumnya berhenti berfungsi.

Mengganti kartu menonaktifkan kartu sebelumnya

Gunakan Encode NEW keycards hanya jika penggantian memang diinginkan. Segera berikan kartu baru kepada tamu.

AVA memeriksa kamar, tamu, dan tanggal menginap sebelum menampilkan pilihan ini. AVA mempertahankan keterkaitan permintaan baru dengan kumpulan kartu yang aktif.

Mulai Kumpulan Keycard Manual Baru

Untuk kamar yang tidak memiliki kumpulan manual aktif, pilih Encode NEW keycards untuk kartu pertama. AVA membuat kumpulan baru tersebut saat encoding pertama berhasil. Selanjutnya, AVA menggunakan kembali kumpulan tersebut untuk setiap permintaan Encode DUPLICATE keycards.

Kumpulan baru tidak memerlukan nomor reservasi

Anda tidak perlu memasukkan atau membuat nomor reservasi untuk kumpulan manual baru. AVA menetapkan kumpulan tersebut secara otomatis setelah kartu pertama berhasil dibuat.

Gunakan kembali Encode NEW keycards hanya jika Anda ingin kartu sebelumnya berhenti berfungsi.

Referensi Cepat

Kolom	Wajib	Nilai default atau catatan
Select Keycard Encoder	Ya	Satu encoder online dipilih secara otomatis. Pilih encoder online tertentu jika tersedia beberapa encoder.
Room Number	Ya	Pilih nomor kamar PMS. Nama kamar encoder muncul sebagai teks bantuan. AVA mengirimkan nomor kamar ini ke alur external-room-key Opera.
Guest Name	Tidak	Opsional.
Valid From	Ya	Default ke waktu saat ini.
Valid Until	Ya	Default ke besok pada waktu kedaluwarsa keycard yang dikonfigurasi di zona waktu hotel Anda. Kembali ke 11:00 AM jika pengaturan tidak ada atau tidak valid.
Number of Keycards	Tidak	Default ke 2. Pilih 1-10 kartu utuh.

AVA menolak jumlah kartu yang bukan bilangan bulat.

Tampilan Room Number

Daftar kamar menampilkan nomor kamar yang digunakan PMS terlebih dahulu. Jika berbeda, AVA menampilkan nama kamar encoder dalam tanda kurung.

Ketersediaan encoder

Daftar encoder dinamis menggunakan koneksi agen live sebagai sumber kebenaran. Jika agen encoder tersambung dan tunnel dapat dijangkau, AVA menampilkannya sebagai Online. Daftar encoder statis atau langsung mempertahankan perilakunya yang sudah ada.

Pemilihan encoder GreatLocks

Setiap baris GreatLocks mewakili satu encoder fisik dan PC Windows yang terhubung dengannya. Jika beberapa encoder online, pilih encoder untuk PC yang Anda perlukan. Encoder yang dipilih akan menangani permintaan keycard ini.

Default Valid Until

AVA menggunakan Settings → Room Access → Keycard Expiration Time untuk waktu default Valid Until. Jika pengaturan ini tidak ada atau tidak valid, AVA menggunakan 11:00 AM. Jika reservasi tidak memiliki tanggal checkout, AVA tetap menggunakan besok pada waktu yang dikonfigurasi tersebut.

Mulai Alur Encoding

1. Buka Operations View.

2. Pilih Encode Keycard.

   ✓ Modal Manual Keycard Encoding terbuka.

3. Jika satu encoder online, AVA memilihnya secara otomatis.

4. Jika beberapa encoder online, pilih encoder target dengan status Online. Status tersebut mengikuti koneksi agen live. Untuk GreatLocks, pilih encoder yang terhubung ke PC Windows yang Anda perlukan.

5. Pilih Room Number dari daftar dropdown.

   ✓ Anda melihat nomor kamar PMS sebagai label utama. Jika dipetakan, Anda juga melihat (Encoder: ...) sebagai teks bantuan.

6. Opsional: masukkan Guest Name.

7. Atur Valid From dan Valid Until.

8. Pilih Number of Keycards.

9. Klik Encode Keycard.

   ✓ AVA memeriksa apakah kamar tersebut sudah memiliki keycard manual yang aktif.

10. Jika AVA menemukan kumpulan kartu yang aktif, pilih Encode DUPLICATE keycards atau Encode NEW keycards.

✓ Alur encoding keycard terbuka dengan operasi yang Anda pilih. 11. Letakkan setiap kartu kosong pada encoder dan ikuti petunjuk di layar.

✓ AVA menampilkan hasil encoding untuk setiap kartu.

Encode dari Reservasi

1. Buka Operations View → Check-ins atau Operations View → Stay-overs.

2. Pilih Manage Pin / Encode Keycard untuk reservasi tersebut.

3. Jika ada kartu aktif, pilih Encode DUPLICATE keycards atau Encode NEW keycards.

4. Pilih encoder online saat AVA memintanya.

   ✓ AVA mengonfirmasi kamar PMS yang ditetapkan sebelum membuka modal encoding. Pengenal kamar PMS yang panjang atau tampak internal tetap valid.

5. Letakkan setiap kartu kosong pada encoder dan selesaikan petunjuknya.

   ✓ Kartu duplikat berfungsi bersama kumpulan kartu yang sudah ada. ✓ Kartu baru menggantikan kumpulan kartu yang sudah ada.

Pemecahan Masalah

Opsi duplikat tidak ditampilkan

Yang Anda lihat: Anda membuka reservasi, tetapi AVA tidak menampilkan pilihan duplikat dan baru.

Mengapa ini terjadi: AVA menampilkan pilihan ini saat menemukan kumpulan keycard manual yang aktif. Kamar baru dapat langsung membuka alur encoding.

Perbaikan:

1. Pastikan reservasi memiliki kamar dan tamu yang benar.
2. Klik Refresh di Operations View.
3. Coba Manage Pin / Encode Keycard lagi.
4. Gunakan alur manual jika Anda perlu menambahkan nama tamu untuk pencocokan.

Kamar reservasi tidak dapat ditentukan

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

Perbaikan:

1. Segarkan reservasi atau Operations View.
2. Pastikan reservasi memiliki kamar yang ditetapkan di PMS Anda.
3. Mulai kembali alur encoding level reservasi.
4. Pilih encoder online saat AVA memintanya.
5. Hubungi support jika pesan tersebut muncul lagi setelah kamar PMS ditetapkan.

AVA menerima identitas kamar PMS yang valid, bahkan jika identitas tersebut panjang atau tampak internal. Jangan mengubah identitas kamar secara manual.

Kartu yang ada tidak dapat diperiksa

Yang Anda lihat: AVA mengatakan bahwa AVA tidak dapat memeriksa apakah kamar sudah memiliki kartu aktif.

Perbaikan:

1. Klik Try again.
2. Jika pencarian masih gagal, pilih Start a new set hanya jika penggantian memang diinginkan.
3. Beri tahu tamu bahwa kartu sebelumnya mungkin berhenti berfungsi.

Lebih dari satu kumpulan aktif cocok

Yang Anda lihat: AVA mengatakan bahwa lebih dari satu kumpulan keycard manual yang aktif cocok dengan kamar tersebut.

Perbaikan:

1. Tutup modal.
2. Buka kembali alur manual dan masukkan nama tamu.
3. Jika pencocokan masih tidak jelas, gunakan Access Codes untuk memilih kumpulan yang benar.

Tanggal menginap tidak ada

Yang Anda lihat: AVA mengatakan bahwa tanggal menginap tidak ada, sehingga kumpulan aktif tidak dapat digunakan kembali.

Perbaikan:

1. Segarkan reservasi atau tunggu sinkronisasi PMS.
2. Coba alur encoding lagi.
3. Pilih Start a new set hanya jika kartu sebelumnya harus berhenti berfungsi.

Tombol Encode Keycard hilang

Yang Anda lihat: Tidak ada tombol Encode Keycard di Operations View.

Perbaikan:

1. Buka Settings → Room Access.
2. Atur Room Access Method ke Keycard Encoding.
3. Kembali ke Operations View.

Tombol Encode Keycard dinonaktifkan

Yang Anda lihat: Tombol berwarna abu-abu atau menampilkan "Missing merchant ID. Configure your account in Settings."

Perbaikan:

1. Selesaikan penyiapan akun di Settings.
2. Segarkan halaman.

"No encoders found"

Yang Anda lihat: Daftar encoder menampilkan "No encoders found."

Mengapa ini terjadi: AVA hanya menampilkan encoder dinamis dengan status online live. Status tersebut berasal dari agen yang tersambung dan tunnel yang dapat dijangkau.

Perbaikan:

1. Buka Settings → Room Access.
2. Tambahkan atau aktifkan encoder.
3. Kembali ke Encode Keycard.

Pemilih encoder dilewati

Yang Anda lihat: AVA membuka layar encoding tanpa menampilkan pilihan encoder.

Perbaikan:

1. Pastikan hanya satu encoder yang online.
2. Lanjutkan encoding. Perilaku ini memang diharapkan.
3. Bawa encoder lain online jika Anda perlu memilih secara manual.

GreatLocks memerlukan pemilihan encoder

Yang Anda lihat: AVA tidak dapat melanjutkan permintaan keycard GreatLocks karena tersedia beberapa encoder.

Mengapa ini terjadi: Setiap agen GreatLocks melayani satu encoder. AVA memerlukan pilihan Anda jika lebih dari satu encoder yang dikonfigurasi dapat menangani permintaan tersebut.

Perbaikan:

1. Buka daftar encoder.
2. Pilih encoder GreatLocks yang terhubung ke PC Windows yang dituju.
3. Pastikan statusnya menunjukkan Online.
4. Lanjutkan permintaan keycard.

Jika encoder yang benar tidak tersedia, periksa Encoder ID dan status agen di Settings → Room Access. Jika dua baris GreatLocks menggunakan ID yang sama, edit baris tersebut dan simpan ID yang unik.

Encoder terlihat offline di modal

Yang Anda lihat: Modal keycard reservasi menampilkan encoder sebagai offline, meskipun Settings → Room Access menunjukkan encoder tersebut tersambung.

Mengapa ini terjadi: Modal kini menggunakan status koneksi agen yang sama seperti halaman settings. Jika agen tersambung dan tunnel dapat dijangkau, kedua tampilan seharusnya sama.

Perbaikan:

1. Segarkan Settings → Room Access dan modal reservasi.
2. Periksa Registered Agents untuk kartu encoder.
3. Perbaiki koneksi agen atau tunnel jika salah satu tampilan masih menunjukkan offline.
4. Coba encoding lagi.

Encode Keycard menghasilkan kegagalan

Yang Anda lihat: Modal tertutup dengan permintaan gagal, atau Anda melihat KEYCARD_ENCODE_FAILED.

Mengapa ini terjadi: Encoder mengembalikan false, sehingga AVA menganggap penulisan tersebut benar-benar gagal. Untuk kasus itu, AVA tidak lagi menampilkan respons keberhasilan sementara.

Perbaikan:

1. Periksa daya, sesi, dan status koneksi encoder.
2. Coba lagi permintaan encoding yang sama satu kali.
3. Jika gagal lagi, beralih ke encoder online lainnya.
4. Tinjau log encoder atau hubungi support dengan teks error yang persis.

Ketidakcocokan zona waktu Opera

Yang Anda lihat: Modal gagal sebelum PMS mengembalikan room key. Anda mungkin melihat error ketidakcocokan zona waktu atau zona waktu tidak valid.

Mengapa ini terjadi: AVA menggunakan zona waktu yang dikonfigurasi untuk hotel untuk keycard Opera. AVA menolak pengaturan zona waktu hotel yang tidak valid dan data zona waktu permintaan yang bertentangan sebelum encoding.

Perbaikan:

1. Buka Settings → Essentials → Hotel Basic Details.
2. Pastikan Timezone diatur ke zona waktu hotel yang sebenarnya.
3. Simpan pengaturan jika Anda mengubahnya.
4. Segarkan reservasi atau buka kembali alur manual.
5. Coba Encode Keycard lagi.

Nomor kamar terlihat benar tetapi encoding menggunakan kode kamar lain

Yang Anda lihat: Anda memilih kamar 101, tetapi log encoder menunjukkan nilai kamar lain.

Perbaikan:

1. Buka Settings → Room Access → Keycard Encoder Room Mapping.
2. Temukan kamar PMS yang dipilih.
3. Pastikan Encoder Room Name yang dipetakan sudah benar.
4. Simpan pemetaan, lalu coba encoding lagi.

Permintaan keycard Opera mengalami timeout

Yang Anda lihat: Alur encoding tetap terbuka, lalu menampilkan kegagalan atau timeout.

Mengapa ini terjadi: AVA menganggap 201 Opera tanpa keterangan sebagai penerimaan, lalu menunggu lima detik agar encoder menyelesaikan proses. AVA tidak menganggap metadata roomKeys reservasi sebagai bukti bahwa satu proses encoding fisik telah selesai. Status keberhasilan atau kegagalan terminal yang eksplisit tetap diteruskan tanpa perubahan. Permintaan mengalami timeout hanya jika tidak ada hasil terminal sebelum jendela settle berakhir.

Perbaikan:

1. Pastikan nomor kamar, jumlah kartu, dan jendela validitas masih benar.
2. Pastikan kepada admin PMS Anda bahwa alur external room key diaktifkan.
3. Jika kamar sudah di-encode, jangan membuat duplikat secara tidak sengaja.
4. Coba lagi permintaan yang sama satu kali dari reservasi atau alur manual yang sama.
5. Hubungi support dengan nomor kamar, waktu, dan pesan error jika masih gagal.

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Anda tidak dapat membuka modal encoding manual
• ❌ Encoding gagal pada setiap percobaan
• ❌ Tidak ada encoder yang muncul setelah penyiapan

Sertakan jika memungkinkan:

• Jenis dan lokasi encoder
• Nomor kamar dan tanggal yang digunakan
• Screenshot error

Panduan Terkait

• Atur Keycard Encoder
• Pemecahan Masalah Keycard Encoder
• Manajemen Access Code