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 ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ <id> ในองค์ประกอบ <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> ในข้อความ Transaction (Property Data)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string ตัวระบุที่ไม่ซ้ำกันสำหรับแพ็กเกจราคา ตัวระบุนี้จะแมปกับค่าของ <PackageID> ในข้อความ Transaction (Property Data) โดยระบบจะกำหนดและอ้างถึงแพ็กเกจราคาเพิ่มเติมใน <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> มากกว่า 1 รายการ องค์ประกอบแต่ละรายการต้องระบุค่า MinMaxMessageType ที่แตกต่างกัน
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer ค่าต่อหน่วยการวัดของระยะเวลาในการเข้าพัก โปรดทราบว่าหากค่าเป็น 0 ระบบจะถือว่าไม่มีข้อจำกัด เช่น <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> หมายความว่าไม่มีระยะเวลาในการเข้าพักสูงสุด

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

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum หน่วยเวลา ค่าเริ่มต้นจะเป็น "Day" หากไม่ได้ระบุไว้ ค่าที่ใช้ได้มีดังนี้
  • Day
หมายเหตุ: 1 หน่วย "Day" เท่ากับการเข้าพัก 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

ค่า Open และ Close ใช้ได้กับค่าทั้งหมดขององค์ประกอบ <Restriction> เมื่อใช้ค่า Open และ Close ร่วมกับค่า Arrival และ Departure ระบบจะจำกัดวันที่ที่เจาะจงในแผนการเดินทางสำหรับเช็คอินและเช็คเอาต์ตามลำดับ

  • Open และ Close กับ Arrival: ชุดค่าผสมนี้ระบุวันที่ในแผนการเดินทางที่พร้อมให้เช็คอิน
  • Open และ Close กับ Departure: ชุดค่าผสมนี้ระบุวันที่ในแผนการเดินทางที่พร้อมให้เช็คเอาต์

    • วันที่ Arrival ไม่ได้จำกัดห้องว่างสำหรับคืนที่เข้าพักหลังจากวันที่เช็คอิน

    เช่น สำหรับการเข้าพักตั้งแต่วันที่ 1-4 เมษายน โดยที่วันที่ 2-4 เมษายนปิดไม่ให้เข้าพัก คุณจะยังจองได้

    หมายเหตุ

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

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

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

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

    ทั้ง Arrival และ Departure ต้องมีห้องว่างสำหรับแผนการเดินทางที่ระบุ ค่าเริ่มต้นสำหรับทั้ง Arrival และ Departure คือ Open เว้นแต่จะมีการส่งข้อความก่อนหน้าที่ระบุว่าปิดแล้ว นอกจากนี้ ชุดค่าผสมของห้องพัก/แพ็กเกจต้องพร้อมให้บริการสำหรับทุกวันที่ในแผนการเดินทาง ยกเว้นวันสุดท้ายของการเข้าพัก คุณตั้งค่าห้องว่างนี้ได้โดยใช้การตั้งค่าเริ่มต้นใน Hotel Center หรือผ่านองค์ประกอบ <Status> หรือ <Restriction> หากการตั้งค่าเริ่มต้นคือ Close คุณต้องส่งค่า Status เป็น Open และค่า restriction เป็น Master สำหรับวันที่ที่เกี่ยวข้องเพื่อเปิดความพร้อมจำหน่ายอีกครั้งสำหรับวันที่ในแผนการเดินทาง

    เช่น สำหรับการเข้าพัก 3 คืนที่มีวันที่มาถึงคือ 1 เมษายน แผนการเดินทางแบบเต็มจะเป็นวันที่ 1-4 เมษายน ค่า Status ควรตั้งเป็น Open และค่า Restriction ควรตั้งเป็น Master สำหรับการเข้าพักแบบค้างคืนตั้งแต่วันที่ 1-3 เมษายน วันสุดท้ายของการเข้าพัก (4 เมษายน) ปิดอยู่ เนื่องจากมีเฉพาะวันที่เข้าพักแบบรายคืนเท่านั้นที่ต้องเป็นสถานะ Open

    หมายเหตุ: หากไม่ได้ระบุ 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>

    นำข้อจำกัดด้าน LOS ออก

    การตั้งค่า Time="0" ใน <LengthOfStay> บ่งบอกว่าไม่มีข้อจำกัดสำหรับระยะเวลาในการเข้าพักที่ระบุ เช่น <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> หมายความว่าไม่มีข้อจำกัดเกี่ยวกับระยะเวลาในการเข้าพักสูงสุด

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