Menyiapkan Dukungan Entitlement

Penyiapan Cepat

Sebagian besar hotel menyelesaikan pengaturan ini dalam waktu sekitar 5 menit. Anda hanya memerlukan dukungan PMS dan satu akun admin.

Gunakan panduan ini jika Anda ingin Entitlements menampilkan manfaat reservasi seperti sarapan. Panduan ini juga membantu Anda menetapkan manfaat tersebut ke rate plan dan mengatur kapan tamu dapat menukarkannya.

Buka: Settings → Essentials

Yang Akan Anda Konfigurasikan

Tugas	Yang Dikendalikan	Tempat Digunakan
Dukungan entitlement PMS	Menampilkan fitur pemindaian, manfaat, dan aktivitas	Halaman Entitlements
Pembacaan keycard PMS	Memungkinkan pemindaian kartu fisik untuk Entitlements	Settings → Room Access
Katalog manfaat	Membuat atau mengedit definisi manfaat	Entitlements → Benefits
Penetapan rate plan	Mengaitkan manfaat dengan rate plan	Rates & Availability → Rate Plans
Waktu penukaran	Menetapkan kapan tamu dapat menggunakan manfaat	Entitlements → Benefits
Sinkronisasi ledger	Mencatat konsumsi terlebih dahulu, lalu menyinkronkannya ke PMS	Entitlements → Activity

Pengeditan di perangkat seluler

Katalog manfaat yang sama muncul di ponsel dan desktop. Yang berubah hanya tata letaknya.

Cara Kerja Waktu

AVA menggunakan business date, allocation, accrual, dan redemption timing, ditambah jadwal PMS jika ada, untuk menentukan apakah manfaat dapat digunakan. Saat PMS menyediakan jadwal, AVA mengikuti jadwal tersebut terlebih dahulu. Jika data PMS tidak lengkap, AVA hanya menurunkan waktu ketika aturan tersebut aman untuk ditafsirkan. Streamliner menandatangani eligibility yang digunakan untuk redemption, dan halaman Entitlements menggunakan hasil yang telah ditandatangani tersebut.

Hal ini menjaga agar sarapan dan manfaat serupa selaras dengan hari hotel, bukan hanya hari kalender.

Tanggal business date dan tanggal jadwal PMS

AVA memisahkan dua tanggal ketika jadwal PMS menggunakan malam masa inap yang ditempati:

• Tanggal business date hotel mengontrol apakah staf dapat menukarkan manfaat hari ini.
• Tanggal jadwal PMS mengidentifikasi baris allowance yang harus dibaca dan diperbarui.

Sebagai contoh, sarapan yang ditukarkan pada 28 Agustus dapat menggunakan baris PMS bertanggal 27 Agustus. Jadwal tanpa dasar malam masa inap yang eksplisit tetap menggunakan business date hotel. Aturan yang sama berlaku untuk manfaat harian dan tanggal berlaku manfaat per-masa-inap.

Tanggal posting Mews

Mews biasanya memposting manfaat terhadap malam masa inap yang ditempati. Sebagai contoh, posting tanggal 27 Agustus dapat muncul sebagai sarapan untuk 28 Agustus. AVA mempertahankan dasar malam masa inap ini ketika product catalogue Mews tidak tersedia. Jadwal eksplisit pada hari yang sama menggunakan tanggal redemption yang diberikan. Ini mencakup jadwal PostingTimeUnit, hari kedatangan, dan hari keberangkatan.

Jadwal hari berikutnya Opera

Opera dapat menyimpan paket hari berikutnya terhadap malam masa inap yang ditempati. AVA membaca flag jadwal Opera dan menempatkan manfaat pada tanggal redemption sebenarnya. AVA tetap menulis redemption ke baris jadwal PMS yang cocok. Sebagai contoh, sarapan yang ditukarkan pada 28 Agustus dapat menggunakan baris 27 Agustus di Opera.

Sebelum Memulai

Pastikan item berikut sudah siap:

• Anda dapat membuka Settings → Essentials.
• PMS Anda mendukung manfaat reservasi.
• PMS Anda mendukung akses katalog manfaat atau penetapan rate plan.
• Provider PMS Anda telah memvalidasi pembacaan keycard fisik, jika Anda memerlukan pemindaian kartu.
• Anda mengetahui manfaat yang harus muncul pada masa inap tamu.
• Anda memiliki izin untuk mengedit pengaturan atau rate plan.

Bagian tidak muncul?

Jika halaman Entitlements dinonaktifkan, dukungan PMS Anda tidak tersedia atau tidak aktif.

Memeriksa Dukungan PMS

1. Buka Settings → Essentials → PMS Integration.

2. Pastikan PMS Anda terhubung dan aktif.

3. Buka Entitlements.

4. Pastikan Anda melihat tab Scan, Benefits, dan Activity.

   ✓ PMS yang didukung menampilkan tab entitlement.

Entitlements berbasis kapabilitas

Jika sebuah tab tidak muncul, PMS Anda tidak menyediakan kapabilitas tersebut. Beberapa merchant hanya dapat memindai dan mengonsumsi.

Mengaktifkan pemindaian keycard PMS

Pemindaian kartu fisik memerlukan dukungan PMS dan kapabilitas baca Room Access. Pencarian kamar dan konfirmasi secara manual tetap tersedia tanpa pembacaan kartu.

1. Buka Settings → Room Access → Keycard Encoding.

2. Pilih PMS Integration.

3. Pastikan vendor PMS dan perangkat encoder sudah benar.

4. Aktifkan Enable physical keycard reading.

5. Klik Save.

6. Kembali ke Entitlements dan muat ulang halaman.

   ✓ Start scanning muncul jika snapshot siap dan encoder yang memenuhi syarat tersedia.

Aktifkan pembacaan hanya setelah validasi

Pengaturan ini secara default dinonaktifkan. Aktifkan hanya setelah provider PMS Anda mengonfirmasi bahwa read API properti sudah siap. Encoding tetap berjalan saat pembacaan dinonaktifkan.

Mengelola Katalog Manfaat

1. Buka Entitlements → Benefits.

2. Klik New benefit jika Anda dapat membuat manfaat.

3. Masukkan Code dan Name.

4. Tetapkan penerimanya dengan Each guest atau Each room.

5. Tetapkan frekuensi accrual dengan Every night atau Once per stay.

6. Pilih kapan tamu dapat menggunakannya.

7. Klik Save benefit.

   ✓ Manfaat tersebut muncul di daftar katalog.

Katalog yang dikelola PMS

Jika katalog dikelola PMS, Anda hanya dapat melihat manfaat di sini. Perubahan akan muncul setelah sinkronisasi PMS diperbarui.

Menetapkan Manfaat ke Rate Plan

1. Buka Rates & Availability → Rate Plans.

2. Temukan rate plan yang Anda inginkan.

3. Klik Manage benefits atau View benefits.

4. Pilih manfaat yang sudah ada dari katalog.

5. Tetapkan kuantitas yang disertakan untuk masing-masing manfaat.

6. Klik Save assignments.

   ✓ Tamu yang memesan dengan plan tersebut menerima manfaatnya.

Hanya manfaat yang sudah ada

Rate plan kini memilih manfaat dari katalog manfaat. Anda tidak membuat definisi manfaat di dalam modal rate plan. Jika perlu mengubah allocation, accrual, atau redemption timing, edit manfaat itu sendiri.

Memverifikasi Ledger

1. Buka Entitlements → Activity.

2. Periksa baris redemption terbaru.

3. Pastikan Anda melihat salah satu status berikut:

   • Saved in Streamliner
   • PMS sync pending
   • PMS synced
   • Ledger only
   • PMS sync failed

4. Gunakan Retry untuk sinkronisasi yang gagal.

   ✓ Streamliner mencatat redemption terlebih dahulu. ✓ Sinkronisasi PMS berlangsung setelahnya jika didukung.

Pemecahan Masalah

Muncul pesan "An active PMS connection is required"

Yang Anda lihat: Halaman Entitlements menampilkan An active PMS connection is required, meskipun Settings → Essentials → PMS Integration menunjukkan PMS yang terhubung.

Perbaikan:

1. Muat ulang Entitlements setelah memastikan koneksi PMS.
2. Jika Anda baru saja berpindah hotel, buka kembali hotel yang benar lalu coba lagi.
3. Keluar dan masuk kembali jika pesan tersebut masih muncul.

Entitlements kini membaca konfigurasi PMS aktif untuk hotel saat ini. Hal ini menyelaraskan halaman dengan koneksi yang sama seperti yang Anda lihat di PMS Integration.

Halaman Entitlements Dinonaktifkan

Yang Anda lihat: Halaman Entitlements menampilkan banner yang dinonaktifkan.

Perbaikan:

1. Minta admin mengonfirmasi paket Anda.
2. Pastikan integrasi PMS Anda aktif.
3. Muat ulang halaman Entitlements.

Tab Benefits Hanya Dapat Dibaca

Yang Anda lihat: Anda dapat melihat manfaat, tetapi tidak dapat membuat atau mengeditnya.

Perbaikan:

1. Periksa apakah PMS Anda mengelola katalog.
2. Minta admin memberikan akses tulis ke pengaturan.
3. Muat ulang Entitlements.

Manfaat Rate Plan Tidak Tersimpan

Yang Anda lihat: Drawer manfaat tertutup, tetapi plan tetap menggunakan manfaat lama.

Perbaikan:

1. Pastikan Anda memiliki akses tulis ke pengaturan.
2. Pastikan PMS Anda mendukung penetapan rate plan.
3. Buka kembali rate plan dan simpan sekali lagi.

Sinkronisasi Tetap Pending atau Gagal

Yang Anda lihat: Baris aktivitas tetap pending atau menampilkan sync failed.

Perbaikan:

1. Klik Retry pada baris yang gagal.
2. Periksa koneksi PMS jika percobaan ulang terus gagal.
3. Sementara itu, tetap gunakan ledger Streamliner.

Manfaat Tampak Tidak Tersedia Hari Ini

Yang Anda lihat: Manfaat muncul di katalog, tetapi tidak dapat digunakan untuk masa inap hari ini.

Perbaikan:

1. Periksa tanggal reservasi dan business date hotel.
2. Buka manfaat lalu tinjau aturan waktunya.
3. Jika PMS mengelola katalog, konfirmasikan jadwal di sana.

Jika PMS mengirim jadwal, AVA mengikuti jadwal tersebut sebelum menampilkan manfaat sebagai dapat digunakan. Jika manfaat dimulai pada hari berikutnya, AVA memblokir redemption pada hari kedatangan.

Untuk Opera atau Mews, periksa baris malam masa inap yang ditempati ketika sarapan tidak tersedia hari ini.

Manfaat Menggunakan Tanggal Jadwal yang Salah

Yang Anda lihat: Manfaat tersedia hari ini, tetapi jadwal PMS-nya muncul pada malam masa inap sebelumnya.

Perbaikan:

1. Konfirmasikan business date hotel saat ini.

2. Periksa baris PMS untuk malam masa inap yang ditempati.

3. Konfirmasikan dasar jadwal manfaat di PMS.

4. Segarkan Entitlements sebelum mencoba lagi.

   ✓ AVA seharusnya melakukan redemption terhadap business date hari ini dan memperbarui baris PMS yang cocok.

Masih Mengalami Kendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Halaman Entitlements tetap dinonaktifkan setelah sinkronisasi baru.
• ❌ Manfaat tidak pernah muncul di katalog.
• ❌ Penetapan rate plan tidak tersimpan.
• ❌ Baris aktivitas tidak pernah keluar dari status pending.

Sertakan:

• Nama PMS
• Satu kode manfaat atau nama rate plan
• Tangkapan layar halaman atau drawer

Panduan Terkait

• Periksa dan Konsumsi Entitlement Tamu
• Mengelola Rate Plan
• Integrasi PMS Opera
• Integrasi PMS Mews