Hubungkan eZee PMS

Penyiapan Cepat

Koneksi biasanya hanya memerlukan waktu 2 menit. Anda cukup menyiapkan Hotel Code dan Auth Code dari dukungan eZee.

Streamliner terhubung langsung ke eZee (Absolute / Centrix) untuk menyinkronkan reservasi, detail tamu, dan status kamar secara real-time.

Aturan kamar kotor

AVA mempertahankan penetapan kamar eZee hanya untuk kamar yang bersih. Jika semua kamar yang cocok berstatus kotor, bersihkan satu kamar di Housekeeping, lalu lakukan refresh sebelum menetapkannya. eZee tetap dapat menolak kamar kotor saat check-in dengan kesalahan 117.

Perlindungan kamar terisi

AVA menganggap status eZee Arrived dan Dayuse sebagai terisi. AVA mengecualikan kamar yang terisi dari penetapan, meskipun kamar tersebut bersih. Untuk penetapan otomatis, AVA juga melewati kamar yang ditahan oleh pemesanan berstatus Confirmed, Confirmed Reservation, Unconfirmed Reservation, Dayuse Reservation, atau Reserved. Status ini melindungi kamar dari penetapan yang bertentangan, meskipun housekeeping melaporkannya sebagai bersih. Jika reservasi saat ini memiliki kamar yang ditahan, Assisted Check-In dapat memvalidasi kamar tersebut secara tepat. Reservasi lain tetap tidak dapat menerima kamar yang ditahan itu secara otomatis.

Placeholder bagian hari eZee

eZee dapat mengirim baris Morning dan Night dengan roomid: "0". AVA mengabaikan placeholder tersebut karena bukan kamar fisik. Gunakan kamar fisik yang kosong untuk pembaruan housekeeping dan penetapan kamar.

Pemetaan identitas tamu

Streamliner memetakan data dokumen bertingkat, documentNumber tingkat atas, dan passportNumber tingkat atas ke kolom identitas eZee.

Referensi Singkat

Pengaturan	Deskripsi
Hotel Code	ID unik properti Anda di eZee
Auth Code	Kunci API rahasia untuk autentikasi (hanya-tulis)
Use Demo Environment	Beralih antara lingkungan sandbox dan live

Gunakan Base URL API

Biarkan Base URL kosong, kecuali eZee memberikan endpoint API kustom. Jangan masukkan situs web pemasaran eZee, karena AVA tidak dapat membaca reservasi dari sana.

1. Siapkan Kredensial Anda

Sebelum menghubungkan, pastikan Anda memiliki:

• Hotel Code: Tersedia di dasbor eZee Anda
• Auth Code: Rahasia API khusus (minta kepada eZee atau dukungan Vouch)
• Base URL (Opsional): Hanya diperlukan jika Anda menggunakan endpoint eZee kustom

2. Aktifkan Koneksi

1. Buka Settings → Essentials → PMS Integration

2. Di bawah Select PMS Provider, klik kartu eZee

3. ✓ Kartu eZee ditandai sebagai terpilih

4. Masukkan kredensial Anda:

   • Hotel Code: misalnya, EZ1234
   • Auth Code: Masukkan kunci rahasia Anda
   • Base URL: Biarkan kosong untuk cloud standar (bawaan)

5. Pastikan Use Demo Environment dalam keadaan OFF untuk operasi live

6. Klik Save

   ✓ Status seharusnya berubah menjadi "Connected"

Catatan Keamanan

Setelah disimpan, Auth Code Anda akan disamarkan menjadi *****. Ini normal. Untuk mengubahnya, cukup ganti isi kolom tersebut dengan kode baru.

Fitur

Dengan menghubungkan eZee, Anda mengaktifkan:

• Sinkronisasi Reservasi Otomatis: Pemesanan langsung muncul di Streamliner
• Pembaruan Profil Tamu: Data check-in dan kolom identitas dikirim kembali ke PMS
• Sinkronisasi Status Kamar: Pembaruan housekeeping (Clean/Dirty) tercermin di eZee
• Hanya kamar housekeeping fisik: Placeholder bagian hari seperti Morning dan Night tidak ditampilkan sebagai kamar
• Pencocokan Kamar: Nilai roomID yang sama persis diprioritaskan sebelum pencocokan fallback unitID
• Kamar siap untuk seluruh masa inap: Assisted Check-In menawarkan kamar yang tersedia untuk setiap malam masa inap
• Penetapan awal yang tepat: Untuk pemesanan terkonfirmasi, belum ditetapkan, dan hanya satu kamar, Find ready rooms muncul pada kartu kamar ACI dan menetapkan kamar fisik yang dipilih
• Pemulihan penetapan: Jika eZee tidak mengonfirmasi hasilnya, refresh penetapan kamar sebelum mencari lagi
• Konfirmasi penetapan: AVA membaca kembali pemesanan sebelum mengonfirmasi kamar yang dipilih
• Batas penetapan eZee: Pemindahan kamar, pertukaran, upgrade, dan perubahan pada pemesanan yang sudah memiliki penetapan tetap tidak tersedia di AVA
• Pembersihan Reservasi: Streamliner membatalkan pemesanan eZee sebelum kedatangan
• Reservasi multi-kamar: Membuat satu pemesanan grup eZee dengan tipe kamar dan tarif terpisah untuk setiap kamar
• Pembatalan grup: Pembatalan pemesanan grup sebelum kedatangan membatalkan setiap kamar dalam pemesanan, menggunakan nomor konfirmasi induk
• Pemulihan grup: AVA mempertahankan seluruh grup ketika pembacaan pemesanan tunggal eZee mengembalikan lebih sedikit kamar daripada daftar grup eZee
• Upsell native eZee: Extra Charges eZee yang aktif dapat dikutip dan dilampirkan ke reservasi selama check-in
• Upsell aman saat diputar ulang: Mencoba lagi lampiran upsell yang sama tidak membuat biaya eZee duplikat
• Pembayaran yang ditangkap muncul di folio dan kartu: Reservasi eZee yang sudah dibayar menampilkan pembayaran yang ditangkap dan saldo tersisa di AVA. Saldo tersebut mencakup ekstra yang memenuhi syarat.
• Label sumber tetap mudah dibaca: AVA menggunakan nama sumber bisnis eZee jika tersedia.
• Source collect secara default menjadi hotel collect: AVA memperlakukan sumber reservasi eZee sebagai hotel collect.
• Kapasitas kamar mengikuti batas eZee: Jika eZee membiarkan max occupancy kosong, AVA menggunakan batas dewasa atau anak yang lebih besar, sambil tetap menghormati okupansi dasar kamar.
• eZee tidak mendukung tamu melebihi kapasitas kamar yang dilaporkan. AVA menjaga assisted check-in tetap dalam batas eZee yang telah dihitung.

Batas dewasa dan anak

Nilai maximum adults dan maximum children eZee merupakan batas terpisah untuk kamar yang sama. AVA tidak menjumlahkannya untuk menghitung kapasitas total kamar. Nilai max occupancy yang ditentukan tetap menjadi acuan utama jika eZee menyediakannya.

Pemecahan Masalah

Kesalahan "Invalid Credentials"

Yang Anda lihat: Pesan kesalahan saat penyimpanan atau sinkronisasi langsung gagal.

Perbaikan:

1. Pastikan Hotel Code benar-benar cocok

2. Masukkan ulang Auth Code (mungkin sudah dirotasi)

3. Pastikan tidak ada spasi tambahan yang ikut tersalin

   ✓ AVA menggunakan kredensial yang diperbarui pada operasi PMS berikutnya.

Kode eZee 611 muncul setelah kredensial diubah

Yang Anda lihat: eZee mengembalikan kode 611, "Invalid Auth Code or Hotel Code", setelah Anda mengubah salah satu nilai.

Mengapa ini terjadi: Permintaan PMS sebelumnya mungkin masih diselesaikan dengan kredensial lama.

Perbaikan:

1. Pastikan Hotel Code dan Auth Code cocok dengan properti eZee yang sama.

2. Klik Save di Settings → Essentials → PMS Integration.

3. Tunggu konfirmasi penyimpanan.

4. Coba lagi tindakan reservasi atau housekeeping satu kali.

   ✓ Operasi berikutnya menggunakan kredensial baru.

Hubungi dukungan jika kode 611 masih muncul setelah penyimpanan berhasil.

Koneksi Berhasil tetapi Tidak Ada Reservasi

Yang Anda lihat: Status "Connected", tetapi daftar reservasi kosong.

Periksa:

• Use Demo Environment dalam keadaan OFF
• Anda memiliki kedatangan yang valid untuk hari ini/besok di eZee
• Tunggu 15 menit hingga siklus sinkronisasi awal selesai

eZee mengembalikan kesalahan respons API

Yang Anda lihat: Cakupan Reservasi atau Analytics menampilkan kesalahan respons eZee.

Mengapa ini terjadi: Base URL mengarah ke situs web atau alamat lain yang bukan API.

Perbaikan:

1. Buka Settings → Essentials → PMS Integration.

2. Pilih eZee.

3. Biarkan Base URL kosong untuk koneksi cloud eZee standar.

4. Gunakan URL kustom hanya jika eZee menyediakannya.

5. Klik Save, lalu refresh reservasi atau Analytics.

   ✓ Hari yang benar-benar tidak memiliki reservasi tetap merupakan hasil nol yang valid.

Status kamar tidak sesuai dengan okupansi

Yang Anda lihat: Kamar tiba-tiba terlihat Occupied atau Vacant.

Mengapa ini terjadi: eZee melaporkan okupansi berdasarkan tanggal hotel saat ini. AVA memetakan Arrived dan Dayuse sebagai status terisi.

Perbaikan:

1. Periksa status tamu kamar dan tanggal hotel di eZee.

2. Selesaikan check-in atau check-out tamu di eZee jika diperlukan.

3. Buka Housekeeping di AVA dan refresh daftar kamar.

4. Hubungi dukungan jika status masih tidak benar.

   ✓ Penetapan kamar seharusnya mengikuti status terisi yang telah diperbarui.

eZee menolak pembaruan housekeeping

Yang Anda lihat: Pembaruan kondisi gagal dengan Fail atau Unit Id(s) not found in the system.

Mengapa ini terjadi: eZee tidak melacak kamar tersebut sebagai unit housekeeping. AVA kini mempertahankan alasan yang diberikan oleh eZee.

Perbaikan:

1. Catat nomor kamar dari kesalahan tersebut.

2. Pastikan kamar dikonfigurasi sebagai unit housekeeping di eZee.

3. Perbaiki pemetaan kamar di eZee, atau perbarui kamar lain yang terlacak.

4. Kembali ke Housekeeping dan refresh daftar kamar.

   ✓ Pembaruan kondisi seharusnya berhasil untuk unit housekeeping yang terlacak.

"No rooms available" Saat Assign Room

Yang Anda lihat: Pemilih kamar kosong, atau AVA menyatakan tidak ada kamar yang tersedia.

Mengapa ini terjadi: AVA hanya menawarkan kamar yang memenuhi syarat dan tetap tersedia selama seluruh pemesanan. AVA juga memeriksa housekeeping, pemblokiran, tipe kamar, dan status pemesanan yang menahan kamar. Kamar yang tersedia hari ini dapat dikecualikan ketika pemesanan lain menahannya di kemudian hari.

Perbaikan:

1. Buka Housekeeping.

2. Periksa eZee untuk pemesanan berstatus Confirmed, Confirmed Reservation, Unconfirmed Reservation, Dayuse Reservation, atau Reserved yang menahan kamar yang cocok.

3. Selesaikan pemesanan yang bertentangan atau pilih kamar lain di eZee.

4. Tandai kamar lain yang cocok sebagai Clean, jika diperlukan.

5. Kembali ke reservasi dan klik Refresh.

6. Coba Assign Room lagi.

   ✓ Pemilih kamar seharusnya menampilkan setidaknya satu kamar yang memenuhi syarat.

Kamar menghilang setelah Anda memilihnya

Yang Anda lihat: Kamar yang dipilih tidak lagi tersedia untuk seluruh masa inap tamu.

Mengapa ini terjadi: Ketersediaan eZee berubah setelah daftar kamar dimuat. AVA memeriksa ulang setiap malam masa inap sebelum menulis penetapan.

Perbaikan:

1. Refresh reservasi di AVA.

2. Periksa ketersediaan kamar untuk setiap malam di eZee.

3. Periksa kondisi housekeeping dan status pemblokiran kamar.

4. Pilih kamar lain yang memenuhi syarat dengan tipe kamar yang dipesan.

   ✓ AVA menetapkan kamar hanya setelah eZee mengonfirmasi seluruh masa inap.

AVA tidak dapat mengonfirmasi kamar yang dipilih

Yang Anda lihat: AVA menyatakan bahwa penetapan tidak dapat diverifikasi.

Mengapa ini terjadi: Penulisan atau pembacaan pemesanan lanjutan tidak membuktikan kamar akhir.

Perbaikan:

1. Jangan langsung memilih kamar lain.

2. Refresh reservasi di AVA.

3. Konfirmasikan kamar yang ditampilkan di eZee.

4. Coba lagi hanya jika pemesanan masih belum ditetapkan.

   ✓ Pemesanan yang telah di-refresh menampilkan kamar fisik sebelum Anda melanjutkan.

Hubungi dukungan jika hasilnya masih tidak jelas.

eZee tidak mengizinkan perubahan kamar ini

Yang Anda lihat: AVA menolak pemindahan, pertukaran, upgrade, atau perubahan pada pemesanan yang sudah memiliki penetapan.

Mengapa ini terjadi: eZee hanya mendukung alur AVA ini untuk penetapan awal. Pemesanan harus terkonfirmasi, belum ditetapkan, dan berisi satu kamar.

Perbaikan:

1. Ubah kamar langsung di eZee jika pemesanan sudah memiliki kamar.

2. Refresh reservasi di AVA.

3. Gunakan pemilih kamar hanya untuk pemesanan yang terkonfirmasi, belum ditetapkan, dan hanya memiliki satu kamar.

   ✓ AVA menampilkan kamar yang dikonfirmasi eZee untuk pemesanan tersebut.

Kamar yang Anda tetapkan sebelumnya sendiri tampak terisi

Yang Anda lihat: Assisted Check-In menyatakan Room occupied untuk kamar yang telah ditetapkan sebelumnya bagi tamu.

Mengapa ini terjadi: eZee melaporkan penahanan reservasi yang belum tiba sebagai terisi demi keamanan. AVA dapat membedakan penahanan tersebut dari tamu yang sudah tiba untuk reservasi yang sama.

Perbaikan:

1. Pastikan nomor kamar cocok dengan reservasi eZee saat ini.

2. Refresh reservasi di AVA.

3. Coba lagi Assisted Check-In untuk reservasi yang sama.

4. Gunakan Find ready rooms hanya jika Anda memerlukan kamar lain.

   ✓ AVA dapat mempertahankan kamar yang ditahan untuk tamu tersebut sekaligus melindunginya dari pemesanan lain.

Jika kamar yang muncul salah, minta dukungan untuk meninjau pemetaan kamar eZee. Nilai roomid dan unitid eZee dapat tumpang tindih di antara kamar fisik.

Kapasitas kamar eZee tampak lebih rendah dari sebelumnya

Yang Anda lihat: Sebuah kamar memiliki lebih sedikit slot tamu yang tersedia dalam Assisted Check-In.

Mengapa ini terjadi: AVA tidak lagi menjumlahkan batas dewasa dan anak dari eZee. Nilai tersebut membatasi tempat tidur yang sama, bukan kumpulan kapasitas yang terpisah.

Perbaikan:

1. Bandingkan maximum adults, maximum children, dan okupansi dasar kamar di eZee.

2. Periksa apakah eZee menyediakan nilai max occupancy yang eksplisit.

3. Gunakan kapasitas kamar yang ditampilkan AVA untuk slot tamu yang tersedia dan batas assisted check-in.

4. Hubungi dukungan jika AVA tidak sesuai dengan nilai yang dikonfigurasi di eZee.

   ✓ Reservasi yang sudah ada tetap diizinkan untuk menampung jumlah tamu yang dipesan.

Contoh kapasitas

Jika eZee melaporkan maximum adults 4 dan maximum children 3, AVA menggunakan 4, bukan 7. Jika okupansi dasar kamar lebih tinggi, AVA mempertahankan nilai dasar yang lebih tinggi tersebut.

Reservasi eZee yang sudah dibayar menampilkan saldo belum dibayar

Yang Anda lihat: eZee menampilkan pembayaran yang telah ditangkap, tetapi kartu reservasi atau folio AVA tidak menampilkan pembayaran atau menampilkan saldo yang terlalu tinggi.

Mengapa ini terjadi: AVA mungkin perlu menyegarkan reservasi setelah eZee selesai mencatat pembayaran.

Perbaikan:

1. Pastikan pembayaran muncul di folio reservasi di eZee.

2. Refresh detail reservasi di AVA.

3. Buka kembali bagian Payments dan bandingkan Balance Due dengan eZee.

4. Jangan kumpulkan pembayaran lagi jika eZee sudah menampilkannya sebagai pembayaran yang telah ditangkap.

   ✓ Kartu dan folio seharusnya menampilkan pembayaran yang telah ditangkap dan saldo yang tersisa.

Hubungi dukungan jika nilainya masih berbeda setelah refresh.

Pembatalan grup eZee melaporkan kesalahan PMS sementara

Yang Anda lihat: Pembatalan grup sebelum kedatangan menampilkan pesan 503 atau pesan sementara bahwa PMS tidak tersedia. Pesan tersebut menyebutkan kamar yang belum dibatalkan dan mencantumkan kamar yang sudah dibatalkan.

Mengapa ini terjadi: Layanan pembatalan eZee tidak menyelesaikan permintaan tersebut. AVA membatalkan kamar grup satu per satu dan melaporkan kemajuan sebagian ketika eZee mengalami kegagalan.

Perbaikan:

1. Buka reservasi grup di eZee.

2. Periksa status pembatalan setiap kamar.

3. Tunggu hingga eZee merespons secara normal.

4. Refresh reservasi di AVA.

5. Coba lagi pembatalan satu kali.

6. Pastikan setiap kamar dibatalkan di eZee.

   ✓ AVA mempertahankan nomor konfirmasi induk dan tidak menganggap pembatalan yang belum selesai sebagai berhasil.

Jangan buat pemesanan pengganti dulu

Periksa setiap kamar di eZee sebelum membuat pemesanan pengganti. Sebagian kamar mungkin sudah berhasil dibatalkan sementara kamar lain masih aktif.

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Sinkronisasi masih kosong setelah 30 menit
• ❌ Auth Code terus ditolak
• ❌ Pembatalan grup masih belum selesai setelah eZee pulih

Sertakan juga:

• Hotel Code Anda
• Tangkapan layar pesan kesalahan
• Waktu masalah mulai terjadi

Panduan Terkait

• Masalah Sinkronisasi PMS
• Aturan Check-In
• Dasbor Housekeeping