เชื่อมต่อ eZee PMS

ตั้งค่าอย่างรวดเร็ว

โดยทั่วไปการเชื่อมต่อใช้เวลา 2 นาที คุณต้องมีเพียง Hotel Code และ Auth Code จากฝ่ายสนับสนุนของ eZee

Streamliner เชื่อมต่อกับ eZee (Absolute / Centrix) โดยตรงเพื่อซิงก์ข้อมูลการจอง รายละเอียดผู้เข้าพัก และสถานะห้องแบบเรียลไทม์

กฎสำหรับห้องสกปรก

AVA จะกำหนดห้องใน eZee ให้เฉพาะห้องที่สะอาดเท่านั้น หากห้องที่ตรงกันทุกห้องสกปรก ให้ทำความสะอาดหนึ่งห้องใน Housekeeping แล้วรีเฟรชก่อนกำหนดห้อง eZee ยังสามารถปฏิเสธห้องสกปรกขณะเช็กอินด้วยข้อผิดพลาด 117 ได้

การป้องกันการกำหนดห้องที่มีผู้เข้าพัก

AVA ถือว่าสถานะ Arrived และ Dayuse ของ eZee หมายถึงห้องมีผู้เข้าพัก ระบบจะไม่รวมห้องที่มีผู้เข้าพักไว้สำหรับการกำหนดห้อง แม้ว่าห้องนั้นจะสะอาดก็ตาม สถานะที่เกี่ยวกับการจองเท่านั้น เช่น Confirmed Reservation ไม่ได้หมายความว่ามีผู้เข้าพักอยู่ในห้อง

รายการแทนช่วงเวลาของ eZee

eZee อาจส่งแถว Morning และ Night พร้อม roomid: "0" AVA จะตัดรายการแทนเหล่านี้ออก เนื่องจากไม่ใช่ห้องจริง ใช้ห้องจริงที่ว่างอยู่สำหรับการอัปเดตงานดูแลห้องและการกำหนดห้อง

การแมปข้อมูลระบุตัวตนผู้เข้าพัก

Streamliner จะแมปข้อมูลเอกสารแบบซ้อนกัน รวมถึง documentNumber และ passportNumber ระดับบนสุด เข้ากับฟิลด์ระบุตัวตนของ eZee

ข้อมูลอ้างอิงแบบย่อ

การตั้งค่า	คำอธิบาย
Hotel Code	ID เฉพาะของที่พักของคุณใน eZee
Auth Code	คีย์ API ลับสำหรับการยืนยันตัวตน (เขียนได้อย่างเดียว)
Use Demo Environment	สลับระหว่างสภาพแวดล้อม sandbox และ live

ใช้ API Base URL

เว้น Base URL ว่างไว้ เว้นแต่ eZee จะให้ปลายทาง API แบบกำหนดเองมา อย่ากรอกเว็บไซต์การตลาดของ eZee เนื่องจาก AVA ไม่สามารถอ่านข้อมูลการจองจากเว็บไซต์ดังกล่าวได้

1. เตรียมข้อมูลรับรองของคุณ

ก่อนเชื่อมต่อ ตรวจสอบให้แน่ใจว่าคุณมี:

• Hotel Code: ดูได้ในแดชบอร์ด eZee ของคุณ
• Auth Code: ข้อมูลลับเฉพาะสำหรับ API (ขอจาก eZee หรือฝ่ายสนับสนุนของ Vouch)
• Base URL (ไม่บังคับ): จำเป็นเฉพาะเมื่อคุณใช้ปลายทาง eZee แบบกำหนดเอง

2. เปิดใช้งานการเชื่อมต่อ

1. ไปที่ Settings → Essentials → PMS Integration

2. ในส่วน Select PMS Provider คลิกการ์ด eZee

3. ✓ การ์ด eZee จะแสดงเป็นรายการที่เลือก

4. กรอกข้อมูลรับรองของคุณ:

   • Hotel Code: เช่น EZ1234
   • Auth Code: กรอกคีย์ลับของคุณ
   • Base URL: เว้นว่างไว้สำหรับ cloud มาตรฐาน (ค่าเริ่มต้น)

5. ตรวจสอบว่า Use Demo Environment เป็น OFF สำหรับการดำเนินงานจริง

6. คลิก Save

   ✓ สถานะควรอัปเดตเป็น "Connected"

หมายเหตุด้านความปลอดภัย

หลังบันทึก Auth Code ของคุณจะถูกปกปิดเป็น ***** ซึ่งเป็นเรื่องปกติ หากต้องการเปลี่ยน เพียงพิมพ์ทับช่องดังกล่าวด้วยโค้ดใหม่

ความสามารถ

การเชื่อมต่อ eZee ทำให้ใช้ความสามารถต่อไปนี้ได้:

• Automatic Reservation Sync: การจองจะแสดงใน Streamliner ทันที
• Guest Profile Updates: ข้อมูลเช็กอินและฟิลด์ระบุตัวตนจะถูกส่งกลับไปยัง PMS
• Room Status Sync: การอัปเดตงานดูแลห้อง (Clean/Dirty) จะแสดงใน eZee
• Physical housekeeping rooms only: รายการแทนช่วงเวลา เช่น Morning และ Night จะไม่แสดงเป็นห้อง
• Room Matching: ค่า roomID ที่ตรงกันทุกประการจะถูกใช้ก่อนการจับคู่สำรองด้วย unitID
• Reservation Cleanup: Streamliner จะยกเลิกการจองใน eZee ก่อนถึงวันเข้าพัก
• Multi-room reservations: สร้างการจองแบบกลุ่มใน eZee หนึ่งรายการ โดยใช้ประเภทห้องและราคาแยกกันสำหรับแต่ละห้อง
• Group cancellation: การยกเลิกการจองแบบกลุ่มก่อนเข้าพักจะยกเลิกทุกห้องในการจองนั้น
• Source labels stay readable: AVA จะใช้ชื่อแหล่งที่มาทางธุรกิจของ eZee เมื่อมีข้อมูลดังกล่าว
• Source collect defaults to hotel collect: AVA ถือว่าแหล่งที่มาของการจอง eZee เป็น hotel collect
• Room capacity follows eZee limits: เมื่อ eZee เว้น max occupancy ว่างไว้ AVA จะใช้เพดานจำนวนผู้ใหญ่หรือเด็กที่สูงกว่า โดยยังเคารพจำนวนผู้เข้าพักพื้นฐานของห้อง

ขีดจำกัดผู้ใหญ่และเด็ก

ค่า maximum adults และ maximum children ของ eZee เป็นขีดจำกัดแยกกันสำหรับห้องเดียวกัน AVA จะไม่บวกค่าทั้งสองเข้าด้วยกันเพื่อคำนวณความจุรวมของห้อง หาก eZee ระบุค่า max occupancy ไว้ ค่านั้นจะมีผลเป็นหลัก

การแก้ไขปัญหา

ข้อผิดพลาด "Invalid Credentials"

สิ่งที่คุณเห็น: มีข้อความข้อผิดพลาดเมื่อการบันทึกหรือการซิงก์ล้มเหลวทันที

วิธีแก้:

1. ตรวจสอบว่า Hotel Code ตรงกันทุกประการ

2. กรอก Auth Code ใหม่อีกครั้ง (อาจมีการเปลี่ยนคีย์แล้ว)

3. ตรวจสอบว่าไม่มีช่องว่างต่อท้ายที่ถูกวางติดมาด้วย

   ✓ AVA จะใช้ข้อมูลรับรองที่อัปเดตแล้วในการดำเนินการ PMS ครั้งถัดไป

รหัส eZee 611 ปรากฏหลังเปลี่ยนข้อมูลรับรอง

สิ่งที่คุณเห็น: eZee ส่งคืนรหัส 611 พร้อมข้อความ "Invalid Auth Code or Hotel Code" หลังจากคุณเปลี่ยนค่าใดค่าหนึ่ง

สาเหตุ: คำขอ PMS ก่อนหน้าอาจยังดำเนินการด้วยข้อมูลรับรองเดิมไม่เสร็จ

วิธีแก้:

1. ยืนยันว่า Hotel Code และ Auth Code เป็นของที่พัก eZee เดียวกัน

2. คลิก Save ใน Settings → Essentials → PMS Integration

3. รอการยืนยันการบันทึก

4. ลองดำเนินการจองหรืองานดูแลห้องอีกครั้งหนึ่ง

   ✓ การดำเนินการครั้งถัดไปจะใช้ข้อมูลรับรองใหม่

ติดต่อฝ่ายสนับสนุนหากรหัส 611 ยังคงปรากฏหลังการบันทึกสำเร็จ

เชื่อมต่อสำเร็จแต่ไม่มีการจอง

สิ่งที่คุณเห็น: สถานะแสดง "Connected" แต่รายการจองว่างเปล่า

ตรวจสอบ:

• Use Demo Environment ตั้งเป็น OFF
• คุณมีรายการเข้าพักวันนี้/พรุ่งนี้ที่ถูกต้องใน eZee
• รอ 15 นาทีเพื่อให้รอบการซิงก์ครั้งแรกเสร็จสมบูรณ์

eZee ส่งคืนข้อผิดพลาดจากการตอบกลับของ API

สิ่งที่คุณเห็น: ความครอบคลุมของการจองหรือ Analytics แสดงข้อผิดพลาดจากการตอบกลับของ eZee

สาเหตุ: Base URL ชี้ไปยังเว็บไซต์หรือที่อยู่อื่นที่ไม่ใช่ API

วิธีแก้:

1. เปิด Settings → Essentials → PMS Integration

2. เลือก eZee

3. เว้น Base URL ว่างไว้สำหรับการเชื่อมต่อ eZee cloud มาตรฐาน

4. ใช้ URL แบบกำหนดเองเฉพาะเมื่อ eZee เป็นผู้ให้มา

5. คลิก Save แล้วรีเฟรชรายการจองหรือ Analytics

   ✓ วันที่ไม่มีการจองจริงยังคงเป็นผลลัพธ์ศูนย์ที่ถูกต้อง

สถานะห้องไม่ตรงกับการเข้าพัก

สิ่งที่คุณเห็น: ห้องแสดงเป็น Occupied หรือ Vacant โดยไม่คาดคิด

สาเหตุ: eZee รายงานการเข้าพักโดยใช้วันที่ของโรงแรมปัจจุบัน AVA จะแมป Arrived และ Dayuse เป็นสถานะมีผู้เข้าพัก

วิธีแก้:

1. ตรวจสอบสถานะผู้เข้าพักของห้องและวันที่ของโรงแรมใน eZee

2. ดำเนินการเช็กอินหรือเช็กเอาต์ของผู้เข้าพักใน eZee ให้เสร็จ หากจำเป็น

3. เปิด Housekeeping ใน AVA แล้วรีเฟรชรายการห้อง

4. ติดต่อฝ่ายสนับสนุนหากสถานะยังไม่ถูกต้อง

   ✓ การกำหนดห้องควรเคารพสถานะมีผู้เข้าพักที่รีเฟรชแล้ว

eZee ปฏิเสธการอัปเดตงานดูแลห้อง

สิ่งที่คุณเห็น: การอัปเดตสภาพห้องล้มเหลวด้วย Fail หรือ Unit Id(s) not found in the system

สาเหตุ: eZee ไม่ได้ติดตามห้องดังกล่าวเป็นยูนิตสำหรับงานดูแลห้อง ขณะนี้ AVA จะเก็บเหตุผลที่ eZee ส่งคืนไว้

วิธีแก้:

1. จดหมายเลขห้องจากข้อผิดพลาด

2. ยืนยันว่าห้องได้รับการตั้งค่าเป็นยูนิตสำหรับงานดูแลห้องใน eZee

3. แก้ไขการแมปห้องใน eZee หรืออัปเดตห้องอื่นที่มีการติดตาม

4. กลับไปที่ Housekeeping แล้วรีเฟรชรายการห้อง

   ✓ การอัปเดตสภาพห้องควรสำเร็จสำหรับยูนิตที่มีการติดตาม

"ไม่มีห้องว่าง" ขณะกำหนดห้อง

สิ่งที่คุณเห็น: ตัวเลือกห้องว่างเปล่า หรือ AVA แจ้งว่าไม่มีห้องว่าง

สาเหตุ: AVA จะแสดงเฉพาะห้องสะอาดสำหรับขั้นตอนการกำหนดห้องของ eZee

วิธีแก้:

1. เปิด Housekeeping

2. ทำเครื่องหมายห้องที่ตรงกันหนึ่งห้องเป็น Clean

3. กลับไปที่การจองแล้วคลิก Refresh

4. ลอง Assign Room อีกครั้ง

   ✓ ตัวเลือกห้องควรแสดงห้องที่มีสิทธิ์ใช้งานอย่างน้อยหนึ่งห้อง

ความจุห้องของ eZee ดูน้อยลงกว่าเดิม

สิ่งที่คุณเห็น: ห้องมีจำนวนผู้เข้าพักที่ยังเพิ่มได้ใน Assisted Check-In น้อยลง

สาเหตุ: AVA ไม่บวกเพดานจำนวนผู้ใหญ่และเด็กของ eZee เข้าด้วยกันอีกต่อไป ค่าทั้งสองเป็นขีดจำกัดของเตียงชุดเดียวกัน ไม่ใช่ความจุคนละส่วน

วิธีแก้:

1. เปรียบเทียบ maximum adults, maximum children และจำนวนผู้เข้าพักพื้นฐานของห้องใน eZee

2. ตรวจสอบว่า eZee ระบุค่า max occupancy ไว้โดยเฉพาะหรือไม่

3. ใช้ความจุห้องที่ AVA แสดงสำหรับจำนวนผู้เข้าพักที่เพิ่มได้และขีดจำกัดการเช็กอินแบบมีผู้ช่วย

4. ติดต่อฝ่ายสนับสนุนหาก AVA ไม่ตรงกับค่าที่ตั้งไว้ใน eZee

   ✓ การจองที่มีอยู่ยังคงรองรับจำนวนผู้เข้าพักตามที่จองไว้ได้

ตัวอย่างความจุ

หาก eZee รายงาน maximum adults 4 และ maximum children 3 AVA จะใช้ 4 ไม่ใช่ 7 หากจำนวนผู้เข้าพักพื้นฐานของห้องสูงกว่า AVA จะคงค่าพื้นฐานที่สูงกว่านั้นไว้

ยังติดปัญหาอยู่?

ติดต่อ success@vouch-technologies.com หาก:

• ❌ การซิงก์ยังว่างเปล่าหลังผ่านไป 30 นาที
• ❌ Auth Code ถูกปฏิเสธซ้ำหลายครั้ง

ข้อมูลที่ควรแนบ:

• Hotel Code ของคุณ
• ภาพหน้าจอข้อความข้อผิดพลาด
• เวลาที่เริ่มพบปัญหา

คู่มือที่เกี่ยวข้อง

• PMS Sync Issues
• Check-In Rules
• Housekeeping Dashboard