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 บัญชีพาร์ทเนอร์สำหรับข้อความนี้ ค่าสตริงนี้คือค่า "Partner key" ซึ่งแสดงอยู่ใน หน้าการตั้งค่าบัญชีใน 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 มิเช่นนั้นไม่ควรระบุทั้ง 2 อย่าง
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer จำนวน RateTimeUnits ซึ่งระบุระยะเวลาในการเข้าพักสำหรับราคานี้

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

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

หากต้องการใช้การกำหนดราคาตาม LOS คุณต้องระบุ RateTimeUnit และ UnitMultiplier มิเช่นนั้นไม่ควรระบุทั้ง 2 อย่าง
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 รหัสอักขระที่เป็นตัวอักษรและตัวเลขคละกันแบบ ISO 4217 (3) สำหรับหน่วยเงินตราที่เจาะจง

โปรดดูรายการสกุลเงินที่รองรับ
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 เป็นแบบเดลต้าหรือแบบซ้อนทับ
  • อาจมีการส่ง <AdditionalGuestAmounts> อย่างอิสระจากราคาฐานเฉพาะเมื่อ NotifType เป็นเดลต้า คุณต้องระบุ <BaseByGuestAmts> เมื่อ NotifType คือ Overlay
  • องค์ประกอบ <AdditionalGuestAmounts> ที่ว่างเปล่าที่มีการตั้งค่า NotifType เป็น Delta จะนำจำนวนเงินเพิ่มเติมที่มีอยู่ออกโดยไม่ส่งผลต่อราคาฐาน
  • โดยจะใช้สกุลเงินที่ระบุไว้ใน <BaseByGuestAmt>

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

  • หากผู้ใช้ค้นหาผู้ใหญ่ 3 คน ระบบจะเลือกอัตราการเข้าพัก 2 คนเป็นราคาฐาน และจะนำจำนวนแขกเพิ่มเติมสำหรับผู้ใหญ่ 1 คนเพิ่มลงไปด้วย
  • หากผู้ใช้ค้นหาผู้ใหญ่ 1 คนและเด็ก 2 คน ระบบจะเลือกอัตราการเข้าพักคนเดียวเป็นราคาฐาน และจะเพิ่มจำนวนเงินเพิ่มเติมสำหรับเด็ก 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 หากเป็น 10 ต้องไม่ระบุ AgeQualifyingCode

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

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

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

ตัวอย่าง

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

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

การกำหนดราคาตามวัน

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

ตัวอย่างที่ 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>
เพิ่ม วางซ้อน และนำราคาออก

เพิ่มราคา

กำหนด NotifType เป็น Delta เพื่อเพิ่มราคาต่ออัตราการเข้าพักสำหรับ RoomID_1 และ PackageID_1 ระหว่าง 20-10-2021 ถึง 31-12-2021 โปรดทราบว่า 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 ระหว่างวันที่ 20-10-2021 ถึง 31-12-2021 และแทนที่ด้วยราคาต่ออัตราการเข้าพักที่ระบุใหม่

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

<?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 ระหว่าง 20-10-2021 ถึง 31-12-2021

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

<?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 ระหว่าง 20-10-2021 ถึง 31-12-2021

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

ในตัวอย่างนี้ จำนวนแขกเพิ่มเติมจะนำมาใช้ดังนี้

  • $5 สำหรับเด็กในช่วงอายุ 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 ระหว่างวันที่ 31-10-2021 ถึง 31-12-2021 และแทนที่ด้วยราคาต่ออัตราการเข้าพักที่ระบุใหม่และจำนวนเพิ่มเติม

เช่น หากส่งข้อความนี้หลังข้อความ "เพิ่มราคา" ระบบจะลบราคาฐาน 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 ระหว่าง 20-10-2021 ถึง 31-12-2021

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

<?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 โดยไม่ส่งผลต่อราคาฐานระหว่างวันที่ 20-10-2021 ถึง 31-12-2021

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

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

ตัวอย่าง

Success

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