Kesalahan Koneksi PMS

Pemeriksaan Cepat

Sebagian besar masalah koneksi memerlukan 5-10 menit untuk dikonfirmasi. Jika Anda melihat 429, tunggu waktu retry sebelum mencoba lagi.

Gunakan panduan ini saat AVA tidak dapat terhubung, menampilkan batas sementara, atau melaporkan penolakan PMS.

Retry Otomatis

AVA sekarang otomatis mencoba ulang beberapa request baca PMS jangka pendek, termasuk satu batas rate pencarian reservasi jangka pendek. Request baca Mews yang mengembalikan 408 juga menggunakan jalur percobaan ulang baca. Request Mews menggunakan jendela percobaan ulang terbatas, sehingga PMS yang lambat tidak membuat Housekeeping menunggu tanpa batas. Opera OAuth juga mencoba ulang satu timeout atau error gateway sementara. Selama check-in, AVA mencoba ulang konflik reservasi sementara dan batas rate PMS saat pencarian reservasi, penetapan kamar, dan check-in akhir. Pembaruan tamu Opera juga mencoba ulang penguncian reservasi sementara. Request pemulihan Mews otomatis mencoba ulang 403 konflik operasi sementara. Percobaan ulang ini dapat menambah beberapa detik sebelum AVA menampilkan error. Anda mungkin tidak melihat error jaringan yang hanya terjadi sekali. Kegagalan kredensial webhook Cloudbeds tidak dicoba ulang secara otomatis.

Pesan PMS yang Dipertahankan

Jika AVA menampilkan error PMS tertentu saat refresh, gunakan pesan tersebut. Streamliner mempertahankan respons asli PMS alih-alih menggantinya dengan error teknis generik.

Pesan Error Umum

Error	Arti	Lakukan Ini
"Please fill all required PMS fields"	Ada field wajib yang belum diisi untuk PMS yang dipilih	Lengkapi field wajib yang ditampilkan untuk provider tersebut
"Failed to save PMS Integration"	Error koneksi atau autentikasi	Periksa kembali akun dan izin PMS Anda
"Failed to save settings before connecting"	Pengaturan Essentials lain gagal sebelum OAuth dimulai	Baca pesan lengkapnya, perbaiki pengaturan tersebut, lalu hubungkan lagi
"Unable to communicate with the property management system"	Masalah jaringan atau API	Refresh sekali, lalu uji koneksi lagi
PMS_TEMPORARILY_UNAVAILABLE	PMS tidak menjawab selama penetapan kamar	Periksa PMS, tunggu sebentar, lalu coba ulang penetapan kamar sekali
PMS_ROOM_UNAVAILABLE	Kamar yang dipilih tidak tersedia untuk masa menginap tersebut	Pilih kamar atau tanggal lain, refresh AVA, lalu coba ulang sekali
PMS_RESERVATION_NO_AVAILABILITY	Tidak ada kamar dari tipe yang dipilih yang tersedia untuk masa menginap tersebut	Pilih tipe kamar atau tanggal lain, refresh AVA, lalu coba ulang sekali
"Self check-in is not available at this property right now"	Properti belum disiapkan untuk check-in tamu	Minta administrator menghubungkan PMS atau menyelesaikan penyiapan AVA PMS
"429" atau "rate limited"	PMS atau budget request AVA sendiri meminta Anda mencoba lagi nanti	Tunggu saat AVA mencoba ulang tindakan check-in, atau ikuti waktu retry yang ditampilkan
"409" atau "Conflict"	PMS menolak tindakan karena status reservasi atau request tidak diizinkan	Baca alasan dari PMS, perbaiki reservasi, lalu coba ulang sekali
"403" dengan "Conflicting operation is being performed"	Mews sedang memproses operasi lain untuk sementara	Tunggu sebentar saat AVA mencoba ulang, lalu coba ulang langkah yang terdampak jika perlu
PMS_RESERVATION_MUTATION_IN_PROGRESS	Pembaruan reservasi PMS singkat bertumpang tindih dengan penetapan kamar atau check-in akhir	Tunggu sebentar, refresh reservasi, lalu coba ulang langkah yang terdampak sekali
PMS_ROOM_ASSIGNMENT_OUTCOME_UNKNOWN	PMS mungkin telah mengubah kamar, tetapi AVA tidak dapat memverifikasi penetapan akhir	Jangan mencoba lagi; verifikasi kamar dan tarif di PMS, lalu gunakan refresh kamar eksplisit sebelum menyerahkan kunci
"Cannot check in reservation because assigned space is blocked"	Mews memblokir ruang yang ditetapkan	Tetapkan ruang yang tersedia di Mews, lalu coba ulang check-in
"Assigned space is not available for check-in"	Mews memerlukan ruang yang sudah diperiksa sebelum check-in	Tetapkan ruang yang sudah diperiksa di Mews, lalu coba ulang check-in
"502" atau "Bad Gateway"	Cloudbeds, Opera, atau PMS lain gagal saat membaca atau menulis	Baca penyebabnya, refresh sekali, lalu coba ulang tindakan tersebut
"ava-pms returned 500 with an HTML error page"	Gateway upstream mengembalikan halaman web sementara, bukan respons PMS	Refresh sekali, lalu periksa PMS dan hubungi dukungan jika error kembali
"503" atau "Service Unavailable"	PMS atau layanan jaringan untuk sementara tidak dapat menyelesaikan request	Periksa status PMS, refresh sekali, lalu coba ulang tindakan tersebut
Mews API Error: Transaction has timed out.	Mews tidak menyelesaikan pembacaan inventaris sebelum jendela percobaan ulang berakhir	Periksa Mews, refresh Housekeeping, lalu hubungi dukungan jika terus berlanjut
504 Mews view-billing deadline exceeded	Detail penagihan Mews tidak tiba sebelum batas baca penagihan AVA	Tinjau saldo tersimpan, bandingkan dengan Mews, lalu refresh sekali
"non-reservations payload"	eZee mengembalikan situs web atau respons lain, bukan data reservasi	Periksa eZee Base URL dan biarkan kosong untuk API standar
"Unsupported Cloudbeds version"	Request memilih Cloudbeds v1 atau v2 yang sudah dihentikan	Hapus pin versi, lalu mulai koneksi baru
"You don't have access to property ID"	Cloudbeds memblokir properti	Pastikan properti Cloudbeds yang benar, lalu coba lagi setelah akses dipulihkan
"success:false" tanpa pesan aplikasi terputus	Cloudbeds mengembalikan kegagalan khusus provider	Baca pesan lengkapnya, lalu ikuti langkah pemulihan Cloudbeds yang relevan
"Application is not available to be connected"	Properti memutuskan aplikasi AVA di Cloudbeds	Otorisasi ulang Cloudbeds untuk properti tersebut, lalu coba lagi
"webhook credentials rejected"	Cloudbeds menerima login tetapi menolak penyiapan webhook	Hubungkan ulang Cloudbeds dan simpan pengaturannya lagi
"PMS cache unavailable" atau error invalidasi cache	AVA tidak dapat mengonfirmasi pengaturan PMS baru di seluruh layanannya	Tunggu satu menit, lalu simpan lagi; hubungi dukungan jika berulang
Penyimpanan pengaturan gagal setelah sebagian pekerjaan selesai	Langkah lanjutan atau refresh cache gagal setelah penulisan lain selesai	Periksa PMS sebelum mencoba lagi, lalu refresh AVA
"Configuration is temporarily unavailable"	Command Center tidak dapat mengambil konfigurasi hotel secara lengkap	Refresh, login lagi jika diminta, lalu minta administrator memeriksa akses
611 atau "Invalid Auth Code or Hotel Code"	eZee menolak snapshot kredensial lama setelah perubahan kredensial	Simpan Hotel Code dan Auth Code yang sesuai, lalu coba ulang sekali
"reservationOverlapTo must be greater than reservationOverlapFrom"	PMS menolak jendela overlap 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 otomatis mencoba ulang beberapa request baca PMS jangka pendek. AVA juga mencoba ulang satu kegagalan Opera OAuth sementara. Timeout atau error gateway dapat memerlukan waktu sebelum error ditampilkan saat AVA mencoba ulang. Percobaan ulang Mews berhenti dalam jendela yang terbatas, bukan berlanjut melalui rangkaian percobaan ulang yang panjang. Di Opera, pembacaan atau penulisan housekeeping yang terputus dapat muncul sebagai 502.

Perbaikan:

1. Refresh halaman sekali.

2. Coba tindakan itu lagi.

3. Jika terus gagal, periksa koneksi PMS.

4. Jika error yang sama terus muncul, hubungi dukungan.

   ✓ Gangguan sesaat sering hilang tanpa perubahan pengaturan.

Command Center Tidak Dapat Memverifikasi Konfigurasi

Yang Anda lihat: Command Center menampilkan Configuration is temporarily unavailable.

Mengapa ini terjadi: AVA tidak dapat mengambil konfigurasi lengkap hotel. Penyebabnya mungkin akses yang belum tersedia atau gangguan konfigurasi upstream sementara. AVA tidak menganggap kegagalan ini sebagai penyiapan PMS yang belum lengkap.

Perbaikan:

1. Refresh Command Center sekali.

2. Login lagi jika AVA meminta Anda melakukannya.

3. Minta administrator mengonfirmasi akses Anda ke konfigurasi hotel.

4. Coba lagi nanti jika layanan sedang tidak tersedia.

5. Hubungi dukungan jika pemberitahuan tersebut terus muncul.

   ✓ Pesan penyiapan PMS hanya muncul setelah AVA berhasil mengambil konfigurasi lengkap.

PMS Tidak Tersedia Sementara Selama Penetapan Kamar

Yang Anda lihat: Penetapan kamar menampilkan pesan PMS tidak tersedia sementara.

Mengapa ini terjadi: PMS tidak menjawab request penetapan kamar tepat waktu. Untuk Cloudbeds, AVA juga memvalidasi okupansi langsung untuk setiap kamar yang cocok dan setiap segmen tanggal menginap. AVA mencatat percobaan tersebut sebagai dapat dicoba ulang dan tidak memutar ulang mutasi secara otomatis.

Perbaikan:

1. Periksa status PMS dan buka reservasi di sana.

2. Pastikan penetapan kamar belum selesai sebelum mencoba lagi.

3. Refresh reservasi di AVA.

4. Coba ulang penetapan kamar sekali.

   ✓ AVA seharusnya menetapkan kamar atau menampilkan alasan kesiapan kamar yang spesifik.

Untuk pemesanan multi-room Cloudbeds, coba lagi setelah error sementara hanya jika status reservasi dan kamar terlihat benar. AVA kemudian seharusnya mengevaluasi kamar dan tanggal menginap yang terdampak sebelum menetapkannya.

AVA tidak mengirim email kamar belum siap untuk gangguan ini. Slot notifikasi tetap tersedia jika pemeriksaan berikutnya mengonfirmasi bahwa kamar belum siap.

Jangan mengulangi penulisan yang hasilnya belum jelas

Periksa reservasi di PMS Anda sebelum mencoba ulang tindakan apa pun yang hasilnya belum jelas.

Request PMS Memerlukan Waktu Terlalu Lama

Yang Anda lihat: Tindakan PMS menunggu, lalu menampilkan timeout atau error koneksi.

Mengapa ini terjadi: AVA berhenti menunggu setelah 60 detik untuk request tanpa batas waktu yang lebih ketat. Beberapa pembacaan reservasi dan kapabilitas menggunakan batas waktu yang lebih singkat. Pembacaan penagihan Mews menggunakan batas waktu 40 detik dengan percobaan yang lebih singkat. Hal ini mencegah satu respons PMS yang lambat membuat tindakan reservasi tetap terbuka tanpa batas.

Perbaikan:

1. Tunggu hingga pesan timeout muncul.

2. Refresh reservasi atau halaman sebelum mencoba lagi.

3. Periksa reservasi di PMS Anda sebelum mengulangi tindakan penulisan.

4. Coba ulang tindakan tersebut sekali.

5. Hubungi dukungan jika timeout kembali muncul.

   ✓ Tindakan PMS seharusnya selesai atau mengembalikan error yang jelas dalam waktu sekitar satu menit.

Periksa sebelum mencoba lagi

Jangan mengulangi pembaruan reservasi saat hasilnya belum jelas. Pastikan status reservasi di PMS Anda terlebih dahulu, lalu coba ulang sekali.

Refresh penagihan Mews mencapai batasnya

Yang Anda lihat: AVA menampilkan 504 Mews view-billing deadline exceeded selama self check-in atau refresh penagihan.

Mengapa ini terjadi: Mews tidak mengembalikan detail penagihan terbaru sebelum batas baca penagihan. AVA dapat menampilkan snapshot penagihan tersimpan agar alur check-in tidak menunggu tanpa batas.

Perbaikan:

1. Bandingkan saldo yang ditampilkan dengan faktur lengkap di Mews.

2. Refresh reservasi di AVA sekali.

3. Jangan menagih jumlah yang tidak dikonfirmasi Mews.

4. Minta staf front desk menyelesaikan check-in jika saldo tetap tidak jelas.

5. Hubungi dukungan jika timeout terus muncul.

   ✓ Penundaan penagihan Mews sementara seharusnya menghasilkan hasil yang jelas, bukan membuat check-in terus menunggu.

Pembacaan housekeeping Mews mengalami timeout

Yang Anda lihat: Housekeeping menampilkan timeout Mews, seperti Transaction has timed out.

Mengapa ini terjadi: Mews tidak menyelesaikan pembacaan inventaris sebelum jendela percobaan ulang terbatas AVA berakhir. AVA sekarang menampilkan penyebab dari Mews, bukan mengembalikan daftar kamar kosong atau menyesatkan.

Perbaikan:

1. Periksa Mews Commander untuk gangguan aktif atau respons yang lambat.

2. Refresh Housekeeping setelah Mews merespons secara normal.

3. Jangan menganggap daftar kamar kosong sebagai bukti bahwa kamar tidak tersedia.

4. Hubungi dukungan jika timeout berlanjut setelah Mews pulih.

   ✓ Housekeeping seharusnya memuat inventaris kamar terbaru setelah pembacaan Mews berhasil.

Posting pembayaran direct-sale belum pasti

Yang Anda lihat: Pembayaran direct-sale mengalami timeout, atau AVA tidak dapat mengonfirmasi posting ke PMS.

Mengapa ini terjadi: PMS mungkin telah menerima request sebelum timeout muncul. AVA melindungi pembayaran yang telah dikirim dan pembayaran yang hasilnya belum pasti dari posting ganda.

Perbaikan:

1. Buka reservasi di PMS Anda.

2. Periksa apakah pembayaran sudah muncul di folio yang benar.

3. Jangan kirim pembayaran lagi saat hasilnya belum pasti.

4. Refresh AVA setelah mengonfirmasi hasil di PMS.

5. Hubungi dukungan untuk rekonsiliasi jika pembayaran tidak ada atau hasilnya tidak jelas.

   ✓ Kegagalan persiapan sebelum pengiriman dapat dipulihkan melalui notifikasi pembayaran berikutnya.

Jangan posting pembayaran kedua secara manual

Respons PMS yang belum pasti tidak membuktikan bahwa pembayaran gagal. Tunggu rekonsiliasi sebelum mencoba lagi.

Pembacaan PMS menggunakan fallback

Yang Anda lihat: AVA melanjutkan dengan detail yang lebih sedikit setelah pembacaan PMS memerlukan waktu terlalu lama.

Mengapa ini terjadi: Pembacaan tertentu gagal secara terbuka agar alur tamu atau staf dapat terus berjalan. Fallback dapat menampilkan reservasi yang belum diperkaya atau hasil pencarian yang lebih sederhana. Pembacaan kapabilitas dapat sementara melaporkan fitur sebagai tidak tersedia.

Yang Anda lihat	Mengapa ini terjadi	Perbaikan
Detail reservasi tampak tidak lengkap	Detail tipe kamar tidak dikembalikan tepat waktu	Refresh reservasi dan coba lagi
Pencarian staf menampilkan lebih sedikit detail tamu	Pencarian profil menggunakan fallback nama reservasi	Cari lagi setelah refresh halaman
Alur yang bergantung pada tanggal menampilkan tanggal yang salah	Tanggal bisnis PMS tidak dikembalikan tepat waktu	Refresh, lalu konfirmasi tanggal bisnis di PMS Anda
Group Checkout tidak tersedia	Data kapabilitas tidak tersedia selama pembacaan	Refresh, lalu periksa koneksi PMS
Perpindahan kamar yang didukung ditolak	AVA tidak dapat mengonfirmasi kapabilitas yang diperlukan	Refresh, lalu coba ulang sekali

Periksa PMS sebelum mengulangi penulisan

Fallback ini berlaku untuk pembacaan. Jika penulisan mengalami timeout, periksa PMS sebelum mencoba ulang.

Error Opera Menampilkan Penyebab dari Upstream

Yang Anda lihat: Tindakan Opera menampilkan "Bad Gateway" atau "Service Unavailable (503)".

Mengapa ini terjadi: Opera atau gateway-nya mengembalikan respons error non-JSON. AVA menampilkan teks respons singkat jika tersedia, atau status HTTP jika teksnya kosong.

Perbaikan:

1. Baca pesan error lengkap dan catat kode statusnya.
2. Jika Anda sedang menambahkan sharer, periksa Opera sebelum mencoba lagi.
3. Untuk tindakan lain, refresh AVA sekali, lalu coba lagi.
4. Periksa Opera dan AVA jika error yang sama kembali muncul.
5. Hubungi dukungan jika error berlanjut.

Periksa sharer sebelum mencoba lagi

AVA mencatat progres pembuatan sharer di Opera. Saat semua tamu sudah check-in dan tidak ada perpindahan kamar yang tertunda, AVA mengembalikan hasil tanpa pembaruan Opera lainnya. Perpindahan kamar yang tertunda tetap dapat direkonsiliasi. Tunggu sebentar, refresh AVA, dan periksa Opera sebelum mencoba lagi. Jangan membuat sharer lain secara manual saat hasilnya belum jelas.

Penyalinan pembayaran sharer Opera belum jelas

Yang Anda lihat: Sharer ada, tetapi AVA tidak dapat mengonfirmasi metode pembayaran yang disalin.

Mengapa ini terjadi: Request penyalinan pembayaran Opera menambahkan metode tersebut ke reservasi sharer. Request tersebut mungkin sudah sampai ke Opera sebelum timeout atau error jaringan muncul. AVA hanya membuka kembali kegagalan sebelum pengiriman yang telah dikonfirmasi dan penolakan Opera secara eksplisit. Hasil yang belum jelas tetap dikarantina untuk mencegah metode pembayaran ganda.

Perbaikan:

1. Refresh AVA sekali.

2. Buka reservasi sharer di Opera.

3. Pastikan apakah metode pembayaran yang disalin sudah ada.

4. Jangan mengulangi penyalinan pembayaran jika hasil Opera belum jelas.

5. Hubungi dukungan dengan detail reservasi dan pesan error lengkap.

   ✓ Kegagalan yang telah dikonfirmasi dapat dicoba ulang dengan aman pada operasi sharer berikutnya.

Periksa Opera sebelum mencoba lagi

Jangan menambahkan metode pembayaran secara manual setelah timeout. Opera mungkin telah menerima request awal.

AVA-PMS Menampilkan Ringkasan Error HTML

Yang Anda lihat: AVA menampilkan pesan seperti ava-pms returned 500 with an HTML error page: 502 Bad Gateway.

Mengapa ini terjadi: Gateway upstream mengembalikan halaman error HTML selama request PMS. AVA mempertahankan judul halaman, tetapi menghapus markup halaman web dari error tersebut.

Perbaikan:

1. Refresh AVA sekali.

2. Periksa reservasi dan PMS sebelum mengulangi pembaruan reservasi.

3. Coba ulang tindakan tersebut sekali setelah mengonfirmasi status PMS.

4. Hubungi dukungan jika pesan tersebut kembali muncul.

   ✓ Error seharusnya menampilkan ringkasan singkat, bukan halaman web.

Penolakan PMS Ditampilkan sebagai Konflik

Yang Anda lihat: Sebuah tindakan menampilkan 409, "Conflict", atau penolakan PMS tertentu. Error tersebut tidak lagi muncul sebagai error server generik.

Mengapa ini terjadi: PMS Anda menolak tindakan karena aturan reservasi gagal. AVA mempertahankan status dan pesan upstream agar Anda dapat memperbaiki penyebabnya. Sebagian besar respons 409 bersifat permanen untuk request tersebut. Kode PMS_RESERVATION_MUTATION_IN_PROGRESS merupakan pengecualian sementara selama pembaruan tamu, penetapan kamar, atau check-in akhir.

Perbaikan:

1. Baca pesan PMS lengkap.

2. Buka reservasi di PMS Anda.

3. Perbaiki masalah yang disebutkan dalam pesan.

4. Untuk penolakan pembatalan, periksa apakah tamu sudah check-in, due out, atau check-out.

5. Selesaikan langkah check-out yang diperlukan di PMS sebelum mencoba ulang pembatalan tamu yang sedang menginap.

6. Refresh AVA.

7. Coba ulang tindakan tersebut sekali.

8. Jika PMS masih menolak, selesaikan tindakan di PMS Anda dan hubungi dukungan.

   ✓ AVA seharusnya menampilkan status reservasi yang diperbarui setelah PMS menerima tindakan tersebut.

Penolakan Ketersediaan PMS

Yang Anda lihat: Perpindahan kamar atau pengeditan reservasi menyatakan bahwa kamar atau tipe kamar tidak tersedia. Pesan tersebut mungkin menyertakan PMS_ROOM_UNAVAILABLE atau PMS_RESERVATION_NO_AVAILABILITY.

Mengapa ini terjadi: PMS menemukan konflik ketersediaan langsung. Reservasi lain, blokir kamar yang tidak dapat dijual, atau pemesanan yang sedang berlangsung mungkin menggunakan kamar tersebut. Tipe kamar tersebut juga mungkin tidak memiliki inventaris tersisa untuk seluruh masa menginap.

Perbaikan:

1. Buka reservasi di PMS Anda.

2. Periksa tanggal menginap, kamar yang ditetapkan, dan tipe kamar.

3. Pilih kamar atau tipe kamar yang tersedia jika diperlukan.

4. Refresh Streamliner.

5. Coba ulang perpindahan kamar atau pengeditan reservasi sekali.

   ✓ AVA mempertahankan penetapan awal ketika PMS menolak tujuan perpindahan.

AVA menampilkan penjelasan yang dilokalkan dalam modal perubahan kamar, detail reservasi, dan log check-in. Untuk pertukaran kamar, AVA memindahkan reservasi tujuan kembali sebelum memulihkan reservasi sumber. Hal ini mencegah pertukaran yang gagal membuat salah satu reservasi tetap berada di kamar yang keliru.

Jangan mengulangi perubahan yang tidak tersedia

Mengirim tanggal atau kamar yang sama dan tidak tersedia berulang kali dapat menghasilkan penolakan yang sama. Perbaiki ketersediaan di PMS terlebih dahulu, lalu coba ulang sekali.

Hasil Penetapan Cloudbeds Tidak Diketahui

Yang Anda lihat: Perpindahan atau peningkatan kamar Cloudbeds menyatakan bahwa hasil penetapan tidak diketahui.

Mengapa ini terjadi: Cloudbeds mungkin menerima perpindahan kamar tanpa mengembalikan respons lengkap. AVA menghapus status kamar dan akses yang belum terverifikasi, alih-alih menampilkan penetapan lama. AVA menjeda pembacaan latar belakang sampai refresh eksplisit memverifikasi hasil di PMS.

Perbaikan:

1. Jangan memilih kamar atau rencana pertukaran yang sama lagi.

2. Buka setiap pemesanan yang terdampak di Cloudbeds.

3. Verifikasi nomor kamar, tipe kamar, tanggal, tarif per malam, dan total masa menginap.

4. Gunakan refresh kamar eksplisit di AVA.

5. Jangan menyerahkan kunci sampai AVA menampilkan kamar yang dikonfirmasi PMS.

6. Hubungi dukungan jika nilai kamar atau keuangan masih belum jelas.

   ✓ AVA dapat menghapus penetapan lama setelah status PMS dikonfirmasi.

Jangan mencoba ulang hasil yang tidak diketahui

Mencoba ulang dapat membuat perpindahan kamar lain saat perpindahan pertama masih belum terselesaikan. Verifikasi Cloudbeds terlebih dahulu, lalu gunakan refresh kamar eksplisit.

Mutasi Reservasi Masih Berlangsung

Yang Anda lihat: Pembaruan tamu, penetapan kamar, atau check-in akhir menampilkan PMS_RESERVATION_MUTATION_IN_PROGRESS.

Mengapa ini terjadi: Pembaruan reservasi PMS untuk sementara sedang menguasai reservasi tersebut. Hal ini dapat terjadi setelah verifikasi tamu, unggahan paspor, unggahan dokumen, atau pembaruan reservasi lainnya. Untuk check-in akhir Opera, penetapan kamar mungkin sudah berhasil sebelum penguncian muncul. AVA mencoba ulang konflik yang sama persis ini hingga empat kali dengan jeda singkat.

Perbaikan:

1. Tunggu sebentar hingga pembaruan PMS selesai.

2. Refresh reservasi di AVA.

3. Coba ulang langkah yang terdampak sekali.

   ✓ Langkah yang terdampak seharusnya berlanjut setelah pembaruan reservasi selesai.

Jika kode tetap muncul setelah empat percobaan, AVA menghentikan penulisan dan mengembalikan konflik yang dapat dicoba ulang. Periksa reservasi di PMS Anda sebelum mencoba lagi. Hubungi dukungan jika konflik terus berlanjut. Sertakan nomor reservasi, provider PMS, dan pesan error lengkap.

Konflik operasi Mews sedang dicoba ulang

Yang Anda lihat: Mews mengembalikan 403 dengan "Conflicting operation is being performed at this time."

Mengapa ini terjadi: Mews mengunci reservasi sebentar selama operasi lain. Respons ini tidak berarti Mews menerapkan tindakan yang ditolak. AVA menunggu sebentar dan otomatis mencoba ulang request pemulihan.

Perbaikan:

1. Tunggu hingga tindakan AVA saat ini selesai.

2. Periksa reservasi di Mews jika tindakan tersebut masih menampilkan error.

3. Refresh AVA dan coba ulang langkah check-in yang terdampak sekali.

   ✓ Perpindahan tamu atau pemulihan check-in seharusnya berlanjut setelah Mews melepaskan penguncian.

Hubungi dukungan jika pesan yang sama terus muncul setelah percobaan ulang.

Status check-in Mews berubah

Yang Anda lihat: Mews menolak check-in karena reservasi tidak lagi Confirmed.

Mengapa ini terjadi: Pembaruan Mews lain mengubah reservasi saat AVA memulai check-in. AVA memeriksa reservasi yang tepat satu kali sebelum menentukan bahwa tindakan tersebut gagal.

Perbaikan:

1. Tunggu hingga tindakan AVA saat ini selesai.

2. Jika reservasi berstatus Started dan memiliki kamar yang ditetapkan, lanjutkan dengan kamar yang ditampilkan.

3. Jika reservasi tidak berstatus Started, refresh AVA dan periksa reservasi di Mews.

4. Coba ulang check-in hanya jika Mews menunjukkan bahwa reservasi siap.

   ✓ AVA tidak mengulangi check-in jika Mews sudah memulai reservasi.

Hubungi dukungan jika reservasi memiliki kamar yang ditetapkan tetapi AVA masih melaporkan error.

Mews Menolak Ruang yang Ditetapkan

Yang Anda lihat: Mews menyatakan bahwa ruang yang ditetapkan diblokir atau tidak tersedia untuk check-in.

Mengapa ini terjadi: Mews menerapkan aturan kesiapan kamar selama check-in. Ruang yang ditetapkan mungkin diblokir atau belum diperiksa.

Perbaikan:

1. Buka reservasi di Mews.

2. Tetapkan ruang yang tersedia.

3. Pastikan ruang tersebut sudah diperiksa jika diwajibkan Mews.

4. Refresh reservasi di AVA.

5. Coba ulang check-in sekali.

   ✓ AVA seharusnya menyelesaikan check-in setelah Mews menerima ruang yang ditetapkan.

Hubungi dukungan jika Mews menampilkan ruang yang tersedia dan sudah diperiksa tetapi tetap menolak check-in.

Opera Menolak Nilai Gender yang Tidak Dikenal

Yang Anda lihat: Opera sebelumnya menampilkan Value N/A for field Gender exceeds the maximum length allowed.

Mengapa ini terjadi: Kode gender Opera berbeda menurut properti. Nilai seperti N/A bukan kode yang valid untuk beberapa properti.

Perbaikan:

1. Coba ulang pembaruan tamu di AVA.

2. AVA menghapus placeholder yang tidak dikenal sebelum mengirim pembaruan.

3. AVA mempertahankan gender valid yang tersimpan ketika nilai baru tidak dikenal atau kosong.

4. Hubungi dukungan jika Opera tetap menolak pembaruan tamu.

   ✓ Gender Opera valid yang tersimpan seharusnya tetap tidak berubah kecuali Anda memberikan kode yang sebenarnya.

Error Validasi PMS Saat Refresh

Yang Anda lihat: Pesan PMS muncul saat refresh stayover, seperti reservationOverlapTo must be greater than reservationOverlapFrom.

Mengapa ini terjadi: PMS menolak request karena salah satu aturan validasinya gagal.

Perbaikan:

1. Baca pesan PMS yang persis.

2. Periksa pengaturan terkait di PMS Anda.

3. Koreksi nilai yang gagal divalidasi.

4. Refresh AVA sekali.

   ✓ Anda seharusnya hanya melihat pesan PMS asli sampai data PMS diperbaiki.

---

Koneksi Gagal

Yang Anda lihat: Pesan error saat mengklik Connect

Periksa Ini Terlebih Dahulu

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

2. Konfirmasi izin API

   • Login ke portal admin PMS Anda
   • Verifikasi akses API diaktifkan untuk akun Anda
   • Periksa bahwa izin integrasi telah diberikan

3. Periksa koneksi internet

   • Coba refresh halaman
   • Uji bagian AVA lainnya untuk memastikan konektivitas

Coba Ini

1. Buka Settings → Essentials
2. Klik Disconnect (jika sedang terhubung)
3. Tunggu 30 detik
4. Masukkan ulang kredensial Anda
5. Klik Connect lagi

Penyimpanan Cloudbeds gagal sebelum OAuth

Yang Anda lihat: "Failed to save settings before connecting: ..."

Mengapa ini terjadi: AVA menyimpan perubahan Essentials lain yang belum disimpan sebelum memulai OAuth Cloudbeds. Pesan terperinci mengidentifikasi pengaturan yang gagal.

Perbaikan:

1. Baca banner error lengkap.

2. Perbaiki pengaturan yang disebutkan dalam pesan.

3. Simpan pengaturan tersebut jika AVA menampilkan tindakan simpan.

4. Pilih Connect to Cloudbeds lagi.

   ✓ Cloudbeds akan terbuka setelah penyimpanan sebelum koneksi berhasil.

Pertukaran OAuth Cloudbeds gagal

Yang Anda lihat: Koneksi menampilkan Version is required atau menolak pertukaran kode otorisasi.

Mengapa ini terjadi: Kode otorisasi Cloudbeds hanya dapat digunakan sekali. Callback yang gagal tidak dapat diputar ulang. AVA sekarang menetapkan versi OAuth Cloudbeds yang tidak dicantumkan ke v3 secara default.

Perbaikan:

1. Buka Settings → Essentials.

2. Pilih Connect to Cloudbeds.

3. Login ke Cloudbeds dan pilih Authorize atau Allow.

4. Selesaikan koneksi. Cloudbeds membuat kode otorisasi baru.

5. Hubungi dukungan jika koneksi baru kembali gagal.

   ✓ Koneksi Cloudbeds seharusnya selesai tanpa meminta Anda memasukkan versi.

Cloudbeds v1 atau v2 ditolak

Yang Anda lihat: AVA menampilkan error versi Cloudbeds yang tidak didukung.

Mengapa ini terjadi: Adaptor Cloudbeds v1 dan v2 sudah dihentikan. Perutean Cloudbeds tanpa versi menggunakan v3.

Perbaikan:

1. Hapus pengaturan atau pin versi Cloudbeds yang eksplisit.

2. Minta administrator integrasi Anda menghapus pin pemanggil v1 atau v2.

3. Buka Settings → Essentials.

4. Pilih Connect to Cloudbeds dan selesaikan otorisasi lagi.

   ✓ Koneksi baru menggunakan Cloudbeds v3.

Penyimpanan Pengaturan PMS Tidak Selesai

Yang Anda lihat: AVA menerima detail PMS Anda, lalu menampilkan error cache atau layanan.

Mengapa ini terjadi: AVA menyimpan pengaturan terkait dalam langkah-langkah yang saling bergantung. Satu langkah dapat selesai sebelum langkah lain atau refresh cache gagal. PMS mungkin menerima penulisan meskipun AVA melaporkan error.

Perbaikan:

1. Buka PMS dan periksa apakah kredensial atau pengaturan provider yang diubah telah diterima.

2. Tunggu satu menit sebelum mencoba lagi.

3. Refresh Settings → Essentials → PMS Integration.

4. Biarkan kredensial yang disamarkan apa adanya kecuali Anda sedang menggantinya.

5. Klik Save lagi hanya jika PMS masih memerlukan perubahan tersebut.

6. Konfirmasi pesan sukses sebelum menggunakan alur kerja yang ditenagai PMS.

   ✓ Kredensial baru seharusnya berfungsi di seluruh server AVA setelah penyimpanan berhasil.

Periksa sebelum mencoba lagi

AVA tidak otomatis membatalkan atau mencoba ulang setiap penulisan pengaturan. Menyimpan ulang tanpa memeriksa PMS dapat mengulangi perubahan upstream yang sudah diterima.

Hubungi dukungan jika error yang sama muncul setelah tiga percobaan. Sertakan pesan error lengkap, provider PMS, waktu penyimpanan gagal, dan informasi yang ditampilkan PMS.

Kode eZee 611 Setelah Perubahan Kredensial

Yang Anda lihat: eZee mengembalikan 611, "Invalid Auth Code or Hotel Code", setelah Anda memperbarui kredensial PMS.

Mengapa ini terjadi: Request PMS lama mungkin masih selesai menggunakan snapshot kredensial sebelumnya. AVA menandai snapshot tersebut sebagai kedaluwarsa setelah Anda menyimpan.

Perbaikan:

1. Pastikan Hotel Code dan Auth Code berasal dari properti eZee yang sama.

2. Buka Settings → Essentials → PMS Integration.

3. Simpan kredensial yang diperbarui.

4. Tunggu pesan sukses.

5. Coba ulang tindakan PMS sekali.

   ✓ Operasi PMS berikutnya seharusnya menggunakan kredensial baru.

Hubungi dukungan jika kode 611 tetap muncul setelah penyimpanan berhasil.

Batas Rate Tercapai

Yang Anda lihat: Error 429, pesan rate-limited, atau request yang menyertakan waktu retry.

Mengapa ini terjadi: Cloudbeds atau budget request AVA sendiri untuk sementara membatasi request. AVA mempertahankan waktu retry dari sumber mana pun jika tersedia. AVA juga memiliki budget request terpisah untuk area fitur yang berbeda, sehingga satu halaman yang sibuk lebih kecil kemungkinannya memperlambat halaman lain. Pencarian reservasi, penetapan kamar, dan check-in akhir juga otomatis mencoba ulang 429 PMS sementara. Tindakan tersebut dapat memerlukan beberapa detik tambahan sebelum dilanjutkan atau menampilkan error. Beberapa panggilan yang menghadap tamu menunggu sebentar saat bucket AVA sendiri kosong. Hal itu hanya berlaku untuk burst lokal singkat, bukan cooldown vendor. Jika Cloudbeds mengembalikan error akses yang sama beberapa kali, AVA menjeda retry berikutnya sebentar.

Isolasi batas rate

Jika satu halaman terus menampilkan 429, masalahnya biasanya terbatas pada halaman atau area fitur tersebut. Bagian AVA lainnya mungkin tetap berfungsi normal saat Anda menunggu.

Percobaan ulang pencarian reservasi

Selama pencarian reservasi, AVA otomatis mencoba ulang satu 429 jika waktu retry lima detik atau kurang. Cooldown yang lebih lama dan respons terminal tetap memerlukan langkah refresh dan coba ulang normal di bawah.

Perbaikan:

1. Tunggu waktu retry yang ditampilkan dalam error.

2. Refresh halaman sekali.

3. Coba tindakan itu lagi.

4. Jika masalah berulang, tunggu beberapa menit sebelum mencoba lagi.

5. Jika waktu retry tidak muncul, anggap ini sebagai batas sementara singkat dan coba lagi nanti.

   ✓ Request seharusnya berhasil setelah waktu retry berlalu dan budget request tersedia.

Selama penetapan kamar atau check-in akhir

Biarkan tindakan yang sedang berjalan selesai sebelum memilih Retry. Jika AVA masih menampilkan error penetapan kamar yang informatif, periksa reservasi di PMS Anda. Kemudian refresh AVA dan coba ulang langkah yang terdampak sekali.

Error Akses Cloudbeds

Yang Anda lihat: Pesan akses Cloudbeds terus muncul. Contohnya You don't have access to property ID dan Application is not available to be connected.

Mengapa ini terjadi: Akses ke properti tidak tersedia, atau properti memutuskan aplikasi AVA. AVA menjeda retry berulang agar kegagalan yang sama tidak membanjiri Cloudbeds.

Perbaikan:

1. Pastikan Anda login ke properti Cloudbeds yang benar.

2. Minta admin Cloudbeds memverifikasi akses dan izin properti.

3. Otorisasi ulang AVA jika Cloudbeds menyatakan aplikasi terputus.

4. Tunggu satu menit sebelum mencoba lagi.

5. Refresh sekali setelah masalah akses diperbaiki.

   ✓ Percobaan koneksi berikutnya seharusnya berhasil setelah Cloudbeds menerima request.

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 masih tidak dimuat	Periksa Sync Issues

Kredensial Webhook Cloudbeds Ditolak

Yang Anda lihat: Cloudbeds terus menerima koneksi, tetapi perbaikan webhook gagal setelah Anda menyimpan pengaturan.

Mengapa ini terjadi: Cloudbeds menerima login, tetapi tidak menerima izin webhook yang diperlukan AVA.

Perbaikan:

1. Hubungkan ulang Cloudbeds dari Settings → Essentials.

2. Selesaikan kembali prompt otorisasi Cloudbeds.

3. Simpan lagi pengaturan pre-arrival aktif Anda.

4. Minta admin Cloudbeds meninjau izin aplikasi jika masih gagal.

   ✓ Setelah izin diperbarui, perbaikan webhook seharusnya selesai secara normal.

---

Reservasi Tidak Tersinkron

Yang Anda lihat: Tidak ada reservasi yang muncul setelah koneksi dibuat, atau reservasi hilang

Perbaikan Cepat

1. Klik Refresh di Operations View
2. Tunggu 5-10 menit hingga sinkronisasi awal selesai
3. Pastikan reservasi ada di PMS Anda untuk tanggal hari ini

Periksa Pengaturan PMS

1. Buka Settings → Essentials
2. Gulir ke bagian PMS Integration
3. Pastikan status koneksi menampilkan "Connected"
4. Periksa apakah pengaturan sinkronisasi telah dikonfigurasi dengan benar

Masih Belum Berhasil?

• Pastikan tanggal reservasi sesuai dengan tanggal yang sedang 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 dengan jeda

Perilaku Normal

Sebagian besar sistem PMS melakukan sinkronisasi setiap 5-15 menit. Ketersediaan sinkronisasi real-time bergantung pada:

• Tingkat paket PMS Anda
• Provider PMS tertentu

Kurangi Keterlambatan

1. Gunakan refresh manual bila diperlukan
2. Hubungi provider PMS Anda tentang akses API real-time
3. Jadwalkan sinkronisasi pada periode aktivitas rendah

---

Error Autentikasi

Yang Anda lihat: "Invalid credentials" atau "Authentication failed"

Untuk Cloudbeds

1. Login ke Cloudbeds
2. Buka Settings → Integrations → API
3. Buat kredensial API baru
4. Salin kredensial persis (gunakan tombol copy jika tersedia)
5. Tempel ke AVA tanpa perubahan

Untuk Opera Cloud

1. Tunggu hingga 30 detik sampai AVA menyelesaikan retry otomatisnya. Ini mencakup satu timeout atau error gateway OAuth sementara.

2. Coba ulang tindakan hanya jika error tetap muncul.

3. Pastikan URL environment sudah benar (test versus production).

4. Konfirmasi client ID, client secret, hotel ID, dan enterpriseId.

5. Masukkan ulang kredensial di Settings → Essentials → PMS Integration, lalu klik Save.

6. Hubungi perwakilan Oracle Anda jika error masih muncul.

   ✓ Kegagalan sementara atau kredensial cache yang hanya terjadi sekali dapat pulih tanpa memutus koneksi Opera.

Untuk Mews

1. Login ke Mews Commander
2. Buka Settings → Integrations
3. Temukan Vouch AVA dan buat ulang access token
4. Perbarui token di pengaturan AVA

---

Kapan Menghubungi Support

Tarif atau Paket Tarif Cloudbeds Tidak Tersedia

Yang Anda lihat: Cloudbeds terhubung, tetapi tindakan kalender atau paket tarif tidak tersedia.

Mengapa ini terjadi: Pembacaan kalender dan mutasi paket tarif menggunakan kapabilitas yang terpisah.

Perbaikan:

1. Refresh Operations → Rates & Availability.

2. Pastikan properti Cloudbeds masih menjadi PMS aktif.

3. Tanyakan kepada administrator AVA Anda apakah kapabilitas Cloudbeds yang diperlukan telah diaktifkan.

4. Buat paket tarif yang dapat dijual di Cloudbeds, bukan di AVA.

   ✓ Visibilitas katalog Cloudbeds tidak menjamin setiap tindakan tersedia.

Penyimpanan ARI Cloudbeds Masih Menunggu

Yang Anda lihat: AVA menerima perubahan tarif atau pembatasan, tetapi kalender masih menampilkan nilai lama.

Perbaikan:

1. Tunggu hingga status pekerjaan Cloudbeds selesai.

2. Refresh kalender sekali.

3. Periksa tanggal dan baris tarif yang sama.

4. Jangan mengirimkan perubahan yang sama berulang kali saat masih menunggu.

5. Hubungi dukungan jika nilai yang dipublikasikan tetap tidak berubah.

   ✓ AVA hanya menampilkan keberhasilan setelah memverifikasi nilai tersebut di kalender Cloudbeds.

Hubungi dukungan 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

Panduan Terkait

• Integrasi Cloudbeds
• Integrasi Opera
• Integrasi Mews
• Masalah Sinkronisasi