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 waktu nyata.

Aturan kamar kotor

AVA hanya mempertahankan penetapan kamar eZee 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 sebuah reservasi sudah memiliki kamar, alur strict atau preassigned-nya tetap dapat memvalidasi kamar tersebut.

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 produksi

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 produksi

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

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 bersih dan tidak ditahan oleh pemesanan eZee lain. Kamar bersih dengan status yang ditahan pemesanan tidak tersedia untuk penetapan otomatis.

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

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.

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Sinkronisasi masih kosong setelah 30 menit
• ❌ Auth Code terus ditolak

Sertakan juga:

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

Panduan Terkait

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