OTA_HotelAvailNotifRQ

คำขอ

ไวยากรณ์

ข้อความ OTA_HotelAvailNotifRQ ใช้ไวยากรณ์ต่อไปนี้

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

ข้อความ <OTA_HotelAvailNotifRQ> แต่ละข้อความจะถือเป็นการอัปเดตเดลต้า สำหรับที่พัก วันที่ ห้องพัก และแพ็กเกจแต่ละรายการที่ระบุใน <StatusApplicationControl> การอัปเดตข้อจำกัดที่กำหนดไว้ก่อนหน้านี้ จะแทนที่ค่าของข้อจำกัดเดียวกันเท่านั้น ขณะที่เพิ่มข้อจำกัดใหม่ ไม่มีผลกระทบต่อข้อจำกัดอื่นๆ ที่กำหนดไว้ก่อนหน้านี้ เช่น หากค่าขั้นต่ำ มีการกำหนดระยะเวลาในการเข้าพัก 2 วันก่อนหน้านี้ จากนั้นข้อความใหม่ ที่มีการอัปเดตระยะเวลาในการเข้าพักสูงสุดเพียง 7 วันเท่านั้น จากนั้น การดำเนินการจะไม่ลบค่าระยะเวลาในการเข้าพักขั้นต่ำก่อนหน้า

องค์ประกอบและแอตทริบิวต์

ข้อความ OTA_HotelAvailNotifRQ มีองค์ประกอบและแอตทริบิวต์ต่อไปนี้

หมายเหตุ: ข้อจำกัดระยะเวลาในการเข้าพักแต่ละประเภทมีดังนี้ ตั้งค่าแยกกันได้ ตัวอย่างเช่น ข้อความที่ระบุว่า SetMaxLOS ไม่เขียนทับค่าที่กำหนดไว้ก่อนหน้านี้ สำหรับ SetForwardMaxStay

องค์ประกอบ / @แอตทริบิวต์ จำนวนข้อผิดพลาด ประเภท คำอธิบาย
OTA_HotelAvailNotifRQ 1 Complex element องค์ประกอบรูทของข้อความที่กำหนดความพร้อมใช้งานของราคาห้องพัก
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) เนมสเปซ XML
OTA_HotelAvailNotifRQ / @EchoToken 1 string ตัวระบุที่ไม่ซ้ำกันสำหรับข้อความคำขอนี้ ระบบแสดงผลค่านี้ ในข้อความตอบกลับ อักขระที่อนุญาตคือ a-z A-Z, 0-9, _ (ขีดล่าง) และ - (ขีดกลาง)
OTA_HotelAvailNotifRQ / @TimeStamp 1 DateTime วันที่และเวลาที่สร้างข้อความนี้
OTA_HotelAvailNotifRQ / @Version 1 decimal เวอร์ชันข้อความของ OpenTravel
OTA_HotelAvailNotifRQ / POS 0..1 POS คอนเทนเนอร์สำหรับระบุบัญชีพาร์ทเนอร์ของข้อความนี้ ใช่เลย ใช้ในกรณีที่แบ็กเอนด์แสดงฟีดราคา บัญชีพาร์ทเนอร์หลายบัญชี
OTA_HotelAvailNotifRQ / POS/ Source 1 Source ต้องระบุหากมี <POS> ปรากฏอยู่ คอนเทนเนอร์สำหรับ <RequestorID>
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID ต้องระบุหากมี <POS> อยู่ กําหนดพาร์ทเนอร์ ของคุณได้
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string บัญชีพาร์ทเนอร์สำหรับข้อความนี้ ค่าสตริงนี้คือค่า ค่า Partner key ที่แสดงในส่วน หน้าการตั้งค่าบัญชีใน Hotel Center

หมายเหตุ: หากคุณมีแบ็กเอนด์ที่มีฟีดสำหรับ บัญชี ค่านี้ต้องตรงกับ partner ของข้อความ Transaction (Property Data) และฟังก์ชัน ID ในคอลัมน์ องค์ประกอบ <RequestorID> ของ <OTA_HotelRateAmountNotifRQ> ข้อความสำหรับ ของคุณได้
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages คอนเทนเนอร์สําหรับ <AvailStatusMessage> อย่างน้อย 1 รายการ จากองค์ประกอบเหล่านี้
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับแอตทริบิวต์ รหัสโรงแรมที่ระบุโดยใช้ &lt;id&gt; ในองค์ประกอบ <listing> ในฟีดข้อมูลโรงแรม นอกจากนี้ รหัสโรงแรมยังอยู่ใน Hotel Center ด้วย
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage กําหนดความพร้อมใช้งานและข้อจํากัดของราคาห้องพักในช่วงเวลาต่างๆ สำหรับพร็อพเพอร์ตี้เดียว
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer หมายเหตุ: ระบบจะใช้ข้อความ OTA_HotelInvCountNotifRQ กับการตั้งค่านี้

จำนวนห้องที่เหลือที่สามารถจองได้สำหรับ ช่วงวันที่ใน <StatusApplicationControl> ถ้า ระบุ BookingLimit แล้ว <StatusApplicationControl> ต้องระบุ InvTypeCode และ <AvailStatusMessage> ต้องไม่มี <LengthOfStay> หรือ <RestrictionStatus>

ต้องเท่ากับหรือ มากกว่า 0 ค่าเริ่มต้นจะเป็น 0 หากมีค่าเป็นลบหรือไม่ได้ระบุ

หมายเหตุ: หากต้องการระบุห้องว่างสำหรับ การตั้งค่า <StatusApplicationControl> ต้องตั้งค่าแอตทริบิวต์ BookingLimit อย่างน้อย 1 ครั้ง
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl กำหนดช่วงวันที่ รวมทั้งตัวระบุสำหรับประเภทห้องพัก —InvTypeCode และแพ็กเกจราคา —RatePlanCode
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date วันที่เริ่มต้นตามเขตเวลาของที่พักที่ครอบคลุม ของช่วงวันที่
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) รวม ช่วงวันที่ ต้องเท่ากับหรือมากกว่าค่า start หาก start และ end เท่ากัน การอัปเดตจะมีผล ถึงวันที่นั้น
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันจันทร์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ ยกเว้นการตั้งค่าที่ชัดเจนเป็น "จริง" แล้ว ถูกกรองออกจากวันที่ภายใน Start and End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันอังคารไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันพุธไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันพฤหัสบดีไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันศุกร์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันเสาร์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น กรองออกจากวันที่ในส่วน "เริ่มต้น" และ End)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันอาทิตย์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string ตัวระบุที่ไม่ซ้ำกันสำหรับห้องพัก (ประเภทห้องพัก) ค่านี้จะแมป ไปยัง <RoomID> ในธุรกรรม (Property Data)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string ตัวระบุที่ไม่ซ้ำกันสำหรับแพ็กเกจราคา ตัวระบุนี้จะแมปกับ ของ <PackageID> ในธุรกรรม (ข้อมูลพร็อพเพอร์ตี้) โดยจะมีการกำหนดและอ้างอิงถึงแพ็กเกจราคาเพิ่มเติม ใน <StatusApplicationControl> ทั้ง <OTA_HotelRateAmountNotifRQ> และ <OTA_HotelAvailNotifRQ> ข้อความ

แอตทริบิวต์ RatePlanCode ไม่เกี่ยวข้องและต้องระบุ ไม่ได้ระบุไว้ เมื่อ <AvailStatusMessage> มี BookingLimit ต้องระบุหาก <RestrictionStatus> หรือ ระบุ <LengthOfStay> แล้ว
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay คอนเทนเนอร์สำหรับการกำหนดข้อจำกัด LOS ต้องไม่มีค่านี้อยู่หาก <AvailStatusMessage> ประกอบด้วย BookingLimit
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer ความยาวของรูปแบบที่กำหนดไว้ใน FullPatternLOS

หมายเหตุ: ต้องตั้งค่าแอตทริบิวต์นี้เมื่อใช้ MinMaxMessageType="FullPatternLOS" และไม่มีอยู่

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay กำหนดข้อจำกัดเกี่ยวกับระยะเวลาในการเข้าพัก เมื่อใช้มากกว่าหนึ่ง <LengthOfStay> แต่ละรายการต้องระบุ ค่า MinMaxMessageType ที่แตกต่างกัน
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer ค่าต่อหน่วยการวัดของระยะเวลาในการเข้าพัก โปรดทราบว่าค่าของ ศูนย์จะถือว่าไม่มีข้อจำกัด เช่น <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> หมายถึงไม่มีขีดจำกัดสูงสุด ระยะเวลาในการเข้าพัก

หมายเหตุ: ต้องตั้งค่าแอตทริบิวต์นี้เว้นแต่จะใช้ MinMaxMessageType="FullPatternLOS"

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum หน่วยของเวลา ค่าเริ่มต้นจะเป็น "Day" หากไม่ได้ระบุไว้ ถูกต้อง คือ
  • Day
หมายเหตุ: ห้อง "Day" 1 ห้องเท่ากับการเข้าพัก 1 คืน
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum ประเภทต่างๆ ของข้อจำกัดระยะเวลาในการเข้าพัก SetMaxLOS, SetMinLOS และ FullPatternLOS กำลังมาถึง อ้างอิง SetForwardMinStay และ SetForwardMaxStay อิงตามระยะเวลาที่พัก ค่าสูงสุดต้องเป็น มากกว่าหรือเท่ากับค่าต่ำสุด
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern 0..1 LOS_Pattern กำหนดรูปแบบข้อจำกัดในการเข้าพัก

หมายเหตุ: ต้องมีองค์ประกอบนี้เมื่อใช้ MinMaxMessageType="FullPatternLOS" และไม่มีอยู่

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string ลําดับของอักขระ Y และ N ที่ระบุ แต่ละระยะเวลาในการเข้าพักได้รับอนุญาตหรือไม่ ตั้งแต่ 1 คืนไปจนถึงค่าใน FixedPatternLength ระยะเวลาในการเข้าพักที่มากกว่า FixedPatternLength จะรับค่าที่ตำแหน่งสุดท้าย สำหรับ ตัวอย่างเช่น FixedPatternLength="4" และ FullPatternLOS="YNYN" อนุญาตให้ใช้ระยะเวลาในการเข้าพัก 1 และ 3 เท่านั้น
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus กำหนดข้อจำกัดของแผนการเดินทาง ต้องไม่มีค่านี้อยู่หาก <AvailStatusMessage> ประกอบด้วย BookingLimit
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0..1 enum ระบุว่าประเภทของข้อจำกัดที่ระบุโดย แอตทริบิวต์ Restriction เปิดหรือปิดอยู่ ค่าที่ถูกต้อง ได้แก่
  • Open
  • Close

หมายเหตุ

  • โดยค่าเริ่มต้น Google จะถือว่า การตั้งค่าMasterสำหรับผลิตภัณฑ์ทั้งหมดคือClose คุณกําหนดค่านี้ได้ผ่าน "ความพร้อมใช้งานเริ่มต้น" ใน โรงแรม การตั้งค่าการกำหนดราคา Center "ปิด" ใน Hotel Center ตรงกับค่า Close ที่นี่
  • การตั้งค่า Master เป็น Close เรียกว่า "หยุดการขาย"
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

ต้องระบุแอตทริบิวต์นี้หากระบุ Status

ค่าที่ใช้ได้มีดังนี้

  • Arrival: ค่านี้จะป้องกันไม่ให้มีแผนการเดินทางที่มี วันที่เช็คอินในช่วงวันที่ Start และ End โดยครอบคลุมทุกช่วง
  • Departure: ค่านี้จะป้องกันไม่ให้มีแผนการเดินทางที่มี วันที่เช็คเอาต์ในระหว่างStartและEnd ช่วงวันที่ด้วย
  • Master: ค่านี้จะระบุว่าห้อง พร้อมให้จองในวันที่นั้นๆ

หมายเหตุ: หากไม่ได้ระบุ Restriction ค่า ค่าเริ่มต้นคือ Master
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration ระยะเวลาขั้นต่ำก่อนวันที่เข้าพัก (ในพื้นที่ของที่พัก เวลา) ที่สามารถจองด้วยราคาห้องพักนี้ได้

ประเภทค่าที่ถูกต้องมีดังนี้

  • Integer: จำนวนวันก่อนที่จะมาถึง วันที่ เช่น ค่า 1 บ่งบอกถึงราคาห้องพัก ต้องจองล่วงหน้าอย่างน้อย 1 วันก่อนวันที่เข้าพัก ค่า 0 (ค่าเริ่มต้น) บ่งชี้ว่าไม่มีข้อจำกัด เวลาจองล่าสุด
  • ISO 8601 Duration (days, hours, and minutes): จำนวนวัน (และอาจรวมถึงชั่วโมง/นาที) ก่อนเดินทางมาถึง วันที่ เช่น ค่า P1D บ่งบอกถึงห้องนั้น จะต้องจอง 1 วันก่อนวันที่เข้าพัก ค่า P0DT6H ระบุว่าต้องมีการจองภายใน 6 ชั่วโมง ก่อนสิ้นสุดวันที่เข้าพัก (เช่น 18:00 น.) หรือก่อนหน้านั้น
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration ระยะเวลาสูงสุดก่อนวันที่เข้าพัก (ในพื้นที่ของที่พัก) เวลา) ที่สามารถจองด้วยราคาห้องพักนี้ได้

ประเภทค่าที่ถูกต้องมีดังนี้

  • Integer: จำนวนวันก่อนที่จะมาถึง วันที่ เช่น ค่า 30 บ่งบอกถึงราคาห้องพัก จองล่วงหน้า 30 วันก่อนถึงวันที่เข้าพักไม่ได้ ต ค่าของ 0 (ค่าเริ่มต้น) บ่งบอกว่าไม่มีข้อจำกัด ในช่วงเวลาจองเร็วที่สุด
  • ISO 8601 Duration (days, hours, and minutes): จำนวนวัน (และอาจรวมถึงชั่วโมง/นาที) ก่อนเดินทางถึง วันที่ เช่น ค่า P30D บ่งบอกถึงห้องนั้น ราคาห้องพักนี้จะจองล่วงหน้าเกิน 30 วันก่อนวันที่เข้าพักไม่ได้ ค่า P30DT6H บ่งบอกว่าไม่สามารถทำการจองได้ ก่อน 18:00 น. 30 วันก่อนวันที่เข้าพัก

ตัวอย่าง

วันที่ LoS มาถึง

ตั้งค่าระยะเวลาในการเข้าพักขั้นต่ำและสูงสุด (โดยอิงตามวันที่เข้าพัก)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

ระยะเวลา LoS

ตั้งค่าระยะเวลาในการเข้าพักขั้นต่ำและสูงสุด (โดยอิงตามระยะเวลาที่พัก)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

ข้อจำกัดการออกเดินทาง

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

ข้อจำกัดการเดินทาง

กำหนดข้อจำกัดช่วงเวลาที่ห้ามเข้าพัก (การดำเนินการนี้จะป้องกันไม่ให้มีแผนการเดินทางที่มี เช็คอินในวันที่ที่ระบุ)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

เปิดวันที่สินค้าพร้อมจำหน่าย

เปิดความพร้อมให้บริการสำหรับประเภทห้องพักและแพ็กเกจราคาในวันที่ที่ระบุ

หมายเหตุ: ต้องมีราคาต่อคืนพร้อมกับจำนวนห้องว่าง มากกว่า 0 สำหรับประเภทห้องพัก ก่อนที่ราคาจะพร้อมใช้งานโดยสมบูรณ์

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>


ปิดวันที่สินค้าพร้อมจำหน่าย

ปิดความพร้อมให้บริการสำหรับประเภทห้องพักและแพ็กเกจราคาในวันที่ที่ระบุ ( หรือที่เรียกว่า "หยุดการขาย")

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

ข้อจำกัดการจองล่วงหน้า

กำหนดข้อจำกัดช่วงเวลาการจองล่วงหน้าขั้นต่ำและสูงสุด โดยจะมีผลเท่านั้น ในช่วงสุดสัปดาห์

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

การจองเวลาสุดท้าย

กำหนดวันปิดรับคำสั่งซื้อสำหรับการจองในวันที่เข้าพักเวลา 18:00 น. ที่เวลาท้องถิ่นของโรงแรม 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

ข้อจำกัดหลายประการ

กำหนดข้อจำกัดหลายรายการในช่วงวันที่เดียวกันสำหรับประเภทห้องพักและแพ็กเกจราคา

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>


ขีดจำกัดการจอง

ตั้งค่าจำนวนห้องพักสำหรับประเภทห้องพักในช่วงวันที่ที่ระบุ

หมายเหตุ: OTA_HotelInvCountNotifRQ ข้อความจะเป็นที่ต้องการมากกว่าการตั้งค่าแอตทริบิวต์นี้

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

FullPatternLoS

ตั้งค่าข้อจำกัดการเข้าพักแบบเต็มระยะ

สำหรับการเช็คอินในวันที่ 26 กรกฎาคม 2023 เฉพาะระยะเวลาในการเข้าพัก 2, 4 และ 6 คนเท่านั้นที่ อนุญาต ไม่มีระยะเวลาในการเข้าพัก 1, 3, 5 และ 7 ปีขึ้นไป

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

การตอบกลับ

ไวยากรณ์

ข้อความ OTA_HotelAvailNotifRS ใช้ไวยากรณ์ต่อไปนี้

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       EchoToken="echo_token"
                       Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

องค์ประกอบและแอตทริบิวต์

ข้อความ OTA_HotelAvailNotifRS มีองค์ประกอบและแอตทริบิวต์ต่อไปนี้

องค์ประกอบ / @แอตทริบิวต์ จำนวนข้อผิดพลาด ประเภท คำอธิบาย
OTA_HotelAvailNotifRS 1 Complex element องค์ประกอบรูทสำหรับการตอบกลับข้อความความพร้อมจำหน่ายสินค้า
OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime วันที่และเวลาที่สร้างข้อความนี้
OTA_HotelAvailNotifRS / @EchoToken 1 string ตัวระบุที่ไม่ซ้ำกันจาก OTA_HotelAvailNotifRQ ข้อความ
OTA_HotelAvailNotifRS / Success 0..1 Success ระบุว่าข้อความ OTA_HotelAvailNotifRQ ถูก ประมวลผลสำเร็จแล้ว

<Success> หรือ <Errors> อาจเป็น ที่อยู่ในแต่ละข้อความ
OTA_HotelAvailNotifRS / Errors 0..1 Errors คอนเทนเนอร์สำหรับปัญหาอย่างน้อย 1 รายการที่พบขณะประมวลผล OTA_HotelAvailNotifRQ ข้อความ

<Success> หรือ <Errors> อาจเป็น ที่อยู่ในแต่ละข้อความ
OTA_HotelAvailNotifRS / Errors / Error 1..n Error คำอธิบายของข้อผิดพลาดที่พบขณะประมวลผล OTA_HotelAvailNotifRQ ข้อความ รายละเอียดเกี่ยวกับข้อผิดพลาดเหล่านี้สามารถ สามารถพบได้ใน ข้อความแสดงข้อผิดพลาดของสถานะฟีด
OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer OpenTravel Alliance EWT (ประเภทคําเตือนข้อผิดพลาด) ที่เกี่ยวข้องกับ ใช้เฉพาะค่า 12 (Processing exception) เท่านั้น
OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer OpenTravel Alliance ERR (รหัสข้อผิดพลาด) ที่เกี่ยวข้องกับข้อผิดพลาดนี้ ใช้เฉพาะค่า 450 (Unable to process) เท่านั้น
OTA_HotelAvailNotifRS / Errors / Error / @Code 1 enum สถานะของคำขอเดิม เฉพาะค่า ใช้งาน NotProcessed
OTA_HotelAvailNotifRS / Errors / Error / @ShortText 1 string ตัวระบุ Google สำหรับปัญหา รายละเอียดเกี่ยวกับข้อผิดพลาดเหล่านี้อาจ พบใน ข้อความแสดงข้อผิดพลาดของสถานะฟีด

ตัวอย่าง

สำเร็จ

การตอบกลับการประมวลผลสำเร็จมีดังนี้ ข้อความ OTA_HotelAvailNotifRQ

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

ข้อผิดพลาด

การตอบกลับข้อความ OTA_HotelAvailNotifRQ ที่ไม่ได้ประมวลผลมีดังนี้ เนื่องจากข้อผิดพลาด

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>