Menyiapkan Integrasi PMS Mews

Penyiapan Cepat

Sebagian besar hotel cukup memasukkan Access Token. AVA menyediakan nilai lanjutan bila diperlukan. Proses ini membutuhkan waktu sekitar 10 menit.

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

Lokasi Pengaturan

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 integrasi yang diperlukan	Biasanya disediakan melalui deployment AVA
Advanced → Client ID	Pengidentifikasi klien Mews yang diperlukan	Biasanya disediakan melalui deployment AVA
Advanced → Demo Mode	Menggunakan endpoint sandbox untuk pengujian	Hanya untuk lingkungan pengujian
Reservation comments	Menarik catatan pesanan layanan Mews ke AVA	Saat AVA membaca reservasi atau menyegarkan 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.

Nilai lanjutan

Mews memerlukan Client Token dan Client ID. AVA biasanya menyediakannya melalui konfigurasi deployment. Jangan membuat nilai sendiri; tanyakan kepada dukungan jika field tersebut kosong.

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 informasi rahasia

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 penguncian kamar 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 pesanan layanan Mews ke komentar reservasi.
• ✅ Catatan yang cocok dapat membebaskan pembayaran kamar ketika invoice mengembalikan penanda waiver.
• ✅ AVA memuat detail invoice lengkap sebelum memeriksa waiver pada pembacaan reservasi tunggal.
• ✅ AVA menjaga kamar Mews yang belum ditetapkan tetap terlihat dalam pemesanan multi-kamar.
• ✅ Pembaruan profil tamu dapat memicu pengiriman ulang otomatis untuk mengejar email pre-arrival yang terlewat.
• ✅ Live billing Mews memeriksa ulang catatan kebijakan pembayaran 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.
• ✅ Aturan rate group Mews hanya berlaku untuk produk yang termasuk dalam rate group yang dipesan.
• ⚠️ Produk yang ditetapkan ke rate group lain tetap harus dibayar.
• ✅ Posting benefit Mews biasanya menggunakan malam menginap yang ditempati, sehingga posting 27 Agustus dapat muncul untuk sarapan 28 Agustus.
• ✅ Jadwal benefit pada hari yang sama secara eksplisit menggunakan tanggal penukaran yang diberikan, meskipun katalog produk tidak tersedia.
• ✅ Biaya layanan relatif terhadap kamar dapat mengikuti waiver paket kamar, bahkan ketika Mews melaporkannya sebagai Once tetapi mempostingnya setiap malam.
• ✅ Saldo positif hingga THB 0.01 disembunyikan ketika saldo tersebut hanya merupakan sisa pembulatan akomodasi setelah waiver.
• ⚠️ Biaya positif yang tidak terklasifikasi dan ekstra yang benar-benar dikenakan tetap harus dibayar, termasuk ekstra THB 0.01 yang benar-benar dikenakan.
• ⚠️ 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.
• Aturan rate group tetap terbatas pada cakupannya. AVA menyelesaikan rate group yang dipesan sebelum menerapkan aturan produk Mews yang cocok.
• Rate group lain tetap harus dibayar. Produk yang ditetapkan ke rate group lain tidak mengikuti waiver.
• Biaya layanan relatif terhadap kamar tetap termasuk. AVA mengenali biaya yang terkait dengan produk per malam kamar, bahkan ketika Mews melaporkannya sebagai Once tetapi mempostingnya setiap malam.
• 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 kunci di tampilan perubahan kamar.
• Catatan pesanan layanan 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 pengiriman ulang susulan. 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 pelanggan Mews yang terpisah. AVA hanya menggunakan kembali pelanggan jika nomor dokumen cocok dengan rekaman 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 rekaman 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 kebijakan pembayaran Mews.

AVA memeriksa catatan pesanan layanan Mews terbaru sebelum mengganti saldo tersimpan. AVA hanya melakukannya jika setidaknya satu daftar kebijakan pembayaran 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. Biaya layanan relatif terhadap kamar mengikuti waiver yang sama, bahkan ketika Mews melaporkannya sebagai Once tetapi mempostingnya setiap malam. Label Once saja tidak membuat biaya tambahan atau blokir peninjauan tagihan. Jika AVA tidak dapat membuktikan klasifikasi tersebut, AVA menahan jumlah yang harus dibayar tetapi belum terverifikasi untuk ditinjau staf. Saat penagihan pembayaran kamar diaktifkan, AVA memblokir pencarian reservasi dan mengarahkan tamu ke front desk.

Sisa Pembulatan Akomodasi yang Kecil

Setelah waiver akomodasi, Mews dapat menyisakan saldo positif THB 0.01 dari pembulatan biaya layanan setiap malam. AVA tetap membuat biaya yang tidak terklasifikasi dan ekstra yang benar-benar dikenakan dapat ditagih, termasuk ekstra THB 0.01 yang benar-benar dikenakan.

AVA memverifikasi produk pembulatan sebelum memperlakukannya sebagai akomodasi:

• Produk berasal dari pesanan layanan yang ditautkan ke reservasi kamar.
• Mews melaporkan penetapan harga Absolute dengan harga nol dan frekuensi Once.
• Produk menggunakan kategori akuntansi kamar.

Hanya baris produk yang terverifikasi yang mengikuti waiver akomodasi. Baris produk yang tidak terkait atau tidak terverifikasi tetap harus dibayar.

Periksa invoice Mews lengkap ketika Anda melihat saldo positif apa pun. Tagih saldo tersebut jika mencakup ekstra atau biaya yang tidak terklasifikasi.

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 Dimuat Ulang

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 dimuat ulang, 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 Perubahan Kamar

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

Perbaikan:

1. Periksa reservasi di Mews.
2. Hapus penguncian kamar jika kamar tersebut seharusnya dapat dipindahkan.
3. Segarkan reservasi di AVA.
4. Coba ubah kamar lagi.

Penetapan Kamar Mews Diblokir

Yang Anda lihat: Check-in atau perubahan kamar 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 lalu coba lagi.

Room List Masih Menampilkan Saldo Setelah Waiver

Yang Anda lihat: Room List masih menampilkan pembayaran padahal Mews seharusnya sudah memberikan waiver.

Mengapa ini terjadi: Saldo tersebut mungkin merupakan ekstra yang benar-benar dikenakan, biaya yang tidak terklasifikasi, atau lebih dari THB 0.01.

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.

Sisa akomodasi THB 0.01

AVA hanya menyembunyikan saldo positif THB 0.01 jika saldo tersebut merupakan sisa pembulatan akomodasi setelah waiver. Biaya THB 0.01 yang benar-benar dikenakan atau tidak terklasifikasi tetap harus dibayar.

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 tagihan.

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, seperti sarapan, memerlukan peninjauan tagihan.

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

Hal ini dapat terjadi ketika aturan Mews menggunakan rate group yang tidak dapat diselesaikan oleh AVA. Produk dari rate group lain tetap harus dibayar.

Biaya layanan relatif terhadap kamar

Biaya layanan yang terkait dengan produk per malam kamar seharusnya tidak perlu ditinjau hanya karena Mews melaporkannya sebagai Once. Jika peninjauan tetap diperlukan, periksa apakah ada produk lain yang tidak terklasifikasi atau ketidaksesuaian invoice.

Perbaikan:

1. Periksa produk yang termasuk dalam tarif dan invoice lengkap di Mews.
2. Pastikan reservasi cocok dengan 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 Dikirim 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 biaya.

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. Pastikan jumlah yang harus dibayar berdasarkan 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.

Tagihan Mews Perlu Ditinjau

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

Mengapa ini terjadi: AVA tidak dapat membuktikan klasifikasi produk untuk 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 dapat ditagih oleh AVA dan Mews.
6. Hubungi dukungan AVA jika jumlahnya masih berbeda.

Alasan Waiver Tampak Salah

Yang Anda lihat: AVA memberikan waiver pembayaran kamar, tetapi teks alasannya tidak sesuai dugaan.

Perbaikan:

1. Periksa catatan pesanan layanan 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 Periksa Verifikasi

• Mews dipilih di Select PMS Provider
• Access Token dimasukkan dan disimpan tanpa error
• Field Access Token menampilkan karakter yang disamarkan setelah dimuat ulang
• 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 Anda atasi
• ❌ Anda memerlukan pengaturan Advanced tetapi tidak memiliki nilainya
• ❌ Saldo live masih tidak cocok dengan Mews setelah dimuat ulang
• ❌ Waiver penuh tidak menghapus saldo akomodasi
• ❌ Saldo yang ditampilkan berbeda dari invoice Mews lengkap

Sebaiknya sertakan:

• Screenshot bagian PMS Integration
• Penyedia PMS Anda (Mews)
• Teks error yang tepat, 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