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

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

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

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

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

ขณะนี้ AVA จะลองคำขออ่านข้อมูล PMS ระยะสั้นบางรายการใหม่โดยอัตโนมัติ รวมถึงการจำกัดอัตราคำขอระยะสั้นหนึ่งครั้งระหว่างค้นหาการจอง คำขออ่านข้อมูลของ Mews ที่ส่งคืน 408 จะใช้เส้นทางการลองอ่านใหม่ด้วย คำขอของ Mews ใช้ช่วงเวลาลองใหม่ที่มีขอบเขต จึงไม่ทำให้ Housekeeping ต้องรออย่างไม่มีกำหนดเมื่อ PMS ตอบช้า Opera OAuth จะลองใหม่อีกหนึ่งครั้งเมื่อเกิด timeout หรือ gateway error ชั่วคราว ระหว่างการเช็กอิน AVA จะลองใหม่โดยอัตโนมัติเมื่อเกิด reservation conflict และ rate limit ของ PMS ชั่วคราวระหว่างการจัดสรรห้องและการเช็กอินขั้นสุดท้าย การอัปเดตผู้เข้าพักใน Opera จะลองใหม่เมื่อเกิดการล็อกการจองชั่วคราวด้วย คำขอกู้คืนของ Mews จะลองใหม่โดยอัตโนมัติเมื่อเกิดข้อขัดแย้งในการดำเนินการชั่วคราวด้วยรหัส 403 การลองใหม่เหล่านี้อาจเพิ่มเวลาหลายวินาทีก่อนที่ AVA จะแสดงข้อผิดพลาด คุณอาจไม่เห็นข้อผิดพลาดเครือข่ายที่เกิดขึ้นเพียงครั้งเดียว 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	รีเฟรชหนึ่งครั้ง แล้วทดสอบการเชื่อมต่ออีกครั้ง
PMS_TEMPORARILY_UNAVAILABLE	PMS ไม่ตอบกลับระหว่างการจัดสรรห้อง	ตรวจสอบ PMS รอสักครู่ แล้วลองจัดสรรห้องใหม่หนึ่งครั้ง
PMS_ROOM_UNAVAILABLE	ห้องที่เลือกไม่พร้อมใช้งานสำหรับการเข้าพัก	เลือกห้องหรือวันที่อื่น รีเฟรช AVA แล้วลองใหม่หนึ่งครั้ง
PMS_RESERVATION_NO_AVAILABILITY	ไม่มีห้องประเภทที่เลือกว่างตลอดช่วงเข้าพัก	เลือกประเภทห้องหรือวันที่อื่น รีเฟรช AVA แล้วลองใหม่หนึ่งครั้ง
"Self check-in is not available at this property right now"	ที่พักยังไม่ได้เตรียมระบบสำหรับการเช็กอินของผู้เข้าพัก	ขอให้ผู้ดูแลเชื่อมต่อ PMS หรือดำเนินการตั้งค่า AVA PMS ให้เสร็จ
"429" หรือ "rate limited"	PMS หรืองบประมาณคำขอของ AVA เองขอให้ลองใหม่ภายหลัง	รอขณะที่ AVA ลองการดำเนินการเช็กอินใหม่โดยอัตโนมัติ หรือทำตามเวลาที่แสดงให้ลองใหม่
"409" หรือ "Conflict"	PMS ปฏิเสธการดำเนินการเพราะสถานะการจองหรือคำขอไม่อนุญาต	อ่านเหตุผลจาก PMS แก้ไขการจอง แล้วลองใหม่หนึ่งครั้ง
"403" พร้อมข้อความ "Conflicting operation is being performed"	Mews กำลังประมวลผลการดำเนินการอื่นชั่วคราว	รอสักครู่ขณะที่ AVA ลองใหม่ แล้วลองขั้นตอนที่ได้รับผลกระทบอีกครั้งหากจำเป็น
PMS_RESERVATION_MUTATION_IN_PROGRESS	การอัปเดตการจองระยะสั้นใน PMS ซ้อนทับกับการจัดสรรห้องหรือการเช็กอินขั้นสุดท้าย	รอสักครู่ รีเฟรชการจอง แล้วลองขั้นตอนที่ได้รับผลกระทบใหม่หนึ่งครั้ง
PMS_ROOM_ASSIGNMENT_OUTCOME_UNKNOWN	PMS อาจเปลี่ยนห้องแล้ว แต่ AVA ยืนยันการจัดสรรขั้นสุดท้ายไม่ได้	อย่าลองใหม่ ให้ตรวจสอบห้องและราคาใน PMS แล้วใช้การรีเฟรชห้องโดยเฉพาะก่อนส่งมอบกุญแจ
"Cannot check in reservation because assigned space is blocked"	Mews บล็อกพื้นที่ที่จัดสรรไว้	จัดสรรพื้นที่ที่พร้อมใช้งานใน Mews แล้วลองเช็กอินใหม่
"Assigned space is not available for check-in"	Mews ต้องการพื้นที่ที่ผ่านการตรวจสอบก่อนเช็กอิน	จัดสรรพื้นที่ที่ผ่านการตรวจสอบใน Mews แล้วลองเช็กอินใหม่
"502" หรือ "Bad Gateway"	Cloudbeds, Opera หรือ PMS อื่นล้มเหลวระหว่างการอ่านหรือเขียนข้อมูล	อ่านสาเหตุ รีเฟรชหนึ่งครั้ง แล้วลองการดำเนินการอีกครั้ง
"ava-pms returned 500 with an HTML error page"	gateway ต้นทางส่งหน้าเว็บชั่วคราวกลับมาแทนการตอบกลับจาก PMS	รีเฟรชหนึ่งครั้ง จากนั้นตรวจสอบ PMS และติดต่อฝ่ายสนับสนุนหากยังเกิดขึ้น
"503" หรือ "Service Unavailable"	บริการ PMS หรือเครือข่ายไม่สามารถดำเนินการตามคำขอได้ชั่วคราว	ตรวจสอบสถานะ PMS รีเฟรชหนึ่งครั้ง แล้วลองการดำเนินการอีกครั้ง
Mews API Error: Transaction has timed out.	Mews อ่านข้อมูลคลังห้องไม่เสร็จก่อนหมดช่วงเวลาลองใหม่	ตรวจสอบ Mews รีเฟรช Housekeeping แล้วติดต่อฝ่ายสนับสนุนหากยังเกิดขึ้น
504 Mews view-billing deadline exceeded	รายละเอียดการเรียกเก็บเงินจาก Mews มาไม่ทันขีดจำกัดการอ่านข้อมูลการเรียกเก็บเงินของ AVA	ตรวจสอบยอดคงเหลือที่บันทึกไว้ เปรียบเทียบกับ Mews แล้วรีเฟรชหนึ่งครั้ง
"non-reservations payload"	eZee ส่งเว็บไซต์หรือการตอบกลับอื่นแทนข้อมูลการจอง	ตรวจสอบ Base URL ของ eZee และเว้นว่างไว้สำหรับ API มาตรฐาน
"Unsupported Cloudbeds version"	คำขอเลือก Cloudbeds v1 หรือ v2 ที่เลิกใช้งานแล้ว	ลบการกำหนดเวอร์ชัน แล้วเริ่มการเชื่อมต่อใหม่
"You don't have access to property ID"	Cloudbeds บล็อก property	ยืนยัน Cloudbeds property ที่ถูกต้อง แล้วลองใหม่หลังคืนสิทธิ์การเข้าถึงแล้ว
"success:false" หากไม่มีข้อความว่าแอปถูกตัดการเชื่อมต่อ	Cloudbeds ส่งกลับความล้มเหลวเฉพาะของผู้ให้บริการ	อ่านข้อความทั้งหมด แล้วทำตามขั้นตอนกู้คืน Cloudbeds ที่เกี่ยวข้อง
"Application is not available to be connected"	ที่พักตัดการเชื่อมต่อแอป AVA ใน Cloudbeds	อนุญาต Cloudbeds สำหรับที่พักอีกครั้ง แล้วลองใหม่
"webhook credentials rejected"	Cloudbeds ยอมรับการเข้าสู่ระบบ แต่ปฏิเสธการตั้งค่า webhook	เชื่อมต่อ Cloudbeds อีกครั้ง แล้วบันทึกการตั้งค่าใหม่
"PMS cache unavailable" หรือข้อผิดพลาดการล้างแคช	AVA ยืนยันการตั้งค่า PMS ใหม่ข้ามบริการต่าง ๆ ไม่ได้	รอหนึ่งนาที แล้วบันทึกอีกครั้ง หากยังเกิดซ้ำให้ติดต่อฝ่ายสนับสนุน
การบันทึกการตั้งค่าล้มเหลวหลังงานบางส่วนเสร็จ	ขั้นตอนปลายทางหรือการรีเฟรชแคชล้มเหลวหลังการเขียนข้อมูลอีกรายการเสร็จสิ้น	ตรวจสอบ PMS ก่อนลองใหม่ แล้วรีเฟรช AVA
"Configuration is temporarily unavailable"	Command Center ดึงการกำหนดค่าของโรงแรมได้ไม่ครบ	รีเฟรช เข้าสู่ระบบอีกครั้งหากระบบขอ แล้วขอให้ผู้ดูแลตรวจสอบสิทธิ์
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 อาจใช้เวลาก่อนจะแสดงข้อผิดพลาด ขณะที่ AVA กำลังลองใหม่ Mews จะหยุดการลองใหม่ภายในช่วงเวลาที่กำหนด แทนที่จะลองต่อเป็นลำดับยาวนาน บน Opera การอ่านหรือเขียนข้อมูล housekeeping ที่หลุดอาจแสดงเป็น 502

วิธีแก้:

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

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

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

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

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

Command Center ไม่สามารถตรวจสอบการกำหนดค่าได้

สิ่งที่เห็น: Command Center แสดง Configuration is temporarily unavailable

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

วิธีแก้:

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

2. เข้าสู่ระบบอีกครั้งหาก AVA ขอให้ดำเนินการ

3. ขอให้ผู้ดูแลยืนยันสิทธิ์ของคุณในการเข้าถึงการกำหนดค่าของโรงแรม

4. ลองอีกครั้งภายหลังหากบริการไม่พร้อมใช้งานชั่วคราว

5. ติดต่อฝ่ายสนับสนุนหากการแจ้งเตือนยังคงอยู่

   ✓ ข้อความการตั้งค่า PMS จะแสดงหลังจาก AVA ดึงการกำหนดค่าทั้งหมดได้แล้วเท่านั้น

PMS ไม่พร้อมใช้งานชั่วคราวระหว่างการจัดสรรห้อง

สิ่งที่เห็น: การจัดสรรห้องแสดงข้อความว่า PMS ไม่พร้อมใช้งานชั่วคราว

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

วิธีแก้:

1. ตรวจสอบสถานะ PMS และเปิดการจองใน PMS

2. ยืนยันว่าการจัดสรรห้องยังไม่เสร็จก่อนลองใหม่

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

4. ลองจัดสรรห้องใหม่หนึ่งครั้ง

   ✓ AVA ควรจัดสรรห้องสำเร็จ หรือแสดงเหตุผลเฉพาะที่ทำให้ห้องยังไม่พร้อม

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

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

อย่าทำซ้ำการเขียนข้อมูลที่ผลลัพธ์ไม่ชัดเจน

ตรวจสอบการจองใน PMS ก่อนลองการดำเนินการใด ๆ ที่ผลลัพธ์ไม่ชัดเจน

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

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

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

วิธีแก้:

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

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

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

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

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

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

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

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

การรีเฟรชการเรียกเก็บเงินของ Mews ถึงขีดจำกัด

สิ่งที่เห็น: AVA แสดง 504 Mews view-billing deadline exceeded ระหว่างการเช็กอินด้วยตนเองหรือการรีเฟรชข้อมูลการเรียกเก็บเงิน

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

วิธีแก้:

1. เปรียบเทียบยอดคงเหลือที่แสดงกับใบแจ้งหนี้ฉบับเต็มใน Mews

2. รีเฟรชการจองใน AVA หนึ่งครั้ง

3. อย่าเรียกเก็บจำนวนเงินที่ Mews ไม่ได้ยืนยัน

4. ขอให้พนักงานแผนกต้อนรับดำเนินการเช็กอิน หากยอดคงเหลือยังไม่ชัดเจน

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

   ✓ ความล่าช้าชั่วคราวของการเรียกเก็บเงินใน Mews ควรส่งคืนผลลัพธ์ที่ชัดเจน แทนที่จะปล่อยให้การเช็กอินรอค้าง

การอ่านข้อมูล Housekeeping ของ Mews หมดเวลา

สิ่งที่เห็น: Housekeeping แสดง timeout ของ Mews เช่น Transaction has timed out.

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

วิธีแก้:

1. ตรวจสอบ Mews Commander ว่ามีเหตุขัดข้องหรือการตอบกลับช้าหรือไม่

2. รีเฟรช Housekeeping หลัง Mews กลับมาตอบสนองตามปกติ

3. อย่าถือว่ารายการห้องว่างที่ว่างเปล่าเป็นหลักฐานว่าห้องไม่พร้อมใช้งาน

4. ติดต่อฝ่ายสนับสนุนหาก timeout ยังดำเนินต่อหลัง Mews กู้คืนแล้ว

   ✓ Housekeeping ควรโหลดคลังห้องล่าสุดหลังการอ่านข้อมูลจาก Mews สำเร็จ

การบันทึกการชำระเงินจากการขายโดยตรงยังไม่แน่ชัด

สิ่งที่เห็น: การชำระเงินจากการขายโดยตรงหมดเวลา หรือ AVA ยืนยันไม่ได้ว่า PMS บันทึกการชำระเงินแล้ว

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

วิธีแก้:

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

2. ตรวจสอบว่าการชำระเงินปรากฏใน folio ที่ถูกต้องแล้วหรือไม่

3. อย่าส่งการชำระเงินอีกครั้งขณะที่ผลลัพธ์ยังไม่แน่ชัด

4. รีเฟรช AVA หลังยืนยันผลลัพธ์ใน PMS แล้ว

5. ติดต่อฝ่ายสนับสนุนเพื่อกระทบยอด หากไม่พบการชำระเงินหรือผลลัพธ์ยังไม่ชัดเจน

   ✓ ความล้มเหลวในการเตรียมการก่อนส่งคำขอสามารถกู้คืนได้จากการแจ้งเตือนว่าชำระเงินแล้วในภายหลัง

อย่าบันทึกการชำระเงินครั้งที่สองด้วยตนเอง

การตอบกลับจาก 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 อื่นด้วยตนเองขณะที่ยังไม่ทราบผลลัพธ์

การคัดลอกวิธีชำระเงินของ sharer ใน Opera ยังไม่ชัดเจน

สิ่งที่เห็น: มี sharer อยู่แล้ว แต่ AVA ยืนยันไม่ได้ว่าวิธีชำระเงินถูกคัดลอกแล้ว

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

วิธีแก้:

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

2. เปิดการจองของ sharer ใน Opera

3. ตรวจสอบว่ามีวิธีชำระเงินที่คัดลอกอยู่หรือไม่

4. อย่าคัดลอกวิธีชำระเงินซ้ำเมื่อผลลัพธ์จาก Opera ยังไม่ชัดเจน

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

   ✓ ความล้มเหลวที่ยืนยันแล้วสามารถลองใหม่ได้อย่างปลอดภัยในการดำเนินการถัดไปของ sharer

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

อย่าเพิ่มวิธีชำระเงินด้วยตนเองหลังเกิด timeout Opera อาจยอมรับคำขอเดิมไปแล้ว

AVA-PMS แสดงสรุปข้อผิดพลาด HTML

สิ่งที่เห็น: AVA แสดงข้อความ เช่น ava-pms returned 500 with an HTML error page: 502 Bad Gateway

สาเหตุ: gateway ต้นทางส่งหน้าข้อผิดพลาด HTML ระหว่างคำขอ PMS AVA จะคงชื่อหน้าไว้ แต่ลบมาร์กอัปของเว็บเพจออกจากข้อผิดพลาด

วิธีแก้:

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

2. ตรวจสอบการจองและ PMS ก่อนทำซ้ำการอัปเดตการจอง

3. ยืนยันสถานะ PMS แล้วลองการดำเนินการใหม่หนึ่งครั้ง

4. ติดต่อฝ่ายสนับสนุนหากข้อความนี้กลับมาอีก

   ✓ ข้อผิดพลาดควรแสดงสรุปสั้น ๆ แทนหน้าเว็บ

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 ปฏิเสธเนื่องจากไม่มีห้องว่าง

สิ่งที่เห็น: การย้ายห้องหรือการแก้ไขการจองแจ้งว่าห้องหรือประเภทห้องไม่พร้อมใช้งาน ข้อความอาจมี PMS_ROOM_UNAVAILABLE หรือ PMS_RESERVATION_NO_AVAILABILITY

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

วิธีแก้:

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

2. ตรวจสอบวันที่เข้าพัก ห้องที่จัดสรร และประเภทห้อง

3. เลือกห้องหรือประเภทห้องที่พร้อมใช้งาน หากจำเป็น

4. รีเฟรช Streamliner

5. ลองย้ายห้องหรือแก้ไขการจองใหม่หนึ่งครั้ง

   ✓ AVA จะคงการจัดสรรเดิมไว้เมื่อ PMS ปฏิเสธปลายทาง

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

อย่าทำซ้ำการเปลี่ยนแปลงที่ห้องไม่พร้อมใช้งาน

การส่งวันที่หรือห้องเดิมที่ไม่พร้อมใช้งานซ้ำอาจทำให้เกิดการปฏิเสธเดิม แก้ไขห้องว่างใน PMS ก่อน แล้วจึงลองใหม่หนึ่งครั้ง

ผลการจัดสรร Cloudbeds ไม่ชัดเจน

สิ่งที่เห็น: การย้ายห้องหรือการอัปเกรดใน Cloudbeds แสดงว่าผลการจัดสรรไม่ชัดเจน

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

วิธีแก้:

1. อย่าเลือกห้องเดิมหรือแผนการสลับเดิมอีกครั้ง

2. เปิดการจองแต่ละรายการที่ได้รับผลกระทบใน Cloudbeds

3. ตรวจสอบหมายเลขห้อง ประเภทห้อง วันที่ อัตรารายคืน และยอดรวมการเข้าพัก

4. ใช้การรีเฟรชห้องโดยเฉพาะใน AVA

5. อย่าส่งมอบกุญแจจนกว่า AVA จะแสดงห้องที่ PMS ยืนยันแล้ว

6. ติดต่อฝ่ายสนับสนุนหากข้อมูลห้องหรือมูลค่าทางการเงินใด ๆ ยังไม่ชัดเจน

   ✓ AVA สามารถล้างการจัดสรรที่ค้างจากเดิมได้หลังยืนยันสถานะใน PMS แล้ว

อย่าลองใหม่เมื่อผลลัพธ์ไม่ชัดเจน

การลองใหม่อาจสร้างการย้ายห้องอีกครั้งขณะที่การย้ายครั้งแรกยังหาข้อสรุปไม่ได้ ตรวจสอบ Cloudbeds ก่อน แล้วใช้การรีเฟรชห้องโดยเฉพาะ

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

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

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

วิธีแก้:

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

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

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

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

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

กำลังลองใหม่เมื่อ Mews เกิดข้อขัดแย้งในการดำเนินการ

สิ่งที่เห็น: Mews ส่งคืน 403 พร้อมข้อความ "Conflicting operation is being performed at this time."

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

วิธีแก้:

1. รอให้การดำเนินการ AVA ปัจจุบันเสร็จสิ้น

2. ตรวจสอบการจองใน Mews หากการดำเนินการยังแสดงข้อผิดพลาด

3. รีเฟรช AVA แล้วลองขั้นตอนเช็กอินที่ได้รับผลกระทบใหม่หนึ่งครั้ง

   ✓ การย้ายผู้เข้าพักหรือการกู้คืนการเช็กอินควรดำเนินต่อหลัง Mews ปลดล็อก

ติดต่อฝ่ายสนับสนุนหากข้อความเดิมยังคงอยู่หลังการลองใหม่

สถานะการเช็กอินของ Mews เปลี่ยนไป

สิ่งที่เห็น: Mews ปฏิเสธการเช็กอินเพราะการจองไม่ได้อยู่ในสถานะ Confirmed อีกต่อไป

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

วิธีแก้:

1. รอให้การดำเนินการ AVA ปัจจุบันเสร็จสิ้น

2. หากการจองอยู่ในสถานะ Started และมีห้องที่จัดสรรแล้ว ให้ดำเนินการต่อด้วยห้องที่แสดง

3. หากการจองไม่ได้อยู่ในสถานะ Started ให้รีเฟรช AVA และตรวจสอบการจองใน Mews

4. ลองเช็กอินใหม่เมื่อ Mews แสดงว่าการจองพร้อมแล้วเท่านั้น

   ✓ AVA จะไม่ทำซ้ำการเช็กอินเมื่อ Mews เริ่มการจองไปแล้ว

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

Mews ปฏิเสธพื้นที่ที่จัดสรร

สิ่งที่เห็น: Mews แจ้งว่าพื้นที่ที่จัดสรรถูกบล็อกหรือไม่พร้อมสำหรับเช็กอิน

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

วิธีแก้:

1. เปิดการจองใน Mews

2. จัดสรรพื้นที่ที่พร้อมใช้งาน

3. ยืนยันว่าพื้นที่ผ่านการตรวจสอบแล้วเมื่อ Mews กำหนดให้ต้องตรวจสอบ

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

5. ลองเช็กอินใหม่หนึ่งครั้ง

   ✓ AVA ควรเช็กอินสำเร็จหลัง Mews ยอมรับพื้นที่ที่จัดสรร

ติดต่อฝ่ายสนับสนุนหาก Mews แสดงพื้นที่ที่พร้อมใช้งานและผ่านการตรวจสอบแล้ว แต่ยังปฏิเสธการเช็กอิน

Opera ปฏิเสธค่าเพศที่ไม่รู้จัก

สิ่งที่เห็น: ก่อนหน้านี้ Opera แสดง Value N/A for field Gender exceeds the maximum length allowed.

สาเหตุ: รหัสเพศของ Opera แตกต่างกันตามที่พัก ค่าต่าง ๆ เช่น N/A ไม่ใช่รหัสที่ถูกต้องสำหรับบางที่พัก

วิธีแก้:

1. ลองอัปเดตข้อมูลผู้เข้าพักใน AVA ใหม่

2. AVA จะลบตัวแทนค่าที่ไม่รู้จักก่อนส่งการอัปเดต

3. AVA จะเก็บค่าเพศที่ถูกต้องซึ่งบันทึกไว้ เมื่อค่าใหม่ไม่รู้จักหรือไม่มีค่า

4. ติดต่อฝ่ายสนับสนุนหาก Opera ยังคงปฏิเสธการอัปเดตผู้เข้าพัก

   ✓ ค่าเพศ Opera ที่ถูกต้องซึ่งบันทึกไว้จะยังคงเดิม เว้นแต่คุณจะระบุรหัสจริง

ข้อผิดพลาดการตรวจสอบ 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 ก่อนบันทึกให้เสร็จ AVA บันทึกการตั้งค่าที่เกี่ยวข้องเป็นขั้นตอนที่พึ่งพากัน ขั้นตอนหนึ่งอาจเสร็จสิ้นก่อนที่อีกขั้นตอนหนึ่งหรือการรีเฟรชแคชจะล้มเหลว PMS อาจยอมรับการเขียนข้อมูล แม้ AVA จะแสดงข้อผิดพลาด

วิธีแก้:

1. เปิด PMS และตรวจสอบว่าข้อมูลรับรองหรือการตั้งค่าผู้ให้บริการที่เปลี่ยนแปลงได้รับการยอมรับหรือไม่

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

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

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

5. คลิก Save อีกครั้งเฉพาะเมื่อ PMS ยังต้องการการเปลี่ยนแปลง

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

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

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

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

ติดต่อฝ่ายสนับสนุนหากข้อผิดพลาดเดิมปรากฏหลังลองสามครั้ง แนบข้อความข้อผิดพลาดทั้งหมด ผู้ให้บริการ PMS เวลาที่บันทึกล้มเหลว และสิ่งที่ 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 อาจยังทำงานตามปกติระหว่างรอ

การลองใหม่ระหว่างค้นหาการจอง

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

วิธีแก้:

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

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

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

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

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

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

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

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

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

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

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

วิธีแก้:

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

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

3. อนุญาต AVA อีกครั้งหาก Cloudbeds แจ้งว่าแอปถูกตัดการเชื่อมต่อ

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

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

   ✓ การเชื่อมต่อครั้งถัดไปควรสำเร็จหลัง 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

---

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

อัตราค่าบริการหรือแผนอัตราค่าบริการของ Cloudbeds ไม่พร้อมใช้งาน

สิ่งที่เห็น: เชื่อมต่อ Cloudbeds แล้ว แต่ไม่มีการดำเนินการในปฏิทินหรือแผนอัตราค่าบริการ

สาเหตุ: การอ่านปฏิทินและการเปลี่ยนแปลงแผนอัตราค่าบริการใช้ความสามารถแยกจากกัน

วิธีแก้:

1. รีเฟรช Operations → Rates & Availability

2. ยืนยันว่า property ของ Cloudbeds ยังคงเป็น PMS ที่ใช้งานอยู่

3. สอบถามผู้ดูแล AVA ว่าเปิดใช้ความสามารถ Cloudbeds ที่จำเป็นแล้วหรือไม่

4. สร้างแผนอัตราค่าบริการที่ขายได้ใหม่ใน Cloudbeds ไม่ใช่ใน AVA

   ✓ การมองเห็นแค็ตตาล็อก Cloudbeds ไม่ได้หมายความว่าทุกการดำเนินการจะพร้อมใช้งาน

การบันทึก Cloudbeds ARI ยังรอดำเนินการ

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

วิธีแก้:

1. รอให้สถานะงานของ Cloudbeds เสร็จสิ้น

2. รีเฟรชปฏิทินหนึ่งครั้ง

3. ตรวจสอบวันที่และแถวอัตราค่าบริการเดิม

4. อย่าส่งการเปลี่ยนแปลงเดิมซ้ำขณะที่ยังรอดำเนินการ

5. ติดต่อฝ่ายสนับสนุนหากค่าที่เผยแพร่ยังไม่เปลี่ยนแปลง

   ✓ AVA จะแสดงว่าสำเร็จหลังยืนยันค่าในปฏิทิน Cloudbeds แล้ว

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

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

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

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

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

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

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