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

การเปลี่ยนแปลงอัตรา

ภาพรวม

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

คำขอ

ไวยากรณ์

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

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="partner_key"
                      id="message_ID"
                      timestamp="timestamp">
  <HotelRateModifications hotel_id="HotelID" action="[overlay]">
    <ItineraryRateModification id="ModificationID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </BookingDates>
      <BookingWindow min="integer" max="integer"/>
      <CheckinDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </CheckinDates>
      <CheckoutDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </CheckoutDates>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <LengthOfStay min="integer" max="integer"/>
      <MinimumAmount before_discount="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <StayDates application="[all|any]">
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </StayDates>
      <UserCountries type="[include|exclude]">
        <Country code="country_code"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="float"/>
        <RateRule id="RateRuleID"/>
        <Refundable available="[false|true]"
                       refundable_until_days="number_of_days"
                       refundable_until_time="time"/>
        <Availability status="[unavailable]"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

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

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

องค์ประกอบ / @แอตทริบิวต์	จำนวนข้อผิดพลาด	ประเภท	คำอธิบาย
RateModifications	1	Complex element	องค์ประกอบรูทของข้อความการปรับราคา
RateModifications / @partner	1	string	บัญชีพาร์ทเนอร์สำหรับข้อความนี้ ค่าสตริงนี้คือค่า "Partner key" ซึ่งแสดงใน หน้าการตั้งค่าบัญชีใน Hotel Center หมายเหตุ: หากคุณมีแบ็กเอนด์ที่มีฟีดสำหรับหลายบัญชี ค่านี้จะต้องตรงกับค่าแอตทริบิวต์ `ID` ที่ระบุในองค์ประกอบ `<RequestorID>` ของข้อความ `<OTA_HotelRateAmountNotifRQ>` และ `<OTA_HotelAvailNotifRQ>` สำหรับบัญชีเดียวกัน
RateModifications / @id	1	string	ตัวระบุที่ไม่ซ้ำกันสำหรับข้อความคำขอนี้ ค่านี้จะแสดงในข้อความตอบกลับ อักขระที่อนุญาตคือ a-z, A-Z, 0-9, _ (ขีดล่าง) และ - (ขีดกลาง)
RateModifications / @timestamp	1	DateTime	วันที่และเวลาที่สร้างข้อความนี้
RateModifications / HotelRateModifications	0..n	HotelRateModifications	การปรับราคาที่พัก การปรับราคาแต่ละครั้งจะมีผลกับที่พักเดียว หมายเหตุ: หากการปรับราคาหลายรายการใช้กับราคาเดียวกันได้ การแก้ไขทั้งหมดจะมีผล ไม่มีการรับประกันคำสั่งซื้อที่เจาะจง
RateModifications / HotelRateModifications / @hotel_id	1	string	ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ `<id>` ในองค์ประกอบ `<listing>` ในฟีดข้อมูลโรงแรม นอกจากนี้ รหัสโรงแรมยังอยู่ใน Hotel Center ด้วย
RateModifications / HotelRateModifications / @action	0..1	enum	หากไม่ได้ระบุ `action` ระบบจะเพิ่มหรืออัปเดตการแก้ไขภายในองค์ประกอบนี้สำหรับโรงแรมนี้ หากระบุ `action="overlay"` ระบบจะลบการแก้ไขที่กำหนดไว้ก่อนหน้านี้ทั้งหมดของโรงแรมนี้ก่อน จากนั้นระบบจะเขียนการแก้ไขที่ระบุไว้ที่นี่ หากใช้ `action="overlay"` และไม่ได้ระบุการแก้ไขภายในองค์ประกอบนี้ ระบบจะลบการแก้ไขทั้งหมดของโรงแรมนี้
RateModifications / HotelRateModifications / ItineraryRateModification	0..200	ItineraryRateModification	การแก้ไขราคาครั้งเดียวสำหรับที่พัก หมายเหตุ: การแก้ไขอัตราจะแก้ไขข้อบกพร่องได้ยากและเราขอแนะนําให้ใช้เท่าที่จำเป็น โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM) สำหรับกรณีการใช้งานที่จำเป็นต้องปรับเปลี่ยนอัตรามากกว่า 200 ครั้ง
RateModifications / HotelRateModifications / ItineraryRateModification / @id	1	string	ตัวระบุที่ไม่ซ้ำกันสำหรับการปรับราคา จำนวนอักขระสูงสุดที่อนุญาตคือ 40 ตัว อักขระที่อนุญาตคือ a-z, A-Z, 0-9, _ (ขีดล่าง), - (ขีดคั่น) และ (มหัพภาค)
RateModifications / HotelRateModifications / ItineraryRateModification / @action	0..1	enum	หากไม่ได้ระบุ และระบบไม่ได้จัดเก็บการแก้ไขราคาที่มี `id` เดียวกัน ระบบจะจัดเก็บการแก้ไขราคานี้ไว้ หากไม่ระบุไว้และจัดเก็บการแก้ไขราคาด้วย `id` เดียวกัน ระบบจะอัปเดตการแก้ไขราคาที่มีอยู่ หากระบุ ค่าต้องเป็น `"delete"` หากระบุ `"delete"` ระบบจะลบการแก้ไขราคาที่จัดเก็บไว้ด้วย `id` เดียวกัน เมื่อใช้ `"delete"` อย่าใส่องค์ประกอบย่อยใน `<ItineraryRateModification>` นอกจากนั้น ยังไม่อนุญาตให้ใช้ `"delete"` ร่วมกับ `<HotelRateModifications action="overlay"/>`
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates	0..1	BookingDates	คอนเทนเนอร์สำหรับช่วงวันที่อย่างน้อย 1 ช่วงซึ่งกำหนดเมื่อต้องมีการจองเพื่อให้การปรับราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange	1..99	DateRange	ช่วงวันที่ที่ระบุเมื่อต้องมีการจองเพื่อให้การปรับราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @start	0..1	Date	วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่ก่อนหน้าหรือวันที่เดียวกับ `end` หากไม่มีการระบุ `start` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่เริ่มต้น
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @end	0..1	Date	วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่เดียวกับหรือหลังจาก `start` หากไม่มีการระบุ `end` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่สิ้นสุด
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @days_of_week	0..1	string	วันของสัปดาห์ที่อนุญาตในช่วงวันที่ หากไม่ได้ระบุ ระบบจะอนุญาตให้ใช้ทุกวันในช่วงวันที่ อักขระแต่ละตัวในสตริงจะระบุวัน เช่น "MTWHF" เป็นการระบุว่าระบบอนุญาตให้ใช้วันธรรมดาในช่วงวันที่ อักขระที่ใช้ได้มีดังนี้ `M` สำหรับวันจันทร์ `T` สำหรับวันอังคาร `W` สำหรับวันพุธ `H` สำหรับวันพฤหัสบดี `F` สำหรับวันศุกร์ `S` สำหรับวันเสาร์ `U` สำหรับวันอาทิตย์ ชุดค่าผสมของอักขระแบบใดก็ได้สามารถใช้ได้
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow	0..1	BookingWindow	ระบุระยะเวลาที่การจองต้องสัมพันธ์กับวันที่เช็คอิน (ตามเขตเวลาของที่พัก) เช่น อาจตั้งค่าระยะเวลาการจองเป็น 7 วันเป็นอย่างน้อย แต่ไม่เกิน 180 วันก่อนเช็คอิน
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @min	0..1	integer	จำนวนวันขั้นต่ำก่อนเช็คอินเมื่อทำการจองเพื่อให้การปรับราคามีผล หากไม่ได้ระบุ จะถือว่าไม่มีจำนวนขั้นต่ำ
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @max	0..1	integer	จำนวนวันสูงสุดก่อนเช็คอินเมื่อทำการจองเพื่อให้การปรับราคามีผล หากไม่ได้ระบุ จะถือว่าไม่มีจำนวนสูงสุด
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates	0..1	CheckinDates	คอนเทนเนอร์สำหรับช่วงวันที่อย่างน้อย 1 ช่วงซึ่งกำหนดเมื่อต้องเลือกวันเช็คอินเพื่อให้การปรับราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange	1..99	DateRange	ช่วงวันที่ที่ระบุเมื่อต้องเลือกวันเช็คอินเพื่อให้การปรับราคามีผล คุณไม่จำเป็นต้องมีองค์ประกอบนี้หากจะลบการปรับราคาอย่างน้อย 1 รายการ
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @start	0..1	Date	วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่ก่อนหน้าหรือวันที่เดียวกับ `end` หากไม่มีการระบุ `start` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่เริ่มต้น
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @end	0..1	Date	วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่เดียวกับหรือหลังจาก `start` หากไม่มีการระบุ `end` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่สิ้นสุด
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @days_of_week	0..1	string	วันของสัปดาห์ที่อนุญาตในช่วงวันที่ หากไม่ได้ระบุ ระบบจะอนุญาตให้ใช้ทุกวันในช่วงวันที่ อักขระแต่ละตัวในสตริงจะระบุวัน เช่น "MTWHF" เป็นการระบุว่าระบบอนุญาตให้ใช้วันธรรมดาในช่วงวันที่ อักขระที่ใช้ได้มีดังนี้ `M` สำหรับวันจันทร์ `T` สำหรับวันอังคาร `W` สำหรับวันพุธ `H` สำหรับวันพฤหัสบดี `F` สำหรับวันศุกร์ `S` สำหรับวันเสาร์ `U` สำหรับวันอาทิตย์ ชุดค่าผสมของอักขระแบบใดก็ได้สามารถใช้ได้
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates	0..1	CheckoutDates	คอนเทนเนอร์สำหรับช่วงวันที่อย่างน้อย 1 ช่วงซึ่งกำหนดเมื่อต้องเช็คเอาต์เพื่อให้การปรับราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange	1..99	DateRange	ช่วงวันที่ที่ระบุเมื่อต้องเช็คเอาต์เพื่อให้การปรับราคามีผล คุณไม่จำเป็นต้องมีองค์ประกอบนี้หากจะลบการปรับราคาอย่างน้อย 1 รายการ
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @start	0..1	Date	วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่ก่อนหน้าหรือวันที่เดียวกับ `end` หากไม่มีการระบุ `start` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่เริ่มต้น
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @end	0..1	Date	วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่เดียวกับหรือหลังจาก `start` หากไม่มีการระบุ `end` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่สิ้นสุด
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @days_of_week	0..1	string	วันของสัปดาห์ที่อนุญาตในช่วงวันที่ หากไม่ได้ระบุ ระบบจะอนุญาตให้ใช้ทุกวันในช่วงวันที่ อักขระแต่ละตัวในสตริงจะระบุวัน เช่น "MTWHF" เป็นการระบุว่าระบบอนุญาตให้ใช้วันธรรมดาในช่วงวันที่ อักขระที่ใช้ได้มีดังนี้ `M` สำหรับวันจันทร์ `T` สำหรับวันอังคาร `W` สำหรับวันพุธ `H` สำหรับวันพฤหัสบดี `F` สำหรับวันศุกร์ `S` สำหรับวันเสาร์ `U` สำหรับวันอาทิตย์ ชุดค่าผสมของอักขระแบบใดก็ได้สามารถใช้ได้
RateModifications / HotelRateModifications / ItineraryRateModification / Devices	0..1	Devices	คอนเทนเนอร์สำหรับแสดงอุปกรณ์ของผู้ใช้ที่มีสิทธิ์แก้ไขราคา หากระบุไว้ ระบบจะใช้การปรับราคาต่อเมื่อผู้ใช้ตรงกับอุปกรณ์ในรายการเครื่องใดเครื่องหนึ่งเท่านั้น หากไม่ได้ระบุ การดําเนินการนี้จะไม่จำกัดการใช้การปรับราคา
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device	1..3	Device	กำหนดอุปกรณ์ของผู้ใช้ 1 ประเภทที่มีสิทธิ์แก้ไขราคา
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device / @type	1	enum	ประเภทอุปกรณ์ ค่าต้องเป็น `desktop`, `tablet` หรือ `mobile`
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions	1	ModificationActions	การดำเนินการที่ใช้กับราคาหากเป็นไปตามเงื่อนไขที่ระบุทั้งหมด
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment	0..1	PriceAdjustment	แก้ไขอัตราโดยการคูณทั้ง `AmountBeforeTax` และ `AmountAfterTax` ด้วยตัวคูณที่ระบุ
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment / @multiplier	1	float	ทั้ง `AmountBeforeTax` และ `AmountAfterTax` จะคูณด้วยค่านี้
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule	0..1	RateRule	แก้ไขอัตราโดยใช้รหัสกฎเกี่ยวกับอัตราที่ระบุไว้กับอัตราดังกล่าว
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule / @id	1	string	รหัสนี้จะจับคู่ราคากับคำจำกัดความในไฟล์คำจำกัดความกฎเกี่ยวกับอัตรา หมายเหตุ จำนวนอักขระสูงสุดสำหรับช่องนี้คือ 40 ตัว แต่ละอัตราจะเชื่อมโยงกับกฎเกี่ยวกับอัตราได้เพียง 1 ข้อเท่านั้น หากมีการแก้ไขที่ใช้รหัสกฎเกี่ยวกับอัตราหลายรายการ ระบบจะกำหนดรหัสกฎเกี่ยวกับอัตราที่เล็กที่สุดทางพจนานุกรมให้กับอัตราดังกล่าว หากรหัสนี้ไม่ตรงกับกฎเกี่ยวกับอัตราในไฟล์คำจำกัดความกฎเกี่ยวกับอัตรา ระบบจะถือว่ารหัสไม่มีสิทธิ์ ดูข้อมูลเกี่ยวกับตัวเลือก UI ของอัตราส่วนลดเฉพาะบุคคลแบบต่างๆ ได้ใน บทความนี้
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable	0..1	Refundable	เขียนทับการคืนเงินของราคาเป็นค่าที่ระบุ โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อตั้งค่าแอตทริบิวต์ การดำเนินการแก้ไขนี้จะเขียนการตั้งค่าแบบขอเงินคืนได้ของราคาที่เข้าเกณฑ์โดยสมบูรณ์ ไม่ใช่เพียงช่องการป้อนข้อมูลเท่านั้น หากไม่ได้ตั้งค่า `available` หรือ `refundable_until_days` ไว้ ระบบจะไม่แสดงราคาห้องพักเป็นขอเงินคืนได้ หาก `available` คือ `0` หรือ `false` ระบบจะละเว้นแอตทริบิวต์อื่นๆ ราคาห้องพักจะไม่แสดงเป็นขอเงินคืนได้แม้จะมีการตั้งค่าแอตทริบิวต์อื่นๆ อย่างน้อย 1 รายการหรือทั้ง 2 รายการก็ตาม ขอแนะนำให้ตั้งค่า `refundable_until_time` หากไม่ได้ตั้งค่า ระบบจะใช้เวลาแรกสุด (เที่ยงคืน)
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @available	1	boolean	(ต้องระบุ) ตั้งค่าเป็น `1` หรือ `true` เพื่อระบุว่าราคาห้องพักนี้ขอเงินคืนเต็มจำนวนได้หรือไม่ มิเช่นนั้นให้ตั้งค่าเป็น `0` หรือ `false`
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days	0..1	integer	(ต้องระบุหาก `available` คือ `true`) ระบุจำนวนวันก่อนเช็คอินที่จะขอเงินคืนเต็มจำนวนได้ ค่าของ `refundable_until_days` ต้องเป็นจำนวนเต็มตั้งแต่ 0 ถึง 330
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @refundable_until_time	0..1	Time	(แนะนำหาก `available` คือ `true`) ระบุเวลาสุดท้ายของวันตามเวลาท้องถิ่นของโรงแรมที่ขอเงินคืนเต็มจำนวนได้ ใช้ค่านี้ร่วมกับ `refundable_until_days` ได้ เช่น เพื่อระบุว่า "ขอเงินคืนได้จนถึง 16:00 น. ก่อนเช็คอิน 2 วัน" หากไม่ได้ตั้งค่า `refundable_until_time` ไว้ ค่าเริ่มต้นจะเป็นเที่ยงคืน
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability	0..1	Availability	เขียนทับห้องว่างของราคาเป็นค่าที่ระบุ เรารองรับการตั้งค่าอัตราเป็น `unavailable` เท่านั้น
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability / @status	1	enum	หากเป็น `status="unavailable"` ระบบจะพิจารณาราคาเสมือนว่าไม่พร้อมใช้งาน ไม่ว่าจะมีราคาที่ถูกต้องหรือไม่ก็ตาม
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay	0..1	LengthOfStay	กำหนดขีดจำกัดระยะเวลาในการเข้าพักที่การปรับราคานี้จะนำไปใช้ได้ ระบบจะไม่ปรับราคาหากระยะเวลาในการเข้าพักไม่อยู่ในขีดจำกัดขั้นต่ำและสูงสุด
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @min	0..1	integer	จำนวนคืนขั้นต่ำที่เข้าพักซึ่งอนุญาตให้ปรับราคาได้ หากไม่ได้ระบุ จะถือว่าไม่มีจำนวนขั้นต่ำ
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @max	0..1	integer	จำนวนคืนสูงสุดที่เข้าพักซึ่งอนุญาตให้แก้ไขราคาได้ หากไม่ได้ระบุ จะถือว่าไม่มีจำนวนสูงสุด
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount	0..1	MinimumAmount	ระบุผลรวมขั้นต่ำของราคาห้องพักรายวัน (โดยใช้ `AmountBeforeTax` หรือ `AmountAfterTax` ที่มากกว่า) ที่ต้องให้เกินราคาเพื่อให้การปรับราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount / @before_discount	1	integer	ค่าที่ต้องเกินขีดจำกัดเพื่อให้ใช้การปรับราคาได้
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans	0..1	RatePlans	คอนเทนเนอร์สำหรับรายการแพ็กเกจราคาที่จะใช้การปรับราคา หากไม่ได้ระบุ `<RatePlans>` การปรับราคาจะมีผลกับแพ็กเกจราคาทั้งหมด
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan	1..n	RatePlan	ระบุแพ็กเกจราคา แพ็กเกจราคากำหนดโดยชุดค่าผสมของแพ็กเกจ ราคา และจำนวนห้องว่างตามที่ระบุไว้ในข้อความ Transaction (Property Data), OTA_HotelRateAmountNotifRQ และ OTA_HotelAvailNotifRQ รวมถึงกำหนดโดย PackageID
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan / @id	1	string	ตัวระบุที่ไม่ซ้ำกันสำหรับแพ็กเกจราคา ค่านี้จะแมปกับค่า PackageID ใน `<PackageData>` ในข้อความ Transaction (Property Data) และในแอตทริบิวต์ `RatePlanCode` ใน `<StatusApplicationControl>` ทั้งข้อความ `<OTA_HotelRateAmountNotifRQ>` และ `<OTA_HotelAvailNotifRQ>` จำนวนอักขระสูงสุดที่อนุญาตคือ 50 ตัว
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes	0..1	RoomTypes	คอนเทนเนอร์สำหรับรายการประเภทห้องพักที่จะใช้การปรับราคา การปรับราคาจะมีผลกับ `<RoomType>` แต่ละรายการที่ระบุ หากไม่ได้ระบุ `<RoomTypes>` การปรับราคาจะมีผลกับห้องพักทั้งหมด
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType	1..n	RoomType	ระบุประเภทห้องพัก ประเภทห้องพักจะระบุอยู่ในองค์ประกอบ `<RoomData>` ของข้อความ Transaction (Property Data) และมีการอ้างอิงโดยใช้ค่า `<RoomID>` (นอกจากนี้ ค่า `<RoomID>` ยังอ้างอิงโดยแอตทริบิวต์ `InvTypeCode` ในข้อความ OTA_HotelRateAmountNotifRQ)
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id	1	string	ตัวระบุที่ไม่ซ้ำกันสำหรับห้องพัก (ประเภทห้องพัก) ค่านี้จะแมปกับ `<RoomID>` ในข้อความ Transaction (Property Data) จำนวนอักขระสูงสุดที่อนุญาตคือ 50 ตัว
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates	0..1	StayDates	คอนเทนเนอร์สำหรับช่วงวันที่อย่างน้อย 1 ช่วงซึ่งกำหนดวิธีใช้การปรับราคา เช่น เพื่อรองรับราคาตามฤดูกาล
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / @application	1	enum	อธิบายวิธีที่ควรใช้การปรับราคา ค่าที่ใช้ได้มีดังนี้ `all`: ใช้การปรับราคาสำหรับแต่ละคืนในแผนการเดินทาง หากวันที่ทั้งหมดในแผนการเดินทางซ้อนทับกับวันที่เข้าพัก `any`: ใช้การปรับราคากับทุกคืนในแผนการเดินทาง หากวันที่ในแผนการเดินทางซ้อนทับกับวันที่ในช่วงวันที่เข้าพัก คุณต้องระบุแอตทริบิวต์นี้เสมอ
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange	1..99	DateRange	ช่วงวันที่ที่ระบุวันที่ที่จะใช้การปรับราคา
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @start	0..1	Date	วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่ก่อนหน้าหรือวันที่เดียวกับ `end` หากไม่มีการระบุ `start` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่เริ่มต้น
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @end	0..1	Date	วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่เดียวกับหรือหลังวันที่ `start` หากไม่มีการระบุ `end` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่สิ้นสุด
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @days_of_week	0..1	string	วันของสัปดาห์ที่อนุญาตในช่วงวันที่ หากไม่ได้ระบุ ระบบจะอนุญาตให้ใช้ทุกวันในช่วงวันที่ อักขระแต่ละตัวในสตริงจะระบุวัน เช่น "MTWHF" เป็นการระบุว่าระบบอนุญาตให้ใช้วันธรรมดาในช่วงวันที่ อักขระที่ใช้ได้มีดังนี้ `M` สำหรับวันจันทร์ `T` สำหรับวันอังคาร `W` สำหรับวันพุธ `H` สำหรับวันพฤหัสบดี `F` สำหรับวันศุกร์ `S` สำหรับวันเสาร์ `U` สำหรับวันอาทิตย์ ชุดค่าผสมของอักขระแบบใดก็ได้สามารถใช้ได้
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries	0..1	UserCountries	หากระบุ การแก้ไขราคาจะมีผลเฉพาะในกรณีที่ผู้ใช้อยู่ในประเทศที่ระบุเท่านั้น หากไม่ได้ระบุ การปรับราคาจะมีผลไม่ว่าผู้ใช้จะอยู่ที่ใดก็ตาม
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / @type	0..1	enum	ประเภทของข้อกำหนด UserCountry ค่าที่ถูกต้องคือ `include` และ `exclude` หากตั้งค่า `type`Usercountries เป็น `include` การปรับราคาจะมีผลกับผู้ใช้จากประเทศที่ระบุไว้ หาก `type` ประเทศของผู้ใช้คือ `exclude` การปรับราคาจะมีผลกับผู้ใช้ที่อยู่นอกประเทศที่ระบุไว้ หากไม่ได้ตั้งค่า `type` ประเทศของผู้ใช้ ระบบจะถือว่าเป็น `include` และการปรับอัตราจะมีผลกับผู้ใช้จากประเทศที่ระบุไว้
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country	1..300	Country	ระบุประเทศของผู้ใช้ที่อนุญาตสำหรับการปรับราคา
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country / @code	1	string	รหัสประเทศ CLDR เช่น `DE` หรือ `FR` โปรดทราบว่ารหัสประเทศ CLDR สำหรับบางประเทศจะไม่ตรงกับรหัสประเทศ ISO 2 ตัวอักษร และไม่รองรับรหัสภูมิภาค CLDR ด้วย

ตัวอย่าง

ข้อความพื้นฐาน

ตัวอย่างต่อไปนี้แสดงข้อความ RateModifications` พื้นฐาน

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-07-01" end="2023-07-31" days_of_week="MTWHF"/>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2023-10-01" end="2023-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2023-10-08" end="2023-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

ลบการปรับราคา 1 รายการ

ตัวอย่างต่อไปนี้แสดงวิธีลบการแก้ไขราคา 1 รายการสําหรับที่พัก

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1" action="delete"/>
  </HotelRateModifications>
</RateModifications>

ลบการแก้ไขอัตราทั้งหมด

ตัวอย่างต่อไปนี้แสดงวิธีลบการปรับราคาทั้งหมดของที่พัก

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
</RateModifications>

วางซ้อนการปรับราคาทั้งหมด

ตัวอย่างต่อไปนี้แสดงวิธีวางซ้อน <HotelRateModifications> สําหรับที่พักด้วยการแก้ไขอัตราใหม่อย่างน้อย 1 รายการ เมื่อ action="overlay" ระบบจะลบการปรับราคาที่จัดเก็บไว้ทั้งหมดก่อนบันทึกการปรับราคาที่ระบุไว้ในข้อความปัจจุบัน

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

การดำเนินการแก้ไขหลายรายการ

ตัวอย่างต่อไปนี้แสดงวิธีทำการแก้ไขหลายรายการพร้อมกัน

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-01-01" end="2023-02-28"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier=".95"/>
        <Refundable available="true"
                    refundable_until_days="1"
                    refundable_until_time="12:00:00"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

ปิดแพ็กเกจราคาสำหรับประเทศของผู้ใช้

ตัวอย่างต่อไปนี้แสดงวิธีจำกัดแพ็กเกจราคาไว้เฉพาะผู้ใช้ภาษาญี่ปุ่น (JP) เท่านั้น

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <RatePlans>
         <RatePlan id="jp_only"/>
      </RatePlans>
      <UserCountries type="exclude">
        <Country code="JP"/>
      </UserCountries>
      <ModificationActions>
        <Availability status="unavailable"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

การตอบกลับ

ไวยากรณ์

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

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type"><var>issue_description</var></Issue>
  </Issues>
</RateModificationsResponse>

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

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

องค์ประกอบ / @แอตทริบิวต์	จำนวนข้อผิดพลาด	ประเภท	คำอธิบาย
RateModifications	1	Complex element	องค์ประกอบรูทที่ระบุความสำเร็จหรือปัญหาสำหรับข้อความคำขอ RateModifications ที่ได้รับ
RateModificationsResponse / @timestamp	1	DateTime	วันที่และเวลาที่สร้างข้อความนี้
RateModificationsResponse / @id	1	string	ตัวระบุที่ไม่ซ้ำกันจากข้อความ RateModifications ที่เกี่ยวข้อง
RateModificationsResponse / @partner	1	string	บัญชีพาร์ทเนอร์สำหรับข้อความนี้
RateModificationsResponse / Success	0..1	Success	บ่งบอกว่าข้อความ RateModifications ได้รับการประมวลผลเรียบร้อยแล้วโดยไม่มีคำเตือน ข้อผิดพลาด หรือความล้มเหลว แต่ละข้อความจะมี `<Success>` หรือ `<Issues>` ปรากฏอยู่
RateModificationsResponse / Issues	0..1	Issues	คอนเทนเนอร์สำหรับปัญหาอย่างน้อย 1 รายการที่พบขณะประมวลผลข้อความ RateModifications แต่ละข้อความจะมี `<Success>` หรือ `<Issues>` ปรากฏอยู่
RateModificationsResponse / Issues / Issue	1..n	Issue	คำอธิบายของคำเตือน ข้อผิดพลาด หรือความล้มเหลวที่พบขณะประมวลผลข้อความ RateModifications ดูรายละเอียดเกี่ยวกับปัญหาเหล่านี้ได้ในข้อความแสดงข้อผิดพลาดของสถานะฟีด
RateModificationsResponse / Issues / Issue / @code	1	integer	ตัวระบุสำหรับปัญหา
RateModificationsResponse / Issues / Issue / @status	1	enum	ประเภทของปัญหาที่พบ ค่าที่ถูกต้องคือ `warning`, `error` และ `failure`

ตัวอย่าง

Success

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

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</RateModificationsResponse>

ปัญหา

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

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</RateModificationsResponse>