ข้ามไปยังเนื้อหาหลัก

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

ตรวจเร็ว

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

ใช้คู่มือนี้เมื่อ AVA เชื่อมต่อกับ PMS ไม่ได้ หรือแสดงข้อผิดพลาด rate limit ชั่วคราว

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

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

ข้อความ PMS เดิมยังคงอยู่

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

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

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

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

ข้อผิดพลาดความหมายสิ่งที่ควรทำ
"Please fill all required PMS fields"ข้อมูลประจำตัวที่จำเป็นหายไปเพิ่มข้อมูล PMS ที่ขาดอยู่
"Failed to save PMS Integration"ข้อผิดพลาดในการเชื่อมต่อหรือการตรวจสอบสิทธิ์ตรวจสอบบัญชี PMS และสิทธิ์อีกครั้ง
"Unable to communicate with the property management system"ปัญหาเครือข่ายหรือ APIรีเฟรชหนึ่งครั้ง แล้วทดสอบการเชื่อมต่ออีกครั้ง
"429" หรือ "rate limited"PMS ขอให้ AVA ชะลอและลองใหม่ภายหลัง และ AVA จะแสดงเวลาลองใหม่เมื่อมีข้อมูลรอเวลาลองใหม่ แล้วลองอีกครั้ง
"reservationOverlapTo must be greater than reservationOverlapFrom"PMS ปฏิเสธช่วง stayover overlapอัปเดตค่า overlap ใน PMS แล้วรีเฟรช

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

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

สาเหตุ: AVA จะลองคำขออ่านข้อมูลสั้น ๆ จาก PMS ใหม่ให้อัตโนมัติ

วิธีแก้:

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

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

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

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

    ✓ ปัญหาเฉพาะครั้งมักหายได้โดยไม่ต้องเปลี่ยนการตั้งค่า

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

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

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

วิธีแก้:

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

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

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

  4. รีเฟรช AVA อีกครั้ง

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

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

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

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

  1. ยืนยันว่าข้อมูลประจำตัวถูกต้อง

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

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

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

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

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

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

  1. ไปที่ การตั้งค่า → สิ่งจำเป็น
  2. คลิก ยกเลิกการเชื่อมต่อ (หากเชื่อมต่ออยู่)
  3. รอ 30 วินาที
  4. ป้อนข้อมูลประจำตัวของคุณอีกครั้ง
  5. คลิก เชื่อมต่อ อีกครั้ง

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

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

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

วิธีแก้:

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

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

  3. ลองทำอีกครั้ง

  4. หากปัญหากลับมาอีก ให้รอสักครู่ก่อนลองใหม่

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

    ✓ เมื่อ PMS อนุญาตคำขอใหม่แล้ว ควรทำรายการสำเร็จ

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

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

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

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

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

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

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

  1. ไปที่ การตั้งค่า → สิ่งจำเป็น
  2. เลื่อนไปที่ส่วน การรวม PMS
  3. ตรวจสอบว่าสถานะการเชื่อมต่อแสดงเป็น "เชื่อมต่อแล้ว"
  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. ติดต่อผู้แทน Oracle ของคุณ
  2. ขอรีเฟรชข้อมูลประจำตัว API
  3. ยืนยันว่า URL ของสภาพแวดล้อมถูกต้อง (test เทียบกับใช้งานจริง)

สำหรับ 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)
  • เวลาที่เริ่มเกิดปัญหา
  • ขั้นตอนที่คุณลองไปแล้ว

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