การอ้างอิง 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 (ข้อมูลพร็อพเพอร์ตี้) กำหนดประเภทและข้อมูลแพ็กเกจ (แพ็กเกจราคา)

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

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

  • OTA_HotelInvCountNotifRQ กำหนดห้องว่างหรือจำนวนห้องสำหรับขาย

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

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

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

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

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

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

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

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