ตั้งค่าการเชื่อมต่อ Cloudbeds PMS

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

การเชื่อมต่อ Cloudbeds โดยทั่วไปใช้เวลาประมาณ 10 นาที Cloudbeds ใช้ OAuth v3 AVA จะใช้ v3 หาก callback ไม่ระบุเวอร์ชัน Cloudbeds v1 และ v2 เลิกใช้งานแล้ว คำขอที่ระบุ v1 หรือ v2 อย่างชัดเจนจะส่งคืนข้อผิดพลาดว่าไม่รองรับเวอร์ชัน นำการกำหนดเวอร์ชันออก แล้วเริ่มการเชื่อมต่อใหม่ ขณะนี้ Cloudbeds ขอ item access, read-only add-on access และ read access สำหรับ hotel, rate และ taxes/fees นอกจากนี้ยังขอ adjustment write access สำหรับการอัปเดตที่รองรับซึ่งต้องคง rate เดิมไว้ AVA จะบันทึกการเปลี่ยนแปลง Essentials อื่น ๆ ที่ยังไม่ได้บันทึกก่อนเปลี่ยนเส้นทางไป OAuth Cloudbeds จะกลายเป็น PMS ที่ใช้งานอยู่หลังการอนุญาตเสร็จสิ้น การเลือก provider จะรีเฟรชโดยอัตโนมัติเมื่อการดำเนินการขั้นสุดท้ายเสร็จสมบูรณ์

คู่มือนี้ช่วยให้คุณเชื่อมต่อ Cloudbeds ระบบจะซิงก์ข้อมูล reservation, guest, housekeeping, payment, room, currency, hotel, rate และ tax หาก Cloudbeds ปฏิเสธการเชื่อมต่อ AVA จะแสดงเหตุผลที่แน่ชัดบนแถบข้อผิดพลาด

การอ่านปฏิทิน Cloudbeds และการดำเนินการกับแคตตาล็อก rate plan จะแสดงแยกกันใน AVA การดำเนินการเขียนแต่ละรายการจะเปิดใช้ตาม capability ในช่วงเริ่มต้น

ตำแหน่งที่พบ

Settings → Essentials → Property Management System (PMS) Integration

ก่อนเริ่มต้น

คุณต้องมี:

• บัญชี Cloudbeds ที่มีสิทธิ์ admin
• ข้อมูลเข้าสู่ระบบ Cloudbeds
• สิทธิ์อนุญาตแอปภายนอก

คำเตือน

เชื่อมต่อบัญชี Cloudbeds ได้เพียงหนึ่งบัญชีต่อหนึ่งที่พักเท่านั้น

เชื่อมต่อกับ Cloudbeds

ขั้นตอนที่ 1: เลือก Cloudbeds เป็น PMS ของคุณ

1. ไปที่ Settings → Essentials
2. เลื่อนไปที่ Property Management System (PMS) Integration
3. คลิกการ์ด Cloudbeds
4. เครื่องหมายถูก (✓) จะปรากฏเพื่อยืนยันการเลือก

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

ขั้นตอนที่ 2: เริ่มการเชื่อมต่อ

1. คลิกปุ่ม Connect to Cloudbeds
2. AVA จะบันทึกการเปลี่ยนแปลง Essentials อื่น ๆ ที่ยังไม่ได้บันทึกก่อน
3. เบราว์เซอร์จะเปิดหน้าการอนุญาตของ Cloudbeds

ขั้นตอนที่ 3: อนุญาตการเข้าถึง

1. เข้าสู่ระบบบัญชี Cloudbeds ของคุณ
2. ตรวจสอบสิทธิ์ที่ AVA ขอ
3. คลิก Authorize หรือ Allow
4. กลับไปที่ AVA หลังการอนุญาตเสร็จสิ้น

AVA จะรับ Property ID และ API key ของ Cloudbeds ผ่าน OAuth คุณไม่จำเป็นต้องป้อนค่าเหล่านี้ด้วยตนเอง

ขณะนี้ AVA ขอสิทธิ์ดังต่อไปนี้:

Permission	AVA ใช้สิทธิ์นี้ทำอะไร
read:hotel	ดูข้อมูลเมทาดาทาของโรงแรม
read:guest	ดูรายละเอียดผู้เข้าพัก
write:guest	อัปเดตรายละเอียดผู้เข้าพัก
read:housekeeping	ดูข้อมูล housekeeping
write:housekeeping	อัปเดตข้อมูล housekeeping
read:rate	ดูข้อมูลแผน rate
read:payment	ดูข้อมูลการชำระเงิน
write:payment	อัปเดตข้อมูลการชำระเงิน
read:reservation	ดูข้อมูล reservation
write:reservation	อัปเดตข้อมูล reservation
read:room	ดูข้อมูลห้อง
write:room	อัปเดตข้อมูลห้อง
read:currency	อ่านการตั้งค่าสกุลเงินของที่พัก
read:taxesAndFees	ดูข้อมูลภาษีและค่าธรรมเนียม
read:item	ดูข้อมูลแคตตาล็อก item
write:item	อัปเดตข้อมูลแคตตาล็อก item
read:addon	ดูข้อมูลแคตตาล็อก add-on
write:adjustment	รักษา rate ระหว่างการอัปเดต reservation ที่รองรับ

การเชื่อมต่อ Cloudbeds ที่มีอยู่

หากคุณเชื่อมต่อ Cloudbeds ก่อนการแก้ไขนี้ token ของคุณจะยังคงใช้สิทธิ์เดิม เชื่อมต่อใหม่จาก Settings → Essentials เพื่อรับชุดสิทธิ์ปัจจุบันทั้งหมด

ขั้นตอนที่ 4: ตรวจสอบการเชื่อมต่อ

1. กลับไปที่การตั้งค่า AVA
2. รอข้อความ "Finalizing connection..." (5-10 วินาที)
3. สถานะจะแสดงเครื่องหมายถูกสีเขียว
4. ข้อความจะแสดง: "Cloudbeds Account Linked"
5. ยืนยันว่าการ์ด provider Cloudbeds ยังคงถูกเลือก

เชื่อมต่อเสร็จแล้ว! 🎉

AVA จะรีเฟรชการเลือก provider หลังการดำเนินการขั้นสุดท้าย การ์ดที่เลือกควรแสดง Cloudbeds โดยไม่ต้องรีเฟรชหน้าด้วยตนเอง

ข้อผิดพลาด OAuth ของ Cloudbeds

เมื่อ Cloudbeds บล็อกการเชื่อมต่อ AVA จะแสดงข้อความที่อ่านเข้าใจได้ คุณไม่ต้องเดาจากข้อความล้มเหลวแบบกว้าง ๆ อีกต่อไป

สิ่งที่คุณเห็น	หมายความว่าอะไร	ต้องทำอะไร
Cloudbeds did not return the OAuth state parameter.	callback ของ Cloudbeds ไม่มีข้อมูล state	เริ่มการเชื่อมต่ออีกครั้ง
Cloudbeds did not return an authorization code.	Cloudbeds ดำเนินการอนุญาตไม่เสร็จ	เชื่อมต่อใหม่จาก Settings → Essentials
Cloudbeds OAuth state verification failed.	state ใน callback ไม่ถูกต้องหรือหมดอายุ	เชื่อมต่อ Cloudbeds ใหม่
Could not identify the merchant for this Cloudbeds link.	AVA จับคู่ callback กับโรงแรมของคุณไม่ได้	ตรวจว่าคุณเข้าสู่ระบบ property ที่ถูกต้อง
Version is required.	callback OAuth ดำเนินการไม่เสร็จ	เริ่มการเชื่อมต่อ Cloudbeds ใหม่ AVA จะใช้ OAuth v3 โดยอัตโนมัติ
Unsupported Cloudbeds version.	คำขอเลือก Cloudbeds v1 หรือ v2 ที่เลิกใช้แล้ว	นำการกำหนดเวอร์ชันออก แล้วเริ่มการเชื่อมต่อใหม่
Cloudbeds rejected the authorization code exchange.	Cloudbeds ปฏิเสธ authorization code ที่ใช้ได้ครั้งเดียว	เริ่มการเชื่อมต่อ Cloudbeds ใหม่เพื่อให้ Cloudbeds สร้าง code ใหม่
Failed to link Cloudbeds account.	AVA ระบุข้อผิดพลาดจาก backend ไม่ได้	คัดลอกข้อความทั้งหมดแล้วติดต่อฝ่ายสนับสนุน

สิ่งที่ซิงก์อัตโนมัติ

Cloudbeds ใช้ webhooks สำหรับการอัปเดตแบบเรียลไทม์ เมื่อมีการเปลี่ยนแปลงใน Cloudbeds AVA จะได้รับแจ้งทันที:

เหตุการณ์	เกิดอะไรขึ้น
Reservation created	AVA ได้รับการแจ้งเตือนและสามารถกำหนดเวลาข้อความ pre-arrival ได้
Reservation dates changed	AVA อัปเดตข้อความที่ตั้งเวลาไว้
Check-in/out status	สถานะซิงก์แบบเรียลไทม์
Guest profile updated	AVA รีเฟรชรายละเอียดผู้เข้าพักล่าสุด รวมถึงการเปลี่ยนอีเมลที่ใช้สำหรับ automatic resend catch-up

เมื่อคุณดู reservation ใน AVA ระบบจะดึงข้อมูลล่าสุดจาก Cloudbeds โดยตรง ทำให้คุณเห็นข้อมูลปัจจุบันอยู่เสมอ

ข้อมูล

ข้อมูลไหลหลักจาก Cloudbeds → AVA การอัปเดตผู้เข้าพักที่ทำใน AVA เช่น การเช็กอินเสร็จสมบูรณ์ จะถูกส่งกลับไป Cloudbeds

การอัปเดตอีเมลผู้เข้าพัก

เมื่อ Cloudbeds ส่งการอัปเดตผู้เข้าพัก AVA สามารถส่งอีเมล pre-arrival ที่เลยกำหนดแล้วไปยังที่อยู่ PMS ล่าสุดของผู้เข้าพักได้อีกครั้ง การ catch-up อัตโนมัตินี้จะทำงานหลังการซิงก์ครั้งถัดไป

การป้องกันการอ่านของ Cloudbeds

หากเจ้าหน้าที่หลายคนร้องขอข้อมูล Cloudbeds เดียวกันพร้อมกัน AVA จะแชร์คำขออ่านเพียงครั้งเดียว หาก Cloudbeds ส่งข้อผิดพลาดด้าน access เดิมหรือข้อผิดพลาด success:false ซ้ำ AVA จะหยุด retry ซ้ำชั่วคราว

การอัปเดตเวลาเดินทางมาถึงของ Cloudbeds

เมื่อซิงก์ผู้เข้าพักหลัก AVA สามารถส่ง estimated arrival time ของ reservation ไปยัง Cloudbeds v3 ได้ ผู้เข้าพักร่วมจะไม่อัปเดตเวลานี้ เวลาที่ไม่ถูกต้อง ขาดหาย หรือว่างจะถูกละเว้น ดังนั้น AVA จะไม่ล้างข้อมูล PMS เดิม หากการอัปเดตตัวเลือกนี้ล้มเหลว หรือ Cloudbeds ไม่รองรับ การซิงก์ผู้เข้าพักยังคงสำเร็จ

ใช้ตัวเลือกห้องของ Cloudbeds ใน ACI

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

หากต้องการเปิดใช้ฟีเจอร์นี้ ให้เปิด Allow ACI room swaps ที่ Settings → Check-In → Check-In Policy สำหรับการอัปเกรด ให้เปิด Offer room type upgrades in Assisted Check-In เพิ่มเติม เพิ่มกลุ่มประเภทห้องตามลำดับก่อนบันทึกนโยบายการอัปเกรด

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

ข้อจำกัดตัวเลือกห้องของ Cloudbeds

Cloudbeds ไม่มีการดำเนินการสลับห้องแบบ atomic ที่ยืนยันแล้ว AVA ใช้การย้ายแบบมีการป้องกัน และตรวจสอบห้อง ประเภทห้อง rate ยอดรวม ผู้เข้าพัก วันที่ และรายการที่อยู่กลุ่มเดียวกัน ผู้เข้าพักที่ยังไม่ได้จัดสรรจะได้รับเฉพาะตัวเลือกประเภทห้องเดียวกัน Cloudbeds ไม่รองรับนโยบายแจ้งเตือนการบล็อกแบบมีรหัส การจัดอันดับ VIP หรือการเรียกคืนสิทธิ์ courtesy

หากไม่ทราบผลลัพธ์การจัดสรร อย่าลองซ้ำทันที ตรวจสอบการจองและ rate ที่ได้รับผลกระทบทุกรายการใน Cloudbeds ก่อน จากนั้นใช้การรีเฟรชห้องแบบ explicit ใน AVA AVA จะคงสถานะห้องและสถานะการเข้าถึงเป็นยังไม่ยืนยันจนกว่าการรีเฟรชนั้นจะสำเร็จ อย่าส่งมอบกุญแจจนกว่าจะยืนยันห้องและ rate แล้ว

ผู้เข้าพัก Cloudbeds ที่มีอยู่

เมื่อการสแกนไม่มี Cloudbeds guest ID AVA จะตรวจสอบรายชื่อผู้เข้าพักทั้งหมดในการจอง ซึ่งรวมถึงผู้เข้าพักที่ยังไม่ได้จัดสรรห้อง

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

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

ช่องข้อมูลว่างจากการสแกนจะไม่ล้างค่าทางเลือกเดิมใน Cloudbeds ซึ่งรวมถึงการสแกนที่ไม่มีเอกสาร

ตรวจสอบการจับคู่ที่ไม่ชัดเจน

อย่าสร้างโปรไฟล์เพิ่มเมื่อ AVA ขอให้ตรวจสอบผู้เข้าพัก ยืนยันรายละเอียดผู้เข้าพักและข้อมูลยืนยันตัวตนใน Cloudbeds ก่อน

อัตราและความพร้อมให้บริการ

AVA อ่านอัตรารายวันโดยละเอียดจาก Cloudbeds เพื่อแสดงในปฏิทิน Operations → Rates & Availability ปฏิทินนี้อาจแสดงราคา จำนวนห้อง CTA, CTD และข้อจำกัดการเข้าพักขั้นต่ำหรือสูงสุด แถวห้องหรืออัตราที่ขาดหายยังคงแสดงอยู่ เพื่อให้คุณระบุข้อมูล Cloudbeds ที่ไม่ครบถ้วนได้

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

การเขียนข้อมูลไป Cloudbeds ทำงานแบบอะซิงโครนัส

การเปลี่ยนแปลง ARI ที่รองรับจะส่งสถานะยอมรับแล้วขณะที่ Cloudbeds กำลังประมวลผลงาน AVA จะตรวจสอบค่าปฏิทินที่เผยแพร่ก่อนแสดงว่าสำเร็จ อย่าทำการเปลี่ยนแปลงเดิมซ้ำขณะที่การเปลี่ยนแปลงแรกยังอยู่ระหว่างดำเนินการ

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

AVA จะแสดงผลลัพธ์ Queued, Failed, Verified หรือ Verification timeout สำหรับการเขียนที่รองรับ การตรวจสอบอาจใช้เวลาสูงสุดเจ็ดนาที ขณะที่ AVA ตรวจสอบงาน PMS และอ่านค่าปฏิทินกลับมา ให้รีเฟรชด้วยตนเองเมื่อการตรวจสอบหมดเวลา

Occupancy ปัจจุบันของห้องระหว่างการจัดสรรอัตโนมัติ

สถานะ housekeeping ของ Cloudbeds ไม่ได้แสดง occupancy ของ reservation ปัจจุบันเสมอไป reservation ที่เช็กอินเกินกำหนดอาจแสดงเป็นห้องว่างหลังวันออกเดินทาง

ก่อนการจัดสรรอัตโนมัติ AVA จะตรวจสอบทั้งสองแหล่งข้อมูล:

• สถานะ housekeeping ของ Cloudbeds
• reservation ที่เช็กอินอยู่แบบเรียลไทม์สำหรับห้องที่อยู่ระหว่างพิจารณา

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

AVA จะข้ามห้องที่มี reservation อื่นเช็กอินอยู่ การตรวจสอบนี้ยังป้องกันปลายทางที่เลือกไว้ระหว่างการย้ายห้องขณะเข้าพัก

ต้องยืนยันว่าห้องว่าง

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

การกำหนดห้องด้วยตนเองอย่างชัดเจนจะคงพฤติกรรมเดิมของ Cloudbeds ไว้ ระบบจะคง room lock และเป้าหมายห้องแบบเข้มงวดไว้ด้วย

หาก AVA ไม่สามารถจัดสรรห้องได้ ให้ตรวจสอบ reservation และสถานะ housekeeping ใน Cloudbeds จากนั้นรีเฟรช AVA แล้วลองจัดสรรอีกครั้งหนึ่งครั้ง

พฤติกรรมการโพสต์การชำระเงิน

บิลรวมของ Cloudbeds จะโพสต์การชำระเงินรวมหนึ่งรายการไปยัง reservation หลักที่แชร์กัน AVA เก็บ metadata การติดตามระดับห้องไว้ เพื่อให้เจ้าหน้าที่ตรวจสอบการจัดสรรย้อนหลังได้ หากการจองไม่ได้ใช้บิลรวม AVA จะโพสต์แยกตาม reservation ตามปกติ

เมื่อ AVA โพสต์การชำระเงิน Cloudbeds จะเก็บรายละเอียดเหล่านี้ไว้ในคำอธิบายการชำระเงิน:

• Gateway Transaction ID: ตัวระบุธุรกรรมของเกตเวย์การชำระเงิน
• Payment Reference: ข้อมูลอ้างอิงการชำระเงินของ AVA

ใช้ค่าใดค่าหนึ่งเพื่อจับคู่รายการ folio ของ Cloudbeds กับการชำระเงินใน Stripe Cloudbeds จะเก็บบรรทัดคำอธิบายทั้งสองไว้เมื่อคุณอ่าน folio ในภายหลัง

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

กระทบยอดการชำระเงิน Cloudbeds

1. เปิด reservation ใน AVA และจด Transaction ID หรือข้อมูลอ้างอิงการชำระเงิน

2. เปิด folio ของ reservation เดียวกันใน Cloudbeds

3. ค้นหาการชำระเงินที่ AVA โพสต์

4. เปรียบเทียบ Gateway Transaction ID หรือ Payment Reference กับการชำระเงินใน AVA

   ✓ จำนวนเงิน วิธีการชำระเงิน และข้อมูลอ้างอิงควรระบุว่าเป็นการชำระเงินเดียวกัน

สำหรับบิลรวม ให้ตรวจ folio ของ reservation หลักที่แชร์กัน Cloudbeds จะแสดงการชำระเงินรวมหนึ่งรายการสำหรับบิลรวมนั้น

ผลต่อผู้เข้าพักและพนักงาน

• แบบฟอร์มผู้เข้าพักปรับตามกฎของ Cloudbeds ฟิลด์ที่ต้องกรอกและฟิลด์ที่ซ่อนจะเปลี่ยนตามการตั้งค่า Cloudbeds ดังนั้นผู้เข้าพักจะเห็นเฉพาะสิ่งที่จำเป็น
• การค้นหา reservation ใช้ Cloudbeds หาก Cloudbeds ไม่ได้เชื่อมต่อ ขั้นตอนค้นหาผู้เข้าพักจะล้มเหลว AVA จะรอการค้นหานานถึง 20 วินาทีก่อนแสดงข้อผิดพลาดว่า service unavailable
• การค้นหา fallback ของ Cloudbeds ใช้ข้อมูลอ้างอิงการยืนยัน OTA ที่ตรงกันทุกประการ ช่วยให้การค้นหาในที่พักขนาดใหญ่ตอบสนองได้ดีและค้นหา reservation ที่ตรงกันได้เกินหน้าผลลัพธ์แรก
• การสแกนเอกสาร ACI ไม่เปลี่ยน occupancy ของ Cloudbeds AVA จะตรวจสอบความจุเมื่อสร้างหรือซิงก์ผู้เข้าพักร่วมที่รอดำเนินการระหว่าง Registration แล้วตรวจอีกครั้งก่อนเช็กอินขั้นสุดท้าย
• Cloudbeds ไม่รองรับผู้เข้าพักเกินความจุห้องที่รายงาน AVA จะไม่ผ่อนผันขีดจำกัดความจุระหว่างการเช็กอินแบบมีผู้ช่วย
• การอัปเดต occupancy จะรักษาห้องจริงที่จัดสรรไว้ล่วงหน้า เมื่อ AVA เปลี่ยน Adults หรือ Children ใน Cloudbeds การจัดสรรห้องเดิมจะยังคงอยู่
• การแก้ไข occupancy จะรักษา rate ที่จองไว้ในต้นทาง AVA จะส่งการตั้งค่า no-reprice แยกต่อห้องเมื่อเปลี่ยน Adults หรือ Children ใน Cloudbeds
• ยังมีตัวป้องกันการแก้ไขให้ใช้ หาก Cloudbeds ปรับราคา stay โดยไม่คาดคิด AVA จะตรวจสอบ rate ตามวันที่และสามารถโพสต์การแก้ไข fallback ได้
• กฎต้นทางที่รองรับใช้การคำนวณที่ทราบต้นทาง ค่าธรรมเนียมเปอร์เซ็นต์แบบ exclusive เดียวใช้การแก้ไขก่อนภาษีที่ปลอดภัยต่อหน่วยเซนต์ ส่วนค่าธรรมเนียมเปอร์เซ็นต์แบบ inclusive ทั้งหมด รวมถึงหลายค่าธรรมเนียม ใช้การแก้ไข gross ที่แม่นยำ
• ตรวจสอบ rate ตามวันที่หลัง Cloudbeds อัปเดตเสร็จ Cloudbeds ใช้การเปลี่ยน rate แบบอะซิงโครนัส AVA จะรอ rate job แล้วตรวจ nightly rate ตามวันที่แทนการพึ่งข้อมูลสรุป plan ที่ล่าช้า
• กฎต้นทางที่ไม่รองรับจะหยุดอย่างปลอดภัย ค่าธรรมเนียมแบบผสม แบบคงที่ ที่หายไป อ่านไม่ได้ หรือ exclusive หลายรายการจะคืน PMS_RATE_PRESERVATION_SOURCE_TAX_UNSUPPORTED ก่อนเปลี่ยน occupancy
• ยังมี fallback ระดับ property AVA จะใช้เฉพาะเมื่อ source ที่ตรงกันไม่มีค่าธรรมเนียมที่ใช้ได้
• ความต่างจากการปัดเศษเล็กน้อยของ Cloudbeds จะไม่ขัดขวางการตรวจสอบ หากมีเพียง subtotal และ tax ที่ต่างกันด้วยจำนวนเท่ากันคนละทิศทางภายใน 10 เซนต์ AVA จะยอมรับยอดรวมที่ผู้เข้าพักเห็นว่าไม่เปลี่ยนแปลง
• ส่วนต่างยอดรวมเล็กน้อยก็ยอมรับได้ หลัง retry การตรวจสอบขั้นสุดท้าย การอัปเดตที่ทราบต้นทางสามารถยอมรับส่วนต่างยอดรวมที่สอดคล้องกันได้ถึง 5 เซนต์ AVA จะเพิ่มหมายเหตุพร้อมยอดที่ชำระแล้วและยอดที่จองไว้ ไม่ต้องโพสต์การแก้ไขด้วยตนเอง
• บิลรวมจะแสดงการชำระเงิน PMS หนึ่งรายการ คุณอาจเห็นการชำระเงินนั้นบน folio ของ reservation หลักที่แชร์กัน แทนที่จะเห็นในทุกห้อง
• การเปลี่ยนอีเมลผู้เข้าพักอาจกระตุ้น resend catch-up เมื่อ Cloudbeds ส่งการอัปเดตผู้เข้าพัก AVA สามารถส่งอีเมล pre-arrival ที่เลยกำหนดแล้วไปยังที่อยู่ล่าสุดได้อีกครั้ง
• ป้ายแหล่งที่มาของการจองสามารถใช้ metadata แหล่งของ Cloudbeds ได้ หาก reservation ไม่มี sourceName AVA จะ fallback ไปใช้ชื่อ source ของ Cloudbeds ที่เชื่อมโยงไว้
• source collect มาจากระเบียน source ที่เชื่อมโยงเมื่อมี วิธีนี้ช่วยให้พฤติกรรมแหล่ง hotel และ channel สอดคล้องกับการตั้งค่า Cloudbeds
• ยอดรวม reservation ใช้ค่าจาก invoice ของ Cloudbeds ที่ถูกต้อง รายการ reservation อาจยังไม่แสดงยอดรวมของการเข้าพักจนกว่ารายละเอียด invoice จะโหลดเสร็จ เปิดรายละเอียด reservation เพื่อตรวจสอบยอดรวม PMS ทั้งหมด รวมภาษีด้วย โดย Balance Due ยังคงเป็นจำนวนเงินที่ค้างชำระ
• ใบแจ้งหนี้แบบ channel-collect จะยังถูกยกเว้น เมื่อ Cloudbeds v3 ทำเครื่องหมายว่า invoice แบบ channel-collect ถูกยกเว้น AVA จะตั้งยอดที่ต้องชำระเป็นศูนย์และแสดงการยกเว้นใน Streamliner
• การตั้งค่า room condition มีผลเฉพาะการซิงก์ housekeeping ค่านี้ควบคุมว่า AVA จะส่งสถานะ Clean หรือ Inspected ไปยัง Cloudbeds เมื่อห้องถูกทำเครื่องหมายว่าสะอาดใน AVA ไม่ได้เปลี่ยน UI ของผู้เข้าพัก
• การซิงก์ estimated arrival time ใช้เฉพาะผู้เข้าพักหลัก ผู้เข้าพักร่วมและเวลาที่ไม่ถูกต้องจะถูกละเว้น ดังนั้น AVA จะคงค่า PMS เดิมไว้
• AVA ขอ item access และ read-only add-on access โดยตั้งใจไม่รวม write:addon
• fallback rate corrections ใช้ adjustment access AVA ขอ write:adjustment สำหรับการแก้ไข safety-net หาก Cloudbeds ปรับราคาโดยไม่คาดคิด
• Cloudbeds OAuth scopes จะรีเฟรชเมื่อเชื่อมต่อใหม่ ให้เชื่อมต่อรายการที่สร้างก่อนการแก้ไขนี้ใหม่เพื่อรับชุดสิทธิ์ปัจจุบันทั้งหมด

ขาดสิทธิ์ adjustment

Cloudbeds ต้องให้สิทธิ์ write:adjustment เพื่อให้ AVA แก้ไขการปรับราคาโดยไม่คาดคิดระหว่างการแก้ไข occupancy ได้ หาก AVA รายงาน PMS_RATE_PRESERVATION_ADJUSTMENT_SCOPE_MISSING ให้หยุด retry การแก้ไข เชื่อมต่อ Cloudbeds ใหม่โดยใช้ผู้ดูแลระบบและอนุมัติสิทธิ์ adjustment AVA จะบล็อกการแก้ไขก่อนเขียน occupancy ดังนั้นโดยปกติไม่จำเป็นต้องกระทบยอด folio

ยกเลิกการเชื่อมต่อ Cloudbeds

ควรยกเลิกการเชื่อมต่อเฉพาะเมื่อคุณ:

• กำลังสลับไปใช้ PMS อื่น
• กำลังเปลี่ยนบัญชี Cloudbeds
• กำลังแก้ปัญหาการซิงก์

วิธียกเลิกการเชื่อมต่อ:

1. ไปที่ Settings → Essentials
2. คลิก Disconnect from Cloudbeds
3. ยืนยันเมื่อมีข้อความถาม

ข้อควรระวัง

การยกเลิกการเชื่อมต่อจะหยุดการซิงก์ทั้งหมดทันที ข้อมูลเดิมจะยังอยู่แต่จะไม่อัปเดต

การแก้ปัญหา

ค้างที่ "Connecting..."

1. รอ 30 วินาที
2. รีเฟรชหน้า
3. ตรวจการเชื่อมต่ออินเทอร์เน็ต
4. ลองใช้เบราว์เซอร์อื่น

เกิดข้อผิดพลาดในการบันทึกก่อน Cloudbeds เชื่อมต่อ

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

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

วิธีแก้:

1. อ่านข้อความทั้งหมดที่แสดงในแถบข้อผิดพลาด

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

3. เลือก Save หากหน้าแสดงว่ามีการเปลี่ยนแปลงที่ยังไม่ได้บันทึก

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

   ✓ AVA จะเปลี่ยนเส้นทางไป Cloudbeds หลังบันทึกสำเร็จ

ข้อความ Cloudbeds OAuth

สิ่งที่คุณเห็น: มีข้อความ Cloudbeds OAuth แสดงในแถบแจ้งเตือน

วิธีแก้:

1. อ่านข้อความก่อน
2. เทียบกับตารางด้านบน
3. เริ่มการเชื่อมต่อ Cloudbeds ใหม่หากข้อความพูดถึง state, code, version หรือ token exchange
4. ยืนยันว่าคุณใช้บัญชี Cloudbeds admin
5. อย่านำ callback การอนุญาตที่ล้มเหลวกลับมาใช้ซ้ำ authorization code ของ Cloudbeds ใช้ได้ครั้งเดียว
6. ติดต่อฝ่ายสนับสนุนหากการเชื่อมต่อใหม่ยังล้มเหลว

ข้อมูล

แถบแจ้งเตือนจะแสดงรายละเอียดข้อผิดพลาดของ Cloudbeds เองเมื่อมี ช่วยให้คุณมีจุดเริ่มต้นที่ชัดเจนขึ้นเมื่อติดต่อฝ่ายสนับสนุน AVA จะกำหนด OAuth version ของ Cloudbeds ที่ไม่ระบุให้เป็น v3 โดยอัตโนมัติ Cloudbeds v1 และ v2 ไม่รองรับอีกต่อไป ใช้ routing ที่ไม่ระบุเวอร์ชันเพื่อให้ AVA เลือก v3

Reservation ไม่ซิงก์

1. รอ 15 นาทีสำหรับการซิงก์ครั้งแรก
2. ตรวจสถานะการเชื่อมต่อ (ควรแสดงเป็นสีเขียว)
3. ลองยกเลิกการเชื่อมต่อแล้วเชื่อมต่อใหม่
4. ตรวจว่ามี reservation อยู่ใน Cloudbeds

ข้อผิดพลาด access หรือ property ของ Cloudbeds

สิ่งที่คุณเห็น: ข้อความเช่น You don't have access to property ID หรือข้อผิดพลาดเดิมของ Cloudbeds กลับมาทันที

สาเหตุ: บัญชี Cloudbeds ที่เชื่อมต่อไม่สามารถอ่าน property นั้นได้ AVA ยังหยุด retry ซ้ำชั่วคราวด้วย

วิธีแก้:

1. ยืนยันว่าคุณเข้าสู่ระบบ Cloudbeds property ที่ถูกต้อง

2. ให้ Cloudbeds admin ตรวจสอบ access และสิทธิ์ของ property

3. รอหนึ่งนาทีก่อนคลิก Refresh อีกครั้ง

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

   ✓ การรีเฟรชครั้งถัดไปควรใช้งานได้หลังแก้ปัญหา Cloudbeds access แล้ว

ต้องตรวจสอบตัวตนผู้เข้าพัก

สิ่งที่คุณเห็น: AVA ขอให้พนักงานตรวจสอบผู้เข้าพักระหว่างการลงทะเบียนหรือเช็กอิน ข้อความอาจมี GUEST_BOOKING_MATCH_REVIEW_REQUIRED

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

วิธีแก้:

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

2. ตรวจสอบชื่อเต็ม วันเดือนปีเกิด และรายละเอียดเอกสารของผู้เข้าพัก

3. แก้ไขระเบียนผู้เข้าพักในการจองที่ซ้ำหรือไม่ถูกต้องตามนโยบายของโรงแรม

4. รีเฟรช reservation ใน AVA

5. ลองลงทะเบียนผู้เข้าพักอีกครั้งหนึ่งครั้ง

   ✓ AVA ควรนำโปรไฟล์ที่ถูกต้องกลับมาใช้หรือสร้างโปรไฟล์ใหม่อย่างปลอดภัย

ติดต่อฝ่ายสนับสนุนหากรายละเอียดการจองถูกต้องแต่ยังต้องตรวจสอบอยู่

ขาดสิทธิ์ adjustment ของ Cloudbeds

สิ่งที่คุณเห็น: การแก้ไข occupancy คืนค่า PMS_RATE_PRESERVATION_ADJUSTMENT_SCOPE_MISSING

สาเหตุ: Cloudbeds property ของคุณไม่ได้ให้ AVA เข้าถึง write:adjustment

วิธีแก้:

1. หยุด retry การแก้ไข occupancy

2. ไปที่ Settings → Essentials

3. เชื่อมต่อ Cloudbeds ใหม่ด้วยบัญชีผู้ดูแลระบบ

4. อนุมัติสิทธิ์ write:adjustment

5. รอให้การเชื่อมต่อเสร็จ แล้วลองแก้ไขอีกครั้งหนึ่งครั้ง

   ✓ AVA ควรยอมรับการแก้ไข occupancy ใหม่หลังสิทธิ์เปิดใช้งาน

การตรวจสอบสิทธิ์ที่แคชไว้

AVA อาจเก็บ property ไว้ในสถานะบล็อกนานถึงหกชั่วโมงหลังการปฏิเสธครั้งแรก ติดต่อฝ่ายสนับสนุนหาก code เดิมยังคงอยู่หลังเชื่อมต่อใหม่และรอแล้ว

ต้องตรวจสอบการตั้งค่า source tax ของ Cloudbeds

สิ่งที่คุณเห็น: การแก้ไข occupancy คืนค่า PMS_RATE_PRESERVATION_SOURCE_TAX_UNSUPPORTED ข้อความระบุว่า occupancy ของ Cloudbeds ไม่ได้ถูกเปลี่ยน

สาเหตุ: กฎ tax หรือ fee ของ source ใน reservation ไม่รองรับ AVA จะหยุดก่อนเขียน occupancy เพื่อป้องกันการปรับราคาที่กู้คืนไม่ได้

วิธีแก้:

1. เปิด reservation ใน Cloudbeds

2. ยืนยัน booking source และ target room type ของ reservation

3. ตรวจสอบค่าธรรมเนียม tax และ fee ของ source

4. ให้ Cloudbeds administrator แก้ไขกฎ source ที่ไม่รองรับ ซึ่งอาจเกี่ยวข้องกับค่าธรรมเนียมแบบผสม ไม่ใช่เปอร์เซ็นต์ อ่านไม่ได้ หรือ exclusive หลายรายการ

5. รีเฟรช AVA แล้วลองแก้ไข occupancy อีกครั้งหนึ่งครั้ง

   ✓ การแก้ไขควรดำเนินต่อได้หลัง Cloudbeds แสดง source policy ที่รองรับ

ห้ามข้ามการตรวจสอบ source

อย่าเปลี่ยน occupancy ด้วยตนเองจนกว่าจะยืนยันยอดที่จองไว้ใน Cloudbeds ติดต่อฝ่ายสนับสนุนหากกฎ source ดูเหมือนรองรับ แต่ AVA ยังคงคืน code นี้

เชื่อม Cloudbeds แล้วแต่ยังไม่ใช้งาน

สิ่งที่คุณเห็น: เชื่อม Cloudbeds สำเร็จแล้ว แต่ยังเลือก PMS อื่นอยู่ คุณอาจเห็นข้อความ: "Cloudbeds is linked, but it could not be set as the active PMS. Select Cloudbeds above and save to finish."

วิธีแก้:

1. ไปที่ Settings → Essentials

2. เลือกการ์ด provider Cloudbeds

3. คลิก Save

4. ยืนยันว่าการ์ด Cloudbeds ยังคงถูกเลือกหลังบันทึก

   ✓ Cloudbeds เป็น PMS ที่ใช้งานอยู่แล้ว

หากคำเตือนปรากฏอีกครั้ง ให้ดำเนินขั้นตอนการเชื่อมต่อ Cloudbeds อีกครั้ง ขั้นตอนซ้ำจะลองเปิดใช้งานบัญชีที่เชื่อมโยงแล้วอีกครั้ง

แท็บแคตตาล็อกไม่ปรากฏ

สิ่งที่คุณเห็น: แท็บ Items หรือ Add-ons หายไป

วิธีแก้:

1. เปิดหน้า Rooms ใหม่
2. ตรวจ prompt สิทธิ์ของ Cloudbeds
3. ยืนยันว่า prompt มี read:item, write:item และ read:addon
4. ติดต่อฝ่ายสนับสนุนหากแท็บแคตตาล็อกยังไม่ปรากฏ

หน้าอนุญาต Cloudbeds เปิดไม่ได้

สิ่งที่คุณเห็น: ไม่มีอะไรเกิดขึ้นหลังเลือก Connect to Cloudbeds

วิธีแก้:

1. รีเฟรช Settings → Essentials
2. เลือก Connect to Cloudbeds อีกครั้ง
3. ตรวจการเชื่อมต่ออินเทอร์เน็ต
4. ลองใช้เบราว์เซอร์อื่นหรือหน้าต่างส่วนตัว

ความปลอดภัย

• การเชื่อมต่อใช้ OAuth 2.0 ที่ปลอดภัย
• รหัสผ่านของคุณจะไม่ถูกเก็บไว้ใน AVA
• เพิกถอน access ได้ทุกเมื่อจาก Cloudbeds
• การเชื่อมต่อจะหมดอายุหลังไม่มีการใช้งาน 90 วัน

คำถามที่พบบ่อย

ฉันเชื่อมต่อ Cloudbeds หลาย property ได้หรือไม่? ไม่ได้ หนึ่ง property ต่อหนึ่งบัญชี AVA

การยกเลิกการเชื่อมต่อจะลบข้อมูลของฉันหรือไม่? ไม่ ข้อมูลเดิมจะยังอยู่แต่จะไม่อัปเดต

พนักงานสามารถเชื่อมต่อ Cloudbeds ได้หรือไม่? ไม่ได้ เฉพาะผู้ดูแลระบบเท่านั้นที่จัดการการเชื่อมต่อ PMS ได้

ยังแก้ไม่ได้ใช่ไหม?

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

• ❌ ข้อผิดพลาด OAuth เดิมปรากฏหลังเชื่อมต่อใหม่
• ❌ Cloudbeds ยังคงปฏิเสธการแลกเปลี่ยน authorization code
• ❌ คุณยืนยันบัญชีหรือ property ของ Cloudbeds ที่ถูกต้องไม่ได้

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

• ภาพหน้าจอแถบข้อผิดพลาด
• เวลาที่ปัญหาเริ่มต้น
• ข้อความที่แสดงใน AVA แบบตรงตัว

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

• PMS Connection
• PMS Options
• PMS Connection Errors