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

ภาพรวม

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

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

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

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

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

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

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

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

หลักเกณฑ์

ใช้หลักเกณฑ์ต่อไปนี้สำหรับข้อความสินค้าคงคลัง

ระบบจะระบุห้องว่างตามโรงแรม วันที่ และประเภทห้องพัก
จำนวนห้องว่างต้องมากกว่า 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

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีพุช/POST ข้อความได้ที่การพุช ข้อความ

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

ตัวอย่างนี้แสดงวิธีตั้งค่าห้องว่างสำหรับห้องที่จองได้ 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>