Kelola Kode Akses
Sebagian besar tim menemukan kode dalam waktu kurang dari satu menit menggunakan Reservation ID, Guest Name, atau Room.
Panduan ini membantu Anda meninjau dan membagikan kode akses untuk smart lock, keycard, dan locker dengan cepat saat dibutuhkan staf atau tamu. Panduan ini juga membantu Anda membaca riwayat event keycard di tampilan Events dan melacak status job smart-lock.
Buka: Access Codes
Referensi Cepat
| Tugas | Klik di mana | 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 terungkap |
| Melihat lock ID | Key icon | Lock ID muncul di tooltip |
| Menyalin kode | Copy icon | Kode disalin dan menampilkan Copied |
| Pindah halaman | 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 | Waktu tersisa muncul untuk kode aktif |
| Memeriksa progres job | Badge Operation Status | Menampilkan apakah setiap PIN smart-lock 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 aman bila tersedia. Error room-conflict keycard tidak bisa diulang. |
| Meninjau riwayat keycard | Tampilan Events | Satu baris muncul untuk setiap percobaan encode keycard |
| Menghapus filter | Clear All atau Reset All | Tampilan default kembali |
Menemukan Access Code
-
Buka Access Codes.
-
Masukkan Reservation ID, Guest Name, atau Room.
-
Tunggu sebentar agar daftar diperbarui.
✓ Kode yang cocok muncul di daftar.
Memfilter Daftar
-
Klik More Filters.
-
Pilih satu atau lebih filter:
- Status: Active, Expired, Generation Pending, Partial Success, Generation Failed, Revoked, Superseded
- Access Method: Smart Lock, Keycard, Locker, ACI
- Date Range: Tanggal mulai dan akhir
-
Klik Reset All untuk menghapus semuanya di panel ini.
✓ Daftar diperbarui sesuai pilihan Anda.
Pindah Antar Halaman
-
Scroll ke bagian bawah daftar.
-
Klik Previous atau Next.
-
Buka 10 per page dan pilih 10, 25, 50, atau 100.
✓ Daftar diperbarui dengan ukuran halaman baru.
Menampilkan dan Menyalin PIN
-
Temukan baris yang Anda perlukan.
-
Klik eye icon untuk menampilkan PIN.
-
Klik copy icon.
✓ Ikon berubah menjadi Copied sebentar.
Melihat Lock ID
-
Temukan baris smart lock yang Anda perlukan.
-
Pilih key icon.
✓ Lock ID muncul di tooltip.
Memahami Label Status
| Status | Artinya | Yang Harus Dilakukan |
|---|---|---|
| Active | Kode saat ini valid | Bagikan ke tamu |
| Expired | Jendela validitas sudah berakhir | Terbitkan kode baru jika perlu |
| pending | Job smart-lock masih diproses | Tunggu dan refresh sebelum membagikan |
| partial | Sebagian langkah smart-lock selesai, tetapi job belum selesai | Tunggu dan refresh sebelum membagikan |
| Failed | Provider gagal membuat kode | Periksa setup lock dan coba lagi |
| Revoked | Kode dinonaktifkan lebih awal | Konfirmasi dengan manager sebelum menerbitkan ulang |
| Superseded | Kode yang lebih baru menggantikan ini | Gunakan kode terbaru |
Gunakan More Filters → Status untuk menemukan baris ini sebagai Generation Pending dan Partial Success.
AVA memeriksa job smart-lock terbaru sebelum entri backlog yang lebih lama. PIN tamu baru seharusnya selesai lebih cepat daripada baris pending lama. AVA melewati baris Active historis yang sudah kedaluwarsa, bahkan jika 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 ulang job smart-lock pending sebelum mengembalikan hasil. AVA juga menunggu setidaknya 2 detik di antara pengecekan provider, jadi satu refresh lagi mungkin masih diperlukan.
Memahami Status Operasi Smart Lock
Setiap baris PIN smart-lock menampilkan chip operasi sendiri di tabel dan kartu mobile. Gunakan status ini saat kode smart-lock masih berjalan melalui bridge vendor.
Jangan bagikan PIN smart-lock sampai 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 job lock selesai | Bagikan PIN ke 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 | Di Mana 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 | Kapan kode dibuat |
Jika daftar hanya menampilkan kode locker, kolom Valid Period disembunyikan.
Meninjau Riwayat Event Keycard
Gunakan tampilan Events saat Anda membutuhkan audit trail percobaan encoding keycard.
| Status tampilan | Yang Anda lihat | Artinya |
|---|---|---|
| Encoded | Baris kartu sukses | AVA menulis kartu untuk percobaan itu |
| Failed | Detail error di baris | Kartu tidak ter-encode |
| Expired | Kartu melewati jendela validitasnya | Kartu tidak lagi valid |
| Revoked | Baris kartu yang dicabut | Kartu dinonaktifkan lebih awal |
| Superseded | Baris pengganti | Kartu baru menggantikan yang ini |
| Created | Waktu encode di kolom Created | Kapan AVA mencatat percobaan |
Daftar default tetap mengelompokkan access code berdasarkan reservasi. Dalam tampilan Events, baris keycard di-flatten menjadi satu baris per percobaan. Baris smart lock dan locker tetap menampilkan satu record per access code. Booking multi-kamar tetap menyimpan record kamar terpisah di bawah referensi reservasi yang sama.
Baris keycard yang gagal sekarang menyimpan pesan terstruktur terlebih dahulu.
Anda juga mungkin melihat detail userMessage, errorCode, retriable, vendor, dan upstream aman untuk support.
Gunakan retriable untuk menentukan apakah retry kemungkinan membantu.
Timeout room-access HTTP 504 tetap berada di jalur ini dengan KEYCARD_VENDOR_TIMEOUT.
KEYCARD_RESERVATION_ROOM_CONFLICT berarti AVA menemukan kartu aktif pada record kamar lain.
Periksa room assignment sebelum mencoba lagi.
AVA tetap 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.
Gunakan Manage PIN (smart lock) atau Manage Locker Code (locker) di reservasi jika Anda perlu mengatur atau mengubah akses.
Tips
- Entri locker menampilkan Locker # dan Code alih-alih PIN.
- ACI memfilter record access code assisted check-in.
- Semua waktu memakai zona waktu yang ditampilkan di bagian bawah halaman.
- Baris keycard memakai kolom Created untuk waktu encode.
- Jika nama kamar terlihat salah, konfirmasi room mapping di Rooms.
- Baca Access Details langsung di tabel saat Anda membutuhkan pesan dalam bahasa sederhana.
Pemecahan Masalah
Beberapa baris keycard
Yang Anda lihat: Reservasi yang sama muncul beberapa kali di Events.
Perbaikan:
- Periksa kolom Display status.
- Gunakan waktu Created yang paling baru.
- Simpan baris yang lebih lama hanya saat Anda membutuhkan audit trail.
- Jika booking memiliki beberapa kamar, bandingkan juga nomor kamarnya.
Tidak ada access code ditemukan
Yang Anda lihat: "No access codes found" atau daftar kosong.
Perbaikan:
- Hapus semua filter.
- Cari berdasarkan Reservation ID atau Room.
- Refresh halaman.
Ikon copy tidak melakukan apa-apa
Yang Anda lihat: Ikon copy tidak berubah menjadi Copied.
Perbaikan:
- Tampilkan PIN terlebih dahulu.
- Coba lagi setelah memberi izin clipboard browser.
Status menunjukkan Failed
Yang Anda lihat: Status Failed dengan pesan error.
Perbaikan:
- Pastikan integrasi smart lock terhubung.
- 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:
- Tunggu hingga 1 menit, lalu refresh reservasi atau halaman Access Codes.
- PIN baru dicek sebelum baris backlog lama, jadi kode tamu baru seharusnya selesai lebih dulu.
- Jika Anda sedang di lookup check-in, AVA memeriksa ulang job pending sebelum menampilkan hasil.
- Jika barisnya sudah kedaluwarsa, AVA sengaja melewatinya.
- Jika status berubah menjadi Successful, bagikan PIN.
- Jika tetap pending atau partial lebih dari 1 menit pada masa inap yang sedang berlangsung, coba buat PIN lagi dari reservasi.
- Jika berubah menjadi Timed out atau Failed, periksa koneksi vendor dan status bridge sebelum mencoba lagi.
Pesan kegagalan keycard berupa bahasa sederhana
Yang Anda lihat: Baris keycard menampilkan pesan singkat alih-alih string vendor mentah.
Anda juga mungkin melihat detail userMessage, errorCode, retriable, vendor, atau upstream yang aman.
Perbaikan:
- Baca pesan singkat terlebih dahulu.
- Gunakan error code, flag retriable, dan detail vendor saat Anda menghubungi support.
- Konfirmasi reservation ID, kamar, dan tanggal inap sudah benar.
- Jika Anda melihat
KEYCARD_RESERVATION_ROOM_CONFLICT, buka kamar yang sudah memiliki kartu aktif. - Jika room mapping atau sesi encoder salah, perbaiki itu terlebih dahulu.
- Coba lagi aksi keycard setelah Anda menyimpan perubahan.
Kolom Valid Period hilang
Yang Anda lihat: Kolom Valid Period tidak ditampilkan.
Perbaikan:
- Hapus semua filter.
- Pastikan Anda tidak sedang melihat kode locker saja.
Masih Terkendala?
Hubungi success@vouch-technologies.com jika:
- ❌ Kode tidak muncul setelah check-in
- ❌ Status tetap Failed setelah mencoba lagi
- ❌ Anda tidak bisa membuka halaman Access Codes
Hal yang membantu untuk disertakan:
- Reservation ID
- Room number
- Screenshot baris status