Menyiapkan Integrasi PMS Mews

Penyiapan Cepat

Sebagian besar hotel hanya memerlukan Access Token. Proses ini memakan waktu sekitar 10 menit.

Panduan ini membantu Anda menghubungkan AVA ke Mews agar reservasi dan detail tamu tersinkron dengan benar. Panduan ini juga menjelaskan cara AVA menangani produk yang sudah termasuk dalam tarif, seperti sarapan yang digabungkan dalam tarif OTA.

Tempat Menemukannya

Settings → Essentials → Property Management System (PMS) Integration

Referensi Cepat

Pengaturan	Yang dikontrol	Kapan digunakan
Access Token	Menghubungkan AVA ke Mews	Selalu
Advanced → Client Token	Kredensial koneksi lanjutan	Hanya jika diminta oleh dukungan
Advanced → Client ID	Pengidentifikasi properti Anda di Mews	Hanya jika diminta oleh dukungan
Advanced → Demo Mode	Menggunakan endpoint sandbox untuk pengujian	Hanya untuk lingkungan pengujian
Reservation comments	Menarik catatan service order Mews ke AVA	Saat AVA membaca reservasi atau melakukan penyegaran live billing
Room payment waiver	Menggunakan invoice yang dikembalikan untuk menentukan waiver	Saat invoice menandai pembayaran kamar sebagai di-waive
Accommodation charge policies	Menampilkan kontrol waive dan hide akomodasi di pengaturan pembayaran AVA	Hanya jika koneksi Mews Anda menyediakan dukungan payment-policy

Sebelum Memulai

Anda memerlukan:

• Akses ke area admin Mews
• Access Token / Token ID untuk integrasi AVA
• Izin admin untuk memperbarui pengaturan PMS di AVA

info

Jika Anda tidak memiliki Access Token, hubungi admin Mews atau dukungan AVA.

Cara Mendapatkan Access Token Mews

Ikuti langkah-langkah berikut di Mews:

1. Masuk ke Mews PMS

2. Klik Marketplace di sidebar

   

3. Klik My Subscriptions

   

4. Temukan Vouch AVA Front Desk Agent

5. Klik Edit

6. Buka bagian Access Token

7. Salin Token ID

   

tip

Tempel token ke AVA segera agar Anda tidak kehilangannya.

Langkah Konfigurasi

Langkah 1: Pilih Mews

1. Buka Settings → Essentials → PMS Integration
2. Klik kartu Mews
3. Formulir konfigurasi Mews akan muncul

Langkah 2: Masukkan Access Token

1. Tempel Token ID dari Mews ke field Access Token
2. Token disembunyikan setelah disimpan demi keamanan

Nilai yang Disamarkan Aman

Jika Anda kembali nanti dan melihat karakter yang disamarkan, biarkan apa adanya lalu klik Save. AVA mempertahankan Access Token, Client Token, dan Client ID yang tersimpan.

Jika Anda memerlukan pengaturan Mews Advanced (khusus dukungan)

1. Klik Advanced
2. Masukkan nilai yang diberikan oleh dukungan:
   • Client Token
   • Client ID
3. Opsional: Aktifkan Demo Mode jika Anda menguji dengan endpoint sandbox

peringatan

Jangan mengubah nilai Advanced kecuali diminta oleh dukungan. Nilai yang salah dapat menghentikan sinkronisasi.

Langkah 3: Simpan

1. Klik Save di bagian bawah halaman
2. Cari pesan keberhasilan
3. Field Access Token menampilkan placeholder untuk melindungi secret

Yang Terjadi Setelah Terhubung

• ✅ AVA mulai menggunakan data Mews untuk reservasi dan detail tamu
• ✅ Field Access Token menampilkan karakter yang disamarkan
• ✅ Gunakan Edit Token jika Anda perlu memperbarui token nanti
• ℹ️ AVA mempertahankan nilai Demo Mode saat Anda menyimpan field Mews lainnya.
• ℹ️ Lingkungan produksi tidak memaksa Demo Mode menjadi OFF.
• ✅ Nama perusahaan Mews kini mengisi label sumber reservasi saat AVA dapat menyelesaikannya.
• ✅ Reservasi Mews diperlakukan sebagai hotel collect di AVA.
• ✅ Status room-lock Do Not Move tetap tersinkron dengan Mews.
• ✅ AVA melewati kamar Mews yang diblokir saat penugasan otomatis dan mencoba kamar bersih lain jika memungkinkan.
• ✅ AVA menarik catatan service order Mews ke komentar reservasi.
• ✅ Catatan yang cocok dapat membebaskan pembayaran kamar ketika invoice mengembalikan flag waiver.
• ✅ AVA memuat detail invoice lengkap sebelum memeriksa waiver pada pembacaan reservasi tunggal.
• ✅ AVA menjaga kamar Mews yang belum ditetapkan tetap terlihat dalam booking multi-room.
• ✅ Pembaruan profil tamu dapat memicu catch-up pengiriman ulang pre-arrival otomatis.
• ✅ Live billing Mews memeriksa ulang catatan payment-policy yang dikonfigurasi sebelum mengganti saldo tersimpan.
• ✅ Waiver seluruh invoice dapat membuat saldo yang harus dibayar menjadi nol sambil mempertahankan catatan deposit dan pembayaran untuk audit.
• ✅ Produk yang sudah termasuk dalam tarif dan telah diverifikasi, seperti sarapan yang dibundel, dapat mengikuti waiver paket kamar.
• ✅ Tagihan dengan harga relatif yang terkait dengan produk yang telah diverifikasi dapat mengikuti waiver tersebut.
• ⚠️ AVA menolak secara aman ketika tidak dapat membuktikan klasifikasi suatu produk.
• ✅ Bandingkan invoice Mews lengkap sebelum menagih saldo yang tidak terduga.

Dampak bagi Tamu & Staf

• Formulir tamu menyesuaikan aturan Mews. Field wajib dan field tersembunyi berubah berdasarkan konfigurasi Mews, sehingga tamu hanya melihat yang diperlukan.
• Pencarian reservasi menggunakan Mews. Jika Mews belum dikonfigurasi, langkah pencarian tamu akan gagal.
• Produk yang telah diverifikasi dan termasuk dalam tarif dapat mengikuti waiver. AVA memperlakukan produk yang termasuk dalam tarif sebagai akomodasi ketika Mews membuktikan bahwa produk tersebut memang termasuk.
• Pencarian oleh staf tetap tersedia. Staf dapat menggunakan Staff Access untuk membandingkan tagihan PMS live.
• Klasifikasi waiver yang tidak jelas ditolak secara aman. Saat penagihan pembayaran kamar diaktifkan, AVA mengarahkan tamu ke front desk selama pencarian. AVA menahan jumlah yang belum terverifikasi untuk ditinjau staf.
• Label sumber booking dapat menampilkan nama perusahaan Mews. Jika AVA dapat menyelesaikan nama perusahaan, AVA menggunakan nama tersebut alih-alih company ID mentah.
• Mews source collect kini default ke hotel collect. Ini menjaga label sumber tetap selaras dengan kontrak reservasi yang diterima AVA.
• Kamar yang terkunci tetap terkunci di AVA. Jika Mews menandai reservasi sebagai terkunci, Streamliner menampilkan ikon lock di tampilan room-change.
• Catatan service order menjadi komentar reservasi. Staf dapat meninjau teks catatan saat mencari reservasi.
• Pembayaran kamar yang di-waive tetap dapat dijelaskan. Saat Mews menandai invoice sebagai di-waive, AVA menampilkan teks catatan sebagai alasan waiver.
• Live billing mengikuti aturan waiver yang sama. Room List memeriksa ulang catatan yang dikonfigurasi sebelum mengganti saldo tersimpan.
• Waiver penuh tetap menyimpan catatan audit. AVA dapat menampilkan saldo nol sekaligus mempertahankan baris deposit dan pembayaran.
• Penagihan yang tidak jelas perlu ditinjau. AVA tidak menampilkan jumlah waiver yang belum terverifikasi sebagai jumlah yang dapat ditagih.
• Saldo yang tidak terduga perlu ditinjau. Bandingkan jumlah yang ditampilkan dengan tagihan Mews live sebelum menagih.
• Accommodation charge policies berbasis kapabilitas. Jika Mews menyediakannya, AVA menampilkan kontrol waive dan hide di pengaturan pembayaran.
• Perubahan email tamu dapat memicu catch-up pengiriman ulang. Saat Mews mengirim pembaruan tamu, AVA dapat mengirim ulang email pre-arrival yang sudah terlewat ke alamat terbaru.

Booking Multi-Room Tetap Lengkap

AVA menjaga setiap kamar Mews yang dipesan tetap terlihat, bahkan sebelum Mews menetapkan kamar fisik. Kamar utama tetap berada di urutan pertama dalam daftar. Ini membantu staf melihat seluruh booking saat pencarian dan check-in.

Referensi Booking Bersama Tetap Terpisah

Jika beberapa reservasi Mews memiliki external booking ID atau family ID yang sama, AVA menjaga setiap reservasi tetap terpisah. Tamu, kamar, tanggal, status, dan total tetap berada pada reservasi yang Anda buka.

Email Booking Bersama Membuat Tamu Terpisah

Jika dua tamu menggunakan email booking yang sama, AVA membuat customer Mews yang terpisah. AVA hanya menggunakan kembali customer jika nomor dokumen cocok dengan record yang sudah ada. Jika AVA sudah memiliki referensi tamu Mews langsung, AVA terus memperbarui tamu tersebut.

Pembaruan Tamu Tetap Terkini

Saat Mews mengirim pembaruan profil tamu, AVA menyegarkan record tamu yang digunakannya untuk pemeriksaan pengiriman ulang. Jika email tamu berubah, AVA dapat mengirim ulang email pre-arrival yang sudah terlewat setelah sinkronisasi.

Kecocokan Tepat

AVA mencocokkan nilai kebijakan akomodasi yang dikonfigurasi secara tepat. Tinjau invoice Mews lengkap ketika suatu nilai tidak cocok.

Waiver Live Billing

Gunakan bagian ini saat Room List atau penyegaran reservasi harus menerapkan kembali payment policies Mews.

AVA memeriksa catatan service-order Mews terbaru sebelum mengganti saldo tersimpan. AVA hanya melakukannya jika setidaknya satu daftar payment-policy telah dikonfigurasi.

Pencarian oleh staf tetap tersedia agar staf dapat membandingkan reservasi dengan tagihan Mews live. Saat Mews membuktikan bahwa suatu produk yang termasuk dalam tarif merupakan bagian dari tarif yang dipesan, waiver mencakup produk tersebut. Tagihan terkait yang harganya relatif terhadap produk tersebut mengikuti waiver yang sama. Jika AVA tidak dapat membuktikan klasifikasi tersebut, AVA menahan jumlah yang harus dibayar dan belum terverifikasi untuk ditinjau staf. Saat penagihan pembayaran kamar diaktifkan, AVA memblokir pencarian reservasi dan mengarahkan tamu ke front desk.

Saat Mews mengembalikan waiver seluruh invoice, AVA menampilkan saldo yang harus dibayar sebesar nol. AVA tetap mempertahankan catatan deposit dan pembayaran untuk audit. Dengan begitu staf dapat meninjau apa yang ditagihkan, meskipun totalnya menjadi nol. Saat evaluasi live terverifikasi, evaluasi tersebut juga dapat menggantikan snapshot waiver yang sudah kedaluwarsa.

tip

Segarkan reservasi setelah Mews selesai melakukan sinkronisasi. Dengan begitu AVA mendapatkan catatan dan status invoice terbaru.

Pemecahan Masalah

Error "Access Token is required"

Yang Anda lihat: "Access Token is required"

Perbaikan:

1. Tempel Token ID dari Mews
2. Klik Save lagi
3. ✓ Error akan hilang setelah disimpan

Token Tersimpan tetapi Tidak Ada Data yang Tersinkron

Yang Anda lihat: Anda telah menyimpan token, tetapi reservasi tidak muncul

Perbaikan:

1. Tunggu 10-15 menit untuk sinkronisasi pertama
2. Segarkan halaman dan pastikan Mews masih dipilih
3. Minta admin Mews memastikan langganan AVA aktif
4. Hubungi dukungan AVA jika masalah berlanjut

Field yang Disamarkan Muncul Kembali Setelah Reload

Yang Anda lihat: Access Token atau field lanjutan menampilkan karakter yang disamarkan setelah Anda memuat ulang halaman.

Perbaikan:

1. Biarkan nilai yang disamarkan tetap seperti itu.
2. Klik Save lagi.
3. ✓ AVA mempertahankan kredensial Mews yang tersimpan.

Anda Tidak Dapat Menemukan Client Token, Client ID, atau Demo Mode

Yang Anda lihat: Anda tidak melihat field Client Token, Client ID, atau Demo Mode

Perbaikan:

1. Klik Advanced
2. ✓ Field lanjutan muncul di dalam bagian Advanced

Demo Mode Aktif, tetapi Sinkronisasi Tampak Salah

Yang Anda lihat: Reservasi hilang atau data pengujian tidak terduga

Perbaikan:

1. Matikan Demo Mode
2. Klik Save
3. Segarkan halaman dan periksa status koneksi Anda
4. Hubungi dukungan jika masalah berlanjut

Demo Mode Tidak Cocok Setelah Disimpan

Yang Anda lihat: Checkbox Demo Mode berubah setelah refresh, atau tidak cocok dengan pengaturan Mews yang tersimpan.

Perbaikan:

1. Buka Advanced.
2. Periksa nilai Demo Mode.
3. Simpan hanya perubahan yang Anda inginkan.
4. Segarkan halaman.
5. Hubungi dukungan jika checkbox masih tidak sesuai dengan konfigurasi Mews yang tersimpan.

Kamar Tidak Muncul dalam Room Changes

Yang Anda lihat: Kamar tidak ada di Allow move room.

Perbaikan:

1. Periksa reservasi di Mews.
2. Hapus room lock jika kamar seharusnya dapat dipindahkan.
3. Segarkan reservasi di AVA.
4. Coba room change lagi.

Penugasan Kamar Mews yang Diblokir

Yang Anda lihat: Check-in atau room change menampilkan "space is blocked" atau "room unavailable".

Perbaikan:

1. Tunggu AVA mencoba kamar bersih lainnya.
2. Tetapkan kamar lain di Mews jika tidak ada kamar bersih yang tersedia.
3. Segarkan AVA dan coba lagi.

Room List Masih Menampilkan Saldo Setelah Waiver

Yang Anda lihat: Room List masih menampilkan pembayaran setelah Mews seharusnya membebaskannya.

Perbaikan:

1. Periksa invoice lengkap reservasi di Mews.
2. Pastikan reservasi cocok dengan Accommodation Charge Policies.
3. Pastikan nilai kebijakan masih dikonfigurasi di AVA.
4. Segarkan reservasi setelah sinkronisasi Mews selesai.
5. Jangan menagih jumlah yang belum terverifikasi.
6. Minta staf front desk meninjau invoice.

Pembayaran Kamar Masih Harus Dibayar

Yang Anda lihat: Reservasi Mews masih meminta pembayaran kamar.

Mengapa ini terjadi: Waiver tidak cocok, atau AVA perlu memverifikasi klasifikasi penagihan.

Perbaikan:

1. Buka reservasi di Mews.
2. Periksa invoice lengkap.
3. Pastikan reservasi cocok dengan Accommodation Charge Policies.
4. Segarkan reservasi di AVA.
5. Jangan menagih jumlah yang belum terverifikasi.
6. Hubungi dukungan jika pembayaran masih muncul.

Produk Bundel Perlu Ditinjau

Yang Anda lihat: Produk Mews yang termasuk dalam tarif, seperti sarapan, perlu ditinjau penagihannya.

Mengapa ini terjadi: AVA tidak dapat membuktikan apakah produk tersebut termasuk dalam tarif yang dipesan.

Perbaikan:

1. Periksa produk yang termasuk dalam tarif dan invoice lengkap di Mews.
2. Pastikan reservasi cocok dengan suatu nilai dalam Accommodation Charge Policies.
3. Segarkan reservasi di AVA.
4. Jangan menagih jumlah yang belum terverifikasi.
5. Minta staf front desk meninjau invoice Mews lengkap.

Tamu Diarahkan ke Front Desk Saat Pencarian

Yang Anda lihat: Tamu melihat pesan peninjauan front desk setelah pencarian reservasi. Tamu tidak dapat melanjutkan ke langkah kamar atau pembayaran.

Mengapa ini terjadi: Kebijakan akomodasi yang dikonfigurasi cocok, tetapi Mews tidak dapat mengklasifikasikan suatu tagihan.

Perbaikan:

1. Tinjau tarif Mews, produk yang termasuk, dan invoice lengkap.
2. Pastikan nilai yang cocok ada di Settings → Payment → Accommodation Charge Policies.
3. Segarkan reservasi setelah Mews selesai melakukan sinkronisasi.
4. Konfirmasikan jumlah yang harus dibayar dengan invoice Mews lengkap.
5. Minta staf front desk menyelesaikan check-in jika peninjauan masih diperlukan.

AVA tidak menggunakan saldo tersimpan atau menagih jumlah yang belum terverifikasi.

Penagihan Mews Perlu Ditinjau

Yang Anda lihat: Saldo Mews yang ditampilkan berbeda dari invoice lengkap.

Mengapa ini terjadi: AVA tidak dapat membuktikan klasifikasi produk dalam waiver.

Perbaikan:

1. Buka reservasi melalui Staff Access.
2. Tinjau tarif reservasi, produk yang termasuk, dan invoice lengkap di Mews.
3. Pastikan kebijakan yang dikonfigurasi cocok dengan paket kamar.
4. Segarkan AVA setelah data Mews lengkap.
5. Tagih hanya jumlah yang dikonfirmasi sebagai harus dibayar oleh AVA dan Mews.
6. Hubungi dukungan AVA jika jumlahnya masih berbeda.

Alasan Waiver Tampak Salah

Yang Anda lihat: AVA membebaskan pembayaran kamar, tetapi teks alasannya tidak terduga.

Perbaikan:

1. Periksa catatan service order Mews yang cocok.
2. Pastikan teks catatan tersebut sesuai dengan yang Anda harapkan.
3. Ingat bahwa AVA hanya mencocokkan kata utuh.
4. Hubungi dukungan jika alasan waiver masih tampak salah.

Daftar Verifikasi

• Mews dipilih di Select PMS Provider
• Access Token dimasukkan dan disimpan tanpa error
• Field Access Token menampilkan karakter yang disamarkan setelah refresh
• Reservasi mulai tersinkron dari Mews

Masih Mengalami Kendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Sinkronisasi tidak dimulai setelah 15 menit
• ❌ Anda melihat error penyimpanan yang tidak dapat diselesaikan
• ❌ Anda memerlukan pengaturan Advanced tetapi tidak memiliki nilainya
• ❌ Saldo live masih tidak cocok dengan Mews setelah refresh
• ❌ Waiver penuh tidak menghapus saldo akomodasi
• ❌ Saldo yang ditampilkan berbeda dari invoice Mews lengkap

Sebaiknya sertakan:

• Screenshot bagian PMS Integration
• Provider PMS Anda (Mews)
• Teks error yang persis, jika ada
• Nomor konfirmasi reservasi
• Screenshot catatan Mews dan saldo AVA
• Waktu terakhir invoice disinkronkan

Panduan Terkait

• Koneksi PMS
• Integrasi Payment Gateway
• Mengelola Pembayaran Reservasi
• Error Koneksi PMS