Kesalahan Koneksi PMS
Sebagian besar masalah koneksi memerlukan 5-10 menit untuk dikonfirmasi. Jika Anda melihat 429, tunggu waktu retry sebelum mencoba lagi.
Gunakan panduan ini ketika AVA tidak dapat terhubung ke PMS Anda atau menampilkan error rate-limit sementara.
AVA sekarang secara otomatis mencoba ulang beberapa request baca PMS jangka pendek. Anda mungkin tidak melihat error jaringan satu kali.
Jika AVA menampilkan error PMS tertentu saat refresh, gunakan pesan itu. Streamliner mempertahankan respons asli PMS alih-alih menggantinya dengan error teknis generik.
Pesan Error Umum
| Error | Arti | Tindakan |
|---|---|---|
| "Please fill all required PMS fields" | Kredensial wajib belum diisi | Tambahkan kredensial PMS yang belum ada |
| "Failed to save PMS Integration" | Error koneksi atau autentikasi | Periksa kembali akun dan izin PMS Anda |
| "Unable to communicate with the property management system" | Masalah jaringan atau API | Refresh sekali, lalu uji koneksi lagi |
| "429" atau "rate limited" | PMS meminta AVA melambat dan mencoba lagi nanti, dan AVA menampilkan waktu retry jika tersedia | Tunggu waktu retry, lalu coba lagi |
| "You don't have access to property ID" atau "success:false" | Cloudbeds memblokir properti atau mengembalikan kegagalan akses logis | Pastikan properti Cloudbeds yang dipilih benar, lalu tunggu satu menit sebelum mencoba lagi |
| "reservationOverlapTo must be greater than reservationOverlapFrom" | PMS menolak window overlap untuk stayover | Perbarui nilai overlap di PMS Anda, lalu refresh |
Gangguan Koneksi Sementara
Yang Anda lihat: Error koneksi satu kali, timeout, atau respons kosong.
Mengapa ini terjadi: AVA secara otomatis mencoba ulang beberapa request baca PMS jangka pendek.
Perbaikan:
-
Refresh halaman sekali.
-
Coba tindakan itu lagi.
-
Jika terus gagal, periksa koneksi PMS.
-
Jika error yang sama terus kembali, hubungi support.
✓ Gangguan sesaat sering hilang tanpa perubahan pengaturan.
Error Validasi PMS Saat Refresh
Yang Anda lihat: Pesan PMS muncul saat refresh stayover, misalnya reservationOverlapTo must be greater than reservationOverlapFrom.
Mengapa ini terjadi: PMS menolak request karena salah satu aturan validasinya gagal.
Perbaikan:
-
Baca pesan PMS yang persis.
-
Periksa pengaturan terkait di PMS Anda.
-
Koreksi nilai yang gagal validasi.
-
Refresh AVA sekali.
✓ Anda seharusnya hanya melihat pesan PMS asli sampai data PMS diperbaiki.
Koneksi Gagal
Yang Anda lihat: Pesan error saat klik Connect
Periksa Ini Terlebih Dahulu
-
Verifikasi kredensial sudah benar
- Periksa ulang API key atau client credentials Anda
- Pastikan tidak ada spasi tambahan sebelum atau sesudah kredensial
- Pastikan kredensial belum kedaluwarsa
-
Pastikan izin API tersedia
- Login ke portal admin PMS Anda
- Verifikasi akses API diaktifkan untuk akun Anda
- Periksa bahwa izin integrasi sudah diberikan
-
Periksa koneksi internet
- Coba refresh halaman
- Uji bagian AVA lain untuk memastikan konektivitas
Coba Ini
- Buka Settings → Essentials
- Klik Disconnect (jika sedang terhubung)
- Tunggu 30 detik
- Masukkan ulang kredensial Anda
- Klik Connect lagi
Batas Rate Tercapai
Yang Anda lihat: Error 429, pesan rate-limited, atau request yang menyertakan waktu retry.
Mengapa ini terjadi: PMS Anda sedang membatasi jumlah request sementara. AVA menyimpan waktu retry ketika PMS mengirimkannya. Jika Cloudbeds menampilkan error akses yang sama beberapa kali, AVA menunda retry berikutnya sebentar.
Perbaikan:
-
Tunggu waktu retry yang ditampilkan di error.
-
Refresh halaman sekali.
-
Coba tindakan itu lagi.
-
Jika masalah berulang, tunggu beberapa menit sebelum mencoba lagi.
-
Jika tidak ada waktu retry, anggap ini batas sementara yang singkat dan coba lagi nanti.
✓ Request seharusnya berhasil setelah PMS mengizinkan request baru.
Yang Anda lihat → Perbaikan
| Yang Anda lihat | Perbaikan |
|---|---|
| Error muncul sekali | Tunggu waktu retry, lalu coba lagi |
| Error terus kembali | Tunggu beberapa menit, lalu coba lagi |
| Reservasi tetap tidak dimuat | Periksa Sync Issues |
Reservasi Tidak Tersinkron
Yang Anda lihat: Tidak ada reservasi yang muncul setelah konek, atau reservasi hilang
Perbaikan Cepat
- Klik Refresh di Operations View
- Tunggu 5-10 menit sampai sinkronisasi awal selesai
- Verifikasi reservasi ada di PMS untuk tanggal hari ini
Periksa Pengaturan PMS
- Buka Settings → Essentials
- Scroll ke bagian PMS Integration
- Verifikasi status koneksi menampilkan "Connected"
- Pastikan pengaturan sinkronisasi dikonfigurasi dengan benar
Masih Belum Berhasil?
- Pastikan tanggal reservasi cocok dengan tanggal yang Anda lihat di AVA
- Periksa bahwa status reservasi di PMS mengizinkan sinkronisasi (confirmed, bukan cancelled)
- Pastikan jumlah tamu lebih dari 0
Keterlambatan Sinkronisasi
Yang Anda lihat: Reservasi muncul terlambat
Perilaku Normal
Sebagian besar sistem PMS melakukan sinkronisasi setiap 5-15 menit. Ketersediaan sinkronisasi real-time bergantung pada:
- Level paket PMS Anda
- Provider PMS yang spesifik
Kurangi Keterlambatan
- Gunakan refresh manual saat diperlukan
- Hubungi provider PMS Anda tentang akses API real-time
- Jadwalkan sinkronisasi saat periode aktivitas rendah
Error Autentikasi
Yang Anda lihat: "Invalid credentials" atau "Authentication failed"
Untuk Cloudbeds
- Login ke Cloudbeds
- Buka Settings → Integrations → API
- Buat kredensial API baru
- Salin kredensial persis (gunakan tombol copy jika tersedia)
- Tempel ke AVA tanpa perubahan
Untuk Opera Cloud
- Hubungi perwakilan Oracle Anda
- Minta refresh kredensial API
- Verifikasi URL environment sudah benar (test vs production)
Untuk Mews
- Login ke Mews Commander
- Buka Settings → Integrations
- Temukan Vouch AVA lalu regenerasi access token
- Perbarui token di pengaturan AVA
Kapan Menghubungi Support
Hubungi support jika:
- Anda sudah mencoba semua langkah pemecahan masalah
- Pesan error merujuk ke error sistem atau masalah teknis
- Perubahan PMS belum tercermin setelah 30 menit
Email: success@vouch-technologies.com
Sertakan:
- Screenshot pesan error
- Jenis PMS (Cloudbeds/Opera/Mews)
- Waktu masalah mulai terjadi
- Langkah yang sudah Anda coba