หน้านี้ได้รับการแปลโดย Cloud Translation API

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` หมายเหตุ: ห้องพัก `"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` คุณกำหนดค่านี้ได้ผ่าน "ห้องว่างเริ่มต้น" ในการตั้งค่าราคาของ Hotel 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 สำหรับปัญหา ดูรายละเอียดเกี่ยวกับข้อผิดพลาดเหล่านี้ได้ใน ข้อความแสดงข้อผิดพลาดของสถานะฟีด

ตัวอย่าง

Success

การตอบกลับข้อความ 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>