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

ภาพรวม

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

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

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

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

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

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

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

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

หลักเกณฑ์

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

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

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

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

  • CountType ต้องมีค่า 2 เสมอจึงจะถูกต้อง เนื่องจากจะแสดงจำนวน "ความพร้อมที่แน่นอน"

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

พื้นที่โฆษณากับความพร้อมใช้งาน

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

คุณอาจ "ไม่มีห้องว่าง" ได้แม้ว่าจะมีสินค้าคงคลังก็ตาม เนื่องจากสินค้าคงคลังและความพร้อมจำหน่ายสินค้าเป็นอิสระจากกัน

ความพร้อมใช้งานมี 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> ให้ใช้รหัสเดียวกับที่คุณใช้ในระบบสำหรับประเภทห้องพัก ความสอดคล้องกับระบบของคุณเป็นสิ่งสำคัญที่ทำให้มั่นใจได้ว่า 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>