Pindai Entitlement Tamu

Cek Cepat

Sebagian besar pemindaian memerlukan waktu kurang dari 1 menit. Refresh pertama setiap hari bisnis membuat daftar reservasi ringan. Detail entitlement dimuat hanya setelah Anda memilih reservasi.

Gunakan panduan ini saat Anda perlu memindai kartu tamu, me-refresh data reservasi, atau menggunakan pencarian manual. Refresh normal menggunakan kembali reservasi yang tidak berubah. Dengan begitu, sebagian besar pembaruan menjadi lebih cepat dan pembacaan PMS berkurang.

Area	Fungsinya	Yang perlu Anda harapkan
Scan	Membaca keycard tamu berdasarkan snapshot hari ini	Reservasi yang cocok terbuka di layar
Refresh	Membuat ulang snapshot reservasi hari ini	Banner menampilkan progres, jumlah, dan status siap
Manual lookup	Menemukan reservasi berdasarkan kamar atau nomor konfirmasi	Anda tetap dapat bekerja saat kartu tidak terbaca
Benefits	Mengelola definisi benefit dan penetapan rate-plan	Hanya menampilkan tindakan yang didukung PMS Anda
Activity	Menampilkan konsumsi hari ini dan status sinkronisasi	Anda dapat membatalkan atau mencoba ulang sinkronisasi yang gagal

Buka Halaman

1. Buka Entitlements.

2. Mulai dari tab Scan.

3. Pilih encoder yang terhubung jika Anda perlu memindai kartu.

   ✓ Tombol Start scanning tersedia saat snapshot siap.

Pembaca keycard yang didukung PMS

AVA dapat memindai melalui pembaca yang didukung PMS saat koneksi tersebut menyediakan pembacaan keycard. Pembaca tersebut muncul bersama encoder lain yang memenuhi syarat. Pengaturan properti Enable physical keycard reading juga harus aktif.

Pemindaian kartu Opera

Pemindaian kartu Opera menyediakan detail kamar dan validitas, tetapi tidak menyediakan nama tamu. Gunakan detail reservasi yang cocok untuk mengonfirmasi tamu sebelum mengelola entitlement.

Refresh Data Reservasi

Halaman ini menyimpan snapshot lokal untuk tanggal bisnis hotel saat ini. Refresh normal bersifat inkremental. Refresh menggunakan kembali detail yang berhasil saat revisi reservasi PMS tidak berubah. Refresh hanya membaca daftar reservasi yang sedang menginap. Refresh tidak memuat detail entitlement untuk setiap reservasi. Tamu yang akan check-out hari ini tetap memenuhi syarat selama masih berada di kamar. Beberapa PMS memberi label masa inap ini sebagai DUE_OUT atau Due Out, bukan CHECKED_IN.

1. Klik Refresh untuk pembaruan normal.

2. Klik Refresh + clear cache saat detail tampak usang atau Anda memerlukan pembuatan ulang penuh.

3. Tunggu hingga banner status berubah menjadi status siap.

   ✓ Halaman kini dapat memindai kartu lagi.

Refresh otomatis

Jika tidak ada snapshot aktif, AVA memulai refresh pertama secara otomatis. Jika refresh mengembalikan data hari yang sama secara parsial, AVA tetap menampilkan baris yang dapat digunakan. Pemindaian yang hanya menggunakan snapshot tetap tersedia saat refresh berjalan. Jika PMS mulai membatasi refresh, AVA menghentikan proses tersebut. AVA tetap menampilkan snapshot terakhir yang dapat digunakan.

Baca Jumlah Refresh

Banner status kini menampilkan jumlah progres refresh.

Jumlah	Artinya	Mengapa penting
Fetched	Reservasi yang baru dibaca dari PMS	Jumlah yang lebih tinggi berarti lebih banyak baris baru atau berubah
Reused	Reservasi yang diteruskan dari snapshot sebelumnya	Penggunaan ulang yang lebih tinggi biasanya berarti refresh lebih cepat
Deferred	Detail reservasi yang menunggu pemilihan unik	Detail ini belum perlu dibaca dari PMS
Hydrated	Reservasi dengan detail entitlement yang telah dimuat	Jumlah ini menunjukkan seberapa banyak detail yang telah diperiksa AVA
Pages	Halaman daftar reservasi PMS yang dibaca selama refresh	Membantu Anda menemukan pemindaian daftar yang lambat atau sangat panjang

Tamu pada hari keberangkatan

AVA mempertahankan tamu dalam daftar entitlement sampai PMS menandai masa inap tersebut sudah check-out. Refresh snapshot sebelum menyajikan sarapan atau benefit lain pada hari keberangkatan.

Snapshot melacak reservasi yang detailnya telah dimuat secara terpisah dari reservasi yang ditunda. Total entitlement mungkin merupakan batas bawah selama detail masih ditunda. Total tersebut menjadi lengkap setelah setiap reservasi dimuat atau mengembalikan hasil tanpa benefit.

Muat Detail Reservasi

1. Pindai kartu tamu atau gunakan pencarian manual.

2. Pilih hasil kamar saat beberapa kecocokan kamar muncul.

3. Tunggu sementara AVA memuat detail entitlement reservasi tersebut.

   ✓ Hasil yang berhasil, termasuk hasil tanpa benefit, tetap tersimpan dalam cache selama hari bisnis tersebut.

Pemindaian dan pencarian berulang menggunakan kembali hasil yang tersimpan dalam cache. Pembacaan detail yang gagal hanya memengaruhi reservasi yang dipilih. AVA menunggu sebelum mencoba lagi, dan respons pembatasan laju dapat memperpanjang waktu tunggu tersebut.

Benefit Opera untuk hari berikutnya

Opera dapat menyimpan paket hari berikutnya pada malam menginap sebelumnya. AVA menggunakan flag jadwal Opera untuk menampilkan benefit pada tanggal penukaran sebenarnya. Tanggal bisnis hotel mengendalikan penukaran, sedangkan tanggal PMS yang cocok mengendalikan baris allowance. Misalnya, sarapan 28 Agustus dapat menggunakan baris jadwal Opera 27 Agustus. Jadwal tanpa dasar malam menginap yang eksplisit tetap menggunakan tanggal bisnis hotel.

Tanggal posting Mews

Mews biasanya memposting benefit berdasarkan malam menginap yang ditempati. Karena itu, posting 27 Agustus dapat muncul sebagai sarapan untuk 28 Agustus. AVA mempertahankan default ini saat katalog produk Mews tidak tersedia. Jadwal hari yang sama yang eksplisit, termasuk PostingTimeUnit, menggunakan tanggal penukaran yang diberikan.

Saat tanggal PMS berbeda dari tanggal hari ini

Beberapa benefit PMS menggunakan malam menginap yang ditempati sebagai tanggal jadwalnya. Hal ini umum untuk paket sarapan hari berikutnya.

• AVA memeriksa apakah tamu dapat menukarkan benefit pada tanggal bisnis hotel hari ini.
• AVA membaca dan memperbarui tanggal jadwal PMS yang cocok.
• Benefit per masa inap juga menggunakan jadwal yang cocok saat tanggal berlakunya berasal dari dasar tersebut.

Anda tidak perlu mengubah tanggal bisnis hotel secara manual.

Tangani Reservasi Keluarga

AVA mengelompokkan reservasi terkait untuk kamar yang sama menjadi satu hasil tingkat kamar. Ini mencakup pemesanan blok, pemesanan beberapa kamar, dan reservasi dengan tamu berbagi kamar.

AVA menggunakan keluarga reservasi PMS yang diberikan oleh koneksi. Anda tidak perlu mengidentifikasi tamu terkait dari kode shared-guest khusus vendor. Reservasi keluarga Opera menggunakan peran Primary, Sharer, atau Member yang dinormalisasi. Record pendamping Mews menggunakan peran Main atau Accompany yang dinormalisasi.

Hasil dapat menampilkan:

• Booked occupancy, dengan jumlah dewasa dan anak jika PMS menyediakannya.
• Daftar tamu berlabel Primary, Sharer, Accompany, atau Guest.
• Allowance yang dipilih untuk grup reservasi kamar tersebut.

AVA tidak menjumlahkan allowance dari reservasi terkait. AVA menggunakan allowance tertinggi dan memilih Primary jika allowance sama. Konsumsi tetap melekat pada reservasi yang menyediakan allowance.

Gunakan daftar tamu untuk mengonfirmasi siapa yang Anda layani sebelum mencatat benefit.

Okupansi yang tidak diketahui tetap tidak diketahui

Jika PMS tidak menyediakan okupansi yang dipesan, AVA membiarkan nilai tersebut kosong. AVA tidak menampilkan angka nol yang keliru.

Tangani Refresh yang Dibatasi

Gunakan ini saat refresh berhenti sebelum Anda memperkirakan prosesnya selesai. Anda mungkin juga melihat lebih sedikit reservasi yang diambil daripada biasanya.

1. Tunggu satu menit sebelum mencoba lagi.

2. Klik Refresh lagi.

3. Tetap gunakan snapshot saat ini jika masih mencakup tamu hari ini.

4. Minta admin memeriksa batas laju PMS jika masalah ini terus terjadi.

   ✓ AVA tidak berpura-pura bahwa refresh selesai saat PMS membatasinya.

Pindai Kartu

1. Buka Entitlements.
2. Tetap di Scan.
3. Pilih encoder yang online.
4. Klik Start scanning.
5. Tempelkan keycard tamu.
6. Tinjau reservasi yang cocok.
7. Klik Consume 1 saat tamu menggunakan entitlement.
8. Klik Manager override hanya saat manajer menyetujui pengecualian.
9. Klik Done setelah selesai melayani tamu tersebut.

✓ Banner akan menampilkan Card scanned — ready for the next card in a moment secara singkat. ✓ Setelah itu pemindaian kembali ke Ready — tap the next card at any time.

Gunakan Pencarian Manual

Gunakan pencarian manual saat kartu tidak terbaca, atau saat Anda memerlukan pencarian berdasarkan kamar. AVA memeriksa tanggal masa inap sebelum memicu pembacaan entitlement berbayar. Jika tanggal tidak ada atau tidak valid, perbaiki reservasi terlebih dahulu.

1. Gunakan Look up by room saat Anda mengetahui nomor kamar.
2. Gunakan Look up by confirmation number saat Anda mengetahui referensi pemesanan.
3. Tunggu hingga kartu reservasi muncul.
4. Gunakan kartu entitlement dengan cara yang sama seperti hasil pemindaian.

Memulai pencarian manual menghentikan pembacaan kartu aktif sebelum pencarian dimulai. Kontrol Start scanning, encoder, dan kandidat tetap terkunci selama pencarian. Jika beberapa hasil kamar cocok, memilih salah satunya membuat pencarian tetap tanpa kartu.

Fallback langsung

Saat pencarian manual tidak menemukan data di cache, AVA mungkin memeriksa PMS secara langsung. Hasil tersebut muncul dengan catatan sampai refresh berikutnya menyertakannya.

Baca Status Snapshot

Teks banner	Artinya	Yang Anda lakukan
in-house reservations ready	Snapshot siap untuk pemindaian	Mulai memindai
Refreshing PMS reservations…	AVA sedang membuat ulang snapshot	Tunggu refresh selesai
using earlier same-day data	Refresh hari yang sama gagal, tetapi data yang dapat digunakan masih tersedia	Refresh lagi saat Anda bisa
unavailable until the next refresh	Reservasi tersebut belum dapat digunakan	Refresh atau gunakan pencarian manual
Reservation data must be refreshed before scanning	Belum ada snapshot yang siap	Klik Refresh

Saat halaman menampilkan peringatan

Halaman juga memperingatkan saat akses PMS hilang, tidak didukung, dibatasi, atau tidak tersedia. Snapshot yang ada dapat tetap terlihat dalam kondisi tersebut.

Benefits dan Activity

Tab lainnya tetap berfungsi dengan cara yang sama.

• Benefits menampilkan katalog benefit saat PMS Anda menyediakannya.
• Activity menampilkan konsumsi hari ini, tindakan undo, dan tindakan retry.
• Rate plan assignments tetap berada di Benefits saat PMS Anda mengizinkannya.

Undo memperbarui jumlah entitlement yang terlihat secara langsung. Undo tidak memerlukan refresh lanjutan yang dapat mengganggu pemindaian kartu aktif.

Pemecahan Masalah

Yang Anda lihat: Data reservasi harus di-refresh sebelum pemindaian

Perbaikan:

1. Klik Refresh.
2. Tunggu status siap.
3. Jika perlu, klik Refresh + clear cache.
4. Buka lagi Entitlements jika banner tidak diperbarui.

Yang Anda lihat: Halaman menampilkan peringatan PMS

Perbaikan:

1. Tetap gunakan snapshot saat ini jika masih tersedia.
2. Minta admin menghubungkan kembali PMS atau memulihkan akses kapabilitas.
3. Refresh lagi setelah masalah PMS diperbaiki.

Yang Anda lihat: Refresh berhenti lebih awal atau menampilkan peringatan pembatasan

Perbaikan:

1. Tunggu hingga jendela percobaan ulang berlalu.
2. Pilih kembali reservasi tersebut.
3. Gunakan snapshot saat ini untuk tamu lainnya.
4. Minta admin memeriksa batas laju PMS jika masalah berlanjut.

Yang Anda lihat: Detail entitlement masih dimuat

Mengapa ini terjadi: AVA hanya memuat detail setelah pemilihan reservasi yang unik. Daftar reservasi dapat siap sementara detail entitlement-nya masih ditunda.

Perbaikan:

1. Pastikan reservasi dipilih secara unik.
2. Tunggu hingga pembacaan detail selesai.
3. Klik Refresh + clear cache jika koreksi di PMS lebih baru.
4. Periksa koneksi PMS jika detail tetap tidak tersedia.

Yang Anda lihat: Pencarian manual tidak mengembalikan hasil yang dapat digunakan

Perbaikan:

1. Pastikan reservasi memiliki tanggal masa inap yang valid.
2. Pastikan nomor kamar atau nomor konfirmasi sudah benar.
3. Refresh reservasi di PMS, lalu coba lagi.
4. Gunakan Refresh + clear cache jika snapshot masih tampak usang.

Yang Anda lihat: Pencarian manual membuka kembali pemindaian atau mengganti hasil yang lebih baru

Mengapa ini terjadi: Respons pemindaian atau pencarian lama mungkin masih diselesaikan.

Perbaikan:

1. Tunggu hingga pencarian saat ini selesai.

2. Jangan mengubah encoder atau memilih kandidat lain saat proses berjalan.

3. Mulai kembali pencarian dengan nomor kamar atau nomor konfirmasi yang benar.

   ✓ AVA mempertahankan hasil terbaru dan tidak memulai kembali pemindaian dari pencarian manual.

Yang Anda lihat: Pemindaian menampilkan beberapa reservasi atau tidak ada kecocokan

Perbaikan:

1. Buka hasil tingkat kamar saat beberapa reservasi terkait cocok.
2. Pastikan encoder yang dipilih sedang online.
3. Gunakan Look up by room atau Look up by confirmation number.
4. Gunakan label daftar tamu untuk mengonfirmasi tamu yang dilayani.
5. Jika hasil masih tampak salah, minta dukungan meninjau pemetaan reservasi.

Yang Anda lihat: Allowance kamar tampak terlalu tinggi

Yang Anda lihat: Hasil kamar yang dikelompokkan menampilkan satu allowance untuk beberapa reservasi terkait.

Mengapa ini terjadi: AVA memilih allowance reservasi tertinggi. AVA tidak pernah menjumlahkan allowance dari reservasi terkait.

Perbaikan: Periksa label Primary, Sharer, dan Accompany. Hubungi dukungan jika allowance yang dipilih berbeda dari PMS.

Yang Anda lihat: Tamu yang berangkat hari ini tidak ditemukan

Yang Anda lihat: Tamu masih berada di kamar, tetapi pencarian kamar menyatakan tidak ada reservasi aktif yang cocok.

Mengapa ini terjadi: PMS mungkin menandai masa inap pada hari keberangkatan sebagai DUE_OUT atau Due Out.

Perbaikan:

1. Pastikan tamu belum check-out di PMS.

2. Klik Refresh di Entitlements.

3. Cari lagi berdasarkan kamar atau nomor konfirmasi.

4. Gunakan Refresh + clear cache jika tamu masih tidak muncul.

   ✓ AVA mempertahankan masa inap checked-in dan due-out tetap memenuhi syarat sampai check-out selesai.

Yang Anda lihat: Reservasi keluarga menampilkan allowance yang salah

Yang Anda lihat: Reservasi blok, beberapa kamar, atau sharer tidak menampilkan benefit yang diharapkan.

Perbaikan:

1. Refresh reservasi di PMS Anda.
2. Klik Refresh + clear cache di Entitlements.
3. Cari lagi berdasarkan kamar atau nomor konfirmasi.
4. Pilih reservasi yang benar saat beberapa kandidat muncul.
5. Hubungi dukungan jika allowance masih berbeda dari PMS.

Yang Anda lihat: Pembacaan keycard fisik tidak diaktifkan

Perbaikan:

1. Gunakan Look up by room atau Look up by confirmation number.
2. Buka Settings → Room Access → Keycard Encoding.
3. Pilih PMS Integration.
4. Pastikan vendor PMS dan perangkat encoder sudah benar.
5. Aktifkan Enable physical keycard reading hanya setelah API pembacaan PMS divalidasi.
6. Klik Save, lalu muat ulang Entitlements.
7. Hubungi dukungan jika peringatan tetap muncul setelah disimpan.

Pencarian manual tetap tersedia

AVA menonaktifkan pemindaian kartu saat koneksi tidak dapat membaca kartu. Pencarian berdasarkan kamar dan konfirmasi tetap tersedia. Peringatan tersebut dapat berarti pembacaan nonaktif, tidak didukung, atau sementara tidak tersedia.

Yang Anda lihat: Hasil menyatakan telah diperiksa langsung di PMS

Perbaikan:

1. Gunakan hasil tersebut untuk tamu saat ini.
2. Klik Refresh agar pemindaian berikutnya menggunakan snapshot yang diperbarui.
3. Periksa kembali reservasi jika hasil langsung tersebut masih tampak salah.

Masih Terhenti?

Hubungi success@vouch-technologies.com jika:

• ❌ Snapshot tidak pernah siap.
• ❌ Pemindaian kartu terus tidak menemukan reservasi yang valid.
• ❌ Fallback langsung terus muncul setelah refresh.

Sebaiknya sertakan:

• ID reservasi atau nomor konfirmasi
• Nomor kamar
• Screenshot banner status
• Waktu masalah mulai terjadi

Panduan Terkait

• Kelola Kode Akses
• Encoding Keycard Manual
• Masalah Smart Lock