OTA_HotelRateAmountNotifRQ

คำขอ

ไวยากรณ์

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="message_ID"
                            TimeStamp="timestamp"
                            Version="3.0"
                            NotifType="[Overlay|Delta|Remove]"
                            NotifScopeType="[ProductRate]">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"
                                RatePlanType="[26]" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="float"
                            AmountAfterTax="float"
                            CurrencyCode="currency"
                            NumberOfGuests="integer"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="float"
                                   AgeQualifyingCode="[10|8]"
                                   MaxAge="integer"/>
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

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

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

องค์ประกอบ / @แอตทริบิวต์ จำนวนข้อผิดพลาด ประเภท คำอธิบาย
OTA_HotelRateAmountNotifRQ 1 Complex element องค์ประกอบรูทของข้อความราคา
OTA_HotelRateAmountNotifRQ / @xmlns 0..1 string (URI) เนมสเปซ XML
OTA_HotelRateAmountNotifRQ / @EchoToken 1 string ตัวระบุที่ไม่ซ้ำกันสำหรับข้อความคำขอนี้ ค่านี้จะแสดงในข้อความตอบกลับ อักขระที่อนุญาตคือ a-z, A-Z, 0-9, _ (underscore) และ - (dash)
OTA_HotelRateAmountNotifRQ / @TimeStamp 1 DateTime วันที่และเวลาที่สร้างข้อความนี้
OTA_HotelRateAmountNotifRQ / @Version 1 decimal เวอร์ชันของข้อความ OpenTravel
OTA_HotelRateAmountNotifRQ / @NotifType 0..1 enum

ประเภทของการแจ้งเตือนที่จะใช้กับ <RateAmountMessage> ทั้งหมด

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

หากต้องการทำความเข้าใจวิธีการทำงานของแอตทริบิวต์เหล่านี้ โปรดดูตัวอย่าง

  • Overlay: ลบราคาต่ออัตราการเข้าพักทั้งหมดสำหรับประเภทห้องพัก แพ็กเกจราคา และวันที่ที่ระบุใน <StatusApplicationControl> และแทนที่ด้วยราคาใหม่
  • Remove: ลบราคาต่ออัตราการเข้าพักที่มีอยู่ทั้งหมดสำหรับประเภทห้องพัก แพ็กเกจราคา และวันที่ที่ระบุใน <StatusApplicationControl>
  • Delta: (ใช้ค่าเริ่มต้นหากไม่ได้ระบุ NotifType) เพิ่มหรืออัปเดตราคาต่ออัตราการเข้าพักที่มีอยู่สำหรับประเภทห้องพัก แพ็กเกจราคา และวันที่ที่ระบุใน <StatusApplicationControl>
OTA_HotelRateAmountNotifRQ / @NotifScopeType 0..1 enum

ขอบเขตของ NotifType ที่จะใช้กับ <RateAmountMessage> ทั้งหมด

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

  • ProductRate: (ใช้ค่าเริ่มต้นหากไม่ได้ระบุ NotifScopeType) NotifType จะใช้กับผลิตภัณฑ์ ซึ่งเป็นชุดค่าผสมของประเภทห้องพัก (InvTypeCode) และแพ็กเกจราคา (RatePlanCode)
OTA_HotelRateAmountNotifRQ / POS 0..1 POS คอนเทนเนอร์สำหรับการระบุบัญชีพาร์ทเนอร์ของข้อความนี้ (โดยปกติแล้วจะใช้หากแบ็กเอนด์แสดงฟีดราคาสำหรับบัญชีพาร์ทเนอร์หลายบัญชี)
OTA_HotelRateAmountNotifRQ / POS / Source 1 Source ต้องระบุหากมี <POS> ปรากฏอยู่ คอนเทนเนอร์สำหรับ <RequestorID>
OTA_HotelRateAmountNotifRQ / POS / RequestorID 1 RequestorID ต้องระบุหากมี <POS> ปรากฏอยู่ กำหนดบัญชีพาร์ทเนอร์
OTA_HotelRateAmountNotifRQ / POS / RequestorID / @ID 1 string บัญชีพาร์ทเนอร์สำหรับข้อความนี้ ค่าสตริงนี้คือค่า "คีย์พาร์ทเนอร์" ที่ระบุไว้ใน หน้าการตั้งค่าบัญชีใน Hotel Center

หมายเหตุ: หากมีแบ็กเอนด์ที่มีฟีดสำหรับหลายบัญชี ค่านี้จะต้องตรงกับค่าแอตทริบิวต์ partner ของข้อความ Transaction (Property Data) และค่าแอตทริบิวต์ ID ในองค์ประกอบ <RequestorID> ของข้อความ <OTA_HotelAvailNotifRQ> สำหรับบัญชีเดียวกัน
OTA_HotelRateAmountNotifRQ / RateAmountMessages 1 RateAmountMessages คอลเล็กชันขององค์ประกอบ <RateAmountMessage> ที่กำหนดราคา
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode 1 string ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมซึ่งระบุโดยใช้ <id> ในองค์ประกอบ <listing> ในฟีดข้อมูลโรงแรม นอกจากนี้ รหัสโรงแรมยังแสดงอยู่ใน Hotel Center ด้วย
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage 1..n RateAmountMessage คอนเทนเนอร์สำหรับการกำหนดราคาห้องพัก (ชุดค่าผสมของประเภทห้องพักและแพ็กเกจราคาในช่วงวันที่)
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl 1 StatusApplicationControl กำหนดช่วงวันที่ รวมทั้งตัวระบุสำหรับประเภทห้องพัก (InvTypeCode) และแพ็กเกจราคา (RatePlanCode)
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start 1 Date วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End 1 Date วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย ต้องเท่ากับหรือมากกว่าค่า start หากวันที่ของ start และ end เท่ากัน การอัปเดตจะมีผลในวันที่ดังกล่าว โปรดทราบว่า Google รองรับข้อมูลย้อนหลังได้สูงสุด 3 ปี
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันจันทร์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true ระบบจะไม่รวมวันอื่นของสัปดาห์ที่ไม่ได้ตั้งค่าเป็น true ไว้อย่างชัดเจน (ระบบจะกรองวันอื่นของสัปดาห์ออกจากวันที่ภายใน Start และ End)
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันอังคารไว้อย่างชัดเจน

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

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

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

หากตั้งค่าเป็น true ระบบจะไม่รวมวันอื่นของสัปดาห์ที่ไม่ได้ตั้งค่าเป็น true ไว้อย่างชัดเจน (ระบบจะกรองวันอื่นของสัปดาห์ออกจากวันที่ภายใน Start และ End)
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันเสาร์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true ระบบจะไม่รวมวันอื่นของสัปดาห์ที่ไม่ได้ตั้งค่าเป็น true ไว้อย่างชัดเจน (ระบบจะกรองวันอื่นของสัปดาห์ออกจากวันที่ภายใน Start และ End)
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันอาทิตย์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true ระบบจะไม่รวมวันอื่นของสัปดาห์ที่ไม่ได้ตั้งค่าเป็น true ไว้อย่างชัดเจน (ระบบจะกรองวันอื่นของสัปดาห์ออกจากวันที่ภายใน Start และ End)
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode 1 string ตัวระบุที่ไม่ซ้ำกันสำหรับห้องพัก (ประเภทห้องพัก) ค่านี้จะแมปกับ <RoomID> ในข้อความ Transaction (Property Data)
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode 1 string ตัวระบุที่ไม่ซ้ำกันสำหรับแพ็กเกจราคา ตัวระบุนี้จะแมปกับ <PackageID> ในข้อความ Transaction (Property Data) โดยระบบจะกำหนดและอ้างถึงแพ็กเกจราคาเพิ่มเติมใน <StatusApplicationControl> ทั้งในข้อความ <OTA_HotelRateAmountNotifRQ> และ <OTA_HotelAvailNotifRQ>
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType 0..1 string ตัวระบุที่ระบุประเภทรูปแบบการกำหนดราคา ARI ที่มีผลกับการอัปเดตราคานี้ คุณควรระบุค่านี้โดยใช้ค่า 26 เฉพาะเมื่อใช้รูปแบบการกำหนดราคาตาม LOS การยกเว้นแอตทริบิวต์นี้บ่งบอกว่าเป็นการอัปเดตราคาตามวันที่
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates 0..1 Rates คอนเทนเนอร์สำหรับคอลเล็กชันขององค์ประกอบ <Rate> ไม่ต้องระบุองค์ประกอบนี้หาก NotifType เป็น "Remove" หากไม่เป็นเช่นนั้น คุณต้องระบุองค์ประกอบนี้เพียงครั้งเดียว
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate 1 Rate คอนเทนเนอร์สำหรับคอลเล็กชันขององค์ประกอบ <BaseByGuestAmts>
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @RateTimeUnit 0..1 String หน่วยที่ระบุระยะเวลาในการเข้าพัก ค่าที่รองรับเพียงค่าเดียวคือ "Day" ซึ่งหมายความว่าระบบจะระบุระยะเวลาในการเข้าพักเป็นวัน

หากต้องการใช้การกำหนดราคาตาม LOS คุณต้องระบุ RateTimeUnit และ UnitMultiplier มิเช่นนั้น ไม่ควรระบุค่าใดเลย
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer จำนวน RateTimeUnits ที่เป็นองค์ประกอบของระยะเวลาในการเข้าพักสำหรับราคานี้

ตัวอย่างเช่น หากค่า RateTimeUnits คือ "Day" UnitMultiplier เท่ากับ 5 หมายความว่าราคาที่ระบุไว้ภายใต้ออบเจ็กต์ Rate นี้จะมีผลกับแต่ละคืนของการเข้าพัก 5 คืน

ระบบจะคูณอัตราการเข้าพักที่ระบุไว้ในออบเจ็กต์ Rate นี้ด้วย UnitMultiplier (ระยะเวลาในการเข้าพัก) เพื่อหาราคารวมสำหรับการเข้าพัก

หากต้องการใช้การกำหนดราคาตาม LOS คุณต้องระบุ RateTimeUnit และ UnitMultiplier มิเช่นนั้น ไม่ควรระบุค่าใดเลย
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts 1 BaseByGuestAmts คอนเทนเนอร์สำหรับคอลเล็กชันของค่าใช้จ่ายพื้นฐาน
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt 1..n BaseByGuestAmt ระบุราคาห้องพักในสกุลเงินที่ระบุไว้ ระบบกำหนดราคาตามอัตราการเข้าพักได้ด้วยการใช้องค์ประกอบ <BaseByGuestAmt> หลายรายการ โดยแต่ละรายการจะมีค่า NumberOfGuests ต่างกัน หากไม่เป็นเช่นนั้น ราคาจะเป็นไปตามจำนวนผู้เข้าพักสูงสุดที่กำหนดโดย NumberOfGuests
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax 0..1 float

ราคาห้องพักรายวันก่อนรวมภาษีและค่าธรรมเนียม

คุณระบุได้ทั้ง AmountBeforeTax และ AmountAfterTax หากไม่ได้ระบุ AmountBeforeTax คุณต้องระบุ AmountAfterTax หากระบุ AmountBeforeTax และไม่ได้ระบุ AmountAfterTax คุณต้องระบุภาษีและค่าธรรมเนียมในข้อความ <TaxFeeInfo>

หากใช้โปรโมชัน ส่วนลดจะมีผลกับ AmountBeforeTax และเปอร์เซ็นต์ส่วนลดจะมีผลกับ AmountAfterTax ด้วยเช่นกัน เนื่องจากวิธีนี้ไม่ได้ผลกับโครงสร้างภาษีบางประเภท เราจึงขอแนะนำอย่างยิ่งให้ระบุเฉพาะ AmountBeforeTax ที่นี่และใช้ <TaxFeeInfo> เพื่อระบุภาษีและค่าธรรมเนียมเท่านั้น
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax 0..1 float ราคารายวันของห้องพักหลังรวมภาษีและค่าธรรมเนียมที่เกี่ยวข้อง หากระบุ AmountAfterTax แล้ว ไม่จำเป็นต้องส่งข้อความ <TaxFeeInfo> ต่อที่พักแยกต่างหาก แอตทริบิวต์นี้ใช้ร่วมกับ AmountBeforeTax ได้เพื่อระบุทั้งราคาฐานและราคารวมที่แสดงต่อผู้ใช้ในบางภูมิภาคได้

คำเตือน: หากใช้โปรโมชัน เราไม่แนะนำอย่างยิ่งให้ใช้จำนวนเงิน AmountAfterTax หากต้องการใช้ส่วนลด ให้ระบุภาษีและค่าธรรมเนียมโดยใช้ข้อความ <TaxFeeInfo> ระบบจะนำส่วนลดของคุณไปใช้กับจำนวนเงิน AmountBeforeTax

หมายเหตุ: ต้องระบุ AmountAfterTax หากไม่ได้ระบุ AmountBeforeTax
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @CurrencyCode 1 enum รหัสอักขระที่เป็นตัวอักษร 3 หลักในรูปแบบ ISO 4217 สำหรับหน่วยเงินตราที่เจาะจง

โปรดดูรายการสกุลเงินที่รองรับ
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @NumberOfGuests 0..1 integer จำนวนแขกสูงสุดที่ราคานี้รองรับได้ ค่าเริ่มต้นจะเป็น 2 คน หากไม่ได้ระบุไว้

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

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts 0..1 AdditionalGuestAmounts คอนเทนเนอร์สำหรับคอลเล็กชันของค่าใช้จ่ายสำหรับแขกเพิ่มเติม

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

จำนวนเงินสำหรับแขกเพิ่มเติมมีดังนี้
  • โดยจะมีผลเพิ่มเติมจากอัตราการเข้าพักฐาน อัตราการเข้าพักฐานคืออัตราการเข้าพักสูงสุดที่ระบุไว้ใน <BaseByGuestAmts> ซึ่งน้อยกว่าหรือเท่ากับจํานวนผู้ใหญ่ในการค้นหาของผู้ใช้
  • โดยจะมีผลตราบใดที่อัตราการเข้าพักในการค้นหาของผู้ใช้อยู่ภายในความจุของห้อง
  • <AdditionalGuestAmounts> จะแทนที่จำนวนเงินเพิ่มเติมที่ระบุไว้ก่อนหน้านี้ด้วยจำนวนเงินใหม่เสมอเมื่อ NotifType เป็น Delta หรือ Overlay
  • ระบบจะส่ง <AdditionalGuestAmounts> แยกจากราคาฐานได้ก็ต่อเมื่อ NotifType เป็น Delta เท่านั้น และต้องระบุ <BaseByGuestAmts> เมื่อ NotifType เป็น Overlay
  • องค์ประกอบ <AdditionalGuestAmounts> ที่ว่างเปล่าซึ่งตั้งค่า NotifType เป็น Delta จะนําจำนวนเงินเพิ่มเติมที่มีอยู่ออกโดยไม่ส่งผลต่อราคาฐาน
  • โดยระบบจะใช้สกุลเงินที่ระบุใน <BaseByGuestAmt>

ตัวอย่างเช่น สมมติว่าระบุราคาฐานสำหรับผู้ใหญ่ 1 และ 2 คน

  • หากผู้ใช้ค้นหาราคาสำหรับผู้ใหญ่ 3 คน ระบบจะเลือกราคาสำหรับอัตราการเข้าพัก 2 คนเป็นราคาฐาน และบวกราคาสำหรับผู้ใหญ่ 1 คนเพิ่มเข้าไป
  • หากผู้ใช้ค้นหาราคาสำหรับผู้ใหญ่ 1 คนและเด็ก 2 คน ระบบจะเลือกอัตราการเข้าพักสำหรับผู้ใหญ่ 1 คนเป็นราคาฐาน และบวกราคาเพิ่มเติมสำหรับเด็ก 2 คน
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount 0..n AdditionalGuestAmount ระบุราคาตามประเภทของแขก ซึ่งระบุผ่าน AgeQualifyingCode และอายุของแขก (หากมี) ซึ่งระบุผ่าน MaxAge
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @AgeQualifyingCode 1 enum กำหนดประเภทของแขกเพิ่มเติม ไม่ว่าจะเป็นผู้ใหญ่หรือเด็ก ตัวเลือกที่ใช้ได้มีดังนี้
  • 10: ผู้ใหญ่
  • 8: บุตรหลาน

AgeQualifyingCode สามารถตั้งค่าเป็น 10 สำหรับองค์ประกอบ AdditionalGuestAmount ได้สูงสุด 1 รายการ

ต้องระบุ MaxAge เมื่อ AgeQualifyingCode เป็น 8
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge 0..1 integer ต้องระบุ MaxAge เมื่อ AgeQualifyingCode เป็น 8 แต่ไม่ต้องระบุเมื่อ AgeQualifyingCode เป็น 10

MaxAge ควรเป็นจำนวนเต็มระหว่าง 0 ถึง 17.

การระบุค่า 0 จะปิดใช้ผู้โดยสารที่เป็นเด็ก

ระบบจะถือว่าค่าที่มากกว่า 17 เป็นค่าสูงสุดที่ยอมรับซึ่งเท่ากับ 17

คุณระบุช่วงอายุของเด็กได้หลายช่วงผ่านองค์ประกอบ AdditionalGuestAmount แยกต่างหาก ช่วงอายุต้องต่อเนื่องและไม่ทับซ้อนกัน
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount 1 float จำนวนเงินก่อนรวมภาษีและค่าธรรมเนียมที่เพิ่มเข้าไปในราคาฐานสำหรับแขกแต่ละคนที่มาเพิ่ม

คุณต้องระบุภาษีและค่าธรรมเนียมที่ขึ้นอยู่กับอายุของผู้เข้าพักผ่านองค์ประกอบ <AgeBrackets> ในข้อความ <TaxFeeInfo>

ตัวอย่าง

ส่วนนี้จะแสดงตัวอย่างโค้ดที่ไฮไลต์วิธีการดังนี้

เมื่อคุณตั้งค่า add, overlay หรือ remove ช่วงวันที่อาจเป็นค่าเดียวกันหรือต่างกันก็ได้ ทั้งนี้ขึ้นอยู่กับเป้าหมายของคุณ เช่น คุณสามารถใช้ overlay เพื่อตั้งค่าช่วงวันหยุดเพียง 2-3 สัปดาห์ในเดือนธันวาคมแทนการตั้งค่าช่วงวันที่ทั้งหมดสำหรับข้อความ "เพิ่มราคา" ซึ่งจะใช้แทนอัตราการเข้าพักสำหรับระยะเวลานี้เท่านั้น

ราคาต่อวัน

ห้องพักและแพ็กเกจราคาหนึ่งๆ จะมีอัตราการเข้าพักได้สูงสุด 50 รายการต่อพร็อพเพอร์ตี้ หากราคาสำหรับอัตราการเข้าพักทั้งหมดเท่ากัน คุณก็ควรส่งอัตราการเข้าพักสูงสุดพร้อมราคาที่กำหนด การทำเช่นนี้ทำให้ Google อนุมานว่าอัตราการเข้าพักที่ต่ำกว่าจะได้รับราคาฐานเดียวกันด้วย

กำหนดราคาฐานและราคารวม

ตัวอย่างที่ 1

ราคาฐาน (ไม่รวมภาษีหรือค่าธรรมเนียม) สําหรับอัตราการเข้าพักเริ่มต้น (ห้องพักแบบคู่) ในโมเดลนี้ คุณต้องกำหนดภาษีและค่าธรรมเนียมสำหรับที่พักโดยใช้ข้อความ <TaxFeeInfo> ราคาฐานจะปรากฏให้เห็นชัดมากขึ้นสำหรับผู้ใช้ที่ค้นหาจากบางภูมิภาค

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

ตัวอย่างที่ 2

ราคาฐานและราคารวมสำหรับอัตราการเข้าพักเริ่มต้น (ห้องพักแบบคู่) ในโมเดลนี้ คุณไม่ควรกําหนดภาษีและค่าธรรมเนียมแยกกันโดยใช้ข้อความ <TaxFeeInfo> ราคาฐานจะปรากฏให้เห็นชัดมากขึ้นสำหรับผู้ใช้ที่ค้นหาจากบางภูมิภาค

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

ตัวอย่างที่ 3

ราคารวม (รวมภาษีและค่าธรรมเนียม) สําหรับอัตราการเข้าพักหลายรายการ ในโมเดลนี้ คุณไม่ควรกําหนดภาษีและค่าธรรมเนียมแยกกันโดยใช้ข้อความ <TaxFeeInfo>

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountAfterTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountAfterTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

ตัวอย่าง 4

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-01"
                                End="2020-05-31"
                                InvTypeCode="RoomID_2"
                                RatePlanCode="PackageID_2"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            AmountAfterTax="220.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
เพิ่ม วางซ้อน และนำราคาออก

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

เพิ่มราคา

กำหนด NotifType เป็น Delta เพื่อเพิ่มราคาต่ออัตราการเข้าพักสำหรับ RoomID_1 และ PackageID_1 ระหว่าง 2021-10-20 ถึง 2021-12-31 โปรดทราบว่า Google รองรับข้อมูลย้อนหลังได้สูงสุด 3 ปี

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountBeforeTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

วางซ้อนราคา

กำหนด NotifType เป็น Overlay เพื่อลบราคาต่ออัตราการเข้าพักทั้งหมดสำหรับ RoomID_1 และ PackageID_1 ระหว่าง 2021-10-20 ถึง 2021-12-31 และแทนที่ด้วยราคาต่ออัตราการเข้าพักที่ระบุใหม่

เช่น หากส่งข้อความนี้หลังจากข้อความ "เพิ่มราคา" ระบบจะลบราคาที่ 1, 2 และ 3 ของอัตราการเข้าพัก และจะจัดเก็บเฉพาะราคาที่ 1 ของอัตราการเข้าพักใหม่เท่านั้น นอกจากนี้ คุณยังตั้งค่าช่วงวันที่ให้สั้นลงได้ (เช่น 2021-12-20 และ 2021-12-31) เพื่อแทนที่อัตราการเข้าพักบางส่วนในบางวันที่เจาะจง เช่น วันหยุด 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

นําราคาออก

กำหนด NotifType เป็น Remove เพื่อลบราคาต่ออัตราการเข้าพักทั้งหมดสำหรับ RoomID_1 และ PackageID_1 ระหว่าง 2021-10-20 ถึง 2021-12-31

เช่น หากส่งข้อความนี้หลังจากข้อความตัวอย่างอื่นๆ ระบบจะไม่จัดเก็บราคาต่ออัตราการเข้าพัก

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
เพิ่ม วางซ้อน และนำจำนวนเงินเพิ่มเติมสำหรับแขกออก

เพิ่มจำนวน

กำหนด NotifType เป็น Delta เพื่อเพิ่มราคาฐานสำหรับอัตราการเข้าพัก 1 และ 2 และจำนวนผู้เข้าพักเพิ่มเติมสำหรับ RoomID_1 และ PackageID_1 ระหว่าง 2021-10-20 ถึง 2021-12-31

ระบบจะเพิ่มค่าบริการสำหรับผู้เข้าพักเพิ่มเติมจากราคาฐาน ซึ่งจะกำหนดตามอัตราการเข้าพักในการค้นหาของผู้ใช้ จำนวนผู้เข้าพักที่ผู้ใช้ระบุต้องไม่เกินความจุของ RoomID_1

ในตัวอย่างนี้ ระบบจะใช้จำนวนเงินเพิ่มเติมสำหรับผู้มาเยือนดังนี้

  • 50 บาทสำหรับเด็กอายุ 0-10 ปี (รวม)
  • $10 สำหรับเด็กอายุ 11-17 ปี
  • $20 สำหรับผู้ใหญ่
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="5.00" AgeQualifyingCode="8" MaxAge="10" />
            <AdditionalGuestAmount Amount="10.00" AgeQualifyingCode="8" MaxAge="17" />
            <AdditionalGuestAmount Amount="20.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

จำนวนเงินที่วางซ้อน

กำหนด NotifType เป็น Overlay เพื่อลบราคาต่ออัตราการเข้าพักทั้งหมดและค่าบริการเพิ่มเติมทั้งหมดสำหรับผู้เข้าพักสำหรับ RoomID_1 และ PackageID_1 ระหว่าง 2021-10-20 ถึง 2021-12-31 และแทนที่ด้วยราคาต่ออัตราการเข้าพักและค่าบริการเพิ่มเติมที่ระบุใหม่

เช่น หากส่งข้อความนี้หลังจากข้อความ "เพิ่มราคา" ระบบจะลบราคาอัตราการเข้าพักฐานที่ 1 และ 2 และจะจัดเก็บเฉพาะราคาอัตราการเข้าพักฐานที่ 1 ใหม่เท่านั้น ระบบจะลบจำนวนเงินค่าบริการเพิ่มเติมสำหรับแขกชุดก่อนหน้า และจะจัดเก็บเฉพาะจำนวนเงินชุดใหม่เท่านั้น ตอนนี้จำนวนผู้เข้าพักที่เพิ่มขึ้นจะใช้ราคาอัตราการเข้าพัก 1 คนใหม่เป็นราคาฐาน โปรดทราบว่าหลังจากการอัปเดตนี้ จะไม่มีการกำหนดค่าใช้จ่ายเพิ่มเติมสำหรับเด็ก 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="30.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

นำจำนวนเงินออก

กำหนด NotifType เป็น Delete เพื่อลบราคาฐานต่ออัตราการเข้าพักทั้งหมด และราคาเพิ่มเติมทั้งหมดสำหรับผู้เข้าพักสำหรับ RoomID_1 และ PackageID_1 ระหว่าง 2021-10-20 ถึง 2021-12-31

เช่น หากส่งข้อความนี้หลังจากข้อความตัวอย่างอื่นๆ ระบบจะไม่จัดเก็บราคาฐานต่ออัตราการเข้าพักหรือจำนวนผู้เข้าพักเพิ่มเติม

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

นำเฉพาะจำนวนผู้เข้าร่วมที่เกินมาออก

กำหนด NotifType เป็น Delta โดยมีองค์ประกอบ <AdditionalGuestAmounts> ว่างเปล่าเพื่อลบค่าเพิ่มเติมสำหรับแขกทั้งหมดสำหรับ RoomID_1 และ PackageID_1 โดยไม่ส่งผลต่อราคาฐานระหว่าง 2021-10-20 ถึง 2021-12-31

เช่น หากส่งข้อความนี้หลังจากข้อความตัวอย่างอื่นๆ ระบบจะจัดเก็บเฉพาะจำนวนฐานเท่านั้น

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <AdditionalGuestAmounts/>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

ราคาตาม LOS

กำหนดราคาตาม LOS

ตัวอย่างที่ 1

กำหนดราคาสำหรับการเข้าพัก 1, 2 และ 3 คืนตั้งแต่วันที่ 18-05-2020 ราคารวมสำหรับการเข้าพัก 1, 2 และ 3 คืนในตัวอย่างนี้จะเป็น $100, $180 และ $240 ตามลำดับ

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="1" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="2" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="90.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
เพิ่ม วางซ้อน และนำราคาตาม LOS ออก

เพิ่มระยะเวลาในการเข้าพัก

เมื่อใช้การกำหนดราคาตาม LOS การดำเนินการ Delta จะช่วยให้อัปเดตราคาได้อย่างต่อเนื่องสำหรับช่วงวันที่เช็คอินที่ระบุใน <StatusApplicationControl> และสำหรับระยะเวลาในการเข้าพักทั้งหมดที่ระบุโดย UnitMultiplier ขององค์ประกอบ Rate ย่อยแต่ละรายการ

คุณต้องระบุราคาอัตราการเข้าพักทั้งหมดสำหรับวันที่เช็คอินและระยะเวลาในการเข้าพักที่เกี่ยวข้องแต่ละรายการ

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

วางซ้อนระยะเวลาในการเข้าพัก

เมื่อใช้การกำหนดราคาตาม LOS การดำเนินการ Overlay จะแทนที่ราคาสำหรับระยะเวลาในการเข้าพักทั้งหมดของผลิตภัณฑ์และช่วงวันที่เช็คอินที่ระบุใน <StatusApplicationControl>

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

นำระยะเวลาในการเข้าพักออก

เมื่อใช้การกำหนดราคาตาม LOS การดำเนินการ Remove จะนําราคาสำหรับระยะเวลาในการเข้าพักทั้งหมดของผลิตภัณฑ์และช่วงวันที่เช็คอินที่ระบุใน <StatusApplicationControl> ออก

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

การตอบกลับ

ไวยากรณ์

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

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS 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_HotelRateAmountNotifRS>

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

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

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

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

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

ตัวอย่าง

สำเร็จ

การตอบกลับข้อความ OTA_HotelRateAmountNotifRQ ที่ประมวลผลเรียบร้อยแล้วมีดังนี้

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelRateAmountNotifRS>

ข้อผิดพลาด

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

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