Menyiapkan Kunci Digital QRLOCK

Penyiapan Cepat

Siapkan detail QR Master, petakan kamar Anda, lalu uji satu tautan tamu. Luangkan waktu sekitar 15 menit.

Panduan ini membantu Anda menghubungkan QRLOCK dan menerbitkan kunci kamar digital yang di-host melalui AVA.

Referensi cepat

Tugas	Yang diperlukan	Tempat melakukannya
Menghubungkan QRLOCK	QR Master SID, Auth Token, dan nomor community	Settings → Room Access
Memetakan kamar	ID kamar PMS yang tepat dan kamar QRLOCK	QRLOCK Room Mapping
Menguji akses	Reservasi uji dan pembaca QRLOCK yang dapat dijangkau	Detail check-in atau reservasi
Mengelola akses	Kunci aktif, email tamu, atau tindakan staf	Reservasi atau Access Codes

Sebelum memulai

Konfirmasikan persyaratan berikut:

• Akun QRLOCK Anda menyediakan QR Master SID.
• Anda memiliki Auth Token yang sesuai.
• Anda mengetahui Community Number QRLOCK Anda.
• Kamar QRLOCK telah dibuat dan tersedia di sistem vendor.
• ID kamar PMS merupakan string yang stabil dan unik.
• AVA menggunakan origin HTTPS publik untuk kunci tamu di production.

Jaga kerahasiaan kredensial

AVA mengenkripsi kredensial QRLOCK dan tautan tamu. Jangan menempelkan token ke screenshot, pesan dukungan, atau catatan bersama.

Mengonfirmasi URL layanan kunci tamu

Administrator deployment Anda harus menggunakan URL Room Access Service yang sudah ada untuk tautan tamu. AVA hanya menggunakan URL aplikasi jika URL Room Access tidak dikonfigurasi.

Pengaturan	Penggunaan
Room Access Service URL (ROOM_ACCESS_BASE_URL)	Origin utama untuk /guest-key dan /guest-key/client.js
Application URL (APP_BASE_URL)	Origin fallback jika URL Room Access tidak ditetapkan

URL yang dipilih harus berupa origin HTTPS publik di production. URL tersebut tidak boleh menyertakan path, query, fragment, atau kredensial login. Jangan menambahkan pengaturan guest-origin terpisah.

Minta administrator deployment Anda memastikan kedua route tamu dapat dimuat sebelum menguji penerbitan.

Menghubungkan QRLOCK

1. Buka Settings → Room Access.

2. Pilih opsi koneksi QR digital-key.

3. Pilih QRLOCK sebagai provider.

4. Masukkan QR Master SID, Auth Token, dan Community Number Anda.

5. Pilih Test Connection.

6. Simpan koneksi setelah pengujian berhasil.

   ✓ AVA menampilkan Connected, menyamarkan token yang disimpan, dan memuat inventaris kamar QRLOCK.

Pembaca QR yang didukung

AVA mendukung kamar pembaca QRALOCK dan QRLOCK melalui alur digital-key ini. Keluarga model QR lainnya tetap tidak tersedia.

Memetakan kamar PMS ke kamar QRLOCK

1. Buka QRLOCK Room Mapping di pengaturan QR digital-key.

2. Pilih kamar PMS.

3. Pilih kamar QRLOCK yang sesuai dari inventaris.

4. Simpan pemetaan yang tertunda.

5. Ulangi untuk setiap kamar yang harus menerima kunci QR.

   ✓ AVA menampilkan kamar sebagai sudah dipetakan dan siap diterbitkan.

QRLOCK dapat berbagi kamar PMS

Anda dapat mempertahankan pemetaan PIN-vendor untuk kamar PMS yang sama. QRLOCK hanya menyimpan dan mengubah pemetaan QRLOCK. Pemetaan vendor lain tetap tersedia untuk alur aksesnya masing-masing.

Petakan setiap kamar secara eksplisit

AVA tidak menebak kamar QRLOCK dari nama yang mirip. Kamar yang belum dipetakan atau ambigu tidak dapat menerima kunci QR.

Mengirimkan kunci QR tamu

Untuk penetapan kamar QRLOCK yang memenuhi syarat, AVA menerbitkan satu kunci setelah penetapan kamar. AVA menyimpan kunci sebelum memulai pengiriman email.

1. Selesaikan check-in tamu.

2. Buka Room Information untuk kamar yang sudah check-in.

3. Periksa status pengiriman kunci QR.

4. Gunakan tindakan guest-link untuk menyalin tautan jika diperlukan.

   ✓ Tamu menerima email informasi kamar dengan instruksi QR.

Setelah penerbitan otomatis atau oleh staf, pastikan kunci yang sama muncul di riwayat akses. Kemudian buka tautan tamu dan pastikan halaman QR yang di-host dapat dimuat.

Percobaan ulang email menggunakan kunci yang sama. Percobaan tersebut tidak membuat kartu vendor lain.

Kartu kamar dapat menampilkan Pending, Sent, atau Staff assistance required. Penerimaan email tidak membuktikan bahwa tamu telah membuka pintu.

Tautan mengikuti jendela validitas reservasi. AVA memisahkan tautan tamu dari kode akses PIN.

Mengirim ulang informasi kamar

Gunakan Email room information saat tamu kembali membutuhkan detail terkini.

1. Buka reservasi atau kartu kamar yang sudah check-in.

2. Pilih Email room information.

3. Konfirmasikan email pribadi tamu.

   ✓ AVA mengirim ulang kunci QR dan detail kamar yang sudah ada.

Tindakan email tidak menerbitkan kunci baru. Gunakan alamat email pribadi, bukan alamat proxy OTA.

Jika pengiriman sementara tidak tersedia, AVA mencoba ulang intent pengiriman yang sama.

Menerbitkan atau menerbitkan ulang akses sebagai staf

Gunakan kontrol staf saat penerbitan otomatis tidak terjadi atau saat diperlukan penggantian.

1. Buka reservasi di Reservations atau Access Codes.
2. Buka Manage digital key.
3. Pilih Issue hanya jika tidak ada kunci aktif.
4. Pilih Send saat kunci siap.
5. Pilih Copy guest link untuk membagikan tautan tamu aktif secara langsung.

Penerbitan oleh staf dan pengiriman email merupakan tindakan yang terpisah. AVA memeriksa kamar, tanggal, nomor telepon, dan pemetaan kamar saat ini sebelum menerbitkan.

Untuk reservasi dengan beberapa kamar, AVA memeriksa kamar yang dipilih. Kamar yang dipilih dan sudah terminal tidak dapat diterbitkan, diterbitkan ulang, atau dikirim. Riwayat reservasi dan kontrol penarikan tetap tersedia.

Menarik atau menerbitkan ulang kunci QR

Tarik akses saat tamu check-out lebih awal atau kehilangan izin akses.

1. Buka detail akses kamar reservasi.

2. Pilih Withdraw untuk kunci QR aktif.

3. Konfirmasikan penarikan.

4. Jika pembatalan masih diproses, pilih Retry cancellation setelah percobaan ulang tersedia.

5. Tunggu konfirmasi pembatalan vendor.

6. Segarkan status dan pilih Reissue.

7. Konfirmasikan pembuatan baru.

   ✓ AVA membuat kartu vendor dan tautan tamu baru.

Jangan mengulangi penerbitan yang belum pasti secara membabi buta

Jika AVA menampilkan kunci yang belum terselesaikan atau sudah ditarik, tunggu pemulihan oleh staf. Pengiriman otomatis tidak pernah mengganti kunci tersebut tanpa tindakan eksplisit.

Tautan AVA lama tetap berstatus ditarik setelah penerbitan ulang. Gunakan hanya tautan tamu terbaru.

Perilaku checkout

Checkout mempertahankan perilaku kunci QR yang sudah ada. Staf harus menarik akses untuk keberangkatan lebih awal. Jendela validitas yang tersimpan tetap mengatur kedaluwarsa normal.

Memindahkan tamu ke kamar lain

AVA mempertahankan hubungan pembuatan kunci QR dengan penetapan kamar.

1. Selesaikan pemindahan kamar di PMS.
2. Segarkan reservasi di AVA.
3. Tunggu AVA mengonfirmasi kamar tujuan.
4. Tinjau status pembatalan kunci lama.
5. Terbitkan akses untuk kamar tujuan hanya setelah pembatalan berhasil.

Jika tamu kembali ke kamar semula, gunakan tindakan Reissue yang telah diperiksa revisinya. Jangan ulangi pemindahan PMS setelah pembatalan gagal.

Yang Anda lihat → Perbaikan

Pengujian koneksi QRLOCK gagal

Yang Anda lihat: Test Connection gagal atau tidak ada inventaris QRLOCK yang dimuat.

Perbaikan:

1. Periksa QR Master SID dan Community Number.
2. Tempelkan kembali Auth Token tanpa spasi tambahan.
3. Pastikan akun QRLOCK Anda dapat melihat community dan kamar.
4. Simpan kredensial, lalu jalankan kembali Test Connection.

Kamar tidak dapat menerima kunci QR

Yang Anda lihat: Tindakan QR digital-key tidak tersedia untuk suatu reservasi.

Perbaikan:

1. Pastikan reservasi memiliki kamar yang ditetapkan.
2. Buka QRLOCK Room Mapping.
3. Petakan kamar PMS yang tepat ke satu kamar QRLOCK.
4. Segarkan reservasi dan coba lagi.

Tautan tamu ditarik atau tidak tersedia

Yang Anda lihat: Tautan lama menyatakan akses tidak tersedia, atau penggantinya tidak ada.

Perbaikan:

1. Konfirmasikan status kunci QR terbaru di reservasi.
2. Jangan gunakan kembali tautan lama setelah penarikan atau penerbitan ulang.
3. Jika pembatalan telah dikonfirmasi, pilih Reissue.
4. Bagikan hanya tautan yang baru dibuat.

Email kunci QR tidak tiba

Yang Anda lihat: Kartu kamar menampilkan status email tertunda atau gagal.

Perbaikan:

1. Pastikan tamu memiliki alamat email pribadi.

2. Pastikan alamat tersebut bukan alamat proxy OTA.

3. Tunggu hingga percobaan ulang pengiriman selesai.

4. Pilih Email room information setelah status diperbarui.

5. Gunakan Copy guest link jika tamu membutuhkan akses segera.

   ✓ Kunci QR saat ini tetap tidak berubah selama pengiriman email dicoba ulang.

Penerbitan kunci QR menghasilkan kesalahan layanan

Yang Anda lihat: Penerbitan otomatis atau oleh staf menghasilkan 503, dan tidak ada baris riwayat atau tautan email yang muncul.

Perbaikan:

1. Minta administrator deployment Anda memastikan Room Access Service URL telah dikonfigurasi.

2. Pastikan /guest-key dan /guest-key/client.js dapat dimuat dari URL publik tersebut.

3. Pastikan URL tidak memiliki path, query, fragment, atau kredensial.

4. Coba lagi penerbitan setelah release Room Access Service sehat.

5. Pastikan baris riwayat akses baru, tautan tamu, dan pengiriman email telah muncul.

   ✓ AVA memvalidasi route tamu sebelum membuat kunci vendor.

Pemetaan QRLOCK bertentangan dengan vendor lain

Yang Anda lihat: Vendor smart-lock lama sudah menggunakan kamar PMS yang sama.

Perbaikan:

1. Buka QRLOCK Room Mapping di pengaturan QR digital-key.

2. Pilih kamar PMS dan kamar QRLOCK yang tepat.

3. Simpan pemetaan QRLOCK tanpa menghapus pemetaan PIN-vendor.

4. Pastikan kedua pemetaan vendor tetap terlihat di area penyiapannya masing-masing.

   ✓ QRLOCK menggunakan pemetaannya, sementara vendor PIN mempertahankan pemetaannya.

Jika penyimpanan tetap gagal, segarkan halaman dan coba lagi satu kali. Jangan reset pemetaan vendor PIN untuk menyelesaikan konflik QRLOCK.

Pemindahan kamar menghalangi kunci pengganti

Yang Anda lihat: AVA menyatakan pemulihan staf diperlukan sebelum menerbitkan kunci.

Perbaikan:

1. Segarkan reservasi setelah PMS mengonfirmasi tujuan.

2. Buka status kunci QR kamar sebelumnya.

3. Pastikan pembatalan vendor berhasil.

4. Periksa pemetaan kamar tujuan.

5. Pilih Reissue hanya saat AVA mengaktifkannya.

   ✓ AVA membuat satu pengganti untuk keadaan tujuan yang telah dikonfirmasi.

Kamar yang dipilih tidak dapat menggunakan tindakan digital-key

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

Perbaikan:

1. Pastikan kamar yang dipilih tidak berstatus terminal di PMS.
2. Jika sesuai, pilih kamar aktif dari reservasi.
3. Tinjau status dan riwayat yang ada untuk kamar terminal.
4. Tarik akses hanya saat tamu tidak lagi boleh masuk.

QR berhasil dipindai tetapi pintu tidak terbuka

Yang Anda lihat: Halaman yang di-host menampilkan kode QR, tetapi pembaca menolaknya.

Perbaikan:

1. Pastikan tamu menggunakan tautan terbaru.
2. Periksa jendela validitas reservasi dan waktu saat ini.
3. Pastikan pemetaan kamar QRLOCK sesuai dengan kamar fisik.
4. Uji pembaca dengan aplikasi QRLOCK atau alat vendor.
5. Gunakan metode akses cadangan hotel selama Anda menyelidikinya.

Masih mengalami kendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Kredensial tetap gagal setelah Anda memverifikasinya
• ❌ Kamar yang sudah dipetakan tidak dapat menerbitkan kunci QR
• ❌ Pembatalan atau penerbitan ulang tetap belum terselesaikan

Sebaiknya sertakan:

• Nama hotel dan nomor kamar
• Model QRLOCK dan nomor community
• Screenshot status tanpa kredensial
• ID reservasi dan waktu masalah mulai terjadi

Panduan terkait

• Ikhtisar Smart Locks
• Menyiapkan Penetapan Smart Lock
• Pemecahan Masalah Smart Lock