การอ้างอิง XML ห้องว่าง ราคา และห้องว่าง (ARI)

คู่มืออ้างอิง XML นี้มีเนื้อหาการอ้างอิงโดยละเอียดและตัวอย่างโค้ดสำหรับข้อความ องค์ประกอบ และแอตทริบิวต์ต่างๆ สำหรับฟีดความพร้อมใช้งาน ราคา และห้องว่าง (ARI)

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

ARI ใช้โปรโตคอลมาตรฐานของ OpenTravel Alliance (OTA) สำหรับข้อความหลักบางประเภทเพื่อกำหนดความพร้อมให้บริการและพื้นที่โฆษณา

การกำหนดราคาตาม LOS

ราคา LOS-based ช่วยให้คุณระบุราคาต่อวันที่เช็คอินและระยะเวลาในการเข้าพัก แทนที่จะเป็นต่อวันที่เข้าพัก เมื่อระบุองค์ประกอบ <StatusApplicationControl>สำหรับการกำหนดราคาตาม LOS แอตทริบิวต์ @Start และ @End จะแสดงถึงช่วงวันที่เช็คอินที่ใช้กับราคา LOS

แม้ว่าเมื่อใช้การกำหนดราคาตาม LOS จะไม่มีราคาต่อคืนอีกต่อไป แต่คุณยังคงใช้ฟีเจอร์ ARI อื่นๆ ทั้งหมด (จำนวนห้อง ห้องว่าง กฎ โปรโมชัน ฯลฯ) กับราคาเหล่านี้ได้ และจะมีการระบุที่ระดับต่อคืน ซึ่งหมายความว่าหากระบบของคุณสอดคล้องกับระบบการกำหนดราคาตาม LOS มากขึ้น คุณก็ยังใช้ประโยชน์จากชุดฟีเจอร์ ARI ที่ครอบคลุมได้ นอกเหนือจากประสิทธิภาพแบนด์วิดท์ที่ได้รับจากการใช้การอัปเดตความพร้อมและข้อจำกัดรายคืน

หากต้องการเปิดใช้การกำหนดราคาตาม LOS ในบัญชี โปรดติดต่อ TAM หรือติดต่อเรา

ARI ใช้ข้อความคำขอต่อไปนี้

  • Transaction (Property Data) กำหนดประเภทและข้อมูลแพ็กเกจ (แพ็กเกจราคา)

  • OTA_HotelRateAmountNotifRQ กำหนดจำนวนอัตราการเข้าพักต่อวันหรือตาม LOS ต่อผลิตภัณฑ์ (ชุดค่าผสมของประเภทห้องพักและแพ็กเกจราคา) สำหรับช่วงวันที่ที่เฉพาะเจาะจง

  • OTA_HotelAvailNotifRQ กำหนดความพร้อมให้บริการและข้อจำกัดตามประเภทห้องพักและแพ็กเกจราคา ข้อความนี้ใช้อัปเดตห้องว่างได้ด้วย แต่ขอแนะนำให้ใช้ OTA_HotelInvCountNotifRQ แทน

  • OTA_HotelInvCountNotifRQ กำหนดสินค้าคงคลังของห้องพักจริงหรือ จำนวนห้องพักที่พร้อมขาย

  • TaxFeeInfo (ไม่บังคับ) กำหนดภาษีและค่าธรรมเนียมต่อที่พัก คุณไม่จำเป็นต้องใช้ข้อความนี้หากระบุ AmountAfterTax ในข้อความ OTA_HotelRateAmountNotifRQ อยู่แล้ว

  • Promotions (ไม่บังคับ) กำหนดราคาโปรโมชันสำหรับการจอง การเข้าพัก และผู้ใช้บางราย

  • RateModifications (ไม่บังคับ) กำหนดกฎการแก้ไขราคาสำหรับการจอง การเข้าพัก และผู้ใช้บางราย

  • ExtraGuestCharges (ไม่บังคับ) กำหนดวิธีกำหนดค่าราคาสำหรับเด็กและผู้ใหญ่เพิ่มเติม

แต่ละข้อความจะมีข้อมูลชุดย่อยที่ Google ใช้เพื่อคำนวณราคาและความพร้อมให้บริการ ซึ่งปรากฏต่อผู้ใช้เมื่อค้นหาที่พักของคุณด้วยวันที่เช็คอินและเช็คเอาต์ที่เจาะจง รวมถึงอัตราการเข้าพัก

ประวัติการแก้ไขการอ้างอิง XML ของ ARI

ตารางต่อไปนี้แสดงการอัปเดตข้อมูลเอกสารเมื่อมีการเปลี่ยนแปลงฟีเจอร์เท่านั้น

วันที่ การเปลี่ยนแปลง
14 สิงหาคม 2020 รุ่นแรก
21 ตุลาคม 2020 เพิ่มประเภทข้อความ Promotions
17 พฤศจิกายน 2020 สำหรับข้อความ Transaction (Property Data) มีการอัปเดตปลายทางและเพิ่มแอตทริบิวต์ action ไปยังองค์ประกอบ PropertyDataSet
24 พฤศจิกายน 2020 สำหรับข้อความ Transaction (Property Data) มีการเพิ่มองค์ประกอบ <AllowablePackageIDs> และ <AllowableRoomIDs>
4 กุมภาพันธ์ 2021 เพิ่มข้อความตอบกลับ
25 กุมภาพันธ์ 2021 เพิ่ม OTA_HotelInvCountNotifRQ แล้ว
21 ตุลาคม 2020 เพิ่มประเภทข้อความการปรับราคา