เชื่อมต่อ eZee PMS

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

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

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

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

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

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

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

รายการแทนช่วงเวลาของ 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 ทำให้ใช้ความสามารถต่อไปนี้ได้:

• การซิงก์การจองอัตโนมัติ: การจองจะแสดงใน Streamliner ทันที
• การอัปเดตโปรไฟล์ผู้เข้าพัก: ข้อมูลเช็กอินและฟิลด์ระบุตัวตนจะถูกส่งกลับไปยัง PMS
• การซิงก์สถานะห้อง: การอัปเดตงานดูแลห้อง (Clean/Dirty) จะแสดงใน eZee
• เฉพาะห้องงานดูแลห้องจริง: รายการแทนช่วงเวลา เช่น Morning และ Night จะไม่แสดงเป็นห้อง
• การจับคู่ห้อง: ค่า roomID ที่ตรงกันทุกประการจะถูกใช้ก่อนการจับคู่สำรองด้วย unitID
• การล้างข้อมูลการจอง: Streamliner จะยกเลิกการจองใน eZee ก่อนถึงวันเข้าพัก
• การจองหลายห้อง: สร้างการจองแบบกลุ่มใน eZee หนึ่งรายการ โดยใช้ประเภทห้องและราคาที่แยกกันสำหรับแต่ละห้อง
• การยกเลิกแบบกลุ่ม: การยกเลิกการจองแบบกลุ่มก่อนเข้าพักจะยกเลิกทุกห้องในการจองนั้น โดยใช้หมายเลขยืนยันของการจองหลัก
• การกู้คืนการจองแบบกลุ่ม: AVA จะเก็บกลุ่มทั้งหมดไว้เมื่อการอ่านการจองเดี่ยวจาก eZee ส่งคืนห้องน้อยกว่ารายการกลุ่มของ eZee
• การขายเพิ่มแบบเนทีฟของ eZee: Extra Charges ที่ใช้งานอยู่ของ eZee สามารถนำมาเสนอราคาและแนบกับการจองระหว่างเช็กอินได้
• การขายเพิ่มที่ปลอดภัยเมื่อเล่นซ้ำ: การลองแนบรายการขายเพิ่มเดิมซ้ำจะไม่สร้างค่าบริการ eZee ซ้ำ
• การชำระเงินที่บันทึกแล้วจะแสดงในโฟลิโอและการ์ด: การจอง eZee ที่ชำระเงินแล้วจะแสดงการชำระเงินที่บันทึกและยอดคงเหลือใน AVA ยอดคงเหลือจะรวมค่าใช้จ่ายเพิ่มเติมที่เข้าเกณฑ์
• ป้ายกำกับแหล่งที่มายังคงอ่านง่าย: AVA จะใช้ชื่อแหล่งที่มาทางธุรกิจของ eZee เมื่อมีข้อมูลดังกล่าว
• การเรียกเก็บจากแหล่งที่มาเริ่มต้นเป็น hotel collect: AVA ถือว่าแหล่งที่มาของการจอง eZee เป็น hotel collect
• ความจุห้องเป็นไปตามขีดจำกัด eZee: เมื่อ eZee เว้น max occupancy ว่างไว้ AVA จะใช้เพดานจำนวนผู้ใหญ่หรือเด็กที่สูงกว่า โดยยังเคารพจำนวนผู้เข้าพักพื้นฐานของห้อง
• eZee ไม่รองรับผู้เข้าพักเกินความจุห้องที่รายงาน AVA จะจำกัดการเช็กอินแบบมีผู้ช่วยให้อยู่ภายในขีดจำกัด eZee ที่คำนวณได้

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

ค่า 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. ตรวจสอบ eZee ว่ามีการจองสถานะ Confirmed, Confirmed Reservation, Unconfirmed Reservation, Dayuse Reservation หรือ Reserved ที่สงวนห้องที่ตรงกันอยู่หรือไม่

3. แก้ไขการจองที่ขัดแย้งกันหรือเลือกห้องอื่นใน eZee

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

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

6. ลอง 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 จะคงค่าพื้นฐานที่สูงกว่านั้นไว้

การจอง eZee ที่ชำระเงินแล้วแสดงยอดค้างชำระ

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

สาเหตุ: AVA อาจต้องรีเฟรชการจองหลังจาก eZee บันทึกการชำระเงินเสร็จแล้ว

วิธีแก้:

1. ยืนยันว่าการชำระเงินปรากฏในโฟลิโอการจองใน eZee

2. รีเฟรชรายละเอียดการจองใน AVA

3. เปิดส่วน Payments อีกครั้ง แล้วเปรียบเทียบ Balance Due กับ eZee

4. อย่าเรียกเก็บเงินซ้ำเมื่อ eZee แสดงว่าบันทึกการชำระเงินแล้ว

   ✓ การ์ดและโฟลิโอควรแสดงการชำระเงินที่บันทึกแล้วและยอดคงเหลือ

ติดต่อฝ่ายสนับสนุนหากค่าต่าง ๆ ยังคงไม่ตรงกันหลังรีเฟรช

การยกเลิกแบบกลุ่มของ eZee แสดงข้อผิดพลาด PMS ชั่วคราว

สิ่งที่คุณเห็น: การยกเลิกการจองแบบกลุ่มก่อนเข้าพักแสดง 503 หรือข้อความว่า PMS ใช้งานไม่ได้ชั่วคราว ข้อความจะระบุห้องที่ยังยกเลิกไม่ได้และแสดงรายการห้องที่ยกเลิกไปแล้ว

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

วิธีแก้:

1. เปิดการจองแบบกลุ่มใน eZee

2. ตรวจสอบสถานะการยกเลิกของทุกห้อง

3. รอให้ eZee ตอบสนองได้ตามปกติ

4. รีเฟรชการจองใน AVA

5. ลองยกเลิกอีกครั้งหนึ่ง

6. ยืนยันว่าทุกห้องถูกยกเลิกใน eZee

   ✓ AVA จะเก็บหมายเลขยืนยันของการจองหลักไว้ และจะไม่ถือว่าการยกเลิกที่ไม่เสร็จสมบูรณ์สำเร็จ

อย่าเพิ่งสร้างการจองทดแทน

ตรวจสอบทุกห้องใน eZee ก่อนสร้างการจองทดแทน บางห้องอาจยกเลิกสำเร็จแล้ว ขณะที่อีกห้องยังใช้งานอยู่

ยังติดขัดอยู่?

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

• ❌ การซิงก์ยังว่างเปล่าหลังผ่านไป 30 นาที
• ❌ Auth Code ถูกปฏิเสธซ้ำหลายครั้ง
• ❌ การยกเลิกแบบกลุ่มยังไม่เสร็จสมบูรณ์หลัง eZee กลับมาใช้งานได้

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

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

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

• ปัญหาการซิงก์ PMS
• กฎการเช็กอิน
• แดชบอร์ด Housekeeping