ข้อความสินค้าคงคลัง

ภาพรวม

ข้อความเกี่ยวกับห้องพัก (OTA_HotelInvCountNotifRQ) จะกำหนดจำนวนห้องพัก (จำนวนห้องจริง) ที่พร้อมให้จองสำหรับประเภทห้องพักที่เฉพาะเจาะจง เมื่อส่งข้อความ "พื้นที่โฆษณา" คุณจะต้องระบุจำนวนห้อง ประเภทที่มีอยู่ในวันที่ที่ระบุ หากไม่มีห้องประเภทนี้ ผลิตภัณฑ์ที่เกี่ยวข้องกับประเภทห้องและวันที่ดังกล่าวจะไม่แสดง

ส่วนต่อไปนี้ครอบคลุมหลักเกณฑ์ทั่วไป ตัวอย่างพื้นฐาน และวิธีการ เพื่อช่วยให้คุณเริ่มต้นเพิ่มและอัปเดตสินค้าคงคลังและการส่ง ข้อความพื้นที่โฆษณา

ดูตัวอย่างสถานการณ์ต่างๆ ที่เกี่ยวข้องกับพื้นที่โฆษณาได้ที่ วิธีการ

องค์ประกอบที่จำเป็นและไม่บังคับ

การอ้างอิง XML จะให้คำอธิบายขององค์ประกอบที่จำเป็นและที่ไม่บังคับ โปรดดูรายละเอียด เกี่ยวกับแอตทริบิวต์และองค์ประกอบย่อย โปรดดูองค์ประกอบพื้นที่โฆษณาและ

ไวยากรณ์และสคีมา

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

คุณสามารถใช้เครื่องมือ XML ของบุคคลที่สาม เช่น xmllint เพื่อตรวจสอบฟีดกับ สคีมาที่เผยแพร่ก่อนส่งไปยัง Google สำหรับพื้นที่โฆษณา สคีมาข้อความ โปรดดูสคีมา Hotel Ads

หลักเกณฑ์

ใช้หลักเกณฑ์ต่อไปนี้สำหรับข้อความพื้นที่โฆษณา

  • ระบบจะกำหนดห้องว่างตามโรงแรม วันที่ และประเภทห้องพัก

  • จำนวนห้องว่างต้องมากกว่า 0 สำหรับทุกคืนที่เข้าพักเพื่อ เพื่อแสดงราคาสำหรับแพ็กเกจราคาและอัตราการเข้าพักที่เกี่ยวข้อง

  • หากจำนวนห้องว่างเท่ากับ 0 ห้องจะไม่พร้อมใช้งานสำหรับ ให้ระบุรหัสห้องพักและช่วงวันที่ที่ระบุ

  • CountType ต้องมีค่า 2 เพื่อให้ใช้งานได้เสมอ เนื่องจากมีการระบุ จำนวน "ความพร้อมที่แน่นอน"

  • ส่งห้องว่างที่อัปเดตทุกครั้งที่มีการจองหรือยกเลิกห้องพักในระบบ

สินค้าคงคลังกับความพร้อมจำหน่ายสินค้า

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

อาจไม่มีสถานะ "ไม่มีห้องว่าง" แม้จะมีพื้นที่โฆษณาอยู่แล้ว และความพร้อมให้บริการ เป็นอิสระจากกัน

ความพร้อมให้บริการมี 2 แบบ ประการแรกคือความพร้อมจำหน่ายสินค้าโดยรวมของผลิตภัณฑ์สำหรับการเข้าพักหนึ่งๆ ซึ่งได้รับผลกระทบจากปัจจัยต่างๆ เช่น ห้องพักทุกคืนมีราคาที่กำหนดไว้หรือไม่ ห้องพักสำหรับประเภทห้องพักที่เกี่ยวข้องมีห้องว่างหรือไม่ และข้อจำกัดด้านความพร้อมจำหน่ายสินค้าเปิดอยู่หรือไม่ อย่างที่ 2 มีการตั้งค่า ข้อจำกัดสำหรับผลิตภัณฑ์ในวันที่ที่ระบุ แสดงด้วย <RestrictionStatus Restriction="Master" Status="Open"/> ใน OTA_HotelAvailNotifRQ และปิดการขาย ความพร้อมจำหน่ายสินค้านี้เรียกว่า "หยุดการขาย"

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

ตัวอย่าง

ส่วนนี้จะแสดงตัวอย่างพื้นฐานของข้อความพื้นที่โฆษณาที่ใช้ "ต้องระบุ" และองค์ประกอบที่ไม่บังคับ เมื่อเตรียมไฟล์แล้ว คุณจะต้องส่งไปยัง Google ผ่านข้อความ POST ไปยังปลายทางนี้

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/โพสต์ข้อความ โปรดดูที่การพุช ข้อความ

สำหรับ HotelCode ให้ใช้รหัสโรงแรมที่ไม่ซ้ำกันซึ่งคุณใช้ภายในระบบ ในการระบุพร็อพเพอร์ตี้ ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ <id> ใน<listing> ในส่วน ฟีดข้อมูลโรงแรม สำหรับ <RoomID> ให้ใช้รหัสเดียวกับที่คุณใช้ในระบบสำหรับประเภทห้องพัก ความสอดคล้องกับระบบของคุณเป็นสิ่งสำคัญในการตรวจสอบว่า แสดงข้อมูลอย่างถูกต้อง

ตัวอย่างนี้แสดงวิธีตั้งค่าห้องว่างสำหรับห้องที่จองได้ 13 ห้องในเดือนธันวาคม

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

ดูตัวอย่างเพิ่มเติมได้ที่พื้นที่โฆษณา ตัวอย่าง

วิธีการ

ส่วนนี้จะแสดงสถานการณ์ที่คุณอาจพบในระหว่างส่ง ข้อความสินค้าคงคลัง

สถานการณ์: วิธีบล็อกไม่ให้มีการจองห้อง

คำอธิบาย

คุณต้องระบุว่าไม่มีห้องเหลือที่สามารถจองได้ ห้องพักประเภทนี้ ในช่วงวันที่ที่เจาะจง ซึ่งส่วนใหญ่มักจะเป็นเพราะ เต็ม

โซลูชัน

คุณตั้งค่า <InvCount Count> เป็นค่า 0 และเพิ่มช่วงวันที่ที่ต้องการ

ตัวอย่าง

ตัวอย่างนี้แสดงวิธีใช้ InvCount เพื่อตั้งค่าพื้นที่โฆษณาเป็น 0 สำหรับ ระบุห้องและวันที่ (เช่น 2-3 สัปดาห์แรกในเดือนมกราคม)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>