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_account_name"/>
    </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"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="float"
                            AmountAfterTax="float"
                            CurrencyCode="currency"
                            NumberOfGuests="integer"/>
          </BaseByGuestAmts>
        </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, _ (ขีดล่าง) และ - (ขีดกลาง)
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 เท่ากัน การอัปเดตจะมีผลในวันที่ดังกล่าว
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 / Rates 0..1 Rates คอนเทนเนอร์สําหรับคอลเล็กชันขององค์ประกอบ <Rate> ไม่ต้องระบุองค์ประกอบนี้หาก NotifType เป็น "Remove" หากไม่เป็นเช่นนั้น คุณต้องระบุองค์ประกอบนี้เพียงครั้งเดียว
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate 1 ราคา คอนเทนเนอร์สำหรับคอลเล็กชันขององค์ประกอบ <BaseByGuestAmts>
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseGuestAmts 1 BaseByGuestAmts คอนเทนเนอร์สำหรับคอลเล็กชันของค่าใช้จ่ายพื้นฐาน
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseGuestAmts / BaseByGuestAmt 1..n BaseByGuestAmt ระบุราคาห้องพักในสกุลเงินที่ระบุไว้ ระบบกำหนดราคาตามอัตราการเข้าพักได้ด้วยการใช้องค์ประกอบ <BaseByGuestAmt> หลายรายการ โดยแต่ละรายการจะมีค่า NumberOfGuests ต่างกัน หากไม่เป็นเช่นนั้น ราคาจะเป็นไปตามจำนวนผู้เข้าพักสูงสุดที่กำหนดโดย NumberOfGuests
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseGuestAmts / BaseByGuestAmt / @AmountBeforeTax 0..1 Float

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

หากใช้โปรโมชัน ส่วนลดจะมีผลกับ AmountBeforeTax และเปอร์เซ็นต์ส่วนลดจะมีผลกับ AmountAfterTax ด้วยเช่นกัน เนื่องจากวิธีนี้ไม่ได้ผลกับโครงสร้างภาษีบางประเภท เราจึงขอแนะนำอย่างยิ่งให้ระบุเฉพาะ AmountBeforeTax ที่นี่และใช้ TaxFeeInfo ในการระบุภาษีและค่าธรรมเนียมเท่านั้น

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

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

หมายเหตุ: ต้องระบุ AmountAfterTax หากไม่ได้ระบุ AmountBeforeTax

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseGuestAmts / BaseByGuestAmt / @CurrencyCode 1 Enum รหัสอักขระที่เป็นตัวอักษร 3 หลักในรูปแบบ ISO 4217 สำหรับหน่วยเงินตราที่เจาะจง
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseGuestAmts / BaseByGuestAmt / @NumberOfGuests 0..1 Integer จำนวนแขกสูงสุดที่กำหนดไว้สำหรับห้องพัก ค่าเริ่มต้นจะเป็น 2 หากไม่ได้ระบุไว้

ตัวอย่าง

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

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

ตัวอย่าง 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 ระหว่าง 2020-05-18 ถึง 2020-05-23

<?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-23"
                                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 ระหว่าง 2020-05-18 ถึง 2020-05-23 และแทนที่ด้วยราคาต่ออัตราการเข้าพักที่ระบุใหม่

เช่น หากส่งข้อความนี้หลังจากข้อความ "เพิ่มราคา" ระบบจะลบราคาที่ 1, 2 และ 3 ของอัตราการเข้าพัก และจะจัดเก็บเฉพาะราคาที่ 1 ของอัตราการเข้าพักใหม่เท่านั้น

<?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-23"
                                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 เป็น Delete เพื่อลบราคาต่ออัตราการเข้าพักทั้งหมดสำหรับ RoomID_1 และ PackageID_1 ระหว่าง 2020-05-18 ถึง 2020-05-23

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

<?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="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </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 ความสำเร็จ บ่งบอกว่าข้อความ OTA_HotelRateAmountNotifRQ ได้รับการประมวลผลเรียบร้อยแล้ว

แต่ละข้อความจะมี <Success> หรือ <Errors> ปรากฏอยู่

OTA_HotelRateAmountNotifRS / Errors 0..1 Error คอนเทนเนอร์สำหรับปัญหาอย่างน้อย 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="2020-05-13T20: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="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelRateAmountNotifRS>