Kelola Kode Akses

Pencarian Cepat

Sebagian besar tim menemukan kode dalam waktu kurang dari satu menit menggunakan Reservation ID, Guest Name, atau Room.

Panduan ini membantu Anda meninjau PIN, QR key, keycard, dan akses locker. Panduan ini juga membantu Anda membaca riwayat event keycard dan riwayat QR key.

Buka: Access Codes

---

Referensi Cepat

Tugas	Tempat mengeklik	Hasil
Menemukan kode	Reservation ID, Guest Name, atau Room	Kode yang cocok muncul
Memfilter berdasarkan status atau metode	More Filters	Daftar diperbarui dengan filter Anda
Menampilkan PIN	Eye icon	PIN ditampilkan
Melihat lock ID	Key icon	Lock ID muncul di tooltip
Menyalin kode	Copy icon	Kode disalin dan menampilkan Copied
Berpindah antarhalaman	Previous atau Next	Halaman lain dimuat
Mengubah ukuran halaman	10 per page	Daftar diperbarui dengan ukuran baru
Memeriksa tanggal validitas	Kolom Valid Period	Waktu mulai dan akhir muncul
Memeriksa sisa waktu	Badge Status	Sisa waktu muncul untuk kode aktif
Memeriksa progres job	Badge Operation Status	Menunjukkan apakah setiap PIN smart-lock berstatus pending, partial, successful, failed, atau timed out
Meninjau detail kegagalan	Access Details	Error keycard dalam bahasa sederhana muncul di sini, dengan userMessage, errorCode, retriable, vendor, dan detail upstream yang aman jika tersedia
Meninjau riwayat keycard	Tampilan Events	Satu baris muncul untuk setiap percobaan encode keycard
Menghapus filter	Clear All atau Reset All	Tampilan default kembali

Menemukan Kode Akses

1. Buka Access Codes.

2. Masukkan Reservation ID, Guest Name, atau Room.

3. Tunggu sebentar hingga daftar diperbarui.

   ✓ Kode yang cocok muncul di daftar.

Memfilter Daftar

1. Klik More Filters.

2. Pilih satu atau beberapa filter:

   • Status: Active, Expired, Generation Pending, Partial Success, Generation Failed, Revoked, Superseded
   • Access Method: Smart Lock, Digital Key, Keycard, Locker, ACI
   • Date Range: Tanggal mulai dan akhir

3. Klik Reset All untuk menghapus semua pilihan di panel ini.

   ✓ Daftar diperbarui sesuai pilihan Anda.

Berpindah Antarhalaman

1. Gulir ke bagian bawah daftar.

2. Klik Previous atau Next.

3. Buka 10 per page lalu pilih 10, 25, 50, atau 100.

   ✓ Daftar diperbarui dengan ukuran halaman baru.

Mengelola QR digital key

1. Temukan baris QRLOCK.

2. Buka Manage digital key.

3. Pilih Issue, Copy guest link, Send, atau Withdraw.

4. Gunakan Retry cancellation saat penarikan masih diproses.

5. Pilih Reissue hanya setelah pembatalan dikonfirmasi.

   ✓ Modal menampilkan status key saat ini dan riwayat yang difilter berdasarkan reservasi.

Untuk reservasi dengan beberapa kamar, AVA memeriksa kamar yang dipilih. Penerbitan, penerbitan ulang, dan pengiriman tetap tidak tersedia untuk kamar yang dipilih dan bersifat terminal. Riwayat kamar dan kontrol penarikan tetap tersedia.

Jika nomor telepon tamu hilang atau sudah tidak sesuai, AVA dapat mencocokkan QR key yang sudah ada menggunakan pemegang yang tersimpan. AVA memeriksa kamar yang dipilih, masa inap, pemetaan, kedaluwarsa, dan status penarikan sebelum mengembalikan key tersebut.

Pemulihan ini menggunakan kembali key yang sudah ada. Pemulihan ini tidak membuat kartu QRLOCK lain atau memperbarui nomor telepon tamu di PMS.

Menampilkan dan Menyalin PIN

1. Temukan baris yang Anda perlukan.

2. Klik eye icon untuk menampilkan PIN.

3. Klik copy icon.

   ✓ Ikon berubah menjadi Copied selama beberapa saat.

Melihat Lock ID

1. Temukan baris smart lock yang Anda perlukan.

2. Pilih key icon.

   ✓ Lock ID muncul di tooltip.

Memahami Label Status

Status	Artinya	Yang harus dilakukan
Active	Kode saat ini valid	Bagikan kepada tamu
Expired	Masa berlaku telah berakhir	Terbitkan kode baru jika diperlukan
pending	Job smart-lock masih diproses	Tunggu dan refresh sebelum membagikannya
partial	Beberapa langkah smart-lock telah selesai, tetapi job belum selesai	Tunggu dan refresh sebelum membagikannya
Failed	Provider gagal membuat kode	Periksa kembali penyiapan lock dan coba lagi
Revoked	Kode dinonaktifkan lebih awal	Konfirmasikan kepada manajer sebelum menerbitkannya kembali
Superseded	Kode yang lebih baru menggantikan kode ini	Gunakan kode terbaru

Gunakan More Filters → Status untuk menemukan baris ini sebagai Generation Pending dan Partial Success.

PIN baru diperiksa lebih dahulu

AVA memeriksa job smart-lock yang lebih baru sebelum entri backlog yang lebih lama. PIN tamu yang baru seharusnya selesai lebih cepat daripada baris pending lama. AVA melewati baris Active historis yang sudah kedaluwarsa, meskipun field bridge lama masih ada. Baris Active saat ini tetap memenuhi syarat selama jendela aksesnya masih terbuka. Selama refresh check-in dan lookup, AVA memeriksa kembali job smart-lock pending sebelum mengembalikan hasil. AVA juga menunggu setidaknya 2 detik di antara pemeriksaan provider, jadi satu refresh lagi mungkin masih diperlukan.

Kredensial diterbitkan sebelum check-in final

AVA dapat menerbitkan PIN, QR key, atau kredensial locker selama penetapan kamar. Setelah check-in final, kredensial yang berhasil tetap terpasang pada tamu yang telah dikonfirmasi tiba. Refresh reservasi sebelum menerbitkan kredensial lain.

Memahami Status Operasi Smart Lock

Setiap baris PIN smart-lock menampilkan chip operasinya sendiri di tabel dan kartu mobile. Gunakan status ini saat kode smart-lock masih diproses melalui bridge vendor.

Tunggu Status Ready

Jangan bagikan PIN smart-lock hingga Operation Status menampilkan Successful. pending dan partial masih berarti akses belum sepenuhnya siap.

Status	Artinya	Yang harus dilakukan
Pending	AVA masih menunggu job vendor selesai	Tunggu sebentar, lalu refresh halaman
Successful	AVA mengonfirmasi bahwa job lock telah selesai	Bagikan PIN kepada tamu
Failed	Job vendor gagal	Periksa koneksi lock dan coba lagi
Timed out	AVA terus memeriksa, tetapi job tidak selesai tepat waktu	Coba buat PIN lagi dan verifikasi bridge

Meninjau Detail Waktu

Gunakan tabel untuk memastikan kapan kode dimulai, berakhir, dan dibuat.

Item	Tempat melihatnya	Artinya
Time remaining	Di bawah badge status Active	Sisa waktu sebelum kode kedaluwarsa
Valid Period	Kolom Valid Period	Tanggal/waktu mulai dan akhir
Created	Kolom Created	Waktu kode dibuat

Kolom Valid Period

Jika daftar hanya menampilkan kode locker, kolom Valid Period disembunyikan.

Tanggal kalender properti

Untuk reservasi PMS, AVA mempertahankan tanggal kedatangan dan keberangkatan sebagai tanggal kalender properti. AVA menerapkan zona waktu hotel saat membuat setiap jendela validitas. Dengan demikian, Valid Period tetap selaras dengan tanggal lokal reservasi.

Meninjau Riwayat Event Keycard

Gunakan tampilan Events saat Anda memerlukan jejak audit percobaan encoding keycard.

Status tampilan	Yang Anda lihat	Artinya
Encoded	Baris kartu yang berhasil	AVA menulis kartu untuk percobaan tersebut
Failed	Detail error di baris	Kartu gagal di-encode
Expired	Kartu yang melewati masa berlakunya	Kartu tidak lagi valid
Revoked	Baris kartu yang dicabut	Kartu dinonaktifkan lebih awal
Superseded	Baris pengganti	Kartu yang lebih baru menggantikan kartu ini
Created	Waktu encode di kolom Created	Waktu AVA mencatat percobaan

Hanya untuk baris keycard

Daftar default tetap mengelompokkan kode akses berdasarkan reservasi. Dalam tampilan Events, baris keycard diratakan menjadi satu baris per percobaan. Baris smart lock dan locker tetap menampilkan satu record per kode akses.

Timestamp keycard Opera

Untuk keycard Opera, waktu Created menggunakan keyCreationTime PMS yang telah dikonfirmasi. Timestamp tersebut cocok dengan konfirmasi fisik kunci yang berhasil. Jika Opera mengembalikan timestamp validitas dalam waktu lokal hotel, AVA mempertahankannya untuk diagnostik konfirmasi.

Detail kegagalan yang dinormalisasi

Baris keycard yang gagal kini menyimpan pesan terstruktur terlebih dahulu. Jika encoder mengembalikan false, AVA mencatat KEYCARD_ENCODE_FAILED sebagai kegagalan bertipe. Anda juga dapat melihat userMessage, errorCode, retriable, vendor, dan detail upstream yang aman untuk dukungan. Gunakan retriable untuk menentukan apakah percobaan ulang kemungkinan akan membantu. Timeout room-access HTTP 504 tetap berada di jalur ini dengan KEYCARD_VENDOR_TIMEOUT. Saat membandingkan timeout, periksa kamar, jumlah kunci, dan jendela validitas terlebih dahulu. Hal itu membantu membedakan ketidakcocokan yang sebenarnya dari masalah konfirmasi yang hanya terkait zona waktu.

Kode fault tetap terlihat

AVA mempertahankan nilai room-access faultcode:<value> di pesan event. Redaksi PII tetap berlaku untuk nomor telepon, email, kartu, dan token. Gunakan faultcode saat membandingkan insiden vendor.

Digital key menggunakan kontrol terpisah

Gunakan Manage digital key untuk baris QRLOCK. Gunakan Manage PIN untuk smart lock atau Manage Locker Code untuk locker.

Access Codes hanya dapat dilihat untuk baris PIN, keycard, dan locker. Baris QRLOCK membuka modal pengelolaan khususnya.

Tips

• Entri locker menampilkan Locker # dan Code, bukan PIN.
• ACI memfilter record kode akses assisted check-in.
• Semua waktu menggunakan zona waktu yang ditampilkan di bagian bawah halaman.
• Baris keycard menggunakan kolom Created untuk waktu encode.
• Untuk keycard Opera, kolom Created menggunakan timestamp PMS yang telah dikonfirmasi.
• Jika nama kamar terlihat salah, konfirmasikan pemetaan kamar di Rooms.
• Baca Access Details langsung di tabel saat Anda memerlukan pesan dalam bahasa sederhana.

Pemecahan Masalah

Beberapa baris keycard

Yang Anda lihat: Reservasi yang sama muncul beberapa kali di Events.

Perbaikan:

1. Periksa kolom Display status.
2. Gunakan waktu Created terbaru.
3. Simpan baris lama hanya jika Anda memerlukan jejak audit.

Tidak ada kode akses yang ditemukan

Yang Anda lihat: "No access codes found" atau daftar kosong.

Perbaikan:

1. Hapus semua filter.
2. Cari berdasarkan Reservation ID atau Room.
3. Refresh halaman.

Ikon salin tidak berfungsi

Yang Anda lihat: Ikon salin tidak berubah menjadi Copied.

Perbaikan:

1. Tampilkan PIN terlebih dahulu.
2. Coba lagi setelah memberikan akses clipboard browser.

Status menunjukkan Failed

Yang Anda lihat: Status Failed disertai pesan error.

Perbaikan:

1. Pastikan integrasi smart lock terhubung.
2. Coba buat PIN lagi dari reservasi.

Status operasi tetap pending atau partial

Yang Anda lihat: Kode smart-lock menampilkan pending atau partial setelah dibuat.

Perbaikan:

1. Tunggu hingga 1 menit, lalu refresh reservasi atau halaman Access Codes.
2. PIN baru diperiksa sebelum baris backlog lama, jadi kode tamu baru seharusnya selesai lebih dahulu.
3. Jika Anda berada di lookup check-in, AVA memeriksa kembali job pending sebelum menampilkan hasil.
4. Jika baris tersebut sudah kedaluwarsa, AVA memang sengaja melewatinya.
5. Jika status berubah menjadi Successful, bagikan PIN.
6. Jika tetap pending atau partial selama lebih dari 1 menit pada masa inap yang sedang berlangsung, coba buat PIN lagi dari reservasi.
7. Jika berubah menjadi Timed out atau Failed, periksa koneksi vendor dan status bridge sebelum mencoba lagi.

Pesan kegagalan keycard menggunakan bahasa sederhana

Yang Anda lihat: Baris keycard menampilkan pesan singkat, bukan string vendor mentah. Anda juga dapat melihat detail userMessage, errorCode, retriable, vendor, atau upstream yang aman.

Perbaikan:

1. Baca pesan singkat terlebih dahulu.
2. Gunakan kode error, flag retriable, dan detail vendor saat menghubungi dukungan.
3. Pastikan ID reservasi, kamar, dan tanggal menginap sudah benar.
4. Jika pemetaan kamar atau sesi encoder salah, perbaiki terlebih dahulu.
5. Coba lagi tindakan keycard setelah menyimpan perubahan.

Kolom Valid Period tidak ada

Yang Anda lihat: Kolom Valid Period tidak ditampilkan.

Perbaikan:

1. Hapus semua filter.
2. Pastikan Anda tidak sedang melihat kode khusus locker.

Tindakan QR key tidak tersedia

Yang Anda lihat: Issue, Reissue, atau Send tidak tersedia.

Perbaikan:

1. Buka riwayat QR key yang difilter berdasarkan reservasi.
2. Pastikan kamar yang dipilih bukan kamar terminal di PMS.
3. Periksa bahwa kamar PMS memiliki pemetaan QRLOCK yang tersimpan.
4. Gunakan Retry cancellation jika penarikan sebelumnya masih diproses.

QR key tersimpan hilang setelah nomor telepon tamu berubah

Yang Anda lihat: Nomor telepon tamu kosong atau berubah, tetapi QR key telah diterbitkan sebelumnya.

Perbaikan:

1. Refresh reservasi setelah data PMS terbaru masuk.

2. Pastikan kamar yang dipilih dan tanggal menginap sesuai dengan riwayat QR key.

3. Buka kembali Manage digital key.

4. Gunakan Copy guest link atau Send jika key yang sudah ada muncul.

5. Jangan menerbitkan berulang kali saat status masih dimuat.

   ✓ AVA dapat menggunakan kembali key yang tersimpan jika masa inap dan pemetaan kamarnya masih sesuai.

Hubungi dukungan sebelum menerbitkan ulang jika key tetap tidak tersedia. Perubahan kamar, masa inap, pemetaan, kedaluwarsa, atau status penarikan mungkin memerlukan pemulihan oleh staf.

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Kode tidak muncul setelah check-in
• ❌ Status tetap Failed setelah dicoba ulang
• ❌ Anda tidak dapat membuka halaman Access Codes

Sertakan jika memungkinkan:

• Reservation ID
• Nomor kamar
• Screenshot baris status

Panduan Terkait

• Pengelolaan Metadata Kamar
• Menyiapkan Digital Key QRLOCK
• Masalah Smart Lock
• Command Center