ข้อผิดพลาดในการเชื่อมต่อ PMS

ตรวจสอบอย่างรวดเร็ว

ปัญหาการเชื่อมต่อส่วนใหญ่ใช้เวลายืนยัน 5-10 นาที หากเห็น 429 ให้รอเวลาที่ระบุให้ลองใหม่ก่อนดำเนินการอีกครั้ง

ใช้คู่มือนี้เมื่อ AVA เชื่อมต่อไม่ได้ แสดงการจำกัดชั่วคราว หรือรายงานว่า PMS ปฏิเสธคำขอ

การลองใหม่อัตโนมัติ

ขณะนี้ AVA จะลองคำขออ่านข้อมูล PMS ระยะสั้นบางรายการใหม่โดยอัตโนมัติ Opera OAuth จะลองใหม่อีกหนึ่งครั้งเมื่อเกิด timeout หรือ gateway error ชั่วคราว ระหว่างการเช็กอิน AVA จะลองใหม่โดยอัตโนมัติเมื่อเกิด reservation conflict และ rate limit ของ PMS ชั่วคราวระหว่างการจัดสรรห้องและการเช็กอินขั้นสุดท้าย คุณอาจไม่เห็นข้อผิดพลาดเครือข่ายที่เกิดขึ้นเพียงครั้งเดียว Cloudbeds จะไม่ลองใหม่อัตโนมัติเมื่อข้อมูลรับรอง webhook ล้มเหลว

ข้อความ PMS ที่คงเดิม

หาก AVA แสดงข้อผิดพลาด PMS โดยเฉพาะระหว่างการรีเฟรช ให้ใช้ข้อความนั้น Streamliner จะเก็บคำตอบเดิมจาก PMS ไว้แทนที่จะแทนด้วยข้อผิดพลาดทางเทคนิคทั่วไป

ข้อความแสดงข้อผิดพลาดทั่วไป

ข้อผิดพลาด	ความหมาย	สิ่งที่ควรทำ
"Please fill all required PMS fields"	ข้อมูลในช่องที่จำเป็นสำหรับ PMS ที่เลือกหายไป	กรอกช่องที่จำเป็นซึ่งแสดงสำหรับผู้ให้บริการรายนั้นให้ครบ
"Failed to save PMS Integration"	ข้อผิดพลาดในการเชื่อมต่อหรือการตรวจสอบสิทธิ์	ตรวจสอบบัญชี PMS และสิทธิ์ของคุณอีกครั้ง
"Failed to save settings before connecting"	การตั้งค่า Essentials อื่นล้มเหลวก่อนเริ่ม OAuth	อ่านข้อความทั้งหมด แก้การตั้งค่านั้น แล้วเชื่อมต่ออีกครั้ง
"Unable to communicate with the property management system"	ปัญหาเครือข่ายหรือ API	รีเฟรชหนึ่งครั้ง แล้วทดสอบการเชื่อมต่ออีกครั้ง
"429" หรือ "rate limited"	PMS หรืองบประมาณคำขอของ AVA เองขอให้ลองใหม่ภายหลัง	รอขณะที่ AVA ลองการดำเนินการเช็กอินใหม่โดยอัตโนมัติ หรือทำตามเวลาที่แสดงให้ลองใหม่
"409" หรือ "Conflict"	PMS ปฏิเสธการดำเนินการเพราะสถานะการจองหรือคำขอไม่อนุญาต	อ่านเหตุผลจาก PMS แก้ไขการจอง แล้วลองใหม่หนึ่งครั้ง
PMS_RESERVATION_MUTATION_IN_PROGRESS	การอัปเดตการจองระยะสั้นใน PMS ซ้อนทับกับการจัดสรรห้องหรือการเช็กอินขั้นสุดท้าย	รอสักครู่ รีเฟรชการจอง แล้วลองขั้นตอนที่ได้รับผลกระทบใหม่หนึ่งครั้ง
"502" หรือ "Bad Gateway"	Cloudbeds, Opera หรือ PMS อื่นล้มเหลวระหว่างการอ่านหรือเขียนข้อมูล	อ่านสาเหตุ รีเฟรชหนึ่งครั้ง แล้วลองการดำเนินการอีกครั้ง
"503" หรือ "Service Unavailable"	บริการ PMS หรือเครือข่ายไม่สามารถดำเนินการตามคำขอได้ชั่วคราว	ตรวจสอบสถานะ PMS รีเฟรชหนึ่งครั้ง แล้วลองการดำเนินการอีกครั้ง
"non-reservations payload"	eZee ส่งเว็บไซต์หรือการตอบกลับอื่นแทนข้อมูลการจอง	ตรวจสอบ Base URL ของ eZee และเว้นว่างไว้สำหรับ API มาตรฐาน
"Unsupported Cloudbeds version"	คำขอเลือก Cloudbeds v1 หรือ v2 ที่เลิกใช้งานแล้ว	ลบการกำหนดเวอร์ชัน แล้วเริ่มการเชื่อมต่อใหม่
"You don't have access to property ID" หรือ "success:false"	Cloudbeds บล็อก property หรือส่งกลับว่าการเข้าถึงล้มเหลวเชิงตรรกะ	ยืนยัน Cloudbeds property ที่ถูกต้อง แล้วรอหนึ่งนาทีก่อนลองใหม่
"webhook credentials rejected"	Cloudbeds ยอมรับการเข้าสู่ระบบ แต่ปฏิเสธการตั้งค่า webhook	เชื่อมต่อ Cloudbeds อีกครั้ง แล้วบันทึกการตั้งค่าใหม่
"PMS cache unavailable" หรือข้อผิดพลาดการล้างแคช	AVA ยืนยันการตั้งค่า PMS ใหม่ข้ามบริการต่าง ๆ ไม่ได้	รอหนึ่งนาที แล้วบันทึกอีกครั้ง หากยังเกิดซ้ำให้ติดต่อฝ่ายสนับสนุน
611 หรือ "Invalid Auth Code or Hotel Code"	eZee ปฏิเสธภาพข้อมูลรับรองเดิมหลังมีการเปลี่ยนข้อมูลรับรอง	บันทึก Hotel Code และ Auth Code ที่ตรงกัน แล้วลองใหม่หนึ่งครั้ง
"reservationOverlapTo must be greater than reservationOverlapFrom"	PMS ปฏิเสธช่วงเวลาการซ้อนทับของการพักต่อ	อัปเดตค่าการซ้อนทับใน PMS แล้วรีเฟรช

ปัญหาการเชื่อมต่อชั่วคราว

สิ่งที่เห็น: ข้อผิดพลาดการเชื่อมต่อครั้งเดียว timeout หรือการตอบกลับว่างเปล่า

สาเหตุ: AVA จะลองคำขออ่านข้อมูล PMS ระยะสั้นบางรายการใหม่โดยอัตโนมัติ นอกจากนี้ยังลองใหม่หนึ่งครั้งเมื่อเกิดข้อผิดพลาด Opera OAuth ชั่วคราว timeout หรือ gateway error อาจใช้เวลาสูงสุด 30 วินาทีก่อนจะแสดงข้อผิดพลาด บน Opera การอ่านหรือเขียนข้อมูล housekeeping ที่หลุดอาจแสดงเป็น 502

วิธีแก้:

1. รีเฟรชหน้าหนึ่งครั้ง

2. ลองดำเนินการอีกครั้ง

3. หากยังล้มเหลว ให้ตรวจสอบการเชื่อมต่อ PMS

4. หากข้อผิดพลาดเดิมยังกลับมา ให้ติดต่อฝ่ายสนับสนุน

   ✓ ปัญหาที่เกิดขึ้นเพียงครั้งเดียวมักหายได้โดยไม่ต้องเปลี่ยนการตั้งค่า

คำขอ PMS ใช้เวลานานเกินไป

สิ่งที่เห็น: การดำเนินการ PMS รออยู่ แล้วแสดง timeout หรือข้อผิดพลาดการเชื่อมต่อ

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

วิธีแก้:

1. รอให้ข้อความ timeout ปรากฏ

2. รีเฟรชการจองหรือหน้าก่อนลองอีกครั้ง

3. ตรวจสอบการจองใน PMS ก่อนทำซ้ำการดำเนินการเขียนข้อมูล

4. ลองการดำเนินการใหม่หนึ่งครั้ง

5. ติดต่อฝ่ายสนับสนุนหาก timeout กลับมาอีก

   ✓ การดำเนินการ PMS ควรเสร็จสิ้นหรือส่งคืนข้อผิดพลาดที่ชัดเจนภายในประมาณหนึ่งนาที

ตรวจสอบก่อนลองใหม่

อย่าทำซ้ำการอัปเดตการจองขณะที่ยังไม่ทราบผลลัพธ์ ยืนยันสถานะการจองใน PMS ก่อน แล้วจึงลองใหม่หนึ่งครั้ง

การอ่านข้อมูล PMS ใช้ข้อมูลสำรอง

สิ่งที่เห็น: AVA ดำเนินการต่อโดยมีรายละเอียดน้อยลงหลังการอ่านข้อมูล PMS ใช้เวลานานเกินไป

สาเหตุ: การอ่านข้อมูลที่เลือกไว้จะยอมให้ขั้นตอนดำเนินต่อได้เมื่อการอ่านล้มเหลว เพื่อให้ขั้นตอนของผู้เข้าพักหรือพนักงานดำเนินต่อ ข้อมูลสำรองอาจแสดงการจองที่ไม่ได้เติมรายละเอียด หรือผลการค้นหาที่เรียบง่ายกว่า การอ่านข้อมูลความสามารถอาจรายงานฟีเจอร์ว่าไม่พร้อมใช้งานชั่วคราว

สิ่งที่เห็น	สาเหตุ	วิธีแก้
รายละเอียดการจองดูไม่ครบ	ไม่ได้รับรายละเอียดประเภทห้องทันเวลา	รีเฟรชการจองแล้วลองอีกครั้ง
การค้นหาของพนักงานแสดงรายละเอียดผู้เข้าพักน้อยลง	การค้นหาโปรไฟล์ใช้ข้อมูลสำรองจากชื่อการจอง	รีเฟรชหน้าแล้วค้นหาอีกครั้ง
ขั้นตอนที่ขึ้นอยู่กับวันที่แสดงวันที่ไม่ถูกต้อง	ไม่ได้รับวันที่ทำการของ PMS ทันเวลา	รีเฟรช แล้วตรวจสอบวันที่ทำการใน PMS
ไม่พบ Group Checkout	ไม่มีข้อมูลความสามารถระหว่างการอ่าน	รีเฟรช แล้วตรวจสอบการเชื่อมต่อ PMS
ไม่อนุญาตให้ย้ายห้องที่รองรับ	AVA ยืนยันความสามารถที่จำเป็นไม่ได้	รีเฟรช แล้วลองใหม่หนึ่งครั้ง

ตรวจสอบ PMS ก่อนทำซ้ำการเขียนข้อมูล

ข้อมูลสำรองเหล่านี้ใช้กับการอ่านข้อมูล หากการเขียนข้อมูล timeout ให้ตรวจสอบ PMS ก่อนลองใหม่

ข้อผิดพลาด Opera แสดงสาเหตุจากระบบต้นทาง

สิ่งที่เห็น: การดำเนินการของ Opera แสดง "Bad Gateway" หรือ "Service Unavailable (503)"

สาเหตุ: Opera หรือ gateway ส่งการตอบกลับข้อผิดพลาดที่ไม่ใช่ JSON AVA จะแสดงข้อความตอบกลับสั้น ๆ เมื่อมี หรือแสดงสถานะ HTTP เมื่อไม่มีข้อความ

วิธีแก้:

1. อ่านข้อความข้อผิดพลาดทั้งหมดและจดรหัสสถานะ
2. หากกำลังเพิ่ม sharer ให้ตรวจสอบ Opera ก่อนลองใหม่
3. สำหรับการดำเนินการอื่น ให้รีเฟรช AVA หนึ่งครั้ง แล้วลองใหม่
4. ตรวจสอบ Opera และ AVA หากข้อผิดพลาดเดิมกลับมา
5. ติดต่อฝ่ายสนับสนุนหากข้อผิดพลาดยังดำเนินต่อ

ตรวจสอบ sharer ก่อนลองใหม่

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

PMS ปฏิเสธและแสดงเป็น Conflict

สิ่งที่เห็น: การดำเนินการแสดง 409, "Conflict" หรือการปฏิเสธโดย PMS โดยเฉพาะ ข้อผิดพลาดนี้จะไม่แสดงเป็นข้อผิดพลาดเซิร์ฟเวอร์ทั่วไปอีกต่อไป

สาเหตุ: PMS ปฏิเสธการดำเนินการเพราะกฎของการจองไม่ผ่าน AVA จะคงสถานะและข้อความจากระบบต้นทางไว้ เพื่อให้คุณแก้สาเหตุได้ การตอบกลับ 409 ส่วนใหญ่จะเกิดถาวรสำหรับคำขอนั้น รหัส PMS_RESERVATION_MUTATION_IN_PROGRESS เป็นข้อยกเว้นชั่วคราวระหว่างการจัดสรรห้องหรือการเช็กอินขั้นสุดท้าย

วิธีแก้:

1. อ่านข้อความ PMS ทั้งหมด

2. เปิดการจองใน PMS

3. แก้ปัญหาที่ข้อความระบุ

4. สำหรับการปฏิเสธการยกเลิก ให้ตรวจสอบว่าการเข้าพักเช็กอินแล้ว ถึงกำหนดออก หรือเช็กเอาต์แล้ว

5. ดำเนินขั้นตอนเช็กเอาต์ที่จำเป็นใน PMS ให้เสร็จก่อนลองยกเลิกการจองที่เข้าพักอยู่ใหม่

6. รีเฟรช AVA

7. ลองการดำเนินการใหม่หนึ่งครั้ง

8. หาก PMS ยังคงปฏิเสธ ให้ดำเนินการใน PMS แล้วติดต่อฝ่ายสนับสนุน

   ✓ AVA ควรแสดงสถานะการจองที่อัปเดตแล้วหลัง PMS ยอมรับการดำเนินการ

การเปลี่ยนแปลงการจองยังดำเนินอยู่

สิ่งที่เห็น: การจัดสรรห้องหรือการเช็กอินขั้นสุดท้ายแสดง PMS_RESERVATION_MUTATION_IN_PROGRESS

สาเหตุ: การอัปเดตการจองใน PMS กำลังถือครองการจองไว้ชั่วคราว เหตุการณ์นี้อาจเกิดหลังการยืนยันผู้เข้าพัก การอัปโหลดหนังสือเดินทาง หรือการอัปเดตการจองอื่น AVA จะลองความขัดแย้งนี้ใหม่โดยอัตโนมัติในช่วงเวลาสั้น ๆ

วิธีแก้:

1. รอสักครู่ให้การอัปเดต PMS เสร็จสิ้น

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

3. ลองขั้นตอนที่ได้รับผลกระทบใหม่หนึ่งครั้ง

   ✓ ขั้นตอนที่ได้รับผลกระทบควรดำเนินต่อหลังการอัปเดตการจองเสร็จสิ้น

หากรหัสยังคงอยู่หลังลองใหม่ ให้ติดต่อฝ่ายสนับสนุน แนบหมายเลขการจอง ผู้ให้บริการ PMS และข้อความข้อผิดพลาดทั้งหมด

ข้อผิดพลาดการตรวจสอบ PMS ระหว่างรีเฟรช

สิ่งที่เห็น: ข้อความ PMS ปรากฏระหว่างการรีเฟรช stayover เช่น reservationOverlapTo must be greater than reservationOverlapFrom

สาเหตุ: PMS ปฏิเสธคำขอเพราะกฎการตรวจสอบข้อใดข้อหนึ่งล้มเหลว

วิธีแก้:

1. อ่านข้อความ PMS ให้ตรงตามต้นฉบับ

2. ตรวจสอบการตั้งค่าที่เกี่ยวข้องใน PMS

3. แก้ค่าที่ตรวจสอบไม่ผ่าน

4. รีเฟรช AVA หนึ่งครั้ง

   ✓ คุณจะเห็นข้อความเดิมจาก PMS จนกว่าจะแก้ข้อมูลใน PMS ให้ถูกต้อง

---

การเชื่อมต่อล้มเหลว

สิ่งที่เห็น: ข้อความข้อผิดพลาดเมื่อคลิก Connect

ตรวจสอบสิ่งเหล่านี้ก่อน

1. ตรวจสอบว่าข้อมูลรับรองถูกต้อง

   • ตรวจสอบ API key หรือข้อมูลรับรองไคลเอนต์อีกครั้ง
   • ตรวจสอบว่าไม่มีช่องว่างเกินก่อนหรือหลังข้อมูลรับรอง
   • ยืนยันว่าข้อมูลรับรองยังไม่หมดอายุ

2. ยืนยันสิทธิ์ API

   • เข้าสู่ระบบพอร์ทัลผู้ดูแลระบบ PMS
   • ตรวจสอบว่าเปิดใช้การเข้าถึง API สำหรับบัญชีแล้ว
   • ตรวจสอบว่าได้รับสิทธิ์ integration แล้ว

3. ตรวจสอบการเชื่อมต่ออินเทอร์เน็ต

   • ลองรีเฟรชหน้า
   • ทดสอบส่วนอื่นของ AVA เพื่อยืนยันการเชื่อมต่อ

ลองทำสิ่งนี้

1. ไปที่ Settings → Essentials
2. คลิก Disconnect (หากเชื่อมต่ออยู่)
3. รอ 30 วินาที
4. ป้อนข้อมูลรับรองอีกครั้ง
5. คลิก Connect อีกครั้ง

Cloudbeds บันทึกไม่สำเร็จก่อน OAuth

สิ่งที่เห็น: "Failed to save settings before connecting: ..."

สาเหตุ: AVA บันทึกการเปลี่ยนแปลง Essentials อื่นที่ยังไม่ได้บันทึกก่อนเริ่ม OAuth ของ Cloudbeds ข้อความโดยละเอียดจะระบุการตั้งค่าที่ล้มเหลว

วิธีแก้:

1. อ่านแบนเนอร์ข้อผิดพลาดทั้งหมด

2. แก้การตั้งค่าที่ข้อความระบุ

3. บันทึกการตั้งค่าหาก AVA แสดงการดำเนินการบันทึก

4. เลือก Connect to Cloudbeds อีกครั้ง

   ✓ Cloudbeds จะเปิดขึ้นหลังการบันทึกก่อนเชื่อมต่อสำเร็จ

การแลกเปลี่ยน Cloudbeds OAuth ล้มเหลว

สิ่งที่เห็น: การเชื่อมต่อแสดง Version is required หรือปฏิเสธการแลกเปลี่ยน authorization code

สาเหตุ: authorization code ของ Cloudbeds ใช้ได้ครั้งเดียว

การเรียก callback ที่ล้มเหลวไม่สามารถเล่นซ้ำได้ ขณะนี้ AVA จะกำหนดค่าเริ่มต้นของ Cloudbeds OAuth version ที่ไม่ได้ระบุเป็น v3

วิธีแก้:

1. ไปที่ Settings → Essentials

2. เลือก Connect to Cloudbeds

3. เข้าสู่ระบบ Cloudbeds แล้วเลือก Authorize หรือ Allow

4. ดำเนินการเชื่อมต่อให้เสร็จ Cloudbeds จะสร้าง authorization code ใหม่

5. ติดต่อฝ่ายสนับสนุนหากการเชื่อมต่อใหม่ล้มเหลวอีกครั้ง

   ✓ การเชื่อมต่อ Cloudbeds ควรเสร็จโดยไม่ขอให้ป้อนเวอร์ชัน

Cloudbeds v1 หรือ v2 ถูกปฏิเสธ

สิ่งที่เห็น: AVA แสดงข้อผิดพลาดว่า Cloudbeds version ไม่รองรับ

สาเหตุ: adapter ของ Cloudbeds v1 และ v2 เลิกใช้งานแล้ว การกำหนดเส้นทาง Cloudbeds ที่ไม่ระบุเวอร์ชันใช้ v3

วิธีแก้:

1. ลบการตั้งค่าหรือการกำหนด Cloudbeds version ที่ระบุไว้

2. ขอให้ผู้ดูแล integration ลบ caller pin ของ v1 หรือ v2

3. ไปที่ Settings → Essentials

4. เลือก Connect to Cloudbeds และดำเนินการอนุญาตอีกครั้ง

   ✓ การเชื่อมต่อใหม่จะใช้ Cloudbeds v3

การบันทึกการตั้งค่า PMS ไม่เสร็จสมบูรณ์

สิ่งที่เห็น: AVA รับรายละเอียด PMS แล้วแสดงข้อผิดพลาดแคชหรือบริการ

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

วิธีแก้:

1. รอหนึ่งนาทีก่อนลองใหม่

2. รีเฟรช Settings → Essentials → PMS Integration

3. ปล่อยข้อมูลรับรองที่ถูกปิดบังไว้เหมือนเดิม เว้นแต่กำลังเปลี่ยนข้อมูลเหล่านั้น

4. คลิก Save อีกครั้ง

5. ยืนยันข้อความสำเร็จก่อนใช้ขั้นตอนที่ขับเคลื่อนด้วย PMS

   ✓ ข้อมูลรับรองใหม่ควรทำงานกับเซิร์ฟเวอร์ AVA ทั้งหมดหลังบันทึกสำเร็จ

ติดต่อฝ่ายสนับสนุนหากข้อผิดพลาดเดิมปรากฏหลังลองสามครั้ง แนบข้อความข้อผิดพลาดทั้งหมด ผู้ให้บริการ PMS และเวลาที่บันทึกล้มเหลว

eZee Code 611 หลังเปลี่ยนข้อมูลรับรอง

สิ่งที่เห็น: eZee ส่ง 611, "Invalid Auth Code or Hotel Code" หลังอัปเดตข้อมูลรับรอง PMS

สาเหตุ: คำขอ PMS เก่าอาจยังดำเนินการด้วยภาพข้อมูลรับรองเดิมไม่เสร็จ AVA จะทำให้ภาพข้อมูลรับรองนั้นใช้ไม่ได้หลังการบันทึก

วิธีแก้:

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

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

3. บันทึกข้อมูลรับรองที่อัปเดต

4. รอข้อความสำเร็จ

5. ลองการดำเนินการ PMS ใหม่หนึ่งครั้ง

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

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

ถึงขีดจำกัดการเรียกใช้งาน

สิ่งที่เห็น: ข้อผิดพลาด 429 ข้อความ rate limit หรือคำขอที่มีเวลาที่ควรลองใหม่

สาเหตุ: Cloudbeds หรืองบประมาณคำขอของ AVA เองกำลังจำกัดคำขอชั่วคราว AVA จะเก็บเวลาที่ควรลองใหม่จากแหล่งใดแหล่งหนึ่งเมื่อมีข้อมูล AVA ยังแยกงบประมาณคำขอตามพื้นที่ฟีเจอร์ต่าง ๆ ทำให้หน้าใดหน้าหนึ่งที่มีการใช้งานมากมีโอกาสทำให้หน้าอื่นช้าลงน้อยกว่าเดิม ขณะนี้คำขอที่ผู้เข้าพักเห็นบางรายการจะรอสักครู่เมื่อ bucket ของ AVA เองว่าง การรอนี้ใช้เฉพาะ burst ระยะสั้นภายในระบบ ไม่รวมช่วง cooldown ของผู้ให้บริการ หาก Cloudbeds ส่ง access error เดิมหลายครั้ง AVA จะหยุดการลองครั้งถัดไปชั่วครู่ การจัดสรรห้องและการเช็กอินขั้นสุดท้ายจะลองใหม่โดยอัตโนมัติเมื่อเกิด 429 จาก PMS ชั่วคราว การดำเนินการเหล่านี้อาจใช้เวลาเพิ่มอีกหลายวินาทีก่อนจะดำเนินการต่อหรือแสดงข้อผิดพลาด

การแยกผลกระทบของ rate limit

หากหน้าใดหน้าหนึ่งแสดง 429 ซ้ำ ๆ ปัญหามักจำกัดอยู่ที่หน้านั้นหรือพื้นที่ฟีเจอร์นั้น ส่วนอื่นของ AVA อาจยังทำงานตามปกติระหว่างรอ

วิธีแก้:

1. รอเวลาที่แสดงในข้อผิดพลาดให้ลองใหม่

2. รีเฟรชหน้าหนึ่งครั้ง

3. ลองการดำเนินการอีกครั้ง

4. หากปัญหาเกิดซ้ำ ให้รอสักครู่ก่อนลองใหม่

5. หากไม่แสดงเวลาที่ควรลองใหม่ ให้ถือว่าเป็นการจำกัดชั่วคราวระยะสั้น แล้วลองภายหลัง

   ✓ คำขอควรสำเร็จหลังเวลาที่ควรลองใหม่ผ่านไปและมีงบประมาณคำขอพร้อมใช้งาน

ระหว่างการจัดสรรห้องหรือการเช็กอินขั้นสุดท้าย

ปล่อยให้การดำเนินการปัจจุบันเสร็จสิ้นก่อนเลือก Retry หาก AVA ยังคงแสดงข้อผิดพลาดการจัดสรรห้องที่เข้าใจได้ ให้ตรวจสอบการจองใน PMS จากนั้นรีเฟรช AVA แล้วลองขั้นตอนที่ได้รับผลกระทบใหม่หนึ่งครั้ง

ข้อผิดพลาดการเข้าถึง Cloudbeds

สิ่งที่เห็น: ข้อความการเข้าถึง Cloudbeds เช่น You don't have access to property ID ยังคงกลับมา

สาเหตุ: บัญชี Cloudbeds ที่เชื่อมต่อไม่สามารถอ่าน property นั้นได้ AVA จะหยุดการลองซ้ำเพื่อไม่ให้ความล้มเหลวเดิมส่งคำขอไปยัง Cloudbeds มากเกินไป

วิธีแก้:

1. ยืนยันว่าล็อกอินอยู่ใน Cloudbeds property ที่ถูกต้อง

2. ขอให้ผู้ดูแล Cloudbeds ตรวจสอบการเข้าถึง property และสิทธิ์

3. รอหนึ่งนาทีก่อนลองใหม่

4. รีเฟรชหนึ่งครั้งหลังแก้ปัญหาการเข้าถึงแล้ว

   ✓ การเชื่อมต่อครั้งถัดไปควรสำเร็จหลัง Cloudbeds ยอมรับคำขอ

สิ่งที่เห็น → วิธีแก้

สิ่งที่เห็น	วิธีแก้
ข้อผิดพลาดปรากฏครั้งเดียว	รอเวลาที่ควรลองใหม่ แล้วลองอีกครั้ง
ข้อผิดพลาดกลับมาเรื่อย ๆ	หยุดรอสักครู่ แล้วลองใหม่
ยังโหลดการจองไม่ได้	ตรวจสอบ ปัญหาการซิงก์

ข้อมูลรับรอง Cloudbeds Webhook ถูกปฏิเสธ

สิ่งที่เห็น: Cloudbeds ยอมรับการเชื่อมต่อเรื่อยมา แต่การซ่อมแซม webhook ล้มเหลวหลังบันทึกการตั้งค่า

สาเหตุ: Cloudbeds ยอมรับการเข้าสู่ระบบ แต่ไม่ยอมรับสิทธิ์ webhook ที่ AVA ต้องใช้

วิธีแก้:

1. เชื่อมต่อ Cloudbeds ใหม่จาก Settings → Essentials

2. ดำเนินการตามหน้าต่างอนุญาต Cloudbeds อีกครั้ง

3. บันทึกการตั้งค่า pre-arrival ที่ใช้งานอยู่อีกครั้ง

4. ขอให้ผู้ดูแล Cloudbeds ตรวจสอบสิทธิ์ของแอปหากยังล้มเหลว

   ✓ หลังรีเฟรชสิทธิ์แล้ว การซ่อมแซม webhook ควรเสร็จตามปกติ

---

การจองไม่ซิงค์

สิ่งที่เห็น: ไม่มีรายการจองหลังเชื่อมต่อ หรือมีรายการจองหายไป

การแก้ไขด่วน

1. คลิก Refresh ใน Operations View
2. รอ 5-10 นาทีให้การซิงก์ครั้งแรกเสร็จ
3. ตรวจสอบว่าใน PMS มีรายการจองสำหรับวันนี้

ตรวจสอบการตั้งค่า PMS

1. ไปที่ Settings → Essentials
2. เลื่อนไปที่ส่วน PMS Integration
3. ตรวจสอบว่าสถานะการเชื่อมต่อแสดงเป็น "Connected"
4. ตรวจสอบว่าตั้งค่าการซิงก์ถูกต้อง

ยังไม่ทำงานใช่ไหม?

• ยืนยันวันที่ของการจองตรงกับวันที่กำลังดูใน AVA
• ตรวจสอบว่าสถานะการจองใน PMS อนุญาตให้ซิงก์ (ยืนยันแล้ว ไม่ได้ยกเลิก)
• ตรวจสอบว่าจำนวนผู้เข้าพักมากกว่า 0

---

ความล่าช้าในการซิงก์

สิ่งที่เห็น: รายการจองปรากฏล่าช้า

พฤติกรรมปกติ

ระบบ PMS ส่วนใหญ่ซิงก์ทุก 5-15 นาที ความพร้อมใช้งานของการซิงก์แบบเรียลไทม์ขึ้นอยู่กับ:

• ระดับแพ็กเกจ PMS
• ผู้ให้บริการ PMS รายที่ใช้งาน

ลดความล่าช้า

1. ใช้การรีเฟรชด้วยตนเองเมื่อจำเป็น
2. ติดต่อผู้ให้บริการ PMS เกี่ยวกับการเข้าถึง API แบบเรียลไทม์
3. ตั้งเวลาซิงก์ในช่วงที่มีกิจกรรมน้อย

---

ข้อผิดพลาดในการยืนยันตัวตน

สิ่งที่เห็น: "Invalid credentials" หรือ "Authentication failed"

สำหรับ Cloudbeds

1. เข้าสู่ระบบ Cloudbeds
2. ไปที่ Settings → Integrations → API
3. สร้างข้อมูลรับรอง API ใหม่
4. คัดลอกข้อมูลรับรองให้ตรงทุกตัวอักษร (ใช้ปุ่มคัดลอกถ้ามี)
5. วางลงใน AVA โดยไม่แก้ไข

สำหรับ Opera Cloud

1. รอสูงสุด 30 วินาทีให้ AVA ลองใหม่อัตโนมัติเสร็จ การดำเนินการนี้ครอบคลุม timeout หรือ gateway error ชั่วคราวของ OAuth หนึ่งครั้ง

2. ลองการดำเนินการใหม่เฉพาะเมื่อข้อผิดพลาดยังคงอยู่

3. ตรวจสอบว่า environment URL ถูกต้อง (test เทียบกับ production)

4. ยืนยัน client ID, client secret, hotel ID และ enterpriseId

5. ป้อนข้อมูลรับรองอีกครั้งใน Settings → Essentials → PMS Integration แล้วคลิก Save

6. ติดต่อผู้แทน Oracle หากยังพบข้อผิดพลาด

   ✓ ความล้มเหลวชั่วคราวหรือข้อมูลรับรองที่แคชไว้ซึ่งเกิดขึ้นครั้งเดียวอาจหายได้โดยไม่ต้องตัดการเชื่อมต่อ Opera

สำหรับ Mews

1. เข้าสู่ระบบ Mews Commander
2. ไปที่ Settings → Integrations
3. ค้นหา Vouch AVA แล้วสร้าง access token ใหม่
4. อัปเดต token ในการตั้งค่า AVA

---

เมื่อใดควรติดต่อฝ่ายสนับสนุน

ติดต่อฝ่ายสนับสนุนหาก:

• ลองทำตามขั้นตอนแก้ปัญหาทั้งหมดแล้ว
• ข้อความข้อผิดพลาดอ้างถึงข้อผิดพลาดของระบบหรือปัญหาทางเทคนิค
• การเปลี่ยนแปลงใน PMS ไม่แสดงหลังผ่านไป 30 นาที

อีเมล: success@vouch-technologies.com

แนบข้อมูลต่อไปนี้:

• ภาพหน้าจอข้อความข้อผิดพลาด
• ประเภท PMS (Cloudbeds/Opera/Mews)
• เวลาที่เริ่มเกิดปัญหา
• ขั้นตอนที่ลองไปแล้ว

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

• การเชื่อมต่อ Cloudbeds
• การเชื่อมต่อ Opera
• การเชื่อมต่อ Mews
• ปัญหาการซิงก์