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` ของข้อความธุรกรรม (ข้อมูลพร็อพเพอร์ตี้) และค่าแอตทริบิวต์ `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` ระบบจะไม่รวมวันอื่นของสัปดาห์ที่ไม่ได้ตั้งค่าเป็น `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` หมายเหตุ: `"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>` หรือ <ข้อจำกัด> หากการตั้งค่าเริ่มต้นเป็น `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>

OTA_HotelAvailNotifRQ จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

คำขอ

ไวยากรณ์

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

ตัวอย่าง

วันที่มาถึงแบบ LOS

ระยะเวลา LoS

นำข้อจำกัด LoS ออก

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

ข้อจำกัดในการเดินทางมาถึง

วันที่เปิดให้จอง

ปิดวันที่ไม่พร้อมให้บริการ

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

การจองที่ปิดรับ

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

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

FullPatternLoS

คำตอบ

ไวยากรณ์

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

ตัวอย่าง

สำเร็จ

ข้อผิดพลาด

OTA_HotelAvailNotifRQ